@webpieces/api-doc-model 0.0.1

package/src/model/ApiDocModel.d.ts

@@ -0,0 +1,202 @@
+import { TypeRef } from './TypeRef';
+/**
+ * The model classes. Every one of them is a CLASS with an explicit constructor per `CLAUDE.md` §1 —
+ * these are data-only structures, and a renderer (#982) builds nothing, it only reads.
+ *
+ * Nothing in this file imports anything but {@link TypeRef}: the package depends on `typescript` and
+ * NOTHING else, so it can be pointed at any upstream project's contract. One app-specific import
+ * here would end that, which is why `responsibilities.md` states the constraint rather than leaving
+ * it to be discovered.
+ */
+/** A type the extractor could not represent. RECORDED, never dropped — #982's guard needs a name. */
+export declare class UnmappedType {
+    /** The verbatim TypeScript type text, e.g. `Map<string, Widget>`. */
+    readonly typeText: string;
+    /** Pointer-style location: `path/to/File.ts:12:5`. */
+    readonly location: string;
+    /** Why it could not be mapped, in one sentence a renderer can print. */
+    readonly reason: string;
+    constructor(
+    /** The verbatim TypeScript type text, e.g. `Map<string, Widget>`. */
+    typeText: string, 
+    /** Pointer-style location: `path/to/File.ts:12:5`. */
+    location: string, 
+    /** Why it could not be mapped, in one sentence a renderer can print. */
+    reason: string);
+}
+/** The DERIVED discriminator of a union — never invented, only observed. See {@link DocumentedType}. */
+export declare class UnionDiscriminator {
+    /** The property every branch carries. */
+    readonly propertyName: string;
+    /** branch type name -> the single string literal that branch's property holds. */
+    readonly branchValues: ReadonlyMap<string, string>;
+    constructor(
+    /** The property every branch carries. */
+    propertyName: string, 
+    /** branch type name -> the single string literal that branch's property holds. */
+    branchValues: ReadonlyMap<string, string>);
+}
+/** One field of one DTO. */
+export declare class DocumentedField {
+    readonly name: string;
+    readonly type: TypeRef;
+    /**
+     * OPTIONAL (`name?: string`) — the property may be ABSENT. Distinguished from
+     * {@link nullable} on purpose: `{}` and `{name: null}` are different wire documents, and a
+     * renderer that conflates them emits a schema that rejects one of them.
+     */
+    readonly optional: boolean;
+    /** NULLABLE (`name: string | null`) — the property is present and may hold `null`. */
+    readonly nullable: boolean;
+    /** The JSDoc body, links flattened. Empty string when undocumented. */
+    readonly description: string;
+    /**
+     * The `@mcp` block tag — an OPTIONAL agent-facing override. Undefined means "no override",
+     * and a renderer falls back to {@link description}; the fallback is NOT applied here so a
+     * renderer can tell a deliberate agent-facing sentence from a reused human one.
+     */
+    readonly mcpDescription: string | undefined;
+    /** The `@format` tag, lifted onto the SCALAR (on an array, onto the ITEM). */
+    readonly format: string | undefined;
+    /** `@WpMin(n)` — numeric fields only; anything else is a build failure. */
+    readonly min: number | undefined;
+    /** `@WpMax(n)` — numeric fields only; anything else is a build failure. */
+    readonly max: number | undefined;
+    constructor(name: string, type: TypeRef, 
+    /**
+     * OPTIONAL (`name?: string`) — the property may be ABSENT. Distinguished from
+     * {@link nullable} on purpose: `{}` and `{name: null}` are different wire documents, and a
+     * renderer that conflates them emits a schema that rejects one of them.
+     */
+    optional: boolean, 
+    /** NULLABLE (`name: string | null`) — the property is present and may hold `null`. */
+    nullable: boolean, 
+    /** The JSDoc body, links flattened. Empty string when undocumented. */
+    description: string, 
+    /**
+     * The `@mcp` block tag — an OPTIONAL agent-facing override. Undefined means "no override",
+     * and a renderer falls back to {@link description}; the fallback is NOT applied here so a
+     * renderer can tell a deliberate agent-facing sentence from a reused human one.
+     */
+    mcpDescription: string | undefined, 
+    /** The `@format` tag, lifted onto the SCALAR (on an array, onto the ITEM). */
+    format: string | undefined, 
+    /** `@WpMin(n)` — numeric fields only; anything else is a build failure. */
+    min: number | undefined, 
+    /** `@WpMax(n)` — numeric fields only; anything else is a build failure. */
+    max: number | undefined);
+}
+/** One named type reachable from a contract: an object DTO, a string-literal enum, or a union. */
+export declare class DocumentedType {
+    readonly name: string;
+    readonly description: string;
+    /** Object shape. Empty for an enum or a union. */
+    readonly fields: readonly DocumentedField[];
+    /** Set for a string-literal union that has a name. */
+    readonly enumValues: readonly string[];
+    /** Set for a union of named object types. */
+    readonly unionRefNames: readonly string[];
+    /** Set only when EVERY branch carries the same property typed as one string literal. */
+    readonly discriminator: UnionDiscriminator | undefined;
+    /** An index signature (`[k: string]: X`) — the OPEN-MAP half of an object that also has fields. */
+    readonly indexSignatureValue: TypeRef | undefined;
+    constructor(name: string, description: string, 
+    /** Object shape. Empty for an enum or a union. */
+    fields: readonly DocumentedField[], 
+    /** Set for a string-literal union that has a name. */
+    enumValues: readonly string[], 
+    /** Set for a union of named object types. */
+    unionRefNames: readonly string[], 
+    /** Set only when EVERY branch carries the same property typed as one string literal. */
+    discriminator: UnionDiscriminator | undefined, 
+    /** An index signature (`[k: string]: X`) — the OPEN-MAP half of an object that also has fields. */
+    indexSignatureValue: TypeRef | undefined);
+}
+/** `@Endpoint(path, kind, options?)`'s third argument, as far as a document cares. */
+export declare class DocumentedEndpointOptions {
+    readonly formPost: boolean;
+    /** `calledBy` — REQUIRED by the decorator for `external`, absent otherwise. */
+    readonly calledBy: string | undefined;
+    readonly callerKind: string | undefined;
+    constructor(formPost: boolean, 
+    /** `calledBy` — REQUIRED by the decorator for `external`, absent otherwise. */
+    calledBy: string | undefined, callerKind: string | undefined);
+}
+/** The `@WpMcpTool(...)` declaration, when the method carries one. */
+export declare class DocumentedMcpTool {
+    readonly name: string;
+    /** The tool hints an agent reads — `readOnly`, `destructive`, `idempotent`, `openWorld`. */
+    readonly hints: ReadonlyMap<string, boolean>;
+    constructor(name: string, 
+    /** The tool hints an agent reads — `readOnly`, `destructive`, `idempotent`, `openWorld`. */
+    hints: ReadonlyMap<string, boolean>);
+}
+/** WHICH credential an endpoint demands — `@WpAuthPublic`, `@WpAuthJwt`, … — verbatim from the source. */
+export declare class DocumentedAuth {
+    /** The decorator name as written, e.g. `WpAuthJwt`. */
+    readonly decorator: string;
+    /** Its argument text, verbatim, when it took one. Undefined for `@WpAuthPublic()`. */
+    readonly argumentText: string | undefined;
+    constructor(
+    /** The decorator name as written, e.g. `WpAuthJwt`. */
+    decorator: string, 
+    /** Its argument text, verbatim, when it took one. Undefined for `@WpAuthPublic()`. */
+    argumentText: string | undefined);
+}
+/** One `@Endpoint` method of one contract. */
+export declare class DocumentedEndpoint {
+    readonly methodName: string;
+    /** The path, constant-folded. A const that cannot be folded is a HARD FAILURE, never a guess. */
+    readonly path: string;
+    /** `rpc` | `cloudtasks` | `cron` | `external`, verbatim — this package invents no taxonomy. */
+    readonly kind: string;
+    readonly hidden: boolean;
+    readonly options: DocumentedEndpointOptions;
+    readonly auth: DocumentedAuth | undefined;
+    readonly mcpTool: DocumentedMcpTool | undefined;
+    /** `@WpMcpAuthJwt(...)`'s argument text, when present. */
+    readonly mcpAuthText: string | undefined;
+    /** `@MaskLog({...})` — field name -> mask mode. */
+    readonly maskLog: ReadonlyMap<string, string>;
+    readonly description: string;
+    /** The `@mcp` override. See {@link DocumentedField.mcpDescription}. */
+    readonly mcpDescription: string | undefined;
+    readonly request: TypeRef | undefined;
+    readonly response: TypeRef | undefined;
+    constructor(methodName: string, 
+    /** The path, constant-folded. A const that cannot be folded is a HARD FAILURE, never a guess. */
+    path: string, 
+    /** `rpc` | `cloudtasks` | `cron` | `external`, verbatim — this package invents no taxonomy. */
+    kind: string, hidden: boolean, options: DocumentedEndpointOptions, auth: DocumentedAuth | undefined, mcpTool: DocumentedMcpTool | undefined, 
+    /** `@WpMcpAuthJwt(...)`'s argument text, when present. */
+    mcpAuthText: string | undefined, 
+    /** `@MaskLog({...})` — field name -> mask mode. */
+    maskLog: ReadonlyMap<string, string>, description: string, 
+    /** The `@mcp` override. See {@link DocumentedField.mcpDescription}. */
+    mcpDescription: string | undefined, request: TypeRef | undefined, response: TypeRef | undefined);
+}
+/** ONE extraction pass over ONE contract file. Both #982's renderers read exactly this. */
+export declare class ApiDocModel {
+    /** The contract class name, e.g. `SaveApi`. */
+    readonly contractName: string;
+    /** `@ApiPath(...)`, constant-folded. */
+    readonly basePath: string;
+    /** The JSDoc on the contract class, links flattened. */
+    readonly description: string;
+    readonly endpoints: readonly DocumentedEndpoint[];
+    /** Every named type reachable from the endpoints, by name. A `$ref` target for a renderer. */
+    readonly types: ReadonlyMap<string, DocumentedType>;
+    /** Everything that could not be represented — recorded, not dropped. */
+    readonly unmapped: readonly UnmappedType[];
+    constructor(
+    /** The contract class name, e.g. `SaveApi`. */
+    contractName: string, 
+    /** `@ApiPath(...)`, constant-folded. */
+    basePath: string, 
+    /** The JSDoc on the contract class, links flattened. */
+    description: string, endpoints: readonly DocumentedEndpoint[], 
+    /** Every named type reachable from the endpoints, by name. A `$ref` target for a renderer. */
+    types: ReadonlyMap<string, DocumentedType>, 
+    /** Everything that could not be represented — recorded, not dropped. */
+    unmapped: readonly UnmappedType[]);
+}

