@gtkx/codegen 0.21.0 → 1.0.0-rc.1

package/dist/khronos/render.js

@@ -0,0 +1,158 @@
+import { lowerFirst, sourceStringLiteral, toCamelIdentifier } from "@gtkx/utils";
+import { tBind, tInlineStruct, tRef, tString, tUint8, tVoid } from "../analysis/descriptor.js";
+import { planArgs, scalarAliasOrGroup, scalarPrefixArgs, trackInto } from "./args.js";
+import { commandJsDoc, inParamDocLine, singularJsDoc } from "./jsdoc.js";
+const GL_LIB_EXPRESSION = "LIB";
+const glBind = (name, argList, returnType) => tBind({
+    libExpr: GL_LIB_EXPRESSION,
+    symbolExpr: sourceStringLiteral(name),
+    argList,
+    returnType,
+});
+const commandExportName = (name) => toCamelIdentifier(name.startsWith("gl") ? lowerFirst(name.slice(2)) : name);
+const singularize = (plural) => plural.endsWith("ies") ? `${plural.slice(0, -3)}y` : plural.replace(/s$/, "");
+const renderDescriptorList = (descriptors) => descriptors.length === 0 ? "[]" : `[${descriptors.join(", ")}]`;
+const buildEmittedReturn = (plan, returnGroup, usedTypes) => {
+    const track = trackInto(usedTypes);
+    switch (plan.kind) {
+        case "void":
+            return { tsType: "void", descriptor: tVoid };
+        case "scalar": {
+            const alias = track(scalarAliasOrGroup(plan.scalar, returnGroup));
+            return { tsType: alias, descriptor: plan.scalar.descriptor, expr: (call) => `${call} as ${alias}` };
+        }
+        case "boolean":
+            return { tsType: "boolean", descriptor: tUint8, expr: (call) => `(${call} as number) !== 0` };
+        case "string":
+            return { tsType: "string", descriptor: tString("borrowed"), expr: (call) => `${call} as string` };
+        case "sync":
+            return { tsType: track("GLsync"), descriptor: tInlineStruct(), expr: (call) => `${call} as GLsync` };
+        case "opaque-pointer":
+            return {
+                tsType: track("GLpointer"),
+                descriptor: tInlineStruct(),
+                expr: (call) => `${call} as GLpointer`,
+            };
+    }
+};
+const returnTsType = (returned, outs) => {
+    if (outs.length === 0)
+        return returned.tsType;
+    const outTypes = outs.map((out) => out.tsType);
+    if (returned.expr === undefined) {
+        return outTypes.length === 1 && outTypes[0] !== undefined ? outTypes[0] : `[${outTypes.join(", ")}]`;
+    }
+    return `[${returned.tsType}, ${outTypes.join(", ")}]`;
+};
+const returnStatements = (call, returned, outs) => {
+    if (outs.length === 0) {
+        return returned.expr === undefined ? [`${call};`] : [`return ${returned.expr(call)};`];
+    }
+    const outValues = outs.map((out) => `${out.cellName}.value`);
+    if (returned.expr === undefined) {
+        const tail = outValues.length === 1 ? `return ${outValues[0]};` : `return [${outValues.join(", ")}];`;
+        return [`${call};`, tail];
+    }
+    return [`const result = ${call};`, `return [${returned.expr("result")}, ${outValues.join(", ")}];`];
+};
+export const renderCommand = (plan, feature, usedTypes) => {
+    const { command } = plan;
+    const exportName = commandExportName(command.name);
+    const { args, ins, outs } = planArgs(plan, usedTypes);
+    const returned = buildEmittedReturn(plan.returnPlan, command.returnGroup, usedTypes);
+    const signature = ins.map((arg) => `${arg.name}: ${arg.tsType}`).join(", ");
+    const argNames = args.map((arg) => (arg.out ? arg.cellName : arg.name)).join(", ");
+    const descriptors = renderDescriptorList(args.map((arg) => arg.descriptor));
+    const tsReturn = returnTsType(returned, outs);
+    const jsDoc = commandJsDoc({ command, feature, ins, outs, returnPlan: plan.returnPlan });
+    const seeds = outs.map((out) => out.seed);
+    const bindExpression = glBind(command.name, descriptors, returned.descriptor);
+    const inline = plan.params.some((paramPlan) => paramPlan.kind === "string-out");
+    const bindingName = inline ? "binding" : toCamelIdentifier(command.name);
+    const body = [
+        ...seeds,
+        ...(inline ? [`const ${bindingName} = ${bindExpression};`] : []),
+        ...returnStatements(`${bindingName}(${argNames})`, returned, outs),
+    ]
+        .map((line) => `    ${line}`)
+        .join("\n");
+    return {
+        exportName,
+        ...(inline ? {} : { binding: `const ${bindingName} = ${bindExpression};` }),
+        declaration: `${jsDoc}\nexport function ${exportName}(${signature}): ${tsReturn} {\n${body}\n}`,
+    };
+};
+const GEN_FAMILY = /^gl(Gen|Create)[A-Z][A-Za-z]*s$/;
+const DELETE_FAMILY = /^glDelete[A-Z][A-Za-z]*s$/;
+export const deriveGenSingular = (plan, feature, usedTypes) => {
+    if (!GEN_FAMILY.test(plan.command.name))
+        return undefined;
+    const countIndex = plan.params.length - 2;
+    const outIndex = plan.params.length - 1;
+    const countPlan = plan.params[countIndex];
+    const outPlan = plan.params[outIndex];
+    const countParam = plan.command.params[countIndex];
+    const outParam = plan.command.params[outIndex];
+    if (countPlan?.kind !== "scalar" || outPlan?.kind !== "ref-array-out")
+        return undefined;
+    if (countParam === undefined || outParam === undefined)
+        return undefined;
+    if (outPlan.lenParamName !== countParam.name || outParam.objectClass === undefined)
+        return undefined;
+    const prefix = scalarPrefixArgs(plan, usedTypes);
+    if (prefix === undefined)
+        return undefined;
+    const exportName = singularize(commandExportName(plan.command.name));
+    const bindingName = `${plan.command.name}Single`;
+    const descriptors = [
+        ...prefix.map((arg) => arg.descriptor),
+        countPlan.scalar.descriptor,
+        tRef(outPlan.scalar.descriptor),
+    ];
+    usedTypes.add(outPlan.scalar.tsAlias);
+    const signature = prefix.map((arg) => `${arg.name}: ${arg.tsType}`).join(", ");
+    const callArgs = [...prefix.map((arg) => arg.name), "1", "out"].join(", ");
+    const jsDoc = singularJsDoc({
+        commandName: plan.command.name,
+        feature,
+        summary: `Returns one ${outParam.objectClass} object name via \`${plan.command.name}(${prefix.length > 0 ? "..., " : ""}1, ...)\`.`,
+        body: [
+            ...prefix.map((arg) => inParamDocLine(plan.command, arg)),
+            ` * @returns The new ${outParam.objectClass} object name`,
+        ],
+    });
+    const body = [`    const out = { value: 0 };`, `    ${bindingName}(${callArgs});`, "    return out.value;"].join("\n");
+    const binding = glBind(plan.command.name, renderDescriptorList(descriptors), tVoid);
+    return {
+        exportName,
+        binding: `const ${bindingName} = ${binding};`,
+        declaration: `${jsDoc}\nexport function ${exportName}(${signature}): ${outPlan.scalar.tsAlias} {\n${body}\n}`,
+    };
+};
+export const deriveDeleteSingular = (plan, feature, usedTypes) => {
+    if (!DELETE_FAMILY.test(plan.command.name))
+        return undefined;
+    if (plan.params.length !== 2)
+        return undefined;
+    const [countPlan, arrayPlan] = plan.params;
+    const [countParam, arrayParam] = plan.command.params;
+    if (countPlan?.kind !== "scalar" || arrayPlan?.kind !== "array-in")
+        return undefined;
+    if (countParam === undefined || arrayParam === undefined)
+        return undefined;
+    if (arrayParam.len !== countParam.name || arrayParam.objectClass === undefined)
+        return undefined;
+    const exportName = singularize(commandExportName(plan.command.name));
+    usedTypes.add(arrayPlan.scalar.tsAlias);
+    const jsDoc = singularJsDoc({
+        commandName: plan.command.name,
+        feature,
+        summary: `Deletes one ${arrayParam.objectClass} object name via \`${plan.command.name}(1, ...)\`.`,
+        body: [` * @param name - The ${arrayParam.objectClass} object name to delete`],
+    });
+    return {
+        exportName,
+        declaration: `${jsDoc}\nexport function ${exportName}(name: ${arrayPlan.scalar.tsAlias}): void {\n    ${plan.command.name}(1, [name]);\n}`,
+    };
+};
+//# sourceMappingURL=render.js.map

