openapi-typesafe 0.0.0 → 1.0.0-rc.0

package/dist/api/transform-context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-context.mjs","sources":["../../src/api/transform-context.ts"],"sourcesContent":["import * as changeCase from \"change-case\";\nimport { RunFooter } from \"../application/transform/footer/document-footer.js\";\nimport type { SchemaLocation } from \"../application/transform/schema/schema-context.js\";\nimport type {\n  DocumentFooter,\n  NameCasing,\n  TransformContext,\n  TransformDiagnostics,\n  TransformOptions,\n} from \"../application/transform/transform-context.js\";\nimport type { GlobalContext, TransformNodeOptions } from \"../types.js\";\nimport { defaultLogger, monotonicNow } from \"./default-ports.js\";\nimport { ContextFooterSink } from \"./footer-sink.js\";\nimport { schemaCallbacks } from \"./schema-callbacks.js\";\n\n/**\n * Builds the ported transformers' context from the original `GlobalContext`: options, refs,\n * discriminators, the run footer and the user callbacks (see `schema-callbacks.ts`).\n */\n\nfunction transformOptions(ctx: GlobalContext): TransformOptions {\n  return {\n    additionalProperties: ctx.additionalProperties,\n    alphabetize: ctx.alphabetize,\n    arrayLength: ctx.arrayLength,\n    binaryAsBlob: ctx.binaryAsBlob,\n    conditionalEnums: ctx.conditionalEnums,\n    dedupeEnums: ctx.dedupeEnums,\n    defaultNonNullable: ctx.defaultNonNullable,\n    emptyObjectsUnknown: ctx.emptyObjectsUnknown,\n    enum: ctx.enum,\n    enumValues: ctx.enumValues,\n    excludeDeprecated: ctx.excludeDeprecated,\n    fixes: new Set(ctx.fix ?? []),\n    immutable: ctx.immutable,\n    propertiesRequiredByDefault: ctx.propertiesRequiredByDefault,\n    readWriteMarkers: ctx.readWriteMarkers,\n    generatePathParams: ctx.generatePathParams,\n    pathParamsAsTypes: ctx.pathParamsAsTypes,\n    rootTypes: ctx.rootTypes,\n    rootTypesNoSchemaPrefix: ctx.rootTypesNoSchemaPrefix,\n    rootTypesKeepCasing: ctx.rootTypesKeepCasing,\n    exportType: ctx.exportType,\n    inject: ctx.inject,\n    makePathsEnum: ctx.makePathsEnum,\n  };\n}\n\n/** One footer per run: it holds the enum registry, so it lives on the run's context. */\nfunction runFooter(ctx: GlobalContext): DocumentFooter {\n  ctx.runFooter ??= new RunFooter(new ContextFooterSink(ctx.injectFooter), ctx.dedupeEnums);\n  return ctx.runFooter;\n}\n\nconst CASING: NameCasing = { pascalCase: (text) => changeCase.pascalCase(text) };\n\n/**\n * A monotonic clock and the run's logger (the default one for a user's own context), \"ts\" group.\n */\nfunction diagnostics(ctx: GlobalContext): TransformDiagnostics {\n  const logger = ctx.logger ?? defaultLogger(ctx.silent);\n  return {\n    now: monotonicNow,\n    debug: (message, durationMs) => logger.debug(message, \"ts\", durationMs),\n  };\n}\n\n/** The ported transformers' context for one call from a legacy transformer. */\nexport function createTransformContext(ctx: GlobalContext): TransformContext {\n  return {\n    options: transformOptions(ctx),\n    refs: { resolve: (ref) => ctx.resolve(ref) },\n    discriminators: {\n      objectAt: (ref) => ctx.discriminators.objects[ref],\n      isHandled: (ref) => ctx.discriminators.refsHandled.includes(ref),\n    },\n    footer: runFooter(ctx),\n    callbacks: schemaCallbacks(ctx),\n    diagnostics: diagnostics(ctx),\n    casing: CASING,\n  };\n}\n\n/** The transformer's location for the original options object. */\nexport function schemaLocation(options: TransformNodeOptions): SchemaLocation {\n  return { path: options.path, schema: options.schema };\n}\n"],"names":[],"mappings":";;;;;;AAoBA,SAAS,iBAAiB,GAAA,EAAsC;AAC9D,EAAA,OAAO;AAAA,IACL,sBAAsB,GAAA,CAAI,oBAAA;AAAA,IAC1B,aAAa,GAAA,CAAI,WAAA;AAAA,IACjB,aAAa,GAAA,CAAI,WAAA;AAAA,IACjB,cAAc,GAAA,CAAI,YAAA;AAAA,IAClB,kBAAkB,GAAA,CAAI,gBAAA;AAAA,IACtB,aAAa,GAAA,CAAI,WAAA;AAAA,IACjB,oBAAoB,GAAA,CAAI,kBAAA;AAAA,IACxB,qBAAqB,GAAA,CAAI,mBAAA;AAAA,IACzB,MAAM,GAAA,CAAI,IAAA;AAAA,IACV,YAAY,GAAA,CAAI,UAAA;AAAA,IAChB,mBAAmB,GAAA,CAAI,iBAAA;AAAA,IACvB,OAAO,IAAI,GAAA,CAAI,GAAA,CAAI,GAAA,IAAO,EAAE,CAAA;AAAA,IAC5B,WAAW,GAAA,CAAI,SAAA;AAAA,IACf,6BAA6B,GAAA,CAAI,2BAAA;AAAA,IACjC,kBAAkB,GAAA,CAAI,gBAAA;AAAA,IACtB,oBAAoB,GAAA,CAAI,kBAAA;AAAA,IACxB,mBAAmB,GAAA,CAAI,iBAAA;AAAA,IACvB,WAAW,GAAA,CAAI,SAAA;AAAA,IACf,yBAAyB,GAAA,CAAI,uBAAA;AAAA,IAC7B,qBAAqB,GAAA,CAAI,mBAAA;AAAA,IACzB,YAAY,GAAA,CAAI,UAAA;AAAA,IAChB,QAAQ,GAAA,CAAI,MAAA;AAAA,IACZ,eAAe,GAAA,CAAI;AAAA,GACrB;AACF;AAGA,SAAS,UAAU,GAAA,EAAoC;AACrD,EAAA,GAAA,CAAI,SAAA,KAAc,IAAI,SAAA,CAAU,IAAI,kBAAkB,GAAA,CAAI,YAAY,CAAA,EAAG,GAAA,CAAI,WAAW,CAAA;AACxF,EAAA,OAAO,GAAA,CAAI,SAAA;AACb;AAEA,MAAM,MAAA,GAAqB,EAAE,UAAA,EAAY,CAAC,SAAS,UAAA,CAAW,UAAA,CAAW,IAAI,CAAA,EAAE;AAK/E,SAAS,YAAY,GAAA,EAA0C;AAC7D,EAAA,MAAM,MAAA,GAAS,GAAA,CAAI,MAAA,IAAU,aAAA,CAAc,IAAI,MAAM,CAAA;AACrD,EAAA,OAAO;AAAA,IACL,GAAA,EAAK,YAAA;AAAA,IACL,KAAA,EAAO,CAAC,OAAA,EAAS,UAAA,KAAe,OAAO,KAAA,CAAM,OAAA,EAAS,MAAM,UAAU;AAAA,GACxE;AACF;AAGO,SAAS,uBAAuB,GAAA,EAAsC;AAC3E,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,iBAAiB,GAAG,CAAA;AAAA,IAC7B,IAAA,EAAM,EAAE,OAAA,EAAS,CAAC,QAAQ,GAAA,CAAI,OAAA,CAAQ,GAAG,CAAA,EAAE;AAAA,IAC3C,cAAA,EAAgB;AAAA,MACd,UAAU,CAAC,GAAA,KAAQ,GAAA,CAAI,cAAA,CAAe,QAAQ,GAAG,CAAA;AAAA,MACjD,WAAW,CAAC,GAAA,KAAQ,IAAI,cAAA,CAAe,WAAA,CAAY,SAAS,GAAG;AAAA,KACjE;AAAA,IACA,MAAA,EAAQ,UAAU,GAAG,CAAA;AAAA,IACrB,SAAA,EAAW,gBAAgB,GAAG,CAAA;AAAA,IAC9B,WAAA,EAAa,YAAY,GAAG,CAAA;AAAA,IAC5B,MAAA,EAAQ;AAAA,GACV;AACF;AAGO,SAAS,eAAe,OAAA,EAA+C;AAC5E,EAAA,OAAO,EAAE,IAAA,EAAM,OAAA,CAAQ,IAAA,EAAM,MAAA,EAAQ,QAAQ,MAAA,EAAO;AACtD;;"}