package/src/model/ApiDocModel.js

@@ -0,0 +1,231 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiDocModel = exports.DocumentedEndpoint = exports.DocumentedAuth = exports.DocumentedMcpTool = exports.DocumentedEndpointOptions = exports.DocumentedType = exports.DocumentedField = exports.UnionDiscriminator = exports.UnmappedType = void 0;
+/**
+ * The model classes. Every one of them is a CLASS with an explicit constructor per `CLAUDE.md` §1 —
+ * these are data-only structures, and a renderer (#982) builds nothing, it only reads.
+ *
+ * Nothing in this file imports anything but {@link TypeRef}: the package depends on `typescript` and
+ * NOTHING else, so it can be pointed at any upstream project's contract. One app-specific import
+ * here would end that, which is why `responsibilities.md` states the constraint rather than leaving
+ * it to be discovered.
+ */
+/** A type the extractor could not represent. RECORDED, never dropped — #982's guard needs a name. */
+class UnmappedType {
+    typeText;
+    location;
+    reason;
+    constructor(
+    /** The verbatim TypeScript type text, e.g. `Map<string, Widget>`. */
+    typeText, 
+    /** Pointer-style location: `path/to/File.ts:12:5`. */
+    location, 
+    /** Why it could not be mapped, in one sentence a renderer can print. */
+    reason) {
+        this.typeText = typeText;
+        this.location = location;
+        this.reason = reason;
+    }
+}
+exports.UnmappedType = UnmappedType;
+/** The DERIVED discriminator of a union — never invented, only observed. See {@link DocumentedType}. */
+class UnionDiscriminator {
+    propertyName;
+    branchValues;
+    constructor(
+    /** The property every branch carries. */
+    propertyName, 
+    /** branch type name -> the single string literal that branch's property holds. */
+    branchValues) {
+        this.propertyName = propertyName;
+        this.branchValues = branchValues;
+    }
+}
+exports.UnionDiscriminator = UnionDiscriminator;
+/** One field of one DTO. */
+class DocumentedField {
+    name;
+    type;
+    optional;
+    nullable;
+    description;
+    mcpDescription;
+    format;
+    min;
+    max;
+    constructor(name, type, 
+    /**
+     * OPTIONAL (`name?: string`) — the property may be ABSENT. Distinguished from
+     * {@link nullable} on purpose: `{}` and `{name: null}` are different wire documents, and a
+     * renderer that conflates them emits a schema that rejects one of them.
+     */
+    optional, 
+    /** NULLABLE (`name: string | null`) — the property is present and may hold `null`. */
+    nullable, 
+    /** The JSDoc body, links flattened. Empty string when undocumented. */
+    description, 
+    /**
+     * The `@mcp` block tag — an OPTIONAL agent-facing override. Undefined means "no override",
+     * and a renderer falls back to {@link description}; the fallback is NOT applied here so a
+     * renderer can tell a deliberate agent-facing sentence from a reused human one.
+     */
+    mcpDescription, 
+    /** The `@format` tag, lifted onto the SCALAR (on an array, onto the ITEM). */
+    format, 
+    /** `@WpMin(n)` — numeric fields only; anything else is a build failure. */
+    min, 
+    /** `@WpMax(n)` — numeric fields only; anything else is a build failure. */
+    max) {
+        this.name = name;
+        this.type = type;
+        this.optional = optional;
+        this.nullable = nullable;
+        this.description = description;
+        this.mcpDescription = mcpDescription;
+        this.format = format;
+        this.min = min;
+        this.max = max;
+    }
+}
+exports.DocumentedField = DocumentedField;
+/** One named type reachable from a contract: an object DTO, a string-literal enum, or a union. */
+class DocumentedType {
+    name;
+    description;
+    fields;
+    enumValues;
+    unionRefNames;
+    discriminator;
+    indexSignatureValue;
+    constructor(name, description, 
+    /** Object shape. Empty for an enum or a union. */
+    fields, 
+    /** Set for a string-literal union that has a name. */
+    enumValues, 
+    /** Set for a union of named object types. */
+    unionRefNames, 
+    /** Set only when EVERY branch carries the same property typed as one string literal. */
+    discriminator, 
+    /** An index signature (`[k: string]: X`) — the OPEN-MAP half of an object that also has fields. */
+    indexSignatureValue) {
+        this.name = name;
+        this.description = description;
+        this.fields = fields;
+        this.enumValues = enumValues;
+        this.unionRefNames = unionRefNames;
+        this.discriminator = discriminator;
+        this.indexSignatureValue = indexSignatureValue;
+    }
+}
+exports.DocumentedType = DocumentedType;
+/** `@Endpoint(path, kind, options?)`'s third argument, as far as a document cares. */
+class DocumentedEndpointOptions {
+    formPost;
+    calledBy;
+    callerKind;
+    constructor(formPost, 
+    /** `calledBy` — REQUIRED by the decorator for `external`, absent otherwise. */
+    calledBy, callerKind) {
+        this.formPost = formPost;
+        this.calledBy = calledBy;
+        this.callerKind = callerKind;
+    }
+}
+exports.DocumentedEndpointOptions = DocumentedEndpointOptions;
+/** The `@WpMcpTool(...)` declaration, when the method carries one. */
+class DocumentedMcpTool {
+    name;
+    hints;
+    constructor(name, 
+    /** The tool hints an agent reads — `readOnly`, `destructive`, `idempotent`, `openWorld`. */
+    hints) {
+        this.name = name;
+        this.hints = hints;
+    }
+}
+exports.DocumentedMcpTool = DocumentedMcpTool;
+/** WHICH credential an endpoint demands — `@WpAuthPublic`, `@WpAuthJwt`, … — verbatim from the source. */
+class DocumentedAuth {
+    decorator;
+    argumentText;
+    constructor(
+    /** The decorator name as written, e.g. `WpAuthJwt`. */
+    decorator, 
+    /** Its argument text, verbatim, when it took one. Undefined for `@WpAuthPublic()`. */
+    argumentText) {
+        this.decorator = decorator;
+        this.argumentText = argumentText;
+    }
+}
+exports.DocumentedAuth = DocumentedAuth;
+/** One `@Endpoint` method of one contract. */
+class DocumentedEndpoint {
+    methodName;
+    path;
+    kind;
+    hidden;
+    options;
+    auth;
+    mcpTool;
+    mcpAuthText;
+    maskLog;
+    description;
+    mcpDescription;
+    request;
+    response;
+    constructor(methodName, 
+    /** The path, constant-folded. A const that cannot be folded is a HARD FAILURE, never a guess. */
+    path, 
+    /** `rpc` | `cloudtasks` | `cron` | `external`, verbatim — this package invents no taxonomy. */
+    kind, hidden, options, auth, mcpTool, 
+    /** `@WpMcpAuthJwt(...)`'s argument text, when present. */
+    mcpAuthText, 
+    /** `@MaskLog({...})` — field name -> mask mode. */
+    maskLog, description, 
+    /** The `@mcp` override. See {@link DocumentedField.mcpDescription}. */
+    mcpDescription, request, response) {
+        this.methodName = methodName;
+        this.path = path;
+        this.kind = kind;
+        this.hidden = hidden;
+        this.options = options;
+        this.auth = auth;
+        this.mcpTool = mcpTool;
+        this.mcpAuthText = mcpAuthText;
+        this.maskLog = maskLog;
+        this.description = description;
+        this.mcpDescription = mcpDescription;
+        this.request = request;
+        this.response = response;
+    }
+}
+exports.DocumentedEndpoint = DocumentedEndpoint;
+/** ONE extraction pass over ONE contract file. Both #982's renderers read exactly this. */
+class ApiDocModel {
+    contractName;
+    basePath;
+    description;
+    endpoints;
+    types;
+    unmapped;
+    constructor(
+    /** The contract class name, e.g. `SaveApi`. */
+    contractName, 
+    /** `@ApiPath(...)`, constant-folded. */
+    basePath, 
+    /** The JSDoc on the contract class, links flattened. */
+    description, endpoints, 
+    /** Every named type reachable from the endpoints, by name. A `$ref` target for a renderer. */
+    types, 
+    /** Everything that could not be represented — recorded, not dropped. */
+    unmapped) {
+        this.contractName = contractName;
+        this.basePath = basePath;
+        this.description = description;
+        this.endpoints = endpoints;
+        this.types = types;
+        this.unmapped = unmapped;
+    }
+}
+exports.ApiDocModel = ApiDocModel;
+//# sourceMappingURL=ApiDocModel.js.map