package/dist/khronos/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/khronos/render.ts"],"names":[],"mappings":"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","sourcesContent":["import { lowerFirst, sourceStringLiteral, toCamelIdentifier } from \"@gtkx/utils\";\nimport { tBind, tInlineStruct, tRef, tString, tUint8, tVoid } from \"../analysis/descriptor.js\";\nimport { type OutArg, planArgs, scalarAliasOrGroup, scalarPrefixArgs, trackInto } from \"./args.js\";\nimport { commandJsDoc, inParamDocLine, singularJsDoc } from \"./jsdoc.js\";\nimport type { CommandPlan, ReturnPlan } from \"./plan.js\";\n\nconst GL_LIB_EXPRESSION = \"LIB\";\n\nconst glBind = (name: string, argList: string, returnType: string): string =>\n    tBind({\n        libExpr: GL_LIB_EXPRESSION,\n        symbolExpr: sourceStringLiteral(name),\n        argList,\n        returnType,\n    });\n\nconst commandExportName = (name: string): string =>\n    toCamelIdentifier(name.startsWith(\"gl\") ? lowerFirst(name.slice(2)) : name);\n\nconst singularize = (plural: string): string =>\n    plural.endsWith(\"ies\") ? `${plural.slice(0, -3)}y` : plural.replace(/s$/, \"\");\n\nconst renderDescriptorList = (descriptors: string[]): string =>\n    descriptors.length === 0 ? \"[]\" : `[${descriptors.join(\", \")}]`;\n\nexport type RenderedCommand = {\n    exportName: string;\n    binding?: string;\n    declaration: string;\n};\n\ntype EmittedReturn = {\n    tsType: string;\n    descriptor: string;\n    expr?: (call: string) => string;\n};\n\nconst buildEmittedReturn = (\n    plan: ReturnPlan,\n    returnGroup: string | undefined,\n    usedTypes: Set<string>,\n): EmittedReturn => {\n    const track = trackInto(usedTypes);\n    switch (plan.kind) {\n        case \"void\":\n            return { tsType: \"void\", descriptor: tVoid };\n        case \"scalar\": {\n            const alias = track(scalarAliasOrGroup(plan.scalar, returnGroup));\n            return { tsType: alias, descriptor: plan.scalar.descriptor, expr: (call) => `${call} as ${alias}` };\n        }\n        case \"boolean\":\n            return { tsType: \"boolean\", descriptor: tUint8, expr: (call) => `(${call} as number) !== 0` };\n        case \"string\":\n            return { tsType: \"string\", descriptor: tString(\"borrowed\"), expr: (call) => `${call} as string` };\n        case \"sync\":\n            return { tsType: track(\"GLsync\"), descriptor: tInlineStruct(), expr: (call) => `${call} as GLsync` };\n        case \"opaque-pointer\":\n            return {\n                tsType: track(\"GLpointer\"),\n                descriptor: tInlineStruct(),\n                expr: (call) => `${call} as GLpointer`,\n            };\n    }\n};\n\nconst returnTsType = (returned: EmittedReturn, outs: OutArg[]): string => {\n    if (outs.length === 0) return returned.tsType;\n    const outTypes = outs.map((out) => out.tsType);\n    if (returned.expr === undefined) {\n        return outTypes.length === 1 && outTypes[0] !== undefined ? outTypes[0] : `[${outTypes.join(\", \")}]`;\n    }\n    return `[${returned.tsType}, ${outTypes.join(\", \")}]`;\n};\n\nconst returnStatements = (call: string, returned: EmittedReturn, outs: OutArg[]): string[] => {\n    if (outs.length === 0) {\n        return returned.expr === undefined ? [`${call};`] : [`return ${returned.expr(call)};`];\n    }\n    const outValues = outs.map((out) => `${out.cellName}.value`);\n    if (returned.expr === undefined) {\n        const tail = outValues.length === 1 ? `return ${outValues[0]};` : `return [${outValues.join(\", \")}];`;\n        return [`${call};`, tail];\n    }\n    return [`const result = ${call};`, `return [${returned.expr(\"result\")}, ${outValues.join(\", \")}];`];\n};\n\nexport const renderCommand = (\n    plan: CommandPlan & { ok: true },\n    feature: string,\n    usedTypes: Set<string>,\n): RenderedCommand => {\n    const { command } = plan;\n    const exportName = commandExportName(command.name);\n    const { args, ins, outs } = planArgs(plan, usedTypes);\n    const returned = buildEmittedReturn(plan.returnPlan, command.returnGroup, usedTypes);\n    const signature = ins.map((arg) => `${arg.name}: ${arg.tsType}`).join(\", \");\n    const argNames = args.map((arg) => (arg.out ? arg.cellName : arg.name)).join(\", \");\n    const descriptors = renderDescriptorList(args.map((arg) => arg.descriptor));\n    const tsReturn = returnTsType(returned, outs);\n    const jsDoc = commandJsDoc({ command, feature, ins, outs, returnPlan: plan.returnPlan });\n    const seeds = outs.map((out) => out.seed);\n    const bindExpression = glBind(command.name, descriptors, returned.descriptor);\n    const inline = plan.params.some((paramPlan) => paramPlan.kind === \"string-out\");\n    const bindingName = inline ? \"binding\" : toCamelIdentifier(command.name);\n    const body = [\n        ...seeds,\n        ...(inline ? [`const ${bindingName} = ${bindExpression};`] : []),\n        ...returnStatements(`${bindingName}(${argNames})`, returned, outs),\n    ]\n        .map((line) => `    ${line}`)\n        .join(\"\\n\");\n    return {\n        exportName,\n        ...(inline ? {} : { binding: `const ${bindingName} = ${bindExpression};` }),\n        declaration: `${jsDoc}\\nexport function ${exportName}(${signature}): ${tsReturn} {\\n${body}\\n}`,\n    };\n};\n\nconst GEN_FAMILY = /^gl(Gen|Create)[A-Z][A-Za-z]*s$/;\nconst DELETE_FAMILY = /^glDelete[A-Z][A-Za-z]*s$/;\n\nexport const deriveGenSingular = (\n    plan: CommandPlan & { ok: true },\n    feature: string,\n    usedTypes: Set<string>,\n): RenderedCommand | undefined => {\n    if (!GEN_FAMILY.test(plan.command.name)) return undefined;\n    const countIndex = plan.params.length - 2;\n    const outIndex = plan.params.length - 1;\n    const countPlan = plan.params[countIndex];\n    const outPlan = plan.params[outIndex];\n    const countParam = plan.command.params[countIndex];\n    const outParam = plan.command.params[outIndex];\n    if (countPlan?.kind !== \"scalar\" || outPlan?.kind !== \"ref-array-out\") return undefined;\n    if (countParam === undefined || outParam === undefined) return undefined;\n    if (outPlan.lenParamName !== countParam.name || outParam.objectClass === undefined) return undefined;\n    const prefix = scalarPrefixArgs(plan, usedTypes);\n    if (prefix === undefined) return undefined;\n    const exportName = singularize(commandExportName(plan.command.name));\n    const bindingName = `${plan.command.name}Single`;\n    const descriptors = [\n        ...prefix.map((arg) => arg.descriptor),\n        countPlan.scalar.descriptor,\n        tRef(outPlan.scalar.descriptor),\n    ];\n    usedTypes.add(outPlan.scalar.tsAlias);\n    const signature = prefix.map((arg) => `${arg.name}: ${arg.tsType}`).join(\", \");\n    const callArgs = [...prefix.map((arg) => arg.name), \"1\", \"out\"].join(\", \");\n    const jsDoc = singularJsDoc({\n        commandName: plan.command.name,\n        feature,\n        summary: `Returns one ${outParam.objectClass} object name via \\`${plan.command.name}(${prefix.length > 0 ? \"..., \" : \"\"}1, ...)\\`.`,\n        body: [\n            ...prefix.map((arg) => inParamDocLine(plan.command, arg)),\n            ` * @returns The new ${outParam.objectClass} object name`,\n        ],\n    });\n    const body = [`    const out = { value: 0 };`, `    ${bindingName}(${callArgs});`, \"    return out.value;\"].join(\n        \"\\n\",\n    );\n    const binding = glBind(plan.command.name, renderDescriptorList(descriptors), tVoid);\n    return {\n        exportName,\n        binding: `const ${bindingName} = ${binding};`,\n        declaration: `${jsDoc}\\nexport function ${exportName}(${signature}): ${outPlan.scalar.tsAlias} {\\n${body}\\n}`,\n    };\n};\n\nexport const deriveDeleteSingular = (\n    plan: CommandPlan & { ok: true },\n    feature: string,\n    usedTypes: Set<string>,\n): RenderedCommand | undefined => {\n    if (!DELETE_FAMILY.test(plan.command.name)) return undefined;\n    if (plan.params.length !== 2) return undefined;\n    const [countPlan, arrayPlan] = plan.params;\n    const [countParam, arrayParam] = plan.command.params;\n    if (countPlan?.kind !== \"scalar\" || arrayPlan?.kind !== \"array-in\") return undefined;\n    if (countParam === undefined || arrayParam === undefined) return undefined;\n    if (arrayParam.len !== countParam.name || arrayParam.objectClass === undefined) return undefined;\n    const exportName = singularize(commandExportName(plan.command.name));\n    usedTypes.add(arrayPlan.scalar.tsAlias);\n    const jsDoc = singularJsDoc({\n        commandName: plan.command.name,\n        feature,\n        summary: `Deletes one ${arrayParam.objectClass} object name via \\`${plan.command.name}(1, ...)\\`.`,\n        body: [` * @param name - The ${arrayParam.objectClass} object name to delete`],\n    });\n    return {\n        exportName,\n        declaration: `${jsDoc}\\nexport function ${exportName}(name: ${arrayPlan.scalar.tsAlias}): void {\\n    ${plan.command.name}(1, [name]);\\n}`,\n    };\n};\n"]}