package/dist/api/transform-schema.cjs

@@ -0,0 +1,31 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+const document = require('../application/transform/document/document.cjs');
+const rootTypeAliases = require('../application/transform/document/root-type-aliases.cjs');
+const documentDeclarations = require('./document-declarations.cjs');
+const footerEntry = require('./footer-entry.cjs');
+const transformContext = require('./transform-context.cjs');
+
+const OPERATIONS_NAME = "operations";
+function isOperations(entry) {
+  const name = footerEntry.isIrDeclaration(entry) ? entry.name : entry.name?.escapedText;
+  return name === OPERATIONS_NAME;
+}
+function transformDocument(schema, ctx) {
+  const document$1 = schema;
+  const context = transformContext.createTransformContext(ctx);
+  const rawBody = document.documentBody(document$1, context);
+  const footer = [...ctx.injectFooter];
+  const body = rootTypeAliases.renameAliasesTakenByFooter(rawBody, footer.filter(footerEntry.isIrDeclaration));
+  const closing = document.documentClosing(document$1, context, footer.some(isOperations));
+  return { body, footer, closing };
+}
+function transformSchema(schema, ctx) {
+  return documentDeclarations.documentDeclarations(transformDocument(schema, ctx));
+}
+
+exports.default = transformSchema;
+exports.transformDocument = transformDocument;
+//# sourceMappingURL=transform-schema.cjs.map

package/dist/api/transform-schema.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-schema.cjs","sources":["../../src/api/transform-schema.ts"],"sourcesContent":["import type { ts } from \"../adapters/type-ast-bridge/typescript-types.js\";\nimport { documentBody, documentClosing } from \"../application/transform/document/document.js\";\nimport { renameAliasesTakenByFooter } from \"../application/transform/document/root-type-aliases.js\";\nimport type { IrDeclaration } from \"../domain/ir/nodes.js\";\nimport type { DocumentObject } from \"../domain/openapi/document-object.js\";\nimport type { GlobalContext, OpenAPI3 } from \"../types.js\";\nimport { documentDeclarations, type TransformedDocument } from \"./document-declarations.js\";\nimport { type FooterEntry, isIrDeclaration } from \"./footer-entry.js\";\nimport { createTransformContext } from \"./transform-context.js\";\n\nconst OPERATIONS_NAME = \"operations\";\n\n/** Whether a footer entry is named `operations` (any declaration kind, as in the original). */\nfunction isOperations(entry: FooterEntry): boolean {\n  const name = isIrDeclaration(entry)\n    ? (entry as { name?: string }).name\n    : (entry as Partial<ts.InterfaceDeclaration>).name?.escapedText;\n  return name === OPERATIONS_NAME;\n}\n\n/** @internal Root types, the footer, then the closing declarations (Phase 5, step 6). */\nexport function transformDocument(schema: OpenAPI3, ctx: GlobalContext): TransformedDocument {\n  const document = schema as DocumentObject;\n  const context = createTransformContext(ctx);\n  // documentBody registers the enums in the footer, so the footer is read after it.\n  const rawBody = documentBody(document, context);\n  const footer: FooterEntry[] = [...ctx.injectFooter];\n  const body = renameAliasesTakenByFooter(rawBody, footer.filter(isIrDeclaration));\n  const closing = documentClosing(document, context, footer.some(isOperations));\n  return { body, footer, closing };\n}\n\n/**\n * The whole document as IR declarations (ENGINEERING_PLAN 6.1–6.2); `openapiTS` returns the same\n * for a loaded document.\n */\nexport default function transformSchema(schema: OpenAPI3, ctx: GlobalContext): IrDeclaration[] {\n  return documentDeclarations(transformDocument(schema, ctx));\n}\n"],"names":["isIrDeclaration","document","createTransformContext","documentBody","renameAliasesTakenByFooter","documentClosing","documentDeclarations"],"mappings":";;;;;;;;;;AAUA,MAAM,eAAA,GAAkB,YAAA;AAGxB,SAAS,aAAa,KAAA,EAA6B;AACjD,EAAA,MAAM,OAAOA,2BAAA,CAAgB,KAAK,IAC7B,KAAA,CAA4B,IAAA,GAC5B,MAA2C,IAAA,EAAM,WAAA;AACtD,EAAA,OAAO,IAAA,KAAS,eAAA;AAClB;AAGO,SAAS,iBAAA,CAAkB,QAAkB,GAAA,EAAyC;AAC3F,EAAA,MAAMC,UAAA,GAAW,MAAA;AACjB,EAAA,MAAM,OAAA,GAAUC,wCAAuB,GAAG,CAAA;AAE1C,EAAA,MAAM,OAAA,GAAUC,qBAAA,CAAaF,UAAA,EAAU,OAAO,CAAA;AAC9C,EAAA,MAAM,MAAA,GAAwB,CAAC,GAAG,GAAA,CAAI,YAAY,CAAA;AAClD,EAAA,MAAM,OAAOG,0CAAA,CAA2B,OAAA,EAAS,MAAA,CAAO,MAAA,CAAOJ,2BAAe,CAAC,CAAA;AAC/E,EAAA,MAAM,UAAUK,wBAAA,CAAgBJ,UAAA,EAAU,SAAS,MAAA,CAAO,IAAA,CAAK,YAAY,CAAC,CAAA;AAC5E,EAAA,OAAO,EAAE,IAAA,EAAM,MAAA,EAAQ,OAAA,EAAQ;AACjC;AAMA,SAAwB,eAAA,CAAgB,QAAkB,GAAA,EAAqC;AAC7F,EAAA,OAAOK,yCAAA,CAAqB,iBAAA,CAAkB,MAAA,EAAQ,GAAG,CAAC,CAAA;AAC5D;;;"}

package/dist/api/transform-schema.mjs

@@ -0,0 +1,26 @@
+import { documentBody, documentClosing } from '../application/transform/document/document.mjs';
+import { renameAliasesTakenByFooter } from '../application/transform/document/root-type-aliases.mjs';
+import { documentDeclarations } from './document-declarations.mjs';
+import { isIrDeclaration } from './footer-entry.mjs';
+import { createTransformContext } from './transform-context.mjs';
+
+const OPERATIONS_NAME = "operations";
+function isOperations(entry) {
+  const name = isIrDeclaration(entry) ? entry.name : entry.name?.escapedText;
+  return name === OPERATIONS_NAME;
+}
+function transformDocument(schema, ctx) {
+  const document = schema;
+  const context = createTransformContext(ctx);
+  const rawBody = documentBody(document, context);
+  const footer = [...ctx.injectFooter];
+  const body = renameAliasesTakenByFooter(rawBody, footer.filter(isIrDeclaration));
+  const closing = documentClosing(document, context, footer.some(isOperations));
+  return { body, footer, closing };
+}
+function transformSchema(schema, ctx) {
+  return documentDeclarations(transformDocument(schema, ctx));
+}
+
+export { transformSchema as default, transformDocument };
+//# sourceMappingURL=transform-schema.mjs.map