package/src/model/ApiDocModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiDocModel.js","sourceRoot":"","sources":["../../../../../../packages/docs/api-doc-model/src/model/ApiDocModel.ts"],"names":[],"mappings":"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","sourcesContent":["import { TypeRef } from './TypeRef';\n\n/**\n * The model classes. Every one of them is a CLASS with an explicit constructor per `CLAUDE.md` §1 —\n * these are data-only structures, and a renderer (#982) builds nothing, it only reads.\n *\n * Nothing in this file imports anything but {@link TypeRef}: the package depends on `typescript` and\n * NOTHING else, so it can be pointed at any upstream project's contract. One app-specific import\n * here would end that, which is why `responsibilities.md` states the constraint rather than leaving\n * it to be discovered.\n */\n\n/** A type the extractor could not represent. RECORDED, never dropped — #982's guard needs a name. */\nexport class UnmappedType {\n    constructor(\n        /** The verbatim TypeScript type text, e.g. `Map<string, Widget>`. */\n        readonly typeText: string,\n        /** Pointer-style location: `path/to/File.ts:12:5`. */\n        readonly location: string,\n        /** Why it could not be mapped, in one sentence a renderer can print. */\n        readonly reason: string,\n    ) {}\n}\n\n/** The DERIVED discriminator of a union — never invented, only observed. See {@link DocumentedType}. */\nexport class UnionDiscriminator {\n    constructor(\n        /** The property every branch carries. */\n        readonly propertyName: string,\n        /** branch type name -> the single string literal that branch's property holds. */\n        readonly branchValues: ReadonlyMap<string, string>,\n    ) {}\n}\n\n/** One field of one DTO. */\nexport class DocumentedField {\n    constructor(\n        readonly name: string,\n        readonly type: TypeRef,\n        /**\n         * OPTIONAL (`name?: string`) — the property may be ABSENT. Distinguished from\n         * {@link nullable} on purpose: `{}` and `{name: null}` are different wire documents, and a\n         * renderer that conflates them emits a schema that rejects one of them.\n         */\n        readonly optional: boolean,\n        /** NULLABLE (`name: string | null`) — the property is present and may hold `null`. */\n        readonly nullable: boolean,\n        /** The JSDoc body, links flattened. Empty string when undocumented. */\n        readonly description: string,\n        /**\n         * The `@mcp` block tag — an OPTIONAL agent-facing override. Undefined means \"no override\",\n         * and a renderer falls back to {@link description}; the fallback is NOT applied here so a\n         * renderer can tell a deliberate agent-facing sentence from a reused human one.\n         */\n        readonly mcpDescription: string | undefined,\n        /** The `@format` tag, lifted onto the SCALAR (on an array, onto the ITEM). */\n        readonly format: string | undefined,\n        /** `@WpMin(n)` — numeric fields only; anything else is a build failure. */\n        readonly min: number | undefined,\n        /** `@WpMax(n)` — numeric fields only; anything else is a build failure. */\n        readonly max: number | undefined,\n    ) {}\n}\n\n/** One named type reachable from a contract: an object DTO, a string-literal enum, or a union. */\nexport class DocumentedType {\n    constructor(\n        readonly name: string,\n        readonly description: string,\n        /** Object shape. Empty for an enum or a union. */\n        readonly fields: readonly DocumentedField[],\n        /** Set for a string-literal union that has a name. */\n        readonly enumValues: readonly string[],\n        /** Set for a union of named object types. */\n        readonly unionRefNames: readonly string[],\n        /** Set only when EVERY branch carries the same property typed as one string literal. */\n        readonly discriminator: UnionDiscriminator | undefined,\n        /** An index signature (`[k: string]: X`) — the OPEN-MAP half of an object that also has fields. */\n        readonly indexSignatureValue: TypeRef | undefined,\n    ) {}\n}\n\n/** `@Endpoint(path, kind, options?)`'s third argument, as far as a document cares. */\nexport class DocumentedEndpointOptions {\n    constructor(\n        readonly formPost: boolean,\n        /** `calledBy` — REQUIRED by the decorator for `external`, absent otherwise. */\n        readonly calledBy: string | undefined,\n        readonly callerKind: string | undefined,\n    ) {}\n}\n\n/** The `@WpMcpTool(...)` declaration, when the method carries one. */\nexport class DocumentedMcpTool {\n    constructor(\n        readonly name: string,\n        /** The tool hints an agent reads — `readOnly`, `destructive`, `idempotent`, `openWorld`. */\n        readonly hints: ReadonlyMap<string, boolean>,\n    ) {}\n}\n\n/** WHICH credential an endpoint demands — `@WpAuthPublic`, `@WpAuthJwt`, … — verbatim from the source. */\nexport class DocumentedAuth {\n    constructor(\n        /** The decorator name as written, e.g. `WpAuthJwt`. */\n        readonly decorator: string,\n        /** Its argument text, verbatim, when it took one. Undefined for `@WpAuthPublic()`. */\n        readonly argumentText: string | undefined,\n    ) {}\n}\n\n/** One `@Endpoint` method of one contract. */\nexport class DocumentedEndpoint {\n    constructor(\n        readonly methodName: string,\n        /** The path, constant-folded. A const that cannot be folded is a HARD FAILURE, never a guess. */\n        readonly path: string,\n        /** `rpc` | `cloudtasks` | `cron` | `external`, verbatim — this package invents no taxonomy. */\n        readonly kind: string,\n        readonly hidden: boolean,\n        readonly options: DocumentedEndpointOptions,\n        readonly auth: DocumentedAuth | undefined,\n        readonly mcpTool: DocumentedMcpTool | undefined,\n        /** `@WpMcpAuthJwt(...)`'s argument text, when present. */\n        readonly mcpAuthText: string | undefined,\n        /** `@MaskLog({...})` — field name -> mask mode. */\n        readonly maskLog: ReadonlyMap<string, string>,\n        readonly description: string,\n        /** The `@mcp` override. See {@link DocumentedField.mcpDescription}. */\n        readonly mcpDescription: string | undefined,\n        readonly request: TypeRef | undefined,\n        readonly response: TypeRef | undefined,\n    ) {}\n}\n\n/** ONE extraction pass over ONE contract file. Both #982's renderers read exactly this. */\nexport class ApiDocModel {\n    constructor(\n        /** The contract class name, e.g. `SaveApi`. */\n        readonly contractName: string,\n        /** `@ApiPath(...)`, constant-folded. */\n        readonly basePath: string,\n        /** The JSDoc on the contract class, links flattened. */\n        readonly description: string,\n        readonly endpoints: readonly DocumentedEndpoint[],\n        /** Every named type reachable from the endpoints, by name. A `$ref` target for a renderer. */\n        readonly types: ReadonlyMap<string, DocumentedType>,\n        /** Everything that could not be represented — recorded, not dropped. */\n        readonly unmapped: readonly UnmappedType[],\n    ) {}\n}\n"]}

