@wildo-ai/saas-technical-doc 1.1.4 → 1.1.6

package/dist/esm/runtime/frontend-provider-registry.techdoc.js.map

@@ -1 +1 @@
-{"version":3,"file":"frontend-provider-registry.techdoc.js","sourceRoot":"","sources":["../../../src/runtime/frontend-provider-registry.techdoc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACL,uCAAuC,GAIxC,MAAM,8CAA8C,CAAC;AAsBtD;;GAEG;AACH,MAAM,UAAU,qCAAqC,CACnD,KAAkD;IAElD,OAAO,uCAAuC,CAAC;QAC7C,OAAO,EAAE,KAAK,EAAE,OAAO;QACvB,OAAO,EAAE,KAAK,EAAE,OAAO;QACvB,YAAY,EAAE,KAAK,EAAE,YAAY;KAClC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\n * The technical doc's provider registry — now composed from BOTH channels.\n *\n * It used to build itself by casting each served `FrontendProviderEntry` to a\n * module type that was an alias of that entry, which made the cast true and\n * useless: the registry could never hold anything a JSON payload could not\n * carry, so a provider's SDK loader had nowhere to arrive.\n *\n *   - **DATA** — the materialized frontend-services block for THIS docs service.\n *     Authoritative for which providers are on, in this environment.\n *   - **CODE** — `generatedFrontendProviderModules` from the docs site's own\n *     `src/generated/frontend-providers.generated.ts`, written by\n *     `wildo config sync` and handed to `DocsAuthProvider` by the Root swizzle.\n *\n * The types are now the engine's own techdoc-facet types rather than local\n * aliases, so a provider module authored against\n * `@wildo-ai/external-connectors-public/techdoc` is the same type this registry\n * holds. Re-exported under the same names so every consumer's import is\n * unchanged.\n */\n\nimport {\n  composeHydratedFrontendTechdocProviders,\n  type FrontendProviderHydrationDiagnostic,\n  type FrontendTechdocProviderRegistry,\n  type GeneratedTechdocProviderModules,\n} from '@wildo-ai/external-connectors-public/techdoc';\nimport type { FrontendProvidersBlock } from '@wildo-ai/saas-models/public-runtime';\n\nexport type {\n  FrontendTechdocProviderModule,\n  FrontendTechdocProviderRef,\n  FrontendTechdocProviderRegistry,\n  GeneratedTechdocProviderModules,\n} from '@wildo-ai/external-connectors-public/techdoc';\n\nexport interface CreateFrontendTechdocProviderRegistryInput {\n  /** The DATA channel: the materialized block for this docs service. */\n  readonly entries?: FrontendProvidersBlock;\n  /**\n   * The CODE channel. Absent is the ordinary case for a docs site that declares\n   * no package-shipped provider — `wildo config sync` writes no generated file,\n   * so there is nothing to import and nothing to pass.\n   */\n  readonly modules?: GeneratedTechdocProviderModules;\n  readonly onDiagnostic?: (diagnostic: FrontendProviderHydrationDiagnostic) => void;\n}\n\n/**\n * Tech-doc runtime registry, hydrated from both channels.\n */\nexport function createFrontendTechdocProviderRegistry(\n  input?: CreateFrontendTechdocProviderRegistryInput,\n): FrontendTechdocProviderRegistry {\n  return composeHydratedFrontendTechdocProviders({\n    entries: input?.entries,\n    modules: input?.modules,\n    onDiagnostic: input?.onDiagnostic,\n  });\n}\n"]}
+{"version":3,"file":"frontend-provider-registry.techdoc.js","sourceRoot":"","sources":["../../../../src/runtime/frontend-provider-registry.techdoc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACL,uCAAuC,GAIxC,MAAM,8CAA8C,CAAC;AAqBtD;;GAEG;AACH,MAAM,UAAU,qCAAqC,CACnD,KAAkD;IAElD,OAAO,uCAAuC,CAAC;QAC7C,OAAO,EAAE,KAAK,EAAE,OAAO;QACvB,OAAO,EAAE,KAAK,EAAE,OAAO;QACvB,YAAY,EAAE,KAAK,EAAE,YAAY;KAClC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\n * The technical doc's provider registry — now composed from BOTH channels.\n *\n * It used to build itself by casting each served `FrontendProviderEntry` to a\n * module type that was an alias of that entry, which made the cast true and\n * useless: the registry could never hold anything a JSON payload could not\n * carry, so a provider's SDK loader had nowhere to arrive.\n *\n *   - **DATA** — the materialized frontend-services block for THIS docs service.\n *     Authoritative for which providers are on, in this environment.\n *   - **CODE** — `generatedFrontendProviderModules` from the docs site's own\n *     `src/generated/frontend-providers.generated.ts`, written by\n *     `wildo config sync` and handed to `DocsAuthProvider` by the Root swizzle.\n *\n * The types are now the engine's own techdoc-facet types rather than local\n * aliases, so a provider module authored against\n * `@wildo-ai/external-connectors-public/techdoc` is the same type this registry\n * holds. Re-exported under the same names so every consumer's import is\n * unchanged.\n */\n\nimport {\n  composeHydratedFrontendTechdocProviders,\n  type FrontendProviderHydrationDiagnostic,\n  type FrontendTechdocProviderRegistry,\n  type GeneratedTechdocProviderModules,\n} from '@wildo-ai/external-connectors-public/techdoc';\nimport type { FrontendProvidersBlock } from '@wildo-ai/saas-models/public-runtime';\n\nexport type {\n  FrontendTechdocProviderModule,\n  FrontendTechdocProviderRef,\n  FrontendTechdocProviderRegistry,\n  GeneratedTechdocProviderModules,\n} from '@wildo-ai/external-connectors-public/techdoc';\n\nexport interface CreateFrontendTechdocProviderRegistryInput {\n  /** The DATA channel: the materialized block for this docs service. */\n  readonly entries?: FrontendProvidersBlock;\n  /**\n   * The CODE channel. Absent is the ordinary case for a docs site that declares\n   * no providers. Config sync still writes an empty map so startup imports remain stable.\n   */\n  readonly modules?: GeneratedTechdocProviderModules;\n  readonly onDiagnostic?: (diagnostic: FrontendProviderHydrationDiagnostic) => void;\n}\n\n/**\n * Tech-doc runtime registry, hydrated from both channels.\n */\nexport function createFrontendTechdocProviderRegistry(\n  input?: CreateFrontendTechdocProviderRegistryInput,\n): FrontendTechdocProviderRegistry {\n  return composeHydratedFrontendTechdocProviders({\n    entries: input?.entries,\n    modules: input?.modules,\n    onDiagnostic: input?.onDiagnostic,\n  });\n}\n"]}