package/dist/api/transform-schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-schema.mjs","sources":["../../src/api/transform-schema.ts"],"sourcesContent":["import type { ts } from \"../adapters/type-ast-bridge/typescript-types.js\";\nimport { documentBody, documentClosing } from \"../application/transform/document/document.js\";\nimport { renameAliasesTakenByFooter } from \"../application/transform/document/root-type-aliases.js\";\nimport type { IrDeclaration } from \"../domain/ir/nodes.js\";\nimport type { DocumentObject } from \"../domain/openapi/document-object.js\";\nimport type { GlobalContext, OpenAPI3 } from \"../types.js\";\nimport { documentDeclarations, type TransformedDocument } from \"./document-declarations.js\";\nimport { type FooterEntry, isIrDeclaration } from \"./footer-entry.js\";\nimport { createTransformContext } from \"./transform-context.js\";\n\nconst OPERATIONS_NAME = \"operations\";\n\n/** Whether a footer entry is named `operations` (any declaration kind, as in the original). */\nfunction isOperations(entry: FooterEntry): boolean {\n  const name = isIrDeclaration(entry)\n    ? (entry as { name?: string }).name\n    : (entry as Partial<ts.InterfaceDeclaration>).name?.escapedText;\n  return name === OPERATIONS_NAME;\n}\n\n/** @internal Root types, the footer, then the closing declarations (Phase 5, step 6). */\nexport function transformDocument(schema: OpenAPI3, ctx: GlobalContext): TransformedDocument {\n  const document = schema as DocumentObject;\n  const context = createTransformContext(ctx);\n  // documentBody registers the enums in the footer, so the footer is read after it.\n  const rawBody = documentBody(document, context);\n  const footer: FooterEntry[] = [...ctx.injectFooter];\n  const body = renameAliasesTakenByFooter(rawBody, footer.filter(isIrDeclaration));\n  const closing = documentClosing(document, context, footer.some(isOperations));\n  return { body, footer, closing };\n}\n\n/**\n * The whole document as IR declarations (ENGINEERING_PLAN 6.1–6.2); `openapiTS` returns the same\n * for a loaded document.\n */\nexport default function transformSchema(schema: OpenAPI3, ctx: GlobalContext): IrDeclaration[] {\n  return documentDeclarations(transformDocument(schema, ctx));\n}\n"],"names":[],"mappings":";;;;;;AAUA,MAAM,eAAA,GAAkB,YAAA;AAGxB,SAAS,aAAa,KAAA,EAA6B;AACjD,EAAA,MAAM,OAAO,eAAA,CAAgB,KAAK,IAC7B,KAAA,CAA4B,IAAA,GAC5B,MAA2C,IAAA,EAAM,WAAA;AACtD,EAAA,OAAO,IAAA,KAAS,eAAA;AAClB;AAGO,SAAS,iBAAA,CAAkB,QAAkB,GAAA,EAAyC;AAC3F,EAAA,MAAM,QAAA,GAAW,MAAA;AACjB,EAAA,MAAM,OAAA,GAAU,uBAAuB,GAAG,CAAA;AAE1C,EAAA,MAAM,OAAA,GAAU,YAAA,CAAa,QAAA,EAAU,OAAO,CAAA;AAC9C,EAAA,MAAM,MAAA,GAAwB,CAAC,GAAG,GAAA,CAAI,YAAY,CAAA;AAClD,EAAA,MAAM,OAAO,0BAAA,CAA2B,OAAA,EAAS,MAAA,CAAO,MAAA,CAAO,eAAe,CAAC,CAAA;AAC/E,EAAA,MAAM,UAAU,eAAA,CAAgB,QAAA,EAAU,SAAS,MAAA,CAAO,IAAA,CAAK,YAAY,CAAC,CAAA;AAC5E,EAAA,OAAO,EAAE,IAAA,EAAM,MAAA,EAAQ,OAAA,EAAQ;AACjC;AAMA,SAAwB,eAAA,CAAgB,QAAkB,GAAA,EAAqC;AAC7F,EAAA,OAAO,oBAAA,CAAqB,iBAAA,CAAkB,MAAA,EAAQ,GAAG,CAAC,CAAA;AAC5D;;"}

package/dist/api/type-helpers.cjs

@@ -0,0 +1,85 @@
+'use strict';
+
+const loadTypescript = require('../adapters/type-ast-bridge/load-typescript.cjs');
+const typescriptToIr = require('../adapters/type-ast-bridge/typescript-to-ir.cjs');
+const helperTypes = require('../application/transform/helper-types.cjs');
+const literalType = require('../application/transform/literal-type.cjs');
+const refType = require('../application/transform/ref-type.cjs');
+const sharedTypes = require('../application/transform/shared-types.cjs');
+const typeCombinators = require('../application/transform/type-combinators.cjs');
+const constructors = require('../domain/ir/constructors.cjs');
+const footerEntry = require('./footer-entry.cjs');
+
+const BOOLEAN = Object.freeze(constructors.irKeyword("boolean"));
+const FALSE = Object.freeze(constructors.irBoolean(false));
+const NEVER = Object.freeze(constructors.irKeyword("never"));
+const NULL = Object.freeze(constructors.irKeyword("null"));
+const NUMBER = Object.freeze(constructors.irKeyword("number"));
+const STRING = Object.freeze(constructors.irKeyword("string"));
+const TRUE = Object.freeze(constructors.irBoolean(true));
+const UNDEFINED = Object.freeze(constructors.irKeyword("undefined"));
+const UNKNOWN = sharedTypes.UNKNOWN_TYPE;
+function isIrType(type) {
+  return typeof type.kind === "string";
+}
+function toIrType(type) {
+  return isIrType(type) ? type : typescriptToIr.fromTypeNode(loadTypescript.loadTypeScript(), type);
+}
+function tsUnion(types) {
+  return typeCombinators.unionOf(types.map(toIrType));
+}
+function tsIntersection(types) {
+  return typeCombinators.intersectionOf(types.map(toIrType));
+}
+function tsNullable(types) {
+  return typeCombinators.nullableOf(types.map(toIrType));
+}
+function tsOmit(type, keys) {
+  return typeCombinators.omitKeys(toIrType(type), keys);
+}
+function tsRecord(key, value) {
+  return constructors.irRecord(toIrType(key), toIrType(value));
+}
+function tsLiteral(value) {
+  return literalType.literalType(value);
+}
+function tsWithRequired(type, keys, injectFooter) {
+  if (keys.length === 0) {
+    return toIrType(type);
+  }
+  const { name, text } = helperTypes.HELPER_TYPES.withRequired;
+  if (!injectFooter.some((entry) => footerEntry.declaresTypeAlias(entry, name))) {
+    injectFooter.push({ kind: "rawDeclaration", name, text });
+  }
+  return typeCombinators.withRequiredKeys(toIrType(type), keys);
+}
+function isParameterObject(value) {
+  return Boolean(value && !("$ref" in value && value.$ref) && value.in);
+}
+function oapiRef(path, resolved, options = {}) {
+  return refType.refType(path, {
+    isDeep: options.deep ?? false,
+    extractProperties: options.extractProperties ?? [],
+    parameter: isParameterObject(resolved) ? { in: resolved.in, name: resolved.name } : null
+  });
+}
+
+exports.BOOLEAN = BOOLEAN;
+exports.FALSE = FALSE;
+exports.NEVER = NEVER;
+exports.NULL = NULL;
+exports.NUMBER = NUMBER;
+exports.STRING = STRING;
+exports.TRUE = TRUE;
+exports.UNDEFINED = UNDEFINED;
+exports.UNKNOWN = UNKNOWN;
+exports.oapiRef = oapiRef;
+exports.toIrType = toIrType;
+exports.tsIntersection = tsIntersection;
+exports.tsLiteral = tsLiteral;
+exports.tsNullable = tsNullable;
+exports.tsOmit = tsOmit;
+exports.tsRecord = tsRecord;
+exports.tsUnion = tsUnion;
+exports.tsWithRequired = tsWithRequired;
+//# sourceMappingURL=type-helpers.cjs.map

