@wildo-ai/saas-technical-doc 1.1.2 → 1.1.3

package/dist/esm/companion/rendering/technical-documentation-render-model.js.map

@@ -1 +1 @@
-{"version":3,"file":"technical-documentation-render-model.js","sourceRoot":"","sources":["../../../../../src/companion/rendering/technical-documentation-render-model.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from 'node:crypto';\n\nimport {\n  createTechnicalDocumentationRenderOutputManifestV1,\n  canonicalizeTechnicalDocumentationJson,\n  TechnicalDocumentationOutputKind,\n  TechnicalDocumentationNormalizedRelativePathSchema,\n  TechnicalDocumentationRendererKind,\n  type TechnicalDocumentationAuthorizedBundleManifestV1,\n  type TechnicalDocumentationRenderOutputManifestV1,\n  type TechnicalDocumentationRendererExecutionV1,\n  type TechnicalDocumentationVersionedIdentityV1,\n  type TechnicalDocumentationResolvedAssetBundleManifestV1,\n  type TechnicalDocumentationSupportedApiVersion,\n  type TechnicalDocumentationUnitV1,\n} from '@wildo-ai/saas-specifications/technical-documentation';\n\n/**\n * Names opaque emitted bytes, and detects their corruption when a reader compares this against the\n * bytes it actually loaded. That two-sided check is why it survived the 2026-08-27 digest\n * demolition; its string-hashing sibling did not, because every caller of that one was recording\n * agreement between two parts of the repository rather than naming content.\n */\nexport function technicalDocumentationSha256Bytes(bytes: Uint8Array): string {\n  return `sha256:${createHash('sha256').update(bytes).digest('hex')}`;\n}\n\nexport interface TechnicalDocumentationRenderModel {\n  readonly authorizedBundleIdentity: TechnicalDocumentationVersionedIdentityV1;\n  readonly channel: TechnicalDocumentationAuthorizedBundleManifestV1['channel'];\n  readonly units: readonly TechnicalDocumentationUnitV1[];\n  readonly unitPathByRef: ReadonlyMap<string, string>;\n}\n\nexport interface TechnicalDocumentationRenderedFile {\n  readonly outputRef: string;\n  readonly rendererRef: string;\n  readonly outputKind: TechnicalDocumentationOutputKind;\n  readonly sourceUnitRefs: readonly string[];\n  readonly normalizedRelativePath: string;\n  readonly mediaType: string;\n  readonly bytes: Uint8Array;\n}\n\nexport interface TechnicalDocumentationRendererResult {\n  readonly execution: TechnicalDocumentationRendererExecutionV1;\n  readonly files: readonly TechnicalDocumentationRenderedFile[];\n}\n\nexport function createTechnicalDocumentationRendererExecution(input: {\n  readonly rendererKind: TechnicalDocumentationRendererKind;\n  readonly rendererRef: string;\n  readonly rendererVersion: number;\n  /** Names the renderer's configuration. `rendererRef@rendererVersion` names the implementation. */\n  readonly configurationRef: string;\n}): TechnicalDocumentationRendererExecutionV1 {\n  /*\n   * This built two sha256 fields until 2026-08-27: one over the renderer's own function bodies\n   * (`Function.prototype.toString()`), one over its configuration object. Neither was ever compared\n   * to anything — they rode into the manifest beside the `rendererRef` and `rendererVersion` that\n   * already say which renderer ran, in a form a reader can act on.\n   */\n  return {\n    rendererKind: input.rendererKind,\n    rendererRef: input.rendererRef,\n    rendererVersion: input.rendererVersion,\n    configurationRef: input.configurationRef,\n  };\n}\n\nfunction slugForUnit(unit: TechnicalDocumentationUnitV1): string {\n  const source = unit.unitRef.split('/').at(-1) ?? unit.unitRef;\n  const slug = source.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');\n  if (slug.length === 0) throw new Error(`technical-documentation unit ${unit.unitRef} cannot produce a stable path`);\n  return slug;\n}\n\n/**\n * Every route the engine content module owns, keyed by unit slug. Exported as a SET so the\n * renderers can tell a gated page this application does not publish (flatten the link) from a\n * misspelled route (leave it for the managed-tree validator).\n */\nconst ENGINE_UNIT_PATH_BY_SLUG: Readonly<Record<string, string>> = {\n    'application-orientation': 'get-started',\n    authentication: 'access-and-identity/overview',\n    'sign-in-and-mfa': 'access-and-identity/sign-in-and-mfa',\n    'complete-sign-in': 'access-and-identity/complete-sign-in',\n    'mfa-enrollment-and-recovery': 'access-and-identity/mfa-enrollment-and-recovery',\n    'sign-in-troubleshoot': 'access-and-identity/sign-in-troubleshoot',\n    'single-sign-on': 'access-and-identity/single-sign-on',\n    'sso-configure': 'access-and-identity/sso-configure',\n    'sso-rollout-and-recovery': 'access-and-identity/sso-rollout-and-recovery',\n    'sso-troubleshoot': 'access-and-identity/sso-troubleshoot',\n    'api-keys': 'access-and-identity/api-keys',\n    'api-keys-create-and-store': 'access-and-identity/api-keys-create-and-store',\n    'api-keys-lifecycle': 'access-and-identity/api-keys-lifecycle',\n    'api-keys-troubleshoot': 'access-and-identity/api-keys-troubleshoot',\n    'oauth-provider': 'access-and-identity/oauth-provider',\n    'oauth-register-client': 'access-and-identity/oauth-register-client',\n    'oauth-authorize-delegated-access': 'access-and-identity/oauth-authorize-delegated-access',\n    'oauth-operate-and-revoke': 'access-and-identity/oauth-operate-and-revoke',\n    'user-administration': 'user-administration',\n    'manage-users-manually': 'user-administration/manage-users-manually',\n    'invite-and-onboard-user': 'user-administration/invite-and-onboard-user',\n    'organization-roles': 'user-administration/roles-and-permissions',\n    'change-user-access': 'user-administration/change-user-access',\n    'manage-organization-units': 'user-administration/manage-organization-units',\n    'design-organization-unit-hierarchy': 'user-administration/design-organization-unit-hierarchy',\n    'assign-organization-unit-access': 'user-administration/assign-organization-unit-access',\n    'operate-organization-units': 'user-administration/operate-organization-units',\n    'suspend-or-remove-user': 'user-administration/suspend-or-remove-user',\n    'review-users-and-access': 'user-administration/review-users-and-access',\n    'troubleshoot-user-access': 'user-administration/troubleshoot-user-access',\n    scim: 'user-administration/scim-provisioning',\n    'scim-protocol-and-payloads': 'user-administration/scim-protocol-and-payloads',\n    'scim-configure': 'user-administration/scim-configure',\n    'scim-microsoft-entra': 'user-administration/scim-microsoft-entra',\n    'scim-okta': 'user-administration/scim-okta',\n    'scim-ldap-and-active-directory': 'user-administration/scim-ldap-and-active-directory',\n    'scim-map-profile-and-units': 'user-administration/scim-map-profile-and-units',\n    'scim-validate-and-roll-out': 'user-administration/scim-validate-and-roll-out',\n    'scim-operate-and-troubleshoot': 'user-administration/scim-operate-and-troubleshoot',\n    'audit-and-siem': 'security-and-audit',\n    'investigate-audit-event': 'security-and-audit/investigate-event',\n    'review-privileged-and-access-changes': 'security-and-audit/review-access-changes',\n    'export-audit-records': 'security-and-audit/export-audit-records',\n    'configure-siem-export': 'security-and-audit/configure-siem',\n    'siem-splunk': 'security-and-audit/siem-splunk',\n    'siem-microsoft-sentinel': 'security-and-audit/siem-microsoft-sentinel',\n    'siem-elastic': 'security-and-audit/siem-elastic',\n    'operate-and-troubleshoot-siem-delivery': 'security-and-audit/operate-siem',\n    'protect-and-retain-audit-evidence': 'security-and-audit/protect-evidence',\n    billing: 'billing-and-subscriptions',\n    'understand-billing-plans-and-access': 'billing-and-subscriptions/plans-and-access',\n    'start-billing-subscription': 'billing-and-subscriptions/start-subscription',\n    'change-or-end-billing-subscription': 'billing-and-subscriptions/change-or-end-subscription',\n    'billing-records-and-usage': 'billing-and-subscriptions/billing-records',\n    'manage-invoices-and-payments': 'billing-and-subscriptions/invoices-and-payments',\n    'understand-metered-usage': 'billing-and-subscriptions/metered-usage',\n    'reconcile-billing-and-access': 'billing-and-subscriptions/reconcile-access',\n    'troubleshoot-billing-change': 'billing-and-subscriptions/troubleshoot',\n    integrations: 'integrations',\n    'automation-platforms': 'integrations/automation-platforms',\n    'connect-n8n': 'integrations/automation/n8n',\n    'connect-zapier': 'integrations/automation/zapier',\n    'connect-make': 'integrations/automation/make',\n    'ai-coding-tools': 'integrations/ai-coding-tools',\n    'connect-cursor': 'integrations/ai-tools/cursor',\n    'connect-codex': 'integrations/ai-tools/codex',\n    'connect-claude-code': 'integrations/ai-tools/claude-code',\n    'agent-interoperability': 'integrations/agents',\n    'mcp-integrations': 'integrations/mcp',\n    'a2a-integrations': 'integrations/a2a',\n    'first-request': 'integrations/create-your-own-integration',\n    'common-rest-api': 'integrations/rest-api',\n    'rest-api-conventions': 'integrations/rest/conventions',\n    'send-api-request': 'integrations/rest/send-request',\n    'work-with-api-collections': 'integrations/rest/read-collections',\n    'write-and-reconcile-api-changes': 'integrations/rest/write-and-reconcile',\n    'troubleshoot-api-request': 'integrations/rest/troubleshoot',\n    webhooks: 'integrations/webhooks',\n    'configure-and-test-webhook-endpoint': 'integrations/webhooks/configure-and-test',\n    'verify-webhook-delivery': 'integrations/webhooks/verify-delivery',\n    'operate-webhook-deliveries': 'integrations/webhooks/operate-deliveries',\n    'troubleshoot-webhook-deliveries': 'integrations/webhooks/troubleshoot',\n};\n\nexport const ENGINE_UNIT_ROUTES: ReadonlySet<string> = new Set(Object.values(ENGINE_UNIT_PATH_BY_SLUG));\n\n/**\n * Maps a published semantic unit to its consumer navigation home.\n *\n * This is deliberately renderer-owned rather than inferred from Markdown file\n * names: the semantic unit is the stable composition input, while a renderer\n * owns audience-facing URLs. The route table is deliberately organized by a\n * customer's product responsibility—not the internal framework that implements\n * it—so readers can find access, organization, security, billing and\n * integration material without learning Wildo vocabulary. Application-domain\n * use cases remain deferred to the app-creator flow, so an application-owned\n * unit fails closed instead of acquiring an implicit route.\n */\nfunction pathForUnit(unit: TechnicalDocumentationUnitV1): string {\n  const slug = slugForUnit(unit);\n  if (unit.unitRef.startsWith('technical-documentation:unit/')) {\n    const path = ENGINE_UNIT_PATH_BY_SLUG[slug];\n    if (path !== undefined) return path;\n    throw new Error(`technical-documentation framework unit ${unit.unitRef} has no consumer navigation path`);\n  }\n  throw new Error(`technical-documentation unit ${unit.unitRef} has no consumer navigation category`);\n}\n\nexport function createTechnicalDocumentationRenderModel(\n  authorizedBundle: TechnicalDocumentationAuthorizedBundleManifestV1,\n): TechnicalDocumentationRenderModel {\n  const unitPathByRef = new Map<string, string>();\n  const occupiedPaths = new Set<string>();\n  for (const unit of authorizedBundle.units) {\n    const path = pathForUnit(unit);\n    if (occupiedPaths.has(path)) throw new Error(`technical-documentation units collide on renderer path ${path}`);\n    occupiedPaths.add(path);\n    unitPathByRef.set(unit.unitRef, path);\n  }\n  return Object.freeze({\n    authorizedBundleIdentity: Object.freeze({ ref: authorizedBundle.bundleRef, version: authorizedBundle.bundleVersion }),\n    channel: authorizedBundle.channel,\n    units: Object.freeze([...authorizedBundle.units]),\n    unitPathByRef,\n  });\n}\n\nexport function createTechnicalDocumentationAggregateRenderManifest(input: {\n  readonly authorizedBundle: TechnicalDocumentationAuthorizedBundleManifestV1;\n  readonly resolvedAssetBundle: TechnicalDocumentationResolvedAssetBundleManifestV1;\n  readonly supportedApiVersion: TechnicalDocumentationSupportedApiVersion;\n  readonly rendererResults: readonly TechnicalDocumentationRendererResult[];\n  /** This render's own identity; the publication pointer selects a render by it. */\n  readonly renderRef: string;\n  readonly renderVersion: number;\n}): TechnicalDocumentationRenderOutputManifestV1 {\n  const rendererExecutions = input.rendererResults.map((result) => result.execution);\n  const outputs = input.rendererResults.flatMap((result) => result.files.map((file) => ({\n    outputRef: file.outputRef,\n    rendererRef: file.rendererRef,\n    outputKind: file.outputKind,\n    sourceUnitRefs: [...file.sourceUnitRefs],\n    normalizedRelativePath: TechnicalDocumentationNormalizedRelativePathSchema.parse(file.normalizedRelativePath),\n    mediaType: file.mediaType,\n    byteLength: file.bytes.byteLength,\n    byteDigest: technicalDocumentationSha256Bytes(file.bytes),\n  })));\n  return createTechnicalDocumentationRenderOutputManifestV1({\n    schemaVersion: 1,\n    renderRef: input.renderRef,\n    renderVersion: input.renderVersion,\n    authorizedBundleIdentity: { ref: input.authorizedBundle.bundleRef, version: input.authorizedBundle.bundleVersion },\n    resolvedAssetBundleIdentity: { ref: input.resolvedAssetBundle.assetBundleRef, version: input.resolvedAssetBundle.assetBundleVersion },\n    supportedApiVersion: input.supportedApiVersion,\n    rendererExecutions,\n    outputs,\n  });\n}\n"]}
+{"version":3,"file":"technical-documentation-render-model.js","sourceRoot":"","sources":["../../../../../src/companion/rendering/technical-documentation-render-model.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from 'node:crypto';\n\nimport { APPLICATION_DOMAIN_RESOURCE_PAGE_UNIT_REF_PREFIX } from '../application-documentation/technical-documentation-engine-content-bundle';\n\nimport {\n  createTechnicalDocumentationRenderOutputManifestV1,\n  canonicalizeTechnicalDocumentationJson,\n  TechnicalDocumentationOutputKind,\n  TechnicalDocumentationNormalizedRelativePathSchema,\n  TechnicalDocumentationRendererKind,\n  type TechnicalDocumentationAuthorizedBundleManifestV1,\n  type TechnicalDocumentationRenderOutputManifestV1,\n  type TechnicalDocumentationRendererExecutionV1,\n  type TechnicalDocumentationVersionedIdentityV1,\n  type TechnicalDocumentationResolvedAssetBundleManifestV1,\n  type TechnicalDocumentationSupportedApiVersion,\n  type TechnicalDocumentationUnitV1,\n} from '@wildo-ai/saas-specifications/technical-documentation';\n\n/**\n * Names opaque emitted bytes, and detects their corruption when a reader compares this against the\n * bytes it actually loaded. That two-sided check is why it survived the 2026-08-27 digest\n * demolition; its string-hashing sibling did not, because every caller of that one was recording\n * agreement between two parts of the repository rather than naming content.\n */\nexport function technicalDocumentationSha256Bytes(bytes: Uint8Array): string {\n  return `sha256:${createHash('sha256').update(bytes).digest('hex')}`;\n}\n\nexport interface TechnicalDocumentationRenderModel {\n  readonly authorizedBundleIdentity: TechnicalDocumentationVersionedIdentityV1;\n  readonly channel: TechnicalDocumentationAuthorizedBundleManifestV1['channel'];\n  readonly units: readonly TechnicalDocumentationUnitV1[];\n  readonly unitPathByRef: ReadonlyMap<string, string>;\n}\n\nexport interface TechnicalDocumentationRenderedFile {\n  readonly outputRef: string;\n  readonly rendererRef: string;\n  readonly outputKind: TechnicalDocumentationOutputKind;\n  readonly sourceUnitRefs: readonly string[];\n  readonly normalizedRelativePath: string;\n  readonly mediaType: string;\n  readonly bytes: Uint8Array;\n}\n\nexport interface TechnicalDocumentationRendererResult {\n  readonly execution: TechnicalDocumentationRendererExecutionV1;\n  readonly files: readonly TechnicalDocumentationRenderedFile[];\n}\n\nexport function createTechnicalDocumentationRendererExecution(input: {\n  readonly rendererKind: TechnicalDocumentationRendererKind;\n  readonly rendererRef: string;\n  readonly rendererVersion: number;\n  /** Names the renderer's configuration. `rendererRef@rendererVersion` names the implementation. */\n  readonly configurationRef: string;\n}): TechnicalDocumentationRendererExecutionV1 {\n  /*\n   * This built two sha256 fields until 2026-08-27: one over the renderer's own function bodies\n   * (`Function.prototype.toString()`), one over its configuration object. Neither was ever compared\n   * to anything — they rode into the manifest beside the `rendererRef` and `rendererVersion` that\n   * already say which renderer ran, in a form a reader can act on.\n   */\n  return {\n    rendererKind: input.rendererKind,\n    rendererRef: input.rendererRef,\n    rendererVersion: input.rendererVersion,\n    configurationRef: input.configurationRef,\n  };\n}\n\nfunction slugForUnit(unit: TechnicalDocumentationUnitV1): string {\n  const source = unit.unitRef.split('/').at(-1) ?? unit.unitRef;\n  const slug = source.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');\n  if (slug.length === 0) throw new Error(`technical-documentation unit ${unit.unitRef} cannot produce a stable path`);\n  return slug;\n}\n\n/**\n * Every route the engine content module owns, keyed by unit slug. Exported as a SET so the\n * renderers can tell a gated page this application does not publish (flatten the link) from a\n * misspelled route (leave it for the managed-tree validator).\n */\nconst ENGINE_UNIT_PATH_BY_SLUG: Readonly<Record<string, string>> = {\n    'application-orientation': 'get-started',\n    'what-this-application-manages': 'what-this-application-manages',\n    authentication: 'access-and-identity/overview',\n    'sign-in-and-mfa': 'access-and-identity/sign-in-and-mfa',\n    'complete-sign-in': 'access-and-identity/complete-sign-in',\n    'mfa-enrollment-and-recovery': 'access-and-identity/mfa-enrollment-and-recovery',\n    'sign-in-troubleshoot': 'access-and-identity/sign-in-troubleshoot',\n    'single-sign-on': 'access-and-identity/single-sign-on',\n    'sso-configure': 'access-and-identity/sso-configure',\n    'sso-rollout-and-recovery': 'access-and-identity/sso-rollout-and-recovery',\n    'sso-troubleshoot': 'access-and-identity/sso-troubleshoot',\n    'api-keys': 'access-and-identity/api-keys',\n    'api-keys-create-and-store': 'access-and-identity/api-keys-create-and-store',\n    'api-keys-lifecycle': 'access-and-identity/api-keys-lifecycle',\n    'api-keys-troubleshoot': 'access-and-identity/api-keys-troubleshoot',\n    'oauth-provider': 'access-and-identity/oauth-provider',\n    'oauth-register-client': 'access-and-identity/oauth-register-client',\n    'oauth-authorize-delegated-access': 'access-and-identity/oauth-authorize-delegated-access',\n    'oauth-operate-and-revoke': 'access-and-identity/oauth-operate-and-revoke',\n    'user-administration': 'user-administration',\n    'manage-users-manually': 'user-administration/manage-users-manually',\n    'invite-and-onboard-user': 'user-administration/invite-and-onboard-user',\n    'organization-roles': 'user-administration/roles-and-permissions',\n    'change-user-access': 'user-administration/change-user-access',\n    'manage-organization-units': 'user-administration/manage-organization-units',\n    'design-organization-unit-hierarchy': 'user-administration/design-organization-unit-hierarchy',\n    'assign-organization-unit-access': 'user-administration/assign-organization-unit-access',\n    'operate-organization-units': 'user-administration/operate-organization-units',\n    'suspend-or-remove-user': 'user-administration/suspend-or-remove-user',\n    'review-users-and-access': 'user-administration/review-users-and-access',\n    'troubleshoot-user-access': 'user-administration/troubleshoot-user-access',\n    scim: 'user-administration/scim-provisioning',\n    'scim-protocol-and-payloads': 'user-administration/scim-protocol-and-payloads',\n    'scim-configure': 'user-administration/scim-configure',\n    'scim-microsoft-entra': 'user-administration/scim-microsoft-entra',\n    'scim-okta': 'user-administration/scim-okta',\n    'scim-ldap-and-active-directory': 'user-administration/scim-ldap-and-active-directory',\n    'scim-map-profile-and-units': 'user-administration/scim-map-profile-and-units',\n    'scim-validate-and-roll-out': 'user-administration/scim-validate-and-roll-out',\n    'scim-operate-and-troubleshoot': 'user-administration/scim-operate-and-troubleshoot',\n    'audit-and-siem': 'security-and-audit',\n    'investigate-audit-event': 'security-and-audit/investigate-event',\n    'review-privileged-and-access-changes': 'security-and-audit/review-access-changes',\n    'export-audit-records': 'security-and-audit/export-audit-records',\n    'configure-siem-export': 'security-and-audit/configure-siem',\n    'siem-splunk': 'security-and-audit/siem-splunk',\n    'siem-microsoft-sentinel': 'security-and-audit/siem-microsoft-sentinel',\n    'siem-elastic': 'security-and-audit/siem-elastic',\n    'operate-and-troubleshoot-siem-delivery': 'security-and-audit/operate-siem',\n    'respond-to-leaked-credential': 'security-and-audit/respond-to-leaked-credential',\n    'protect-and-retain-audit-evidence': 'security-and-audit/protect-evidence',\n    integrations: 'integrations',\n    'automation-platforms': 'integrations/automation-platforms',\n    'connect-n8n': 'integrations/automation/n8n',\n    'connect-zapier': 'integrations/automation/zapier',\n    'connect-make': 'integrations/automation/make',\n    'ai-coding-tools': 'integrations/ai-coding-tools',\n    'connect-cursor': 'integrations/ai-tools/cursor',\n    'connect-codex': 'integrations/ai-tools/codex',\n    'connect-claude-code': 'integrations/ai-tools/claude-code',\n    'agent-interoperability': 'integrations/agents',\n    'mcp-integrations': 'integrations/mcp',\n    'a2a-integrations': 'integrations/a2a',\n    'first-request': 'integrations/create-your-own-integration',\n    'common-rest-api': 'integrations/rest-api',\n    'rest-api-conventions': 'integrations/rest/conventions',\n    'send-api-request': 'integrations/rest/send-request',\n    'work-with-api-collections': 'integrations/rest/read-collections',\n    'write-and-reconcile-api-changes': 'integrations/rest/write-and-reconcile',\n    'troubleshoot-api-request': 'integrations/rest/troubleshoot',\n    webhooks: 'integrations/webhooks',\n    'configure-and-test-webhook-endpoint': 'integrations/webhooks/configure-and-test',\n    'verify-webhook-delivery': 'integrations/webhooks/verify-delivery',\n    'operate-webhook-deliveries': 'integrations/webhooks/operate-deliveries',\n    'troubleshoot-webhook-deliveries': 'integrations/webhooks/troubleshoot',\n};\n\nexport const ENGINE_UNIT_ROUTES: ReadonlySet<string> = new Set(Object.values(ENGINE_UNIT_PATH_BY_SLUG));\n\n/**\n * Maps a published semantic unit to its consumer navigation home.\n *\n * This is deliberately renderer-owned rather than inferred from Markdown file\n * names: the semantic unit is the stable composition input, while a renderer\n * owns audience-facing URLs. The route table is deliberately organized by a\n * customer's product responsibility—not the internal framework that implements\n * it—so readers can find access, organization, security and integration\n * material without learning Wildo vocabulary.\n *\n * One namespace is DERIVED rather than listed — `unit/manages/<resource>`, the page per\n * application resource — because those units cannot be enumerated when this file is written. An\n * application-OWNED unit still fails closed instead of acquiring an implicit route; that refusal\n * is what this table is for, and it is untouched.\n */\nfunction pathForUnit(unit: TechnicalDocumentationUnitV1): string {\n  const slug = slugForUnit(unit);\n  /*\n   * ONE derived branch, and it is deliberately narrow.\n   *\n   * Every other route in this table is a constant, because a renderer owns audience-facing URLs\n   * and an authored page's URL is a decision somebody made. A page per application resource cannot\n   * work that way — the resources are not known when this file is written — so its route is\n   * DERIVED from the reserved `unit/manages/` namespace the projector emits.\n   *\n   * What has NOT changed is the refusal below. A unit an application named still fails closed; the\n   * generated pages are engine units carrying an application subject, which is why they can be\n   * routed at all. Anything outside both the fixed table and this one namespace is still a\n   * missing decision rather than an implicit URL.\n   */\n  if (unit.unitRef.startsWith(APPLICATION_DOMAIN_RESOURCE_PAGE_UNIT_REF_PREFIX)) {\n    const resourceIdentifier = unit.unitRef.slice(APPLICATION_DOMAIN_RESOURCE_PAGE_UNIT_REF_PREFIX.length);\n    if (resourceIdentifier.length === 0 || resourceIdentifier.includes('/')) {\n      throw new Error(`technical-documentation generated resource unit ${unit.unitRef} has no single-segment resource identifier`);\n    }\n    return `${ENGINE_UNIT_PATH_BY_SLUG['what-this-application-manages']}/${resourceIdentifier}`;\n  }\n  if (unit.unitRef.startsWith('technical-documentation:unit/')) {\n    const path = ENGINE_UNIT_PATH_BY_SLUG[slug];\n    if (path !== undefined) return path;\n    throw new Error(`technical-documentation framework unit ${unit.unitRef} has no consumer navigation path`);\n  }\n  throw new Error(`technical-documentation unit ${unit.unitRef} has no consumer navigation category`);\n}\n\nexport function createTechnicalDocumentationRenderModel(\n  authorizedBundle: TechnicalDocumentationAuthorizedBundleManifestV1,\n): TechnicalDocumentationRenderModel {\n  const unitPathByRef = new Map<string, string>();\n  const occupiedPaths = new Set<string>();\n  for (const unit of authorizedBundle.units) {\n    const path = pathForUnit(unit);\n    if (occupiedPaths.has(path)) throw new Error(`technical-documentation units collide on renderer path ${path}`);\n    occupiedPaths.add(path);\n    unitPathByRef.set(unit.unitRef, path);\n  }\n  return Object.freeze({\n    authorizedBundleIdentity: Object.freeze({ ref: authorizedBundle.bundleRef, version: authorizedBundle.bundleVersion }),\n    channel: authorizedBundle.channel,\n    units: Object.freeze([...authorizedBundle.units]),\n    unitPathByRef,\n  });\n}\n\nexport function createTechnicalDocumentationAggregateRenderManifest(input: {\n  readonly authorizedBundle: TechnicalDocumentationAuthorizedBundleManifestV1;\n  readonly resolvedAssetBundle: TechnicalDocumentationResolvedAssetBundleManifestV1;\n  readonly supportedApiVersion: TechnicalDocumentationSupportedApiVersion;\n  readonly rendererResults: readonly TechnicalDocumentationRendererResult[];\n  /** This render's own identity; the publication pointer selects a render by it. */\n  readonly renderRef: string;\n  readonly renderVersion: number;\n}): TechnicalDocumentationRenderOutputManifestV1 {\n  const rendererExecutions = input.rendererResults.map((result) => result.execution);\n  const outputs = input.rendererResults.flatMap((result) => result.files.map((file) => ({\n    outputRef: file.outputRef,\n    rendererRef: file.rendererRef,\n    outputKind: file.outputKind,\n    sourceUnitRefs: [...file.sourceUnitRefs],\n    normalizedRelativePath: TechnicalDocumentationNormalizedRelativePathSchema.parse(file.normalizedRelativePath),\n    mediaType: file.mediaType,\n    byteLength: file.bytes.byteLength,\n    byteDigest: technicalDocumentationSha256Bytes(file.bytes),\n  })));\n  return createTechnicalDocumentationRenderOutputManifestV1({\n    schemaVersion: 1,\n    renderRef: input.renderRef,\n    renderVersion: input.renderVersion,\n    authorizedBundleIdentity: { ref: input.authorizedBundle.bundleRef, version: input.authorizedBundle.bundleVersion },\n    resolvedAssetBundleIdentity: { ref: input.resolvedAssetBundle.assetBundleRef, version: input.resolvedAssetBundle.assetBundleVersion },\n    supportedApiVersion: input.supportedApiVersion,\n    rendererExecutions,\n    outputs,\n  });\n}\n"]}