package/src/model/TypeRef.d.ts

@@ -0,0 +1,48 @@
+/**
+ * How a single declared type was RESOLVED. This is the leaf of the model: every field, every request
+ * and every response points at one of these.
+ *
+ * It is a CLASS with static factories rather than a discriminated union of interfaces, per
+ * `CLAUDE.md` §1 — it is data, it is constructed explicitly, and a renderer pattern-matches on
+ * `kind`. The factories exist because the combinations are not free-form: an `array` always has
+ * `items`, an `openMap` always has `values`, a `ref` always has `refName`, and a constructor taking
+ * eight optional fields would let a caller build a shape no resolver can produce.
+ */
+export type TypeRefKind = 'primitive' | 'ref' | 'array' | 'openMap' | 'enum' | 'union' | 'unmapped';
+/** The scalar kinds a renderer can emit without any further lookup. */
+export type PrimitiveKind = 'string' | 'number' | 'boolean' | 'null' | 'unknown';
+export declare class TypeRef {
+    readonly kind: TypeRefKind;
+    /** Set when `kind === 'primitive'`. */
+    readonly primitive: PrimitiveKind | undefined;
+    /** Set when `kind === 'ref'` — the name of a {@link DocumentedType} in the model. */
+    readonly refName: string | undefined;
+    /** Set when `kind === 'array'` — the ITEM type. */
+    readonly items: TypeRef | undefined;
+    /** Set when `kind === 'openMap'` — the VALUE type of an index signature. */
+    readonly values: TypeRef | undefined;
+    /** Set when `kind === 'enum'` — the string-literal members, in declaration order. */
+    readonly enumValues: readonly string[];
+    /** Set when `kind === 'union'` — the branch type names, in declaration order. */
+    readonly unionRefNames: readonly string[];
+    /**
+     * INTEGER-ness, which TypeScript itself cannot express: it has one numeric type. Declared by
+     * writing `Integer` (preferred — it composes: `Integer[]`, `Record<string, Integer>`) or by
+     * putting `@WpInt()` on the field. Both produce this same flag; see `responsibilities.md`.
+     */
+    readonly integer: boolean;
+    /** Set when `kind === 'unmapped'` — the verbatim TS type text, for a renderer's guard. */
+    readonly unmappedText: string | undefined;
+    private constructor();
+    static primitiveOf(primitive: PrimitiveKind, integer?: boolean): TypeRef;
+    static ref(refName: string): TypeRef;
+    static array(items: TypeRef): TypeRef;
+    static openMap(values: TypeRef): TypeRef;
+    static enumOf(enumValues: readonly string[]): TypeRef;
+    static union(unionRefNames: readonly string[]): TypeRef;
+    static unmapped(unmappedText: string): TypeRef;
+    /** The same ref, marked integer. Used by `@WpInt()`, which decorates the FIELD, not the type. */
+    asInteger(): TypeRef;
+    /** True for a numeric leaf — what `@WpMin` / `@WpMax` are allowed to constrain. */
+    isNumeric(): boolean;
+}