package/dist/khronos/select.d.ts

@@ -0,0 +1,15 @@
+import type { GlEnum, GlRegistry } from "./model.js";
+type GlProfile = "core";
+export type GlSelection = {
+    api: string;
+    version: number;
+    profile: GlProfile;
+};
+type GlSubset = {
+    commands: Map<string, string>;
+    enums: Map<string, string>;
+};
+export declare const selectSubset: (registry: GlRegistry, selection: GlSelection) => GlSubset;
+export declare const resolveEnum: (registry: GlRegistry, name: string) => GlEnum;
+export {};
+//# sourceMappingURL=select.d.ts.map

package/dist/khronos/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../src/khronos/select.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAA+B,UAAU,EAAE,MAAM,YAAY,CAAC;AAElF,KAAK,SAAS,GAAG,MAAM,CAAC;AAExB,MAAM,MAAM,WAAW,GAAG;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF,KAAK,QAAQ,GAAG;IACZ,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B,CAAC;AAmCF,eAAO,MAAM,YAAY,aAAc,UAAU,aAAa,WAAW,KAAG,QAU3E,CAAC;AAEF,eAAO,MAAM,WAAW,aAAc,UAAU,QAAQ,MAAM,KAAG,MAMhE,CAAC"}

package/dist/khronos/select.js