package/dist/api/type-helpers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-helpers.cjs","sources":["../../src/api/type-helpers.ts"],"sourcesContent":["import { loadTypeScript } from \"../adapters/type-ast-bridge/load-typescript.js\";\nimport { fromTypeNode } from \"../adapters/type-ast-bridge/typescript-to-ir.js\";\nimport type { ts } from \"../adapters/type-ast-bridge/typescript-types.js\";\nimport { HELPER_TYPES } from \"../application/transform/helper-types.js\";\nimport { literalType } from \"../application/transform/literal-type.js\";\nimport { refType } from \"../application/transform/ref-type.js\";\nimport { UNKNOWN_TYPE } from \"../application/transform/shared-types.js\";\nimport {\n  intersectionOf,\n  nullableOf,\n  omitKeys,\n  unionOf,\n  withRequiredKeys,\n} from \"../application/transform/type-combinators.js\";\nimport { irBoolean, irKeyword, irRecord } from \"../domain/ir/constructors.js\";\nimport type { IrType } from \"../domain/ir/nodes.js\";\nimport type { ParameterObject, ReferenceObject } from \"../types.js\";\nimport { declaresTypeAlias, type FooterEntry } from \"./footer-entry.js\";\n\n/**\n * The public type helpers (ENGINEERING_PLAN 6.2, ADR-004 decision 2). Same names and call\n * signatures as the original helpers; they return IR types. A `ts.TypeNode` argument (from user\n * code built with `ts.factory`) is read into IR by the bridge.\n */\n\n/** A helper argument: an IR type, or a TypeScript type node from user code. */\nexport type TypeInput = IrType | ts.TypeNode;\n\nexport const BOOLEAN: IrType = Object.freeze(irKeyword(\"boolean\"));\nexport const FALSE: IrType = Object.freeze(irBoolean(false));\nexport const NEVER: IrType = Object.freeze(irKeyword(\"never\"));\nexport const NULL: IrType = Object.freeze(irKeyword(\"null\"));\nexport const NUMBER: IrType = Object.freeze(irKeyword(\"number\"));\nexport const STRING: IrType = Object.freeze(irKeyword(\"string\"));\nexport const TRUE: IrType = Object.freeze(irBoolean(true));\nexport const UNDEFINED: IrType = Object.freeze(irKeyword(\"undefined\"));\n/** The shared `unknown` type; the transformers compare with it by identity, as the original did. */\nexport const UNKNOWN: IrType = UNKNOWN_TYPE;\n\n/** IR nodes have a string `kind`; TypeScript nodes have a numeric `SyntaxKind`. */\nfunction isIrType(type: TypeInput): type is IrType {\n  return typeof type.kind === \"string\";\n}\n\n/** @internal Read a helper argument into IR. */\nexport function toIrType(type: TypeInput): IrType {\n  return isIrType(type) ? type : fromTypeNode(loadTypeScript(), type);\n}\n\n/** `A | B`: `never` for no types, the type itself for one; repeated primitives are removed. */\nexport function tsUnion(types: readonly TypeInput[]): IrType {\n  return unionOf(types.map(toIrType));\n}\n\n/** `A & B`, with the same rules as `tsUnion`. */\nexport function tsIntersection(types: readonly TypeInput[]): IrType {\n  return intersectionOf(types.map(toIrType));\n}\n\n/** `A | null`, without removing repeated types. */\nexport function tsNullable(types: readonly TypeInput[]): IrType {\n  return nullableOf(types.map(toIrType));\n}\n\n/** `Omit<T, \"a\" | \"b\">`. */\nexport function tsOmit(type: TypeInput, keys: readonly string[]): IrType {\n  return omitKeys(toIrType(type), keys);\n}\n\n/** `Record<K, V>`. */\nexport function tsRecord(key: TypeInput, value: TypeInput): IrType {\n  return irRecord(toIrType(key), toIrType(value));\n}\n\n/**\n * The literal type of a JSON value: strings, numbers, booleans and `null` as literals, arrays as\n * tuples (an empty one as `never[]`), objects as object types; anything else is `unknown`.\n */\nexport function tsLiteral(value: unknown): IrType {\n  return literalType(value);\n}\n\n/**\n * `WithRequired<T, \"a\" | \"b\">`, or the type itself for no keys. Adds the `WithRequired` helper\n * type to the footer once.\n */\nexport function tsWithRequired(\n  type: TypeInput,\n  keys: readonly string[],\n  injectFooter: FooterEntry[],\n): IrType {\n  if (keys.length === 0) {\n    return toIrType(type);\n  }\n  const { name, text } = HELPER_TYPES.withRequired;\n  if (!injectFooter.some((entry) => declaresTypeAlias(entry, name))) {\n    injectFooter.push({ kind: \"rawDeclaration\", name, text });\n  }\n  return withRequiredKeys(toIrType(type), keys);\n}\n\nexport interface OapiRefOptions {\n  /** Whether to wrap with FlattenedDeepRequired<> (default: false) */\n  deep?: boolean;\n  /** Array of property names to wrap with Extract<> when accessing */\n  extractProperties?: string[];\n}\n\nfunction isParameterObject(\n  value: ParameterObject | ReferenceObject | undefined,\n): value is ParameterObject {\n  return Boolean(value && !(\"$ref\" in value && value.$ref) && (value as ParameterObject).in);\n}\n\n/**\n * The generated type a JSON Pointer refers to, as an indexed access: `#/components/schemas/Foo`\n * → `components[\"schemas\"][\"Foo\"]`. Object `properties` are skipped, and a referenced parameter\n * is indexed by its location (`resolved`).\n */\nexport function oapiRef(\n  path: string,\n  resolved?: ParameterObject | ReferenceObject,\n  options: OapiRefOptions = {},\n): IrType {\n  return refType(path, {\n    isDeep: options.deep ?? false,\n    extractProperties: options.extractProperties ?? [],\n    parameter: isParameterObject(resolved) ? { in: resolved.in, name: resolved.name } : null,\n  });\n}\n"],"names":["irKeyword","irBoolean","UNKNOWN_TYPE","fromTypeNode","loadTypeScript","unionOf","intersectionOf","nullableOf","omitKeys","irRecord","literalType","HELPER_TYPES","declaresTypeAlias","withRequiredKeys","refType"],"mappings":"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"}

package/dist/api/type-helpers.mjs

