@ts-pf/codegen 0.1.0-beta.0

package/README.md

@@ -0,0 +1,96 @@
+# @ts-pf/codegen
+
+Print a nested `Contract` `.d.ts` from a `@ts-pf/docs` `catalog()`. The frontend uses today's `createClient<Contract>(link)` — no second runtime, no `as typeof contract`, no `tsc --dts` of the backend.
+
+Agent skill: [`skills/ts-pf-codegen/`](skills/ts-pf-codegen/). Sync with `npx skills experimental_sync -y`.
+
+Types never come from `fetch()` or `JSON.parse` casts. The catalog is the spec; the `.d.ts` is the TypeScript contract.
+
+```ts
+import { catalog } from '@ts-pf/docs'
+import { emit } from '@ts-pf/codegen'
+import { writeFileSync } from 'node:fs'
+
+const spec = catalog(contract, { prefix: '/rpc' })
+writeFileSync('catalog.json', JSON.stringify(spec, null, 2))
+writeFileSync('contract.d.ts', emit(spec))
+```
+
+```ts
+import { asResult, createClient } from '@ts-pf/client'
+import { FetchLink } from '@ts-pf/client-http'
+import type { Contract } from './contract.js'
+
+const client = createClient<Contract>(new FetchLink({ url: '/rpc' }))
+await client.planet.find({ id: 1 })
+
+const result = await asResult(client.planet.find({ id: 1 }))
+if (!result.ok && result.error.code === 'NOT_FOUND') {
+  result.error.data.id
+}
+```
+
+## `emit` / `catalogHash`
+
+```ts
+import { emit, catalogHash, type EmitOptions } from '@ts-pf/codegen'
+
+emit(catalog, {
+  name: 'Contract', // default
+  failOnUnavailable: false, // default; true throws on kind: 'unavailable'
+  banner: true, // catalogVersion + sha256 hash
+})
+
+catalogHash(catalog) // 'sha256:<hex>' of canonical JSON
+```
+
+Generated procedures are `ContractProcedure<I, O, E>` with Phantom Standard Schema leaves so `InferErrorData` / `asResult` still narrow `error.code === 'NOT_FOUND'`. Protocol errors stay out of the generated error map (`ClientError` already unions them). No-input is `void`. Streams are `AsyncIterable<Item>`.
+
+The generated file uses `import type { ContractProcedure } from '@ts-pf/contract'`. This package does not import contract at runtime.
+
+## CLI
+
+```
+ts-pf-codegen emit <catalog.json|-> [-o contract.d.ts] [--name Contract] [--fail-on-unavailable]
+ts-pf-codegen pull <url> [-o contract.d.ts] [--lock catalog.lock.json]
+ts-pf-codegen hash <catalog.json|->
+```
+
+`emit` and `hash` read stdin when the path is `-`. Omit `-o` to write the `.d.ts` to stdout.
+
+Commit `contract.d.ts`, or CI-run `ts-pf-codegen pull` and pin `catalog.lock.json`:
+
+```json
+{
+  "url": "https://api.example.com/catalog.json",
+  "catalogVersion": 1,
+  "catalogHash": "sha256:…"
+}
+```
+
+Mismatch on pull exits non-zero. No registry in v1.
+
+## Serve the catalog in userland
+
+Do **not** put this on `FetchHandler`. A GET under `/rpc/...` is a procedure miss / `METHOD_NOT_ALLOWED`, not a spec.
+
+```ts
+// Userland — not FetchHandler, not @ts-pf/codegen:
+if (url.pathname === '/catalog.json') {
+  return Response.json(catalog(contract, { prefix: '/rpc' }))
+}
+const result = await handler.handle(req, { prefix: '/rpc', context })
+```
+
+## Not in this package
+
+- `createClientFromCatalog`
+- Folding into `@ts-pf/client` or `@ts-pf/docs`
+- OpenAPI-TS as the typed client (use `@ts-pf/openapi` for the polyglot export)
+- Type-level `FromSchema` over imported JSON
+- `tsc --dts` of the live router
+- Serving catalog from FetchHandler
+- Auth on `pull` (later)
+- A schema registry
+
+The catalog is the portable spec. [`@ts-pf/openapi`](../openapi) remains the polyglot OpenAPI 3.1 export.

