${escapeHtml(
codeRef,
)}`;
});
+ // Convert reference-style links: [Label][CodeRef] into docs.rs links
+ // Keep the label as the link text, resolve the second bracket as a Rust code ref.
+ html = html.replace(
+ /\[([^\]]+)\]\s*\[\s*((?:crate::|c2pa::)?[A-Za-z][A-Za-z0-9_]*(?:::[A-Za-z0-9_]+)*)\s*\]/g,
+ (m, label, codeRef) => {
+ const url = resolveDocsUrl(codeRef);
+ return `${escapeHtml(label)}`;
+ },
+ );
+
+ // Convert [CodeRef] (non-markdown-link, no backticks) to docs.rs links.
+ // Avoid interfering with [text](url) by ensuring no '(' follows the ']'.
+ // Also avoid reference definition lines (followed by ':').
+ // Accept optional crate:: prefix and Type paths with ::member.
+ html = html.replace(
+ /\[((?:crate::|c2pa::)?[A-Z][A-Za-z0-9_]*(?:::[A-Za-z0-9_]+)*)\](?!\(|:)/g,
+ (m, labelOrCodeRef) => {
+ const mapped =
+ (Object.prototype.hasOwnProperty.call(refDefs, labelOrCodeRef) &&
+ refDefs[labelOrCodeRef]) ||
+ null;
+ const url =
+ mapped && /^https?:\/\//.test(mapped)
+ ? mapped
+ : resolveDocsUrl(mapped || labelOrCodeRef);
+ return `${escapeHtml(labelOrCodeRef)}`;
+ },
+ );
+
// Links: [text](url)
html = html.replace(/\[([^\]]+)\]\(([^)]+)\)/g, (m, label, url) => {
const safeUrl = url.replace(/"/g, '"');
@@ -251,70 +326,78 @@ function PropertiesTable({
- {Object.entries(properties).map(([name, schema]) => {
- const typeHtml = formatType(schema);
- const isRequired = Array.isArray(required)
- ? required.includes(name)
- : false;
- const explicitDefault =
- schema && Object.prototype.hasOwnProperty.call(schema, 'default')
- ? schema.default
- : undefined;
- const inferredDefault =
- defaults && Object.prototype.hasOwnProperty.call(defaults, name)
- ? defaults[name]
- : undefined;
- const chosenDefault =
- explicitDefault !== undefined
- ? explicitDefault
- : inferredDefault !== undefined
- ? inferredDefault
- : undefined;
-
- // Link to the referenced definition for non-primitive defaults (objects/arrays) when possible
- let defaultCell;
- if (chosenDefault === undefined) {
- defaultCell = 'N/A';
- } else if (
- typeof chosenDefault === 'object' &&
- chosenDefault !== null
- ) {
- const defName = schema ? refToDefName(schema.$ref) : null;
- if (defName) {
- defaultCell = (
- <>
- See {defName}
-
- );
+ {Object.entries(properties)
+ .sort(([aName], [bName]) =>
+ String(aName).localeCompare(String(bName), undefined, {
+ sensitivity: 'base',
+ numeric: true,
+ }),
+ )
+ .map(([name, schema]) => {
+ const typeHtml = formatType(schema);
+ const isRequired = Array.isArray(required)
+ ? required.includes(name)
+ : false;
+ const explicitDefault =
+ schema &&
+ Object.prototype.hasOwnProperty.call(schema, 'default')
+ ? schema.default
+ : undefined;
+ const inferredDefault =
+ defaults && Object.prototype.hasOwnProperty.call(defaults, name)
+ ? defaults[name]
+ : undefined;
+ const chosenDefault =
+ explicitDefault !== undefined
+ ? explicitDefault
+ : inferredDefault !== undefined
+ ? inferredDefault
+ : undefined;
+
+ // Link to the referenced definition for non-primitive defaults (objects/arrays) when possible
+ let defaultCell;
+ if (chosenDefault === undefined) {
+ defaultCell = 'N/A';
+ } else if (
+ typeof chosenDefault === 'object' &&
+ chosenDefault !== null
+ ) {
+ const defName = schema ? refToDefName(schema.$ref) : null;
+ if (defName) {
+ defaultCell = (
+ <>
+ See {defName}
+
+ );
+ } else {
+ defaultCell = JSON.stringify(chosenDefault);
+ }
} else {
defaultCell = JSON.stringify(chosenDefault);
}
- } else {
- defaultCell = JSON.stringify(chosenDefault);
- }
-
- return (
-