@@ -0,0 +1,66 @@
+import { loadTypeScript } from '../adapters/type-ast-bridge/load-typescript.mjs';
+import { fromTypeNode } from '../adapters/type-ast-bridge/typescript-to-ir.mjs';
+import { HELPER_TYPES } from '../application/transform/helper-types.mjs';
+import { literalType } from '../application/transform/literal-type.mjs';
+import { refType } from '../application/transform/ref-type.mjs';
+import { UNKNOWN_TYPE } from '../application/transform/shared-types.mjs';
+import { intersectionOf, nullableOf, omitKeys, unionOf, withRequiredKeys } from '../application/transform/type-combinators.mjs';
+import { irKeyword, irBoolean, irRecord } from '../domain/ir/constructors.mjs';
+import { declaresTypeAlias } from './footer-entry.mjs';
+
+const BOOLEAN = Object.freeze(irKeyword("boolean"));
+const FALSE = Object.freeze(irBoolean(false));
+const NEVER = Object.freeze(irKeyword("never"));
+const NULL = Object.freeze(irKeyword("null"));
+const NUMBER = Object.freeze(irKeyword("number"));
+const STRING = Object.freeze(irKeyword("string"));
+const TRUE = Object.freeze(irBoolean(true));
+const UNDEFINED = Object.freeze(irKeyword("undefined"));
+const UNKNOWN = UNKNOWN_TYPE;
+function isIrType(type) {
+  return typeof type.kind === "string";
+}
+function toIrType(type) {
+  return isIrType(type) ? type : fromTypeNode(loadTypeScript(), type);
+}
+function tsUnion(types) {
+  return unionOf(types.map(toIrType));
+}
+function tsIntersection(types) {
+  return intersectionOf(types.map(toIrType));
+}
+function tsNullable(types) {
+  return nullableOf(types.map(toIrType));
+}
+function tsOmit(type, keys) {
+  return omitKeys(toIrType(type), keys);
+}
+function tsRecord(key, value) {
+  return irRecord(toIrType(key), toIrType(value));
+}
+function tsLiteral(value) {
+  return literalType(value);
+}
+function tsWithRequired(type, keys, injectFooter) {
+  if (keys.length === 0) {
+    return toIrType(type);
+  }
+  const { name, text } = HELPER_TYPES.withRequired;
+  if (!injectFooter.some((entry) => declaresTypeAlias(entry, name))) {
+    injectFooter.push({ kind: "rawDeclaration", name, text });
+  }
+  return withRequiredKeys(toIrType(type), keys);
+}
+function isParameterObject(value) {
+  return Boolean(value && !("$ref" in value && value.$ref) && value.in);
+}
+function oapiRef(path, resolved, options = {}) {
+  return refType(path, {
+    isDeep: options.deep ?? false,
+    extractProperties: options.extractProperties ?? [],
+    parameter: isParameterObject(resolved) ? { in: resolved.in, name: resolved.name } : null
+  });
+}
+
+export { BOOLEAN, FALSE, NEVER, NULL, NUMBER, STRING, TRUE, UNDEFINED, UNKNOWN, oapiRef, toIrType, tsIntersection, tsLiteral, tsNullable, tsOmit, tsRecord, tsUnion, tsWithRequired };
+//# sourceMappingURL=type-helpers.mjs.map

package/dist/api/type-helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-helpers.mjs","sources":["../../src/api/type-helpers.ts"],"sourcesContent":["import { loadTypeScript } from \"../adapters/type-ast-bridge/load-typescript.js\";\nimport { fromTypeNode } from \"../adapters/type-ast-bridge/typescript-to-ir.js\";\nimport type { ts } from \"../adapters/type-ast-bridge/typescript-types.js\";\nimport { HELPER_TYPES } from \"../application/transform/helper-types.js\";\nimport { literalType } from \"../application/transform/literal-type.js\";\nimport { refType } from \"../application/transform/ref-type.js\";\nimport { UNKNOWN_TYPE } from \"../application/transform/shared-types.js\";\nimport {\n  intersectionOf,\n  nullableOf,\n  omitKeys,\n  unionOf,\n  withRequiredKeys,\n} from \"../application/transform/type-combinators.js\";\nimport { irBoolean, irKeyword, irRecord } from \"../domain/ir/constructors.js\";\nimport type { IrType } from \"../domain/ir/nodes.js\";\nimport type { ParameterObject, ReferenceObject } from \"../types.js\";\nimport { declaresTypeAlias, type FooterEntry } from \"./footer-entry.js\";\n\n/**\n * The public type helpers (ENGINEERING_PLAN 6.2, ADR-004 decision 2). Same names and call\n * signatures as the original helpers; they return IR types. A `ts.TypeNode` argument (from user\n * code built with `ts.factory`) is read into IR by the bridge.\n */\n\n/** A helper argument: an IR type, or a TypeScript type node from user code. */\nexport type TypeInput = IrType | ts.TypeNode;\n\nexport const BOOLEAN: IrType = Object.freeze(irKeyword(\"boolean\"));\nexport const FALSE: IrType = Object.freeze(irBoolean(false));\nexport const NEVER: IrType = Object.freeze(irKeyword(\"never\"));\nexport const NULL: IrType = Object.freeze(irKeyword(\"null\"));\nexport const NUMBER: IrType = Object.freeze(irKeyword(\"number\"));\nexport const STRING: IrType = Object.freeze(irKeyword(\"string\"));\nexport const TRUE: IrType = Object.freeze(irBoolean(true));\nexport const UNDEFINED: IrType = Object.freeze(irKeyword(\"undefined\"));\n/** The shared `unknown` type; the transformers compare with it by identity, as the original did. */\nexport const UNKNOWN: IrType = UNKNOWN_TYPE;\n\n/** IR nodes have a string `kind`; TypeScript nodes have a numeric `SyntaxKind`. */\nfunction isIrType(type: TypeInput): type is IrType {\n  return typeof type.kind === \"string\";\n}\n\n/** @internal Read a helper argument into IR. */\nexport function toIrType(type: TypeInput): IrType {\n  return isIrType(type) ? type : fromTypeNode(loadTypeScript(), type);\n}\n\n/** `A | B`: `never` for no types, the type itself for one; repeated primitives are removed. */\nexport function tsUnion(types: readonly TypeInput[]): IrType {\n  return unionOf(types.map(toIrType));\n}\n\n/** `A & B`, with the same rules as `tsUnion`. */\nexport function tsIntersection(types: readonly TypeInput[]): IrType {\n  return intersectionOf(types.map(toIrType));\n}\n\n/** `A | null`, without removing repeated types. */\nexport function tsNullable(types: readonly TypeInput[]): IrType {\n  return nullableOf(types.map(toIrType));\n}\n\n/** `Omit<T, \"a\" | \"b\">`. */\nexport function tsOmit(type: TypeInput, keys: readonly string[]): IrType {\n  return omitKeys(toIrType(type), keys);\n}\n\n/** `Record<K, V>`. */\nexport function tsRecord(key: TypeInput, value: TypeInput): IrType {\n  return irRecord(toIrType(key), toIrType(value));\n}\n\n/**\n * The literal type of a JSON value: strings, numbers, booleans and `null` as literals, arrays as\n * tuples (an empty one as `never[]`), objects as object types; anything else is `unknown`.\n */\nexport function tsLiteral(value: unknown): IrType {\n  return literalType(value);\n}\n\n/**\n * `WithRequired<T, \"a\" | \"b\">`, or the type itself for no keys. Adds the `WithRequired` helper\n * type to the footer once.\n */\nexport function tsWithRequired(\n  type: TypeInput,\n  keys: readonly string[],\n  injectFooter: FooterEntry[],\n): IrType {\n  if (keys.length === 0) {\n    return toIrType(type);\n  }\n  const { name, text } = HELPER_TYPES.withRequired;\n  if (!injectFooter.some((entry) => declaresTypeAlias(entry, name))) {\n    injectFooter.push({ kind: \"rawDeclaration\", name, text });\n  }\n  return withRequiredKeys(toIrType(type), keys);\n}\n\nexport interface OapiRefOptions {\n  /** Whether to wrap with FlattenedDeepRequired<> (default: false) */\n  deep?: boolean;\n  /** Array of property names to wrap with Extract<> when accessing */\n  extractProperties?: string[];\n}\n\nfunction isParameterObject(\n  value: ParameterObject | ReferenceObject | undefined,\n): value is ParameterObject {\n  return Boolean(value && !(\"$ref\" in value && value.$ref) && (value as ParameterObject).in);\n}\n\n/**\n * The generated type a JSON Pointer refers to, as an indexed access: `#/components/schemas/Foo`\n * → `components[\"schemas\"][\"Foo\"]`. Object `properties` are skipped, and a referenced parameter\n * is indexed by its location (`resolved`).\n */\nexport function oapiRef(\n  path: string,\n  resolved?: ParameterObject | ReferenceObject,\n  options: OapiRefOptions = {},\n): IrType {\n  return refType(path, {\n    isDeep: options.deep ?? false,\n    extractProperties: options.extractProperties ?? [],\n    parameter: isParameterObject(resolved) ? { in: resolved.in, name: resolved.name } : null,\n  });\n}\n"],"names":[],"mappings":"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"}