package/dist/cli.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+export type CliIo = {
+    stdin: {
+        read: () => Promise<string>;
+    };
+    stdout: {
+        write: (chunk: string) => void;
+    };
+    stderr: {
+        write: (chunk: string) => void;
+    };
+    readFile: (path: string) => Promise<string>;
+    writeFile: (path: string, content: string) => Promise<void>;
+    fetch: typeof fetch;
+};
+export declare function runCli(argv: string[], io: CliIo): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAaA,MAAM,MAAM,KAAK,GAAG;IAClB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE,CAAA;IACtC,MAAM,EAAE;QAAE,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAA;IAC1C,MAAM,EAAE;QAAE,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAA;IAC1C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3C,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3D,KAAK,EAAE,OAAO,KAAK,CAAA;CACpB,CAAA;AAQD,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAavE"}

package/dist/cli.js

@@ -0,0 +1,232 @@
+#!/usr/bin/env node
+import { readFile, writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { stderr as nodeStderr, stdin as nodeStdin, stdout as nodeStdout, } from 'node:process';
+import { fileURLToPath } from 'node:url';
+import { emit } from './emit.js';
+import { catalogHash } from './hash.js';
+const USAGE = 'Usage: ts-pf-codegen <emit|pull|hash> …\n' +
+    '  ts-pf-codegen emit <catalog.json> [-o contract.d.ts] [--name Contract] [--fail-on-unavailable]\n' +
+    '  ts-pf-codegen pull <url> [-o contract.d.ts] [--lock catalog.lock.json]\n' +
+    '  ts-pf-codegen hash <catalog.json>\n';
+export async function runCli(argv, io) {
+    const [cmd, ...rest] = argv;
+    if (cmd === 'emit') {
+        return emitCmd(rest, io);
+    }
+    if (cmd === 'pull') {
+        return pullCmd(rest, io);
+    }
+    if (cmd === 'hash') {
+        return hashCmd(rest, io);
+    }
+    io.stderr.write(USAGE);
+    return 1;
+}
+async function emitCmd(args, io) {
+    const parsed = parseArgs(args, {
+        flags: new Set(['fail-on-unavailable']),
+        values: new Set(['o', 'name']),
+    });
+    const input = parsed.positional[0];
+    if (input === undefined) {
+        io.stderr.write('emit: missing catalog path (use - for stdin)\n');
+        return 1;
+    }
+    const raw = await readInput(input, io);
+    const catalog = parseCatalog(raw);
+    const name = typeof parsed.values.name === 'string' ? parsed.values.name : undefined;
+    const dts = emit(catalog, {
+        ...(name !== undefined ? { name } : {}),
+        failOnUnavailable: parsed.flags.has('fail-on-unavailable'),
+    });
+    return writeOutput(dts, parsed.values.o, io);
+}
+async function pullCmd(args, io) {
+    const parsed = parseArgs(args, {
+        flags: new Set(),
+        values: new Set(['o', 'lock']),
+    });
+    const url = parsed.positional[0];
+    if (url === undefined) {
+        io.stderr.write('pull: missing catalog url\n');
+        return 1;
+    }
+    const response = await io.fetch(url);
+    if (!response.ok) {
+        io.stderr.write(`pull: GET ${url} failed (${String(response.status)})\n`);
+        return 1;
+    }
+    const raw = await response.text();
+    const catalog = parseCatalog(raw);
+    const hash = catalogHash(catalog);
+    const lockPath = parsed.values.lock;
+    if (typeof lockPath === 'string') {
+        let existing;
+        try {
+            existing = await io.readFile(lockPath);
+        }
+        catch {
+            existing = undefined;
+        }
+        if (existing !== undefined) {
+            const lock = parseLock(existing);
+            if (lock.catalogHash !== hash) {
+                io.stderr.write(`pull: catalog hash mismatch\n  lock: ${lock.catalogHash}\n  got:  ${hash}\n`);
+                return 1;
+            }
+        }
+        else {
+            const lock = {
+                url,
+                catalogVersion: catalog.catalogVersion,
+                catalogHash: hash,
+            };
+            await io.writeFile(`${lockPath}`, `${JSON.stringify(lock, null, 2)}\n`);
+        }
+    }
+    const dts = emit(catalog);
+    return writeOutput(dts, parsed.values.o, io);
+}
+async function hashCmd(args, io) {
+    const parsed = parseArgs(args, { flags: new Set(), values: new Set() });
+    const input = parsed.positional[0];
+    if (input === undefined) {
+        io.stderr.write('hash: missing catalog path (use - for stdin)\n');
+        return 1;
+    }
+    const raw = await readInput(input, io);
+    const catalog = parseCatalog(raw);
+    io.stdout.write(`${catalogHash(catalog)}\n`);
+    return 0;
+}
+async function readInput(path, io) {
+    if (path === '-') {
+        return io.stdin.read();
+    }
+    return io.readFile(path);
+}
+async function writeOutput(content, output, io) {
+    if (typeof output === 'string') {
+        await io.writeFile(output, content);
+        return 0;
+    }
+    io.stdout.write(content);
+    return 0;
+}
+function parseCatalog(raw) {
+    let value;
+    try {
+        value = JSON.parse(raw);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'invalid JSON';
+        throw new Error(`catalog is not JSON: ${message}`);
+    }
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new Error('catalog must be a JSON object');
+    }
+    return value;
+}
+function parseLock(raw) {
+    let value;
+    try {
+        value = JSON.parse(raw);
+    }
+    catch {
+        throw new Error('lockfile is not JSON');
+    }
+    if (typeof value !== 'object' ||
+        value === null ||
+        !('catalogHash' in value) ||
+        typeof value.catalogHash !== 'string') {
+        throw new Error('lockfile missing catalogHash');
+    }
+    return { catalogHash: value.catalogHash };
+}
+function parseArgs(args, spec) {
+    const positional = [];
+    const flags = new Set();
+    const values = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === undefined) {
+            continue;
+        }
+        if (arg === '--') {
+            positional.push(...args.slice(i + 1));
+            break;
+        }
+        if (arg.startsWith('--')) {
+            const eq = arg.indexOf('=');
+            const name = eq === -1 ? arg.slice(2) : arg.slice(2, eq);
+            if (spec.flags.has(name)) {
+                flags.add(name);
+                continue;
+            }
+            if (spec.values.has(name)) {
+                const value = eq === -1 ? args[++i] : arg.slice(eq + 1);
+                if (value === undefined) {
+                    throw new Error(`missing value for --${name}`);
+                }
+                values[name] = value;
+                continue;
+            }
+            throw new Error(`unknown option --${name}`);
+        }
+        if (arg === '-o') {
+            const value = args[++i];
+            if (value === undefined) {
+                throw new Error('missing value for -o');
+            }
+            values.o = value;
+            continue;
+        }
+        if (arg.startsWith('-') && arg !== '-') {
+            throw new Error(`unknown option ${arg}`);
+        }
+        positional.push(arg);
+    }
+    return { positional, flags, values };
+}
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of nodeStdin) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+function isMain() {
+    const argv1 = process.argv[1];
+    if (argv1 === undefined) {
+        return false;
+    }
+    try {
+        return fileURLToPath(import.meta.url) === resolve(argv1);
+    }
+    catch {
+        return false;
+    }
+}
+async function main() {
+    const io = {
+        stdin: { read: readStdin },
+        stdout: { write: (chunk) => nodeStdout.write(chunk) },
+        stderr: { write: (chunk) => nodeStderr.write(chunk) },
+        readFile: (path) => readFile(path, 'utf8'),
+        writeFile: (path, content) => writeFile(path, content, 'utf8'),
+        fetch,
+    };
+    try {
+        process.exitCode = await runCli(process.argv.slice(2), io);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        nodeStderr.write(`${message}\n`);
+        process.exitCode = 1;
+    }
+}
+if (isMain()) {
+    void main();
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/emit.d.ts

@@ -0,0 +1,11 @@
+import type { ProcedureCatalog } from '@ts-pf/docs';
+export type EmitOptions = {
+    /** Type name. Default `Contract`. */
+    name?: string;
+    /** Throw if any input/output/error data is `unavailable`. Default false. */
+    failOnUnavailable?: boolean;
+    /** Default true. Header comment with catalogVersion + catalogHash. */
+    banner?: boolean;
+};
+export declare function emit(catalog: ProcedureCatalog, options?: EmitOptions): string;
+//# sourceMappingURL=emit.d.ts.map

package/dist/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../src/emit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,gBAAgB,EACjB,MAAM,aAAa,CAAA;AAOpB,MAAM,MAAM,WAAW,GAAG;IACxB,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,sEAAsE;IACtE,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,wBAAgB,IAAI,CAClB,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,WAAgB,GACxB,MAAM,CAqCR"}

package/dist/emit.js

@@ -0,0 +1,147 @@
+import { catalogHash } from './hash.js';
+import { aliasName, pascalCase, quoteKey, quoteString } from './names.js';
+import { PHANTOM_SOURCE } from './phantom.js';
+import { printJsonSchema } from './print-type.js';
+import { buildTree } from './tree.js';
+export function emit(catalog, options = {}) {
+    if (catalog.catalogVersion !== 1) {
+        throw new Error(`Unsupported catalogVersion: ${String(catalog.catalogVersion)}`);
+    }
+    if (!Array.isArray(catalog.procedures)) {
+        throw new Error('catalog.procedures must be an array');
+    }
+    const name = options.name ?? 'Contract';
+    const failOnUnavailable = options.failOnUnavailable ?? false;
+    const banner = options.banner ?? true;
+    const aliases = [];
+    const tree = buildTree(catalog.procedures);
+    const body = printNamespace(tree, aliases, failOnUnavailable);
+    const lines = [];
+    if (banner) {
+        lines.push('/**');
+        lines.push(' * Generated by @ts-pf/codegen. Do not edit.');
+        lines.push(` * catalogVersion: ${String(catalog.catalogVersion)}`);
+        lines.push(` * catalogHash: ${catalogHash(catalog)}`);
+        lines.push(' */');
+        lines.push('');
+    }
+    lines.push("import type { ContractProcedure } from '@ts-pf/contract'");
+    lines.push('');
+    lines.push(PHANTOM_SOURCE);
+    lines.push('');
+    for (const alias of aliases) {
+        lines.push(`type ${alias.name} = ${alias.ts}`);
+        lines.push('');
+    }
+    lines.push(`export type ${name} = ${body}`);
+    lines.push('');
+    return lines.join('\n');
+}
+function printNamespace(tree, aliases, failOnUnavailable) {
+    const lines = ['{'];
+    for (const [key, node] of tree) {
+        const value = node.kind === 'proc'
+            ? printProcedure(node.proc, aliases, failOnUnavailable)
+            : printNamespace(node.children, aliases, failOnUnavailable);
+        const valueLines = value.split('\n');
+        lines.push(`  ${quoteKey(key)}: ${valueLines[0]}`);
+        for (const line of valueLines.slice(1)) {
+            lines.push(`  ${line}`);
+        }
+    }
+    lines.push('}');
+    return lines.join('\n');
+}
+function printProcedure(proc, aliases, failOnUnavailable) {
+    const input = printSlot(proc.input, {
+        path: proc.path,
+        suffix: 'Input',
+        missing: 'void',
+        slot: 'input',
+        aliases,
+        failOnUnavailable,
+    });
+    const output = printSlot(proc.output, {
+        path: proc.path,
+        suffix: 'Output',
+        missing: 'unknown',
+        slot: 'output',
+        aliases,
+        failOnUnavailable,
+    });
+    const errors = printErrorMap(proc.errors, proc.path, aliases, failOnUnavailable);
+    const args = errors === undefined ? [input, output] : [input, output, errors];
+    const compact = args.every((arg) => !arg.includes('\n'));
+    if (compact) {
+        return `ContractProcedure<${args.join(', ')}>`;
+    }
+    return `ContractProcedure<\n${args.map((arg) => indentLines(arg, 1)).join(',\n')}\n>`;
+}
+function printErrorMap(errors, path, aliases, failOnUnavailable) {
+    if (errors.length === 0) {
+        return undefined;
+    }
+    const fields = [];
+    for (const err of errors) {
+        const body = [];
+        if (err.status !== undefined) {
+            body.push(`status: ${String(err.status)}`);
+        }
+        if (err.message !== undefined) {
+            body.push(`message: ${quoteString(err.message)}`);
+        }
+        if (err.data !== undefined) {
+            const data = printSlot(err.data, {
+                path,
+                suffix: `Error${pascalCase(err.code)}`,
+                missing: 'unknown',
+                slot: `error ${err.code} data`,
+                aliases,
+                failOnUnavailable,
+            });
+            body.push(`data: Phantom<${data}>`);
+        }
+        const def = body.length === 0
+            ? '{}'
+            : `{\n${body.map((line) => `  ${line}`).join('\n')}\n}`;
+        const defLines = def.split('\n');
+        fields.push(`${quoteKey(err.code)}: ${defLines[0]}`);
+        for (const line of defLines.slice(1)) {
+            fields.push(line);
+        }
+    }
+    return `{\n${fields.map((line) => `  ${line}`).join('\n')}\n}`;
+}
+function printSlot(schema, opts) {
+    if (schema === undefined) {
+        return opts.missing;
+    }
+    if (schema.kind === 'unavailable') {
+        if (opts.failOnUnavailable) {
+            throw new Error(`Unavailable schema at ${opts.path.join('/')} ${opts.slot}: ${schema.reason}`);
+        }
+        return 'unknown';
+    }
+    if (schema.kind === 'stream') {
+        const item = printSlot(schema.item, {
+            ...opts,
+            suffix: `${opts.suffix}Item`,
+            missing: 'unknown',
+            slot: `${opts.slot} item`,
+        });
+        return `AsyncIterable<${item}>`;
+    }
+    const printed = printJsonSchema(schema.jsonSchema, {
+        prefix: aliasName(opts.path, opts.suffix),
+    });
+    opts.aliases.push(...printed.aliases);
+    return printed.ts;
+}
+function indentLines(text, n) {
+    const pad = '  '.repeat(n);
+    return text
+        .split('\n')
+        .map((line) => `${pad}${line}`)
+        .join('\n');
+}
+//# sourceMappingURL=emit.js.map

package/dist/emit.js.map

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

package/dist/hash.d.ts

@@ -0,0 +1,3 @@
+import type { ProcedureCatalog } from '@ts-pf/docs';
+export declare function catalogHash(catalog: ProcedureCatalog): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD,wBAAgB,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAI7D"}

package/dist/hash.js

@@ -0,0 +1,21 @@
+import { createHash } from 'node:crypto';
+export function catalogHash(catalog) {
+    const json = JSON.stringify(canonicalize(catalog));
+    const hex = createHash('sha256').update(json).digest('hex');
+    return `sha256:${hex}`;
+}
+function canonicalize(value) {
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(canonicalize);
+    }
+    const input = value;
+    const output = {};
+    for (const key of Object.keys(input).sort()) {
+        output[key] = canonicalize(input[key]);
+    }
+    return output;
+}
+//# sourceMappingURL=hash.js.map

package/dist/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAGxC,MAAM,UAAU,WAAW,CAAC,OAAyB;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAA;IAClD,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC3D,OAAO,UAAU,GAAG,EAAE,CAAA;AACxB,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,KAAK,CAAA;IACd,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;IAChC,CAAC;IACD,MAAM,KAAK,GAAG,KAAgC,CAAA;IAC9C,MAAM,MAAM,GAA4B,EAAE,CAAA;IAC1C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5C,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;IACxC,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { type EmitOptions, emit } from './emit.js';
+export { catalogHash } from './hash.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { emit } from './emit.js';
+export { catalogHash } from './hash.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,IAAI,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA"}

package/dist/names.d.ts

@@ -0,0 +1,6 @@
+export declare function isIdent(value: string): boolean;
+export declare function quoteKey(value: string): string;
+export declare function quoteString(value: string): string;
+export declare function pascalCase(segment: string): string;
+export declare function aliasName(path: readonly string[], suffix: string): string;
+//# sourceMappingURL=names.d.ts.map

package/dist/names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../src/names.ts"],"names":[],"mappings":"AAmDA,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASlD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGzE"}