package/src/model/TypeRef.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeRef = void 0;
+class TypeRef {
+    kind;
+    primitive;
+    refName;
+    items;
+    values;
+    enumValues;
+    unionRefNames;
+    integer;
+    unmappedText;
+    constructor(kind, 
+    /** Set when `kind === 'primitive'`. */
+    primitive, 
+    /** Set when `kind === 'ref'` — the name of a {@link DocumentedType} in the model. */
+    refName, 
+    /** Set when `kind === 'array'` — the ITEM type. */
+    items, 
+    /** Set when `kind === 'openMap'` — the VALUE type of an index signature. */
+    values, 
+    /** Set when `kind === 'enum'` — the string-literal members, in declaration order. */
+    enumValues, 
+    /** Set when `kind === 'union'` — the branch type names, in declaration order. */
+    unionRefNames, 
+    /**
+     * INTEGER-ness, which TypeScript itself cannot express: it has one numeric type. Declared by
+     * writing `Integer` (preferred — it composes: `Integer[]`, `Record<string, Integer>`) or by
+     * putting `@WpInt()` on the field. Both produce this same flag; see `responsibilities.md`.
+     */
+    integer, 
+    /** Set when `kind === 'unmapped'` — the verbatim TS type text, for a renderer's guard. */
+    unmappedText) {
+        this.kind = kind;
+        this.primitive = primitive;
+        this.refName = refName;
+        this.items = items;
+        this.values = values;
+        this.enumValues = enumValues;
+        this.unionRefNames = unionRefNames;
+        this.integer = integer;
+        this.unmappedText = unmappedText;
+    }
+    // webpieces-disable no-function-outside-class -- static factories on the class itself; the private constructor is what stops an impossible combination being built
+    static primitiveOf(primitive, integer = false) {
+        return new TypeRef('primitive', primitive, undefined, undefined, undefined, [], [], integer, undefined);
+    }
+    // webpieces-disable no-function-outside-class -- static factory; the private constructor is what stops an impossible combination being built
+    static ref(refName) {
+        return new TypeRef('ref', undefined, refName, undefined, undefined, [], [], false, undefined);
+    }
+    // webpieces-disable no-function-outside-class -- static factory; the private constructor is what stops an impossible combination being built
+    static array(items) {
+        return new TypeRef('array', undefined, undefined, items, undefined, [], [], false, undefined);
+    }
+    // webpieces-disable no-function-outside-class -- static factory; the private constructor is what stops an impossible combination being built
+    static openMap(values) {
+        return new TypeRef('openMap', undefined, undefined, undefined, values, [], [], false, undefined);
+    }
+    // webpieces-disable no-function-outside-class -- static factory; the private constructor is what stops an impossible combination being built
+    static enumOf(enumValues) {
+        return new TypeRef('enum', undefined, undefined, undefined, undefined, enumValues, [], false, undefined);
+    }
+    // webpieces-disable no-function-outside-class -- static factory; the private constructor is what stops an impossible combination being built
+    static union(unionRefNames) {
+        return new TypeRef('union', undefined, undefined, undefined, undefined, [], unionRefNames, false, undefined);
+    }
+    // webpieces-disable no-function-outside-class -- static factory; the private constructor is what stops an impossible combination being built
+    static unmapped(unmappedText) {
+        return new TypeRef('unmapped', undefined, undefined, undefined, undefined, [], [], false, unmappedText);
+    }
+    /** The same ref, marked integer. Used by `@WpInt()`, which decorates the FIELD, not the type. */
+    asInteger() {
+        return new TypeRef(this.kind, this.primitive, this.refName, this.items, this.values, this.enumValues, this.unionRefNames, true, this.unmappedText);
+    }
+    /** True for a numeric leaf — what `@WpMin` / `@WpMax` are allowed to constrain. */
+    isNumeric() {
+        return this.kind === 'primitive' && this.primitive === 'number';
+    }
+}
+exports.TypeRef = TypeRef;
+//# sourceMappingURL=TypeRef.js.map