package/dist/api/unsupported-feature-warnings.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+const unsupportedFeatures = require('../domain/openapi/unsupported-features.cjs');
+
+const DOCS_BASE_URL = "https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs";
+const SUPPORT_DOCS_URL = `${DOCS_BASE_URL}/introduction.md#openapi-3-2-support`;
+const REASONS = {
+  [unsupportedFeatures.UnsupportedFeature.QUERYSTRING_NEXT_TO_QUERY]: 'is an "in: querystring" parameter next to "in: query" parameters, which OpenAPI 3.2 does not allow; the query parameters keep their types and this parameter is not in the generated types'
+};
+function warnUnsupportedFeatures(document, logger) {
+  for (const { feature, pointer } of unsupportedFeatures.findUnsupportedFeatures(document)) {
+    logger.warn(`${pointer} ${REASONS[feature]}. See ${SUPPORT_DOCS_URL}`);
+  }
+}
+
+exports.warnUnsupportedFeatures = warnUnsupportedFeatures;
+//# sourceMappingURL=unsupported-feature-warnings.cjs.map

package/dist/api/unsupported-feature-warnings.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsupported-feature-warnings.cjs","sources":["../../src/api/unsupported-feature-warnings.ts"],"sourcesContent":["import type { Logger } from \"../application/ports/logger.js\";\nimport {\n  findUnsupportedFeatures,\n  UnsupportedFeature,\n} from \"../domain/openapi/unsupported-features.js\";\n\nconst DOCS_BASE_URL = \"https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs\";\nconst SUPPORT_DOCS_URL = `${DOCS_BASE_URL}/introduction.md#openapi-3-2-support`;\n\n/** Why each feature is not in the generated types. */\nconst REASONS: Readonly<Record<UnsupportedFeature, string>> = {\n  [UnsupportedFeature.QUERYSTRING_NEXT_TO_QUERY]:\n    'is an \"in: querystring\" parameter next to \"in: query\" parameters, which OpenAPI 3.2 does ' +\n    \"not allow; the query parameters keep their types and this parameter is not in the \" +\n    \"generated types\",\n};\n\n/**\n * Warn once per use of an OpenAPI 3.2 feature that the generated types leave out, so a missing\n * parameter is never silent (CODING_PRINCIPLES §8.7).\n */\nexport function warnUnsupportedFeatures(document: unknown, logger: Logger): void {\n  for (const { feature, pointer } of findUnsupportedFeatures(document)) {\n    logger.warn(`${pointer} ${REASONS[feature]}. See ${SUPPORT_DOCS_URL}`);\n  }\n}\n"],"names":["UnsupportedFeature","findUnsupportedFeatures"],"mappings":";;;;AAMA,MAAM,aAAA,GAAgB,qEAAA;AACtB,MAAM,gBAAA,GAAmB,GAAG,aAAa,CAAA,oCAAA,CAAA;AAGzC,MAAM,OAAA,GAAwD;AAAA,EAC5D,CAACA,sCAAA,CAAmB,yBAAyB,GAC3C;AAGJ,CAAA;AAMO,SAAS,uBAAA,CAAwB,UAAmB,MAAA,EAAsB;AAC/E,EAAA,KAAA,MAAW,EAAE,OAAA,EAAS,OAAA,EAAQ,IAAKC,2CAAA,CAAwB,QAAQ,CAAA,EAAG;AACpE,IAAA,MAAA,CAAO,IAAA,CAAK,GAAG,OAAO,CAAA,CAAA,EAAI,QAAQ,OAAO,CAAC,CAAA,MAAA,EAAS,gBAAgB,CAAA,CAAE,CAAA;AAAA,EACvE;AACF;;"}

package/dist/api/unsupported-feature-warnings.mjs

@@ -0,0 +1,15 @@
+import { findUnsupportedFeatures, UnsupportedFeature } from '../domain/openapi/unsupported-features.mjs';
+
+const DOCS_BASE_URL = "https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs";
+const SUPPORT_DOCS_URL = `${DOCS_BASE_URL}/introduction.md#openapi-3-2-support`;
+const REASONS = {
+  [UnsupportedFeature.QUERYSTRING_NEXT_TO_QUERY]: 'is an "in: querystring" parameter next to "in: query" parameters, which OpenAPI 3.2 does not allow; the query parameters keep their types and this parameter is not in the generated types'
+};
+function warnUnsupportedFeatures(document, logger) {
+  for (const { feature, pointer } of findUnsupportedFeatures(document)) {
+    logger.warn(`${pointer} ${REASONS[feature]}. See ${SUPPORT_DOCS_URL}`);
+  }
+}
+
+export { warnUnsupportedFeatures };
+//# sourceMappingURL=unsupported-feature-warnings.mjs.map

package/dist/api/unsupported-feature-warnings.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsupported-feature-warnings.mjs","sources":["../../src/api/unsupported-feature-warnings.ts"],"sourcesContent":["import type { Logger } from \"../application/ports/logger.js\";\nimport {\n  findUnsupportedFeatures,\n  UnsupportedFeature,\n} from \"../domain/openapi/unsupported-features.js\";\n\nconst DOCS_BASE_URL = \"https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs\";\nconst SUPPORT_DOCS_URL = `${DOCS_BASE_URL}/introduction.md#openapi-3-2-support`;\n\n/** Why each feature is not in the generated types. */\nconst REASONS: Readonly<Record<UnsupportedFeature, string>> = {\n  [UnsupportedFeature.QUERYSTRING_NEXT_TO_QUERY]:\n    'is an \"in: querystring\" parameter next to \"in: query\" parameters, which OpenAPI 3.2 does ' +\n    \"not allow; the query parameters keep their types and this parameter is not in the \" +\n    \"generated types\",\n};\n\n/**\n * Warn once per use of an OpenAPI 3.2 feature that the generated types leave out, so a missing\n * parameter is never silent (CODING_PRINCIPLES §8.7).\n */\nexport function warnUnsupportedFeatures(document: unknown, logger: Logger): void {\n  for (const { feature, pointer } of findUnsupportedFeatures(document)) {\n    logger.warn(`${pointer} ${REASONS[feature]}. See ${SUPPORT_DOCS_URL}`);\n  }\n}\n"],"names":[],"mappings":";;AAMA,MAAM,aAAA,GAAgB,qEAAA;AACtB,MAAM,gBAAA,GAAmB,GAAG,aAAa,CAAA,oCAAA,CAAA;AAGzC,MAAM,OAAA,GAAwD;AAAA,EAC5D,CAAC,kBAAA,CAAmB,yBAAyB,GAC3C;AAGJ,CAAA;AAMO,SAAS,uBAAA,CAAwB,UAAmB,MAAA,EAAsB;AAC/E,EAAA,KAAA,MAAW,EAAE,OAAA,EAAS,OAAA,EAAQ,IAAK,uBAAA,CAAwB,QAAQ,CAAA,EAAG;AACpE,IAAA,MAAA,CAAO,IAAA,CAAK,GAAG,OAAO,CAAA,CAAA,EAAI,QAAQ,OAAO,CAAC,CAAA,MAAA,EAAS,gBAAgB,CAAA,CAAE,CAAA;AAAA,EACvE;AACF;;"}

package/dist/application/print/comment-writer.cjs