package/dist/esm/runtime/index.d.ts

@@ -46,13 +46,21 @@ export * from './docs-auth-session.schemas';
 export * from './decode-jwt-claims';
 export * from './docs-auth-client';
 export * from './DocsAuthContext';
+export * from './DocsFrontendProviders';
 export * from './frontend-provider-registry.techdoc';
 export { FrontendProviderEntrySchema, FrontendProvidersBlockSchema, type FrontendProviderEntry, type FrontendProvidersBlock, } from '@wildo-ai/saas-models/public-runtime';
 export * from './use-docs-auth-session';
 export * from './use-docs-frontend-provider-registry';
 export * from './use-docs-provider-sdks';
+export * from './use-docs-provider-scripts';
+export * from './provider-component-registry.techdoc';
+export * from './use-docs-provider-component';
+export * from './DocsProviderComponent';
 export * from './AuthExchangePage';
 export * from './openapi-reference-model';
+export * from './openapi-reference-navigation';
 export * from './openapi-reference-conservation';
 export * from './openapi-reference-view';
+export * from './openapi-reference-words';
+export * from './documentation-site-translator';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAuBH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sCAAsC,CAAC;AACrD,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,sCAAsC,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uCAAuC,CAAC;AACtD,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAuBH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sCAAsC,CAAC;AACrD,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,sCAAsC,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uCAAuC,CAAC;AACtD,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uCAAuC,CAAC;AACtD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC"}

