@adhd/apigen-engine-naming 0.2.2 → 0.2.4

package/CHANGELOG.md

@@ -1,3 +1,25 @@
+## 0.2.4 (2026-09-26)
+
+### 🚀 Features
+
+- **vite-plugins:** absorb perf/test-resolve-fix — test-time @adhd/* source resolution ([3e344506](https://github.com/PseudoSky/adhd/commit/3e344506))
+
+### 🩹 Fixes
+
+- **apigen-engine-naming:** close review doc/lint residuals ([c7c9fd45](https://github.com/PseudoSky/adhd/commit/c7c9fd45))
+- **apigen:** close codegen-injection review residuals (cd9a5d6c) ([9acbe746](https://github.com/PseudoSky/adhd/commit/9acbe746))
+- **apigen:** harden fastify/express codegen against injection (ff1b22ad, 61ecfab8) ([de2a5948](https://github.com/PseudoSky/adhd/commit/de2a5948))
+- **vite:** restore import.meta.url in CJS output under vite 8 ([7916e639](https://github.com/PseudoSky/adhd/commit/7916e639))
+- **nx:** finish the ESLint v9 flat-config migration and unblock the gate ([53f4ff3e](https://github.com/PseudoSky/adhd/commit/53f4ff3e))
+
+### ❤️ Thank You
+
+- pseudosky
+
+## 0.2.3 (2026-09-24)
+
+This was a version bump only for apigen-engine-naming to align it with other projects, there were no code changes.
+
 ## 0.2.2 (2026-08-07)
 
 

package/README.md

@@ -9,10 +9,30 @@ Part of [apigen](../README.md).
 ## Public API
 
 ```ts
-import { toKebab, toCamel, toPascal, toSnake, normalizeFileName, project, checkCollisions, CollisionDetectedError, envelopeKey, envelopeCliFlag, envelopeEnvVar, envelopeMetaKey } from '@adhd/apigen-engine-naming';
+import {
+  toKebab, toCamel, toPascal, toSnake, normalizeFileName,
+  project, httpVerb, checkCollisions, CollisionDetectedError,
+  envelopeKey, envelopeCliFlag, envelopeEnvVar, envelopeMetaKey,
+  sanitizeIdentifier, uniqueSanitizedIdentifiers,
+  escapeStringLiteral, escapeLineTerminators, toPosixPath, coercePort,
+} from '@adhd/apigen-engine-naming';
 ```
 
 - **case helpers** — `toKebab` / `toCamel` / `toPascal` / `toSnake`, `normalizeFileName`.
 - **`project(...)`** — derive the namespace/id for a source.
+- **`httpVerb(...)`** — resolve the effective HTTP verb for a composed schema.
 - **`checkCollisions(...)`** — detect duplicate export ids (throws `CollisionDetectedError`).
 - **envelope keys** — map an envelope field to its CLI flag / env var / MCP `_meta` key.
+- **codegen emit primitives** (the single, context-correct surface every generator splices a
+  dynamic value through — see `src/lib/emit.ts`):
+  - `sanitizeIdentifier(id)` — a discovered id → a valid identifier.
+  - `uniqueSanitizedIdentifiers(ids)` — a collision-free **set** of identifiers (a lossy
+    sanitisation can map distinct ids to the same name; this disambiguates with a stable
+    `_2`, `_3`, … suffix so generated `import * as …_ns` declarations never collide).
+  - `escapeStringLiteral(value)` — a complete, quoted JS/TS string literal (escapes quotes,
+    backslashes, control chars, and `U+2028`/`U+2029`).
+  - `escapeLineTerminators(text)` — the `U+2028`/`U+2029` escape applied to an already-
+    serialized blob (e.g. a `JSON.stringify`'d schema map) before it is spliced.
+  - `toPosixPath(p)` — normalise a path to `/` separators.
+  - `coercePort(value)` — a caller-supplied `port` option → a validated integer literal
+    (rejects blank/non-numeric/out-of-range values instead of splicing them).

package/index.d.ts

@@ -1,2 +1,3 @@
-export { toKebab, toCamel, toPascal, toSnake, normalizeFileName, project, httpVerb, checkCollisions, CollisionDetectedError, envelopeKey, envelopeCliFlag, envelopeEnvVar, envelopeMetaKey, sanitizeIdentifier, } from './lib/naming';
+export { toKebab, toCamel, toPascal, toSnake, normalizeFileName, project, httpVerb, checkCollisions, CollisionDetectedError, envelopeKey, envelopeCliFlag, envelopeEnvVar, envelopeMetaKey, sanitizeIdentifier, uniqueSanitizedIdentifiers, } from './lib/naming';
+export { escapeLineTerminators, escapeStringLiteral, toPosixPath, coercePort, } from './lib/emit';
 export type { TransportProjection, HttpVerb, ProjectionConfig, CollisionError, } from './lib/naming';

package/index.js

@@ -1,3 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("ts-morph");require("node:fs");require("node:path");require("ts-json-schema-generator");const y=new Set(["string","number","boolean","integer"]);function P(e){if(typeof e!="object"||e===null)return!1;const t=e;if(t.$ref!==void 0||t.oneOf||t.anyOf||t.allOf)return!1;const{type:n}=t;return typeof n=="string"?y.has(n):Array.isArray(n)?n.every(r=>y.has(r)||r==="null"):Array.isArray(t.enum)&&t.enum.length>0?t.enum.every(r=>["string","number","boolean"].includes(typeof r)):!1}function C(e){if(!e||typeof e!="object")return!1;const t=e.properties;return t===void 0||typeof t!="object"||t===null?!1:Object.values(t).every(P)}const x={"decimal.js":"Decimal"};function _(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}Object.entries(x).map(([e,t])=>({pattern:new RegExp(`import\\(["'][^"']*${_(e)}[^"']*["']\\)\\.\\w+`,"g"),key:t}));function h(e){return e.words.join("-")}function k(e){return e.words.map((t,n)=>n===0?t:E(t)).join("")}function v(e){return e.words.map(E).join("")}function $(e){return e.words.join("_")}function w(e){return e.replace(/\.[^.]+$/,"").replace(/[._]+/g,"-")}function b(e,t={}){var l,u;const n=[e.namespace,...e.path],r=e.safe||C(e.input)?"GET":"POST",a=((u=(l=t.http)==null?void 0:l.verb)==null?void 0:u[e.id])??r,p="/"+n.map(s=>h(s)).join("/"),c=n.map(s=>$(s)).join("_"),i=n.map(s=>$(s)).slice(0,-1).join("."),g=v(n[n.length-2]??n[0]),f=v(n[n.length-1]),d=n.map(s=>h(s));return{http:{verb:a,route:p},mcp:{name:c},grpc:{package:i,service:g,method:f},cli:{path:d}}}function K(e,t,n){var a,p;const r=(p=(a=n.http)==null?void 0:a.verb)==null?void 0:p[e];return r==="GET"||r==="POST"?r:t["x-apigen-safe"]?"GET":"POST"}class j extends Error{constructor(t){const n=t.map(r=>`  [${r.transport}] "${r.target}" ← ${r.ids[0]} vs ${r.ids[1]}`);super(`apigen-naming: ${t.length} projection collision(s) detected:
-${n.join(`
-`)}`),this.name="CollisionDetectedError",this.collisions=t}}function M(e,t={}){const n=new Map,r=new Map,a=new Map,p=new Map,c=[];for(const o of e){const i=b(o,t),g=`${i.http.verb} ${i.http.route}`,f=n.get(g);f!==void 0&&f!==o.id?c.push({transport:"http",target:g,ids:[f,o.id]}):n.set(g,o.id);const d=r.get(i.mcp.name);d!==void 0&&d!==o.id?c.push({transport:"mcp",target:i.mcp.name,ids:[d,o.id]}):r.set(i.mcp.name,o.id);const l=`${i.grpc.package}.${i.grpc.service}/${i.grpc.method}`,u=a.get(l);u!==void 0&&u!==o.id?c.push({transport:"grpc",target:l,ids:[u,o.id]}):a.set(l,o.id);const s=i.cli.path.join(" "),m=p.get(s);m!==void 0&&m!==o.id?c.push({transport:"cli",target:s,ids:[m,o.id]}):p.set(s,o.id)}if(c.length>0)throw new j(c)}function S(e,t){return`x-${e}-${t}`}function O(e,t){return`--${e}-${t}`}function z(e,t){const n=r=>r.toUpperCase().replace(/-/g,"_");return e==="adhd"?`APIGEN_${n(t)}`:`APIGEN_${n(e)}_${n(t)}`}const A=S;function T(e){let t=e.replace(/[^a-zA-Z0-9_$]/g,"_");return(t===""||/^[0-9]/.test(t))&&(t=`_${t}`),t}function E(e){return e.length===0?e:e[0].toUpperCase()+e.slice(1)}exports.CollisionDetectedError=j;exports.checkCollisions=M;exports.envelopeCliFlag=O;exports.envelopeEnvVar=z;exports.envelopeKey=S;exports.envelopeMetaKey=A;exports.httpVerb=K;exports.normalizeFileName=w;exports.project=b;exports.sanitizeIdentifier=T;exports.toCamel=k;exports.toKebab=h;exports.toPascal=v;exports.toSnake=$;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require("node:fs");let e=require("node:module");require("node:path"),(0,e.createRequire)(require("node:url").pathToFileURL(__filename).href);var t={id:`date-time`,kind:`scalar`,schema:{type:`string`,format:`date-time`},matches(e){return e.type===`string`&&e.format===`date-time`},ownsValue(e){return e instanceof Date},encode(e,t,n){return e.toISOString()},decode(e,t,n){if(typeof e!=`string`){if(n.mode===`strict`)throw TypeError(`[date-time] expected a string on the wire at "${n.path}", got ${typeof e}`);return new Date(String(e))}if(n.mode===`strict`&&Number.isNaN(new Date(e).getTime()))throw TypeError(`[date-time] invalid date-time string at "${n.path}": ${JSON.stringify(e)}`);return new Date(e)}},n={id:`int64`,kind:`scalar`,schema:{type:`string`,format:`int64`},matches(e){return e.type===`string`&&e.format===`int64`},ownsValue(e){return typeof e==`bigint`},encode(e,t,n){return String(e)},decode(e,t,n){if(typeof e!=`string`){if(n.mode===`strict`)throw TypeError(`[int64] expected a string on the wire at "${n.path}", got ${typeof e}`);try{return BigInt(Math.trunc(Number(e)))}catch{return BigInt(0)}}if(n.mode===`strict`)return BigInt(e);if(/^-?\d+$/.test(e))try{return BigInt(e)}catch{return BigInt(0)}return BigInt(0)}};function r(e){return e}var i={id:`decimal`,kind:`scalar`,schema:{type:`string`,format:`decimal`},matches(e){return e.type===`string`&&e.format===`decimal`},encode(e,t,n){return e},decode(e,t,n){if(typeof e!=`string`){if(n.mode===`strict`)throw TypeError(`[decimal] expected a string on the wire at "${n.path}", got ${typeof e}`);return r(String(e))}if(n.mode===`strict`&&!/^-?\d+(\.\d+)?$/.test(e))throw TypeError(`[decimal] wire value "${e}" at "${n.path}" is not a valid decimal string`);return r(e)}},a={id:`byte`,kind:`scalar`,schema:{type:`string`,format:`byte`},matches(e){return e.type===`string`&&e.format===`byte`},ownsValue(e){return e instanceof Uint8Array},encode(e,t,n){return Buffer.from(e).toString(`base64`)},decode(e,t,n){if(typeof e!=`string`){if(n.mode===`strict`)throw TypeError(`[byte] expected a base64 string on the wire at "${n.path}", got ${typeof e}`);return new Uint8Array}if(n.mode===`strict`&&!/^[A-Za-z0-9+/]*={0,2}$/.test(e))throw TypeError(`[byte] wire value at "${n.path}" is not standard base64 (format:byte): "${e}"`);return new Uint8Array(Buffer.from(e,`base64`))}},o=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/,s={id:`uuid`,kind:`scalar`,schema:{type:`string`,format:`uuid`},matches(e){return e.type===`string`&&e.format===`uuid`},encode(e,t,n){return e.toLowerCase()},decode(e,t,n){if(typeof e!=`string`){if(n.mode===`strict`)throw TypeError(`[uuid] expected a string on the wire at "${n.path}", got ${typeof e}`);return String(e).toLowerCase()}if(n.mode===`strict`&&!o.test(e))throw TypeError(`[uuid] wire value "${e}" at "${n.path}" is not a lowercase-hyphenated RFC 4122 UUID`);return e}},c=`NaN`,l=`Infinity`,u=`-Infinity`,d=new Set([c,l,u]);t.id,n.id,i.id,a.id,s.id,{id:`number-special`,kind:`scalar`,schema:{type:`number`},matches(e){return e.type===`number`&&e.format===void 0},ownsValue(e){return typeof e==`number`&&!Number.isFinite(e)},encode(e,t,n){return Number.isNaN(e)?c:e===1/0?l:e===-1/0?u:e},decode(e,t,n){if(typeof e==`number`)return e;if(typeof e==`string`){if(e===c)return NaN;if(e===l)return 1/0;if(e===u)return-1/0;let t=Number(e);if(!Number.isNaN(t))return t}if(n.mode===`strict`)throw TypeError(`[number-special] unrecognized wire value at "${n.path}": ${JSON.stringify(e)}. Expected a number or one of ${[...d].join(`, `)}.`);return NaN}}.id,Object.freeze({typescript:{"date-time":{encode:`$.toISOString()`,decode:`new Date($)`,mode:`native`},int64:{encode:`String($)`,decode:`BigInt($)`,mode:`native`},decimal:{encode:`$.toString()`,decode:`new Decimal($)`,imports:[],dep:{name:`decimal.js`,version:`^10`},mode:`branded`},byte:{encode:`Buffer.from($).toString('base64')`,decode:`new Uint8Array(Buffer.from($, 'base64'))`,mode:`native`},uuid:{encode:`$.toLowerCase()`,decode:`$`,mode:`native`},"number-special":{encode:`numToWire($)`,decode:`wireToNum($)`,mode:`native`}},python:{"date-time":{encode:`$.isoformat()`,decode:`datetime.fromisoformat($)`,imports:[`from datetime import datetime`],mode:`native`},int64:{encode:`str($)`,decode:`int($)`,mode:`native`},decimal:{encode:`str($)`,decode:`Decimal($)`,imports:[`from decimal import Decimal`],mode:`native`},byte:{encode:`b64encode($).decode()`,decode:`b64decode($)`,imports:[`from base64 import b64encode, b64decode`],mode:`native`},uuid:{encode:`str($)`,decode:`UUID($)`,imports:[`from uuid import UUID`],mode:`native`},"number-special":{encode:`num_to_wire($)`,decode:`wire_to_num($)`,mode:`native`}},rust:{"date-time":{encode:`__SCAFFOLD_RUST_DATETIME_ENCODE__`,decode:`__SCAFFOLD_RUST_DATETIME_DECODE__`,imports:[`use chrono::{DateTime, Utc};`],dep:{name:`chrono`,version:`^0.4`},mode:`lib`},int64:{encode:`__SCAFFOLD_RUST_INT64_ENCODE__`,decode:`__SCAFFOLD_RUST_INT64_DECODE__`,imports:[`use serde_with::DisplayFromStr;`],dep:{name:`serde_with`,version:`^3`},mode:`lib`},decimal:{encode:`__SCAFFOLD_RUST_DECIMAL_ENCODE__`,decode:`__SCAFFOLD_RUST_DECIMAL_DECODE__`,imports:[`use rust_decimal::Decimal;`],dep:{name:`rust_decimal`,version:`^1`},mode:`lib`},byte:{encode:`__SCAFFOLD_RUST_BYTE_ENCODE__`,decode:`__SCAFFOLD_RUST_BYTE_DECODE__`,imports:[`use serde_with::base64::Base64;`],dep:{name:`serde_with`,version:`^3`},mode:`lib`},uuid:{encode:`__SCAFFOLD_RUST_UUID_ENCODE__`,decode:`__SCAFFOLD_RUST_UUID_DECODE__`,imports:[`use uuid::Uuid;`],dep:{name:`uuid`,version:`^1`},mode:`lib`},"number-special":{encode:`__SCAFFOLD_RUST_NUMSPECIAL_ENCODE__`,decode:`__SCAFFOLD_RUST_NUMSPECIAL_DECODE__`,mode:`native`}},go:{"date-time":{encode:`__SCAFFOLD_GO_DATETIME_ENCODE__`,decode:`__SCAFFOLD_GO_DATETIME_DECODE__`,imports:[`"time"`],mode:`native`},int64:{encode:`__SCAFFOLD_GO_INT64_ENCODE__`,decode:`__SCAFFOLD_GO_INT64_DECODE__`,imports:[`"strconv"`],mode:`native`},decimal:{encode:`__SCAFFOLD_GO_DECIMAL_ENCODE__`,decode:`__SCAFFOLD_GO_DECIMAL_DECODE__`,imports:[`"github.com/shopspring/decimal"`],dep:{name:`github.com/shopspring/decimal`,version:`v1`},mode:`lib`},byte:{encode:`__SCAFFOLD_GO_BYTE_ENCODE__`,decode:`__SCAFFOLD_GO_BYTE_DECODE__`,imports:[`"encoding/base64"`],mode:`native`},uuid:{encode:`__SCAFFOLD_GO_UUID_ENCODE__`,decode:`__SCAFFOLD_GO_UUID_DECODE__`,imports:[`"github.com/google/uuid"`],dep:{name:`github.com/google/uuid`,version:`v1`},mode:`lib`},"number-special":{encode:`__SCAFFOLD_GO_NUMSPECIAL_ENCODE__`,decode:`__SCAFFOLD_GO_NUMSPECIAL_DECODE__`,mode:`native`}},java:{"date-time":{encode:`$.toString()`,decode:`Instant.parse($)`,imports:[`import java.time.Instant;`],dep:{name:`jackson-datatype-jsr310`,version:`2.x`},mode:`lib`},int64:{encode:`@JsonFormat(shape = JsonFormat.Shape.STRING)`,decode:`@JsonFormat(shape = JsonFormat.Shape.STRING)`,imports:[`import com.fasterxml.jackson.annotation.JsonFormat;`],mode:`native`},decimal:{encode:`@JsonSerialize(using = ToStringSerializer.class)`,decode:`new BigDecimal($)`,imports:[`import java.math.BigDecimal;`,`import com.fasterxml.jackson.databind.annotation.JsonSerialize;`,`import com.fasterxml.jackson.databind.ser.std.ToStringSerializer;`],mode:`native`},byte:{encode:`$`,decode:`$`,mode:`native`},uuid:{encode:`$.toString()`,decode:`UUID.fromString($)`,imports:[`import java.util.UUID;`],mode:`native`},"number-special":{encode:`@JsonSerialize(using = NumberSpecialSerializer.class)`,decode:`@JsonDeserialize(using = NumberSpecialDeserializer.class)`,imports:[`import com.fasterxml.jackson.databind.annotation.JsonSerialize;`,`import com.fasterxml.jackson.databind.annotation.JsonDeserialize;`],mode:`native`}}});var f=new Set([`string`,`number`,`boolean`,`integer`]);function p(e){if(typeof e!=`object`||!e)return!1;let t=e;if(t.$ref!==void 0||t.oneOf||t.anyOf||t.allOf)return!1;let{type:n}=t;return typeof n==`string`?f.has(n):Array.isArray(n)?n.every(e=>f.has(e)||e===`null`):Array.isArray(t.enum)&&t.enum.length>0?t.enum.every(e=>[`string`,`number`,`boolean`].includes(typeof e)):!1}function m(e){if(!e||typeof e!=`object`)return!1;let t=e.properties;return t===void 0||typeof t!=`object`||!t?!1:Object.values(t).every(p)}var h={"decimal.js":`Decimal`};function g(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}Object.entries(h).map(([e,t])=>({pattern:RegExp(`import\\(["'][^"']*${g(e)}[^"']*["']\\)\\.\\w+`,`g`),key:t}));function _(e){return e.words.join(`-`)}function v(e){return e.words.map((e,t)=>t===0?e:M(e)).join(``)}function y(e){return e.words.map(M).join(``)}function b(e){return e.words.join(`_`)}function x(e){return e.replace(/\.[^.]+$/,``).replace(/[._]+/g,`-`)}function S(e,t={}){let n=[e.namespace,...e.path],r=e.safe||m(e.input)?`GET`:`POST`,i=t.http?.verb?.[e.id]??r,a=`/`+n.map(e=>_(e)).join(`/`),o=n.map(e=>b(e)).join(`_`),s=n.map(e=>b(e)).slice(0,-1).join(`.`),c=y(n[n.length-2]??n[0]),l=y(n[n.length-1]),u=n.map(e=>_(e));return{http:{verb:i,route:a},mcp:{name:o},grpc:{package:s,service:c,method:l},cli:{path:u}}}function C(e,t,n){let r=n.http?.verb?.[e];return r===`GET`||r===`POST`?r:t[`x-apigen-safe`]?`GET`:`POST`}var w=class extends Error{constructor(e){let t=e.map(e=>`  [${e.transport}] "${e.target}" ← ${e.ids[0]} vs ${e.ids[1]}`);super(`apigen-naming: ${e.length} projection collision(s) detected:\n${t.join(`
+`)}`),this.name=`CollisionDetectedError`,this.collisions=e}};function T(e,t={}){let n=new Map,r=new Map,i=new Map,a=new Map,o=[];for(let s of e){let e=S(s,t),c=`${e.http.verb} ${e.http.route}`,l=n.get(c);l!==void 0&&l!==s.id?o.push({transport:`http`,target:c,ids:[l,s.id]}):n.set(c,s.id);let u=r.get(e.mcp.name);u!==void 0&&u!==s.id?o.push({transport:`mcp`,target:e.mcp.name,ids:[u,s.id]}):r.set(e.mcp.name,s.id);let d=`${e.grpc.package}.${e.grpc.service}/${e.grpc.method}`,f=i.get(d);f!==void 0&&f!==s.id?o.push({transport:`grpc`,target:d,ids:[f,s.id]}):i.set(d,s.id);let p=e.cli.path.join(` `),m=a.get(p);m!==void 0&&m!==s.id?o.push({transport:`cli`,target:p,ids:[m,s.id]}):a.set(p,s.id)}if(o.length>0)throw new w(o)}function E(e,t){return`x-${e}-${t}`}function D(e,t){return`--${e}-${t}`}function O(e,t){let n=e=>e.toUpperCase().replace(/-/g,`_`);return e===`adhd`?`APIGEN_${n(t)}`:`APIGEN_${n(e)}_${n(t)}`}var k=E;function A(e){let t=e.replace(/[^a-zA-Z0-9_$]/g,`_`);return(t===``||/^[0-9]/.test(t))&&(t=`_${t}`),t}function j(e){let t=new Set,n=[];for(let r of e){let e=A(r),i=e,a=2;for(;t.has(i);)i=`${e}_${a}`,a+=1;t.add(i),n.push(i)}return n}function M(e){return e.length===0?e:e[0].toUpperCase()+e.slice(1)}function N(e){return e.replace(/\u2028/g,`\\u2028`).replace(/\u2029/g,`\\u2029`)}function P(e){return N(JSON.stringify(e))}function F(e,t=3e3){if(e==null)return t;if(typeof e!=`string`&&typeof e!=`number`||typeof e==`string`&&e.trim()===``)throw TypeError(`apigen: invalid port option ${JSON.stringify(e)} — expected an integer in [0, 65535]`);let n=Number(e);if(!Number.isInteger(n)||n<0||n>65535)throw TypeError(`apigen: invalid port option ${JSON.stringify(e)} — expected an integer in [0, 65535]`);return n}function I(e){return e.replace(/\\/g,`/`)}exports.CollisionDetectedError=w,exports.checkCollisions=T,exports.coercePort=F,exports.envelopeCliFlag=D,exports.envelopeEnvVar=O,exports.envelopeKey=E,exports.envelopeMetaKey=k,exports.escapeLineTerminators=N,exports.escapeStringLiteral=P,exports.httpVerb=C,exports.normalizeFileName=x,exports.project=S,exports.sanitizeIdentifier=A,exports.toCamel=v,exports.toKebab=_,exports.toPascal=y,exports.toPosixPath=I,exports.toSnake=b,exports.uniqueSanitizedIdentifiers=j;

package/index.mjs

@@ -1,148 +1,541 @@
-import "ts-morph";
 import "node:fs";
+import { createRequire as e } from "node:module";
 import "node:path";
-import "ts-json-schema-generator";
-const h = /* @__PURE__ */ new Set(["string", "number", "boolean", "integer"]);
-function j(e) {
-  if (typeof e != "object" || e === null)
-    return !1;
-  const t = e;
-  if (t.$ref !== void 0 || t.oneOf || t.anyOf || t.allOf)
-    return !1;
-  const { type: n } = t;
-  return typeof n == "string" ? h.has(n) : Array.isArray(n) ? n.every((r) => h.has(r) || r === "null") : Array.isArray(t.enum) && t.enum.length > 0 ? t.enum.every((r) => ["string", "number", "boolean"].includes(typeof r)) : !1;
-}
-function E(e) {
-  if (!e || typeof e != "object")
-    return !1;
-  const t = e.properties;
-  return t === void 0 || typeof t != "object" || t === null ? !1 : Object.values(t).every(
-    j
-  );
-}
-const S = {
-  "decimal.js": "Decimal"
+e(import.meta.url);
+//#endregion
+//#region ../apigen-base-logical/src/lib/codecs/date-time.ts
+var t = {
+	id: "date-time",
+	kind: "scalar",
+	schema: {
+		type: "string",
+		format: "date-time"
+	},
+	matches(e) {
+		return e.type === "string" && e.format === "date-time";
+	},
+	ownsValue(e) {
+		return e instanceof Date;
+	},
+	encode(e, t, n) {
+		return e.toISOString();
+	},
+	decode(e, t, n) {
+		if (typeof e != "string") {
+			if (n.mode === "strict") throw TypeError(`[date-time] expected a string on the wire at "${n.path}", got ${typeof e}`);
+			return new Date(String(e));
+		}
+		if (n.mode === "strict" && Number.isNaN(new Date(e).getTime())) throw TypeError(`[date-time] invalid date-time string at "${n.path}": ${JSON.stringify(e)}`);
+		return new Date(e);
+	}
+}, n = {
+	id: "int64",
+	kind: "scalar",
+	schema: {
+		type: "string",
+		format: "int64"
+	},
+	matches(e) {
+		return e.type === "string" && e.format === "int64";
+	},
+	ownsValue(e) {
+		return typeof e == "bigint";
+	},
+	encode(e, t, n) {
+		return String(e);
+	},
+	decode(e, t, n) {
+		if (typeof e != "string") {
+			if (n.mode === "strict") throw TypeError(`[int64] expected a string on the wire at "${n.path}", got ${typeof e}`);
+			try {
+				return BigInt(Math.trunc(Number(e)));
+			} catch {
+				return BigInt(0);
+			}
+		}
+		if (n.mode === "strict") return BigInt(e);
+		if (/^-?\d+$/.test(e)) try {
+			return BigInt(e);
+		} catch {
+			return BigInt(0);
+		}
+		return BigInt(0);
+	}
 };
-function x(e) {
-  return e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-Object.entries(S).map(([e, t]) => ({
-  // Matches: import("...{modSpec}...").<anyMemberName>  (single or double quotes)
-  // The module specifier appears inside an absolute path, so we allow any
-  // characters between the quote and the specifier, and between the specifier
-  // and the closing quote. The trailing member accessor (`.default`, `.Decimal`,
-  // …) is matched generically (`\w+`) rather than anchored to one spelling —
-  // see the doc comment above for why.
-  pattern: new RegExp(
-    `import\\(["'][^"']*${x(e)}[^"']*["']\\)\\.\\w+`,
-    "g"
-  ),
-  key: t
-}));
-function $(e) {
-  return e.words.join("-");
+//#endregion
+//#region ../apigen-base-logical/src/lib/codecs/decimal.ts
+function r(e) {
+	return e;
 }
-function M(e) {
-  return e.words.map((t, n) => n === 0 ? t : b(t)).join("");
+var i = {
+	id: "decimal",
+	kind: "scalar",
+	schema: {
+		type: "string",
+		format: "decimal"
+	},
+	matches(e) {
+		return e.type === "string" && e.format === "decimal";
+	},
+	encode(e, t, n) {
+		return e;
+	},
+	decode(e, t, n) {
+		if (typeof e != "string") {
+			if (n.mode === "strict") throw TypeError(`[decimal] expected a string on the wire at "${n.path}", got ${typeof e}`);
+			return r(String(e));
+		}
+		if (n.mode === "strict" && !/^-?\d+(\.\d+)?$/.test(e)) throw TypeError(`[decimal] wire value "${e}" at "${n.path}" is not a valid decimal string`);
+		return r(e);
+	}
+}, a = {
+	id: "byte",
+	kind: "scalar",
+	schema: {
+		type: "string",
+		format: "byte"
+	},
+	matches(e) {
+		return e.type === "string" && e.format === "byte";
+	},
+	ownsValue(e) {
+		return e instanceof Uint8Array;
+	},
+	encode(e, t, n) {
+		return Buffer.from(e).toString("base64");
+	},
+	decode(e, t, n) {
+		if (typeof e != "string") {
+			if (n.mode === "strict") throw TypeError(`[byte] expected a base64 string on the wire at "${n.path}", got ${typeof e}`);
+			return /* @__PURE__ */ new Uint8Array();
+		}
+		if (n.mode === "strict" && !/^[A-Za-z0-9+/]*={0,2}$/.test(e)) throw TypeError(`[byte] wire value at "${n.path}" is not standard base64 (format:byte): "${e}"`);
+		return new Uint8Array(Buffer.from(e, "base64"));
+	}
+}, o = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/, s = {
+	id: "uuid",
+	kind: "scalar",
+	schema: {
+		type: "string",
+		format: "uuid"
+	},
+	matches(e) {
+		return e.type === "string" && e.format === "uuid";
+	},
+	encode(e, t, n) {
+		return e.toLowerCase();
+	},
+	decode(e, t, n) {
+		if (typeof e != "string") {
+			if (n.mode === "strict") throw TypeError(`[uuid] expected a string on the wire at "${n.path}", got ${typeof e}`);
+			return String(e).toLowerCase();
+		}
+		if (n.mode === "strict" && !o.test(e)) throw TypeError(`[uuid] wire value "${e}" at "${n.path}" is not a lowercase-hyphenated RFC 4122 UUID`);
+		return e;
+	}
+}, c = "NaN", l = "Infinity", u = "-Infinity", d = /* @__PURE__ */ new Set([
+	c,
+	l,
+	u
+]);
+t.id, n.id, i.id, a.id, s.id, {
+	id: "number-special",
+	kind: "scalar",
+	schema: { type: "number" },
+	matches(e) {
+		return e.type === "number" && e.format === void 0;
+	},
+	ownsValue(e) {
+		return typeof e == "number" && !Number.isFinite(e);
+	},
+	encode(e, t, n) {
+		return Number.isNaN(e) ? c : e === Infinity ? l : e === -Infinity ? u : e;
+	},
+	decode(e, t, n) {
+		if (typeof e == "number") return e;
+		if (typeof e == "string") {
+			if (e === c) return NaN;
+			if (e === l) return Infinity;
+			if (e === u) return -Infinity;
+			let t = Number(e);
+			if (!Number.isNaN(t)) return t;
+		}
+		if (n.mode === "strict") throw TypeError(`[number-special] unrecognized wire value at "${n.path}": ${JSON.stringify(e)}. Expected a number or one of ${[...d].join(", ")}.`);
+		return NaN;
+	}
+}.id, Object.freeze({
+	typescript: {
+		"date-time": {
+			encode: "$.toISOString()",
+			decode: "new Date($)",
+			mode: "native"
+		},
+		int64: {
+			encode: "String($)",
+			decode: "BigInt($)",
+			mode: "native"
+		},
+		decimal: {
+			encode: "$.toString()",
+			decode: "new Decimal($)",
+			imports: [],
+			dep: {
+				name: "decimal.js",
+				version: "^10"
+			},
+			mode: "branded"
+		},
+		byte: {
+			encode: "Buffer.from($).toString('base64')",
+			decode: "new Uint8Array(Buffer.from($, 'base64'))",
+			mode: "native"
+		},
+		uuid: {
+			encode: "$.toLowerCase()",
+			decode: "$",
+			mode: "native"
+		},
+		"number-special": {
+			encode: "numToWire($)",
+			decode: "wireToNum($)",
+			mode: "native"
+		}
+	},
+	python: {
+		"date-time": {
+			encode: "$.isoformat()",
+			decode: "datetime.fromisoformat($)",
+			imports: ["from datetime import datetime"],
+			mode: "native"
+		},
+		int64: {
+			encode: "str($)",
+			decode: "int($)",
+			mode: "native"
+		},
+		decimal: {
+			encode: "str($)",
+			decode: "Decimal($)",
+			imports: ["from decimal import Decimal"],
+			mode: "native"
+		},
+		byte: {
+			encode: "b64encode($).decode()",
+			decode: "b64decode($)",
+			imports: ["from base64 import b64encode, b64decode"],
+			mode: "native"
+		},
+		uuid: {
+			encode: "str($)",
+			decode: "UUID($)",
+			imports: ["from uuid import UUID"],
+			mode: "native"
+		},
+		"number-special": {
+			encode: "num_to_wire($)",
+			decode: "wire_to_num($)",
+			mode: "native"
+		}
+	},
+	rust: {
+		"date-time": {
+			encode: "__SCAFFOLD_RUST_DATETIME_ENCODE__",
+			decode: "__SCAFFOLD_RUST_DATETIME_DECODE__",
+			imports: ["use chrono::{DateTime, Utc};"],
+			dep: {
+				name: "chrono",
+				version: "^0.4"
+			},
+			mode: "lib"
+		},
+		int64: {
+			encode: "__SCAFFOLD_RUST_INT64_ENCODE__",
+			decode: "__SCAFFOLD_RUST_INT64_DECODE__",
+			imports: ["use serde_with::DisplayFromStr;"],
+			dep: {
+				name: "serde_with",
+				version: "^3"
+			},
+			mode: "lib"
+		},
+		decimal: {
+			encode: "__SCAFFOLD_RUST_DECIMAL_ENCODE__",
+			decode: "__SCAFFOLD_RUST_DECIMAL_DECODE__",
+			imports: ["use rust_decimal::Decimal;"],
+			dep: {
+				name: "rust_decimal",
+				version: "^1"
+			},
+			mode: "lib"
+		},
+		byte: {
+			encode: "__SCAFFOLD_RUST_BYTE_ENCODE__",
+			decode: "__SCAFFOLD_RUST_BYTE_DECODE__",
+			imports: ["use serde_with::base64::Base64;"],
+			dep: {
+				name: "serde_with",
+				version: "^3"
+			},
+			mode: "lib"
+		},
+		uuid: {
+			encode: "__SCAFFOLD_RUST_UUID_ENCODE__",
+			decode: "__SCAFFOLD_RUST_UUID_DECODE__",
+			imports: ["use uuid::Uuid;"],
+			dep: {
+				name: "uuid",
+				version: "^1"
+			},
+			mode: "lib"
+		},
+		"number-special": {
+			encode: "__SCAFFOLD_RUST_NUMSPECIAL_ENCODE__",
+			decode: "__SCAFFOLD_RUST_NUMSPECIAL_DECODE__",
+			mode: "native"
+		}
+	},
+	go: {
+		"date-time": {
+			encode: "__SCAFFOLD_GO_DATETIME_ENCODE__",
+			decode: "__SCAFFOLD_GO_DATETIME_DECODE__",
+			imports: ["\"time\""],
+			mode: "native"
+		},
+		int64: {
+			encode: "__SCAFFOLD_GO_INT64_ENCODE__",
+			decode: "__SCAFFOLD_GO_INT64_DECODE__",
+			imports: ["\"strconv\""],
+			mode: "native"
+		},
+		decimal: {
+			encode: "__SCAFFOLD_GO_DECIMAL_ENCODE__",
+			decode: "__SCAFFOLD_GO_DECIMAL_DECODE__",
+			imports: ["\"github.com/shopspring/decimal\""],
+			dep: {
+				name: "github.com/shopspring/decimal",
+				version: "v1"
+			},
+			mode: "lib"
+		},
+		byte: {
+			encode: "__SCAFFOLD_GO_BYTE_ENCODE__",
+			decode: "__SCAFFOLD_GO_BYTE_DECODE__",
+			imports: ["\"encoding/base64\""],
+			mode: "native"
+		},
+		uuid: {
+			encode: "__SCAFFOLD_GO_UUID_ENCODE__",
+			decode: "__SCAFFOLD_GO_UUID_DECODE__",
+			imports: ["\"github.com/google/uuid\""],
+			dep: {
+				name: "github.com/google/uuid",
+				version: "v1"
+			},
+			mode: "lib"
+		},
+		"number-special": {
+			encode: "__SCAFFOLD_GO_NUMSPECIAL_ENCODE__",
+			decode: "__SCAFFOLD_GO_NUMSPECIAL_DECODE__",
+			mode: "native"
+		}
+	},
+	java: {
+		"date-time": {
+			encode: "$.toString()",
+			decode: "Instant.parse($)",
+			imports: ["import java.time.Instant;"],
+			dep: {
+				name: "jackson-datatype-jsr310",
+				version: "2.x"
+			},
+			mode: "lib"
+		},
+		int64: {
+			encode: "@JsonFormat(shape = JsonFormat.Shape.STRING)",
+			decode: "@JsonFormat(shape = JsonFormat.Shape.STRING)",
+			imports: ["import com.fasterxml.jackson.annotation.JsonFormat;"],
+			mode: "native"
+		},
+		decimal: {
+			encode: "@JsonSerialize(using = ToStringSerializer.class)",
+			decode: "new BigDecimal($)",
+			imports: [
+				"import java.math.BigDecimal;",
+				"import com.fasterxml.jackson.databind.annotation.JsonSerialize;",
+				"import com.fasterxml.jackson.databind.ser.std.ToStringSerializer;"
+			],
+			mode: "native"
+		},
+		byte: {
+			encode: "$",
+			decode: "$",
+			mode: "native"
+		},
+		uuid: {
+			encode: "$.toString()",
+			decode: "UUID.fromString($)",
+			imports: ["import java.util.UUID;"],
+			mode: "native"
+		},
+		"number-special": {
+			encode: "@JsonSerialize(using = NumberSpecialSerializer.class)",
+			decode: "@JsonDeserialize(using = NumberSpecialDeserializer.class)",
+			imports: ["import com.fasterxml.jackson.databind.annotation.JsonSerialize;", "import com.fasterxml.jackson.databind.annotation.JsonDeserialize;"],
+			mode: "native"
+		}
+	}
+});
+//#endregion
+//#region ../apigen-core-client/src/lib/get-safety.ts
+var f = /* @__PURE__ */ new Set([
+	"string",
+	"number",
+	"boolean",
+	"integer"
+]);
+function p(e) {
+	if (typeof e != "object" || !e) return !1;
+	let t = e;
+	if (t.$ref !== void 0 || t.oneOf || t.anyOf || t.allOf) return !1;
+	let { type: n } = t;
+	return typeof n == "string" ? f.has(n) : Array.isArray(n) ? n.every((e) => f.has(e) || e === "null") : Array.isArray(t.enum) && t.enum.length > 0 ? t.enum.every((e) => [
+		"string",
+		"number",
+		"boolean"
+	].includes(typeof e)) : !1;
+}
+function m(e) {
+	if (!e || typeof e != "object") return !1;
+	let t = e.properties;
+	return t === void 0 || typeof t != "object" || !t ? !1 : Object.values(t).every(p);
+}
+//#endregion
+//#region ../apigen-core-client/src/lib/schema-builders/ts-json-schema.ts
+var h = { "decimal.js": "Decimal" };
+function g(e) {
+	return e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+Object.entries(h).map(([e, t]) => ({
+	pattern: RegExp(`import\\(["'][^"']*${g(e)}[^"']*["']\\)\\.\\w+`, "g"),
+	key: t
+}));
+//#endregion
+//#region src/lib/naming.ts
+function _(e) {
+	return e.words.join("-");
 }
 function v(e) {
-  return e.words.map(b).join("");
+	return e.words.map((e, t) => t === 0 ? e : M(e)).join("");
 }
 function y(e) {
-  return e.words.join("_");
-}
-function G(e) {
-  return e.replace(/\.[^.]+$/, "").replace(/[._]+/g, "-");
-}
-function P(e, t = {}) {
-  var l, u;
-  const n = [e.namespace, ...e.path], r = e.safe || E(e.input) ? "GET" : "POST", p = ((u = (l = t.http) == null ? void 0 : l.verb) == null ? void 0 : u[e.id]) ?? r, a = "/" + n.map((s) => $(s)).join("/"), c = n.map((s) => y(s)).join("_"), i = n.map((s) => y(s)).slice(0, -1).join("."), g = v(n[n.length - 2] ?? n[0]), f = v(n[n.length - 1]), m = n.map((s) => $(s));
-  return {
-    http: { verb: p, route: a },
-    mcp: { name: c },
-    grpc: { package: i, service: g, method: f },
-    cli: { path: m }
-  };
-}
-function K(e, t, n) {
-  var p, a;
-  const r = (a = (p = n.http) == null ? void 0 : p.verb) == null ? void 0 : a[e];
-  return r === "GET" || r === "POST" ? r : t["x-apigen-safe"] ? "GET" : "POST";
-}
-class _ extends Error {
-  constructor(t) {
-    const n = t.map(
-      (r) => `  [${r.transport}] "${r.target}" ← ${r.ids[0]} vs ${r.ids[1]}`
-    );
-    super(
-      `apigen-naming: ${t.length} projection collision(s) detected:
-${n.join(`
-`)}`
-    ), this.name = "CollisionDetectedError", this.collisions = t;
-  }
-}
-function T(e, t = {}) {
-  const n = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Map(), p = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Map(), c = [];
-  for (const o of e) {
-    const i = P(o, t), g = `${i.http.verb} ${i.http.route}`, f = n.get(g);
-    f !== void 0 && f !== o.id ? c.push({
-      transport: "http",
-      target: g,
-      ids: [f, o.id]
-    }) : n.set(g, o.id);
-    const m = r.get(i.mcp.name);
-    m !== void 0 && m !== o.id ? c.push({
-      transport: "mcp",
-      target: i.mcp.name,
-      ids: [m, o.id]
-    }) : r.set(i.mcp.name, o.id);
-    const l = `${i.grpc.package}.${i.grpc.service}/${i.grpc.method}`, u = p.get(l);
-    u !== void 0 && u !== o.id ? c.push({
-      transport: "grpc",
-      target: l,
-      ids: [u, o.id]
-    }) : p.set(l, o.id);
-    const s = i.cli.path.join(" "), d = a.get(s);
-    d !== void 0 && d !== o.id ? c.push({
-      transport: "cli",
-      target: s,
-      ids: [d, o.id]
-    }) : a.set(s, o.id);
-  }
-  if (c.length > 0)
-    throw new _(c);
-}
-function w(e, t) {
-  return `x-${e}-${t}`;
-}
-function z(e, t) {
-  return `--${e}-${t}`;
-}
-function N(e, t) {
-  const n = (r) => r.toUpperCase().replace(/-/g, "_");
-  return e === "adhd" ? `APIGEN_${n(t)}` : `APIGEN_${n(e)}_${n(t)}`;
-}
-const D = w;
-function U(e) {
-  let t = e.replace(/[^a-zA-Z0-9_$]/g, "_");
-  return (t === "" || /^[0-9]/.test(t)) && (t = `_${t}`), t;
+	return e.words.map(M).join("");
 }
 function b(e) {
-  return e.length === 0 ? e : e[0].toUpperCase() + e.slice(1);
-}
-export {
-  _ as CollisionDetectedError,
-  T as checkCollisions,
-  z as envelopeCliFlag,
-  N as envelopeEnvVar,
-  w as envelopeKey,
-  D as envelopeMetaKey,
-  K as httpVerb,
-  G as normalizeFileName,
-  P as project,
-  U as sanitizeIdentifier,
-  M as toCamel,
-  $ as toKebab,
-  v as toPascal,
-  y as toSnake
+	return e.words.join("_");
+}
+function x(e) {
+	return e.replace(/\.[^.]+$/, "").replace(/[._]+/g, "-");
+}
+function S(e, t = {}) {
+	let n = [e.namespace, ...e.path], r = e.safe || m(e.input) ? "GET" : "POST", i = t.http?.verb?.[e.id] ?? r, a = "/" + n.map((e) => _(e)).join("/"), o = n.map((e) => b(e)).join("_"), s = n.map((e) => b(e)).slice(0, -1).join("."), c = y(n[n.length - 2] ?? n[0]), l = y(n[n.length - 1]), u = n.map((e) => _(e));
+	return {
+		http: {
+			verb: i,
+			route: a
+		},
+		mcp: { name: o },
+		grpc: {
+			package: s,
+			service: c,
+			method: l
+		},
+		cli: { path: u }
+	};
+}
+function C(e, t, n) {
+	let r = n.http?.verb?.[e];
+	return r === "GET" || r === "POST" ? r : t["x-apigen-safe"] ? "GET" : "POST";
+}
+var w = class extends Error {
+	constructor(e) {
+		let t = e.map((e) => `  [${e.transport}] "${e.target}" ← ${e.ids[0]} vs ${e.ids[1]}`);
+		super(`apigen-naming: ${e.length} projection collision(s) detected:\n${t.join("\n")}`), this.name = "CollisionDetectedError", this.collisions = e;
+	}
 };
+function T(e, t = {}) {
+	let n = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Map(), i = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Map(), o = [];
+	for (let s of e) {
+		let e = S(s, t), c = `${e.http.verb} ${e.http.route}`, l = n.get(c);
+		l !== void 0 && l !== s.id ? o.push({
+			transport: "http",
+			target: c,
+			ids: [l, s.id]
+		}) : n.set(c, s.id);
+		let u = r.get(e.mcp.name);
+		u !== void 0 && u !== s.id ? o.push({
+			transport: "mcp",
+			target: e.mcp.name,
+			ids: [u, s.id]
+		}) : r.set(e.mcp.name, s.id);
+		let d = `${e.grpc.package}.${e.grpc.service}/${e.grpc.method}`, f = i.get(d);
+		f !== void 0 && f !== s.id ? o.push({
+			transport: "grpc",
+			target: d,
+			ids: [f, s.id]
+		}) : i.set(d, s.id);
+		let p = e.cli.path.join(" "), m = a.get(p);
+		m !== void 0 && m !== s.id ? o.push({
+			transport: "cli",
+			target: p,
+			ids: [m, s.id]
+		}) : a.set(p, s.id);
+	}
+	if (o.length > 0) throw new w(o);
+}
+function E(e, t) {
+	return `x-${e}-${t}`;
+}
+function D(e, t) {
+	return `--${e}-${t}`;
+}
+function O(e, t) {
+	let n = (e) => e.toUpperCase().replace(/-/g, "_");
+	return e === "adhd" ? `APIGEN_${n(t)}` : `APIGEN_${n(e)}_${n(t)}`;
+}
+var k = E;
+function A(e) {
+	let t = e.replace(/[^a-zA-Z0-9_$]/g, "_");
+	return (t === "" || /^[0-9]/.test(t)) && (t = `_${t}`), t;
+}
+function j(e) {
+	let t = /* @__PURE__ */ new Set(), n = [];
+	for (let r of e) {
+		let e = A(r), i = e, a = 2;
+		for (; t.has(i);) i = `${e}_${a}`, a += 1;
+		t.add(i), n.push(i);
+	}
+	return n;
+}
+function M(e) {
+	return e.length === 0 ? e : e[0].toUpperCase() + e.slice(1);
+}
+//#endregion
+//#region src/lib/emit.ts
+function N(e) {
+	return e.replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+}
+function P(e) {
+	return N(JSON.stringify(e));
+}
+function F(e, t = 3e3) {
+	if (e == null) return t;
+	if (typeof e != "string" && typeof e != "number" || typeof e == "string" && e.trim() === "") throw TypeError(`apigen: invalid port option ${JSON.stringify(e)} — expected an integer in [0, 65535]`);
+	let n = Number(e);
+	if (!Number.isInteger(n) || n < 0 || n > 65535) throw TypeError(`apigen: invalid port option ${JSON.stringify(e)} — expected an integer in [0, 65535]`);
+	return n;
+}
+function I(e) {
+	return e.replace(/\\/g, "/");
+}
+//#endregion
+export { w as CollisionDetectedError, T as checkCollisions, F as coercePort, D as envelopeCliFlag, O as envelopeEnvVar, E as envelopeKey, k as envelopeMetaKey, N as escapeLineTerminators, P as escapeStringLiteral, C as httpVerb, x as normalizeFileName, S as project, A as sanitizeIdentifier, v as toCamel, _ as toKebab, y as toPascal, I as toPosixPath, b as toSnake, j as uniqueSanitizedIdentifiers };

package/lib/emit.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Replaces raw `U+2028` LINE SEPARATOR / `U+2029` PARAGRAPH SEPARATOR
+ * characters with their `\u2028` / `\u2029` escape sequences.
+ *
+ * `JSON.stringify` emits these two code points **verbatim** (they are valid in
+ * JSON) even though ECMAScript treats them as line terminators. That is a
+ * parse error inside a string literal on pre-ES2019 targets — this repo
+ * targets `es2018` (`tsconfig.base.json`) — and a raw separator also breaks any
+ * single-line context (a comment, a log line) it lands in.
+ *
+ * `escapeStringLiteral` applies this to a single string literal.
+ * `escapeLineTerminators` is the same escape applied **directly to an
+ * already-serialized blob** — e.g. a `JSON.stringify`'d schema map whose
+ * nested `description` fields may carry these separators — so a multi-value
+ * JSON blob spliced into generated source cannot smuggle a raw line terminator
+ * past `JSON.stringify`. It is only safe on JSON/source text (it never touches
+ * any other character); it is not a substitute for `escapeStringLiteral` on a
+ * raw value, because it does not add quotes or escape backslashes.
+ *
+ * @example escapeLineTerminators('a\u2028b') // → 'a\\u2028b'
+ */
+export declare function escapeLineTerminators(text: string): string;
+/**
+ * Renders a value as a **complete, double-quoted JavaScript/TypeScript string
+ * literal** (including the surrounding quotes), safe to splice into generated
+ * source in any string-literal position.
+ *
+ * Uses `JSON.stringify`, whose output is a valid ECMAScript string literal on
+ * ES2019+ targets (the JSON-superset proposal, V8 "JSON ⊂ ECMAScript") and
+ * correctly escapes the double-quote, the backslash, and all C0 control
+ * characters (newline, carriage return, tab, …). The two characters
+ * `JSON.stringify` emits **verbatim** even though they are line terminators —
+ * `U+2028` / `U+2029` — are then escaped via {@link escapeLineTerminators}
+ * (see that helper for why this repo needs it at `es2018`).
+ *
+ * @example escapeStringLiteral("it's")   // → `"it's"`
+ * @example escapeStringLiteral('a\nb')   // → `"a\\nb"` (no raw newline)
+ * @example escapeStringLiteral('\u2028') // → `"\\u2028"`
+ */
+export declare function escapeStringLiteral(value: string): string;
+/**
+ * Coerces a caller-supplied `port` option to a validated integer, safe to
+ * splice into generated source as a numeric literal.
+ *
+ * Generate/run options reach a plugin as **untyped** option values — a CLI
+ * `--opt port=8080` arrives as the string `'8080'`, and nothing prevents a
+ * hostile or fat-fingered `--opt port=8080); process.exit(1); //`. Splicing
+ * that raw (`await app.listen({ port: ${port} })`) is a code-injection vector.
+ * Collapsing the value to an integer in the valid TCP range `[0, 65535]`
+ * (0 = request an ephemeral port) before splicing closes it: the emitted
+ * literal is always a bare number.
+ *
+ * `undefined`/`null` fall back to `fallback` (3000, matching the generators'
+ * historical default). Only a string or a number is ever coerced — a blank
+ * string, a non-numeric string, a non-string/non-number (`true`, `[]`, an
+ * object), a non-integer, or an out-of-range value throws rather than silently
+ * emitting something wrong. The type gate matters: `Number(true)` is `1` and
+ * `Number([])` is `0`, so without it those values would sneak through as if
+ * they were ports.
+ *
+ * @example coercePort('8080')  // → 8080
+ * @example coercePort(undefined) // → 3000
+ * @throws {TypeError} on a blank/non-numeric string, a non-string/non-number,
+ *   a non-integer, or an out-of-range value.
+ */
+export declare function coercePort(value: unknown, fallback?: number): number;
+/**
+ * Normalises a filesystem path to POSIX separators (`/`).
+ *
+ * Generated specifiers and paths must be platform-stable: a Windows-joined
+ * `pkg\\src\\index.ts` spliced verbatim into an import would not match the
+ * value an OpenAPI/schema emitter produces on POSIX. Always emit `/`.
+ *
+ * @example toPosixPath('a\\b') // → 'a/b'
+ */
+export declare function toPosixPath(p: string): string;
+export { sanitizeIdentifier, uniqueSanitizedIdentifiers } from './naming';

package/lib/naming.d.ts

@@ -237,3 +237,29 @@ export declare const envelopeMetaKey: typeof envelopeKey;
  * @example sanitizeIdentifier('123abc')       // → '_123abc'
  */
 export declare function sanitizeIdentifier(id: string): string;
+/**
+ * Assigns each raw id a **unique** codegen-safe identifier, disambiguating
+ * sanitisation collisions deterministically.
+ *
+ * {@link sanitizeIdentifier} is lossy: several distinct raw ids can collapse to
+ * the same identifier (`a-b`, `a_b`, `a.b` → `a_b`). A generator that emits one
+ * `import * as <id>_ns` / `const <id>_fns` pair **per package** would then emit
+ * duplicate declarations for a project holding two such packages — a hard
+ * `routes.ts` parse error (`Identifier 'a_b_ns' has already been declared`),
+ * or, worse, a silent last-writer-wins alias.
+ *
+ * This resolves the collision by appending a stable `_2`, `_3`, … suffix in
+ * input order: the FIRST id to claim a name keeps it (so a collision-free
+ * input is byte-identical to before), and each subsequent collision gets the
+ * next free suffix. The result is deterministic for a given input order, so
+ * generated output stays reproducible.
+ *
+ * @example uniqueSanitizedIdentifiers(['a-b', 'a_b', 'a.b'])
+ *   // → ['a_b', 'a_b_2', 'a_b_3']
+ * @example uniqueSanitizedIdentifiers(['dispatch-cli'])
+ *   // → ['dispatch_cli']
+ * @example uniqueSanitizedIdentifiers(['a-b', 'a_b', 'a_b_2'])
+ *   // → ['a_b', 'a_b_2', 'a_b_2_2']  (the suffix is appended to the
+ *   //   colliding sanitized base, so an id already ending in `_2` collides anew)
+ */
+export declare function uniqueSanitizedIdentifiers(ids: string[]): string[];

package/package.json

@@ -1,13 +1,30 @@
 {
   "name": "@adhd/apigen-engine-naming",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "dependencies": {
-    "@adhd/apigen-core-client": "^0.3.0"
+    "@adhd/apigen-core-client": "^0.3.2"
   },
   "main": "./index.js",
   "module": "./index.mjs",
   "typings": "./index.d.ts",
   "publishConfig": {
     "access": "public"
+  },
+  "description": "Naming conventions for apigen code generation",
+  "keywords": [
+    "api",
+    "naming",
+    "codegen",
+    "typescript"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PseudoSky/adhd.git",
+    "directory": "packages/apigen/apigen-engine-naming"
+  },
+  "homepage": "https://github.com/PseudoSky/adhd/tree/main/packages/apigen/apigen-engine-naming#readme",
+  "bugs": {
+    "url": "https://github.com/PseudoSky/adhd/issues"
   }
 }