@@ -0,0 +1,95 @@
+'use strict';
+
+const assertNever = require('../../domain/assert-never.cjs');
+const textWriter = require('./text-writer.cjs');
+
+const LINE_FEED = 10;
+const CARRIAGE_RETURN = 13;
+const SINGLE_LINE_WHITESPACE = /* @__PURE__ */ new Set([
+  32,
+  9,
+  11,
+  12,
+  160,
+  133,
+  5760,
+  8192,
+  8193,
+  8194,
+  8195,
+  8196,
+  8197,
+  8198,
+  8199,
+  8200,
+  8201,
+  8202,
+  8203,
+  8239,
+  8287,
+  12288,
+  65279
+]);
+const TAB = 9;
+function computeLineStarts(text) {
+  const starts = [0];
+  for (let position = 0; position < text.length; position++) {
+    const code = text.charCodeAt(position);
+    if (code === CARRIAGE_RETURN && text.charCodeAt(position + 1) === LINE_FEED) {
+      position++;
+    }
+    if (textWriter.isLineBreak(code)) {
+      starts.push(position + 1);
+    }
+  }
+  return starts;
+}
+function measureIndent(text, start, end, tabSize) {
+  let width = 0;
+  for (let position = start; position < end && SINGLE_LINE_WHITESPACE.has(text.charCodeAt(position)); position++) {
+    width += text.charCodeAt(position) === TAB ? tabSize - width % tabSize : 1;
+  }
+  return width;
+}
+function writeTrimmedLine(writer, text, start, end) {
+  const lineEnd = Math.min(text.length, end - 1);
+  const line = text.substring(start, lineEnd).trim();
+  if (line.length === 0) {
+    writer.rawWrite(writer.options.newLine);
+    return;
+  }
+  writer.write(line);
+  if (lineEnd !== text.length) {
+    writer.writeLine();
+  }
+}
+function writeBlockComment(writer, body) {
+  const text = `/*${body}*/`;
+  const lineStarts = computeLineStarts(text);
+  const { indentSize } = writer.options;
+  lineStarts.forEach((start, line) => {
+    const end = line + 1 === lineStarts.length ? text.length + 1 : lineStarts[line + 1];
+    if (line > 0) {
+      const spaces = writer.indent * indentSize + measureIndent(text, start, end, indentSize);
+      writer.rawWrite(" ".repeat(spaces));
+    }
+    writeTrimmedLine(writer, text, start, end);
+  });
+}
+function writeLeadingComment(writer, comment) {
+  switch (comment.kind) {
+    case "block":
+      writeBlockComment(writer, comment.text);
+      break;
+    case "line":
+      writer.writeLine();
+      writer.write(`//${comment.text}`);
+      break;
+    default:
+      assertNever.assertNever(comment);
+  }
+  writer.writeLine();
+}
+
+exports.writeLeadingComment = writeLeadingComment;
+//# sourceMappingURL=comment-writer.cjs.map

package/dist/application/print/comment-writer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-writer.cjs","sources":["../../../src/application/print/comment-writer.ts"],"sourcesContent":["import { assertNever } from \"../../domain/assert-never.js\";\nimport type { IrComment } from \"../../domain/ir/nodes.js\";\nimport { isLineBreak, type TextWriter } from \"./text-writer.js\";\n\nconst LINE_FEED = 0x0a;\nconst CARRIAGE_RETURN = 0x0d;\n\n/** Single-line white space as the TypeScript scanner defines it (`isWhiteSpaceSingleLine`). */\nconst SINGLE_LINE_WHITESPACE = new Set([\n  0x20, 0x09, 0x0b, 0x0c, 0xa0, 0x85, 0x1680, 0x2000, 0x2001, 0x2002, 0x2003, 0x2004, 0x2005,\n  0x2006, 0x2007, 0x2008, 0x2009, 0x200a, 0x200b, 0x202f, 0x205f, 0x3000, 0xfeff,\n]);\nconst TAB = 0x09;\n\n/** Start offsets of every line, splitting at CR LF, CR, LF, U+2028 and U+2029 like TypeScript. */\nfunction computeLineStarts(text: string): number[] {\n  const starts = [0];\n  for (let position = 0; position < text.length; position++) {\n    const code = text.charCodeAt(position);\n    if (code === CARRIAGE_RETURN && text.charCodeAt(position + 1) === LINE_FEED) {\n      position++;\n    }\n    if (isLineBreak(code)) {\n      starts.push(position + 1);\n    }\n  }\n  return starts;\n}\n\n/** Leading white space width of `text[start, end)`, counting a tab up to the next tab stop. */\nfunction measureIndent(text: string, start: number, end: number, tabSize: number): number {\n  let width = 0;\n  for (\n    let position = start;\n    position < end && SINGLE_LINE_WHITESPACE.has(text.charCodeAt(position));\n    position++\n  ) {\n    width += text.charCodeAt(position) === TAB ? tabSize - (width % tabSize) : 1;\n  }\n  return width;\n}\n\n/** Write the line `text[start, end)` trimmed; a blank line becomes a bare line break. */\nfunction writeTrimmedLine(writer: TextWriter, text: string, start: number, end: number): void {\n  const lineEnd = Math.min(text.length, end - 1);\n  const line = text.substring(start, lineEnd).trim();\n  if (line.length === 0) {\n    writer.rawWrite(writer.options.newLine);\n    return;\n  }\n  writer.write(line);\n  if (lineEnd !== text.length) {\n    writer.writeLine();\n  }\n}\n\n/**\n * Write a `/*...*\\/` comment the way the TypeScript printer writes a synthesized one: every line\n * after the first is re-indented to the current level plus the line's own leading white space, and\n * every line is trimmed. (TypeScript only does this for comments whose second character is `*`,\n * which is always true for a synthesized block comment, so there is no other branch.)\n */\nfunction writeBlockComment(writer: TextWriter, body: string): void {\n  const text = `/*${body}*/`;\n  const lineStarts = computeLineStarts(text);\n  const { indentSize } = writer.options;\n  lineStarts.forEach((start, line) => {\n    const end = line + 1 === lineStarts.length ? text.length + 1 : (lineStarts[line + 1] as number);\n    if (line > 0) {\n      const spaces = writer.indent * indentSize + measureIndent(text, start, end, indentSize);\n      writer.rawWrite(\" \".repeat(spaces));\n    }\n    writeTrimmedLine(writer, text, start, end);\n  });\n}\n\n/** Write a comment on its own line before the node it belongs to. */\nexport function writeLeadingComment(writer: TextWriter, comment: IrComment): void {\n  switch (comment.kind) {\n    case \"block\":\n      writeBlockComment(writer, comment.text);\n      break;\n    case \"line\":\n      writer.writeLine();\n      writer.write(`//${comment.text}`);\n      break;\n    default:\n      assertNever(comment);\n  }\n  writer.writeLine();\n}\n"],"names":["isLineBreak","assertNever"],"mappings":"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"}

package/dist/application/print/comment-writer.mjs

@@ -0,0 +1,93 @@
+import { assertNever } from '../../domain/assert-never.mjs';
+import { isLineBreak } from './text-writer.mjs';
+
+const LINE_FEED = 10;
+const CARRIAGE_RETURN = 13;
+const SINGLE_LINE_WHITESPACE = /* @__PURE__ */ new Set([
+  32,
+  9,
+  11,
+  12,
+  160,
+  133,
+  5760,
+  8192,
+  8193,
+  8194,
+  8195,
+  8196,
+  8197,
+  8198,
+  8199,
+  8200,
+  8201,
+  8202,
+  8203,
+  8239,
+  8287,
+  12288,
+  65279
+]);
+const TAB = 9;
+function computeLineStarts(text) {
+  const starts = [0];
+  for (let position = 0; position < text.length; position++) {
+    const code = text.charCodeAt(position);
+    if (code === CARRIAGE_RETURN && text.charCodeAt(position + 1) === LINE_FEED) {
+      position++;
+    }
+    if (isLineBreak(code)) {
+      starts.push(position + 1);
+    }
+  }
+  return starts;
+}
+function measureIndent(text, start, end, tabSize) {
+  let width = 0;
+  for (let position = start; position < end && SINGLE_LINE_WHITESPACE.has(text.charCodeAt(position)); position++) {
+    width += text.charCodeAt(position) === TAB ? tabSize - width % tabSize : 1;
+  }
+  return width;
+}
+function writeTrimmedLine(writer, text, start, end) {
+  const lineEnd = Math.min(text.length, end - 1);
+  const line = text.substring(start, lineEnd).trim();
+  if (line.length === 0) {
+    writer.rawWrite(writer.options.newLine);
+    return;
+  }
+  writer.write(line);
+  if (lineEnd !== text.length) {
+    writer.writeLine();
+  }
+}
+function writeBlockComment(writer, body) {
+  const text = `/*${body}*/`;
+  const lineStarts = computeLineStarts(text);
+  const { indentSize } = writer.options;
+  lineStarts.forEach((start, line) => {
+    const end = line + 1 === lineStarts.length ? text.length + 1 : lineStarts[line + 1];
+    if (line > 0) {
+      const spaces = writer.indent * indentSize + measureIndent(text, start, end, indentSize);
+      writer.rawWrite(" ".repeat(spaces));
+    }
+    writeTrimmedLine(writer, text, start, end);
+  });
+}
+function writeLeadingComment(writer, comment) {
+  switch (comment.kind) {
+    case "block":
+      writeBlockComment(writer, comment.text);
+      break;
+    case "line":
+      writer.writeLine();
+      writer.write(`//${comment.text}`);
+      break;
+    default:
+      assertNever(comment);
+  }
+  writer.writeLine();
+}
+
+export { writeLeadingComment };
+//# sourceMappingURL=comment-writer.mjs.map