package/dist/esm/runtime/index.js

@@ -65,13 +65,21 @@ export * from './docs-auth-session.schemas.js';
 export * from './decode-jwt-claims.js';
 export * from './docs-auth-client.js';
 export * from './DocsAuthContext.js';
+export * from './DocsFrontendProviders.js';
 export * from './frontend-provider-registry.techdoc.js';
 export { FrontendProviderEntrySchema, FrontendProvidersBlockSchema, } from '@wildo-ai/saas-models/public-runtime';
 export * from './use-docs-auth-session.js';
 export * from './use-docs-frontend-provider-registry.js';
 export * from './use-docs-provider-sdks.js';
+export * from './use-docs-provider-scripts.js';
+export * from './provider-component-registry.techdoc.js';
+export * from './use-docs-provider-component.js';
+export * from './DocsProviderComponent.js';
 export * from './AuthExchangePage.js';
 export * from './openapi-reference-model.js';
+export * from './openapi-reference-navigation.js';
 export * from './openapi-reference-conservation.js';
 export * from './openapi-reference-view.js';
+export * from './openapi-reference-words.js';
+export * from './documentation-site-translator.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAErE,yBAAyB,CAAC,CAAC,CAAC,CAAC;AAE7B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sCAAsC,CAAC;AACrD,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,GAG7B,MAAM,sCAAsC,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uCAAuC,CAAC;AACtD,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,0BAA0B,CAAC","sourcesContent":["/**\n * `@wildo-ai/saas-technical-doc/runtime` — browser-only auth runtime\n * for the Docusaurus-served docs site (saas-technical-doc.md K-9b).\n *\n * Public surface (consumed by the three Docusaurus swizzles per K-11):\n *\n *   - `<DocsAuthProvider apiBaseUrl=\"…\">` — Root swizzle wraps children.\n *   - `useDocsAuthSession()`              — Navbar + DocItem swizzles read.\n *   - `<AuthExchangePage />`              — mounted at `/auth/exchange`.\n *   - `DocsAuthClient`                    — direct access for the DocItem\n *                                           swizzle's \"request handoff back\n *                                           to app\" code path.\n *   - `DocsAuthClientError` + code type   — typed error branch surface.\n *   - `DocsRole` / `DocsAuthSession`      — discriminated-union types.\n *   - `useDocsFrontendProviderRegistry()` — read the materialized frontend\n *                                           provider registry for this docs\n *                                           service (search / future SDK\n *                                           widgets).\n *   - `decodeJwtClaims`                   — exposed so apps can decode\n *                                           access tokens issued by\n *                                           non-handoff flows (rare;\n *                                           reserved for advanced use).\n *\n * @wildo-boundary\n *   - This sub-tree MAY use React, `react-dom`, the browser `fetch`, and\n *     the browser `atob` global. It MUST NOT import:\n *       - Node built-ins (`fs`, `path`, …)         — would break Docusaurus\n *                                                     client bundle.\n *       - `@wildo-ai/saas-frontend-lib`            — entire point of K-9b\n *                                                     is to NOT pull this.\n *       - inversify                                — reserved for the SaaS\n *                                                     app DI stack.\n *   - This sub-tree MAY import shared schemas + DTO types from\n *     `@wildo-ai/saas-models/public-runtime` (the lightweight subset\n *     allow-listed by `runtime-bundle-isolation.test.ts`).\n *   - This sub-tree MUST initialize `@wildo-ai/zod-decorators` at runtime\n *     entry — see the `ensureZodDecoratorsLoaded(z)` side-effect below.\n *     Skipping this leaves the docs runtime with an under-augmented Zod\n *     `ZodObject` declaration, which historically caused cross-package\n *     `z.infer` widening (the H-3 / M-7 cross-frontend-handoff incident,\n *     see `.cursor/plans/cross-app-jwt-propagation.md`).\n *   - The package's `./companion` and `./` (root) entries MUST NOT import\n *     from this sub-tree (see those files' boundary blocks).\n */\n\n/**\n * Boot the project's Zod decorator augmentation for this bundle.\n *\n * `@wildo-ai/saas-models/public-runtime` re-exports schemas authored\n * against the augmented `ZodObject` interface declared by\n * `@wildo-ai/zod-decorators`. Without `ensureZodDecoratorsLoaded(z)`\n * being called once on this bundle's Zod instance, the docs runtime sees\n * a schema graph whose `.shape` access paths and `z.infer` results don't\n * match what the SaaS app sees — a silent contract drift that bit us in\n * H-3 / M-7. The call is idempotent (guarded inside the function) so\n * importing this module multiple times is a no-op after the first load.\n *\n * The bare-specifier import is allow-listed by\n * `runtime-bundle-isolation.test.ts` (revised 2026-04-19); the package\n * itself is browser-safe (it only mutates `z.ZodType.prototype`).\n */\nimport { z } from 'zod';\nimport { ensureZodDecoratorsLoaded } from '@wildo-ai/zod-decorators';\n\nensureZodDecoratorsLoaded(z);\n\nexport * from './docs-auth-session.schemas';\nexport * from './decode-jwt-claims';\nexport * from './docs-auth-client';\nexport * from './DocsAuthContext';\nexport * from './frontend-provider-registry.techdoc';\nexport {\n  FrontendProviderEntrySchema,\n  FrontendProvidersBlockSchema,\n  type FrontendProviderEntry,\n  type FrontendProvidersBlock,\n} from '@wildo-ai/saas-models/public-runtime';\nexport * from './use-docs-auth-session';\nexport * from './use-docs-frontend-provider-registry';\nexport * from './use-docs-provider-sdks';\nexport * from './AuthExchangePage';\nexport * from './openapi-reference-model';\nexport * from './openapi-reference-conservation';\nexport * from './openapi-reference-view';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAErE,yBAAyB,CAAC,CAAC,CAAC,CAAC;AAE7B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sCAAsC,CAAC;AACrD,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,GAG7B,MAAM,sCAAsC,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uCAAuC,CAAC;AACtD,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uCAAuC,CAAC;AACtD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC","sourcesContent":["/**\n * `@wildo-ai/saas-technical-doc/runtime` — browser-only auth runtime\n * for the Docusaurus-served docs site (saas-technical-doc.md K-9b).\n *\n * Public surface (consumed by the three Docusaurus swizzles per K-11):\n *\n *   - `<DocsAuthProvider apiBaseUrl=\"…\">` — Root swizzle wraps children.\n *   - `useDocsAuthSession()`              — Navbar + DocItem swizzles read.\n *   - `<AuthExchangePage />`              — mounted at `/auth/exchange`.\n *   - `DocsAuthClient`                    — direct access for the DocItem\n *                                           swizzle's \"request handoff back\n *                                           to app\" code path.\n *   - `DocsAuthClientError` + code type   — typed error branch surface.\n *   - `DocsRole` / `DocsAuthSession`      — discriminated-union types.\n *   - `useDocsFrontendProviderRegistry()` — read the materialized frontend\n *                                           provider registry for this docs\n *                                           service (search / future SDK\n *                                           widgets).\n *   - `decodeJwtClaims`                   — exposed so apps can decode\n *                                           access tokens issued by\n *                                           non-handoff flows (rare;\n *                                           reserved for advanced use).\n *\n * @wildo-boundary\n *   - This sub-tree MAY use React, `react-dom`, the browser `fetch`, and\n *     the browser `atob` global. It MUST NOT import:\n *       - Node built-ins (`fs`, `path`, …)         — would break Docusaurus\n *                                                     client bundle.\n *       - `@wildo-ai/saas-frontend-lib`            — entire point of K-9b\n *                                                     is to NOT pull this.\n *       - inversify                                — reserved for the SaaS\n *                                                     app DI stack.\n *   - This sub-tree MAY import shared schemas + DTO types from\n *     `@wildo-ai/saas-models/public-runtime` (the lightweight subset\n *     allow-listed by `runtime-bundle-isolation.test.ts`).\n *   - This sub-tree MUST initialize `@wildo-ai/zod-decorators` at runtime\n *     entry — see the `ensureZodDecoratorsLoaded(z)` side-effect below.\n *     Skipping this leaves the docs runtime with an under-augmented Zod\n *     `ZodObject` declaration, which historically caused cross-package\n *     `z.infer` widening (the H-3 / M-7 cross-frontend-handoff incident,\n *     see `.cursor/plans/cross-app-jwt-propagation.md`).\n *   - The package's `./companion` and `./` (root) entries MUST NOT import\n *     from this sub-tree (see those files' boundary blocks).\n */\n\n/**\n * Boot the project's Zod decorator augmentation for this bundle.\n *\n * `@wildo-ai/saas-models/public-runtime` re-exports schemas authored\n * against the augmented `ZodObject` interface declared by\n * `@wildo-ai/zod-decorators`. Without `ensureZodDecoratorsLoaded(z)`\n * being called once on this bundle's Zod instance, the docs runtime sees\n * a schema graph whose `.shape` access paths and `z.infer` results don't\n * match what the SaaS app sees — a silent contract drift that bit us in\n * H-3 / M-7. The call is idempotent (guarded inside the function) so\n * importing this module multiple times is a no-op after the first load.\n *\n * The bare-specifier import is allow-listed by\n * `runtime-bundle-isolation.test.ts` (revised 2026-04-19); the package\n * itself is browser-safe (it only mutates `z.ZodType.prototype`).\n */\nimport { z } from 'zod';\nimport { ensureZodDecoratorsLoaded } from '@wildo-ai/zod-decorators';\n\nensureZodDecoratorsLoaded(z);\n\nexport * from './docs-auth-session.schemas';\nexport * from './decode-jwt-claims';\nexport * from './docs-auth-client';\nexport * from './DocsAuthContext';\nexport * from './DocsFrontendProviders';\nexport * from './frontend-provider-registry.techdoc';\nexport {\n  FrontendProviderEntrySchema,\n  FrontendProvidersBlockSchema,\n  type FrontendProviderEntry,\n  type FrontendProvidersBlock,\n} from '@wildo-ai/saas-models/public-runtime';\nexport * from './use-docs-auth-session';\nexport * from './use-docs-frontend-provider-registry';\nexport * from './use-docs-provider-sdks';\nexport * from './use-docs-provider-scripts';\nexport * from './provider-component-registry.techdoc';\nexport * from './use-docs-provider-component';\nexport * from './DocsProviderComponent';\nexport * from './AuthExchangePage';\nexport * from './openapi-reference-model';\nexport * from './openapi-reference-navigation';\nexport * from './openapi-reference-conservation';\nexport * from './openapi-reference-view';\nexport * from './openapi-reference-words';\nexport * from './documentation-site-translator';\n"]}

