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

package/dist/esm/runtime/openapi-reference-words-context.js

@@ -0,0 +1,30 @@
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { Fragment, createContext, useContext } from 'react';
+import { isDocumentationListItem, splitMessagePlaceholders } from './documentation-site-translator.js';
+/*
+ * The view's own plumbing for its words — deliberately NOT exported from the runtime (#1992 review): a
+ * site builds its words with `createApiReferenceWords` and passes them to a view; it never reads them
+ * back out of a context, and a hook it could import would only throw outside a view.
+ */
+const ApiReferenceWordsContext = createContext(null);
+/** Provides the words to every part of one reference surface. */
+export const ApiReferenceWordsProvider = ApiReferenceWordsContext.Provider;
+/** The words the enclosing reference view was given. Every view requires them, so this never answers empty. */
+export function useReferenceWords() {
+    const words = useContext(ApiReferenceWordsContext);
+    if (words === null)
+        throw new Error('An API reference part rendered outside a view that was given its words (#1992).');
+    return words;
+}
+/** A sentence with each `{name}` replaced by the element given for it; a placeholder with none stays as written. */
+export function renderSentence(sentence, elements) {
+    // Own elements only, so `{constructor}` stays visibly unfilled instead of resolving to an inherited member.
+    return _jsx(_Fragment, { children: splitMessagePlaceholders(sentence).map((segment, index) => (index % 2 === 1
+            ? _jsx(Fragment, { children: Object.hasOwn(elements, segment) ? elements[segment] : `{${segment}}` }, index)
+            : segment.length > 0 ? _jsx(Fragment, { children: segment }, index) : null)) });
+}
+/** `items` laid out in the reader's locale's list pattern (see `ApiReferenceWords.listLayout`). */
+export function renderList(words, items, kind) {
+    return _jsx(_Fragment, { children: words.listLayout(items.length, kind).map((part, index) => _jsx(Fragment, { children: isDocumentationListItem(part) ? items[part.item] : part.separator }, index)) });
+}
+//# sourceMappingURL=openapi-reference-words-context.js.map

