@polyprism/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Travis Fitzgerald
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,32 @@
+# @polyprism/core
+
+Internal package — the language-agnostic IR, DMMF reader, annotation parser,
+naming resolver, and generator runtime that powers every `@polyprism/*`
+pattern package.
+
+You probably don't want to install this directly. Pick a pattern package:
+
+- [`@polyprism/ts-interface`](../ts-interface) — `export interface User { ... }`
+- [`@polyprism/ts-type`](../ts-type) — `export type User = { ... };`
+- [`@polyprism/ts-class`](../ts-class) — `export class User { ... }`
+
+See the [root README](../../README.md) for the project overview, annotation
+reference, and full feature list.
+
+## Public API
+
+This package exports:
+
+- IR types (`ModelDef`, `FieldDef`, `EnumDef`, `AnnotationSet`, etc.)
+- Annotation parser (`parseAnnotations`)
+- Naming resolver (`resolveTypeIdent`, `resolveFieldIdent`, `resolveTypeFilename`)
+- Generator runtime (`defineGenerator`, `GeneratorContext`)
+- Shared emitter helpers (`emitEnums`, `emitJsonTypes`, `prettyFormatType`,
+  `createInMemoryFileWriter`)
+
+The DMMF reader is internal — it is **never** exposed publicly. This is what
+lets pattern packages have zero third-party runtime dependencies.
+
+## License
+
+[MIT](../../LICENSE) © Travis Fitzgerald

package/dist/annotations/enrich.d.ts

@@ -0,0 +1,5 @@
+import { PolyPrismIR } from '../ir/types.js';
+
+declare function enrichAnnotations(ir: PolyPrismIR): PolyPrismIR;
+
+export { enrichAnnotations };

package/dist/annotations/enrich.js

@@ -0,0 +1,40 @@
+import { parseAnnotations } from "./parser.js";
+function enrichAnnotations(ir) {
+  return {
+    models: ir.models.map(enrichModel),
+    enums: ir.enums.map(enrichEnum)
+  };
+}
+function enrichModel(model) {
+  return {
+    ...model,
+    annotations: mergeRawDoc(parseAnnotations(model.documentation), model.documentation),
+    fields: model.fields.map(enrichField)
+  };
+}
+function enrichField(field) {
+  return {
+    ...field,
+    annotations: mergeRawDoc(parseAnnotations(field.documentation), field.documentation)
+  };
+}
+function enrichEnum(enumDef) {
+  return {
+    ...enumDef,
+    annotations: mergeRawDoc(parseAnnotations(enumDef.documentation), enumDef.documentation),
+    values: enumDef.values.map(enrichEnumValue)
+  };
+}
+function enrichEnumValue(value) {
+  return {
+    ...value,
+    annotations: mergeRawDoc(parseAnnotations(value.documentation), value.documentation)
+  };
+}
+function mergeRawDoc(parsed, _original) {
+  return parsed;
+}
+export {
+  enrichAnnotations
+};
+//# sourceMappingURL=enrich.js.map