package/dist/esm/runtime/openapi-reference-conservation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openapi-reference-conservation.d.ts","sourceRoot":"","sources":["../../../src/runtime/openapi-reference-conservation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACzF,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAwE5F;;;;GAIG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,oBAAoB,EAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAiBjH;AAED,4EAA4E;AAC5E,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,oBAAoB,GAAG,iBAAiB,CAIjG"}
+{"version":3,"file":"openapi-reference-conservation.d.ts","sourceRoot":"","sources":["../../../../src/runtime/openapi-reference-conservation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACzF,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAwE5F;;;;GAIG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,oBAAoB,EAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAiBjH;AAED,4EAA4E;AAC5E,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,oBAAoB,GAAG,iBAAiB,CAIjG"}

package/dist/esm/runtime/openapi-reference-model.d.ts

@@ -14,14 +14,33 @@ export interface ApiReferenceVariant {
     readonly description: string | null;
     readonly method: string;
     readonly path: string;
+    /**
+     * The canonical path when this route is the same operation reached through a parent
+     * (`x-wildo.aliasOfPath`), else `null`. The variant stays a variant — conservation counts it — and
+     * the view presents it under the canonical operation instead of as a duplicate.
+     */
+    readonly aliasOfPath: string | null;
     /** Source-projected authentication and authorization explanation. */
     readonly access: ApiReferenceAccess;
     readonly securitySchemes: readonly string[];
     readonly parameters: readonly ApiReferenceParameter[];
     readonly requestBody: ApiReferenceRequestBody | null;
     readonly responses: readonly ApiReferenceResponse[];
+    /** Documented failure modes from `x-wildo.errorScenarios`, in authored order. */
+    readonly errorScenarios: readonly ApiReferenceErrorScenario[];
     readonly idempotent: boolean | null;
 }
+/**
+ * One documented failure mode, with each identifier named by the error-body field a client reads
+ * it from: `error.type`, `error.customMessageReference` and `error.code` are three fields.
+ */
+export interface ApiReferenceErrorScenario {
+    readonly status: string;
+    readonly when: string;
+    readonly errorType: string | null;
+    readonly customMessageReference: string | null;
+    readonly errorCode: string | null;
+}
 /** A standard OpenAPI parameter, normalized for a documentation renderer. */
 export interface ApiReferenceParameter {
     readonly name: string;
@@ -94,6 +113,11 @@ export interface ApiReferenceResource {
     readonly description: string | null;
     readonly lifecycleRole: string | null;
     readonly relationships: readonly ApiReferenceResourceRelationship[];
+    /**
+     * The reusable schema that IS this resource's representation (`x-wildo.objectSchema`), when the
+     * generator published one: "the Tasks object", shown once on the resource page.
+     */
+    readonly objectSchemaName: string | null;
     readonly families: readonly ApiReferenceFamily[];
 }
 /** A source-declared API-resource category, never inferred from resource names. */
@@ -125,6 +149,7 @@ export interface ApiReferenceSchemaNode {
     readonly types: readonly string[];
     readonly description: string | null;
     readonly format: string | null;
+    /** In the order the contract declares them — the view decides reading order, not the model. */
     readonly properties: readonly ApiReferenceSchemaProperty[];
     readonly items: ApiReferenceSchemaNode | null;
     readonly compositions: readonly ApiReferenceSchemaComposition[];
@@ -190,6 +215,11 @@ export interface ApiReferenceResourceRelationship {
         readonly mode: string;
         readonly strategy: string;
         readonly maxDepth: number;
+        /**
+         * True for the RESTRICT posture: the parent's delete is refused while these rows exist. Nothing is torn
+         * down, so `mode` and `maxDepth` describe nothing and a renderer must not present them.
+         */
+        readonly refusesWhileChildrenExist: boolean;
     } | null;
 }
 export interface ApiReferenceModel {

package/dist/esm/runtime/openapi-reference-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openapi-reference-model.d.ts","sourceRoot":"","sources":["../../../../src/runtime/openapi-reference-model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"openapi-reference-model.d.ts","sourceRoot":"","sources":["../../../../src/runtime/openapi-reference-model.ts"],"names":[],"mappings":"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"}

package/dist/esm/runtime/openapi-reference-model.js

@@ -193,7 +193,7 @@ function schemaNode(value) {
             name,
             required: requiredPropertyNames.has(name),
             schema: schemaNodeOrThrow(propertySchema, `property '${name}'`),
-        })).sort((left, right) => left.name.localeCompare(right.name))
+        }))
         : [];
     const compositionSources = [
         [ApiReferenceSchemaCompositionKind.ONE_OF, value.oneOf],
@@ -332,15 +332,62 @@ function requestBody(value, operationId) {
         mediaTypes: mediaTypes(value.content),
     };
 }