package/dist/esm/runtime/openapi-reference-words-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-reference-words-context.js","sourceRoot":"","sources":["../../../../src/runtime/openapi-reference-words-context.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAC;AAE5E,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAA8B,MAAM,iCAAiC,CAAC;AAGhI;;;;GAIG;AAEH,MAAM,wBAAwB,GAAG,aAAa,CAA2B,IAAI,CAAC,CAAC;AAE/E,iEAAiE;AACjE,MAAM,CAAC,MAAM,yBAAyB,GAAG,wBAAwB,CAAC,QAAQ,CAAC;AAE3E,+GAA+G;AAC/G,MAAM,UAAU,iBAAiB;IAC/B,MAAM,KAAK,GAAG,UAAU,CAAC,wBAAwB,CAAC,CAAC;IACnD,IAAI,KAAK,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;IACvH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,oHAAoH;AACpH,MAAM,UAAU,cAAc,CAAC,QAA8B,EAAE,QAA6C;IAC1G,4GAA4G;IAC5G,OAAO,4BAAG,wBAAwB,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC;YACnF,CAAC,CAAC,KAAC,QAAQ,cAAc,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,IAA7E,KAAK,CAAoF;YAC1G,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAC,QAAQ,cAAc,OAAO,IAAf,KAAK,CAAsB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAI,CAAC;AACnF,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,UAAU,CAAC,KAAwB,EAAE,KAA2B,EAAE,IAA2B;IAC3G,OAAO,4BAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAC,QAAQ,cAAc,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,IAAzE,KAAK,CAAgF,CAAC,GAAI,CAAC;AAChL,CAAC","sourcesContent":["import { Fragment, createContext, useContext, type ReactNode } from 'react';\n\nimport { isDocumentationListItem, splitMessagePlaceholders, type DocumentationListKind } from './documentation-site-translator';\nimport type { ApiReferenceSentence, ApiReferenceWords } from './openapi-reference-words';\n\n/*\n * The view's own plumbing for its words — deliberately NOT exported from the runtime (#1992 review): a\n * site builds its words with `createApiReferenceWords` and passes them to a view; it never reads them\n * back out of a context, and a hook it could import would only throw outside a view.\n */\n\nconst ApiReferenceWordsContext = createContext<ApiReferenceWords | null>(null);\n\n/** Provides the words to every part of one reference surface. */\nexport const ApiReferenceWordsProvider = ApiReferenceWordsContext.Provider;\n\n/** The words the enclosing reference view was given. Every view requires them, so this never answers empty. */\nexport function useReferenceWords(): ApiReferenceWords {\n  const words = useContext(ApiReferenceWordsContext);\n  if (words === null) throw new Error('An API reference part rendered outside a view that was given its words (#1992).');\n  return words;\n}\n\n/** A sentence with each `{name}` replaced by the element given for it; a placeholder with none stays as written. */\nexport function renderSentence(sentence: ApiReferenceSentence, elements: Readonly<Record<string, ReactNode>>): ReactNode {\n  // Own elements only, so `{constructor}` stays visibly unfilled instead of resolving to an inherited member.\n  return <>{splitMessagePlaceholders(sentence).map((segment, index) => (index % 2 === 1\n    ? <Fragment key={index}>{Object.hasOwn(elements, segment) ? elements[segment] : `{${segment}}`}</Fragment>\n    : segment.length > 0 ? <Fragment key={index}>{segment}</Fragment> : null))}</>;\n}\n\n/** `items` laid out in the reader's locale's list pattern (see `ApiReferenceWords.listLayout`). */\nexport function renderList(words: ApiReferenceWords, items: readonly ReactNode[], kind: DocumentationListKind): ReactNode {\n  return <>{words.listLayout(items.length, kind).map((part, index) => <Fragment key={index}>{isDocumentationListItem(part) ? items[part.item] : part.separator}</Fragment>)}</>;\n}\n"]}

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

@@ -0,0 +1,205 @@
+import { DocumentationListKind, type DocumentationListPart, type DocumentationSiteTranslator } from './documentation-site-translator';
+/**
+ * A message whose `{name}` placeholders the VIEW fills with the document's own elements — a role's
+ * label in bold, a field name in code — so the sentence's word order is the locale's while its values
+ * keep their formatting. Rendered by `renderSentence` in the view.
+ */
+export type ApiReferenceSentence = string;
+/**
+ * Every word the API reference shows a reader (#1992).
+ *
+ * The documentation runtime has no label pack of its own, and the reference used to carry its chrome as
+ * English written into the components — "Filter resources", "Required role", "Any one of", "Copy". The
+ * site now passes them in, worded with Docusaurus `translate({ id })` from its `i18n/<locale>/code.json`
+ * (the scaffold's `src/components/documentation-site-words.ts`), as the site's search page words itself
+ * (#1964) and as `DocsProviderComponent` takes its states. The type is the contract: a site that omits a
+ * word does not compile, and a word its locale lacks shows its id rather than English.
+ *
+ * How the view builds text out of these, so no sentence is assembled from fragments:
+ * - a sentence that places string values is a FUNCTION returning the finished text (plural form chosen
+ *   first, values placed after);
+ * - a sentence that places the document's formatted elements is an {@link ApiReferenceSentence}, filled
+ *   by the view (`{roles}`, `{field}`, `{type}`, `{parameters}`, `{heading}`, `{address}`);
+ * - a list is laid out by {@link ApiReferenceWords.listLayout}, the locale's own list pattern.
+ * What the view still writes itself is typographic, not words: the ` · ` between facts and the ` — `
+ * between an element and its description, a label word followed by its value (`Format:` then the
+ * format), and the `field = value` notation of the errors table.
+ *
+ * Values that are the document's own (a resource label, a path, a status code, a role key) are passed
+ * in as they are.
+ *
+ * What is NOT here, deliberately: the document's content (labels, descriptions, summaries — authored in
+ * the application's specifications), wire identifiers shown as code (`error.type`, a media type), and
+ * the names of the three sample languages (cURL, JavaScript, Python), which are product names.
+ */
+export interface ApiReferenceWords {
+    readonly openNavigation: string;
+    readonly closeNavigation: string;
+    readonly apiNavigation: string;
+    readonly apiSections: string;
+    readonly filterResources: string;
+    readonly resourcesNavigation: string;
+    readonly overview: string;
+    readonly otherResources: string;
+    readonly noResourceMatches: (query: string) => string;
+    readonly operationsSwitcher: (operationCount: number) => string;
+    readonly resourceOperations: (resourceLabel: string) => string;
+    readonly filterOperations: (operationCount: number) => string;
+    readonly resourceCount: (count: number) => string;
+    readonly operationCount: (count: number) => string;
+    readonly matchingResources: (count: number) => string;
+    readonly apiResources: string;
+    readonly referenceSize: string;
+    readonly referenceSizeSummary: (operationCount: number, resourceCount: number) => string;
+    readonly searchReference: string;
+    readonly searchPlaceholder: string;
+    readonly clearSearch: string;
+    readonly browseResources: (count: number) => string;
+    readonly noSearchMatches: string;
+    readonly contractEyebrow: string;
+    readonly indexLead: string;
+    readonly allResources: string;
+    readonly resourceNotInDocument: (resourceName: string) => string;
+    readonly breadcrumb: string;
+    readonly selectResourcePrompt: string;
+    readonly apiOverview: string;
+    readonly apiConventions: string;
+    readonly connectionDetails: string;
+    readonly baseUrls: string;
+    readonly authenticationMechanisms: string;
+    readonly schemeType: string;
+    readonly schemeScheme: string;
+    readonly schemeFormat: string;
+    readonly schemeLocation: string;
+    readonly schemeName: string;
+    readonly resourceCardMeta: (familyCount: number, variantCount: number) => string;
+    readonly lifecycle: string;
+    readonly resourceObject: (resourceLabel: string) => string;
+    readonly dataRelationships: (count: number) => string;
+    /** `{related}` (the related resource, bold) reached through `{field}` (the foreign key, code). */
+    readonly relationshipVia: ApiReferenceSentence;
+    readonly relationshipSummary: (values: {
+        readonly nature: string;
+        readonly cardinality: string;
+        readonly relatedCardinality: string;
+        readonly lifecycleModel: string;
+    }) => string;
+    readonly parentDeletePolicy: (policy: string) => string;
+    readonly parentDeleteDoesNotCascade: string;
+    readonly parentDeleteCascade: (values: {
+        readonly strategy: string;
+        readonly mode: string;
+        readonly maxDepth: number;
+    }) => string;
+    readonly familyVariants: (familyLabel: string) => string;
+    readonly copyPathOf: (operationSummary: string) => string;
+    readonly access: string;
+    readonly requiredRole: string;
+    /** `{roles}`: the accepted roles, laid out as a disjunction. */
+    readonly requiredRoles: ApiReferenceSentence;
+    /** `{label}` (bold) then `{key}` (code): one accepted role. */
+    readonly roleWithKey: ApiReferenceSentence;
+    readonly authentication: string;
+    readonly idempotent: string;
+    readonly yes: string;
+    readonly no: string;
+    readonly roleAuthorityDetails: string;
+    readonly boundary: string;
+    readonly alsoReachableAt: string;
+    /** `{heading}` (the "also reachable at" word, bold) introducing the alias routes. */
+    readonly aliasNote: ApiReferenceSentence;
+    /** `{address}` (method and path, code) and the `{parameters}` it adds, a conjunction. */
+    readonly aliasWithParameters: ApiReferenceSentence;
+    readonly requestBody: string;
+    readonly required: string;
+    readonly optional: string;
+    readonly responses: string;
+    readonly noResponseContract: string;
+    readonly errors: string;
+    readonly copy: string;
+    readonly copied: string;
+    readonly samplesFor: (operationSummary: string) => string;
+    readonly requestSample: string;
+    readonly request: string;
+    readonly language: string;
+    readonly copyRequestSample: string;
+    readonly server: string;
+    readonly responseExample: string;
+    readonly response: string;
+    readonly responseStatus: string;
+    readonly copyResponseExample: string;
+    readonly noExampleForStatus: (requestedStatus: string, shownStatus: string) => string;
+    readonly noResponseExample: string;
+    readonly requestAndResponse: string;
+    readonly requestAndResponseFor: (operationSummary: string) => string;
+    readonly close: string;
+    readonly errorStatus: string;
+    readonly errorWhen: string;
+    readonly errorBranchOn: string;
+    readonly pathParameters: string;
+    readonly queryParameters: string;
+    readonly headerParameters: string;
+    readonly cookieParameters: string;
+    readonly otherParameters: string;
+    readonly documentedResponses: string;
+    readonly noStructuredRepresentation: string;
+    readonly bodyFields: string;
+    readonly anyValue: string;
+    readonly noValue: string;
+    readonly unnamedSchema: string;
+    readonly format: string;
+    readonly defaultValue: string;
+    readonly constantValue: string;
+    readonly allowedValues: string;
+    readonly properties: string;
+    /**
+     * The button revealing a long list's remaining fields, naming them — or, with `moreRemain`, only the first
+     * few, which the message words as a sample ("including a, b and c") rather than as the whole list.
+     */
+    readonly showMoreFields: (hiddenCount: number, fieldNames: readonly string[], moreRemain: boolean) => string;
+    readonly requiredFieldMarker: (fieldName: string) => string;
+    /** `{type}`: what an array's items are. */
+    readonly arrayItemsOf: ApiReferenceSentence;
+    readonly model: string;
+    readonly additionalProperties: string;
+    readonly allowed: string;
+    readonly notAllowed: string;
+    readonly childFieldsOf: (fieldName: string) => string;
+    readonly compositionOption: (position: number) => string;
+    /** A composition branch named by the value its discriminating property takes in it. */
+    readonly discriminatorValue: (field: string, value: string) => string;
+    readonly oneOf: string;
+    readonly anyOf: string;
+    readonly allOf: string;
+    readonly compositionShapes: (compositionLabel: string, shapeCount: number) => string;
+    readonly reusableDataModels: (count: number) => string;
+    readonly selectModelPrompt: string;
+    readonly schemaType: string;
+    readonly examples: (count: number) => string;
+    readonly externalExample: string;
+    readonly noInlineExample: string;
+    /** Where each of `itemCount` items goes, and what the reader's locale puts between them. */
+    readonly listLayout: (itemCount: number, kind: DocumentationListKind) => readonly DocumentationListPart[];
+}
+/** The prefix every API reference word's id carries in the site's `code.json`. */
+export declare const API_REFERENCE_WORD_ID_PREFIX = "docs.apiReference.";
+/**
+ * Words that are only ever PART of another word — counts a sentence places — and so are not members of
+ * {@link ApiReferenceWords}. Every other id is `docs.apiReference.<member>`.
+ */
+export declare enum ApiReferenceComponentWordId {
+    /** `{count} operation families`, placed in a resource card's line. */
+    OPERATION_FAMILY_COUNT = "operationFamilyCount",
+    /** `{count} variants`, placed in a resource card's line. */
+    VARIANT_COUNT = "variantCount",
+    /** The "show more fields" button when more fields follow the ones it names. */
+    SHOW_MORE_FIELDS_TRUNCATED = "showMoreFieldsTruncated"
+}
+/** Every id the API reference reads from the site's `code.json`, without its prefix. */
+export type ApiReferenceWordId = keyof ApiReferenceWords | ApiReferenceComponentWordId;
+/**
+ * The API reference's words, looked up through the site's translator (#1992). Each member reads the
+ * id `docs.apiReference.<member>`; a counted one is a `|`-separated plural message with `{count}`.
+ */
+export declare function createApiReferenceWords({ locale, translate, selectPlural }: DocumentationSiteTranslator): ApiReferenceWords;
+//# sourceMappingURL=openapi-reference-words.d.ts.map

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

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

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

@@ -0,0 +1,162 @@
+import { DocumentationListKind, documentationListLayout, fillMessage, isDocumentationListItem, } from './documentation-site-translator.js';
+/** The prefix every API reference word's id carries in the site's `code.json`. */
+export const API_REFERENCE_WORD_ID_PREFIX = 'docs.apiReference.';
+/**
+ * Words that are only ever PART of another word — counts a sentence places — and so are not members of
+ * {@link ApiReferenceWords}. Every other id is `docs.apiReference.<member>`.
+ */
+export var ApiReferenceComponentWordId;
+(function (ApiReferenceComponentWordId) {
+    /** `{count} operation families`, placed in a resource card's line. */
+    ApiReferenceComponentWordId["OPERATION_FAMILY_COUNT"] = "operationFamilyCount";
+    /** `{count} variants`, placed in a resource card's line. */
+    ApiReferenceComponentWordId["VARIANT_COUNT"] = "variantCount";
+    /** The "show more fields" button when more fields follow the ones it names. */
+    ApiReferenceComponentWordId["SHOW_MORE_FIELDS_TRUNCATED"] = "showMoreFieldsTruncated";
+})(ApiReferenceComponentWordId || (ApiReferenceComponentWordId = {}));
+/**
+ * The API reference's words, looked up through the site's translator (#1992). Each member reads the
+ * id `docs.apiReference.<member>`; a counted one is a `|`-separated plural message with `{count}`.
+ */
+export function createApiReferenceWords({ locale, translate, selectPlural }) {
+    const message = (id) => translate(`${API_REFERENCE_WORD_ID_PREFIX}${id}`);
+    const word = (id, values = {}) => fillMessage(message(id), values);
+    // The plural form is chosen on the message as written, then the values are placed.
+    const counted = (id, count, values = {}) => fillMessage(selectPlural(count, message(id)), { count: String(count), ...values });
+    const listOf = (items, kind) => documentationListLayout(locale, items.length, kind).map((part) => (isDocumentationListItem(part) ? items[part.item] : part.separator)).join('');
+    return {
+        openNavigation: word('openNavigation'),
+        closeNavigation: word('closeNavigation'),
+        apiNavigation: word('apiNavigation'),
+        apiSections: word('apiSections'),
+        filterResources: word('filterResources'),
+        resourcesNavigation: word('resourcesNavigation'),
+        overview: word('overview'),
+        otherResources: word('otherResources'),
+        noResourceMatches: (query) => word('noResourceMatches', { query }),
+        operationsSwitcher: (operationCount) => counted('operationsSwitcher', operationCount),
+        resourceOperations: (resourceLabel) => word('resourceOperations', { resource: resourceLabel }),
+        filterOperations: (operationCount) => counted('filterOperations', operationCount),
+        resourceCount: (count) => counted('resourceCount', count),
+        operationCount: (count) => counted('operationCount', count),
+        matchingResources: (count) => counted('matchingResources', count),
+        apiResources: word('apiResources'),
+        referenceSize: word('referenceSize'),
+        referenceSizeSummary: (operationCount, resourceCount) => word('referenceSizeSummary', {
+            operations: counted('operationCount', operationCount),
+            resources: counted('resourceCount', resourceCount),
+        }),
+        searchReference: word('searchReference'),
+        searchPlaceholder: word('searchPlaceholder'),
+        clearSearch: word('clearSearch'),
+        browseResources: (count) => counted('browseResources', count),
+        noSearchMatches: word('noSearchMatches'),
+        contractEyebrow: word('contractEyebrow'),
+        indexLead: word('indexLead'),
+        allResources: word('allResources'),
+        resourceNotInDocument: (resourceName) => word('resourceNotInDocument', { resource: resourceName }),
+        breadcrumb: word('breadcrumb'),
+        selectResourcePrompt: word('selectResourcePrompt'),
+        apiOverview: word('apiOverview'),
+        apiConventions: word('apiConventions'),
+        connectionDetails: word('connectionDetails'),
+        baseUrls: word('baseUrls'),
+        authenticationMechanisms: word('authenticationMechanisms'),
+        schemeType: word('schemeType'),
+        schemeScheme: word('schemeScheme'),
+        schemeFormat: word('schemeFormat'),
+        schemeLocation: word('schemeLocation'),
+        schemeName: word('schemeName'),
+        resourceCardMeta: (familyCount, variantCount) => word('resourceCardMeta', {
+            families: counted(ApiReferenceComponentWordId.OPERATION_FAMILY_COUNT, familyCount),
+            variants: counted(ApiReferenceComponentWordId.VARIANT_COUNT, variantCount),
+        }),
+        lifecycle: word('lifecycle'),
+        resourceObject: (resourceLabel) => word('resourceObject', { resource: resourceLabel }),
+        dataRelationships: (count) => counted('dataRelationships', count),
+        relationshipVia: message('relationshipVia'),
+        relationshipSummary: ({ nature, cardinality, relatedCardinality, lifecycleModel }) => word('relationshipSummary', { nature, cardinality, relatedCardinality, lifecycleModel }),
+        parentDeletePolicy: (policy) => word('parentDeletePolicy', { policy }),
+        parentDeleteDoesNotCascade: word('parentDeleteDoesNotCascade'),
+        parentDeleteCascade: ({ strategy, mode, maxDepth }) => word('parentDeleteCascade', { strategy, mode, maxDepth: String(maxDepth) }),
+        familyVariants: (familyLabel) => word('familyVariants', { family: familyLabel }),
+        copyPathOf: (operationSummary) => word('copyPathOf', { operation: operationSummary }),
+        access: word('access'),
+        requiredRole: word('requiredRole'),
+        requiredRoles: message('requiredRoles'),
+        roleWithKey: message('roleWithKey'),
+        authentication: word('authentication'),
+        idempotent: word('idempotent'),
+        yes: word('yes'),
+        no: word('no'),
+        roleAuthorityDetails: word('roleAuthorityDetails'),
+        boundary: word('boundary'),
+        alsoReachableAt: word('alsoReachableAt'),
+        aliasNote: message('aliasNote'),
+        aliasWithParameters: message('aliasWithParameters'),
+        requestBody: word('requestBody'),
+        required: word('required'),
+        optional: word('optional'),
+        responses: word('responses'),
+        noResponseContract: word('noResponseContract'),
+        errors: word('errors'),
+        copy: word('copy'),
+        copied: word('copied'),
+        samplesFor: (operationSummary) => word('samplesFor', { operation: operationSummary }),
+        requestSample: word('requestSample'),
+        request: word('request'),
+        language: word('language'),
+        copyRequestSample: word('copyRequestSample'),
+        server: word('server'),
+        responseExample: word('responseExample'),
+        response: word('response'),
+        responseStatus: word('responseStatus'),
+        copyResponseExample: word('copyResponseExample'),
+        noExampleForStatus: (requestedStatus, shownStatus) => word('noExampleForStatus', { requested: requestedStatus, shown: shownStatus }),
+        noResponseExample: word('noResponseExample'),
+        requestAndResponse: word('requestAndResponse'),
+        requestAndResponseFor: (operationSummary) => word('requestAndResponseFor', { operation: operationSummary }),
+        close: word('close'),
+        errorStatus: word('errorStatus'),
+        errorWhen: word('errorWhen'),
+        errorBranchOn: word('errorBranchOn'),
+        pathParameters: word('pathParameters'),
+        queryParameters: word('queryParameters'),
+        headerParameters: word('headerParameters'),
+        cookieParameters: word('cookieParameters'),
+        otherParameters: word('otherParameters'),
+        documentedResponses: word('documentedResponses'),
+        noStructuredRepresentation: word('noStructuredRepresentation'),
+        bodyFields: word('bodyFields'),
+        anyValue: word('anyValue'),
+        noValue: word('noValue'),
+        unnamedSchema: word('unnamedSchema'),
+        format: word('format'),
+        defaultValue: word('defaultValue'),
+        constantValue: word('constantValue'),
+        allowedValues: word('allowedValues'),
+        properties: word('properties'),
+        showMoreFields: (hiddenCount, fieldNames, moreRemain) => counted(moreRemain ? ApiReferenceComponentWordId.SHOW_MORE_FIELDS_TRUNCATED : 'showMoreFields', hiddenCount, { fields: listOf(fieldNames, DocumentationListKind.CONJUNCTION) }),
+        requiredFieldMarker: (fieldName) => word('requiredFieldMarker', { field: fieldName }),
+        arrayItemsOf: message('arrayItemsOf'),
+        model: word('model'),
+        additionalProperties: word('additionalProperties'),
+        allowed: word('allowed'),
+        notAllowed: word('notAllowed'),
+        childFieldsOf: (fieldName) => word('childFieldsOf', { field: fieldName }),
+        compositionOption: (position) => word('compositionOption', { position: String(position) }),
+        discriminatorValue: (field, value) => word('discriminatorValue', { field, value }),
+        oneOf: word('oneOf'),
+        anyOf: word('anyOf'),
+        allOf: word('allOf'),
+        compositionShapes: (compositionLabel, shapeCount) => counted('compositionShapes', shapeCount, { composition: compositionLabel }),
+        reusableDataModels: (count) => counted('reusableDataModels', count),
+        selectModelPrompt: word('selectModelPrompt'),
+        schemaType: word('schemaType'),
+        examples: (count) => counted('examples', count),
+        externalExample: word('externalExample'),
+        noInlineExample: word('noInlineExample'),
+        listLayout: (itemCount, kind) => documentationListLayout(locale, itemCount, kind),
+    };
+}
+//# sourceMappingURL=openapi-reference-words.js.map

package/dist/esm/runtime/openapi-reference-words.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-reference-words.js","sourceRoot":"","sources":["../../../../src/runtime/openapi-reference-words.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  DocumentationListKind,\n  documentationListLayout,\n  fillMessage,\n  isDocumentationListItem,\n  type DocumentationListPart,\n  type DocumentationSiteTranslator,\n} from './documentation-site-translator';\n\n/**\n * A message whose `{name}` placeholders the VIEW fills with the document's own elements — a role's\n * label in bold, a field name in code — so the sentence's word order is the locale's while its values\n * keep their formatting. Rendered by `renderSentence` in the view.\n */\nexport type ApiReferenceSentence = string;\n\n/**\n * Every word the API reference shows a reader (#1992).\n *\n * The documentation runtime has no label pack of its own, and the reference used to carry its chrome as\n * English written into the components — \"Filter resources\", \"Required role\", \"Any one of\", \"Copy\". The\n * site now passes them in, worded with Docusaurus `translate({ id })` from its `i18n/<locale>/code.json`\n * (the scaffold's `src/components/documentation-site-words.ts`), as the site's search page words itself\n * (#1964) and as `DocsProviderComponent` takes its states. The type is the contract: a site that omits a\n * word does not compile, and a word its locale lacks shows its id rather than English.\n *\n * How the view builds text out of these, so no sentence is assembled from fragments:\n * - a sentence that places string values is a FUNCTION returning the finished text (plural form chosen\n *   first, values placed after);\n * - a sentence that places the document's formatted elements is an {@link ApiReferenceSentence}, filled\n *   by the view (`{roles}`, `{field}`, `{type}`, `{parameters}`, `{heading}`, `{address}`);\n * - a list is laid out by {@link ApiReferenceWords.listLayout}, the locale's own list pattern.\n * What the view still writes itself is typographic, not words: the ` · ` between facts and the ` — `\n * between an element and its description, a label word followed by its value (`Format:` then the\n * format), and the `field = value` notation of the errors table.\n *\n * Values that are the document's own (a resource label, a path, a status code, a role key) are passed\n * in as they are.\n *\n * What is NOT here, deliberately: the document's content (labels, descriptions, summaries — authored in\n * the application's specifications), wire identifiers shown as code (`error.type`, a media type), and\n * the names of the three sample languages (cURL, JavaScript, Python), which are product names.\n */\nexport interface ApiReferenceWords {\n  /* The shell: rail, drawer and sub-bar. */\n  readonly openNavigation: string;\n  readonly closeNavigation: string;\n  readonly apiNavigation: string;\n  readonly apiSections: string;\n  readonly filterResources: string;\n  readonly resourcesNavigation: string;\n  readonly overview: string;\n  readonly otherResources: string;\n  readonly noResourceMatches: (query: string) => string;\n  readonly operationsSwitcher: (operationCount: number) => string;\n  readonly resourceOperations: (resourceLabel: string) => string;\n  readonly filterOperations: (operationCount: number) => string;\n\n  /* Counts, shared by the rail, the index and the search status. */\n  readonly resourceCount: (count: number) => string;\n  readonly operationCount: (count: number) => string;\n  readonly matchingResources: (count: number) => string;\n\n  /* The index: overview, connection, search, category grid. */\n  readonly apiResources: string;\n  readonly referenceSize: string;\n  readonly referenceSizeSummary: (operationCount: number, resourceCount: number) => string;\n  readonly searchReference: string;\n  readonly searchPlaceholder: string;\n  readonly clearSearch: string;\n  readonly browseResources: (count: number) => string;\n  readonly noSearchMatches: string;\n  readonly contractEyebrow: string;\n  readonly indexLead: string;\n  readonly allResources: string;\n  readonly resourceNotInDocument: (resourceName: string) => string;\n  readonly breadcrumb: string;\n  readonly selectResourcePrompt: string;\n  readonly apiOverview: string;\n  readonly apiConventions: string;\n  readonly connectionDetails: string;\n  readonly baseUrls: string;\n  readonly authenticationMechanisms: string;\n  readonly schemeType: string;\n  readonly schemeScheme: string;\n  readonly schemeFormat: string;\n  readonly schemeLocation: string;\n  readonly schemeName: string;\n  readonly resourceCardMeta: (familyCount: number, variantCount: number) => string;\n\n  /* A resource's introduction. */\n  readonly lifecycle: string;\n  readonly resourceObject: (resourceLabel: string) => string;\n  readonly dataRelationships: (count: number) => string;\n  /** `{related}` (the related resource, bold) reached through `{field}` (the foreign key, code). */\n  readonly relationshipVia: ApiReferenceSentence;\n  readonly relationshipSummary: (values: {\n    readonly nature: string;\n    readonly cardinality: string;\n    readonly relatedCardinality: string;\n    readonly lifecycleModel: string;\n  }) => string;\n  readonly parentDeletePolicy: (policy: string) => string;\n  readonly parentDeleteDoesNotCascade: string;\n  readonly parentDeleteCascade: (values: { readonly strategy: string; readonly mode: string; readonly maxDepth: number }) => string;\n\n  /* An operation. */\n  readonly familyVariants: (familyLabel: string) => string;\n  readonly copyPathOf: (operationSummary: string) => string;\n  readonly access: string;\n  readonly requiredRole: string;\n  /** `{roles}`: the accepted roles, laid out as a disjunction. */\n  readonly requiredRoles: ApiReferenceSentence;\n  /** `{label}` (bold) then `{key}` (code): one accepted role. */\n  readonly roleWithKey: ApiReferenceSentence;\n  readonly authentication: string;\n  readonly idempotent: string;\n  readonly yes: string;\n  readonly no: string;\n  readonly roleAuthorityDetails: string;\n  readonly boundary: string;\n  readonly alsoReachableAt: string;\n  /** `{heading}` (the \"also reachable at\" word, bold) introducing the alias routes. */\n  readonly aliasNote: ApiReferenceSentence;\n  /** `{address}` (method and path, code) and the `{parameters}` it adds, a conjunction. */\n  readonly aliasWithParameters: ApiReferenceSentence;\n  readonly requestBody: string;\n  readonly required: string;\n  readonly optional: string;\n  readonly responses: string;\n  readonly noResponseContract: string;\n  readonly errors: string;\n  readonly copy: string;\n  readonly copied: string;\n\n  /* Samples. */\n  readonly samplesFor: (operationSummary: string) => string;\n  readonly requestSample: string;\n  readonly request: string;\n  readonly language: string;\n  readonly copyRequestSample: string;\n  readonly server: string;\n  readonly responseExample: string;\n  readonly response: string;\n  readonly responseStatus: string;\n  readonly copyResponseExample: string;\n  readonly noExampleForStatus: (requestedStatus: string, shownStatus: string) => string;\n  readonly noResponseExample: string;\n  readonly requestAndResponse: string;\n  readonly requestAndResponseFor: (operationSummary: string) => string;\n  readonly close: string;\n\n  /* Errors table. */\n  readonly errorStatus: string;\n  readonly errorWhen: string;\n  readonly errorBranchOn: string;\n\n  /* Parameters and bodies. */\n  readonly pathParameters: string;\n  readonly queryParameters: string;\n  readonly headerParameters: string;\n  readonly cookieParameters: string;\n  readonly otherParameters: string;\n  readonly documentedResponses: string;\n  readonly noStructuredRepresentation: string;\n  readonly bodyFields: string;\n\n  /* Schemas. */\n  readonly anyValue: string;\n  readonly noValue: string;\n  readonly unnamedSchema: string;\n  readonly format: string;\n  readonly defaultValue: string;\n  readonly constantValue: string;\n  readonly allowedValues: string;\n  readonly properties: string;\n  /**\n   * The button revealing a long list's remaining fields, naming them — or, with `moreRemain`, only the first\n   * few, which the message words as a sample (\"including a, b and c\") rather than as the whole list.\n   */\n  readonly showMoreFields: (hiddenCount: number, fieldNames: readonly string[], moreRemain: boolean) => string;\n  readonly requiredFieldMarker: (fieldName: string) => string;\n  /** `{type}`: what an array's items are. */\n  readonly arrayItemsOf: ApiReferenceSentence;\n  readonly model: string;\n  readonly additionalProperties: string;\n  readonly allowed: string;\n  readonly notAllowed: string;\n  readonly childFieldsOf: (fieldName: string) => string;\n  readonly compositionOption: (position: number) => string;\n  /** A composition branch named by the value its discriminating property takes in it. */\n  readonly discriminatorValue: (field: string, value: string) => string;\n  readonly oneOf: string;\n  readonly anyOf: string;\n  readonly allOf: string;\n  readonly compositionShapes: (compositionLabel: string, shapeCount: number) => string;\n  readonly reusableDataModels: (count: number) => string;\n  readonly selectModelPrompt: string;\n  readonly schemaType: string;\n  readonly examples: (count: number) => string;\n  readonly externalExample: string;\n  readonly noInlineExample: string;\n\n  /** Where each of `itemCount` items goes, and what the reader's locale puts between them. */\n  readonly listLayout: (itemCount: number, kind: DocumentationListKind) => readonly DocumentationListPart[];\n}\n\n/** The prefix every API reference word's id carries in the site's `code.json`. */\nexport const API_REFERENCE_WORD_ID_PREFIX = 'docs.apiReference.';\n\n/**\n * Words that are only ever PART of another word — counts a sentence places — and so are not members of\n * {@link ApiReferenceWords}. Every other id is `docs.apiReference.<member>`.\n */\nexport enum ApiReferenceComponentWordId {\n  /** `{count} operation families`, placed in a resource card's line. */\n  OPERATION_FAMILY_COUNT = 'operationFamilyCount',\n  /** `{count} variants`, placed in a resource card's line. */\n  VARIANT_COUNT = 'variantCount',\n  /** The \"show more fields\" button when more fields follow the ones it names. */\n  SHOW_MORE_FIELDS_TRUNCATED = 'showMoreFieldsTruncated',\n}\n\n/** Every id the API reference reads from the site's `code.json`, without its prefix. */\nexport type ApiReferenceWordId = keyof ApiReferenceWords | ApiReferenceComponentWordId;\n\n/**\n * The API reference's words, looked up through the site's translator (#1992). Each member reads the\n * id `docs.apiReference.<member>`; a counted one is a `|`-separated plural message with `{count}`.\n */\nexport function createApiReferenceWords({ locale, translate, selectPlural }: DocumentationSiteTranslator): ApiReferenceWords {\n  const message = (id: ApiReferenceWordId): string => translate(`${API_REFERENCE_WORD_ID_PREFIX}${id}`);\n  const word = (id: ApiReferenceWordId, values: Readonly<Record<string, string>> = {}): string => fillMessage(message(id), values);\n  // The plural form is chosen on the message as written, then the values are placed.\n  const counted = (id: ApiReferenceWordId, count: number, values: Readonly<Record<string, string>> = {}): string =>\n    fillMessage(selectPlural(count, message(id)), { count: String(count), ...values });\n  const listOf = (items: readonly string[], kind: DocumentationListKind): string =>\n    documentationListLayout(locale, items.length, kind).map((part) => (isDocumentationListItem(part) ? items[part.item] : part.separator)).join('');\n  return {\n    openNavigation: word('openNavigation'),\n    closeNavigation: word('closeNavigation'),\n    apiNavigation: word('apiNavigation'),\n    apiSections: word('apiSections'),\n    filterResources: word('filterResources'),\n    resourcesNavigation: word('resourcesNavigation'),\n    overview: word('overview'),\n    otherResources: word('otherResources'),\n    noResourceMatches: (query) => word('noResourceMatches', { query }),\n    operationsSwitcher: (operationCount) => counted('operationsSwitcher', operationCount),\n    resourceOperations: (resourceLabel) => word('resourceOperations', { resource: resourceLabel }),\n    filterOperations: (operationCount) => counted('filterOperations', operationCount),\n    resourceCount: (count) => counted('resourceCount', count),\n    operationCount: (count) => counted('operationCount', count),\n    matchingResources: (count) => counted('matchingResources', count),\n    apiResources: word('apiResources'),\n    referenceSize: word('referenceSize'),\n    referenceSizeSummary: (operationCount, resourceCount) => word('referenceSizeSummary', {\n      operations: counted('operationCount', operationCount),\n      resources: counted('resourceCount', resourceCount),\n    }),\n    searchReference: word('searchReference'),\n    searchPlaceholder: word('searchPlaceholder'),\n    clearSearch: word('clearSearch'),\n    browseResources: (count) => counted('browseResources', count),\n    noSearchMatches: word('noSearchMatches'),\n    contractEyebrow: word('contractEyebrow'),\n    indexLead: word('indexLead'),\n    allResources: word('allResources'),\n    resourceNotInDocument: (resourceName) => word('resourceNotInDocument', { resource: resourceName }),\n    breadcrumb: word('breadcrumb'),\n    selectResourcePrompt: word('selectResourcePrompt'),\n    apiOverview: word('apiOverview'),\n    apiConventions: word('apiConventions'),\n    connectionDetails: word('connectionDetails'),\n    baseUrls: word('baseUrls'),\n    authenticationMechanisms: word('authenticationMechanisms'),\n    schemeType: word('schemeType'),\n    schemeScheme: word('schemeScheme'),\n    schemeFormat: word('schemeFormat'),\n    schemeLocation: word('schemeLocation'),\n    schemeName: word('schemeName'),\n    resourceCardMeta: (familyCount, variantCount) => word('resourceCardMeta', {\n      families: counted(ApiReferenceComponentWordId.OPERATION_FAMILY_COUNT, familyCount),\n      variants: counted(ApiReferenceComponentWordId.VARIANT_COUNT, variantCount),\n    }),\n    lifecycle: word('lifecycle'),\n    resourceObject: (resourceLabel) => word('resourceObject', { resource: resourceLabel }),\n    dataRelationships: (count) => counted('dataRelationships', count),\n    relationshipVia: message('relationshipVia'),\n    relationshipSummary: ({ nature, cardinality, relatedCardinality, lifecycleModel }) => word('relationshipSummary', { nature, cardinality, relatedCardinality, lifecycleModel }),\n    parentDeletePolicy: (policy) => word('parentDeletePolicy', { policy }),\n    parentDeleteDoesNotCascade: word('parentDeleteDoesNotCascade'),\n    parentDeleteCascade: ({ strategy, mode, maxDepth }) => word('parentDeleteCascade', { strategy, mode, maxDepth: String(maxDepth) }),\n    familyVariants: (familyLabel) => word('familyVariants', { family: familyLabel }),\n    copyPathOf: (operationSummary) => word('copyPathOf', { operation: operationSummary }),\n    access: word('access'),\n    requiredRole: word('requiredRole'),\n    requiredRoles: message('requiredRoles'),\n    roleWithKey: message('roleWithKey'),\n    authentication: word('authentication'),\n    idempotent: word('idempotent'),\n    yes: word('yes'),\n    no: word('no'),\n    roleAuthorityDetails: word('roleAuthorityDetails'),\n    boundary: word('boundary'),\n    alsoReachableAt: word('alsoReachableAt'),\n    aliasNote: message('aliasNote'),\n    aliasWithParameters: message('aliasWithParameters'),\n    requestBody: word('requestBody'),\n    required: word('required'),\n    optional: word('optional'),\n    responses: word('responses'),\n    noResponseContract: word('noResponseContract'),\n    errors: word('errors'),\n    copy: word('copy'),\n    copied: word('copied'),\n    samplesFor: (operationSummary) => word('samplesFor', { operation: operationSummary }),\n    requestSample: word('requestSample'),\n    request: word('request'),\n    language: word('language'),\n    copyRequestSample: word('copyRequestSample'),\n    server: word('server'),\n    responseExample: word('responseExample'),\n    response: word('response'),\n    responseStatus: word('responseStatus'),\n    copyResponseExample: word('copyResponseExample'),\n    noExampleForStatus: (requestedStatus, shownStatus) => word('noExampleForStatus', { requested: requestedStatus, shown: shownStatus }),\n    noResponseExample: word('noResponseExample'),\n    requestAndResponse: word('requestAndResponse'),\n    requestAndResponseFor: (operationSummary) => word('requestAndResponseFor', { operation: operationSummary }),\n    close: word('close'),\n    errorStatus: word('errorStatus'),\n    errorWhen: word('errorWhen'),\n    errorBranchOn: word('errorBranchOn'),\n    pathParameters: word('pathParameters'),\n    queryParameters: word('queryParameters'),\n    headerParameters: word('headerParameters'),\n    cookieParameters: word('cookieParameters'),\n    otherParameters: word('otherParameters'),\n    documentedResponses: word('documentedResponses'),\n    noStructuredRepresentation: word('noStructuredRepresentation'),\n    bodyFields: word('bodyFields'),\n    anyValue: word('anyValue'),\n    noValue: word('noValue'),\n    unnamedSchema: word('unnamedSchema'),\n    format: word('format'),\n    defaultValue: word('defaultValue'),\n    constantValue: word('constantValue'),\n    allowedValues: word('allowedValues'),\n    properties: word('properties'),\n    showMoreFields: (hiddenCount, fieldNames, moreRemain) => counted(\n      moreRemain ? ApiReferenceComponentWordId.SHOW_MORE_FIELDS_TRUNCATED : 'showMoreFields',\n      hiddenCount,\n      { fields: listOf(fieldNames, DocumentationListKind.CONJUNCTION) },\n    ),\n    requiredFieldMarker: (fieldName) => word('requiredFieldMarker', { field: fieldName }),\n    arrayItemsOf: message('arrayItemsOf'),\n    model: word('model'),\n    additionalProperties: word('additionalProperties'),\n    allowed: word('allowed'),\n    notAllowed: word('notAllowed'),\n    childFieldsOf: (fieldName) => word('childFieldsOf', { field: fieldName }),\n    compositionOption: (position) => word('compositionOption', { position: String(position) }),\n    discriminatorValue: (field, value) => word('discriminatorValue', { field, value }),\n    oneOf: word('oneOf'),\n    anyOf: word('anyOf'),\n    allOf: word('allOf'),\n    compositionShapes: (compositionLabel, shapeCount) => counted('compositionShapes', shapeCount, { composition: compositionLabel }),\n    reusableDataModels: (count) => counted('reusableDataModels', count),\n    selectModelPrompt: word('selectModelPrompt'),\n    schemaType: word('schemaType'),\n    examples: (count) => counted('examples', count),\n    externalExample: word('externalExample'),\n    noInlineExample: word('noInlineExample'),\n    listLayout: (itemCount, kind) => documentationListLayout(locale, itemCount, kind),\n  };\n}\n"]}

package/dist/esm/runtime/provider-component-registry.techdoc.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The documentation site's provider-component registry (#1703): the SAME registry the application and
+ * the website build, from the SAME `components` declaration, over the docs site's live provider
+ * modules.
+ *
+ * The techdoc facet type accepted `components` and nothing here read it. The registry is
+ * `createProviderComponentRegistry` from `@wildo-ai/external-connectors-public/techdoc` — keyed
+ * `capability:providerRef`, consent-gated, script-before-component and browser-only — and this file
+ * only feeds it the documentation site's inputs: the hydrated techdoc provider registry, and the loaders
+ * the site contributes for components an engine provider module declares but cannot import (passed to
+ * `DocsFrontendProviders` as `providerComponentLoaders`).
+ *
+ * Nothing is loaded here. Docusaurus prerenders every page at build time, and a component loads only
+ * when a `DocsProviderComponent` asks for it from an effect, which never runs during that prerender.
+ */
+import type { ComponentType } from 'react';
+import { type ProviderComponentDiagnostic, type ProviderComponentLoaderContribution, type ProviderComponentRegistry } from '@wildo-ai/external-connectors-public/techdoc';
+import type { FrontendTechdocProviderRegistry } from './frontend-provider-registry.techdoc';
+/** A component type the documentation site's registry hands back once loaded. */
+export type DocsProviderComponentType = ComponentType<never>;
+/** The documentation site's provider-component registry: the shared registry, holding React components. */
+export type DocsProviderComponentRegistry = ProviderComponentRegistry<DocsProviderComponentType>;
+export interface CreateDocsProviderComponentRegistryInput {
+    readonly providerRegistry: FrontendTechdocProviderRegistry | undefined;
+    readonly providerComponentLoaders?: Iterable<ProviderComponentLoaderContribution>;
+    /** Defaults to `console.warn`: the docs runtime has no logger, and a component that cannot be offered must not be silent. */
+    readonly onDiagnostic?: (diagnostic: ProviderComponentDiagnostic) => void;
+}
+/** Builds the documentation site's provider-component registry from its live provider modules. */
+export declare function createDocsProviderComponentRegistry(input: CreateDocsProviderComponentRegistryInput): DocsProviderComponentRegistry;
+//# sourceMappingURL=provider-component-registry.techdoc.d.ts.map

package/dist/esm/runtime/provider-component-registry.techdoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-component-registry.techdoc.d.ts","sourceRoot":"","sources":["../../../../src/runtime/provider-component-registry.techdoc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAIL,KAAK,2BAA2B,EAChC,KAAK,mCAAmC,EACxC,KAAK,yBAAyB,EAC/B,MAAM,8CAA8C,CAAC;AAEtD,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AAE5F,iFAAiF;AACjF,MAAM,MAAM,yBAAyB,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;AAE7D,2GAA2G;AAC3G,MAAM,MAAM,6BAA6B,GAAG,yBAAyB,CAAC,yBAAyB,CAAC,CAAC;AAEjG,MAAM,WAAW,wCAAwC;IACvD,QAAQ,CAAC,gBAAgB,EAAE,+BAA+B,GAAG,SAAS,CAAC;IACvE,QAAQ,CAAC,wBAAwB,CAAC,EAAE,QAAQ,CAAC,mCAAmC,CAAC,CAAC;IAClF,6HAA6H;IAC7H,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,2BAA2B,KAAK,IAAI,CAAC;CAC3E;AAWD,kGAAkG;AAClG,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,wCAAwC,GAC9C,6BAA6B,CAO/B"}

package/dist/esm/runtime/provider-component-registry.techdoc.js

@@ -0,0 +1,35 @@
+/**
+ * The documentation site's provider-component registry (#1703): the SAME registry the application and
+ * the website build, from the SAME `components` declaration, over the docs site's live provider
+ * modules.
+ *
+ * The techdoc facet type accepted `components` and nothing here read it. The registry is
+ * `createProviderComponentRegistry` from `@wildo-ai/external-connectors-public/techdoc` — keyed
+ * `capability:providerRef`, consent-gated, script-before-component and browser-only — and this file
+ * only feeds it the documentation site's inputs: the hydrated techdoc provider registry, and the loaders
+ * the site contributes for components an engine provider module declares but cannot import (passed to
+ * `DocsFrontendProviders` as `providerComponentLoaders`).
+ *
+ * Nothing is loaded here. Docusaurus prerenders every page at build time, and a component loads only
+ * when a `DocsProviderComponent` asks for it from an effect, which never runs during that prerender.
+ */
+import { collectProviderComponentRegistrations, createProviderComponentRegistry, indexProviderComponentLoaderContributions, } from '@wildo-ai/external-connectors-public/techdoc';
+function warnProviderComponentDiagnostic(diagnostic) {
+    // Reported in the BROWSER only. The registry is built during the server render or prerender too, once per
+    // page, and a declaration nothing can load would otherwise fill the build log with one warning per page
+    // for a fact the first page already stated. The browser is where somebody can see and act on it.
+    if (typeof document === 'undefined')
+        return;
+    // eslint-disable-next-line no-console
+    console.warn(`[wildo-provider-component] ${diagnostic.kind}: ${diagnostic.message}`);
+}
+/** Builds the documentation site's provider-component registry from its live provider modules. */
+export function createDocsProviderComponentRegistry(input) {
+    const onDiagnostic = input.onDiagnostic ?? warnProviderComponentDiagnostic;
+    const registrations = collectProviderComponentRegistrations(input.providerRegistry?.modules.values() ?? [], {
+        contributedLoaders: indexProviderComponentLoaderContributions(input.providerComponentLoaders),
+        onDiagnostic,
+    });
+    return createProviderComponentRegistry({ registrations, onDiagnostic });
+}
+//# sourceMappingURL=provider-component-registry.techdoc.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider-component-registry.techdoc.js","sourceRoot":"","sources":["../../../../src/runtime/provider-component-registry.techdoc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EACL,qCAAqC,EACrC,+BAA+B,EAC/B,yCAAyC,GAI1C,MAAM,8CAA8C,CAAC;AAiBtD,SAAS,+BAA+B,CAAC,UAAuC;IAC9E,0GAA0G;IAC1G,wGAAwG;IACxG,iGAAiG;IACjG,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO;IAC5C,sCAAsC;IACtC,OAAO,CAAC,IAAI,CAAC,8BAA8B,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;AACvF,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,mCAAmC,CACjD,KAA+C;IAE/C,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,IAAI,+BAA+B,CAAC;IAC3E,MAAM,aAAa,GAAG,qCAAqC,CAAC,KAAK,CAAC,gBAAgB,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;QAC1G,kBAAkB,EAAE,yCAAyC,CAAC,KAAK,CAAC,wBAAwB,CAAC;QAC7F,YAAY;KACb,CAAC,CAAC;IACH,OAAO,+BAA+B,CAA4B,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC;AACrG,CAAC","sourcesContent":["/**\n * The documentation site's provider-component registry (#1703): the SAME registry the application and\n * the website build, from the SAME `components` declaration, over the docs site's live provider\n * modules.\n *\n * The techdoc facet type accepted `components` and nothing here read it. The registry is\n * `createProviderComponentRegistry` from `@wildo-ai/external-connectors-public/techdoc` — keyed\n * `capability:providerRef`, consent-gated, script-before-component and browser-only — and this file\n * only feeds it the documentation site's inputs: the hydrated techdoc provider registry, and the loaders\n * the site contributes for components an engine provider module declares but cannot import (passed to\n * `DocsFrontendProviders` as `providerComponentLoaders`).\n *\n * Nothing is loaded here. Docusaurus prerenders every page at build time, and a component loads only\n * when a `DocsProviderComponent` asks for it from an effect, which never runs during that prerender.\n */\n\nimport type { ComponentType } from 'react';\nimport {\n  collectProviderComponentRegistrations,\n  createProviderComponentRegistry,\n  indexProviderComponentLoaderContributions,\n  type ProviderComponentDiagnostic,\n  type ProviderComponentLoaderContribution,\n  type ProviderComponentRegistry,\n} from '@wildo-ai/external-connectors-public/techdoc';\n\nimport type { FrontendTechdocProviderRegistry } from './frontend-provider-registry.techdoc';\n\n/** A component type the documentation site's registry hands back once loaded. */\nexport type DocsProviderComponentType = ComponentType<never>;\n\n/** The documentation site's provider-component registry: the shared registry, holding React components. */\nexport type DocsProviderComponentRegistry = ProviderComponentRegistry<DocsProviderComponentType>;\n\nexport interface CreateDocsProviderComponentRegistryInput {\n  readonly providerRegistry: FrontendTechdocProviderRegistry | undefined;\n  readonly providerComponentLoaders?: Iterable<ProviderComponentLoaderContribution>;\n  /** Defaults to `console.warn`: the docs runtime has no logger, and a component that cannot be offered must not be silent. */\n  readonly onDiagnostic?: (diagnostic: ProviderComponentDiagnostic) => void;\n}\n\nfunction warnProviderComponentDiagnostic(diagnostic: ProviderComponentDiagnostic): void {\n  // Reported in the BROWSER only. The registry is built during the server render or prerender too, once per\n  // page, and a declaration nothing can load would otherwise fill the build log with one warning per page\n  // for a fact the first page already stated. The browser is where somebody can see and act on it.\n  if (typeof document === 'undefined') return;\n  // eslint-disable-next-line no-console\n  console.warn(`[wildo-provider-component] ${diagnostic.kind}: ${diagnostic.message}`);\n}\n\n/** Builds the documentation site's provider-component registry from its live provider modules. */\nexport function createDocsProviderComponentRegistry(\n  input: CreateDocsProviderComponentRegistryInput,\n): DocsProviderComponentRegistry {\n  const onDiagnostic = input.onDiagnostic ?? warnProviderComponentDiagnostic;\n  const registrations = collectProviderComponentRegistrations(input.providerRegistry?.modules.values() ?? [], {\n    contributedLoaders: indexProviderComponentLoaderContributions(input.providerComponentLoaders),\n    onDiagnostic,\n  });\n  return createProviderComponentRegistry<DocsProviderComponentType>({ registrations, onDiagnostic });\n}\n"]}

package/dist/esm/runtime/use-docs-auth-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-docs-auth-session.d.ts","sourceRoot":"","sources":["../../../src/runtime/use-docs-auth-session.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,IAAI,oBAAoB,CASzD"}
+{"version":3,"file":"use-docs-auth-session.d.ts","sourceRoot":"","sources":["../../../../src/runtime/use-docs-auth-session.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,IAAI,oBAAoB,CASzD"}

package/dist/esm/runtime/use-docs-frontend-provider-registry.d.ts

@@ -1,3 +1,4 @@
 import type { FrontendTechdocProviderRegistry } from './frontend-provider-registry.techdoc';
+/** Works for standalone public docs and for existing auth-provider-only mounts. */
 export declare function useDocsFrontendProviderRegistry(): FrontendTechdocProviderRegistry;
 //# sourceMappingURL=use-docs-frontend-provider-registry.d.ts.map

package/dist/esm/runtime/use-docs-frontend-provider-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-docs-frontend-provider-registry.d.ts","sourceRoot":"","sources":["../../../src/runtime/use-docs-frontend-provider-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AAG5F,wBAAgB,+BAA+B,IAAI,+BAA+B,CAEjF"}
+{"version":3,"file":"use-docs-frontend-provider-registry.d.ts","sourceRoot":"","sources":["../../../../src/runtime/use-docs-frontend-provider-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AAI5F,mFAAmF;AACnF,wBAAgB,+BAA+B,IAAI,+BAA+B,CAMjF"}

package/dist/esm/runtime/use-docs-frontend-provider-registry.js

@@ -1,5 +1,13 @@
-import { useDocsAuthSession } from './use-docs-auth-session.js';
+import { useContext } from 'react';
+import { DocsFrontendProvidersContext } from './DocsFrontendProviders.js';
+import { DocsAuthContext } from './DocsAuthContext.js';
+/** Works for standalone public docs and for existing auth-provider-only mounts. */
 export function useDocsFrontendProviderRegistry() {
-    return useDocsAuthSession().frontendProviderRegistry;
+    const providers = useContext(DocsFrontendProvidersContext);
+    const auth = useContext(DocsAuthContext);
+    const registry = providers ?? auth?.frontendProviderRegistry;
+    if (registry === undefined)
+        throw new Error('useDocsFrontendProviderRegistry requires DocsFrontendProviders or DocsAuthProvider.');
+    return registry;
 }
 //# sourceMappingURL=use-docs-frontend-provider-registry.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-docs-frontend-provider-registry.js","sourceRoot":"","sources":["../../../../src/runtime/use-docs-frontend-provider-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,UAAU,+BAA+B;IAC7C,OAAO,kBAAkB,EAAE,CAAC,wBAAwB,CAAC;AACvD,CAAC","sourcesContent":["import type { FrontendTechdocProviderRegistry } from './frontend-provider-registry.techdoc';\nimport { useDocsAuthSession } from './use-docs-auth-session';\n\nexport function useDocsFrontendProviderRegistry(): FrontendTechdocProviderRegistry {\n  return useDocsAuthSession().frontendProviderRegistry;\n}\n"]}
+{"version":3,"file":"use-docs-frontend-provider-registry.js","sourceRoot":"","sources":["../../../../src/runtime/use-docs-frontend-provider-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEnC,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,mFAAmF;AACnF,MAAM,UAAU,+BAA+B;IAC7C,MAAM,SAAS,GAAG,UAAU,CAAC,4BAA4B,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,SAAS,IAAI,IAAI,EAAE,wBAAwB,CAAC;IAC7D,IAAI,QAAQ,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,qFAAqF,CAAC,CAAC;IACnI,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["import { useContext } from 'react';\nimport type { FrontendTechdocProviderRegistry } from './frontend-provider-registry.techdoc';\nimport { DocsFrontendProvidersContext } from './DocsFrontendProviders';\nimport { DocsAuthContext } from './DocsAuthContext';\n\n/** Works for standalone public docs and for existing auth-provider-only mounts. */\nexport function useDocsFrontendProviderRegistry(): FrontendTechdocProviderRegistry {\n  const providers = useContext(DocsFrontendProvidersContext);\n  const auth = useContext(DocsAuthContext);\n  const registry = providers ?? auth?.frontendProviderRegistry;\n  if (registry === undefined) throw new Error('useDocsFrontendProviderRegistry requires DocsFrontendProviders or DocsAuthProvider.');\n  return registry;\n}\n"]}