package/dist/annotations/enrich.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/annotations/enrich.ts"],"sourcesContent":["// Walk an PolyPrism IR and enrich every node's annotations by parsing\n// its `documentation` string. Returns a new IR — the input is not mutated.\n\nimport type {\n  AnnotationSet,\n  EnumDef,\n  EnumValueDef,\n  FieldDef,\n  ModelDef,\n  PolyPrismIR,\n} from \"../ir/types.js\";\nimport { parseAnnotations } from \"./parser.js\";\n\nexport function enrichAnnotations(ir: PolyPrismIR): PolyPrismIR {\n  return {\n    models: ir.models.map(enrichModel),\n    enums: ir.enums.map(enrichEnum),\n  };\n}\n\nfunction enrichModel(model: ModelDef): ModelDef {\n  return {\n    ...model,\n    annotations: mergeRawDoc(parseAnnotations(model.documentation), model.documentation),\n    fields: model.fields.map(enrichField),\n  };\n}\n\nfunction enrichField(field: FieldDef): FieldDef {\n  return {\n    ...field,\n    annotations: mergeRawDoc(parseAnnotations(field.documentation), field.documentation),\n  };\n}\n\nfunction enrichEnum(enumDef: EnumDef): EnumDef {\n  return {\n    ...enumDef,\n    annotations: mergeRawDoc(parseAnnotations(enumDef.documentation), enumDef.documentation),\n    values: enumDef.values.map(enrichEnumValue),\n  };\n}\n\nfunction enrichEnumValue(value: EnumValueDef): EnumValueDef {\n  return {\n    ...value,\n    annotations: mergeRawDoc(parseAnnotations(value.documentation), value.documentation),\n  };\n}\n\n/**\n * The parser's `documentation` field has annotation lines stripped. For nodes\n * that never had documentation, ensure that stays null rather than empty string.\n */\nfunction mergeRawDoc(parsed: AnnotationSet, _original: string | null): AnnotationSet {\n  return parsed;\n}\n"],"mappings":"AAWA,SAAS,wBAAwB;AAE1B,SAAS,kBAAkB,IAA8B;AAC9D,SAAO;AAAA,IACL,QAAQ,GAAG,OAAO,IAAI,WAAW;AAAA,IACjC,OAAO,GAAG,MAAM,IAAI,UAAU;AAAA,EAChC;AACF;AAEA,SAAS,YAAY,OAA2B;AAC9C,SAAO;AAAA,IACL,GAAG;AAAA,IACH,aAAa,YAAY,iBAAiB,MAAM,aAAa,GAAG,MAAM,aAAa;AAAA,IACnF,QAAQ,MAAM,OAAO,IAAI,WAAW;AAAA,EACtC;AACF;AAEA,SAAS,YAAY,OAA2B;AAC9C,SAAO;AAAA,IACL,GAAG;AAAA,IACH,aAAa,YAAY,iBAAiB,MAAM,aAAa,GAAG,MAAM,aAAa;AAAA,EACrF;AACF;AAEA,SAAS,WAAW,SAA2B;AAC7C,SAAO;AAAA,IACL,GAAG;AAAA,IACH,aAAa,YAAY,iBAAiB,QAAQ,aAAa,GAAG,QAAQ,aAAa;AAAA,IACvF,QAAQ,QAAQ,OAAO,IAAI,eAAe;AAAA,EAC5C;AACF;AAEA,SAAS,gBAAgB,OAAmC;AAC1D,SAAO;AAAA,IACL,GAAG;AAAA,IACH,aAAa,YAAY,iBAAiB,MAAM,aAAa,GAAG,MAAM,aAAa;AAAA,EACrF;AACF;AAMA,SAAS,YAAY,QAAuB,WAAyC;AACnF,SAAO;AACT;","names":[]}

package/dist/annotations/index.d.ts

@@ -0,0 +1,3 @@
+export { enrichAnnotations } from './enrich.js';
+export { parseAnnotations } from './parser.js';
+import '../ir/types.js';

package/dist/annotations/index.js

@@ -0,0 +1,3 @@
+export * from "./enrich.js";
+export * from "./parser.js";
+//# sourceMappingURL=index.js.map

package/dist/annotations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/annotations/index.ts"],"sourcesContent":["export * from \"./enrich.js\";\nexport * from \"./parser.js\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;","names":[]}

package/dist/annotations/parser.d.ts

@@ -0,0 +1,9 @@
+import { AnnotationSet } from '../ir/types.js';
+
+/**
+ * Parse a documentation string into an AnnotationSet.
+ * Lines that aren't annotations are preserved in `documentation`.
+ */
+declare function parseAnnotations(doc: string | null): AnnotationSet;
+
+export { parseAnnotations };

package/dist/annotations/parser.js