-function responses(value, operationId) {
+/**
+ * Follows a Response Object `$ref` to the document's `components.responses`.
+ *
+ * The generator publishes the statuses every operation shares — `401` and `500` — once, as
+ * `#/components/responses/<Name>`, and references them from each operation. Reading only inline
+ * responses rendered roughly 1,800 of them in the Wonder Todos document as a bare status with no
+ * description and "No structured representation", although the document carried both. A reference
+ * that names no component is a malformed document, so it refuses rather than render an empty status.
+ */
+function resolveResponseObject(response, componentResponses, owner) {
+    let current = response;
+    const visited = new Set();
+    // A component response may itself be a reference to another one; follow the chain, refusing a cycle.
+    while (isRecord(current) && typeof current.$ref === 'string') {
+        const reference = current.$ref;
+        if (visited.has(reference))
+            throw new Error(`API reference ${owner} has a circular response reference '${reference}'`);
+        visited.add(reference);
+        const encodedName = reference.match(/^#\/components\/responses\/([^/]+)$/)?.[1];
+        // JSON Pointer (RFC 6901 §4): `~1` decodes to `/` and `~0` to `~`, in that order.
+        const name = encodedName?.replace(/~1/g, '/').replace(/~0/g, '~');
+        const resolved = name === undefined ? undefined : componentResponses[name];
+        if (!isRecord(resolved))
+            throw new Error(`API reference ${owner} references an unknown response '${reference}'`);
+        current = resolved;
+    }
+    return current;
+}
+function responses(value, operationId, componentResponses) {
     if (!isRecord(value))
         return [];
-    return Object.entries(value).map(([status, response]) => ({
-        anchorId: apiReferenceTargetFragment({ kind: ApiReferenceTargetKind.RESPONSE, operationId, status }),
-        status,
-        description: isRecord(response) && typeof response.description === 'string' ? response.description : null,
-        mediaTypes: isRecord(response) ? mediaTypes(response.content) : [],
-    })).sort((a, b) => a.status.localeCompare(b.status, undefined, { numeric: true }));
+    return Object.entries(value).map(([status, reference]) => {
+        const response = resolveResponseObject(reference, componentResponses, `${operationId} response ${status}`);
+        return {
+            anchorId: apiReferenceTargetFragment({ kind: ApiReferenceTargetKind.RESPONSE, operationId, status }),
+            status,
+            description: isRecord(response) && typeof response.description === 'string' ? response.description : null,
+            mediaTypes: isRecord(response) ? mediaTypes(response.content) : [],
+        };
+    }).sort((a, b) => a.status.localeCompare(b.status, undefined, { numeric: true }));
+}
+function errorScenarios(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.flatMap((scenario) => {
+        if (!isRecord(scenario) || typeof scenario.status !== 'string' || typeof scenario.when !== 'string')
+            return [];
+        const optional = (field) => typeof field === 'string' && field.length > 0 ? field : null;
+        return [{
+                status: scenario.status,
+                when: scenario.when,
+                errorType: optional(scenario.errorType),
+                customMessageReference: optional(scenario.customMessageReference),
+                errorCode: optional(scenario.errorCode),
+            }];
+    });
 }
 function securitySchemes(value) {
     if (!Array.isArray(value))
@@ -380,6 +427,8 @@ function resourceRelationships(value) {
                 mode: parentDelete.mode,
                 strategy: parentDelete.strategy,
                 maxDepth: parentDelete.maxDepth,
+                // semantic-literal-boundary: the wire value of ResourceRelationshipDocumentationDeleteStrategy.REFUSE_WHILE_CHILDREN_EXIST, read from the published OpenAPI document this runtime model parses without importing the companion schemas.
+                refusesWhileChildrenExist: parentDelete.strategy === 'refuse_while_children_exist',
             } : null,
         };
     });
