@ir-kit/kit 0.0.0-stage → 1.0.0

package/dist/fn-schema/typescript/schema.js

@@ -0,0 +1,344 @@
+import path from "node:path";
+import { createFormatter, createParser, DEFAULT_CONFIG, SchemaGenerator, } from "ts-json-schema-generator";
+import { renderImports, } from "./aliases.js";
+import { detectSentinel, renderSentinelDeclaration, WELL_KNOWN_SCHEMAS, WELL_KNOWN_TRANSPORT, } from "./well-known.js";
+export const VIRTUAL_DIR = "__fn_schema_virtual__";
+const INPUT_PREFIX = "__In_";
+const OUTPUT_NAME = "__Out__";
+export class SignatureSkipped extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SignatureSkipped";
+    }
+}
+export function virtualDirFor(sourceFile) {
+    return path.join(path.dirname(sourceFile), VIRTUAL_DIR);
+}
+export function buildSchemas(fn, ctx) {
+    if (fn.generic && ctx.signature.generics === "skip") {
+        throw new SignatureSkipped(`Generic function "${fn.name}" skipped (set signature.generics to "erase" to coerce type parameters to unknown)`);
+    }
+    if (fn.generic && ctx.signature.generics === "error") {
+        throw new Error(`Generic function "${fn.name}" not supported`);
+    }
+    const overloads = pickOverloads(fn.overloads, ctx.signature.overloads);
+    const skip = ctx.signature.skipParameter;
+    const filteredOverloads = overloads.map((o) => ({
+        parameters: skip ? o.parameters.filter((p) => !skip(p)) : o.parameters,
+        returnAlias: o.returnAlias,
+    }));
+    const allNotes = filteredOverloads.flatMap((o) => [
+        ...o.parameters.flatMap((p) => p.alias.notes),
+        ...o.returnAlias.notes,
+    ]);
+    const allSources = {};
+    for (const o of filteredOverloads) {
+        for (const p of o.parameters)
+            Object.assign(allSources, p.alias.sources);
+        Object.assign(allSources, o.returnAlias.sources);
+    }
+    const wellKnownNames = uniqueNames(allNotes, "well-known");
+    const inferredDefaults = {};
+    for (const n of allNotes) {
+        if (n.kind === "well-known" && n.defaultSchema) {
+            inferredDefaults[n.name] = n.defaultSchema;
+        }
+    }
+    const mappers = {
+        ...inferredDefaults,
+        ...WELL_KNOWN_SCHEMAS,
+        ...(ctx.typeMappers ?? {}),
+    };
+    const maxArity = filteredOverloads.reduce((max, o) => Math.max(max, o.parameters.length), 0);
+    const virtualPath = virtualFileFor(fn);
+    const source = renderVirtualSource(filteredOverloads, maxArity, ctx.signature, wellKnownNames);
+    ctx.project.createSourceFile(virtualPath, source, { overwrite: true });
+    const config = buildGeneratorConfig(virtualPath, ctx.schema);
+    /** ts-morph bundles its own `typescript`; runtime shape matches but module identities differ. */
+    const program = ctx.project.getProgram().compilerObject;
+    const parser = createParser(program, config);
+    const formatter = createFormatter(config);
+    const generator = new SchemaGenerator(program, parser, formatter, config);
+    const definitions = {};
+    const inputSchemas = [];
+    for (let i = 0; i < maxArity; i++) {
+        const raw = generator.createSchema(`${INPUT_PREFIX}${i}`);
+        mergeDefinitions(definitions, raw.definitions);
+        inputSchemas.push(stripWrapper(raw));
+    }
+    const rawOutput = generator.createSchema(OUTPUT_NAME);
+    mergeDefinitions(definitions, rawOutput.definitions);
+    const output = stripWrapper(rawOutput);
+    const annotations = {
+        identity: ctx.schema.identity,
+        transport: ctx.schema.transport,
+        sourceLocations: ctx.schema.sourceLocations,
+        sources: allSources,
+    };
+    for (let i = 0; i < inputSchemas.length; i++) {
+        inputSchemas[i] = applyTypeMappers(inputSchemas[i], mappers, annotations);
+    }
+    const mappedOutput = applyTypeMappers(output, mappers, annotations);
+    for (const k of Object.keys(definitions)) {
+        const mapped = applyTypeMappers(definitions[k], mappers, annotations);
+        definitions[k] = annotateNamedDefinition(mapped, k, annotations);
+    }
+    const primary = filteredOverloads[filteredOverloads.length - 1];
+    const input = (() => {
+        switch (ctx.signature.parameters) {
+            case "first-only":
+                return inputSchemas[0] ?? { type: "null" };
+            case "object":
+                return objectFromParams(primary.parameters, inputSchemas);
+            case "array":
+            default:
+                return inputSchemas;
+        }
+    })();
+    return {
+        input,
+        output: mappedOutput,
+        definitions,
+        coverage: buildCoverageReport(filteredOverloads),
+    };
+}
+function buildCoverageReport(overloads) {
+    const buckets = {
+        mapped: new Map(),
+        lossy: new Map(),
+        notRepresentable: new Map(),
+    };
+    const recordMapped = (name, occ) => {
+        const list = buckets.mapped.get(name);
+        if (list)
+            list.push(occ);
+        else
+            buckets.mapped.set(name, [occ]);
+    };
+    const recordLossy = (name, reason, occ) => {
+        const cur = buckets.lossy.get(name);
+        if (cur)
+            cur.occurrences.push(occ);
+        else
+            buckets.lossy.set(name, { reason, occurrences: [occ] });
+    };
+    const recordNotRepresentable = (name, occ) => {
+        const list = buckets.notRepresentable.get(name);
+        if (list)
+            list.push(occ);
+        else
+            buckets.notRepresentable.set(name, [occ]);
+    };
+    const dispatch = (note, occ) => {
+        if (note.kind === "well-known")
+            recordMapped(note.name, occ);
+        else if (note.kind === "lossy")
+            recordLossy(note.name, note.reason, occ);
+        else
+            recordNotRepresentable(note.name, occ);
+    };
+    for (let oi = 0; oi < overloads.length; oi++) {
+        const o = overloads[oi];
+        for (let pi = 0; pi < o.parameters.length; pi++) {
+            const p = o.parameters[pi];
+            const occ = {
+                side: "input",
+                overloadIndex: oi,
+                paramIndex: pi,
+                paramName: p.name,
+            };
+            for (const n of p.alias.notes)
+                dispatch(n, occ);
+        }
+        const occ = { side: "output", overloadIndex: oi };
+        for (const n of o.returnAlias.notes)
+            dispatch(n, occ);
+    }
+    return {
+        mapped: [...buckets.mapped].map(([name, occurrences]) => ({
+            name,
+            count: occurrences.length,
+            occurrences,
+        })),
+        lossy: [...buckets.lossy].map(([name, v]) => ({
+            name,
+            reason: v.reason,
+            count: v.occurrences.length,
+            occurrences: v.occurrences,
+        })),
+        notRepresentable: [...buckets.notRepresentable].map(([name, occurrences]) => ({
+            name,
+            count: occurrences.length,
+            occurrences,
+        })),
+    };
+}
+function uniqueNames(notes, kind) {
+    const seen = new Set();
+    for (const n of notes)
+        if (n.kind === kind)
+            seen.add(n.name);
+    return [...seen];
+}
+function applyTypeMappers(schema, mappers, ann) {
+    if (Array.isArray(schema)) {
+        return schema.map((s) => applyTypeMappers(s, mappers, ann));
+    }
+    if (!schema || typeof schema !== "object")
+        return schema;
+    const sentinel = detectSentinel(schema);
+    if (sentinel && mappers[sentinel]) {
+        return decorateMappedNode(sentinel, mappers[sentinel], ann);
+    }
+    const out = {};
+    for (const [k, v] of Object.entries(schema)) {
+        out[k] = applyTypeMappers(v, mappers, ann);
+    }
+    return out;
+}
+function decorateMappedNode(name, base, ann) {
+    const out = { ...base };
+    if (ann.identity)
+        out[ann.identity] = name;
+    if (ann.transport) {
+        const hint = WELL_KNOWN_TRANSPORT[name];
+        if (hint)
+            out[ann.transport] = hint;
+    }
+    if (ann.sourceLocations) {
+        const src = ann.sources[name];
+        if (src)
+            out[ann.sourceLocations] = formatSource(src);
+    }
+    return out;
+}
+function annotateNamedDefinition(schema, name, ann) {
+    if (!ann.identity && !ann.sourceLocations)
+        return schema;
+    const out = { ...schema };
+    if (ann.identity && out[ann.identity] === undefined) {
+        out[ann.identity] = name;
+    }
+    if (ann.sourceLocations) {
+        const src = ann.sources[name];
+        if (src && out[ann.sourceLocations] === undefined) {
+            out[ann.sourceLocations] = formatSource(src);
+        }
+    }
+    return out;
+}
+function formatSource(src) {
+    return `${src.file}:${src.line}:${src.column}`;
+}
+function pickOverloads(overloads, strategy) {
+    if (overloads.length === 0)
+        return overloads;
+    switch (strategy) {
+        case "first":
+            return [overloads[0]];
+        case "last":
+            return [overloads[overloads.length - 1]];
+        case "all":
+        case "merge":
+            return overloads;
+    }
+}
+function virtualFileFor(fn) {
+    const dir = virtualDirFor(fn.sourceFilePath);
+    const baseName = path.basename(fn.sourceFilePath, path.extname(fn.sourceFilePath));
+    const member = fn.kind === "method" && fn.className
+        ? `${fn.className}_${fn.name}`
+        : fn.name;
+    return path.join(dir, `${baseName}_${member}.virtual.ts`);
+}
+function renderVirtualSource(overloads, maxArity, signature, wellKnownNames) {
+    const allImports = overloads.flatMap((o) => [
+        ...o.parameters.flatMap((p) => p.alias.imports),
+        ...o.returnAlias.imports,
+    ]);
+    const importBlock = renderImports(allImports);
+    const lines = [];
+    if (importBlock)
+        lines.push(importBlock);
+    for (const name of wellKnownNames) {
+        lines.push(renderSentinelDeclaration(name));
+    }
+    for (let i = 0; i < maxArity; i++) {
+        const variants = overloads.map((o) => paramExpr(o.parameters[i], signature));
+        lines.push(`export type ${INPUT_PREFIX}${i} = ${union(variants)};`);
+    }
+    const outVariants = overloads.map((o) => signature.unwrapPromise
+        ? `Awaited<${o.returnAlias.text}>`
+        : o.returnAlias.text);
+    lines.push(`export type ${OUTPUT_NAME} = ${union(outVariants)};`);
+    return `${lines.join("\n")}\n`;
+}
+function paramExpr(p, _signature) {
+    if (!p)
+        return "undefined";
+    const base = p.alias.text;
+    if (p.optional)
+        return `(${base}) | undefined`;
+    return `(${base})`;
+}
+function union(parts) {
+    const unique = Array.from(new Set(parts));
+    if (unique.length === 1)
+        return unique[0];
+    return unique.join(" | ");
+}
+function buildGeneratorConfig(virtualPath, schema) {
+    return {
+        ...DEFAULT_CONFIG,
+        path: virtualPath,
+        type: "*",
+        expose: schema.expose,
+        topRef: schema.topRef,
+        additionalProperties: schema.additionalProperties,
+        encodeRefs: schema.encodeRefs,
+        schemaId: "",
+        jsDoc: "extended",
+        sortProps: true,
+        strictTuples: false,
+        skipTypeCheck: true,
+    };
+}
+function stripWrapper(schema) {
+    const { definitions: _d, $schema: _s, ...rest } = schema;
+    return rest;
+}
+function mergeDefinitions(target, source) {
+    if (!source)
+        return;
+    for (const [k, v] of Object.entries(source)) {
+        // JSON Schema allows `true`/`false` as a definition shorthand.
+        if (typeof v === "boolean") {
+            target[k] = v ? {} : { not: {} };
+        }
+        else {
+            target[k] = v;
+        }
+    }
+}
+function objectFromParams(params, schemas) {
+    const properties = {};
+    const required = [];
+    for (let idx = 0; idx < params.length; idx++) {
+        const entry = params[idx];
+        if (!entry)
+            continue;
+        const schema = schemas[idx];
+        if (!schema)
+            continue;
+        properties[entry.name] = schema;
+        if (!entry.optional)
+            required.push(entry.name);
+    }
+    return {
+        type: "object",
+        properties,
+        required,
+        additionalProperties: false,
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/fn-schema/typescript/schema.js.map

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

package/dist/fn-schema/typescript/well-known.d.ts

@@ -0,0 +1,17 @@
+import type { JSONSchema } from "../core/index.js";
+export declare const SENTINEL_KEY = "__fn_schema_marker";
+export declare const WELL_KNOWN_SCHEMAS: Record<string, JSONSchema>;
+export declare const WELL_KNOWN_NAMES: ReadonlySet<string>;
+export declare const NOT_REPRESENTABLE: ReadonlySet<string>;
+/** Built-in mappings that lose information — paired with a reason for the diagnostic. */
+export declare const LOSSY_REASONS: Record<string, string>;
+/**
+ * Wire-format hint per TS type. `multipart` = raw upload; `base64` = JSON
+ * payload; `json` = already JSON. Drives the `transport` extension keyword.
+ */
+export type TransportHint = "multipart" | "base64" | "json";
+export declare const WELL_KNOWN_TRANSPORT: Record<string, TransportHint>;
+export declare function sentinelTypeAlias(name: string): string;
+export declare function renderSentinelDeclaration(name: string): string;
+export declare function detectSentinel(schema: unknown): string | null;
+//# sourceMappingURL=well-known.d.ts.map

package/dist/fn-schema/typescript/well-known.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"well-known.d.ts","sourceRoot":"","sources":["../../../src/fn-schema/typescript/well-known.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,eAAO,MAAM,YAAY,uBAAuB,CAAC;AAEjD,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAWzD,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAEhD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAIhD,CAAC;AAEH,yFAAyF;AACzF,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGhD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE5D,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAM9D,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQ7D"}

package/dist/fn-schema/typescript/well-known.js

@@ -0,0 +1,50 @@
+export const SENTINEL_KEY = "__fn_schema_marker";
+export const WELL_KNOWN_SCHEMAS = {
+    Date: { type: "string", format: "date-time" },
+    URL: { type: "string", format: "uri" },
+    RegExp: { type: "string", format: "regex" },
+    File: { type: "string", format: "binary" },
+    Blob: { type: "string", format: "binary" },
+    Buffer: { type: "string", contentEncoding: "base64" },
+    Uint8Array: { type: "string", contentEncoding: "base64" },
+    ArrayBuffer: { type: "string", contentEncoding: "base64" },
+    bigint: { type: "integer" },
+    BigInt: { type: "integer" },
+};
+export const WELL_KNOWN_NAMES = new Set(Object.keys(WELL_KNOWN_SCHEMAS));
+export const NOT_REPRESENTABLE = new Set([
+    "symbol",
+    "Symbol",
+    "unique symbol",
+]);
+/** Built-in mappings that lose information — paired with a reason for the diagnostic. */
+export const LOSSY_REASONS = {
+    bigint: "JSON numbers cannot represent the full bigint range",
+    BigInt: "JSON numbers cannot represent the full bigint range",
+};
+export const WELL_KNOWN_TRANSPORT = {
+    File: "multipart",
+    Blob: "multipart",
+    Buffer: "base64",
+    Uint8Array: "base64",
+    ArrayBuffer: "base64",
+};
+export function sentinelTypeAlias(name) {
+    return `__FnSchemaMap_${name.replace(/[^A-Za-z0-9_]/g, "_")}`;
+}
+export function renderSentinelDeclaration(name) {
+    return `type ${sentinelTypeAlias(name)} = { readonly ${SENTINEL_KEY}: "${name}" };`;
+}
+export function detectSentinel(schema) {
+    if (!schema || typeof schema !== "object")
+        return null;
+    const props = schema.properties;
+    if (!props || typeof props !== "object")
+        return null;
+    const marker = props[SENTINEL_KEY];
+    if (!marker || typeof marker !== "object")
+        return null;
+    const constVal = marker.const;
+    return typeof constVal === "string" ? constVal : null;
+}
+//# sourceMappingURL=well-known.js.map

package/dist/fn-schema/typescript/well-known.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"well-known.js","sourceRoot":"","sources":["../../../src/fn-schema/typescript/well-known.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAEjD,MAAM,CAAC,MAAM,kBAAkB,GAA+B;IAC5D,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE;IAC7C,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE;IACtC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;IAC3C,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE;IAC1C,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE;IAC1C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE;IACrD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE;IACzD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE;IAC1D,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC3B,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAC1D,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAChC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAwB,IAAI,GAAG,CAAC;IAC5D,QAAQ;IACR,QAAQ;IACR,eAAe;CAChB,CAAC,CAAC;AAEH,yFAAyF;AACzF,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,MAAM,EAAE,qDAAqD;IAC7D,MAAM,EAAE,qDAAqD;CAC9D,CAAC;AAQF,MAAM,CAAC,MAAM,oBAAoB,GAAkC;IACjE,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,QAAQ;IACpB,WAAW,EAAE,QAAQ;CACtB,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,iBAAiB,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,EAAE,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,OAAO,QAAQ,iBAAiB,CAAC,IAAI,CAAC,iBAAiB,YAAY,MAAM,IAAI,MAAM,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAe;IAC5C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,KAAK,GAAI,MAAmD,CAAC,UAAU,CAAC;IAC9E,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrD,MAAM,MAAM,GAAI,KAAiC,CAAC,YAAY,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,QAAQ,GAAI,MAA8B,CAAC,KAAK,CAAC;IACvD,OAAO,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;AACxD,CAAC"}

package/dist/fn-schema/unplugin/esbuild.d.ts

@@ -0,0 +1,5 @@
+import { fnSchema } from "./index.js";
+declare const _default: (options: import("./index.js").FnSchemaPluginOptions) => import("unplugin").EsbuildPlugin;
+export default _default;
+export { fnSchema };
+//# sourceMappingURL=esbuild.d.ts.map

package/dist/fn-schema/unplugin/esbuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild.d.ts","sourceRoot":"","sources":["../../../src/fn-schema/unplugin/esbuild.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;;;AAGtC,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/fn-schema/unplugin/esbuild.js

@@ -0,0 +1,4 @@
+import { fnSchema } from "./index.js";
+export default fnSchema.esbuild;
+export { fnSchema };
+//# sourceMappingURL=esbuild.js.map

package/dist/fn-schema/unplugin/esbuild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild.js","sourceRoot":"","sources":["../../../src/fn-schema/unplugin/esbuild.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,eAAe,QAAQ,CAAC,OAAO,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/fn-schema/unplugin/farm.d.ts

@@ -0,0 +1,5 @@
+import { fnSchema } from "./index.js";
+declare const _default: (options: import("./index.js").FnSchemaPluginOptions) => JsPlugin;
+export default _default;
+export { fnSchema };
+//# sourceMappingURL=farm.d.ts.map

package/dist/fn-schema/unplugin/farm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"farm.d.ts","sourceRoot":"","sources":["../../../src/fn-schema/unplugin/farm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;;;AAGtC,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/fn-schema/unplugin/farm.js

@@ -0,0 +1,4 @@
+import { fnSchema } from "./index.js";
+export default fnSchema.farm;
+export { fnSchema };
+//# sourceMappingURL=farm.js.map

package/dist/fn-schema/unplugin/farm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"farm.js","sourceRoot":"","sources":["../../../src/fn-schema/unplugin/farm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,eAAe,QAAQ,CAAC,IAAI,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/fn-schema/unplugin/index.d.ts

@@ -0,0 +1,13 @@
+import { type UnpluginInstance } from "unplugin";
+import { type ExtractOptions } from "../core/index.js";
+export interface FnSchemaPluginOptions extends Omit<ExtractOptions, "files" | "source" | "targets"> {
+    /** Glob pattern(s) for source files. Required. */
+    files: string | string[];
+    /** Working directory for glob resolution + ts-morph project. Default: process.cwd(). */
+    cwd?: string;
+    /** Virtual module specifier consumers import. Default: `virtual:fn-schema/bundle`. */
+    virtualModuleId?: string;
+}
+export declare const fnSchema: UnpluginInstance<FnSchemaPluginOptions, false>;
+export default fnSchema;
+//# sourceMappingURL=index.d.ts.map

package/dist/fn-schema/unplugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fn-schema/unplugin/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjE,OAAO,EAEL,KAAK,cAAc,EAGpB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,qBACf,SAAQ,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5D,kDAAkD;IAClD,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,wFAAwF;IACxF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAuBD,eAAO,MAAM,QAAQ,EAAE,gBAAgB,CAAC,qBAAqB,EAAE,KAAK,CA0EhE,CAAC;eAEU,QAAQ"}

package/dist/fn-schema/unplugin/index.js

@@ -0,0 +1,92 @@
+import path from "node:path";
+import { createUnplugin } from "unplugin";
+import { fileMatcher, globFiles } from "../../files.js";
+import { createProject, } from "../core/index.js";
+import { typescript } from "../typescript/index.js";
+const DEFAULT_VIRTUAL_ID = "virtual:fn-schema/bundle";
+function buildBundle(result) {
+    return {
+        $schema: "http://json-schema.org/draft-07/schema#",
+        definitions: result.definitions,
+        signatures: Object.fromEntries(result.signatures.map((s) => [
+            s.id,
+            { input: s.input, output: s.output },
+        ])),
+    };
+}
+export const fnSchema = createUnplugin((options) => {
+    const cwd = path.resolve(options.cwd ?? process.cwd());
+    const virtualId = options.virtualModuleId ?? DEFAULT_VIRTUAL_ID;
+    const resolvedId = `\0${virtualId}`;
+    const patterns = Array.isArray(options.files)
+        ? options.files
+        : [options.files];
+    let project = null;
+    let cachedSource = null;
+    let watching = false;
+    const ensureProject = () => {
+        if (project)
+            return project;
+        project = createProject({
+            cwd,
+            tsConfigPath: options.tsConfigPath,
+            extractors: [typescript()],
+        });
+        return project;
+    };
+    const generate = async () => {
+        const files = await globFiles(patterns, cwd);
+        const result = await ensureProject().extract({ ...options, files });
+        const bundle = buildBundle(result);
+        return `export default ${JSON.stringify(bundle)};`;
+    };
+    return {
+        name: "@ir-kit/fn-schema-unplugin",
+        enforce: "pre",
+        resolveId(id) {
+            if (id === virtualId)
+                return resolvedId;
+            return null;
+        },
+        async load(id) {
+            if (id !== resolvedId)
+                return null;
+            cachedSource ??= await generate();
+            return cachedSource;
+        },
+        async buildEnd() {
+            if (!watching) {
+                project?.dispose();
+                project = null;
+            }
+        },
+        vite: {
+            async configureServer(server) {
+                watching = true;
+                const matcher = fileMatcher(patterns, cwd);
+                server.watcher.add(matcher.roots);
+                const reload = (abs) => {
+                    if (!matcher.matches(abs))
+                        return;
+                    project?.refresh([abs]);
+                    cachedSource = null;
+                    const mod = server.moduleGraph.getModuleById(resolvedId);
+                    if (mod) {
+                        server.moduleGraph.invalidateModule(mod);
+                        server.ws.send({ type: "full-reload" });
+                    }
+                };
+                server.watcher.on("change", reload);
+                server.watcher.on("add", reload);
+                server.watcher.on("unlink", reload);
+                server.httpServer?.once("close", () => {
+                    watching = false;
+                    project?.dispose();
+                    project = null;
+                });
+            },
+        },
+    };
+});
+export default fnSchema;
+//# sourceMappingURL=index.js.map

package/dist/fn-schema/unplugin/index.js.map

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

package/dist/fn-schema/unplugin/rolldown.d.ts

@@ -0,0 +1,5 @@
+import { fnSchema } from "./index.js";
+declare const _default: (options: import("./index.js").FnSchemaPluginOptions) => import("unplugin").RolldownPlugin<any>;
+export default _default;
+export { fnSchema };
+//# sourceMappingURL=rolldown.d.ts.map

package/dist/fn-schema/unplugin/rolldown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rolldown.d.ts","sourceRoot":"","sources":["../../../src/fn-schema/unplugin/rolldown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;;;AAGtC,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/fn-schema/unplugin/rolldown.js

@@ -0,0 +1,4 @@
+import { fnSchema } from "./index.js";
+export default fnSchema.rolldown;
+export { fnSchema };
+//# sourceMappingURL=rolldown.js.map

package/dist/fn-schema/unplugin/rolldown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rolldown.js","sourceRoot":"","sources":["../../../src/fn-schema/unplugin/rolldown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,eAAe,QAAQ,CAAC,QAAQ,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/fn-schema/unplugin/rollup.d.ts

@@ -0,0 +1,5 @@
+import { fnSchema } from "./index.js";
+declare const _default: (options: import("./index.js").FnSchemaPluginOptions) => RollupPlugin;
+export default _default;
+export { fnSchema };
+//# sourceMappingURL=rollup.d.ts.map

package/dist/fn-schema/unplugin/rollup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollup.d.ts","sourceRoot":"","sources":["../../../src/fn-schema/unplugin/rollup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;;;AAGtC,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/fn-schema/unplugin/rollup.js

@@ -0,0 +1,4 @@
+import { fnSchema } from "./index.js";
+export default fnSchema.rollup;
+export { fnSchema };
+//# sourceMappingURL=rollup.js.map

package/dist/fn-schema/unplugin/rollup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollup.js","sourceRoot":"","sources":["../../../src/fn-schema/unplugin/rollup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,eAAe,QAAQ,CAAC,MAAM,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,CAAC"}