@@ -0,0 +1,45 @@
+const blockApplies = (block, selection) => block.profile === undefined || block.profile === selection.profile;
+const applyRequires = (feature, selection, commands, enums) => {
+    for (const block of feature.requires) {
+        if (!blockApplies(block, selection))
+            continue;
+        for (const name of block.commands) {
+            if (!commands.has(name))
+                commands.set(name, feature.name);
+        }
+        for (const name of block.enums) {
+            if (!enums.has(name))
+                enums.set(name, feature.name);
+        }
+    }
+};
+const applyRemoves = (feature, selection, commands, enums) => {
+    for (const block of feature.removes) {
+        if (!blockApplies(block, selection))
+            continue;
+        for (const name of block.commands)
+            commands.delete(name);
+        for (const name of block.enums)
+            enums.delete(name);
+    }
+};
+export const selectSubset = (registry, selection) => {
+    const features = registry.features
+        .filter((feature) => feature.api === selection.api && feature.number <= selection.version)
+        .sort((a, b) => a.number - b.number);
+    const commands = new Map();
+    const enums = new Map();
+    for (const feature of features)
+        applyRequires(feature, selection, commands, enums);
+    for (const feature of features)
+        applyRemoves(feature, selection, commands, enums);
+    return { commands, enums };
+};
+export const resolveEnum = (registry, name) => {
+    const found = registry.enums.find((candidate) => candidate.name === name);
+    if (found === undefined) {
+        throw new Error(`Enum token ${name} has no definition in the registry`);
+    }
+    return found;
+};
+//# sourceMappingURL=select.js.map

package/dist/khronos/select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.js","sourceRoot":"","sources":["../../src/khronos/select.ts"],"names":[],"mappings":"AAeA,MAAM,YAAY,GAAG,CAAC,KAAuB,EAAE,SAAsB,EAAW,EAAE,CAC9E,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,OAAO,CAAC;AAEvE,MAAM,aAAa,GAAG,CAClB,OAAkB,EAClB,SAAsB,EACtB,QAA6B,EAC7B,KAA0B,EACtB,EAAE;IACN,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACnC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC;YAAE,SAAS;QAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAChC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9D,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACxD,CAAC;IACL,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CACjB,OAAkB,EAClB,SAAsB,EACtB,QAA6B,EAC7B,KAA0B,EACtB,EAAE;IACN,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAClC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC;YAAE,SAAS;QAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ;YAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK;YAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAoB,EAAE,SAAsB,EAAY,EAAE;IACnF,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ;SAC7B,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,GAAG,IAAI,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC,OAAO,CAAC;SACzF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;IAEzC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,KAAK,MAAM,OAAO,IAAI,QAAQ;QAAE,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IACnF,KAAK,MAAM,OAAO,IAAI,QAAQ;QAAE,YAAY,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IAClF,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC/B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAoB,EAAE,IAAY,EAAU,EAAE;IACtE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC1E,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,oCAAoC,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC","sourcesContent":["import type { GlEnum, GlFeature, GlInterfaceBlock, GlRegistry } from \"./model.js\";\n\ntype GlProfile = \"core\";\n\nexport type GlSelection = {\n    api: string;\n    version: number;\n    profile: GlProfile;\n};\n\ntype GlSubset = {\n    commands: Map<string, string>;\n    enums: Map<string, string>;\n};\n\nconst blockApplies = (block: GlInterfaceBlock, selection: GlSelection): boolean =>\n    block.profile === undefined || block.profile === selection.profile;\n\nconst applyRequires = (\n    feature: GlFeature,\n    selection: GlSelection,\n    commands: Map<string, string>,\n    enums: Map<string, string>,\n): void => {\n    for (const block of feature.requires) {\n        if (!blockApplies(block, selection)) continue;\n        for (const name of block.commands) {\n            if (!commands.has(name)) commands.set(name, feature.name);\n        }\n        for (const name of block.enums) {\n            if (!enums.has(name)) enums.set(name, feature.name);\n        }\n    }\n};\n\nconst applyRemoves = (\n    feature: GlFeature,\n    selection: GlSelection,\n    commands: Map<string, string>,\n    enums: Map<string, string>,\n): void => {\n    for (const block of feature.removes) {\n        if (!blockApplies(block, selection)) continue;\n        for (const name of block.commands) commands.delete(name);\n        for (const name of block.enums) enums.delete(name);\n    }\n};\n\nexport const selectSubset = (registry: GlRegistry, selection: GlSelection): GlSubset => {\n    const features = registry.features\n        .filter((feature) => feature.api === selection.api && feature.number <= selection.version)\n        .sort((a, b) => a.number - b.number);\n\n    const commands = new Map<string, string>();\n    const enums = new Map<string, string>();\n    for (const feature of features) applyRequires(feature, selection, commands, enums);\n    for (const feature of features) applyRemoves(feature, selection, commands, enums);\n    return { commands, enums };\n};\n\nexport const resolveEnum = (registry: GlRegistry, name: string): GlEnum => {\n    const found = registry.enums.find((candidate) => candidate.name === name);\n    if (found === undefined) {\n        throw new Error(`Enum token ${name} has no definition in the registry`);\n    }\n    return found;\n};\n"]}