@@ -401,9 +450,28 @@ function resourceCategory(value) {
         description: typeof value.description === 'string' ? value.description : null,
     };
 }
+/**
+ * The family's readable name. The family reference is a URI, so an identifier carrying a `:` arrives
+ * percent-encoded (`collectionExport%3Alist`) and was shown that way ("Collection Export%3Alist"). It is
+ * decoded first, and each `:`-separated part is spelled on its own: "Collection Export · list".
+ */
 function operationFamilyLabel(familyRef) {
-    const identifier = familyRef.split('/operation-family/').at(-1)?.split('/').at(0) ?? familyRef;
-    return identifier.replace(/([a-z])([A-Z])/g, '$1 $2').replace(/[-_]/g, ' ').replace(/^./, (character) => character.toUpperCase());
+    const encoded = familyRef.split('/operation-family/').at(-1)?.split('/').at(0) ?? familyRef;
+    let identifier = encoded;
+    try {
+        identifier = decodeURIComponent(encoded);
+    }
+    catch {
+        // A malformed escape is shown as written rather than failing the whole reference.
+    }
+    return identifier
+        .split(':')
+        // invented-display-text: generated API REFERENCE prose. The technical-doc lane has no label tree
+        // and is not translated — the identifier it renders is the API's own public name.
+        .map((part) => part.replace(/([a-z])([A-Z])/g, '$1 $2').replace(/[-_]/g, ' ').trim())
+        .filter((part) => part.length > 0)
+        .join(' · ')
+        .replace(/^./, (character) => character.toUpperCase());
 }
 /**
  * Presentation-only fallback for a resource whose related tag is absent from
@@ -412,6 +480,7 @@ function operationFamilyLabel(familyRef) {
  * leaking into the reference when no source-authored display tag is available.
  */
 function resourceDisplayLabel(identifier) {
+    // invented-display-text: generated API reference prose, as above.
     return identifier
         .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
         .replace(/[-_]/g, ' ')
@@ -438,10 +507,12 @@ export function createApiReferenceModel(document) {
                     category: resourceCategory(tag['x-wildo'].category),
                     lifecycleRole: typeof tag['x-wildo'].lifecycleRole === 'string' ? tag['x-wildo'].lifecycleRole : null,
                     relationships: resourceRelationships(tag['x-wildo'].relationships),
+                    objectSchemaName: typeof tag['x-wildo'].objectSchema === 'string' ? tag['x-wildo'].objectSchema : null,
                 });
             }
         }
     }