package/src/model/TypeRef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeRef.js","sourceRoot":"","sources":["../../../../../../packages/docs/api-doc-model/src/model/TypeRef.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * How a single declared type was RESOLVED. This is the leaf of the model: every field, every request\n * and every response points at one of these.\n *\n * It is a CLASS with static factories rather than a discriminated union of interfaces, per\n * `CLAUDE.md` §1 — it is data, it is constructed explicitly, and a renderer pattern-matches on\n * `kind`. The factories exist because the combinations are not free-form: an `array` always has\n * `items`, an `openMap` always has `values`, a `ref` always has `refName`, and a constructor taking\n * eight optional fields would let a caller build a shape no resolver can produce.\n */\nexport type TypeRefKind = 'primitive' | 'ref' | 'array' | 'openMap' | 'enum' | 'union' | 'unmapped';\n\n/** The scalar kinds a renderer can emit without any further lookup. */\nexport type PrimitiveKind = 'string' | 'number' | 'boolean' | 'null' | 'unknown';\n\nexport class TypeRef {\n    private constructor(\n        readonly kind: TypeRefKind,\n        /** Set when `kind === 'primitive'`. */\n        readonly primitive: PrimitiveKind | undefined,\n        /** Set when `kind === 'ref'` — the name of a {@link DocumentedType} in the model. */\n        readonly refName: string | undefined,\n        /** Set when `kind === 'array'` — the ITEM type. */\n        readonly items: TypeRef | undefined,\n        /** Set when `kind === 'openMap'` — the VALUE type of an index signature. */\n        readonly values: TypeRef | undefined,\n        /** Set when `kind === 'enum'` — the string-literal members, in declaration order. */\n        readonly enumValues: readonly string[],\n        /** Set when `kind === 'union'` — the branch type names, in declaration order. */\n        readonly unionRefNames: readonly string[],\n        /**\n         * INTEGER-ness, which TypeScript itself cannot express: it has one numeric type. Declared by\n         * writing `Integer` (preferred — it composes: `Integer[]`, `Record<string, Integer>`) or by\n         * putting `@WpInt()` on the field. Both produce this same flag; see `responsibilities.md`.\n         */\n        readonly integer: boolean,\n        /** Set when `kind === 'unmapped'` — the verbatim TS type text, for a renderer's guard. */\n        readonly unmappedText: string | undefined,\n    ) {}\n\n    // webpieces-disable no-function-outside-class -- static factories on the class itself; the private constructor is what stops an impossible combination being built\n    static primitiveOf(primitive: PrimitiveKind, integer = false): TypeRef {\n        return new TypeRef(\n            'primitive',\n            primitive,\n            undefined,\n            undefined,\n            undefined,\n            [],\n            [],\n            integer,\n            undefined,\n        );\n    }\n\n    // webpieces-disable no-function-outside-class -- static factory; the private constructor is what stops an impossible combination being built\n    static ref(refName: string): TypeRef {\n        return new TypeRef(\n            'ref',\n            undefined,\n            refName,\n            undefined,\n            undefined,\n            [],\n            [],\n            false,\n            undefined,\n        );\n    }\n\n    // webpieces-disable no-function-outside-class -- static factory; the private constructor is what stops an impossible combination being built\n    static array(items: TypeRef): TypeRef {\n        return new TypeRef(\n            'array',\n            undefined,\n            undefined,\n            items,\n            undefined,\n            [],\n            [],\n            false,\n            undefined,\n        );\n    }\n\n    // webpieces-disable no-function-outside-class -- static factory; the private constructor is what stops an impossible combination being built\n    static openMap(values: TypeRef): TypeRef {\n        return new TypeRef(\n            'openMap',\n            undefined,\n            undefined,\n            undefined,\n            values,\n            [],\n            [],\n            false,\n            undefined,\n        );\n    }\n\n    // webpieces-disable no-function-outside-class -- static factory; the private constructor is what stops an impossible combination being built\n    static enumOf(enumValues: readonly string[]): TypeRef {\n        return new TypeRef(\n            'enum',\n            undefined,\n            undefined,\n            undefined,\n            undefined,\n            enumValues,\n            [],\n            false,\n            undefined,\n        );\n    }\n\n    // webpieces-disable no-function-outside-class -- static factory; the private constructor is what stops an impossible combination being built\n    static union(unionRefNames: readonly string[]): TypeRef {\n        return new TypeRef(\n            'union',\n            undefined,\n            undefined,\n            undefined,\n            undefined,\n            [],\n            unionRefNames,\n            false,\n            undefined,\n        );\n    }\n\n    // webpieces-disable no-function-outside-class -- static factory; the private constructor is what stops an impossible combination being built\n    static unmapped(unmappedText: string): TypeRef {\n        return new TypeRef(\n            'unmapped',\n            undefined,\n            undefined,\n            undefined,\n            undefined,\n            [],\n            [],\n            false,\n            unmappedText,\n        );\n    }\n\n    /** The same ref, marked integer. Used by `@WpInt()`, which decorates the FIELD, not the type. */\n    asInteger(): TypeRef {\n        return new TypeRef(\n            this.kind,\n            this.primitive,\n            this.refName,\n            this.items,\n            this.values,\n            this.enumValues,\n            this.unionRefNames,\n            true,\n            this.unmappedText,\n        );\n    }\n\n    /** True for a numeric leaf — what `@WpMin` / `@WpMax` are allowed to constrain. */\n    isNumeric(): boolean {\n        return this.kind === 'primitive' && this.primitive === 'number';\n    }\n}\n"]}