package/dist/runner.d.ts

@@ -1,55 +1,37 @@
-import { type GiStoreOptions } from "./gi-store.js";
-import { type JsxStoreOptions } from "./jsx-store.js";
-/**
- * Options for {@link CodegenRunner}.
- */
+import type { ElementProp } from "@gtkx/config";
+import { type GlGenerationReport } from "./khronos/pipeline.js";
+import { type GiStoreOptions } from "./store/gi-store.js";
+import { type JsxStoreOptions } from "./store/jsx-store.js";
+export type GlCodegenOptions = {
+    registryPath: string;
+    overrideExports: Set<string>;
+    outputDir: string;
+    resolveFrom: string;
+};
 export type CodegenRunnerOptions = {
-    /** Resolved `Name-Version` namespace identifiers to generate. */
-    readonly libraries: readonly string[];
-    /** Directories searched for `.gir` files. */
-    readonly girPath: readonly string[];
-    /** Optional user slot-prop overrides keyed by JSX element name. */
-    readonly slotProps?: Readonly<Record<string, readonly string[]>>;
-    /** Target for the injected `@gtkx/gi` bindings package. */
-    readonly gi: GiStoreOptions;
-    /** Target for the injected `@gtkx/react-jsx` unit; React is skipped when omitted. */
-    readonly jsx?: JsxStoreOptions;
+    libraries?: string[];
+    girPath?: string[];
+    elementProps?: Record<string, ElementProp[]> | undefined;
+    gi?: GiStoreOptions;
+    jsx?: JsxStoreOptions | undefined;
+    gl?: GlCodegenOptions;
+    force?: boolean;
 };
-/**
- * Result returned from {@link CodegenRunner.run}.
- */
 export type CodegenRunnerResult = {
-    /** Number of FFI namespaces produced. */
-    readonly namespaces: number;
-    /** Number of widget intrinsics emitted into `jsx.ts`. */
-    readonly widgets: number;
-    /** Wall-clock duration in milliseconds. */
-    readonly duration: number;
+    regenerated: boolean;
+    namespaces: number;
+    intrinsicElements: number;
+    duration: number;
+    gl?: GlGenerationReport | undefined;
 };
 /**
- * Single-entry orchestrator for the GTKX codegen.
- *
- * Loads the GIR repository, runs the FFI pipeline per namespace, runs the
- * React pipeline once, and materializes the self-contained `@gtkx/gi` (and
- * optional `@gtkx/react-jsx`) packages into the project's `node_modules`.
- *
- * @example
- * ```ts
- * import { CodegenRunner } from "@gtkx/codegen";
+ * Runs the `@gtkx` code generators, producing the `@gtkx/gi`, `@gtkx/jsx`, and `@gtkx/gl` bindings from the
+ * configured GObject-introspection libraries and OpenGL registry. The gi store is regenerated only when its
+ * fingerprint is stale unless `options.force` is set, while the OpenGL modules are regenerated whenever
+ * `options.gl` is provided.
  *
- * await new CodegenRunner({
- *     libraries: ["Gtk-4.0", "Adw-1"],
- *     girPath: ["/usr/share/gir-1.0"],
- *     gi: { storeDir, linkDir, realFfiDir, realNativeDir, version },
- * }).run();
- * ```
+ * @param options - What to generate and where to write it.
+ * @returns A summary of what was regenerated and how long the run took.
  */
-export declare class CodegenRunner {
-    private readonly options;
-    constructor(options: CodegenRunnerOptions);
-    /**
-     * Executes the full codegen pipeline and materializes the output packages.
-     */
-    run(): Promise<CodegenRunnerResult>;
-}
+export declare const runCodegen: (options: CodegenRunnerOptions) => Promise<CodegenRunnerResult>;
 //# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyB,KAAK,cAAc,EAAgB,MAAM,eAAe,CAAC;AAEzF,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,gBAAgB,CAAC;AAGrE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,mEAAmE;IACnE,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IACjE,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAC5B,qFAAqF;IACrF,QAAQ,CAAC,GAAG,CAAC,EAAE,eAAe,CAAC;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,aAAa;IACV,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,oBAAoB;IAE1D;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,mBAAmB,CAAC;CA6B5C"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAKhD,OAAO,EAAE,KAAK,kBAAkB,EAAqB,MAAM,uBAAuB,CAAC;AAEnF,OAAO,EAAyB,KAAK,cAAc,EAAgB,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,sBAAsB,CAAC;AAG3E,MAAM,MAAM,gBAAgB,GAAG;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAC/B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,GAAG,SAAS,CAAC;IACzD,EAAE,CAAC,EAAE,cAAc,CAAC;IACpB,GAAG,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAClC,EAAE,CAAC,EAAE,gBAAgB,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;CACvC,CAAC;AAOF;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,YAAmB,oBAAoB,KAAG,OAAO,CAAC,mBAAmB,CAW3F,CAAC"}