+    const componentResponses = isRecord(document.components) && isRecord(document.components.responses) ? document.components.responses : {};
     const resources = new Map();
     const operationIds = new Set();
     const operationVariantRefs = new Set();
@@ -479,11 +550,13 @@ export function createApiReferenceModel(document) {
                 description: typeof operation.description === 'string' ? operation.description : null,
                 method: method.toUpperCase(),
                 path,
+                aliasOfPath: typeof metadata.aliasOfPath === 'string' ? metadata.aliasOfPath : null,
                 access: access(metadata.access),
                 securitySchemes: securitySchemes(operation.security),
                 parameters: Array.isArray(operation.parameters) ? operation.parameters.map(parameter).filter((item) => item !== null) : [],
                 requestBody: requestBody(operation.requestBody, operation.operationId),
-                responses: responses(operation.responses, operation.operationId),
+                responses: responses(operation.responses, operation.operationId, componentResponses),
+                errorScenarios: errorScenarios(metadata.errorScenarios),
                 idempotent: typeof operation['x-idempotent'] === 'boolean' ? operation['x-idempotent'] : null,
             });
             resource.set(metadata.operationFamilyRef, family);
@@ -504,6 +577,7 @@ export function createApiReferenceModel(document) {
             category: tag.category,
             description: tag.description,
             lifecycleRole: tag.lifecycleRole,
+            objectSchemaName: tag.objectSchemaName,
             relationships: tag.relationships.map((relationship) => ({
                 ...relationship,
                 relatedResourceLabel: resourceTags.get(relationship.relatedResourceName)?.label ?? resourceDisplayLabel(relationship.relatedResourceName),