npm - @wildo-ai/saas-technical-doc - Versions diffs - 1.1.5 → 1.1.7 - Mend

@wildo-ai/saas-technical-doc 1.1.5 → 1.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (156) hide show

package/dist/esm/content.exports.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"content.exports.d.ts","sourceRoot":"","sources":["~~../../../~~src/content.exports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,uEAAuE,CAAC;AACtF,cAAc,8DAA8D,CAAC"}
1	+ {"version":3,"file":"content.exports.d.ts","sourceRoot":"","sources":["../../src/content.exports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,uEAAuE,CAAC;AACtF,cAAc,8DAA8D,CAAC"}

package/dist/esm/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["~~../../../~~src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}

package/dist/esm/openapi/api-reference-link-index.d.ts CHANGED Viewed

@@ -10,6 +10,7 @@
  */
 import { OpenApiSection, type OpenApiSectionOutput } from './openapi-generation-output.schemas';
 import { type TechnicalDocumentationApiReferenceTargetV1 } from '@wildo-ai/saas-specifications/technical-documentation';
+import { ApplicationConsumerDocumentationRoute } from './api-reference-targets';
 /** The semantic source identity a guide may resolve to a consumer API URL. */
 export declare enum ApiReferenceLinkIdentityKind {
     /** A generated section exists and its root page is a valid public destination. */
@@ -69,6 +70,8 @@ export declare enum TechnicalDocumentationApiReferenceTargetAvailability {
     AVAILABLE = "AVAILABLE",
     UNAVAILABLE = "UNAVAILABLE"
 }
+/** The consumer-documentation route that roots an API-reference section. */
+export declare function apiReferenceRouteForSection(section: OpenApiSection): ApplicationConsumerDocumentationRoute;
 /**
  * Creates links from the exact generated OpenAPI documents.
  *

package/dist/esm/openapi/api-reference-link-index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"api-reference-link-index.d.ts","sourceRoot":"","sources":["~~../../../../~~src/openapi/api-reference-link-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChG,OAAO,EAGL,KAAK,0CAA0C,EAChD,MAAM,uDAAuD,CAAC;~~AAQ~~/D,8EAA8E;AAC9E,oBAAY,4BAA4B;IACtC,kFAAkF;IAClF,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,gBAAgB,qBAAqB;IACrC,iBAAiB,sBAAsB;IACvC,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,gBAAgB,qBAAqB;CACtC;AAED,MAAM,MAAM,wBAAwB,GAChC;IAAE,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC,IAAI,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC,QAAQ,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACrF;IAAE,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC,QAAQ,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACtF;IAAE,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC,gBAAgB,CAAC;IAAC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;CAAE,GACrG;IAAE,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC,iBAAiB,CAAC;IAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,GACvG;IAAE,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC,OAAO,CAAC;IAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,GAC7F;IAAE,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC,QAAQ,CAAC;IAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvH;IAAE,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC,gBAAgB,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAElG,mGAAmG;AACnG,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,0BAA0B,EAAE,CAAC;CACzD;AAED;;;;;;GAMG;AACH,oBAAY,oDAAoD;IAC9D,SAAS,cAAc;IACvB,WAAW,gBAAgB;CAC5B;~~AAoED~~;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,GAAG,qBAAqB,~~CAyH5G~~;AAED,yGAAyG;AACzG,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,qBAAqB,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,wBAAwB,GAAG,MAAM,CAKzI;AAwCD;;;;GAIG;AACH,wBAAgB,uDAAuD,CACrE,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,0CAA0C,GACjD,oDAAoD,CAMtD;AAED;;;;;;;GAOG;AACH,wBAAgB,6CAA6C,CAC3D,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,0CAA0C,GACjD,MAAM,CAGR"}
1	+ {"version":3,"file":"api-reference-link-index.d.ts","sourceRoot":"","sources":["../../../src/openapi/api-reference-link-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChG,OAAO,EAGL,KAAK,0CAA0C,EAChD,MAAM,uDAAuD,CAAC;AAC/D,OAAO,EAEL,qCAAqC,EAKtC,MAAM,yBAAyB,CAAC;AAGjC,8EAA8E;AAC9E,oBAAY,4BAA4B;IACtC,kFAAkF;IAClF,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,gBAAgB,qBAAqB;IACrC,iBAAiB,sBAAsB;IACvC,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,gBAAgB,qBAAqB;CACtC;AAED,MAAM,MAAM,wBAAwB,GAChC;IAAE,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC,IAAI,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC,QAAQ,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACrF;IAAE,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC,QAAQ,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACtF;IAAE,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC,gBAAgB,CAAC;IAAC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;CAAE,GACrG;IAAE,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC,iBAAiB,CAAC;IAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,GACvG;IAAE,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC,OAAO,CAAC;IAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,GAC7F;IAAE,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC,QAAQ,CAAC;IAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvH;IAAE,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC,gBAAgB,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAElG,mGAAmG;AACnG,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,0BAA0B,EAAE,CAAC;CACzD;AAED;;;;;;GAMG;AACH,oBAAY,oDAAoD;IAC9D,SAAS,cAAc;IACvB,WAAW,gBAAgB;CAC5B;AAUD,4EAA4E;AAC5E,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,cAAc,GAAG,qCAAqC,CAW1G;AAqDD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,GAAG,qBAAqB,CA2H5G;AAED,yGAAyG;AACzG,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,qBAAqB,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,wBAAwB,GAAG,MAAM,CAKzI;AAwCD;;;;GAIG;AACH,wBAAgB,uDAAuD,CACrE,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,0CAA0C,GACjD,oDAAoD,CAMtD;AAED;;;;;;;GAOG;AACH,wBAAgB,6CAA6C,CAC3D,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,0CAA0C,GACjD,MAAM,CAGR"}

package/dist/esm/openapi/api-reference-link-index.js CHANGED Viewed

@@ -10,7 +10,8 @@
  */
 import { OpenApiSection } from './openapi-generation-output.schemas.js';
 import { TechnicalDocumentationApiReferenceSection, TechnicalDocumentationApiReferenceTargetKind, } from '@wildo-ai/saas-specifications/technical-documentation';
-import { ApiReferenceTargetKind, ApplicationConsumerDocumentationRoute, applicationConsumerDocumentationTargetPath, } from './api-reference-targets.js';
+import { ApiReferenceTargetKind, ApplicationConsumerDocumentationRoute, applicationConsumerDocumentationRoutePath, applicationConsumerDocumentationTargetPath, apiReferenceTargetFragment, } from './api-reference-targets.js';
+import { apiReferencePageHref, buildApiReferencePagePlan } from './api-reference-pages.js';
 /** The semantic source identity a guide may resolve to a consumer API URL. */
 export var ApiReferenceLinkIdentityKind;
 (function (ApiReferenceLinkIdentityKind) {
@@ -40,7 +41,8 @@ const OPENAPI_HTTP_METHODS = new Set(['get', 'put', 'post', 'delete', 'options',
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
-function routeForSection(section) {
+/** The consumer-documentation route that roots an API-reference section. */
+export function apiReferenceRouteForSection(section) {
     switch (section) {
         case OpenApiSection.API_REFERENCE:
             return ApplicationConsumerDocumentationRoute.API_REFERENCE;
@@ -64,12 +66,18 @@ function familyName(operationFamilyRef) {
         throw new Error(`API-reference family identity is not canonical: '${operationFamilyRef}'`);
     return name;
 }
-function targetHref(section, target) {
-    return applicationConsumerDocumentationTargetPath(routeForSection(section), target);
+/**
+ * A target's public href. Each resource has its own page (#1623), so a resource-scoped target is
+ * addressed on that page (`/api/tasks#operation-create-task`) and only a category stays on the
+ * section root — the page plan that registers the routes decides, so a guide link and a route can
+ * never disagree about where a target lives.
+ */
+function targetHref(section, plan, target) {
+    return apiReferencePageHref(applicationConsumerDocumentationRoutePath(apiReferenceRouteForSection(section)), apiReferenceTargetFragment(target), plan);
 }
 /** The root is an index entry too: a guide may cite it only when that section was generated. */
 function sectionRootHref(section) {
-    return applicationConsumerDocumentationTargetPath(routeForSection(section));
+    return applicationConsumerDocumentationTargetPath(apiReferenceRouteForSection(section));
 }
 function identityKey(section, identity) {
     switch (identity.kind) {
@@ -126,6 +134,7 @@ export function createApiReferenceLinkIndex(sections) {
         const document = sectionOutput.document;
         if (!isRecord(document) || !isRecord(document.paths))
             throw new Error(`API-reference ${sectionOutput.section} document has no OpenAPI paths object`);
+        const pagePlan = buildApiReferencePagePlan(document);
         add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.ROOT }, sectionRootHref(sectionOutput.section));
         const tags = new Map();
         const usedResourceRefs = new Set();
@@ -150,7 +159,7 @@ export function createApiReferenceLinkIndex(sections) {
             if (resourceName(tagResourceRef) !== tag.name)
                 throw new Error(`API-reference resource tag '${tag.name}' disagrees with its resource identity`);
             tags.set(tag.name, { resourceRef: tagResourceRef });
-            add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.RESOURCE, resourceRef: tagResourceRef }, targetHref(sectionOutput.section, {
+            add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.RESOURCE, resourceRef: tagResourceRef }, targetHref(sectionOutput.section, pagePlan, {
                 kind: ApiReferenceTargetKind.RESOURCE,
                 resourceName: tag.name,
             }));
@@ -165,7 +174,7 @@ export function createApiReferenceLinkIndex(sections) {
                 const categoryIdentity = { kind: ApiReferenceLinkIdentityKind.CATEGORY, categoryId };
                 const key = identityKey(sectionOutput.section, categoryIdentity);
                 if (!seen.has(key))
-                    add(sectionOutput.section, categoryIdentity, targetHref(sectionOutput.section, {
+                    add(sectionOutput.section, categoryIdentity, targetHref(sectionOutput.section, pagePlan, {
                         kind: ApiReferenceTargetKind.CATEGORY,
                         categoryName: categoryId,
                     }));
@@ -193,22 +202,22 @@ export function createApiReferenceLinkIndex(sections) {
                 const operationTarget = { kind: ApiReferenceTargetKind.OPERATION, operationId: operation.operationId };
                 const familyIdentity = { kind: ApiReferenceLinkIdentityKind.OPERATION_FAMILY, operationFamilyRef: metadata.operationFamilyRef };
                 if (!seen.has(identityKey(sectionOutput.section, familyIdentity))) {
-                    add(sectionOutput.section, familyIdentity, targetHref(sectionOutput.section, {
+                    add(sectionOutput.section, familyIdentity, targetHref(sectionOutput.section, pagePlan, {
                         kind: ApiReferenceTargetKind.OPERATION_FAMILY,
                         resourceName: resourceName(metadata.resourceRef),
                         operationName: familyName(metadata.operationFamilyRef),
                     }));
                 }
-                add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.OPERATION_VARIANT, operationVariantRef: metadata.operationVariantRef }, targetHref(sectionOutput.section, operationTarget));
+                add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.OPERATION_VARIANT, operationVariantRef: metadata.operationVariantRef }, targetHref(sectionOutput.section, pagePlan, operationTarget));
                 if (isRecord(operation.requestBody)) {
-                    add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.REQUEST, operationVariantRef: metadata.operationVariantRef }, targetHref(sectionOutput.section, {
+                    add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.REQUEST, operationVariantRef: metadata.operationVariantRef }, targetHref(sectionOutput.section, pagePlan, {
                         kind: ApiReferenceTargetKind.REQUEST,
                         operationId: operation.operationId,
                     }));
                 }
                 if (isRecord(operation.responses)) {
                     for (const status of Object.keys(operation.responses)) {
-                        add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.RESPONSE, operationVariantRef: metadata.operationVariantRef, status }, targetHref(sectionOutput.section, {
+                        add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.RESPONSE, operationVariantRef: metadata.operationVariantRef, status }, targetHref(sectionOutput.section, pagePlan, {
                             kind: ApiReferenceTargetKind.RESPONSE,
                             operationId: operation.operationId,
                             status,
@@ -224,10 +233,12 @@ export function createApiReferenceLinkIndex(sections) {
         }
         const componentSchemas = isRecord(document.components) && isRecord(document.components.schemas) ? document.components.schemas : {};
         for (const schemaName of Object.keys(componentSchemas)) {
-            add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.COMPONENT_SCHEMA, schemaName }, targetHref(sectionOutput.section, {
-                kind: ApiReferenceTargetKind.COMPONENT_SCHEMA,
-                schemaName,
-            }));
+            const target = { kind: ApiReferenceTargetKind.COMPONENT_SCHEMA, schemaName };
+            // A schema no operation reaches is rendered on no page, so it is not offered as a target at all
+            // — a guide asking for it gets UNAVAILABLE rather than a link to nothing.
+            if (pagePlan.pageSlugByFragment[apiReferenceTargetFragment(target)] === undefined)
+                continue;
+            add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.COMPONENT_SCHEMA, schemaName }, targetHref(sectionOutput.section, pagePlan, target));
         }
     }
     return { schemaVersion: 1, entries: entries.sort((left, right) => identityKey(left.section, left.identity).localeCompare(identityKey(right.section, right.identity))) };

package/dist/esm/openapi/api-reference-link-index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"api-reference-link-index.js","sourceRoot":"","sources":["../../../../src/openapi/api-reference-link-index.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Semantic links into the generated API reference.\n \n This module projects a canonical OpenAPI document into a small index of\n * public paths. It does not describe or navigate API contracts itself: every\n * entry is derived from standard OpenAPI fields plus the strict `x-wildo`\n * source identities already present in the document. Guide generation can use\n * the index to link to exact API targets without hard-coding Docusaurus URLs\n * or duplicating operations, request DTOs, responses, or schemas.\n /\n\nimport { OpenApiSection, type OpenApiSectionOutput } from './openapi-generation-output.schemas';\nimport {\n TechnicalDocumentationApiReferenceSection,\n TechnicalDocumentationApiReferenceTargetKind,\n type TechnicalDocumentationApiReferenceTargetV1,\n} from '@wildo-ai/saas-specifications/technical-documentation';\nimport {\n ApiReferenceTargetKind,\n ApplicationConsumerDocumentationRoute,\n applicationConsumerDocumentationTargetPath,\n type ApiReferencePublicTarget,\n} from './api-reference-targets';\n\n/* The semantic source identity a guide may resolve to a consumer API URL. /\nexport enum ApiReferenceLinkIdentityKind {\n /* A generated section exists and its root page is a valid public destination. /\n ROOT = 'ROOT',\n CATEGORY = 'CATEGORY',\n RESOURCE = 'RESOURCE',\n OPERATION_FAMILY = 'OPERATION_FAMILY',\n OPERATION_VARIANT = 'OPERATION_VARIANT',\n REQUEST = 'REQUEST',\n RESPONSE = 'RESPONSE',\n COMPONENT_SCHEMA = 'COMPONENT_SCHEMA',\n}\n\nexport type ApiReferenceLinkIdentity =\n \| { readonly kind: ApiReferenceLinkIdentityKind.ROOT }\n \| { readonly kind: ApiReferenceLinkIdentityKind.CATEGORY; readonly categoryId: string }\n \| { readonly kind: ApiReferenceLinkIdentityKind.RESOURCE; readonly resourceRef: string }\n \| { readonly kind: ApiReferenceLinkIdentityKind.OPERATION_FAMILY; readonly operationFamilyRef: string }\n \| { readonly kind: ApiReferenceLinkIdentityKind.OPERATION_VARIANT; readonly operationVariantRef: string }\n \| { readonly kind: ApiReferenceLinkIdentityKind.REQUEST; readonly operationVariantRef: string }\n \| { readonly kind: ApiReferenceLinkIdentityKind.RESPONSE; readonly operationVariantRef: string; readonly status: string }\n \| { readonly kind: ApiReferenceLinkIdentityKind.COMPONENT_SCHEMA; readonly schemaName: string };\n\n/* One resolved public URL. `section` keeps an identity unambiguous across both API references. /\nexport interface ApiReferenceLinkIndexEntry {\n readonly section: OpenApiSection;\n readonly identity: ApiReferenceLinkIdentity;\n readonly href: string;\n}\n\n/* JSON-safe result of projecting the selected OpenAPI documents. /\nexport interface ApiReferenceLinkIndex {\n readonly schemaVersion: 1;\n readonly entries: readonly ApiReferenceLinkIndexEntry[];\n}\n\n/\n Result of asking whether one semantic guide target exists in the exact\n * generated OpenAPI index. This is deliberately not a boolean: the named\n * vocabulary keeps availability decisions readable at guide-composition call\n * sites and leaves room for future source-owned states without overloading\n * `false`.\n /\nexport enum TechnicalDocumentationApiReferenceTargetAvailability {\n AVAILABLE = 'AVAILABLE',\n UNAVAILABLE = 'UNAVAILABLE',\n}\n\ntype UnknownRecord = Record<string, unknown>;\n\nconst OPENAPI_HTTP_METHODS: ReadonlySet<string> = new Set(['get', 'put', 'post', 'delete', 'options', 'head', 'patch', 'trace']);\n\nfunction isRecord(value: unknown): value is UnknownRecord {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction routeForSection(section: OpenApiSection): ApplicationConsumerDocumentationRoute {\n switch (section) {\n case OpenApiSection.API_REFERENCE:\n return ApplicationConsumerDocumentationRoute.API_REFERENCE;\n case OpenApiSection.APPLICATION_ADMINISTRATION_API_REFERENCE:\n return ApplicationConsumerDocumentationRoute.APPLICATION_ADMINISTRATION_API_REFERENCE;\n default: {\n const exhaustiveSection: never = section;\n throw new Error(`Unsupported API-reference section: ${String(exhaustiveSection)}`);\n }\n }\n}\n\nfunction resourceName(resourceRef: string): string {\n const name = resourceRef.match(/^technical-documentation:resource\\/([^/]+)$/)?.[1];\n if (name === undefined) throw new Error(`API-reference resource identity is not a canonical resource ref: '${resourceRef}'`);\n return name;\n}\n\nfunction familyName(operationFamilyRef: string): string {\n const name = operationFamilyRef.match(/^technical-documentation:resource\\/[^/]+\\/operation-family\\/([^/]+)$/)?.[1];\n if (name === undefined) throw new Error(`API-reference family identity is not canonical: '${operationFamilyRef}'`);\n return name;\n}\n\nfunction targetHref(section: OpenApiSection, target: ApiReferencePublicTarget): string {\n return applicationConsumerDocumentationTargetPath(routeForSection(section), target);\n}\n\n/* The root is an index entry too: a guide may cite it only when that section was generated. /\nfunction sectionRootHref(section: OpenApiSection): string {\n return applicationConsumerDocumentationTargetPath(routeForSection(section));\n}\n\nfunction identityKey(section: OpenApiSection, identity: ApiReferenceLinkIdentity): string {\n switch (identity.kind) {\n case ApiReferenceLinkIdentityKind.ROOT:\n return `${section}\\0${identity.kind}`;\n case ApiReferenceLinkIdentityKind.CATEGORY:\n return `${section}\\0${identity.kind}\\0${identity.categoryId}`;\n case ApiReferenceLinkIdentityKind.RESOURCE:\n return `${section}\\0${identity.kind}\\0${identity.resourceRef}`;\n case ApiReferenceLinkIdentityKind.OPERATION_FAMILY:\n return `${section}\\0${identity.kind}\\0${identity.operationFamilyRef}`;\n case ApiReferenceLinkIdentityKind.OPERATION_VARIANT:\n case ApiReferenceLinkIdentityKind.REQUEST:\n return `${section}\\0${identity.kind}\\0${identity.operationVariantRef}`;\n case ApiReferenceLinkIdentityKind.RESPONSE:\n return `${section}\\0${identity.kind}\\0${identity.operationVariantRef}\\0${identity.status}`;\n case ApiReferenceLinkIdentityKind.COMPONENT_SCHEMA:\n return `${section}\\0${identity.kind}\\0${identity.schemaName}`;\n default: {\n const exhaustiveIdentity: never = identity;\n throw new Error(`Unsupported API-reference link identity: ${JSON.stringify(exhaustiveIdentity)}`);\n }\n }\n}\n\n/\n Creates links from the exact generated OpenAPI documents.\n \n This is intentionally a fail-closed projection. An HTTP operation without\n * the established source identity, a tag/operation resource mismatch, or a\n * duplicate semantic target means guide links could become ambiguous, so the\n * index is not emitted at all.\n /\nexport function createApiReferenceLinkIndex(sections: readonly OpenApiSectionOutput[]): ApiReferenceLinkIndex {\n const entries: ApiReferenceLinkIndexEntry[] = [];\n const seen = new Set<string>();\n const sectionSet = new Set<OpenApiSection>();\n const identityByHref = new Map<string, string>();\n const add = (section: OpenApiSection, identity: ApiReferenceLinkIdentity, href: string): void => {\n const key = identityKey(section, identity);\n if (seen.has(key)) throw new Error(`API-reference link identity is duplicated: ${key}`);\n const priorIdentity = identityByHref.get(href);\n if (priorIdentity !== undefined && priorIdentity !== key) {\n throw new Error(`API-reference public link '${href}' is ambiguous between ${priorIdentity} and ${key}`);\n }\n seen.add(key);\n identityByHref.set(href, key);\n entries.push({ section, identity, href });\n };\n\n for (const sectionOutput of sections) {\n if (sectionSet.has(sectionOutput.section)) throw new Error(`API-reference section is duplicated: ${sectionOutput.section}`);\n sectionSet.add(sectionOutput.section);\n const document = sectionOutput.document;\n if (!isRecord(document) \|\| !isRecord(document.paths)) throw new Error(`API-reference ${sectionOutput.section} document has no OpenAPI paths object`);\n add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.ROOT }, sectionRootHref(sectionOutput.section));\n const tags = new Map<string, { resourceRef: string }>();\n const usedResourceRefs = new Set<string>();\n const categoryMetadataById = new Map<string, { label: string; description: string \| null }>();\n if (!Array.isArray(document.tags)) throw new Error(`API-reference ${sectionOutput.section} document has no resource tags`);\n for (const tag of document.tags) {\n if (!isRecord(tag) \|\| typeof tag.name !== 'string' \|\| !isRecord(tag['x-wildo']) \|\| typeof tag['x-wildo'].resourceRef !== 'string') {\n throw new Error(`API-reference ${sectionOutput.section} document has a malformed resource tag`);\n }\n if (tags.has(tag.name)) throw new Error(`API-reference ${sectionOutput.section} resource tag is duplicated: '${tag.name}'`);\n const category = tag['x-wildo'].category;\n if (category !== undefined && (!isRecord(category) \|\| typeof category.id !== 'string' \|\| typeof category.label !== 'string'\n \|\| (category.description !== undefined && typeof category.description !== 'string'))) {\n throw new Error(`API-reference resource tag '${tag.name}' has malformed category metadata`);\n }\n const categoryId = isRecord(category) && typeof category.id === 'string' ? category.id : null;\n const categoryLabel = isRecord(category) && typeof category.label === 'string' ? category.label : null;\n const categoryDescription = isRecord(category) && typeof category.description === 'string' ? category.description : null;\n const tagResourceRef = tag['x-wildo'].resourceRef;\n if (resourceName(tagResourceRef) !== tag.name) throw new Error(`API-reference resource tag '${tag.name}' disagrees with its resource identity`);\n tags.set(tag.name, { resourceRef: tagResourceRef });\n add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.RESOURCE, resourceRef: tagResourceRef }, targetHref(sectionOutput.section, {\n kind: ApiReferenceTargetKind.RESOURCE,\n resourceName: tag.name,\n }));\n if (categoryId !== null) {\n if (categoryLabel === null) throw new Error(`API-reference resource tag '${tag.name}' has malformed category metadata`);\n const priorMetadata = categoryMetadataById.get(categoryId);\n if (priorMetadata !== undefined && (priorMetadata.label !== categoryLabel \|\| priorMetadata.description !== categoryDescription)) {\n throw new Error(`API-reference category '${categoryId}' has inconsistent source metadata`);\n }\n categoryMetadataById.set(categoryId, { label: categoryLabel, description: categoryDescription });\n const categoryIdentity = { kind: ApiReferenceLinkIdentityKind.CATEGORY, categoryId } as const;\n const key = identityKey(sectionOutput.section, categoryIdentity);\n if (!seen.has(key)) add(sectionOutput.section, categoryIdentity, targetHref(sectionOutput.section, {\n kind: ApiReferenceTargetKind.CATEGORY,\n categoryName: categoryId,\n }));\n }\n }\n\n for (const [path, pathItem] of Object.entries(document.paths)) {\n if (!isRecord(pathItem)) continue;\n for (const [method, operation] of Object.entries(pathItem)) {\n if (!OPENAPI_HTTP_METHODS.has(method)) continue;\n if (!isRecord(operation) \|\| !isRecord(operation['x-wildo']) \|\| typeof operation.operationId !== 'string') {\n throw new Error(`API-reference ${method.toUpperCase()} ${path} operation has malformed identity metadata`);\n }\n const metadata = operation['x-wildo'];\n if (typeof metadata.resourceRef !== 'string' \|\| typeof metadata.operationFamilyRef !== 'string' \|\| typeof metadata.operationVariantRef !== 'string') {\n throw new Error(`API-reference ${method.toUpperCase()} ${path} operation has incomplete identity metadata`);\n }\n if (metadata.path !== path \|\| metadata.httpVerb !== method) throw new Error(`API-reference ${method.toUpperCase()} ${path} operation identity disagrees with its OpenAPI location`);\n const tag = tags.get(resourceName(metadata.resourceRef));\n if (tag === undefined \|\| tag.resourceRef !== metadata.resourceRef) throw new Error(`API-reference ${method.toUpperCase()} ${path} operation has no matching resource tag`);\n usedResourceRefs.add(metadata.resourceRef);\n const operationTarget = { kind: ApiReferenceTargetKind.OPERATION, operationId: operation.operationId } as const;\n const familyIdentity = { kind: ApiReferenceLinkIdentityKind.OPERATION_FAMILY, operationFamilyRef: metadata.operationFamilyRef } as const;\n if (!seen.has(identityKey(sectionOutput.section, familyIdentity))) {\n add(sectionOutput.section, familyIdentity, targetHref(sectionOutput.section, {\n kind: ApiReferenceTargetKind.OPERATION_FAMILY,\n resourceName: resourceName(metadata.resourceRef),\n operationName: familyName(metadata.operationFamilyRef),\n }));\n }\n add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.OPERATION_VARIANT, operationVariantRef: metadata.operationVariantRef }, targetHref(sectionOutput.section, operationTarget));\n if (isRecord(operation.requestBody)) {\n add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.REQUEST, operationVariantRef: metadata.operationVariantRef }, targetHref(sectionOutput.section, {\n kind: ApiReferenceTargetKind.REQUEST,\n operationId: operation.operationId,\n }));\n }\n if (isRecord(operation.responses)) {\n for (const status of Object.keys(operation.responses)) {\n add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.RESPONSE, operationVariantRef: metadata.operationVariantRef, status }, targetHref(sectionOutput.section, {\n kind: ApiReferenceTargetKind.RESPONSE,\n operationId: operation.operationId,\n status,\n }));\n }\n }\n }\n }\n\n for (const [tagName, tag] of tags) {\n if (!usedResourceRefs.has(tag.resourceRef)) {\n throw new Error(`API-reference resource tag '${tagName}' has no rendered HTTP operation`);\n }\n }\n\n const componentSchemas = isRecord(document.components) && isRecord(document.components.schemas) ? document.components.schemas : {};\n for (const schemaName of Object.keys(componentSchemas)) {\n add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.COMPONENT_SCHEMA, schemaName }, targetHref(sectionOutput.section, {\n kind: ApiReferenceTargetKind.COMPONENT_SCHEMA,\n schemaName,\n }));\n }\n }\n return { schemaVersion: 1, entries: entries.sort((left, right) => identityKey(left.section, left.identity).localeCompare(identityKey(right.section, right.identity))) };\n}\n\n/* Resolves one semantic API target and fails loudly when a guide asks for unavailable documentation. /\nexport function resolveApiReferenceLink(index: ApiReferenceLinkIndex, section: OpenApiSection, identity: ApiReferenceLinkIdentity): string {\n const expectedKey = identityKey(section, identity);\n const entry = index.entries.find((candidate) => identityKey(candidate.section, candidate.identity) === expectedKey);\n if (entry === undefined) throw new Error(`API-reference link target is unavailable: ${expectedKey}`);\n return entry.href;\n}\n\nfunction technicalDocumentationTargetIdentity(target: TechnicalDocumentationApiReferenceTargetV1): {\n readonly section: OpenApiSection;\n readonly identity: ApiReferenceLinkIdentity;\n} {\n const section = target.section === TechnicalDocumentationApiReferenceSection.API_REFERENCE\n ? OpenApiSection.API_REFERENCE\n : OpenApiSection.APPLICATION_ADMINISTRATION_API_REFERENCE;\n switch (target.kind) {\n case TechnicalDocumentationApiReferenceTargetKind.ROOT:\n return { section, identity: { kind: ApiReferenceLinkIdentityKind.ROOT } };\n case TechnicalDocumentationApiReferenceTargetKind.CATEGORY:\n return { section, identity: { kind: ApiReferenceLinkIdentityKind.CATEGORY, categoryId: target.categoryId } };\n case TechnicalDocumentationApiReferenceTargetKind.RESOURCE:\n return { section, identity: { kind: ApiReferenceLinkIdentityKind.RESOURCE, resourceRef: target.resourceRef } };\n case TechnicalDocumentationApiReferenceTargetKind.OPERATION_FAMILY:\n return { section, identity: { kind: ApiReferenceLinkIdentityKind.OPERATION_FAMILY, operationFamilyRef: target.operationFamilyRef } };\n case TechnicalDocumentationApiReferenceTargetKind.OPERATION_VARIANT:\n return { section, identity: { kind: ApiReferenceLinkIdentityKind.OPERATION_VARIANT, operationVariantRef: target.operationVariantRef } };\n case TechnicalDocumentationApiReferenceTargetKind.REQUEST:\n return { section, identity: { kind: ApiReferenceLinkIdentityKind.REQUEST, operationVariantRef: target.operationVariantRef } };\n case TechnicalDocumentationApiReferenceTargetKind.RESPONSE:\n return {\n section,\n identity: {\n kind: ApiReferenceLinkIdentityKind.RESPONSE,\n operationVariantRef: target.operationVariantRef,\n status: target.status,\n },\n };\n case TechnicalDocumentationApiReferenceTargetKind.COMPONENT_SCHEMA:\n return { section, identity: { kind: ApiReferenceLinkIdentityKind.COMPONENT_SCHEMA, schemaName: target.schemaName } };\n default: {\n const exhaustiveTarget: never = target;\n throw new Error(`Unsupported technical-documentation API-reference target: ${JSON.stringify(exhaustiveTarget)}`);\n }\n }\n}\n\n/\n Answers whether a typed target exists in the generated OpenAPI index without\n * manufacturing a URL or turning normal optional-content selection into an\n * exception path. Included guide links must still use the strict resolver.\n /\nexport function getTechnicalDocumentationApiReferenceTargetAvailability(\n index: ApiReferenceLinkIndex,\n target: TechnicalDocumentationApiReferenceTargetV1,\n): TechnicalDocumentationApiReferenceTargetAvailability {\n const { section, identity } = technicalDocumentationTargetIdentity(target);\n const expectedKey = identityKey(section, identity);\n return index.entries.some((candidate) => identityKey(candidate.section, candidate.identity) === expectedKey)\n ? TechnicalDocumentationApiReferenceTargetAvailability.AVAILABLE\n : TechnicalDocumentationApiReferenceTargetAvailability.UNAVAILABLE;\n}\n\n/\n Resolves a portable guide target through the generated OpenAPI index.\n \n The technical-documentation contract owns the semantic target because guide\n * content cannot depend on the renderer package. This adapter is the only\n * place that translates that portable target into the OpenAPI identities used\n * to produce public consumer URLs.\n */\nexport function resolveTechnicalDocumentationApiReferenceLink(\n index: ApiReferenceLinkIndex,\n target: TechnicalDocumentationApiReferenceTargetV1,\n): string {\n const { section, identity } = technicalDocumentationTargetIdentity(target);\n return resolveApiReferenceLink(index, section, identity);\n}\n"]}
1	+ {"version":3,"file":"api-reference-link-index.js","sourceRoot":"","sources":["../../../src/openapi/api-reference-link-index.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Semantic links into the generated API reference.\n \n This module projects a canonical OpenAPI document into a small index of\n * public paths. It does not describe or navigate API contracts itself: every\n * entry is derived from standard OpenAPI fields plus the strict `x-wildo`\n * source identities already present in the document. Guide generation can use\n * the index to link to exact API targets without hard-coding Docusaurus URLs\n * or duplicating operations, request DTOs, responses, or schemas.\n /\n\nimport { OpenApiSection, type OpenApiSectionOutput } from './openapi-generation-output.schemas';\nimport {\n TechnicalDocumentationApiReferenceSection,\n TechnicalDocumentationApiReferenceTargetKind,\n type TechnicalDocumentationApiReferenceTargetV1,\n} from '@wildo-ai/saas-specifications/technical-documentation';\nimport {\n ApiReferenceTargetKind,\n ApplicationConsumerDocumentationRoute,\n applicationConsumerDocumentationRoutePath,\n applicationConsumerDocumentationTargetPath,\n apiReferenceTargetFragment,\n type ApiReferencePublicTarget,\n} from './api-reference-targets';\nimport { apiReferencePageHref, buildApiReferencePagePlan, type ApiReferencePagePlan } from './api-reference-pages';\n\n/* The semantic source identity a guide may resolve to a consumer API URL. /\nexport enum ApiReferenceLinkIdentityKind {\n /* A generated section exists and its root page is a valid public destination. /\n ROOT = 'ROOT',\n CATEGORY = 'CATEGORY',\n RESOURCE = 'RESOURCE',\n OPERATION_FAMILY = 'OPERATION_FAMILY',\n OPERATION_VARIANT = 'OPERATION_VARIANT',\n REQUEST = 'REQUEST',\n RESPONSE = 'RESPONSE',\n COMPONENT_SCHEMA = 'COMPONENT_SCHEMA',\n}\n\nexport type ApiReferenceLinkIdentity =\n \| { readonly kind: ApiReferenceLinkIdentityKind.ROOT }\n \| { readonly kind: ApiReferenceLinkIdentityKind.CATEGORY; readonly categoryId: string }\n \| { readonly kind: ApiReferenceLinkIdentityKind.RESOURCE; readonly resourceRef: string }\n \| { readonly kind: ApiReferenceLinkIdentityKind.OPERATION_FAMILY; readonly operationFamilyRef: string }\n \| { readonly kind: ApiReferenceLinkIdentityKind.OPERATION_VARIANT; readonly operationVariantRef: string }\n \| { readonly kind: ApiReferenceLinkIdentityKind.REQUEST; readonly operationVariantRef: string }\n \| { readonly kind: ApiReferenceLinkIdentityKind.RESPONSE; readonly operationVariantRef: string; readonly status: string }\n \| { readonly kind: ApiReferenceLinkIdentityKind.COMPONENT_SCHEMA; readonly schemaName: string };\n\n/* One resolved public URL. `section` keeps an identity unambiguous across both API references. /\nexport interface ApiReferenceLinkIndexEntry {\n readonly section: OpenApiSection;\n readonly identity: ApiReferenceLinkIdentity;\n readonly href: string;\n}\n\n/* JSON-safe result of projecting the selected OpenAPI documents. /\nexport interface ApiReferenceLinkIndex {\n readonly schemaVersion: 1;\n readonly entries: readonly ApiReferenceLinkIndexEntry[];\n}\n\n/\n Result of asking whether one semantic guide target exists in the exact\n * generated OpenAPI index. This is deliberately not a boolean: the named\n * vocabulary keeps availability decisions readable at guide-composition call\n * sites and leaves room for future source-owned states without overloading\n * `false`.\n /\nexport enum TechnicalDocumentationApiReferenceTargetAvailability {\n AVAILABLE = 'AVAILABLE',\n UNAVAILABLE = 'UNAVAILABLE',\n}\n\ntype UnknownRecord = Record<string, unknown>;\n\nconst OPENAPI_HTTP_METHODS: ReadonlySet<string> = new Set(['get', 'put', 'post', 'delete', 'options', 'head', 'patch', 'trace']);\n\nfunction isRecord(value: unknown): value is UnknownRecord {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/* The consumer-documentation route that roots an API-reference section. /\nexport function apiReferenceRouteForSection(section: OpenApiSection): ApplicationConsumerDocumentationRoute {\n switch (section) {\n case OpenApiSection.API_REFERENCE:\n return ApplicationConsumerDocumentationRoute.API_REFERENCE;\n case OpenApiSection.APPLICATION_ADMINISTRATION_API_REFERENCE:\n return ApplicationConsumerDocumentationRoute.APPLICATION_ADMINISTRATION_API_REFERENCE;\n default: {\n const exhaustiveSection: never = section;\n throw new Error(`Unsupported API-reference section: ${String(exhaustiveSection)}`);\n }\n }\n}\n\nfunction resourceName(resourceRef: string): string {\n const name = resourceRef.match(/^technical-documentation:resource\\/([^/]+)$/)?.[1];\n if (name === undefined) throw new Error(`API-reference resource identity is not a canonical resource ref: '${resourceRef}'`);\n return name;\n}\n\nfunction familyName(operationFamilyRef: string): string {\n const name = operationFamilyRef.match(/^technical-documentation:resource\\/[^/]+\\/operation-family\\/([^/]+)$/)?.[1];\n if (name === undefined) throw new Error(`API-reference family identity is not canonical: '${operationFamilyRef}'`);\n return name;\n}\n\n/\n A target's public href. Each resource has its own page (#1623), so a resource-scoped target is\n * addressed on that page (`/api/tasks#operation-create-task`) and only a category stays on the\n * section root — the page plan that registers the routes decides, so a guide link and a route can\n * never disagree about where a target lives.\n /\nfunction targetHref(section: OpenApiSection, plan: ApiReferencePagePlan, target: ApiReferencePublicTarget): string {\n return apiReferencePageHref(applicationConsumerDocumentationRoutePath(apiReferenceRouteForSection(section)), apiReferenceTargetFragment(target), plan);\n}\n\n/* The root is an index entry too: a guide may cite it only when that section was generated. /\nfunction sectionRootHref(section: OpenApiSection): string {\n return applicationConsumerDocumentationTargetPath(apiReferenceRouteForSection(section));\n}\n\nfunction identityKey(section: OpenApiSection, identity: ApiReferenceLinkIdentity): string {\n switch (identity.kind) {\n case ApiReferenceLinkIdentityKind.ROOT:\n return `${section}\\0${identity.kind}`;\n case ApiReferenceLinkIdentityKind.CATEGORY:\n return `${section}\\0${identity.kind}\\0${identity.categoryId}`;\n case ApiReferenceLinkIdentityKind.RESOURCE:\n return `${section}\\0${identity.kind}\\0${identity.resourceRef}`;\n case ApiReferenceLinkIdentityKind.OPERATION_FAMILY:\n return `${section}\\0${identity.kind}\\0${identity.operationFamilyRef}`;\n case ApiReferenceLinkIdentityKind.OPERATION_VARIANT:\n case ApiReferenceLinkIdentityKind.REQUEST:\n return `${section}\\0${identity.kind}\\0${identity.operationVariantRef}`;\n case ApiReferenceLinkIdentityKind.RESPONSE:\n return `${section}\\0${identity.kind}\\0${identity.operationVariantRef}\\0${identity.status}`;\n case ApiReferenceLinkIdentityKind.COMPONENT_SCHEMA:\n return `${section}\\0${identity.kind}\\0${identity.schemaName}`;\n default: {\n const exhaustiveIdentity: never = identity;\n throw new Error(`Unsupported API-reference link identity: ${JSON.stringify(exhaustiveIdentity)}`);\n }\n }\n}\n\n/\n Creates links from the exact generated OpenAPI documents.\n \n This is intentionally a fail-closed projection. An HTTP operation without\n * the established source identity, a tag/operation resource mismatch, or a\n * duplicate semantic target means guide links could become ambiguous, so the\n * index is not emitted at all.\n /\nexport function createApiReferenceLinkIndex(sections: readonly OpenApiSectionOutput[]): ApiReferenceLinkIndex {\n const entries: ApiReferenceLinkIndexEntry[] = [];\n const seen = new Set<string>();\n const sectionSet = new Set<OpenApiSection>();\n const identityByHref = new Map<string, string>();\n const add = (section: OpenApiSection, identity: ApiReferenceLinkIdentity, href: string): void => {\n const key = identityKey(section, identity);\n if (seen.has(key)) throw new Error(`API-reference link identity is duplicated: ${key}`);\n const priorIdentity = identityByHref.get(href);\n if (priorIdentity !== undefined && priorIdentity !== key) {\n throw new Error(`API-reference public link '${href}' is ambiguous between ${priorIdentity} and ${key}`);\n }\n seen.add(key);\n identityByHref.set(href, key);\n entries.push({ section, identity, href });\n };\n\n for (const sectionOutput of sections) {\n if (sectionSet.has(sectionOutput.section)) throw new Error(`API-reference section is duplicated: ${sectionOutput.section}`);\n sectionSet.add(sectionOutput.section);\n const document = sectionOutput.document;\n if (!isRecord(document) \|\| !isRecord(document.paths)) throw new Error(`API-reference ${sectionOutput.section} document has no OpenAPI paths object`);\n const pagePlan = buildApiReferencePagePlan(document);\n add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.ROOT }, sectionRootHref(sectionOutput.section));\n const tags = new Map<string, { resourceRef: string }>();\n const usedResourceRefs = new Set<string>();\n const categoryMetadataById = new Map<string, { label: string; description: string \| null }>();\n if (!Array.isArray(document.tags)) throw new Error(`API-reference ${sectionOutput.section} document has no resource tags`);\n for (const tag of document.tags) {\n if (!isRecord(tag) \|\| typeof tag.name !== 'string' \|\| !isRecord(tag['x-wildo']) \|\| typeof tag['x-wildo'].resourceRef !== 'string') {\n throw new Error(`API-reference ${sectionOutput.section} document has a malformed resource tag`);\n }\n if (tags.has(tag.name)) throw new Error(`API-reference ${sectionOutput.section} resource tag is duplicated: '${tag.name}'`);\n const category = tag['x-wildo'].category;\n if (category !== undefined && (!isRecord(category) \|\| typeof category.id !== 'string' \|\| typeof category.label !== 'string'\n \|\| (category.description !== undefined && typeof category.description !== 'string'))) {\n throw new Error(`API-reference resource tag '${tag.name}' has malformed category metadata`);\n }\n const categoryId = isRecord(category) && typeof category.id === 'string' ? category.id : null;\n const categoryLabel = isRecord(category) && typeof category.label === 'string' ? category.label : null;\n const categoryDescription = isRecord(category) && typeof category.description === 'string' ? category.description : null;\n const tagResourceRef = tag['x-wildo'].resourceRef;\n if (resourceName(tagResourceRef) !== tag.name) throw new Error(`API-reference resource tag '${tag.name}' disagrees with its resource identity`);\n tags.set(tag.name, { resourceRef: tagResourceRef });\n add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.RESOURCE, resourceRef: tagResourceRef }, targetHref(sectionOutput.section, pagePlan, {\n kind: ApiReferenceTargetKind.RESOURCE,\n resourceName: tag.name,\n }));\n if (categoryId !== null) {\n if (categoryLabel === null) throw new Error(`API-reference resource tag '${tag.name}' has malformed category metadata`);\n const priorMetadata = categoryMetadataById.get(categoryId);\n if (priorMetadata !== undefined && (priorMetadata.label !== categoryLabel \|\| priorMetadata.description !== categoryDescription)) {\n throw new Error(`API-reference category '${categoryId}' has inconsistent source metadata`);\n }\n categoryMetadataById.set(categoryId, { label: categoryLabel, description: categoryDescription });\n const categoryIdentity = { kind: ApiReferenceLinkIdentityKind.CATEGORY, categoryId } as const;\n const key = identityKey(sectionOutput.section, categoryIdentity);\n if (!seen.has(key)) add(sectionOutput.section, categoryIdentity, targetHref(sectionOutput.section, pagePlan, {\n kind: ApiReferenceTargetKind.CATEGORY,\n categoryName: categoryId,\n }));\n }\n }\n\n for (const [path, pathItem] of Object.entries(document.paths)) {\n if (!isRecord(pathItem)) continue;\n for (const [method, operation] of Object.entries(pathItem)) {\n if (!OPENAPI_HTTP_METHODS.has(method)) continue;\n if (!isRecord(operation) \|\| !isRecord(operation['x-wildo']) \|\| typeof operation.operationId !== 'string') {\n throw new Error(`API-reference ${method.toUpperCase()} ${path} operation has malformed identity metadata`);\n }\n const metadata = operation['x-wildo'];\n if (typeof metadata.resourceRef !== 'string' \|\| typeof metadata.operationFamilyRef !== 'string' \|\| typeof metadata.operationVariantRef !== 'string') {\n throw new Error(`API-reference ${method.toUpperCase()} ${path} operation has incomplete identity metadata`);\n }\n if (metadata.path !== path \|\| metadata.httpVerb !== method) throw new Error(`API-reference ${method.toUpperCase()} ${path} operation identity disagrees with its OpenAPI location`);\n const tag = tags.get(resourceName(metadata.resourceRef));\n if (tag === undefined \|\| tag.resourceRef !== metadata.resourceRef) throw new Error(`API-reference ${method.toUpperCase()} ${path} operation has no matching resource tag`);\n usedResourceRefs.add(metadata.resourceRef);\n const operationTarget = { kind: ApiReferenceTargetKind.OPERATION, operationId: operation.operationId } as const;\n const familyIdentity = { kind: ApiReferenceLinkIdentityKind.OPERATION_FAMILY, operationFamilyRef: metadata.operationFamilyRef } as const;\n if (!seen.has(identityKey(sectionOutput.section, familyIdentity))) {\n add(sectionOutput.section, familyIdentity, targetHref(sectionOutput.section, pagePlan, {\n kind: ApiReferenceTargetKind.OPERATION_FAMILY,\n resourceName: resourceName(metadata.resourceRef),\n operationName: familyName(metadata.operationFamilyRef),\n }));\n }\n add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.OPERATION_VARIANT, operationVariantRef: metadata.operationVariantRef }, targetHref(sectionOutput.section, pagePlan, operationTarget));\n if (isRecord(operation.requestBody)) {\n add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.REQUEST, operationVariantRef: metadata.operationVariantRef }, targetHref(sectionOutput.section, pagePlan, {\n kind: ApiReferenceTargetKind.REQUEST,\n operationId: operation.operationId,\n }));\n }\n if (isRecord(operation.responses)) {\n for (const status of Object.keys(operation.responses)) {\n add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.RESPONSE, operationVariantRef: metadata.operationVariantRef, status }, targetHref(sectionOutput.section, pagePlan, {\n kind: ApiReferenceTargetKind.RESPONSE,\n operationId: operation.operationId,\n status,\n }));\n }\n }\n }\n }\n\n for (const [tagName, tag] of tags) {\n if (!usedResourceRefs.has(tag.resourceRef)) {\n throw new Error(`API-reference resource tag '${tagName}' has no rendered HTTP operation`);\n }\n }\n\n const componentSchemas = isRecord(document.components) && isRecord(document.components.schemas) ? document.components.schemas : {};\n for (const schemaName of Object.keys(componentSchemas)) {\n const target = { kind: ApiReferenceTargetKind.COMPONENT_SCHEMA, schemaName } as const;\n // A schema no operation reaches is rendered on no page, so it is not offered as a target at all\n // — a guide asking for it gets UNAVAILABLE rather than a link to nothing.\n if (pagePlan.pageSlugByFragment[apiReferenceTargetFragment(target)] === undefined) continue;\n add(sectionOutput.section, { kind: ApiReferenceLinkIdentityKind.COMPONENT_SCHEMA, schemaName }, targetHref(sectionOutput.section, pagePlan, target));\n }\n }\n return { schemaVersion: 1, entries: entries.sort((left, right) => identityKey(left.section, left.identity).localeCompare(identityKey(right.section, right.identity))) };\n}\n\n/* Resolves one semantic API target and fails loudly when a guide asks for unavailable documentation. /\nexport function resolveApiReferenceLink(index: ApiReferenceLinkIndex, section: OpenApiSection, identity: ApiReferenceLinkIdentity): string {\n const expectedKey = identityKey(section, identity);\n const entry = index.entries.find((candidate) => identityKey(candidate.section, candidate.identity) === expectedKey);\n if (entry === undefined) throw new Error(`API-reference link target is unavailable: ${expectedKey}`);\n return entry.href;\n}\n\nfunction technicalDocumentationTargetIdentity(target: TechnicalDocumentationApiReferenceTargetV1): {\n readonly section: OpenApiSection;\n readonly identity: ApiReferenceLinkIdentity;\n} {\n const section = target.section === TechnicalDocumentationApiReferenceSection.API_REFERENCE\n ? OpenApiSection.API_REFERENCE\n : OpenApiSection.APPLICATION_ADMINISTRATION_API_REFERENCE;\n switch (target.kind) {\n case TechnicalDocumentationApiReferenceTargetKind.ROOT:\n return { section, identity: { kind: ApiReferenceLinkIdentityKind.ROOT } };\n case TechnicalDocumentationApiReferenceTargetKind.CATEGORY:\n return { section, identity: { kind: ApiReferenceLinkIdentityKind.CATEGORY, categoryId: target.categoryId } };\n case TechnicalDocumentationApiReferenceTargetKind.RESOURCE:\n return { section, identity: { kind: ApiReferenceLinkIdentityKind.RESOURCE, resourceRef: target.resourceRef } };\n case TechnicalDocumentationApiReferenceTargetKind.OPERATION_FAMILY:\n return { section, identity: { kind: ApiReferenceLinkIdentityKind.OPERATION_FAMILY, operationFamilyRef: target.operationFamilyRef } };\n case TechnicalDocumentationApiReferenceTargetKind.OPERATION_VARIANT:\n return { section, identity: { kind: ApiReferenceLinkIdentityKind.OPERATION_VARIANT, operationVariantRef: target.operationVariantRef } };\n case TechnicalDocumentationApiReferenceTargetKind.REQUEST:\n return { section, identity: { kind: ApiReferenceLinkIdentityKind.REQUEST, operationVariantRef: target.operationVariantRef } };\n case TechnicalDocumentationApiReferenceTargetKind.RESPONSE:\n return {\n section,\n identity: {\n kind: ApiReferenceLinkIdentityKind.RESPONSE,\n operationVariantRef: target.operationVariantRef,\n status: target.status,\n },\n };\n case TechnicalDocumentationApiReferenceTargetKind.COMPONENT_SCHEMA:\n return { section, identity: { kind: ApiReferenceLinkIdentityKind.COMPONENT_SCHEMA, schemaName: target.schemaName } };\n default: {\n const exhaustiveTarget: never = target;\n throw new Error(`Unsupported technical-documentation API-reference target: ${JSON.stringify(exhaustiveTarget)}`);\n }\n }\n}\n\n/\n Answers whether a typed target exists in the generated OpenAPI index without\n * manufacturing a URL or turning normal optional-content selection into an\n * exception path. Included guide links must still use the strict resolver.\n /\nexport function getTechnicalDocumentationApiReferenceTargetAvailability(\n index: ApiReferenceLinkIndex,\n target: TechnicalDocumentationApiReferenceTargetV1,\n): TechnicalDocumentationApiReferenceTargetAvailability {\n const { section, identity } = technicalDocumentationTargetIdentity(target);\n const expectedKey = identityKey(section, identity);\n return index.entries.some((candidate) => identityKey(candidate.section, candidate.identity) === expectedKey)\n ? TechnicalDocumentationApiReferenceTargetAvailability.AVAILABLE\n : TechnicalDocumentationApiReferenceTargetAvailability.UNAVAILABLE;\n}\n\n/\n Resolves a portable guide target through the generated OpenAPI index.\n \n The technical-documentation contract owns the semantic target because guide\n * content cannot depend on the renderer package. This adapter is the only\n * place that translates that portable target into the OpenAPI identities used\n * to produce public consumer URLs.\n */\nexport function resolveTechnicalDocumentationApiReferenceLink(\n index: ApiReferenceLinkIndex,\n target: TechnicalDocumentationApiReferenceTargetV1,\n): string {\n const { section, identity } = technicalDocumentationTargetIdentity(target);\n return resolveApiReferenceLink(index, section, identity);\n}\n"]}

package/dist/esm/openapi/api-reference-pages.d.ts ADDED Viewed

@@ -0,0 +1,55 @@
+/**
+ * A page per resource for the API reference, instead of one client-rendered route (#1623).
+ *
+ * The reference was one route that downloaded and parsed the whole published document on every
+ * visit — 9,650,190 bytes for Wonder Todos, measured 2026-09-25 — and addressed every resource,
+ * operation and response by `#fragment` state on a ~10,000 px page. Nothing had a page of its own, so
+ * nothing had static HTML: not for a reader without JavaScript, not for print, not for the site's
+ * search index.
+ *
+ * This module splits one verified OpenAPI document into what a statically built portal serves:
+ *
+ *  - one PAGE per resource (`/api/<slug>`), carrying that resource's operations and ONLY the
+ *    components they reach, so a page is complete on its own;
+ *  - one light INDEX document for the section root: every tag, and every operation reduced to its
+ *    identity and access, which is all the category grid and the in-page search read;
+ *  - the map from every public fragment to the page it now lives on, so a link written for the
+ *    single-page reference (`/api#operation-…`) still reaches its target, and so the link index
+ *    builds guide links from the same answer.
+ *
+ * It is pure and imports nothing browser- or Node-specific, so the build plugin that registers the
+ * routes and the publication step that writes guide links compute the same plan.
+ */
+type JsonRecord = Record<string, unknown>;
+/** One resource's page: its slug, its resource name, and the self-sufficient document it renders. */
+export interface ApiReferenceResourcePage {
+    readonly slug: string;
+    readonly resourceName: string;
+    readonly document: JsonRecord;
+}
+export interface ApiReferencePagePlan {
+    /** The section root's document: every tag, and every operation reduced to identity and access. */
+    readonly indexDocument: JsonRecord;
+    readonly pages: readonly ApiReferenceResourcePage[];
+    /** Every public fragment that lives on a resource page, with that page's slug. */
+    readonly pageSlugByFragment: Readonly<Record<string, string>>;
+}
+/** Split one verified OpenAPI document into resource pages, an index, and the fragment → page map. */
+export declare function buildApiReferencePagePlan(document: unknown): ApiReferencePagePlan;
+/**
+ * The page slug of `fragment`, reading a request or response fragment as its operation's
+ * (`operation-x--response-200` lives wherever `operation-x` does). That lets a landing page carry the
+ * map WITHOUT the request and response anchors, which were most of its bytes (572 KB of the 1.6 MB
+ * Wonder Todos index, measured 2026-09-25): see `withoutOperationSubFragments`.
+ */
+export declare function apiReferencePageSlugForFragment(fragment: string, pageSlugByFragment: Readonly<Record<string, string>>): string | undefined;
+/** The fragment map without request and response anchors, which `apiReferencePageSlugForFragment` derives. */
+export declare function withoutOperationSubFragments(pageSlugByFragment: Readonly<Record<string, string>>): Readonly<Record<string, string>>;
+/**
+ * The href of a public fragment in a section whose resources have pages: the resource page when the
+ * fragment lives on one (`/api/tasks#operation-create-task`), the section root otherwise (a category
+ * lives on the index). A resource's own fragment is its page, with no fragment.
+ */
+export declare function apiReferencePageHref(sectionRootPath: string, fragment: string, plan: Pick<ApiReferencePagePlan, 'pageSlugByFragment'>): string;
+export {};
+//# sourceMappingURL=api-reference-pages.d.ts.map

package/dist/esm/openapi/api-reference-pages.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"api-reference-pages.d.ts","sourceRoot":"","sources":["../../../src/openapi/api-reference-pages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAQH,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAS1C,qGAAqG;AACrG,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,kGAAkG;IAClG,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACpD,kFAAkF;IAClF,QAAQ,CAAC,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC/D;AAsFD,sGAAsG;AACtG,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,OAAO,GAAG,oBAAoB,CAiFjF;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,EAAE,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,GAAG,SAAS,CAE1I;AAED,8GAA8G;AAC9G,wBAAgB,4BAA4B,CAAC,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAEnI;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,GAAG,MAAM,CAI9I"}

package/dist/esm/openapi/api-reference-pages.js ADDED Viewed

@@ -0,0 +1,229 @@
+/**
+ * A page per resource for the API reference, instead of one client-rendered route (#1623).
+ *
+ * The reference was one route that downloaded and parsed the whole published document on every
+ * visit — 9,650,190 bytes for Wonder Todos, measured 2026-09-25 — and addressed every resource,
+ * operation and response by `#fragment` state on a ~10,000 px page. Nothing had a page of its own, so
+ * nothing had static HTML: not for a reader without JavaScript, not for print, not for the site's
+ * search index.
+ *
+ * This module splits one verified OpenAPI document into what a statically built portal serves:
+ *
+ *  - one PAGE per resource (`/api/<slug>`), carrying that resource's operations and ONLY the
+ *    components they reach, so a page is complete on its own;
+ *  - one light INDEX document for the section root: every tag, and every operation reduced to its
+ *    identity and access, which is all the category grid and the in-page search read;
+ *  - the map from every public fragment to the page it now lives on, so a link written for the
+ *    single-page reference (`/api#operation-…`) still reaches its target, and so the link index
+ *    builds guide links from the same answer.
+ *
+ * It is pure and imports nothing browser- or Node-specific, so the build plugin that registers the
+ * routes and the publication step that writes guide links compute the same plan.
+ */
+import { ApiReferenceTargetKind, apiReferenceResourcePageSlug, apiReferenceTargetFragment, } from './api-reference-targets.js';
+const HTTP_METHODS = new Set(['get', 'put', 'post', 'delete', 'options', 'head', 'patch', 'trace']);
+/** Path segments the section roots already use; a resource page may never shadow one. */
+const RESERVED_PAGE_SLUGS = new Set(['application-administration']);
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+function resourceNameOf(operation) {
+    const metadata = operation['x-wildo'];
+    const resourceRef = isRecord(metadata) && typeof metadata.resourceRef === 'string' ? metadata.resourceRef : '';
+    const name = resourceRef.match(/^technical-documentation:resource\/([^/]+)$/)?.[1];
+    if (name === undefined)
+        throw new Error(`API-reference page plan: operation '${String(operation.operationId)}' has no canonical resource identity`);
+    return name;
+}
+function familyNameOf(operation) {
+    const metadata = operation['x-wildo'];
+    const familyRef = isRecord(metadata) && typeof metadata.operationFamilyRef === 'string' ? metadata.operationFamilyRef : '';
+    const name = familyRef.match(/\/operation-family\/([^/]+)$/)?.[1];
+    if (name === undefined)
+        throw new Error(`API-reference page plan: operation '${String(operation.operationId)}' has no canonical family identity`);
+    return name;
+}
+/** Every `#/components/<kind>/<name>` reference in `node`, recursively. */
+function collectReferences(node, into) {
+    if (Array.isArray(node)) {
+        for (const entry of node)
+            collectReferences(entry, into);
+        return;
+    }
+    if (!isRecord(node))
+        return;
+    if (typeof node.$ref === 'string' && node.$ref.startsWith('#/components/'))
+        into.add(node.$ref);
+    for (const value of Object.values(node))
+        collectReferences(value, into);
+}
+/**
+ * The components a set of operations reaches, closed transitively: a schema that references another
+ * schema brings it along, and a shared response brings the schema its body names.
+ */
+function componentClosure(paths, components) {
+    const componentSchemas = isRecord(components.schemas) ? components.schemas : {};
+    const componentResponses = isRecord(components.responses) ? components.responses : {};
+    const pending = new Set();
+    collectReferences(paths, pending);
+    const schemas = {};
+    const responses = {};
+    const visited = new Set();
+    while (pending.size > 0) {
+        const [reference] = pending;
+        pending.delete(reference);
+        if (visited.has(reference))
+            continue;
+        visited.add(reference);
+        const [, kind, name] = reference.match(/^#\/components\/([^/]+)\/(.+)$/) ?? [];
+        const target = kind === 'schemas' ? componentSchemas[name] : kind === 'responses' ? componentResponses[name] : undefined;
+        if (target === undefined)
+            continue;
+        if (kind === 'schemas')
+            schemas[name] = target;
+        else
+            responses[name] = target;
+        const more = new Set();
+        collectReferences(target, more);
+        for (const next of more)
+            if (!visited.has(next))
+                pending.add(next);
+    }
+    return { schemas, responses };
+}
+/**
+ * An operation as the index needs it: identity, summary, method, path and access — the fields the
+ * category grid and the in-page search read. Parameters, bodies and responses stay on the page, and
+ * so does the role prose (the index shows role LABELS), which is most of an operation's weight.
+ */
+function indexOperation(operation) {
+    const metadata = isRecord(operation['x-wildo']) ? operation['x-wildo'] : {};
+    const access = isRecord(metadata.access) ? metadata.access : {};
+    const roleRequirements = Array.isArray(access.roleRequirements)
+        ? access.roleRequirements.map((requirement) => (isRecord(requirement) ? { role: requirement.role, label: requirement.label } : requirement))
+        : [];
+    return {
+        operationId: operation.operationId,
+        ...(operation.summary === undefined ? {} : { summary: operation.summary }),
+        ...(operation.tags === undefined ? {} : { tags: operation.tags }),
+        ...(operation.security === undefined ? {} : { security: operation.security }),
+        'x-wildo': {
+            resourceRef: metadata.resourceRef,
+            operationFamilyRef: metadata.operationFamilyRef,
+            operationVariantRef: metadata.operationVariantRef,
+            path: metadata.path,
+            httpVerb: metadata.httpVerb,
+            ...(metadata.aliasOfPath === undefined ? {} : { aliasOfPath: metadata.aliasOfPath }),
+            access: { authenticationMode: access.authenticationMode, authenticationSummary: access.authenticationSummary, roleRequirements },
+        },
+    };
+}
+/** Split one verified OpenAPI document into resource pages, an index, and the fragment → page map. */
+export function buildApiReferencePagePlan(document) {
+    if (!isRecord(document) || !isRecord(document.paths))
+        throw new Error('API-reference page plan: document has no OpenAPI paths object');
+    const components = isRecord(document.components) ? document.components : {};
+    const operationsByResource = new Map();
+    for (const [path, pathItem] of Object.entries(document.paths)) {
+        if (!isRecord(pathItem))
+            continue;
+        for (const [method, operation] of Object.entries(pathItem)) {
+            if (!HTTP_METHODS.has(method) || !isRecord(operation))
+                continue;
+            const resourceName = resourceNameOf(operation);
+            operationsByResource.set(resourceName, [...(operationsByResource.get(resourceName) ?? []), { path, method, operation }]);
+        }
+    }
+    const pageSlugByFragment = {};
+    const claim = (fragment, slug) => {
+        const owner = pageSlugByFragment[fragment];
+        if (owner !== undefined && owner !== slug)
+            throw new Error(`API-reference page plan: fragment '${fragment}' belongs to two pages ('${owner}', '${slug}')`);
+        pageSlugByFragment[fragment] = slug;
+    };
+    const slugByResource = new Map();
+    const pages = [];
+    const indexPaths = {};
+    for (const resourceName of [...operationsByResource.keys()].sort((left, right) => left.localeCompare(right))) {
+        const slug = apiReferenceResourcePageSlug(resourceName);
+        if (RESERVED_PAGE_SLUGS.has(slug))
+            throw new Error(`API-reference page plan: resource '${resourceName}' would shadow the reserved route '${slug}'`);
+        const clash = [...slugByResource.entries()].find(([, existing]) => existing === slug);
+        if (clash !== undefined)
+            throw new Error(`API-reference page plan: resources '${clash[0]}' and '${resourceName}' share the page '${slug}'`);
+        slugByResource.set(resourceName, slug);
+        const paths = {};
+        claim(apiReferenceTargetFragment({ kind: ApiReferenceTargetKind.RESOURCE, resourceName }), slug);
+        for (const { path, method, operation } of operationsByResource.get(resourceName)) {
+            paths[path] = { ...(paths[path] ?? {}), [method]: operation };
+            indexPaths[path] = { ...(indexPaths[path] ?? {}), [method]: indexOperation(operation) };
+            const operationId = String(operation.operationId);
+            claim(apiReferenceTargetFragment({ kind: ApiReferenceTargetKind.OPERATION_FAMILY, resourceName, operationName: familyNameOf(operation) }), slug);
+            claim(apiReferenceTargetFragment({ kind: ApiReferenceTargetKind.OPERATION, operationId }), slug);
+            if (isRecord(operation.requestBody))
+                claim(apiReferenceTargetFragment({ kind: ApiReferenceTargetKind.REQUEST, operationId }), slug);
+            for (const status of Object.keys(isRecord(operation.responses) ? operation.responses : {})) {
+                claim(apiReferenceTargetFragment({ kind: ApiReferenceTargetKind.RESPONSE, operationId, status }), slug);
+            }
+        }
+        const closure = componentClosure(paths, components);
+        // A reusable schema lives on the first page (by slug) that reaches it; later pages link to it there.
+        for (const schemaName of Object.keys(closure.schemas)) {
+            const fragment = apiReferenceTargetFragment({ kind: ApiReferenceTargetKind.COMPONENT_SCHEMA, schemaName });
+            if (pageSlugByFragment[fragment] === undefined)
+                pageSlugByFragment[fragment] = slug;
+        }
+        pages.push({
+            slug,
+            resourceName,
+            document: {
+                openapi: document.openapi,
+                ...(isRecord(document.info) ? { info: { title: document.info.title, version: document.info.version } } : {}),
+                ...(document.servers === undefined ? {} : { servers: document.servers }),
+                // Every tag, so a relationship to another resource is labelled by that resource's own name.
+                ...(document.tags === undefined ? {} : { tags: document.tags }),
+                paths,
+                components: {
+                    schemas: closure.schemas,
+                    ...(Object.keys(closure.responses).length > 0 ? { responses: closure.responses } : {}),
+                    ...(components.securitySchemes === undefined ? {} : { securitySchemes: components.securitySchemes }),
+                },
+            },
+        });
+    }
+    return {
+        indexDocument: {
+            openapi: document.openapi,
+            ...(document.info === undefined ? {} : { info: document.info }),
+            ...(document.servers === undefined ? {} : { servers: document.servers }),
+            ...(document.tags === undefined ? {} : { tags: document.tags }),
+            paths: indexPaths,
+            components: components.securitySchemes === undefined ? {} : { securitySchemes: components.securitySchemes },
+        },
+        pages,
+        pageSlugByFragment,
+    };
+}
+/**
+ * The page slug of `fragment`, reading a request or response fragment as its operation's
+ * (`operation-x--response-200` lives wherever `operation-x` does). That lets a landing page carry the
+ * map WITHOUT the request and response anchors, which were most of its bytes (572 KB of the 1.6 MB
+ * Wonder Todos index, measured 2026-09-25): see `withoutOperationSubFragments`.
+ */
+export function apiReferencePageSlugForFragment(fragment, pageSlugByFragment) {
+    return pageSlugByFragment[fragment] ?? pageSlugByFragment[fragment.replace(/--(request|response-[a-z0-9-]+)$/, '')];
+}
+/** The fragment map without request and response anchors, which `apiReferencePageSlugForFragment` derives. */
+export function withoutOperationSubFragments(pageSlugByFragment) {
+    return Object.fromEntries(Object.entries(pageSlugByFragment).filter(([fragment]) => !/^operation-.+--(request|response-[a-z0-9-]+)$/.test(fragment)));
+}
+/**
+ * The href of a public fragment in a section whose resources have pages: the resource page when the
+ * fragment lives on one (`/api/tasks#operation-create-task`), the section root otherwise (a category
+ * lives on the index). A resource's own fragment is its page, with no fragment.
+ */
+export function apiReferencePageHref(sectionRootPath, fragment, plan) {
+    const slug = apiReferencePageSlugForFragment(fragment, plan.pageSlugByFragment);
+    if (slug === undefined)
+        return `${sectionRootPath}#${fragment}`;
+    return fragment === `resource-${slug}` ? `${sectionRootPath}/${slug}` : `${sectionRootPath}/${slug}#${fragment}`;
+}
+//# sourceMappingURL=api-reference-pages.js.map