package/dist/runner.js

@@ -1,60 +1,85 @@
-import { generateNamespaceModule } from "./ffi/pipeline.js";
-import { computeFingerprint } from "./fingerprint.js";
-import { writeGiStore } from "./gi-store.js";
-import { loadGirRepository } from "./gir/repository.js";
-import { writeJsxStore } from "./jsx-store.js";
-import { generateReactFiles } from "./react/pipeline.js";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { checkModules } from "./compile.js";
+import { computeFingerprint, isStoreFresh } from "./fingerprint.js";
+import { Library } from "./gir/library.js";
+import { namespaceDirectory } from "./gir/namespace.js";
+import { generateGlModules } from "./khronos/pipeline.js";
+import { generateNamespaceModule } from "./store/gi/pipeline.js";
+import { writeGiStore } from "./store/gi-store.js";
+import { writeJsxStore } from "./store/jsx-store.js";
+import { generateJsxFiles } from "./store/react/pipeline.js";
 /**
- * Single-entry orchestrator for the GTKX codegen.
+ * Runs the `@gtkx` code generators, producing the `@gtkx/gi`, `@gtkx/jsx`, and `@gtkx/gl` bindings from the
+ * configured GObject-introspection libraries and OpenGL registry. The gi store is regenerated only when its
+ * fingerprint is stale unless `options.force` is set, while the OpenGL modules are regenerated whenever
+ * `options.gl` is provided.
  *
- * Loads the GIR repository, runs the FFI pipeline per namespace, runs the
- * React pipeline once, and materializes the self-contained `@gtkx/gi` (and
- * optional `@gtkx/react-jsx`) packages into the project's `node_modules`.
- *
- * @example
- * ```ts
- * import { CodegenRunner } from "@gtkx/codegen";
- *
- * await new CodegenRunner({
- *     libraries: ["Gtk-4.0", "Adw-1"],
- *     girPath: ["/usr/share/gir-1.0"],
- *     gi: { storeDir, linkDir, realFfiDir, realNativeDir, version },
- * }).run();
- * ```
+ * @param options - What to generate and where to write it.
+ * @returns A summary of what was regenerated and how long the run took.
  */