@@ -0,0 +1,207 @@
+const VALID_NORMALISE_OPS = /* @__PURE__ */ new Set([
+  "trim",
+  "lowercase",
+  "uppercase",
+  "nullEmptyToNull"
+]);
+const VALID_COERCE_TARGETS = /* @__PURE__ */ new Set(["date", "int", "float", "decimal", "string"]);
+function parseAnnotations(doc) {
+  const result = {
+    hide: false,
+    deprecated: null,
+    json: null,
+    type: null,
+    name: null,
+    normalise: null,
+    coerce: null,
+    documentation: null,
+    rawAnnotations: []
+  };
+  if (!doc) return result;
+  const logicalLines = splitLogicalLines(doc);
+  const docLines = [];
+  const rawAnnotations = [];
+  for (const line of logicalLines) {
+    const trimmed = line.trim();
+    const bracketMatch = /^\[(\w+)\]$/.exec(trimmed);
+    if (bracketMatch) {
+      result.json = { kind: "bare", typeName: bracketMatch[1] };
+      rawAnnotations.push(trimmed);
+      continue;
+    }
+    const annotationMatch = /^@(\w+)(?:\s*\(([\s\S]*)\))?$/.exec(trimmed);
+    if (annotationMatch) {
+      applyAnnotation(annotationMatch[1], annotationMatch[2] ?? null, result);
+      rawAnnotations.push(trimmed);
+      continue;
+    }
+    docLines.push(line);
+  }
+  const joinedDoc = docLines.join("\n").trim();
+  result.documentation = joinedDoc.length > 0 ? joinedDoc : null;
+  result.rawAnnotations = rawAnnotations;
+  return result;
+}
+function splitLogicalLines(doc) {
+  const physical = doc.split("\n");
+  const logical = [];
+  let buffer = "";
+  let parenDepth = 0;
+  let braceDepth = 0;
+  let bracketDepth = 0;
+  let inString = null;
+  let isEscaped = false;
+  for (const line of physical) {
+    for (const ch of line) {
+      if (isEscaped) {
+        isEscaped = false;
+        continue;
+      }
+      if (ch === "\\") {
+        isEscaped = true;
+        continue;
+      }
+      if (inString) {
+        if (ch === inString) inString = null;
+        continue;
+      }
+      if (ch === '"' || ch === "'" || ch === "`") {
+        inString = ch;
+        continue;
+      }
+      if (ch === "(") parenDepth++;
+      else if (ch === ")") parenDepth--;
+      else if (ch === "{") braceDepth++;
+      else if (ch === "}") braceDepth--;
+      else if (ch === "[") bracketDepth++;
+      else if (ch === "]") bracketDepth--;
+    }
+    buffer = buffer.length === 0 ? line : `${buffer} ${line.trim()}`;
+    if (parenDepth === 0 && braceDepth === 0 && bracketDepth === 0 && inString === null) {
+      logical.push(buffer);
+      buffer = "";
+    }
+  }
+  if (buffer.length > 0) logical.push(buffer);
+  return logical;
+}
+function applyAnnotation(name, args, set) {
+  switch (name) {
+    case "hide":
+      set.hide = true;
+      return;
+    case "deprecated":
+      set.deprecated = { reason: args ? extractStringArg(args) : null };
+      return;
+    case "json":
+      set.json = parseJsonArgs(args);
+      return;
+    case "type":
+      set.type = parseTypeArgs(args);
+      return;
+    case "name":
+      set.name = args ? args.trim() : null;
+      return;
+    case "normalise":
+    case "normalize":
+      set.normalise = parseNormaliseArgs(args);
+      return;
+    case "coerce":
+      set.coerce = parseCoerceArg(args);
+      return;
+    default:
+      return;
+  }
+}
+function parseJsonArgs(args) {
+  if (!args) return null;
+  const trimmed = args.trim();
+  if (trimmed.length === 0) return null;
+  const pathMatch = /^(\w+)\s+from\s+["'](.+)["']$/.exec(trimmed);
+  if (pathMatch) {
+    return { kind: "with-path", typeName: pathMatch[1], importPath: pathMatch[2] };
+  }
+  const eqIndex = findTopLevelAssignment(trimmed);
+  if (eqIndex > 0) {
+    const namePart = trimmed.slice(0, eqIndex).trim();
+    const exprPart = trimmed.slice(eqIndex + 1).trim();
+    if (/^\w+$/.test(namePart) && exprPart.length > 0) {
+      return { kind: "inline-named", typeName: namePart, typeExpression: exprPart };
+    }
+  }
+  if (/^\w+$/.test(trimmed)) {
+    return { kind: "bare", typeName: trimmed };
+  }
+  return { kind: "inline-anonymous", typeExpression: trimmed };
+}
+function findTopLevelAssignment(s) {
+  let depth = 0;
+  let inString = null;
+  let isEscaped = false;
+  for (let i = 0; i < s.length; i++) {
+    const ch = s[i];
+    if (isEscaped) {
+      isEscaped = false;
+      continue;
+    }
+    if (ch === "\\") {
+      isEscaped = true;
+      continue;
+    }
+    if (inString) {
+      if (ch === inString) inString = null;
+      continue;
+    }
+    if (ch === '"' || ch === "'" || ch === "`") {
+      inString = ch;
+      continue;
+    }
+    if (ch === "{" || ch === "(" || ch === "[" || ch === "<") {
+      depth++;
+      continue;
+    }
+    if (ch === "}" || ch === ")" || ch === "]" || ch === ">") {
+      depth--;
+      continue;
+    }
+    if (ch === "=" && depth === 0) {
+      const prev = i > 0 ? s[i - 1] : "";
+      const next = i + 1 < s.length ? s[i + 1] : "";
+      if (next === "=" || next === ">") continue;
+      if (prev === "=" || prev === "!" || prev === "<" || prev === ">") continue;
+      return i;
+    }
+  }
+  return -1;
+}
+function parseTypeArgs(args) {
+  if (!args) return null;
+  const trimmed = args.trim();
+  const pathMatch = /^(\w+)\s+from\s+["'](.+)["']$/.exec(trimmed);
+  if (pathMatch) {
+    return { typeName: pathMatch[1], importPath: pathMatch[2] };
+  }
+  if (/^\w+$/.test(trimmed)) {
+    return { typeName: trimmed, importPath: null };
+  }
+  return null;
+}
+function parseNormaliseArgs(args) {
+  if (!args) return null;
+  const ops = args.split(",").map((s) => s.trim()).filter((s) => s.length > 0).filter((s) => VALID_NORMALISE_OPS.has(s));
+  return ops.length > 0 ? ops : null;
+}
+function parseCoerceArg(args) {
+  if (!args) return null;
+  const trimmed = args.trim();
+  return VALID_COERCE_TARGETS.has(trimmed) ? trimmed : null;
+}
+function extractStringArg(args) {
+  const trimmed = args.trim();
+  const match = /^["'](.*)["']$/s.exec(trimmed);
+  return match ? match[1] : trimmed;
+}
+export {
+  parseAnnotations
+};
+//# sourceMappingURL=parser.js.map

package/dist/annotations/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/annotations/parser.ts"],"sourcesContent":["// Annotation parser for PolyPrism doc-comment annotations.\n//\n// Grammar (v0.1):\n//   line       = '@' ident                          // @hide\n//              | '@' ident '(' args ')'             // @deprecated(\"…\"), @json(…), …\n//              | '[' ident ']'                      // prisma-json-types-generator compat alias\n//              | <free text>                        // preserved as documentation\n//\n// Multi-line annotations are supported: if a line opens '(' or '{' and\n// doesn't close it, subsequent lines are concatenated until parens balance.\n// String literals are respected during the depth tracking so a brace inside\n// a string doesn't unbalance the depth.\n\nimport type {\n  AnnotationSet,\n  CoerceTo,\n  JsonAnnotation,\n  NormaliseOp,\n  TypeOverride,\n} from \"../ir/types.js\";\n\nconst VALID_NORMALISE_OPS = new Set<NormaliseOp>([\n  \"trim\",\n  \"lowercase\",\n  \"uppercase\",\n  \"nullEmptyToNull\",\n]);\n\nconst VALID_COERCE_TARGETS = new Set<CoerceTo>([\"date\", \"int\", \"float\", \"decimal\", \"string\"]);\n\n/**\n * Parse a documentation string into an AnnotationSet.\n * Lines that aren't annotations are preserved in `documentation`.\n */\nexport function parseAnnotations(doc: string | null): AnnotationSet {\n  const result: AnnotationSet = {\n    hide: false,\n    deprecated: null,\n    json: null,\n    type: null,\n    name: null,\n    normalise: null,\n    coerce: null,\n    documentation: null,\n    rawAnnotations: [],\n  };\n\n  if (!doc) return result;\n\n  const logicalLines = splitLogicalLines(doc);\n  const docLines: string[] = [];\n  const rawAnnotations: string[] = [];\n\n  for (const line of logicalLines) {\n    const trimmed = line.trim();\n\n    // Shorthand: [TypeName] → @json(TypeName)\n    const bracketMatch = /^\\[(\\w+)\\]$/.exec(trimmed);\n    if (bracketMatch) {\n      result.json = { kind: \"bare\", typeName: bracketMatch[1]! };\n      rawAnnotations.push(trimmed);\n      continue;\n    }\n\n    // @ident or @ident(args)\n    const annotationMatch = /^@(\\w+)(?:\\s*\\(([\\s\\S]*)\\))?$/.exec(trimmed);\n    if (annotationMatch) {\n      applyAnnotation(annotationMatch[1]!, annotationMatch[2] ?? null, result);\n      rawAnnotations.push(trimmed);\n      continue;\n    }\n\n    // Not an annotation — preserve as documentation\n    docLines.push(line);\n  }\n\n  const joinedDoc = docLines.join(\"\\n\").trim();\n  result.documentation = joinedDoc.length > 0 ? joinedDoc : null;\n  result.rawAnnotations = rawAnnotations;\n  return result;\n}\n\n/**\n * Split a multi-line doc string into logical lines, joining continuations\n * where parens or braces remain open. Respects string literals.\n */\nfunction splitLogicalLines(doc: string): string[] {\n  const physical = doc.split(\"\\n\");\n  const logical: string[] = [];\n  let buffer = \"\";\n  let parenDepth = 0;\n  let braceDepth = 0;\n  let bracketDepth = 0;\n  let inString: '\"' | \"'\" | \"`\" | null = null;\n  let isEscaped = false;\n\n  for (const line of physical) {\n    for (const ch of line) {\n      if (isEscaped) {\n        isEscaped = false;\n        continue;\n      }\n      if (ch === \"\\\\\") {\n        isEscaped = true;\n        continue;\n      }\n      if (inString) {\n        if (ch === inString) inString = null;\n        continue;\n      }\n      if (ch === '\"' || ch === \"'\" || ch === \"`\") {\n        inString = ch;\n        continue;\n      }\n      if (ch === \"(\") parenDepth++;\n      else if (ch === \")\") parenDepth--;\n      else if (ch === \"{\") braceDepth++;\n      else if (ch === \"}\") braceDepth--;\n      else if (ch === \"[\") bracketDepth++;\n      else if (ch === \"]\") bracketDepth--;\n    }\n\n    buffer = buffer.length === 0 ? line : `${buffer} ${line.trim()}`;\n\n    if (parenDepth === 0 && braceDepth === 0 && bracketDepth === 0 && inString === null) {\n      logical.push(buffer);\n      buffer = \"\";\n    }\n  }\n\n  if (buffer.length > 0) logical.push(buffer);\n  return logical;\n}\n\nfunction applyAnnotation(name: string, args: string | null, set: AnnotationSet): void {\n  switch (name) {\n    case \"hide\":\n      set.hide = true;\n      return;\n    case \"deprecated\":\n      set.deprecated = { reason: args ? extractStringArg(args) : null };\n      return;\n    case \"json\":\n      set.json = parseJsonArgs(args);\n      return;\n    case \"type\":\n      set.type = parseTypeArgs(args);\n      return;\n    case \"name\":\n      set.name = args ? args.trim() : null;\n      return;\n    case \"normalise\":\n    case \"normalize\":\n      set.normalise = parseNormaliseArgs(args);\n      return;\n    case \"coerce\":\n      set.coerce = parseCoerceArg(args);\n      return;\n    default:\n      // Unknown annotation — already captured in rawAnnotations; ignored otherwise.\n      return;\n  }\n}\n\nfunction parseJsonArgs(args: string | null): JsonAnnotation | null {\n  if (!args) return null;\n  const trimmed = args.trim();\n  if (trimmed.length === 0) return null;\n\n  // Form 2: with-path — `TypeName from \"./path\"`\n  // Check first so the assignment scan below doesn't get confused by paths\n  // containing characters that look operator-like.\n  const pathMatch = /^(\\w+)\\s+from\\s+[\"'](.+)[\"']$/.exec(trimmed);\n  if (pathMatch) {\n    return { kind: \"with-path\", typeName: pathMatch[1]!, importPath: pathMatch[2]! };\n  }\n\n  // Form 4: inline named — `Name = expression`\n  // Locate a top-level `=` that's NOT inside braces/parens/brackets/angles,\n  // NOT inside a string/template-literal, and NOT part of a compound operator\n  // (`==`, `=>`, `!=`, `<=`, `>=`).\n  const eqIndex = findTopLevelAssignment(trimmed);\n  if (eqIndex > 0) {\n    const namePart = trimmed.slice(0, eqIndex).trim();\n    const exprPart = trimmed.slice(eqIndex + 1).trim();\n    if (/^\\w+$/.test(namePart) && exprPart.length > 0) {\n      return { kind: \"inline-named\", typeName: namePart, typeExpression: exprPart };\n    }\n  }\n\n  // Form 1: bare — a single identifier and nothing else.\n  if (/^\\w+$/.test(trimmed)) {\n    return { kind: \"bare\", typeName: trimmed };\n  }\n\n  // Form 3: inline anonymous — anything else with structure.\n  // We don't validate TS syntax; the user's tsc will catch invalid expressions.\n  return { kind: \"inline-anonymous\", typeExpression: trimmed };\n}\n\n/**\n * Find the index of the first top-level `=` character in a TS-type-like\n * expression, or -1 if none exists. Respects:\n *   - depth tracking for `{}`, `()`, `[]`, `<>` (angles treated as generic brackets)\n *   - string and template-literal regions (`\"...\"`, `'...'`, `` `...` ``)\n *   - isEscaped sequences (`\\` skips the next char inside strings)\n *   - compound operators (`==`, `=>`, `!=`, `<=`, `>=`, `===`, `!==`)\n */\nfunction findTopLevelAssignment(s: string): number {\n  let depth = 0;\n  let inString: '\"' | \"'\" | \"`\" | null = null;\n  let isEscaped = false;\n\n  for (let i = 0; i < s.length; i++) {\n    const ch = s[i]!;\n\n    if (isEscaped) {\n      isEscaped = false;\n      continue;\n    }\n    if (ch === \"\\\\\") {\n      isEscaped = true;\n      continue;\n    }\n    if (inString) {\n      if (ch === inString) inString = null;\n      continue;\n    }\n    if (ch === '\"' || ch === \"'\" || ch === \"`\") {\n      inString = ch;\n      continue;\n    }\n    if (ch === \"{\" || ch === \"(\" || ch === \"[\" || ch === \"<\") {\n      depth++;\n      continue;\n    }\n    if (ch === \"}\" || ch === \")\" || ch === \"]\" || ch === \">\") {\n      depth--;\n      continue;\n    }\n    if (ch === \"=\" && depth === 0) {\n      const prev = i > 0 ? s[i - 1] : \"\";\n      const next = i + 1 < s.length ? s[i + 1] : \"\";\n      // Compound operators we should NOT treat as the assignment `=`:\n      //   `==`  `===`  `=>`  `!=`  `!==`  `<=`  `>=`\n      if (next === \"=\" || next === \">\") continue;\n      if (prev === \"=\" || prev === \"!\" || prev === \"<\" || prev === \">\") continue;\n      return i;\n    }\n  }\n  return -1;\n}\n\nfunction parseTypeArgs(args: string | null): TypeOverride | null {\n  if (!args) return null;\n  const trimmed = args.trim();\n\n  const pathMatch = /^(\\w+)\\s+from\\s+[\"'](.+)[\"']$/.exec(trimmed);\n  if (pathMatch) {\n    return { typeName: pathMatch[1]!, importPath: pathMatch[2]! };\n  }\n\n  if (/^\\w+$/.test(trimmed)) {\n    return { typeName: trimmed, importPath: null };\n  }\n\n  return null;\n}\n\nfunction parseNormaliseArgs(args: string | null): readonly NormaliseOp[] | null {\n  if (!args) return null;\n  const ops = args\n    .split(\",\")\n    .map((s) => s.trim())\n    .filter((s) => s.length > 0)\n    .filter((s): s is NormaliseOp => VALID_NORMALISE_OPS.has(s as NormaliseOp));\n  return ops.length > 0 ? ops : null;\n}\n\nfunction parseCoerceArg(args: string | null): CoerceTo | null {\n  if (!args) return null;\n  const trimmed = args.trim();\n  return VALID_COERCE_TARGETS.has(trimmed as CoerceTo) ? (trimmed as CoerceTo) : null;\n}\n\nfunction extractStringArg(args: string): string | null {\n  const trimmed = args.trim();\n  const match = /^[\"'](.*)[\"']$/s.exec(trimmed);\n  return match ? match[1]! : trimmed;\n}\n"],"mappings":"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","names":[]}

package/dist/emitter/emit-enums.d.ts

@@ -0,0 +1,9 @@
+import { GeneratorContext } from '../generator/context.js';
+import './file-writer.js';
+import '../ir/types.js';
+import '../generator/config.js';
+import '../naming/types.js';
+
+declare function emitEnums(ctx: GeneratorContext): Promise<void>;
+
+export { emitEnums };

package/dist/emitter/emit-enums.js

@@ -0,0 +1,19 @@
+import { resolveTypeFilename, resolveTypeIdent } from "../naming/resolver.js";
+import { renderEnum } from "./render-enum.js";
+async function emitEnums(ctx) {
+  for (const enumDef of ctx.ir.enums) {
+    if (enumDef.annotations.hide) continue;
+    const ident = resolveTypeIdent({
+      schemaName: enumDef.name,
+      override: enumDef.annotations.name,
+      convention: ctx.config.naming.typeNaming
+    });
+    const filename = resolveTypeFilename(ident, ctx.config.naming.fileNaming);
+    const content = renderEnum(enumDef, ctx.config.naming);
+    await ctx.writer.write(`enums/${filename}.ts`, content);
+  }
+}
+export {
+  emitEnums
+};
+//# sourceMappingURL=emit-enums.js.map

package/dist/emitter/emit-enums.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/emitter/emit-enums.ts"],"sourcesContent":["// High-level emitter: walks the IR's enums and writes one file per enum.\n// Each pattern's emitter calls `await emitEnums(ctx)` for free standalone\n// enum emission. The directory is fixed at `enums/` for consistency.\n\nimport type { GeneratorContext } from \"../generator/context.js\";\nimport { resolveTypeFilename, resolveTypeIdent } from \"../naming/resolver.js\";\nimport { renderEnum } from \"./render-enum.js\";\n\nexport async function emitEnums(ctx: GeneratorContext): Promise<void> {\n  for (const enumDef of ctx.ir.enums) {\n    if (enumDef.annotations.hide) continue;\n\n    const ident = resolveTypeIdent({\n      schemaName: enumDef.name,\n      override: enumDef.annotations.name,\n      convention: ctx.config.naming.typeNaming,\n    });\n    const filename = resolveTypeFilename(ident, ctx.config.naming.fileNaming);\n\n    const content = renderEnum(enumDef, ctx.config.naming);\n    await ctx.writer.write(`enums/${filename}.ts`, content);\n  }\n}\n"],"mappings":"AAKA,SAAS,qBAAqB,wBAAwB;AACtD,SAAS,kBAAkB;AAE3B,eAAsB,UAAU,KAAsC;AACpE,aAAW,WAAW,IAAI,GAAG,OAAO;AAClC,QAAI,QAAQ,YAAY,KAAM;AAE9B,UAAM,QAAQ,iBAAiB;AAAA,MAC7B,YAAY,QAAQ;AAAA,MACpB,UAAU,QAAQ,YAAY;AAAA,MAC9B,YAAY,IAAI,OAAO,OAAO;AAAA,IAChC,CAAC;AACD,UAAM,WAAW,oBAAoB,OAAO,IAAI,OAAO,OAAO,UAAU;AAExE,UAAM,UAAU,WAAW,SAAS,IAAI,OAAO,MAAM;AACrD,UAAM,IAAI,OAAO,MAAM,SAAS,QAAQ,OAAO,OAAO;AAAA,EACxD;AACF;","names":[]}

package/dist/emitter/emit-json-types.d.ts

@@ -0,0 +1,9 @@
+import { GeneratorContext } from '../generator/context.js';
+import './file-writer.js';
+import '../ir/types.js';
+import '../generator/config.js';
+import '../naming/types.js';
+
+declare function emitJsonTypes(ctx: GeneratorContext): Promise<void>;
+
+export { emitJsonTypes };

package/dist/emitter/emit-json-types.js

@@ -0,0 +1,28 @@
+import { autoNameInlineJson, resolveTypeFilename } from "../naming/resolver.js";
+import { renderJsonType } from "./render-json-type.js";
+async function emitJsonTypes(ctx) {
+  const collected = /* @__PURE__ */ new Map();
+  for (const model of ctx.ir.models) {
+    if (model.annotations.hide) continue;
+    for (const field of model.fields) {
+      if (field.annotations.hide) continue;
+      const json = field.annotations.json;
+      if (!json) continue;
+      if (json.kind === "inline-anonymous") {
+        const name = autoNameInlineJson(model.name, field.name);
+        collected.set(name, json.typeExpression);
+      } else if (json.kind === "inline-named") {
+        collected.set(json.typeName, json.typeExpression);
+      }
+    }
+  }
+  for (const [typeName, expr] of collected) {
+    const filename = resolveTypeFilename(typeName, ctx.config.naming.fileNaming);
+    const content = renderJsonType(typeName, expr);
+    await ctx.writer.write(`json-types/${filename}.ts`, content);
+  }
+}
+export {
+  emitJsonTypes
+};
+//# sourceMappingURL=emit-json-types.js.map

package/dist/emitter/emit-json-types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/emitter/emit-json-types.ts"],"sourcesContent":["// High-level emitter: walks the IR for inline `@json(...)` annotations\n// (forms 3 + 4) and writes one file per generated JSON type.\n//\n// Bare and with-path `@json` forms reference an existing user type — no\n// file emission for those. Inline forms (anonymous and named) generate\n// a type alias file under `json-types/`.\n\nimport type { GeneratorContext } from \"../generator/context.js\";\nimport { autoNameInlineJson, resolveTypeFilename } from \"../naming/resolver.js\";\nimport { renderJsonType } from \"./render-json-type.js\";\n\nexport async function emitJsonTypes(ctx: GeneratorContext): Promise<void> {\n  const collected = new Map<string, string>();\n\n  for (const model of ctx.ir.models) {\n    if (model.annotations.hide) continue;\n    for (const field of model.fields) {\n      if (field.annotations.hide) continue;\n      const json = field.annotations.json;\n      if (!json) continue;\n\n      if (json.kind === \"inline-anonymous\") {\n        const name = autoNameInlineJson(model.name, field.name);\n        collected.set(name, json.typeExpression);\n      } else if (json.kind === \"inline-named\") {\n        collected.set(json.typeName, json.typeExpression);\n      }\n      // bare + with-path reference existing user types — no file to emit\n    }\n  }\n\n  for (const [typeName, expr] of collected) {\n    const filename = resolveTypeFilename(typeName, ctx.config.naming.fileNaming);\n    const content = renderJsonType(typeName, expr);\n    await ctx.writer.write(`json-types/${filename}.ts`, content);\n  }\n}\n"],"mappings":"AAQA,SAAS,oBAAoB,2BAA2B;AACxD,SAAS,sBAAsB;AAE/B,eAAsB,cAAc,KAAsC;AACxE,QAAM,YAAY,oBAAI,IAAoB;AAE1C,aAAW,SAAS,IAAI,GAAG,QAAQ;AACjC,QAAI,MAAM,YAAY,KAAM;AAC5B,eAAW,SAAS,MAAM,QAAQ;AAChC,UAAI,MAAM,YAAY,KAAM;AAC5B,YAAM,OAAO,MAAM,YAAY;AAC/B,UAAI,CAAC,KAAM;AAEX,UAAI,KAAK,SAAS,oBAAoB;AACpC,cAAM,OAAO,mBAAmB,MAAM,MAAM,MAAM,IAAI;AACtD,kBAAU,IAAI,MAAM,KAAK,cAAc;AAAA,MACzC,WAAW,KAAK,SAAS,gBAAgB;AACvC,kBAAU,IAAI,KAAK,UAAU,KAAK,cAAc;AAAA,MAClD;AAAA,IAEF;AAAA,EACF;AAEA,aAAW,CAAC,UAAU,IAAI,KAAK,WAAW;AACxC,UAAM,WAAW,oBAAoB,UAAU,IAAI,OAAO,OAAO,UAAU;AAC3E,UAAM,UAAU,eAAe,UAAU,IAAI;AAC7C,UAAM,IAAI,OAAO,MAAM,cAAc,QAAQ,OAAO,OAAO;AAAA,EAC7D;AACF;","names":[]}

package/dist/emitter/file-writer.d.ts

@@ -0,0 +1,12 @@
+interface FileWriter {
+    /** Write `content` to `relativePath` (relative to the writer's output dir). */
+    write(relativePath: string, content: string): Promise<void>;
+}
+declare function createFileWriter(outputDir: string): FileWriter;
+/** In-memory writer for tests. Captures file paths and contents. */
+interface InMemoryFileWriter extends FileWriter {
+    readonly files: ReadonlyMap<string, string>;
+}
+declare function createInMemoryFileWriter(): InMemoryFileWriter;
+
+export { type FileWriter, type InMemoryFileWriter, createFileWriter, createInMemoryFileWriter };

package/dist/emitter/file-writer.js

@@ -0,0 +1,25 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+function createFileWriter(outputDir) {
+  return {
+    async write(relativePath, content) {
+      const fullPath = resolve(outputDir, relativePath);
+      await mkdir(dirname(fullPath), { recursive: true });
+      await writeFile(fullPath, content, "utf8");
+    }
+  };
+}
+function createInMemoryFileWriter() {
+  const files = /* @__PURE__ */ new Map();
+  return {
+    files,
+    async write(relativePath, content) {
+      files.set(relativePath, content);
+    }
+  };
+}
+export {
+  createFileWriter,
+  createInMemoryFileWriter
+};
+//# sourceMappingURL=file-writer.js.map

package/dist/emitter/file-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/emitter/file-writer.ts"],"sourcesContent":["// File output abstraction used by all pattern emitters.\n// The actual implementation writes to disk; tests can substitute an\n// in-memory writer that captures emitted files for snapshotting.\n\nimport { mkdir, writeFile } from \"node:fs/promises\";\nimport { dirname, resolve } from \"node:path\";\n\nexport interface FileWriter {\n  /** Write `content` to `relativePath` (relative to the writer's output dir). */\n  write(relativePath: string, content: string): Promise<void>;\n}\n\nexport function createFileWriter(outputDir: string): FileWriter {\n  return {\n    async write(relativePath: string, content: string): Promise<void> {\n      const fullPath = resolve(outputDir, relativePath);\n      await mkdir(dirname(fullPath), { recursive: true });\n      await writeFile(fullPath, content, \"utf8\");\n    },\n  };\n}\n\n/** In-memory writer for tests. Captures file paths and contents. */\nexport interface InMemoryFileWriter extends FileWriter {\n  readonly files: ReadonlyMap<string, string>;\n}\n\nexport function createInMemoryFileWriter(): InMemoryFileWriter {\n  const files = new Map<string, string>();\n  return {\n    files,\n    async write(relativePath: string, content: string): Promise<void> {\n      files.set(relativePath, content);\n    },\n  };\n}\n"],"mappings":"AAIA,SAAS,OAAO,iBAAiB;AACjC,SAAS,SAAS,eAAe;AAO1B,SAAS,iBAAiB,WAA+B;AAC9D,SAAO;AAAA,IACL,MAAM,MAAM,cAAsB,SAAgC;AAChE,YAAM,WAAW,QAAQ,WAAW,YAAY;AAChD,YAAM,MAAM,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;AAClD,YAAM,UAAU,UAAU,SAAS,MAAM;AAAA,IAC3C;AAAA,EACF;AACF;AAOO,SAAS,2BAA+C;AAC7D,QAAM,QAAQ,oBAAI,IAAoB;AACtC,SAAO;AAAA,IACL;AAAA,IACA,MAAM,MAAM,cAAsB,SAAgC;AAChE,YAAM,IAAI,cAAc,OAAO;AAAA,IACjC;AAAA,EACF;AACF;","names":[]}

package/dist/emitter/format-type.d.ts

@@ -0,0 +1,3 @@
+declare function prettyFormatType(expr: string): string;
+
+export { prettyFormatType };