package/dist/application/print/comment-writer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-writer.mjs","sources":["../../../src/application/print/comment-writer.ts"],"sourcesContent":["import { assertNever } from \"../../domain/assert-never.js\";\nimport type { IrComment } from \"../../domain/ir/nodes.js\";\nimport { isLineBreak, type TextWriter } from \"./text-writer.js\";\n\nconst LINE_FEED = 0x0a;\nconst CARRIAGE_RETURN = 0x0d;\n\n/** Single-line white space as the TypeScript scanner defines it (`isWhiteSpaceSingleLine`). */\nconst SINGLE_LINE_WHITESPACE = new Set([\n  0x20, 0x09, 0x0b, 0x0c, 0xa0, 0x85, 0x1680, 0x2000, 0x2001, 0x2002, 0x2003, 0x2004, 0x2005,\n  0x2006, 0x2007, 0x2008, 0x2009, 0x200a, 0x200b, 0x202f, 0x205f, 0x3000, 0xfeff,\n]);\nconst TAB = 0x09;\n\n/** Start offsets of every line, splitting at CR LF, CR, LF, U+2028 and U+2029 like TypeScript. */\nfunction computeLineStarts(text: string): number[] {\n  const starts = [0];\n  for (let position = 0; position < text.length; position++) {\n    const code = text.charCodeAt(position);\n    if (code === CARRIAGE_RETURN && text.charCodeAt(position + 1) === LINE_FEED) {\n      position++;\n    }\n    if (isLineBreak(code)) {\n      starts.push(position + 1);\n    }\n  }\n  return starts;\n}\n\n/** Leading white space width of `text[start, end)`, counting a tab up to the next tab stop. */\nfunction measureIndent(text: string, start: number, end: number, tabSize: number): number {\n  let width = 0;\n  for (\n    let position = start;\n    position < end && SINGLE_LINE_WHITESPACE.has(text.charCodeAt(position));\n    position++\n  ) {\n    width += text.charCodeAt(position) === TAB ? tabSize - (width % tabSize) : 1;\n  }\n  return width;\n}\n\n/** Write the line `text[start, end)` trimmed; a blank line becomes a bare line break. */\nfunction writeTrimmedLine(writer: TextWriter, text: string, start: number, end: number): void {\n  const lineEnd = Math.min(text.length, end - 1);\n  const line = text.substring(start, lineEnd).trim();\n  if (line.length === 0) {\n    writer.rawWrite(writer.options.newLine);\n    return;\n  }\n  writer.write(line);\n  if (lineEnd !== text.length) {\n    writer.writeLine();\n  }\n}\n\n/**\n * Write a `/*...*\\/` comment the way the TypeScript printer writes a synthesized one: every line\n * after the first is re-indented to the current level plus the line's own leading white space, and\n * every line is trimmed. (TypeScript only does this for comments whose second character is `*`,\n * which is always true for a synthesized block comment, so there is no other branch.)\n */\nfunction writeBlockComment(writer: TextWriter, body: string): void {\n  const text = `/*${body}*/`;\n  const lineStarts = computeLineStarts(text);\n  const { indentSize } = writer.options;\n  lineStarts.forEach((start, line) => {\n    const end = line + 1 === lineStarts.length ? text.length + 1 : (lineStarts[line + 1] as number);\n    if (line > 0) {\n      const spaces = writer.indent * indentSize + measureIndent(text, start, end, indentSize);\n      writer.rawWrite(\" \".repeat(spaces));\n    }\n    writeTrimmedLine(writer, text, start, end);\n  });\n}\n\n/** Write a comment on its own line before the node it belongs to. */\nexport function writeLeadingComment(writer: TextWriter, comment: IrComment): void {\n  switch (comment.kind) {\n    case \"block\":\n      writeBlockComment(writer, comment.text);\n      break;\n    case \"line\":\n      writer.writeLine();\n      writer.write(`//${comment.text}`);\n      break;\n    default:\n      assertNever(comment);\n  }\n  writer.writeLine();\n}\n"],"names":[],"mappings":"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"}

package/dist/application/print/declaration-printer.cjs

@@ -0,0 +1,83 @@
+'use strict';
+
+const assertNever = require('../../domain/assert-never.cjs');
+const commentWriter = require('./comment-writer.cjs');
+const literalText = require('./literal-text.cjs');
+const typePrinter = require('./type-printer.cjs');
+
+function printValue(value) {
+  return typeof value === "number" ? literalText.printNumberLiteral(value) : literalText.printEscapedString(value);
+}
+function writeHead(writer, declaration) {
+  for (const comment of declaration.comments) {
+    commentWriter.writeLeadingComment(writer, comment);
+  }
+  if (declaration.isExported) {
+    writer.write("export ");
+  }
+}
+function writeInterface(writer, declaration) {
+  writeHead(writer, declaration);
+  writer.write(`interface ${declaration.name} {`);
+  typePrinter.writeMultiLineList(
+    writer,
+    declaration.members,
+    { delimiter: "", isLineBreakWhenEmpty: true },
+    (member) => typePrinter.writeMember(writer, member)
+  );
+  writer.write("}");
+}
+function writeTypeAlias(writer, declaration) {
+  writeHead(writer, declaration);
+  writer.write(`type ${declaration.name} = `);
+  typePrinter.writeType(writer, declaration.type);
+  writer.write(";");
+}
+function writeEnumMember(writer, member) {
+  for (const comment of member.comments) {
+    commentWriter.writeLeadingComment(writer, comment);
+  }
+  writer.write(`${member.name} = ${printValue(member.value)}`);
+}
+function writeEnum(writer, declaration) {
+  writeHead(writer, declaration);
+  writer.write(`enum ${declaration.name} {`);
+  typePrinter.writeMultiLineList(
+    writer,
+    declaration.members,
+    { delimiter: ",", isLineBreakWhenEmpty: true },
+    (member) => writeEnumMember(writer, member)
+  );
+  writer.write("}");
+}
+function writeConstArray(writer, declaration) {
+  writeHead(writer, declaration);
+  writer.write(`const ${declaration.name}: `);
+  typePrinter.writeType(writer, declaration.type);
+  writer.write(` = [${declaration.values.map(printValue).join(", ")}];`);
+}
+function writeDeclaration(writer, declaration) {
+  writer.writeLine();
+  switch (declaration.kind) {
+    case "interface":
+      writeInterface(writer, declaration);
+      break;
+    case "typeAlias":
+      writeTypeAlias(writer, declaration);
+      break;
+    case "enum":
+      writeEnum(writer, declaration);
+      break;
+    case "constArray":
+      writeConstArray(writer, declaration);
+      break;
+    case "rawDeclaration":
+      writer.write(declaration.text);
+      break;
+    default:
+      assertNever.assertNever(declaration);
+  }
+}
+
+exports.writeDeclaration = writeDeclaration;
+//# sourceMappingURL=declaration-printer.cjs.map