-export class CodegenRunner {
-    options;
-    constructor(options) {
-        this.options = options;
+export const runCodegen = async (options) => {
+    const start = Date.now();
+    const gl = options.gl === undefined ? undefined : emitGlModules(options.gl);
+    const gi = emitGiStoreIfStale(options);
+    return {
+        regenerated: gi !== undefined,
+        namespaces: gi?.namespaces ?? 0,
+        intrinsicElements: gi?.intrinsicElements ?? 0,
+        duration: Date.now() - start,
+        gl,
+    };
+};
+const emitGlModules = (options) => {
+    const { files, report } = generateGlModules({
+        registryPath: options.registryPath,
+        overrideExports: options.overrideExports,
+    });
+    checkModules({
+        modules: [...files].map(([fileName, source]) => ({ fileName, source })),
+        resolveFrom: options.resolveFrom,
+        label: "the generated gl modules",
+    });
+    mkdirSync(options.outputDir, { recursive: true });
+    for (const [fileName, source] of files) {
+        writeFileSync(join(options.outputDir, fileName), source);
     }
-    /**
-     * Executes the full codegen pipeline and materializes the output packages.
-     */
-    async run() {
-        const start = Date.now();
-        const repository = loadGirRepository(this.options.libraries, this.options.girPath);
-        const namespaces = [];
-        for (const namespace of repository.namespaces.values()) {
-            const { source } = generateNamespaceModule(namespace, repository);
-            namespaces.push({ directory: namespace.name.toLowerCase(), rawSource: source });
-        }
-        const libraries = [...this.options.libraries];
-        writeGiStore(this.options.gi, namespaces, {
-            value: computeFingerprint(repository.girFiles, libraries),
-            girFiles: repository.girFiles,
-            libraries,
+    return report;
+};
+const emitGiStoreIfStale = (options) => {
+    const { gi, libraries, girPath } = options;
+    if (gi === undefined || libraries === undefined || girPath === undefined)
+        return undefined;
+    const elementProps = options.elementProps ?? {};
+    if (options.force !== true && isStoreFresh(gi.storeDir, libraries, elementProps))
+        return undefined;
+    const library = Library.load(libraries, girPath);
+    emitGiStore(gi, libraries, elementProps, library);
+    return {
+        namespaces: library.namespaces.size,
+        intrinsicElements: emitJsxStore(options.jsx, elementProps, library),
+    };
+};
+const emitGiStore = (gi, libraries, elementProps, library) => {
+    const namespaces = [];
+    for (const namespace of library.namespaces.values()) {
+        namespaces.push({
+            directory: namespaceDirectory(namespace),
+            rawSource: generateNamespaceModule(namespace, library),
         });
-        let widgetCount = 0;
-        if (this.options.jsx !== undefined) {
-            const reactPipeline = generateReactFiles(repository, this.options.slotProps);
-            writeJsxStore(this.options.jsx, reactPipeline.files);
-            widgetCount = reactPipeline.widgetCount;
-        }
-        return {
-            namespaces: repository.namespaces.size,
-            widgets: widgetCount,
-            duration: Date.now() - start,
-        };
     }
-}
+    const libs = [...libraries];
+    writeGiStore(gi, namespaces, {
+        value: computeFingerprint(library.girFiles, libs, elementProps),
+        girFiles: library.girFiles,
+        libraries: libs,
+    });
+};
+const emitJsxStore = (jsx, elementProps, library) => {
+    if (jsx === undefined)
+        return 0;
+    const reactPipeline = generateJsxFiles(library, elementProps);
+    writeJsxStore(jsx, reactPipeline.namespaces, reactPipeline.metadata);
+    return reactPipeline.intrinsicElementCount;
+};
 //# sourceMappingURL=runner.js.map

package/dist/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAA8C,YAAY,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAwB,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AA8BzD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,aAAa;IACO;IAA7B,YAA6B,OAA6B;QAA7B,YAAO,GAAP,OAAO,CAAsB;IAAG,CAAC;IAE9D;;OAEG;IACH,KAAK,CAAC,GAAG;QACL,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAEnF,MAAM,UAAU,GAAuB,EAAE,CAAC;QAC1C,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;YACrD,MAAM,EAAE,MAAM,EAAE,GAAG,uBAAuB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YAClE,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9C,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,EAAE;YACtC,KAAK,EAAE,kBAAkB,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC;YACzD,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,SAAS;SACZ,CAAC,CAAC;QAEH,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,aAAa,GAAG,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAC7E,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;YACrD,WAAW,GAAG,aAAa,CAAC,WAAW,CAAC;QAC5C,CAAC;QAED,OAAO;YACH,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,IAAI;YACtC,OAAO,EAAE,WAAW;YACpB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAC/B,CAAC;IACN,CAAC;CACJ"}
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdirSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { ElementProp } from \"@gtkx/config\";\nimport { checkModules } from \"./compile.js\";\nimport { computeFingerprint, isStoreFresh } from \"./fingerprint.js\";\nimport { Library } from \"./gir/library.js\";\nimport { namespaceDirectory } from \"./gir/namespace.js\";\nimport { type GlGenerationReport, generateGlModules } from \"./khronos/pipeline.js\";\nimport { generateNamespaceModule } from \"./store/gi/pipeline.js\";\nimport { type GiNamespaceInput, type GiStoreOptions, writeGiStore } from \"./store/gi-store.js\";\nimport { type JsxStoreOptions, writeJsxStore } from \"./store/jsx-store.js\";\nimport { generateJsxFiles } from \"./store/react/pipeline.js\";\n\nexport type GlCodegenOptions = {\n    registryPath: string;\n    overrideExports: Set<string>;\n    outputDir: string;\n    resolveFrom: string;\n};\n\nexport type CodegenRunnerOptions = {\n    libraries?: string[];\n    girPath?: string[];\n    elementProps?: Record<string, ElementProp[]> | undefined;\n    gi?: GiStoreOptions;\n    jsx?: JsxStoreOptions | undefined;\n    gl?: GlCodegenOptions;\n    force?: boolean;\n};\n\nexport type CodegenRunnerResult = {\n    regenerated: boolean;\n    namespaces: number;\n    intrinsicElements: number;\n    duration: number;\n    gl?: GlGenerationReport | undefined;\n};\n\ntype GiEmitResult = {\n    namespaces: number;\n    intrinsicElements: number;\n};\n\n/**\n * Runs the `@gtkx` code generators, producing the `@gtkx/gi`, `@gtkx/jsx`, and `@gtkx/gl` bindings from the\n * configured GObject-introspection libraries and OpenGL registry. The gi store is regenerated only when its\n * fingerprint is stale unless `options.force` is set, while the OpenGL modules are regenerated whenever\n * `options.gl` is provided.\n *\n * @param options - What to generate and where to write it.\n * @returns A summary of what was regenerated and how long the run took.\n */\nexport const runCodegen = async (options: CodegenRunnerOptions): Promise<CodegenRunnerResult> => {\n    const start = Date.now();\n    const gl = options.gl === undefined ? undefined : emitGlModules(options.gl);\n    const gi = emitGiStoreIfStale(options);\n    return {\n        regenerated: gi !== undefined,\n        namespaces: gi?.namespaces ?? 0,\n        intrinsicElements: gi?.intrinsicElements ?? 0,\n        duration: Date.now() - start,\n        gl,\n    };\n};\n\nconst emitGlModules = (options: GlCodegenOptions): GlGenerationReport => {\n    const { files, report } = generateGlModules({\n        registryPath: options.registryPath,\n        overrideExports: options.overrideExports,\n    });\n    checkModules({\n        modules: [...files].map(([fileName, source]) => ({ fileName, source })),\n        resolveFrom: options.resolveFrom,\n        label: \"the generated gl modules\",\n    });\n    mkdirSync(options.outputDir, { recursive: true });\n    for (const [fileName, source] of files) {\n        writeFileSync(join(options.outputDir, fileName), source);\n    }\n    return report;\n};\n\nconst emitGiStoreIfStale = (options: CodegenRunnerOptions): GiEmitResult | undefined => {\n    const { gi, libraries, girPath } = options;\n    if (gi === undefined || libraries === undefined || girPath === undefined) return undefined;\n    const elementProps = options.elementProps ?? {};\n    if (options.force !== true && isStoreFresh(gi.storeDir, libraries, elementProps)) return undefined;\n    const library = Library.load(libraries, girPath);\n    emitGiStore(gi, libraries, elementProps, library);\n    return {\n        namespaces: library.namespaces.size,\n        intrinsicElements: emitJsxStore(options.jsx, elementProps, library),\n    };\n};\n\nconst emitGiStore = (\n    gi: GiStoreOptions,\n    libraries: string[],\n    elementProps: Record<string, ElementProp[]>,\n    library: Library,\n): void => {\n    const namespaces: GiNamespaceInput[] = [];\n    for (const namespace of library.namespaces.values()) {\n        namespaces.push({\n            directory: namespaceDirectory(namespace),\n            rawSource: generateNamespaceModule(namespace, library),\n        });\n    }\n    const libs = [...libraries];\n    writeGiStore(gi, namespaces, {\n        value: computeFingerprint(library.girFiles, libs, elementProps),\n        girFiles: library.girFiles,\n        libraries: libs,\n    });\n};\n\nconst emitJsxStore = (\n    jsx: JsxStoreOptions | undefined,\n    elementProps: Record<string, ElementProp[]>,\n    library: Library,\n): number => {\n    if (jsx === undefined) return 0;\n    const reactPipeline = generateJsxFiles(library, elementProps);\n    writeJsxStore(jsx, reactPipeline.namespaces, reactPipeline.metadata);\n    return reactPipeline.intrinsicElementCount;\n};\n"]}

package/dist/store/compile-store.d.ts

@@ -0,0 +1,9 @@
+import { type SourceModule } from "../compile.js";
+export type CompileStoreParams = {
+    storeDir: string;
+    files: SourceModule[];
+    packageName: string;
+    exports: Record<string, unknown>;
+};
+export declare const compileStore: (params: CompileStoreParams) => void;
+//# sourceMappingURL=compile-store.d.ts.map

package/dist/store/compile-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-store.d.ts","sourceRoot":"","sources":["../../src/store/compile-store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAElE,MAAM,MAAM,kBAAkB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AA4BF,eAAO,MAAM,YAAY,WAAY,kBAAkB,KAAG,IAWzD,CAAC"}

package/dist/store/compile-store.js

@@ -0,0 +1,38 @@
+import { rmSync } from "node:fs";
+import { join } from "node:path";
+import { compileProject } from "../compile.js";
+const EMIT_OPTIONS = {
+    declaration: true,
+    removeComments: false,
+    sourceMap: false,
+    declarationMap: false,
+    noEmitOnError: true,
+    rootDir: ".",
+    outDir: ".",
+};
+const selfPaths = (packageName, exportsMap, storeDir) => {
+    const paths = {};
+    for (const [key, value] of Object.entries(exportsMap)) {
+        if (key === "./package.json" || typeof value !== "object" || value === null)
+            continue;
+        const target = value.default;
+        if (typeof target !== "string")
+            continue;
+        const stem = target.replace(/^\.\//, "").replace(/\.js$/, "");
+        paths[`${packageName}${key.slice(1)}`] = [join(storeDir, stem)];
+    }
+    return paths;
+};
+export const compileStore = (params) => {
+    compileProject({
+        projectDir: params.storeDir,
+        fileNames: params.files.map((file) => file.fileName),
+        compilerOptions: EMIT_OPTIONS,
+        paths: selfPaths(params.packageName, params.exports, params.storeDir),
+        label: `the generated ${params.packageName} store`,
+    });
+    for (const file of params.files) {
+        rmSync(join(params.storeDir, file.fileName), { force: true });
+    }
+};
+//# sourceMappingURL=compile-store.js.map

package/dist/store/compile-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-store.js","sourceRoot":"","sources":["../../src/store/compile-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAqB,MAAM,eAAe,CAAC;AASlE,MAAM,YAAY,GAAG;IACjB,WAAW,EAAE,IAAI;IACjB,cAAc,EAAE,KAAK;IACrB,SAAS,EAAE,KAAK;IAChB,cAAc,EAAE,KAAK;IACrB,aAAa,EAAE,IAAI;IACnB,OAAO,EAAE,GAAG;IACZ,MAAM,EAAE,GAAG;CACd,CAAC;AAEF,MAAM,SAAS,GAAG,CACd,WAAmB,EACnB,UAAmC,EACnC,QAAgB,EACQ,EAAE;IAC1B,MAAM,KAAK,GAA6B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACpD,IAAI,GAAG,KAAK,gBAAgB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QACtF,MAAM,MAAM,GAAI,KAA+B,CAAC,OAAO,CAAC;QACxD,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,SAAS;QACzC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC9D,KAAK,CAAC,GAAG,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAA0B,EAAQ,EAAE;IAC7D,cAAc,CAAC;QACX,UAAU,EAAE,MAAM,CAAC,QAAQ;QAC3B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;QACpD,eAAe,EAAE,YAAY;QAC7B,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC;QACrE,KAAK,EAAE,iBAAiB,MAAM,CAAC,WAAW,QAAQ;KACrD,CAAC,CAAC;IACH,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;AACL,CAAC,CAAC","sourcesContent":["import { rmSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { compileProject, type SourceModule } from \"../compile.js\";\n\nexport type CompileStoreParams = {\n    storeDir: string;\n    files: SourceModule[];\n    packageName: string;\n    exports: Record<string, unknown>;\n};\n\nconst EMIT_OPTIONS = {\n    declaration: true,\n    removeComments: false,\n    sourceMap: false,\n    declarationMap: false,\n    noEmitOnError: true,\n    rootDir: \".\",\n    outDir: \".\",\n};\n\nconst selfPaths = (\n    packageName: string,\n    exportsMap: Record<string, unknown>,\n    storeDir: string,\n): Record<string, string[]> => {\n    const paths: Record<string, string[]> = {};\n    for (const [key, value] of Object.entries(exportsMap)) {\n        if (key === \"./package.json\" || typeof value !== \"object\" || value === null) continue;\n        const target = (value as { default?: unknown }).default;\n        if (typeof target !== \"string\") continue;\n        const stem = target.replace(/^\\.\\//, \"\").replace(/\\.js$/, \"\");\n        paths[`${packageName}${key.slice(1)}`] = [join(storeDir, stem)];\n    }\n    return paths;\n};\n\nexport const compileStore = (params: CompileStoreParams): void => {\n    compileProject({\n        projectDir: params.storeDir,\n        fileNames: params.files.map((file) => file.fileName),\n        compilerOptions: EMIT_OPTIONS,\n        paths: selfPaths(params.packageName, params.exports, params.storeDir),\n        label: `the generated ${params.packageName} store`,\n    });\n    for (const file of params.files) {\n        rmSync(join(params.storeDir, file.fileName), { force: true });\n    }\n};\n"]}

package/dist/store/gi/async.d.ts

@@ -0,0 +1,4 @@
+import type { GirFunction } from "../../gir/function.js";
+import type { Library } from "../../gir/library.js";
+export declare const matchAsyncFinish: (library: Library, fn: GirFunction, siblings: GirFunction[]) => GirFunction | undefined;
+//# sourceMappingURL=async.d.ts.map

package/dist/store/gi/async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../../../src/store/gi/async.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,eAAO,MAAM,gBAAgB,YAChB,OAAO,MACZ,WAAW,YACL,WAAW,EAAE,KACxB,WAAW,GAAG,SAOhB,CAAC"}