package/dist/esm/companion/rendering/technical-documentation-search-index-renderer.d.ts

@@ -1,3 +1,13 @@
 import { type TechnicalDocumentationRenderModel, type TechnicalDocumentationRendererResult } from './technical-documentation-render-model';
+/**
+ * The ONE index the site reads: `indexes/search.json`, imported by the application's own
+ * `src/pages/search.tsx`.
+ *
+ * A second `indexes/navigation.json` was emitted here and read by nothing — measured with a positive
+ * control, so the empty result is a real absence rather than a bad probe. The site's navigation is
+ * the Docusaurus sidebar, which the Docusaurus renderer emits; a second navigation index was a
+ * record with no reader (#274, and `application-creation-directive.md`: if we write a record,
+ * something reads it).
+ */
 export declare function renderTechnicalDocumentationSearchIndexes(model: TechnicalDocumentationRenderModel): TechnicalDocumentationRendererResult;
 //# sourceMappingURL=technical-documentation-search-index-renderer.d.ts.map

package/dist/esm/companion/rendering/technical-documentation-search-index-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"technical-documentation-search-index-renderer.d.ts","sourceRoot":"","sources":["../../../../../src/companion/rendering/technical-documentation-search-index-renderer.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,iCAAiC,EACtC,KAAK,oCAAoC,EAC1C,MAAM,wCAAwC,CAAC;AAIhD,wBAAgB,yCAAyC,CAAC,KAAK,EAAE,iCAAiC,GAAG,oCAAoC,CA4CxI"}
+{"version":3,"file":"technical-documentation-search-index-renderer.d.ts","sourceRoot":"","sources":["../../../../../src/companion/rendering/technical-documentation-search-index-renderer.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,iCAAiC,EACtC,KAAK,oCAAoC,EAC1C,MAAM,wCAAwC,CAAC;AAIhD;;;;;;;;;GASG;AACH,wBAAgB,yCAAyC,CAAC,KAAK,EAAE,iCAAiC,GAAG,oCAAoC,CA6BxI"}

package/dist/esm/companion/rendering/technical-documentation-search-index-renderer.js

@@ -1,14 +1,18 @@
 import { TechnicalDocumentationOutputKind, TechnicalDocumentationRendererKind } from '@wildo-ai/saas-specifications/technical-documentation';
 import { createTechnicalDocumentationRendererExecution, } from './technical-documentation-render-model.js';
 const SEARCH_RENDERER_REF = 'technical-documentation:renderer/search-index';
+/**
+ * The ONE index the site reads: `indexes/search.json`, imported by the application's own
+ * `src/pages/search.tsx`.
+ *
+ * A second `indexes/navigation.json` was emitted here and read by nothing — measured with a positive
+ * control, so the empty result is a real absence rather than a bad probe. The site's navigation is
+ * the Docusaurus sidebar, which the Docusaurus renderer emits; a second navigation index was a
+ * record with no reader (#274, and `application-creation-directive.md`: if we write a record,
+ * something reads it).
+ */
 export function renderTechnicalDocumentationSearchIndexes(model) {
     const sourceUnitRefs = model.units.map((unit) => unit.unitRef);
-    const navigation = model.units.map((unit) => ({
-        unitRef: unit.unitRef,
-        title: unit.title,
-        kind: unit.kind,
-        path: `/${model.unitPathByRef.get(unit.unitRef)}`,
-    }));
     const search = model.units.map((unit) => ({
         unitRef: unit.unitRef,
         title: unit.title,
@@ -25,15 +29,6 @@ export function renderTechnicalDocumentationSearchIndexes(model) {
             configurationRef: 'technical-documentation:renderer-configuration/search-index-json-v1',
         }),
         files: [
-            {
-                outputRef: 'technical-documentation:output/navigation-index',
-                rendererRef: SEARCH_RENDERER_REF,
-                outputKind: TechnicalDocumentationOutputKind.NAVIGATION_INDEX,
-                sourceUnitRefs,
-                normalizedRelativePath: 'indexes/navigation.json',
-                mediaType: 'application/json',
-                bytes: Buffer.from(`${JSON.stringify({ schemaVersion: 1, units: navigation }, null, 2)}\n`, 'utf8'),
-            },
             {
                 outputRef: 'technical-documentation:output/search-index',
                 rendererRef: SEARCH_RENDERER_REF,

package/dist/esm/companion/rendering/technical-documentation-search-index-renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"technical-documentation-search-index-renderer.js","sourceRoot":"","sources":["../../../../../src/companion/rendering/technical-documentation-search-index-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,kCAAkC,EAAE,MAAM,uDAAuD,CAAC;AAE7I,OAAO,EACL,6CAA6C,GAG9C,MAAM,wCAAwC,CAAC;AAEhD,MAAM,mBAAmB,GAAG,+CAA+C,CAAC;AAE5E,MAAM,UAAU,yCAAyC,CAAC,KAAwC;IAChG,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5C,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;KAClD,CAAC,CAAC,CAAC;IACJ,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;QACzD,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,IAAI,EAAE,IAAI,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;KAClD,CAAC,CAAC,CAAC;IACJ,OAAO;QACL,SAAS,EAAE,6CAA6C,CAAC;YACvD,YAAY,EAAE,kCAAkC,CAAC,QAAQ;YACzD,WAAW,EAAE,mBAAmB;YAChC,eAAe,EAAE,CAAC;YAClB,gBAAgB,EAAE,qEAAqE;SACxF,CAAC;QACF,KAAK,EAAE;YACL;gBACE,SAAS,EAAE,iDAAiD;gBAC5D,WAAW,EAAE,mBAAmB;gBAChC,UAAU,EAAE,gCAAgC,CAAC,gBAAgB;gBAC7D,cAAc;gBACd,sBAAsB,EAAE,yBAAyB;gBACjD,SAAS,EAAE,kBAAkB;gBAC7B,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC;aACpG;YACD;gBACE,SAAS,EAAE,6CAA6C;gBACxD,WAAW,EAAE,mBAAmB;gBAChC,UAAU,EAAE,gCAAgC,CAAC,gBAAgB;gBAC7D,cAAc;gBACd,sBAAsB,EAAE,qBAAqB;gBAC7C,SAAS,EAAE,kBAAkB;gBAC7B,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC;aAChG;SACF;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { TechnicalDocumentationOutputKind, TechnicalDocumentationRendererKind } from '@wildo-ai/saas-specifications/technical-documentation';\n\nimport {\n  createTechnicalDocumentationRendererExecution,\n  type TechnicalDocumentationRenderModel,\n  type TechnicalDocumentationRendererResult,\n} from './technical-documentation-render-model';\n\nconst SEARCH_RENDERER_REF = 'technical-documentation:renderer/search-index';\n\nexport function renderTechnicalDocumentationSearchIndexes(model: TechnicalDocumentationRenderModel): TechnicalDocumentationRendererResult {\n  const sourceUnitRefs = model.units.map((unit) => unit.unitRef);\n  const navigation = model.units.map((unit) => ({\n    unitRef: unit.unitRef,\n    title: unit.title,\n    kind: unit.kind,\n    path: `/${model.unitPathByRef.get(unit.unitRef)}`,\n  }));\n  const search = model.units.map((unit) => ({\n    unitRef: unit.unitRef,\n    title: unit.title,\n    summary: unit.summary,\n    headings: unit.sections.map((section) => section.heading),\n    readerAudiences: unit.readerAudiences,\n    path: `/${model.unitPathByRef.get(unit.unitRef)}`,\n  }));\n  return {\n    execution: createTechnicalDocumentationRendererExecution({\n      rendererKind: TechnicalDocumentationRendererKind.MARKDOWN,\n      rendererRef: SEARCH_RENDERER_REF,\n      rendererVersion: 1,\n      configurationRef: 'technical-documentation:renderer-configuration/search-index-json-v1',\n    }),\n    files: [\n      {\n        outputRef: 'technical-documentation:output/navigation-index',\n        rendererRef: SEARCH_RENDERER_REF,\n        outputKind: TechnicalDocumentationOutputKind.NAVIGATION_INDEX,\n        sourceUnitRefs,\n        normalizedRelativePath: 'indexes/navigation.json',\n        mediaType: 'application/json',\n        bytes: Buffer.from(`${JSON.stringify({ schemaVersion: 1, units: navigation }, null, 2)}\\n`, 'utf8'),\n      },\n      {\n        outputRef: 'technical-documentation:output/search-index',\n        rendererRef: SEARCH_RENDERER_REF,\n        outputKind: TechnicalDocumentationOutputKind.NAVIGATION_INDEX,\n        sourceUnitRefs,\n        normalizedRelativePath: 'indexes/search.json',\n        mediaType: 'application/json',\n        bytes: Buffer.from(`${JSON.stringify({ schemaVersion: 1, units: search }, null, 2)}\\n`, 'utf8'),\n      },\n    ],\n  };\n}\n"]}
+{"version":3,"file":"technical-documentation-search-index-renderer.js","sourceRoot":"","sources":["../../../../../src/companion/rendering/technical-documentation-search-index-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,kCAAkC,EAAE,MAAM,uDAAuD,CAAC;AAE7I,OAAO,EACL,6CAA6C,GAG9C,MAAM,wCAAwC,CAAC;AAEhD,MAAM,mBAAmB,GAAG,+CAA+C,CAAC;AAE5E;;;;;;;;;GASG;AACH,MAAM,UAAU,yCAAyC,CAAC,KAAwC;IAChG,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;QACzD,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,IAAI,EAAE,IAAI,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;KAClD,CAAC,CAAC,CAAC;IACJ,OAAO;QACL,SAAS,EAAE,6CAA6C,CAAC;YACvD,YAAY,EAAE,kCAAkC,CAAC,QAAQ;YACzD,WAAW,EAAE,mBAAmB;YAChC,eAAe,EAAE,CAAC;YAClB,gBAAgB,EAAE,qEAAqE;SACxF,CAAC;QACF,KAAK,EAAE;YACL;gBACE,SAAS,EAAE,6CAA6C;gBACxD,WAAW,EAAE,mBAAmB;gBAChC,UAAU,EAAE,gCAAgC,CAAC,gBAAgB;gBAC7D,cAAc;gBACd,sBAAsB,EAAE,qBAAqB;gBAC7C,SAAS,EAAE,kBAAkB;gBAC7B,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC;aAChG;SACF;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { TechnicalDocumentationOutputKind, TechnicalDocumentationRendererKind } from '@wildo-ai/saas-specifications/technical-documentation';\n\nimport {\n  createTechnicalDocumentationRendererExecution,\n  type TechnicalDocumentationRenderModel,\n  type TechnicalDocumentationRendererResult,\n} from './technical-documentation-render-model';\n\nconst SEARCH_RENDERER_REF = 'technical-documentation:renderer/search-index';\n\n/**\n * The ONE index the site reads: `indexes/search.json`, imported by the application's own\n * `src/pages/search.tsx`.\n *\n * A second `indexes/navigation.json` was emitted here and read by nothing — measured with a positive\n * control, so the empty result is a real absence rather than a bad probe. The site's navigation is\n * the Docusaurus sidebar, which the Docusaurus renderer emits; a second navigation index was a\n * record with no reader (#274, and `application-creation-directive.md`: if we write a record,\n * something reads it).\n */\nexport function renderTechnicalDocumentationSearchIndexes(model: TechnicalDocumentationRenderModel): TechnicalDocumentationRendererResult {\n  const sourceUnitRefs = model.units.map((unit) => unit.unitRef);\n  const search = model.units.map((unit) => ({\n    unitRef: unit.unitRef,\n    title: unit.title,\n    summary: unit.summary,\n    headings: unit.sections.map((section) => section.heading),\n    readerAudiences: unit.readerAudiences,\n    path: `/${model.unitPathByRef.get(unit.unitRef)}`,\n  }));\n  return {\n    execution: createTechnicalDocumentationRendererExecution({\n      rendererKind: TechnicalDocumentationRendererKind.MARKDOWN,\n      rendererRef: SEARCH_RENDERER_REF,\n      rendererVersion: 1,\n      configurationRef: 'technical-documentation:renderer-configuration/search-index-json-v1',\n    }),\n    files: [\n      {\n        outputRef: 'technical-documentation:output/search-index',\n        rendererRef: SEARCH_RENDERER_REF,\n        outputKind: TechnicalDocumentationOutputKind.NAVIGATION_INDEX,\n        sourceUnitRefs,\n        normalizedRelativePath: 'indexes/search.json',\n        mediaType: 'application/json',\n        bytes: Buffer.from(`${JSON.stringify({ schemaVersion: 1, units: search }, null, 2)}\\n`, 'utf8'),\n      },\n    ],\n  };\n}\n"]}

package/dist/esm/companion/technical-documentation-capture-execution-port.d.ts

@@ -7,7 +7,33 @@ export interface TechnicalDocumentationCaptureExecutionResult {
     readonly receipt: TechnicalDocumentationCaptureReceiptV1;
     readonly outputBytes: Uint8Array;
 }
-/** Production-neutral execution port implemented by the Node-only Playwright capture package. */
+/**
+ * Production-neutral execution port implemented by the Node-only Playwright capture package.
+ *
+ * ## Nothing in this repository injects an implementation, and that is a DECISION
+ *
+ * `@wildo-ai/technical-documentation-capture` implements this port, is built, and is tested in CI —
+ * and no package declares a dependency on it. Read as an orphan that is an oversight; it is not.
+ *
+ * - **It carries Playwright.** The companion is delivered as a dist artifact into every generated
+ *   application, so wiring the implementation there would put a browser download into every
+ *   application that never captures anything.
+ *   `technical-documentation-capture-dependency-closure.test.ts` pins the quarantine from the other
+ *   side: the package must stay absent from every engine and generated-application runtime manifest.
+ * - **The port is the cheap half.** A capture needs six APPLICATION-owned bindings
+ *   (`TechnicalDocumentationPlaywrightCaptureBindings`): a base URL, a semantic-target path, an
+ *   authenticated storage state, a landmark, a font profile and an allowed-origin set. That is a
+ *   live stack, a provisioned tenant and a logged-in session — an environment, not an import.
+ *
+ * So an unavailable capture SKIPS rather than blocks: the pilot assets resolver ships a PLACEHOLDER
+ * for a `PRODUCT_SCREENSHOT`/`PLAYWRIGHT_CAPTURE` request, the asset stays REQUIRED, and whether
+ * provisional imagery may actually ship is decided at publication by the environment
+ * (`--refuse-provisional-assets`), never here. Framework-owned figures do not depend on any of this
+ * — a `DIAGRAM`/`DETERMINISTIC_RENDER` request materializes real SVG bytes with no browser at all.
+ *
+ * When an application does bind a capture, it constructs the implementation itself and hands it in.
+ * That is the seam this interface exists for; do not "fix" the missing dependency by adding one.
+ */
 export interface TechnicalDocumentationCaptureExecutionPort {
     execute(request: TechnicalDocumentationCaptureExecutionRequestV1): Promise<TechnicalDocumentationCaptureExecutionResult>;
 }

package/dist/esm/companion/technical-documentation-capture-execution-port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"technical-documentation-capture-execution-port.d.ts","sourceRoot":"","sources":["../../../../src/companion/technical-documentation-capture-execution-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,+CAA+C,EAC/C,sCAAsC,EACvC,MAAM,uDAAuD,CAAC;AAE/D;;;GAGG;AACH,MAAM,WAAW,4CAA4C;IAC3D,QAAQ,CAAC,OAAO,EAAE,sCAAsC,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;CAClC;AAED,iGAAiG;AACjG,MAAM,WAAW,0CAA0C;IACzD,OAAO,CAAC,OAAO,EAAE,+CAA+C,GAAG,OAAO,CAAC,4CAA4C,CAAC,CAAC;CAC1H"}
+{"version":3,"file":"technical-documentation-capture-execution-port.d.ts","sourceRoot":"","sources":["../../../../src/companion/technical-documentation-capture-execution-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,+CAA+C,EAC/C,sCAAsC,EACvC,MAAM,uDAAuD,CAAC;AAE/D;;;GAGG;AACH,MAAM,WAAW,4CAA4C;IAC3D,QAAQ,CAAC,OAAO,EAAE,sCAAsC,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,0CAA0C;IACzD,OAAO,CAAC,OAAO,EAAE,+CAA+C,GAAG,OAAO,CAAC,4CAA4C,CAAC,CAAC;CAC1H"}

package/dist/esm/companion/technical-documentation-capture-execution-port.js.map

@@ -1 +1 @@
-{"version":3,"file":"technical-documentation-capture-execution-port.js","sourceRoot":"","sources":["../../../../src/companion/technical-documentation-capture-execution-port.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  TechnicalDocumentationCaptureExecutionRequestV1,\n  TechnicalDocumentationCaptureReceiptV1,\n} from '@wildo-ai/saas-specifications/technical-documentation';\n\n/**\n * Result returned before the application-owned publication transaction writes any byte. Keeping bytes in memory at this seam prevents the reusable capture\n * implementation from choosing an application output root or bypassing complete-tree staging.\n */\nexport interface TechnicalDocumentationCaptureExecutionResult {\n  readonly receipt: TechnicalDocumentationCaptureReceiptV1;\n  readonly outputBytes: Uint8Array;\n}\n\n/** Production-neutral execution port implemented by the Node-only Playwright capture package. */\nexport interface TechnicalDocumentationCaptureExecutionPort {\n  execute(request: TechnicalDocumentationCaptureExecutionRequestV1): Promise<TechnicalDocumentationCaptureExecutionResult>;\n}\n"]}
+{"version":3,"file":"technical-documentation-capture-execution-port.js","sourceRoot":"","sources":["../../../../src/companion/technical-documentation-capture-execution-port.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  TechnicalDocumentationCaptureExecutionRequestV1,\n  TechnicalDocumentationCaptureReceiptV1,\n} from '@wildo-ai/saas-specifications/technical-documentation';\n\n/**\n * Result returned before the application-owned publication transaction writes any byte. Keeping bytes in memory at this seam prevents the reusable capture\n * implementation from choosing an application output root or bypassing complete-tree staging.\n */\nexport interface TechnicalDocumentationCaptureExecutionResult {\n  readonly receipt: TechnicalDocumentationCaptureReceiptV1;\n  readonly outputBytes: Uint8Array;\n}\n\n/**\n * Production-neutral execution port implemented by the Node-only Playwright capture package.\n *\n * ## Nothing in this repository injects an implementation, and that is a DECISION\n *\n * `@wildo-ai/technical-documentation-capture` implements this port, is built, and is tested in CI —\n * and no package declares a dependency on it. Read as an orphan that is an oversight; it is not.\n *\n * - **It carries Playwright.** The companion is delivered as a dist artifact into every generated\n *   application, so wiring the implementation there would put a browser download into every\n *   application that never captures anything.\n *   `technical-documentation-capture-dependency-closure.test.ts` pins the quarantine from the other\n *   side: the package must stay absent from every engine and generated-application runtime manifest.\n * - **The port is the cheap half.** A capture needs six APPLICATION-owned bindings\n *   (`TechnicalDocumentationPlaywrightCaptureBindings`): a base URL, a semantic-target path, an\n *   authenticated storage state, a landmark, a font profile and an allowed-origin set. That is a\n *   live stack, a provisioned tenant and a logged-in session — an environment, not an import.\n *\n * So an unavailable capture SKIPS rather than blocks: the pilot assets resolver ships a PLACEHOLDER\n * for a `PRODUCT_SCREENSHOT`/`PLAYWRIGHT_CAPTURE` request, the asset stays REQUIRED, and whether\n * provisional imagery may actually ship is decided at publication by the environment\n * (`--refuse-provisional-assets`), never here. Framework-owned figures do not depend on any of this\n * — a `DIAGRAM`/`DETERMINISTIC_RENDER` request materializes real SVG bytes with no browser at all.\n *\n * When an application does bind a capture, it constructs the implementation itself and hands it in.\n * That is the seam this interface exists for; do not \"fix\" the missing dependency by adding one.\n */\nexport interface TechnicalDocumentationCaptureExecutionPort {\n  execute(request: TechnicalDocumentationCaptureExecutionRequestV1): Promise<TechnicalDocumentationCaptureExecutionResult>;\n}\n"]}

package/dist/esm/companion/technical-documentation-diagram-definitions.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Diagram DECLARATIONS — what a diagram IS, and the asset request that asks for one.
+ *
+ * Split out of `technical-documentation-diagram-materializer.ts` on 2026-09-08 to break a genuine
+ * import cycle, and the split is the right shape independently of it. The materializer needs
+ * `technicalDocumentationSha256Bytes` from the render model; the render model imports the engine
+ * content bundle; and the content bundle now names a diagram in a unit definition it builds AT
+ * MODULE LOAD (#474). That closes the loop, and the symptom was not a resolution error but
+ * `createTechnicalDocumentationApplicationRequestDiagramAssetRequest is not a function` — the
+ * factory evaluated as `undefined` several frames from the cause.
+ *
+ * So: DECLARING a diagram needs nothing but the specifications vocabulary, and MATERIALIZING one
+ * needs a hash. Only the second belongs downstream of the render model.
+ */
+import { type TechnicalDocumentationAssetRequestV1 } from '@wildo-ai/saas-specifications/technical-documentation';
+export interface TechnicalDocumentationDiagramNode {
+    readonly nodeRef: string;
+    readonly label: string;
+}
+export interface TechnicalDocumentationDiagramEdge {
+    readonly fromNodeRef: string;
+    readonly toNodeRef: string;
+    readonly label: string;
+}
+export interface TechnicalDocumentationDiagramDefinition {
+    readonly diagramRef: string;
+    readonly title: string;
+    readonly nodes: readonly TechnicalDocumentationDiagramNode[];
+    readonly edges: readonly TechnicalDocumentationDiagramEdge[];
+}
+export declare const TECHNICAL_DOCUMENTATION_APPLICATION_REQUEST_DIAGRAM_V1: TechnicalDocumentationDiagramDefinition;
+export declare function createTechnicalDocumentationApplicationRequestDiagramAssetRequest(): TechnicalDocumentationAssetRequestV1;
+//# sourceMappingURL=technical-documentation-diagram-definitions.d.ts.map

package/dist/esm/companion/technical-documentation-diagram-definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"technical-documentation-diagram-definitions.d.ts","sourceRoot":"","sources":["../../../../src/companion/technical-documentation-diagram-definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAML,KAAK,oCAAoC,EAC1C,MAAM,uDAAuD,CAAC;AAE/D,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,iCAAiC,EAAE,CAAC;IAC7D,QAAQ,CAAC,KAAK,EAAE,SAAS,iCAAiC,EAAE,CAAC;CAC9D;AAED,eAAO,MAAM,sDAAsD,EAAE,uCAYnE,CAAC;AAEH,wBAAgB,iEAAiE,IAAI,oCAAoC,CAwBxH"}

package/dist/esm/companion/technical-documentation-diagram-definitions.js

@@ -0,0 +1,54 @@
+/**
+ * Diagram DECLARATIONS — what a diagram IS, and the asset request that asks for one.
+ *
+ * Split out of `technical-documentation-diagram-materializer.ts` on 2026-09-08 to break a genuine
+ * import cycle, and the split is the right shape independently of it. The materializer needs
+ * `technicalDocumentationSha256Bytes` from the render model; the render model imports the engine
+ * content bundle; and the content bundle now names a diagram in a unit definition it builds AT
+ * MODULE LOAD (#474). That closes the loop, and the symptom was not a resolution error but
+ * `createTechnicalDocumentationApplicationRequestDiagramAssetRequest is not a function` — the
+ * factory evaluated as `undefined` several frames from the cause.
+ *
+ * So: DECLARING a diagram needs nothing but the specifications vocabulary, and MATERIALIZING one
+ * needs a hash. Only the second belongs downstream of the render model.
+ */
+import { TechnicalDocumentationAssetAccessClass, TechnicalDocumentationAssetKind, TechnicalDocumentationAssetOrigin, TechnicalDocumentationAssetRequiredness, TechnicalDocumentationAssetRightsBasis, } from '@wildo-ai/saas-specifications/technical-documentation';
+export const TECHNICAL_DOCUMENTATION_APPLICATION_REQUEST_DIAGRAM_V1 = Object.freeze({
+    diagramRef: 'technical-documentation:diagram/application-api-request',
+    title: 'From client to application API',
+    nodes: Object.freeze([
+        { nodeRef: 'technical-documentation:diagram-node/client', label: 'Client or service' },
+        { nodeRef: 'technical-documentation:diagram-node/application-api', label: 'Application API' },
+        { nodeRef: 'technical-documentation:diagram-node/resource', label: 'Documented resource' },
+    ]),
+    edges: Object.freeze([
+        { fromNodeRef: 'technical-documentation:diagram-node/client', toNodeRef: 'technical-documentation:diagram-node/application-api', label: 'Authenticated request' },
+        { fromNodeRef: 'technical-documentation:diagram-node/application-api', toNodeRef: 'technical-documentation:diagram-node/resource', label: 'Authorized operation' },
+    ]),
+});
+export function createTechnicalDocumentationApplicationRequestDiagramAssetRequest() {
+    return {
+        assetRef: 'technical-documentation:asset/application-api-request-diagram',
+        kind: TechnicalDocumentationAssetKind.DIAGRAM,
+        origin: TechnicalDocumentationAssetOrigin.DETERMINISTIC_RENDER,
+        accessClass: TechnicalDocumentationAssetAccessClass.PUBLIC,
+        requiredness: TechnicalDocumentationAssetRequiredness.REQUIRED,
+        rights: {
+            basis: TechnicalDocumentationAssetRightsBasis.ENGINE_AUTHORED,
+            authorityRef: 'technical-documentation:rights/engine-authored-diagram',
+        },
+        sourceAccessClass: TechnicalDocumentationAssetAccessClass.PUBLIC,
+        viewedTenantAccessClass: TechnicalDocumentationAssetAccessClass.PUBLIC,
+        roleAccessClass: TechnicalDocumentationAssetAccessClass.PUBLIC,
+        captureOrRenderProfileRef: 'technical-documentation:renderer/deterministic-svg-v1',
+        /*
+         * The definition this diagram depicts, NAMED. It was a sha256 of the definition until
+         * 2026-08-27 — computed here by calling the materializer, then compared by the pilot against
+         * the value the same materializer returned over the same frozen constant. A value compared
+         * with itself.
+         */
+        semanticInputRef: TECHNICAL_DOCUMENTATION_APPLICATION_REQUEST_DIAGRAM_V1.diagramRef,
+        altText: 'A client sends an authenticated request through the application API to a documented resource.',
+    };
+}
+//# sourceMappingURL=technical-documentation-diagram-definitions.js.map

package/dist/esm/companion/technical-documentation-diagram-definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"technical-documentation-diagram-definitions.js","sourceRoot":"","sources":["../../../../src/companion/technical-documentation-diagram-definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,sCAAsC,EACtC,+BAA+B,EAC/B,iCAAiC,EACjC,uCAAuC,EACvC,sCAAsC,GAEvC,MAAM,uDAAuD,CAAC;AAoB/D,MAAM,CAAC,MAAM,sDAAsD,GAA4C,MAAM,CAAC,MAAM,CAAC;IAC3H,UAAU,EAAE,yDAAyD;IACrE,KAAK,EAAE,gCAAgC;IACvC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,OAAO,EAAE,6CAA6C,EAAE,KAAK,EAAE,mBAAmB,EAAE;QACtF,EAAE,OAAO,EAAE,sDAAsD,EAAE,KAAK,EAAE,iBAAiB,EAAE;QAC7F,EAAE,OAAO,EAAE,+CAA+C,EAAE,KAAK,EAAE,qBAAqB,EAAE;KAC3F,CAAC;IACF,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,WAAW,EAAE,6CAA6C,EAAE,SAAS,EAAE,sDAAsD,EAAE,KAAK,EAAE,uBAAuB,EAAE;QACjK,EAAE,WAAW,EAAE,sDAAsD,EAAE,SAAS,EAAE,+CAA+C,EAAE,KAAK,EAAE,sBAAsB,EAAE;KACnK,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,UAAU,iEAAiE;IAC/E,OAAO;QACL,QAAQ,EAAE,+DAA+D;QACzE,IAAI,EAAE,+BAA+B,CAAC,OAAO;QAC7C,MAAM,EAAE,iCAAiC,CAAC,oBAAoB;QAC9D,WAAW,EAAE,sCAAsC,CAAC,MAAM;QAC1D,YAAY,EAAE,uCAAuC,CAAC,QAAQ;QAC9D,MAAM,EAAE;YACN,KAAK,EAAE,sCAAsC,CAAC,eAAe;YAC7D,YAAY,EAAE,wDAAwD;SACvE;QACD,iBAAiB,EAAE,sCAAsC,CAAC,MAAM;QAChE,uBAAuB,EAAE,sCAAsC,CAAC,MAAM;QACtE,eAAe,EAAE,sCAAsC,CAAC,MAAM;QAC9D,yBAAyB,EAAE,uDAAuD;QAClF;;;;;WAKG;QACH,gBAAgB,EAAE,sDAAsD,CAAC,UAAU;QACnF,OAAO,EAAE,+FAA+F;KACzG,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Diagram DECLARATIONS — what a diagram IS, and the asset request that asks for one.\n *\n * Split out of `technical-documentation-diagram-materializer.ts` on 2026-09-08 to break a genuine\n * import cycle, and the split is the right shape independently of it. The materializer needs\n * `technicalDocumentationSha256Bytes` from the render model; the render model imports the engine\n * content bundle; and the content bundle now names a diagram in a unit definition it builds AT\n * MODULE LOAD (#474). That closes the loop, and the symptom was not a resolution error but\n * `createTechnicalDocumentationApplicationRequestDiagramAssetRequest is not a function` — the\n * factory evaluated as `undefined` several frames from the cause.\n *\n * So: DECLARING a diagram needs nothing but the specifications vocabulary, and MATERIALIZING one\n * needs a hash. Only the second belongs downstream of the render model.\n */\nimport {\n  TechnicalDocumentationAssetAccessClass,\n  TechnicalDocumentationAssetKind,\n  TechnicalDocumentationAssetOrigin,\n  TechnicalDocumentationAssetRequiredness,\n  TechnicalDocumentationAssetRightsBasis,\n  type TechnicalDocumentationAssetRequestV1,\n} from '@wildo-ai/saas-specifications/technical-documentation';\n\nexport interface TechnicalDocumentationDiagramNode {\n  readonly nodeRef: string;\n  readonly label: string;\n}\n\nexport interface TechnicalDocumentationDiagramEdge {\n  readonly fromNodeRef: string;\n  readonly toNodeRef: string;\n  readonly label: string;\n}\n\nexport interface TechnicalDocumentationDiagramDefinition {\n  readonly diagramRef: string;\n  readonly title: string;\n  readonly nodes: readonly TechnicalDocumentationDiagramNode[];\n  readonly edges: readonly TechnicalDocumentationDiagramEdge[];\n}\n\nexport const TECHNICAL_DOCUMENTATION_APPLICATION_REQUEST_DIAGRAM_V1: TechnicalDocumentationDiagramDefinition = Object.freeze({\n  diagramRef: 'technical-documentation:diagram/application-api-request',\n  title: 'From client to application API',\n  nodes: Object.freeze([\n    { nodeRef: 'technical-documentation:diagram-node/client', label: 'Client or service' },\n    { nodeRef: 'technical-documentation:diagram-node/application-api', label: 'Application API' },\n    { nodeRef: 'technical-documentation:diagram-node/resource', label: 'Documented resource' },\n  ]),\n  edges: Object.freeze([\n    { fromNodeRef: 'technical-documentation:diagram-node/client', toNodeRef: 'technical-documentation:diagram-node/application-api', label: 'Authenticated request' },\n    { fromNodeRef: 'technical-documentation:diagram-node/application-api', toNodeRef: 'technical-documentation:diagram-node/resource', label: 'Authorized operation' },\n  ]),\n});\n\nexport function createTechnicalDocumentationApplicationRequestDiagramAssetRequest(): TechnicalDocumentationAssetRequestV1 {\n  return {\n    assetRef: 'technical-documentation:asset/application-api-request-diagram',\n    kind: TechnicalDocumentationAssetKind.DIAGRAM,\n    origin: TechnicalDocumentationAssetOrigin.DETERMINISTIC_RENDER,\n    accessClass: TechnicalDocumentationAssetAccessClass.PUBLIC,\n    requiredness: TechnicalDocumentationAssetRequiredness.REQUIRED,\n    rights: {\n      basis: TechnicalDocumentationAssetRightsBasis.ENGINE_AUTHORED,\n      authorityRef: 'technical-documentation:rights/engine-authored-diagram',\n    },\n    sourceAccessClass: TechnicalDocumentationAssetAccessClass.PUBLIC,\n    viewedTenantAccessClass: TechnicalDocumentationAssetAccessClass.PUBLIC,\n    roleAccessClass: TechnicalDocumentationAssetAccessClass.PUBLIC,\n    captureOrRenderProfileRef: 'technical-documentation:renderer/deterministic-svg-v1',\n    /*\n     * The definition this diagram depicts, NAMED. It was a sha256 of the definition until\n     * 2026-08-27 — computed here by calling the materializer, then compared by the pilot against\n     * the value the same materializer returned over the same frozen constant. A value compared\n     * with itself.\n     */\n    semanticInputRef: TECHNICAL_DOCUMENTATION_APPLICATION_REQUEST_DIAGRAM_V1.diagramRef,\n    altText: 'A client sends an authenticated request through the application API to a documented resource.',\n  };\n}\n\n"]}

package/dist/esm/companion/technical-documentation-diagram-materializer.d.ts

@@ -1,21 +1,13 @@
-import { type TechnicalDocumentationAssetRequestV1 } from '@wildo-ai/saas-specifications/technical-documentation';
-export interface TechnicalDocumentationDiagramNode {
-    readonly nodeRef: string;
-    readonly label: string;
-}
-export interface TechnicalDocumentationDiagramEdge {
-    readonly fromNodeRef: string;
-    readonly toNodeRef: string;
-    readonly label: string;
-}
-export interface TechnicalDocumentationDiagramDefinition {
-    readonly diagramRef: string;
-    readonly title: string;
-    readonly nodes: readonly TechnicalDocumentationDiagramNode[];
-    readonly edges: readonly TechnicalDocumentationDiagramEdge[];
-}
-export declare const TECHNICAL_DOCUMENTATION_APPLICATION_REQUEST_DIAGRAM_V1: TechnicalDocumentationDiagramDefinition;
-export declare function createTechnicalDocumentationApplicationRequestDiagramAssetRequest(): TechnicalDocumentationAssetRequestV1;
+/**
+ * Deterministic diagram MATERIALIZATION — declaration in, SVG bytes out.
+ *
+ * The declarations themselves live in `./technical-documentation-diagram-definitions`, which this
+ * module re-exports so every existing consumer and the package barrel are unchanged. See that
+ * file's header for why they were split: this one imports the render model for hashing, the render
+ * model imports the engine content bundle, and the content bundle names a diagram at module load.
+ */
+import type { TechnicalDocumentationDiagramDefinition } from './technical-documentation-diagram-definitions';
+export * from './technical-documentation-diagram-definitions';
 /** A dependency-free deterministic SVG materializer; no layout engine or runtime font metrics participate in its bytes. */
 export declare function materializeTechnicalDocumentationDiagram(definition: TechnicalDocumentationDiagramDefinition): {
     readonly bytes: Uint8Array;

package/dist/esm/companion/technical-documentation-diagram-materializer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"technical-documentation-diagram-materializer.d.ts","sourceRoot":"","sources":["../../../../src/companion/technical-documentation-diagram-materializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,oCAAoC,EAC1C,MAAM,uDAAuD,CAAC;AAI/D,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,iCAAiC,EAAE,CAAC;IAC7D,QAAQ,CAAC,KAAK,EAAE,SAAS,iCAAiC,EAAE,CAAC;CAC9D;AAED,eAAO,MAAM,sDAAsD,EAAE,uCAYnE,CAAC;AAEH,wBAAgB,iEAAiE,IAAI,oCAAoC,CAwBxH;AAMD,2HAA2H;AAC3H,wBAAgB,wCAAwC,CAAC,UAAU,EAAE,uCAAuC,GAAG;IAC7G,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;CACrC,CA+BA"}
+{"version":3,"file":"technical-documentation-diagram-materializer.d.ts","sourceRoot":"","sources":["../../../../src/companion/technical-documentation-diagram-materializer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,+CAA+C,CAAC;AAE7G,cAAc,+CAA+C,CAAC;AAM9D,2HAA2H;AAC3H,wBAAgB,wCAAwC,CAAC,UAAU,EAAE,uCAAuC,GAAG;IAC7G,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;CACrC,CA+BA"}

package/dist/esm/companion/technical-documentation-diagram-materializer.js

@@ -1,43 +1,13 @@
-import { TechnicalDocumentationAssetAccessClass, TechnicalDocumentationAssetKind, TechnicalDocumentationAssetOrigin, TechnicalDocumentationAssetRequiredness, TechnicalDocumentationAssetRightsBasis, } from '@wildo-ai/saas-specifications/technical-documentation';
+/**
+ * Deterministic diagram MATERIALIZATION — declaration in, SVG bytes out.
+ *
+ * The declarations themselves live in `./technical-documentation-diagram-definitions`, which this
+ * module re-exports so every existing consumer and the package barrel are unchanged. See that
+ * file's header for why they were split: this one imports the render model for hashing, the render
+ * model imports the engine content bundle, and the content bundle names a diagram at module load.
+ */
 import { technicalDocumentationSha256Bytes } from './rendering/technical-documentation-render-model.js';
-export const TECHNICAL_DOCUMENTATION_APPLICATION_REQUEST_DIAGRAM_V1 = Object.freeze({
-    diagramRef: 'technical-documentation:diagram/application-api-request',
-    title: 'From client to application API',
-    nodes: Object.freeze([
-        { nodeRef: 'technical-documentation:diagram-node/client', label: 'Client or service' },
-        { nodeRef: 'technical-documentation:diagram-node/application-api', label: 'Application API' },
-        { nodeRef: 'technical-documentation:diagram-node/resource', label: 'Documented resource' },
-    ]),
-    edges: Object.freeze([
-        { fromNodeRef: 'technical-documentation:diagram-node/client', toNodeRef: 'technical-documentation:diagram-node/application-api', label: 'Authenticated request' },
-        { fromNodeRef: 'technical-documentation:diagram-node/application-api', toNodeRef: 'technical-documentation:diagram-node/resource', label: 'Authorized operation' },
-    ]),
-});
-export function createTechnicalDocumentationApplicationRequestDiagramAssetRequest() {
-    return {
-        assetRef: 'technical-documentation:asset/application-api-request-diagram',
-        kind: TechnicalDocumentationAssetKind.DIAGRAM,
-        origin: TechnicalDocumentationAssetOrigin.DETERMINISTIC_RENDER,
-        accessClass: TechnicalDocumentationAssetAccessClass.PUBLIC,
-        requiredness: TechnicalDocumentationAssetRequiredness.REQUIRED,
-        rights: {
-            basis: TechnicalDocumentationAssetRightsBasis.ENGINE_AUTHORED,
-            authorityRef: 'technical-documentation:rights/engine-authored-diagram',
-        },
-        sourceAccessClass: TechnicalDocumentationAssetAccessClass.PUBLIC,
-        viewedTenantAccessClass: TechnicalDocumentationAssetAccessClass.PUBLIC,
-        roleAccessClass: TechnicalDocumentationAssetAccessClass.PUBLIC,
-        captureOrRenderProfileRef: 'technical-documentation:renderer/deterministic-svg-v1',
-        /*
-         * The definition this diagram depicts, NAMED. It was a sha256 of the definition until
-         * 2026-08-27 — computed here by calling the materializer, then compared by the pilot against
-         * the value the same materializer returned over the same frozen constant. A value compared
-         * with itself.
-         */
-        semanticInputRef: TECHNICAL_DOCUMENTATION_APPLICATION_REQUEST_DIAGRAM_V1.diagramRef,
-        altText: 'A client sends an authenticated request through the application API to a documented resource.',
-    };
-}
+export * from './technical-documentation-diagram-definitions.js';
 function escapeXml(value) {
     return value.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;').replaceAll('"', '&quot;').replaceAll("'", '&apos;');
 }

package/dist/esm/companion/technical-documentation-diagram-materializer.js.map

@@ -1 +1 @@
-{"version":3,"file":"technical-documentation-diagram-materializer.js","sourceRoot":"","sources":["../../../../src/companion/technical-documentation-diagram-materializer.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  TechnicalDocumentationAssetAccessClass,\n  TechnicalDocumentationAssetKind,\n  TechnicalDocumentationAssetOrigin,\n  TechnicalDocumentationAssetRequiredness,\n  TechnicalDocumentationAssetRightsBasis,\n  type TechnicalDocumentationAssetRequestV1,\n} from '@wildo-ai/saas-specifications/technical-documentation';\n\nimport { technicalDocumentationSha256Bytes } from './rendering/technical-documentation-render-model';\n\nexport interface TechnicalDocumentationDiagramNode {\n  readonly nodeRef: string;\n  readonly label: string;\n}\n\nexport interface TechnicalDocumentationDiagramEdge {\n  readonly fromNodeRef: string;\n  readonly toNodeRef: string;\n  readonly label: string;\n}\n\nexport interface TechnicalDocumentationDiagramDefinition {\n  readonly diagramRef: string;\n  readonly title: string;\n  readonly nodes: readonly TechnicalDocumentationDiagramNode[];\n  readonly edges: readonly TechnicalDocumentationDiagramEdge[];\n}\n\nexport const TECHNICAL_DOCUMENTATION_APPLICATION_REQUEST_DIAGRAM_V1: TechnicalDocumentationDiagramDefinition = Object.freeze({\n  diagramRef: 'technical-documentation:diagram/application-api-request',\n  title: 'From client to application API',\n  nodes: Object.freeze([\n    { nodeRef: 'technical-documentation:diagram-node/client', label: 'Client or service' },\n    { nodeRef: 'technical-documentation:diagram-node/application-api', label: 'Application API' },\n    { nodeRef: 'technical-documentation:diagram-node/resource', label: 'Documented resource' },\n  ]),\n  edges: Object.freeze([\n    { fromNodeRef: 'technical-documentation:diagram-node/client', toNodeRef: 'technical-documentation:diagram-node/application-api', label: 'Authenticated request' },\n    { fromNodeRef: 'technical-documentation:diagram-node/application-api', toNodeRef: 'technical-documentation:diagram-node/resource', label: 'Authorized operation' },\n  ]),\n});\n\nexport function createTechnicalDocumentationApplicationRequestDiagramAssetRequest(): TechnicalDocumentationAssetRequestV1 {\n  return {\n    assetRef: 'technical-documentation:asset/application-api-request-diagram',\n    kind: TechnicalDocumentationAssetKind.DIAGRAM,\n    origin: TechnicalDocumentationAssetOrigin.DETERMINISTIC_RENDER,\n    accessClass: TechnicalDocumentationAssetAccessClass.PUBLIC,\n    requiredness: TechnicalDocumentationAssetRequiredness.REQUIRED,\n    rights: {\n      basis: TechnicalDocumentationAssetRightsBasis.ENGINE_AUTHORED,\n      authorityRef: 'technical-documentation:rights/engine-authored-diagram',\n    },\n    sourceAccessClass: TechnicalDocumentationAssetAccessClass.PUBLIC,\n    viewedTenantAccessClass: TechnicalDocumentationAssetAccessClass.PUBLIC,\n    roleAccessClass: TechnicalDocumentationAssetAccessClass.PUBLIC,\n    captureOrRenderProfileRef: 'technical-documentation:renderer/deterministic-svg-v1',\n    /*\n     * The definition this diagram depicts, NAMED. It was a sha256 of the definition until\n     * 2026-08-27 — computed here by calling the materializer, then compared by the pilot against\n     * the value the same materializer returned over the same frozen constant. A value compared\n     * with itself.\n     */\n    semanticInputRef: TECHNICAL_DOCUMENTATION_APPLICATION_REQUEST_DIAGRAM_V1.diagramRef,\n    altText: 'A client sends an authenticated request through the application API to a documented resource.',\n  };\n}\n\nfunction escapeXml(value: string): string {\n  return value.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;').replaceAll('\"', '&quot;').replaceAll(\"'\", '&apos;');\n}\n\n/** A dependency-free deterministic SVG materializer; no layout engine or runtime font metrics participate in its bytes. */\nexport function materializeTechnicalDocumentationDiagram(definition: TechnicalDocumentationDiagramDefinition): {\n  readonly bytes: Uint8Array;\n  readonly byteDigest: string;\n  readonly mediaType: 'image/svg+xml';\n} {\n  if (definition.nodes.length < 2) throw new Error('technical-documentation diagram requires at least two nodes');\n  const nodes = [...definition.nodes].sort((left, right) => left.nodeRef.localeCompare(right.nodeRef));\n  const nodeRefs = nodes.map((node) => node.nodeRef);\n  if (new Set(nodeRefs).size !== nodeRefs.length) throw new Error('technical-documentation diagram node refs must be unique');\n  const nodeRefSet = new Set(nodeRefs);\n  const edges = [...definition.edges].sort((left, right) => `${left.fromNodeRef}\\0${left.toNodeRef}\\0${left.label}`.localeCompare(`${right.fromNodeRef}\\0${right.toNodeRef}\\0${right.label}`));\n  for (const edge of edges) {\n    if (!nodeRefSet.has(edge.fromNodeRef) || !nodeRefSet.has(edge.toNodeRef)) throw new Error('technical-documentation diagram edge references an unknown node');\n  }\n  const width = 960;\n  const nodeWidth = 180;\n  const gap = (width - nodes.length * nodeWidth) / (nodes.length + 1);\n  const xByRef = new Map(nodes.map((node, index) => [node.nodeRef, Math.round(gap + index * (nodeWidth + gap))]));\n  const nodeSvg = nodes.map((node) => {\n    const x = xByRef.get(node.nodeRef) as number;\n    return `<g><rect x=\"${x}\" y=\"96\" width=\"${nodeWidth}\" height=\"72\" rx=\"12\" fill=\"#f7f8fb\" stroke=\"#263247\" stroke-width=\"2\"/><text x=\"${x + nodeWidth / 2}\" y=\"138\" text-anchor=\"middle\" font-family=\"system-ui,sans-serif\" font-size=\"16\" fill=\"#172033\">${escapeXml(node.label)}</text></g>`;\n  }).join('');\n  const edgeSvg = edges.map((edge, index) => {\n    const fromX = (xByRef.get(edge.fromNodeRef) as number) + nodeWidth;\n    const toX = xByRef.get(edge.toNodeRef) as number;\n    const y = 112 + index * 14;\n    return `<g><path d=\"M ${fromX} ${y} L ${toX} ${y}\" stroke=\"#54657e\" stroke-width=\"2\" marker-end=\"url(#arrow)\"/><text x=\"${Math.round((fromX + toX) / 2)}\" y=\"${y - 6}\" text-anchor=\"middle\" font-family=\"system-ui,sans-serif\" font-size=\"12\" fill=\"#34445d\">${escapeXml(edge.label)}</text></g>`;\n  }).join('');\n  const svg = `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"${width}\" height=\"240\" viewBox=\"0 0 ${width} 240\" role=\"img\" aria-labelledby=\"title\"><title id=\"title\">${escapeXml(definition.title)}</title><defs><marker id=\"arrow\" markerWidth=\"8\" markerHeight=\"8\" refX=\"7\" refY=\"4\" orient=\"auto\"><path d=\"M0,0 L8,4 L0,8 z\" fill=\"#54657e\"/></marker></defs><text x=\"480\" y=\"42\" text-anchor=\"middle\" font-family=\"system-ui,sans-serif\" font-size=\"22\" font-weight=\"600\" fill=\"#172033\">${escapeXml(definition.title)}</text>${edgeSvg}${nodeSvg}</svg>\\n`;\n  const bytes = Buffer.from(svg, 'utf8');\n  return Object.freeze({\n    bytes,\n    byteDigest: technicalDocumentationSha256Bytes(bytes),\n    mediaType: 'image/svg+xml' as const,\n  });\n}\n\n/*\n * `technicalDocumentationDiagramProducerImplementationDigest()` lived here until 2026-08-27. It\n * hashed `escapeXml.toString()` and this materializer's own source text, and rode into every\n * resolved asset as `producerImplementationDigest`. Nothing compared it; the producer is named by\n * `producerRef` + `producerVersion`, which a reader can act on.\n */\n"]}
+{"version":3,"file":"technical-documentation-diagram-materializer.js","sourceRoot":"","sources":["../../../../src/companion/technical-documentation-diagram-materializer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Deterministic diagram MATERIALIZATION — declaration in, SVG bytes out.\n *\n * The declarations themselves live in `./technical-documentation-diagram-definitions`, which this\n * module re-exports so every existing consumer and the package barrel are unchanged. See that\n * file's header for why they were split: this one imports the render model for hashing, the render\n * model imports the engine content bundle, and the content bundle names a diagram at module load.\n */\n\nimport { technicalDocumentationSha256Bytes } from './rendering/technical-documentation-render-model';\n\nimport type { TechnicalDocumentationDiagramDefinition } from './technical-documentation-diagram-definitions';\n\nexport * from './technical-documentation-diagram-definitions';\n\nfunction escapeXml(value: string): string {\n  return value.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;').replaceAll('\"', '&quot;').replaceAll(\"'\", '&apos;');\n}\n\n/** A dependency-free deterministic SVG materializer; no layout engine or runtime font metrics participate in its bytes. */\nexport function materializeTechnicalDocumentationDiagram(definition: TechnicalDocumentationDiagramDefinition): {\n  readonly bytes: Uint8Array;\n  readonly byteDigest: string;\n  readonly mediaType: 'image/svg+xml';\n} {\n  if (definition.nodes.length < 2) throw new Error('technical-documentation diagram requires at least two nodes');\n  const nodes = [...definition.nodes].sort((left, right) => left.nodeRef.localeCompare(right.nodeRef));\n  const nodeRefs = nodes.map((node) => node.nodeRef);\n  if (new Set(nodeRefs).size !== nodeRefs.length) throw new Error('technical-documentation diagram node refs must be unique');\n  const nodeRefSet = new Set(nodeRefs);\n  const edges = [...definition.edges].sort((left, right) => `${left.fromNodeRef}\\0${left.toNodeRef}\\0${left.label}`.localeCompare(`${right.fromNodeRef}\\0${right.toNodeRef}\\0${right.label}`));\n  for (const edge of edges) {\n    if (!nodeRefSet.has(edge.fromNodeRef) || !nodeRefSet.has(edge.toNodeRef)) throw new Error('technical-documentation diagram edge references an unknown node');\n  }\n  const width = 960;\n  const nodeWidth = 180;\n  const gap = (width - nodes.length * nodeWidth) / (nodes.length + 1);\n  const xByRef = new Map(nodes.map((node, index) => [node.nodeRef, Math.round(gap + index * (nodeWidth + gap))]));\n  const nodeSvg = nodes.map((node) => {\n    const x = xByRef.get(node.nodeRef) as number;\n    return `<g><rect x=\"${x}\" y=\"96\" width=\"${nodeWidth}\" height=\"72\" rx=\"12\" fill=\"#f7f8fb\" stroke=\"#263247\" stroke-width=\"2\"/><text x=\"${x + nodeWidth / 2}\" y=\"138\" text-anchor=\"middle\" font-family=\"system-ui,sans-serif\" font-size=\"16\" fill=\"#172033\">${escapeXml(node.label)}</text></g>`;\n  }).join('');\n  const edgeSvg = edges.map((edge, index) => {\n    const fromX = (xByRef.get(edge.fromNodeRef) as number) + nodeWidth;\n    const toX = xByRef.get(edge.toNodeRef) as number;\n    const y = 112 + index * 14;\n    return `<g><path d=\"M ${fromX} ${y} L ${toX} ${y}\" stroke=\"#54657e\" stroke-width=\"2\" marker-end=\"url(#arrow)\"/><text x=\"${Math.round((fromX + toX) / 2)}\" y=\"${y - 6}\" text-anchor=\"middle\" font-family=\"system-ui,sans-serif\" font-size=\"12\" fill=\"#34445d\">${escapeXml(edge.label)}</text></g>`;\n  }).join('');\n  const svg = `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"${width}\" height=\"240\" viewBox=\"0 0 ${width} 240\" role=\"img\" aria-labelledby=\"title\"><title id=\"title\">${escapeXml(definition.title)}</title><defs><marker id=\"arrow\" markerWidth=\"8\" markerHeight=\"8\" refX=\"7\" refY=\"4\" orient=\"auto\"><path d=\"M0,0 L8,4 L0,8 z\" fill=\"#54657e\"/></marker></defs><text x=\"480\" y=\"42\" text-anchor=\"middle\" font-family=\"system-ui,sans-serif\" font-size=\"22\" font-weight=\"600\" fill=\"#172033\">${escapeXml(definition.title)}</text>${edgeSvg}${nodeSvg}</svg>\\n`;\n  const bytes = Buffer.from(svg, 'utf8');\n  return Object.freeze({\n    bytes,\n    byteDigest: technicalDocumentationSha256Bytes(bytes),\n    mediaType: 'image/svg+xml' as const,\n  });\n}\n\n/*\n * `technicalDocumentationDiagramProducerImplementationDigest()` lived here until 2026-08-27. It\n * hashed `escapeXml.toString()` and this materializer's own source text, and rode into every\n * resolved asset as `producerImplementationDigest`. Nothing compared it; the producer is named by\n * `producerRef` + `producerVersion`, which a reader can act on.\n */\n"]}

package/dist/esm/config/wildo-tech-doc-config.schemas.d.ts

@@ -103,10 +103,14 @@ export declare const WildoTechnicalDocConfigSchema: z.ZodObject<{
      * - `CoreResourceType[]` — a curated subset (e.g. `[CoreResourceType.ORGANIZATIONS,
      *   CoreResourceType.ORGANIZATION_MEMBERS, CoreResourceType.FILES]`).
      *
-     * Omitted (default): only the app's own resources are documented. Org-scoped
-     * core resources land in the (auth-gated) Organization API section; any
-     * anonymous ones in the Application API section — the existing section split
-     * by operation access level is unchanged.
+     * Omitted (default): only the app's own resources are documented.
+     *
+     * There is no organizational section. `OpenApiSection` has exactly two members,
+     * `API_REFERENCE` and `APPLICATION_ADMINISTRATION_API_REFERENCE`, neither of which is scoped to
+     * an organization. The split is made per OPERATION, from the `consumerApiSection` the source
+     * projector resolves, so a selected core resource's operations may land in either. Nothing the
+     * docs site emits is auth-gated; see `docs-auth-session.schemas.ts` for why the decoded role axis
+     * is not a control.
      */
     apiDocResources: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodEnum<typeof CoreResourceType>>, z.ZodLiteral<"all">]>>;
     /**

package/dist/esm/config/wildo-tech-doc-config.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wildo-tech-doc-config.schemas.d.ts","sourceRoot":"","sources":["../../../../src/config/wildo-tech-doc-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAG,KAAc,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,4CAA4C;;;;;kBAEvD,CAAC;AACH,MAAM,MAAM,sCAAsC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4CAA4C,CAAC,CAAC;AAElH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,6BAA6B;IACxC;;;;;OAKG;;IAGH;;;;;;;;OAQG;;;;;;IASH;;;;;;;;;;OAUG;;IAGH;;;;OAIG;;IAGH;;;;;;;;;;;;;;;;;;OAkBG;;IAMH;;;;;;;;OAQG;;;;;;;IAGH;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;;;;;IAGH;;;;;;;;;;;;;;;OAeG;;IAGH;;;;;;;;;;;;;;;;;;OAkBG;;;;;;;;kBAEH,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACzF,8DAA8D"}
+{"version":3,"file":"wildo-tech-doc-config.schemas.d.ts","sourceRoot":"","sources":["../../../../src/config/wildo-tech-doc-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAG,KAAc,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,4CAA4C;;;;;kBAEvD,CAAC;AACH,MAAM,MAAM,sCAAsC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4CAA4C,CAAC,CAAC;AAElH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,6BAA6B;IACxC;;;;;OAKG;;IAGH;;;;;;;;OAQG;;;;;;IASH;;;;;;;;;;OAUG;;IAGH;;;;OAIG;;IAGH;;;;;;;;;;;;;;;;;;;;;;OAsBG;;IAMH;;;;;;;;OAQG;;;;;;;IAGH;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;;;;;IAGH;;;;;;;;;;;;;;;OAeG;;IAGH;;;;;;;;;;;;;;;;;;OAkBG;;;;;;;;kBAEH,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACzF,8DAA8D"}

package/dist/esm/config/wildo-tech-doc-config.schemas.js

@@ -104,10 +104,14 @@ export const WildoTechnicalDocConfigSchema = z.strictObject({
      * - `CoreResourceType[]` — a curated subset (e.g. `[CoreResourceType.ORGANIZATIONS,
      *   CoreResourceType.ORGANIZATION_MEMBERS, CoreResourceType.FILES]`).
      *
-     * Omitted (default): only the app's own resources are documented. Org-scoped
-     * core resources land in the (auth-gated) Organization API section; any
-     * anonymous ones in the Application API section — the existing section split
-     * by operation access level is unchanged.
+     * Omitted (default): only the app's own resources are documented.
+     *
+     * There is no organizational section. `OpenApiSection` has exactly two members,
+     * `API_REFERENCE` and `APPLICATION_ADMINISTRATION_API_REFERENCE`, neither of which is scoped to
+     * an organization. The split is made per OPERATION, from the `consumerApiSection` the source
+     * projector resolves, so a selected core resource's operations may land in either. Nothing the
+     * docs site emits is auth-gated; see `docs-auth-session.schemas.ts` for why the decoded role axis
+     * is not a control.
      */
     apiDocResources: z.union([
         z.array(z.enum(CoreResourceType)),