@gtkx/codegen 0.21.0 → 1.0.0-rc.2

package/dist/khronos/plan.js

@@ -0,0 +1,200 @@
+import { tScalar } from "../analysis/descriptor.js";
+const GL_SCALARS = new Map([
+    ["GLenum", { descriptor: tScalar("uint32"), tsAlias: "GLenum", viewType: "Uint32Array", groupBearing: true }],
+    [
+        "GLbitfield",
+        { descriptor: tScalar("uint32"), tsAlias: "GLbitfield", viewType: "Uint32Array", groupBearing: true },
+    ],
+    ["GLuint", { descriptor: tScalar("uint32"), tsAlias: "GLuint", viewType: "Uint32Array" }],
+    ["GLint", { descriptor: tScalar("int32"), tsAlias: "GLint", viewType: "Int32Array" }],
+    ["GLsizei", { descriptor: tScalar("int32"), tsAlias: "GLsizei", viewType: "Int32Array" }],
+    ["GLbyte", { descriptor: tScalar("int8"), tsAlias: "GLbyte", viewType: "Int8Array" }],
+    ["GLubyte", { descriptor: tScalar("uint8"), tsAlias: "GLubyte", viewType: "Uint8Array" }],
+    ["GLshort", { descriptor: tScalar("int16"), tsAlias: "GLshort", viewType: "Int16Array" }],
+    ["GLushort", { descriptor: tScalar("uint16"), tsAlias: "GLushort", viewType: "Uint16Array" }],
+    ["GLfloat", { descriptor: tScalar("float32"), tsAlias: "GLfloat", viewType: "Float32Array" }],
+    ["GLdouble", { descriptor: tScalar("float64"), tsAlias: "GLdouble", viewType: "Float64Array" }],
+    ["GLint64", { descriptor: tScalar("int64"), tsAlias: "GLint64" }],
+    ["GLuint64", { descriptor: tScalar("uint64"), tsAlias: "GLuint64" }],
+    ["GLintptr", { descriptor: tScalar("int64"), tsAlias: "GLintptr" }],
+    ["GLsizeiptr", { descriptor: tScalar("int64"), tsAlias: "GLsizeiptr" }],
+]);
+const GL_BOOLEAN = "GLboolean";
+const GL_CHAR = "GLchar";
+const GL_SYNC = "GLsync";
+const CALLBACK_BASES = new Set(["GLDEBUGPROC", "GLDEBUGPROCARB", "GLDEBUGPROCKHR", "GLVULKANPROCNV"]);
+const parseCType = (cType) => {
+    const pointers = (cType.match(/\*/g) ?? []).length;
+    const isConstData = /(^|\s)const(\s|\*)/.test(` ${cType} `) && pointers > 0;
+    const base = cType
+        .replaceAll("*", " ")
+        .split(/\s+/)
+        .filter((token) => token.length > 0 && token !== "const" && token !== "struct")
+        .join(" ");
+    return { base, pointers, constData: isConstData };
+};
+const isCompsize = (len) => len.includes("COMPSIZE(");
+const planCompsizeOut = (command, scalar, policy) => {
+    if (policy.singleValuedQueries.has(command.name)) {
+        return { plan: { kind: "ref-out", scalar } };
+    }
+    return { reason: "compsize-output" };
+};
+const planPointerOut = (command, param, scalar, policy) => {
+    const len = param.len;
+    if (len === undefined || len === "1") {
+        return { plan: { kind: "ref-out", scalar } };
+    }
+    if (isCompsize(len)) {
+        return planCompsizeOut(command, scalar, policy);
+    }
+    if (/^\d+$/.test(len)) {
+        return { plan: { kind: "ref-fixed-out", scalar, length: Number(len) } };
+    }
+    if (command.params.some((other) => other.name === len)) {
+        return { plan: { kind: "ref-array-out", scalar, lenParamName: len } };
+    }
+    return { reason: "computed-output-length" };
+};
+const planByteOffsetParam = (parsed) => {
+    if (parsed.pointers === 1) {
+        return { plan: { kind: "byte-offset" } };
+    }
+    if (parsed.pointers === 2) {
+        return { plan: { kind: "byte-offset-array" } };
+    }
+    return { reason: "unsupported-shape" };
+};
+const charStringOutLen = (command, param, parsed) => {
+    if (parsed.pointers !== 1) {
+        return undefined;
+    }
+    const len = param.len;
+    if (len === undefined) {
+        return undefined;
+    }
+    return command.params.some((other) => other.name === len) ? len : undefined;
+};
+const planCharParam = (command, param, parsed) => {
+    if (parsed.pointers === 1 && parsed.constData) {
+        return { plan: { kind: "string-in" } };
+    }
+    if (parsed.pointers === 2 && parsed.constData) {
+        return { plan: { kind: "string-array-in" } };
+    }
+    const lenParamName = charStringOutLen(command, param, parsed);
+    if (lenParamName !== undefined) {
+        return { plan: { kind: "string-out", lenParamName } };
+    }
+    return { reason: "unsupported-shape" };
+};
+const planScalarParam = (command, param, parsed, policy) => {
+    const scalar = GL_SCALARS.get(parsed.base);
+    if (scalar === undefined) {
+        throw new Error(`Unmapped C base type "${parsed.base}" on ${command.name}(${param.name}: ${param.cType})`);
+    }
+    if (parsed.pointers === 0) {
+        return { plan: { kind: "scalar", scalar } };
+    }
+    if (parsed.pointers === 1 && parsed.constData) {
+        return { plan: { kind: "array-in", scalar } };
+    }
+    if (parsed.pointers === 1) {
+        return planPointerOut(command, param, scalar, policy);
+    }
+    return { reason: "unsupported-shape" };
+};
+const planVoidParam = (parsed) => {
+    if (parsed.pointers === 1) {
+        return { plan: { kind: "buffer" } };
+    }
+    return { reason: "unsupported-shape" };
+};
+const planBooleanParam = (parsed) => {
+    if (parsed.pointers === 0) {
+        return { plan: { kind: "boolean" } };
+    }
+    return { reason: "unsupported-shape" };
+};
+const planCharOrBoolean = (command, param, parsed) => {
+    if (parsed.base === GL_CHAR || parsed.base === "GLcharARB") {
+        return planCharParam(command, param, parsed);
+    }
+    if (parsed.base === GL_BOOLEAN) {
+        return planBooleanParam(parsed);
+    }
+    return undefined;
+};
+const planByBase = (command, param, parsed, policy) => {
+    const { base, pointers } = parsed;
+    if (base === GL_SYNC && pointers === 0) {
+        return { plan: { kind: "sync" } };
+    }
+    if (base === "void") {
+        return planVoidParam(parsed);
+    }
+    return planCharOrBoolean(command, param, parsed) ?? planScalarParam(command, param, parsed, policy);
+};
+const planParam = (command, param, policy) => {
+    const parsed = parseCType(param.cType);
+    const { base } = parsed;
+    if (CALLBACK_BASES.has(base) || base.startsWith("_cl_")) {
+        return { reason: "callback-parameter" };
+    }
+    if (policy.byteOffsetParams.has(`${command.name}:${param.name}`)) {
+        return planByteOffsetParam(parsed);
+    }
+    return planByBase(command, param, parsed, policy);
+};
+const planScalarReturn = (base) => {
+    if (base === "void") {
+        return { kind: "void" };
+    }
+    if (base === GL_SYNC) {
+        return { kind: "sync" };
+    }
+    if (base === GL_BOOLEAN) {
+        return { kind: "boolean" };
+    }
+    const scalar = GL_SCALARS.get(base);
+    if (scalar !== undefined) {
+        return { kind: "scalar", scalar };
+    }
+    return undefined;
+};
+const planPointerReturn = (base) => {
+    if (base === "void") {
+        return { kind: "opaque-pointer" };
+    }
+    if (base === "GLubyte" || base === GL_CHAR) {
+        return { kind: "string" };
+    }
+    return undefined;
+};
+const planReturn = (command) => {
+    const { base, pointers } = parseCType(command.returnCType);
+    let plan;
+    if (pointers === 0) {
+        plan = planScalarReturn(base);
+    }
+    else if (pointers === 1) {
+        plan = planPointerReturn(base);
+    }
+    if (plan !== undefined) {
+        return plan;
+    }
+    throw new Error(`Unmapped return type "${command.returnCType}" on ${command.name}`);
+};
+const planCommand = (command, policy) => {
+    const params = [];
+    for (const param of command.params) {
+        const outcome = planParam(command, param, policy);
+        if ("reason" in outcome) {
+            return { ok: false, command, reason: outcome.reason };
+        }
+        params.push(outcome.plan);
+    }
+    return { ok: true, command, params, returnPlan: planReturn(command) };
+};
+export { GL_SCALARS, parseCType, planCommand, };
+//# sourceMappingURL=plan.js.map

package/dist/khronos/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/khronos/plan.ts"],"names":[],"mappings":"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","sourcesContent":["import type { GlCommand, GlParam } from \"./model.js\";\nimport { tScalar } from \"../analysis/descriptor.js\";\n\ntype GlScalar = {\n    descriptor: string;\n    tsAlias: string;\n    viewType?: string;\n    groupBearing?: boolean;\n};\n\ntype ParsedCType = {\n    base: string;\n    pointers: number;\n    constData: boolean;\n};\n\ntype ParamPlan =\n    | { kind: \"scalar\"; scalar: GlScalar } |\n    { kind: \"boolean\" } |\n    { kind: \"sync\" } |\n    { kind: \"string-in\" } |\n    { kind: \"string-array-in\" } |\n    { kind: \"array-in\"; scalar: GlScalar } |\n    { kind: \"ref-out\"; scalar: GlScalar } |\n    { kind: \"ref-array-out\"; scalar: GlScalar; lenParamName: string } |\n    { kind: \"ref-fixed-out\"; scalar: GlScalar; length: number } |\n    { kind: \"string-out\"; lenParamName: string } |\n    { kind: \"buffer\" } |\n    { kind: \"byte-offset\" } |\n    { kind: \"byte-offset-array\" };\n\ntype ReturnPlan =\n    | { kind: \"void\" } |\n    { kind: \"scalar\"; scalar: GlScalar } |\n    { kind: \"boolean\" } |\n    { kind: \"string\" } |\n    { kind: \"sync\" } |\n    { kind: \"opaque-pointer\" };\n\ntype GlExclusionReason =\n    | \"callback-parameter\" |\n    \"compsize-output\" |\n    \"computed-output-length\" |\n    \"unsupported-shape\" |\n    \"override-owned\";\n\ntype GlPlanPolicy = {\n    byteOffsetParams: Set<string>;\n    singleValuedQueries: Set<string>;\n};\n\ntype CommandPlan =\n    | {\n        ok: true;\n        command: GlCommand;\n        params: ParamPlan[];\n        returnPlan: ReturnPlan;\n    } |\n    { ok: false; command: GlCommand; reason: GlExclusionReason };\n\ntype ParamOutcome = { plan: ParamPlan } | { reason: GlExclusionReason };\n\nconst GL_SCALARS: Map<string, GlScalar> = new Map([\n    [\"GLenum\", { descriptor: tScalar(\"uint32\"), tsAlias: \"GLenum\", viewType: \"Uint32Array\", groupBearing: true }],\n    [\n        \"GLbitfield\",\n        { descriptor: tScalar(\"uint32\"), tsAlias: \"GLbitfield\", viewType: \"Uint32Array\", groupBearing: true },\n    ],\n    [\"GLuint\", { descriptor: tScalar(\"uint32\"), tsAlias: \"GLuint\", viewType: \"Uint32Array\" }],\n    [\"GLint\", { descriptor: tScalar(\"int32\"), tsAlias: \"GLint\", viewType: \"Int32Array\" }],\n    [\"GLsizei\", { descriptor: tScalar(\"int32\"), tsAlias: \"GLsizei\", viewType: \"Int32Array\" }],\n    [\"GLbyte\", { descriptor: tScalar(\"int8\"), tsAlias: \"GLbyte\", viewType: \"Int8Array\" }],\n    [\"GLubyte\", { descriptor: tScalar(\"uint8\"), tsAlias: \"GLubyte\", viewType: \"Uint8Array\" }],\n    [\"GLshort\", { descriptor: tScalar(\"int16\"), tsAlias: \"GLshort\", viewType: \"Int16Array\" }],\n    [\"GLushort\", { descriptor: tScalar(\"uint16\"), tsAlias: \"GLushort\", viewType: \"Uint16Array\" }],\n    [\"GLfloat\", { descriptor: tScalar(\"float32\"), tsAlias: \"GLfloat\", viewType: \"Float32Array\" }],\n    [\"GLdouble\", { descriptor: tScalar(\"float64\"), tsAlias: \"GLdouble\", viewType: \"Float64Array\" }],\n    [\"GLint64\", { descriptor: tScalar(\"int64\"), tsAlias: \"GLint64\" }],\n    [\"GLuint64\", { descriptor: tScalar(\"uint64\"), tsAlias: \"GLuint64\" }],\n    [\"GLintptr\", { descriptor: tScalar(\"int64\"), tsAlias: \"GLintptr\" }],\n    [\"GLsizeiptr\", { descriptor: tScalar(\"int64\"), tsAlias: \"GLsizeiptr\" }],\n]);\n\nconst GL_BOOLEAN = \"GLboolean\";\nconst GL_CHAR = \"GLchar\";\nconst GL_SYNC = \"GLsync\";\nconst CALLBACK_BASES: Set<string> = new Set([\"GLDEBUGPROC\", \"GLDEBUGPROCARB\", \"GLDEBUGPROCKHR\", \"GLVULKANPROCNV\"]);\n\nconst parseCType = (cType: string): ParsedCType => {\n    const pointers = (cType.match(/\\*/g) ?? []).length;\n    const isConstData = /(^|\\s)const(\\s|\\*)/.test(` ${cType} `) && pointers > 0;\n\n    const base = cType\n        .replaceAll(\"*\", \" \")\n        .split(/\\s+/)\n        .filter((token) => token.length > 0 && token !== \"const\" && token !== \"struct\")\n        .join(\" \");\n\n    return { base, pointers, constData: isConstData };\n};\n\nconst isCompsize = (len: string): boolean => len.includes(\"COMPSIZE(\");\n\nconst planCompsizeOut = (command: GlCommand, scalar: GlScalar, policy: GlPlanPolicy): ParamOutcome => {\n    if (policy.singleValuedQueries.has(command.name)) {\n        return { plan: { kind: \"ref-out\", scalar } };\n    }\n\n    return { reason: \"compsize-output\" };\n};\n\nconst planPointerOut = (command: GlCommand, param: GlParam, scalar: GlScalar, policy: GlPlanPolicy): ParamOutcome => {\n    const len = param.len;\n\n    if (len === undefined || len === \"1\") {\n        return { plan: { kind: \"ref-out\", scalar } };\n    }\n\n    if (isCompsize(len)) {\n        return planCompsizeOut(command, scalar, policy);\n    }\n\n    if (/^\\d+$/.test(len)) {\n        return { plan: { kind: \"ref-fixed-out\", scalar, length: Number(len) } };\n    }\n\n    if (command.params.some((other) => other.name === len)) {\n        return { plan: { kind: \"ref-array-out\", scalar, lenParamName: len } };\n    }\n\n    return { reason: \"computed-output-length\" };\n};\n\nconst planByteOffsetParam = (parsed: ParsedCType): ParamOutcome => {\n    if (parsed.pointers === 1) {\n        return { plan: { kind: \"byte-offset\" } };\n    }\n\n    if (parsed.pointers === 2) {\n        return { plan: { kind: \"byte-offset-array\" } };\n    }\n\n    return { reason: \"unsupported-shape\" };\n};\n\nconst charStringOutLen = (command: GlCommand, param: GlParam, parsed: ParsedCType): string | undefined => {\n    if (parsed.pointers !== 1) {\n        return undefined;\n    }\n\n    const len = param.len;\n\n    if (len === undefined) {\n        return undefined;\n    }\n\n    return command.params.some((other) => other.name === len) ? len : undefined;\n};\n\nconst planCharParam = (command: GlCommand, param: GlParam, parsed: ParsedCType): ParamOutcome => {\n    if (parsed.pointers === 1 && parsed.constData) {\n        return { plan: { kind: \"string-in\" } };\n    }\n\n    if (parsed.pointers === 2 && parsed.constData) {\n        return { plan: { kind: \"string-array-in\" } };\n    }\n\n    const lenParamName = charStringOutLen(command, param, parsed);\n\n    if (lenParamName !== undefined) {\n        return { plan: { kind: \"string-out\", lenParamName } };\n    }\n\n    return { reason: \"unsupported-shape\" };\n};\n\nconst planScalarParam = (\n    command: GlCommand,\n    param: GlParam,\n    parsed: ParsedCType,\n    policy: GlPlanPolicy,\n): ParamOutcome => {\n    const scalar = GL_SCALARS.get(parsed.base);\n\n    if (scalar === undefined) {\n        throw new Error(`Unmapped C base type \"${parsed.base}\" on ${command.name}(${param.name}: ${param.cType})`);\n    }\n\n    if (parsed.pointers === 0) {\n        return { plan: { kind: \"scalar\", scalar } };\n    }\n\n    if (parsed.pointers === 1 && parsed.constData) {\n        return { plan: { kind: \"array-in\", scalar } };\n    }\n\n    if (parsed.pointers === 1) {\n        return planPointerOut(command, param, scalar, policy);\n    }\n\n    return { reason: \"unsupported-shape\" };\n};\n\nconst planVoidParam = (parsed: ParsedCType): ParamOutcome => {\n    if (parsed.pointers === 1) {\n        return { plan: { kind: \"buffer\" } };\n    }\n\n    return { reason: \"unsupported-shape\" };\n};\n\nconst planBooleanParam = (parsed: ParsedCType): ParamOutcome => {\n    if (parsed.pointers === 0) {\n        return { plan: { kind: \"boolean\" } };\n    }\n\n    return { reason: \"unsupported-shape\" };\n};\n\nconst planCharOrBoolean = (command: GlCommand, param: GlParam, parsed: ParsedCType): ParamOutcome | undefined => {\n    if (parsed.base === GL_CHAR || parsed.base === \"GLcharARB\") {\n        return planCharParam(command, param, parsed);\n    }\n\n    if (parsed.base === GL_BOOLEAN) {\n        return planBooleanParam(parsed);\n    }\n\n    return undefined;\n};\n\nconst planByBase = (command: GlCommand, param: GlParam, parsed: ParsedCType, policy: GlPlanPolicy): ParamOutcome => {\n    const { base, pointers } = parsed;\n\n    if (base === GL_SYNC && pointers === 0) {\n        return { plan: { kind: \"sync\" } };\n    }\n\n    if (base === \"void\") {\n        return planVoidParam(parsed);\n    }\n\n    return planCharOrBoolean(command, param, parsed) ?? planScalarParam(command, param, parsed, policy);\n};\n\nconst planParam = (command: GlCommand, param: GlParam, policy: GlPlanPolicy): ParamOutcome => {\n    const parsed = parseCType(param.cType);\n    const { base } = parsed;\n\n    if (CALLBACK_BASES.has(base) || base.startsWith(\"_cl_\")) {\n        return { reason: \"callback-parameter\" };\n    }\n\n    if (policy.byteOffsetParams.has(`${command.name}:${param.name}`)) {\n        return planByteOffsetParam(parsed);\n    }\n\n    return planByBase(command, param, parsed, policy);\n};\n\nconst planScalarReturn = (base: string): ReturnPlan | undefined => {\n    if (base === \"void\") {\n        return { kind: \"void\" };\n    }\n\n    if (base === GL_SYNC) {\n        return { kind: \"sync\" };\n    }\n\n    if (base === GL_BOOLEAN) {\n        return { kind: \"boolean\" };\n    }\n\n    const scalar = GL_SCALARS.get(base);\n\n    if (scalar !== undefined) {\n        return { kind: \"scalar\", scalar };\n    }\n\n    return undefined;\n};\n\nconst planPointerReturn = (base: string): ReturnPlan | undefined => {\n    if (base === \"void\") {\n        return { kind: \"opaque-pointer\" };\n    }\n\n    if (base === \"GLubyte\" || base === GL_CHAR) {\n        return { kind: \"string\" };\n    }\n\n    return undefined;\n};\n\nconst planReturn = (command: GlCommand): ReturnPlan => {\n    const { base, pointers } = parseCType(command.returnCType);\n    let plan: ReturnPlan | undefined;\n\n    if (pointers === 0) {\n        plan = planScalarReturn(base);\n    } else if (pointers === 1) {\n        plan = planPointerReturn(base);\n    }\n\n    if (plan !== undefined) {\n        return plan;\n    }\n\n    throw new Error(`Unmapped return type \"${command.returnCType}\" on ${command.name}`);\n};\n\nconst planCommand = (command: GlCommand, policy: GlPlanPolicy): CommandPlan => {\n    const params: ParamPlan[] = [];\n\n    for (const param of command.params) {\n        const outcome = planParam(command, param, policy);\n\n        if (\"reason\" in outcome) {\n            return { ok: false, command, reason: outcome.reason };\n        }\n\n        params.push(outcome.plan);\n    }\n\n    return { ok: true, command, params, returnPlan: planReturn(command) };\n};\n\nexport {\n    GL_SCALARS,\n    parseCType,\n    planCommand,\n    type GlScalar,\n    type ParsedCType,\n    type ParamPlan,\n    type ReturnPlan,\n    type GlExclusionReason,\n    type GlPlanPolicy,\n    type CommandPlan,\n};\n"]}

package/dist/khronos/render.d.ts

@@ -0,0 +1,17 @@
+import type { CommandPlan } from "./plan.js";
+type RenderedCommand = {
+    exportName: string;
+    binding?: string;
+    declaration: string;
+};
+declare const renderCommand: (plan: CommandPlan & {
+    ok: true;
+}, feature: string, usedTypes: Set<string>) => RenderedCommand;
+declare const deriveGenSingular: (plan: CommandPlan & {
+    ok: true;
+}, feature: string, usedTypes: Set<string>) => RenderedCommand | undefined;
+declare const deriveDeleteSingular: (plan: CommandPlan & {
+    ok: true;
+}, feature: string, usedTypes: Set<string>) => RenderedCommand | undefined;
+export { renderCommand, deriveGenSingular, deriveDeleteSingular, type RenderedCommand };
+//# sourceMappingURL=render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/khronos/render.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAwB,MAAM,WAAW,CAAC;AAKnE,KAAK,eAAe,GAAG;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AA4GF,QAAA,MAAM,aAAa,GACf,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,EAChC,SAAS,MAAM,EACf,WAAW,GAAG,CAAC,MAAM,CAAC,KACvB,eA4BF,CAAC;AA0DF,QAAA,MAAM,iBAAiB,GACnB,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,EAChC,SAAS,MAAM,EACf,WAAW,GAAG,CAAC,MAAM,CAAC,KACvB,eAAe,GAAG,SA4CpB,CAAC;AAkCF,QAAA,MAAM,oBAAoB,GACtB,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,EAChC,SAAS,MAAM,EACf,WAAW,GAAG,CAAC,MAAM,CAAC,KACvB,eAAe,GAAG,SAiCpB,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,KAAK,eAAe,EAAE,CAAC"}

package/dist/khronos/render.js

@@ -0,0 +1,205 @@
+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 GEN_FAMILY = /^gl(Gen|Create)[A-Z][A-Za-z]*s$/;
+const DELETE_FAMILY = /^glDelete[A-Z][A-Za-z]*s$/;
+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 returnNoOut = (call, returned) => returned.expr === undefined ? [`${call};`] : [`return ${returned.expr(call)};`];
+const returnStatements = (call, returned, outs) => {
+    if (outs.length === 0) {
+        return returnNoOut(call, returned);
+    }
+    const outValues = outs.map((out) => `${out.cellName}.value`);
+    if (returned.expr === undefined) {
+        const [single] = outValues;
+        const tail = single !== undefined && outValues.length === 1
+            ? `return ${single};`
+            : `return [${outValues.join(", ")}];`;
+        return [`${call};`, tail];
+    }
+    return [`const result = ${call};`, `return [${returned.expr("result")}, ${outValues.join(", ")}];`];
+};
+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 isInline = plan.params.some((paramPlan) => paramPlan.kind === "string-out");
+    const bindingName = isInline ? "binding" : toCamelIdentifier(command.name);
+    const body = [
+        ...seeds,
+        ...(isInline ? [`const ${bindingName} = ${bindExpression};`] : []),
+        ...returnStatements(`${bindingName}(${argNames})`, returned, outs),
+    ]
+        .map((line) => `    ${line}`)
+        .join("\n");
+    return {
+        exportName,
+        ...(!isInline && { binding: `const ${bindingName} = ${bindExpression};` }),
+        declaration: `${jsDoc}\nexport function ${exportName}(${signature}): ${tsReturn} {\n${body}\n}`,
+    };
+};
+const singularCommandJsDoc = (plan, feature, summary, body) => singularJsDoc({ commandName: plan.command.name, feature, summary, body });
+const genSingularScalars = (plan) => {
+    const countPlan = plan.params.at(-2);
+    if (countPlan?.kind !== "scalar") {
+        return undefined;
+    }
+    const outPlan = plan.params.at(-1);
+    if (outPlan?.kind !== "ref-array-out") {
+        return undefined;
+    }
+    return { countScalar: countPlan.scalar, outScalar: outPlan.scalar, lenParamName: outPlan.lenParamName };
+};
+const genSingularObjectClass = (plan, lenParamName) => {
+    const countParam = plan.command.params[plan.params.length - 2];
+    const outParam = plan.command.params[plan.params.length - 1];
+    if (countParam === undefined || outParam === undefined) {
+        return undefined;
+    }
+    if (lenParamName !== countParam.name) {
+        return undefined;
+    }
+    return outParam.objectClass;
+};
+const genSingularShape = (plan) => {
+    const scalars = genSingularScalars(plan);
+    if (scalars === undefined) {
+        return undefined;
+    }
+    const objectClass = genSingularObjectClass(plan, scalars.lenParamName);
+    if (objectClass === undefined) {
+        return undefined;
+    }
+    return { countScalar: scalars.countScalar, outScalar: scalars.outScalar, objectClass };
+};
+const deriveGenSingular = (plan, feature, usedTypes) => {
+    if (!GEN_FAMILY.test(plan.command.name)) {
+        return undefined;
+    }
+    const shape = genSingularShape(plan);
+    if (shape === undefined) {
+        return undefined;
+    }
+    const prefix = scalarPrefixArgs(plan, usedTypes);
+    if (prefix === undefined) {
+        return undefined;
+    }
+    const { countScalar, outScalar, objectClass } = shape;
+    const exportName = singularize(commandExportName(plan.command.name));
+    const bindingName = `${plan.command.name}Single`;
+    const descriptors = [...prefix.map((arg) => arg.descriptor), countScalar.descriptor, tRef(outScalar.descriptor)];
+    usedTypes.add(outScalar.tsAlias);
+    const signature = prefix.map((arg) => `${arg.name}: ${arg.tsType}`).join(", ");
+    const callArgs = [...prefix.map((arg) => arg.name), "1", "out"].join(", ");
+    const jsDoc = singularCommandJsDoc(plan, feature, `Returns one ${objectClass} object name via ` +
+        `\`${plan.command.name}(${prefix.length > 0 ? "..., " : ""}1, ...)\`.`, [...prefix.map((arg) => inParamDocLine(plan.command, arg)), ` * @returns The new ${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}): ${outScalar.tsAlias} {\n${body}\n}`,
+    };
+};
+const deleteSingularAlias = (plan) => {
+    if (plan.params.length !== 2) {
+        return undefined;
+    }
+    const [countPlan, arrayPlan] = plan.params;
+    if (countPlan?.kind !== "scalar") {
+        return undefined;
+    }
+    if (arrayPlan?.kind !== "array-in") {
+        return undefined;
+    }
+    return arrayPlan.scalar.tsAlias;
+};
+const deleteSingularObjectClass = (plan) => {
+    const [countParam, arrayParam] = plan.command.params;
+    if (countParam === undefined || arrayParam === undefined) {
+        return undefined;
+    }
+    if (arrayParam.len !== countParam.name) {
+        return undefined;
+    }
+    return arrayParam.objectClass;
+};
+const deriveDeleteSingular = (plan, feature, usedTypes) => {
+    if (!DELETE_FAMILY.test(plan.command.name)) {
+        return undefined;
+    }
+    const scalarAlias = deleteSingularAlias(plan);
+    if (scalarAlias === undefined) {
+        return undefined;
+    }
+    const objectClass = deleteSingularObjectClass(plan);
+    if (objectClass === undefined) {
+        return undefined;
+    }
+    usedTypes.add(scalarAlias);
+    const exportName = singularize(commandExportName(plan.command.name));
+    const jsDoc = singularCommandJsDoc(plan, feature, `Deletes one ${objectClass} object name via \`${plan.command.name}(1, ...)\`.`, [` * @param name - The ${objectClass} object name to delete`]);
+    return {
+        exportName,
+        declaration: `${jsDoc}\nexport function ${exportName}(name: ${scalarAlias}): void {\n` +
+            `    ${plan.command.name}(1, [name]);\n}`,
+    };
+};
+export { renderCommand, deriveGenSingular, deriveDeleteSingular };
+//# 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 type { CommandPlan, GlScalar, ReturnPlan } from \"./plan.js\";\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\";\n\ntype 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\ntype GenSingularShape = {\n    countScalar: GlScalar;\n    outScalar: GlScalar;\n    objectClass: string;\n};\n\nconst GL_LIB_EXPRESSION = \"LIB\";\nconst GEN_FAMILY = /^gl(Gen|Create)[A-Z][A-Za-z]*s$/;\nconst DELETE_FAMILY = /^glDelete[A-Z][A-Za-z]*s$/;\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\nconst buildEmittedReturn = (\n    plan: ReturnPlan,\n    returnGroup: string | undefined,\n    usedTypes: Set<string>,\n): EmittedReturn => {\n    const track = trackInto(usedTypes);\n\n    switch (plan.kind) {\n        case \"void\": {\n            return { tsType: \"void\", descriptor: tVoid };\n        }\n        case \"scalar\": {\n            const alias = track(scalarAliasOrGroup(plan.scalar, returnGroup));\n\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        }\n        case \"string\": {\n            return { tsType: \"string\", descriptor: tString(\"borrowed\"), expr: (call) => `${call} as string` };\n        }\n        case \"sync\": {\n            return { tsType: track(\"GLsync\"), descriptor: tInlineStruct(), expr: (call) => `${call} as GLsync` };\n        }\n        case \"opaque-pointer\": {\n            return {\n                tsType: track(\"GLpointer\"),\n                descriptor: tInlineStruct(),\n                expr: (call) => `${call} as GLpointer`,\n            };\n        }\n    }\n};\n\nconst returnTsType = (returned: EmittedReturn, outs: OutArg[]): string => {\n    if (outs.length === 0) {\n        return returned.tsType;\n    }\n\n    const outTypes = outs.map((out) => out.tsType);\n\n    if (returned.expr === undefined) {\n        return outTypes.length === 1 && outTypes[0] !== undefined ? outTypes[0] : `[${outTypes.join(\", \")}]`;\n    }\n\n    return `[${returned.tsType}, ${outTypes.join(\", \")}]`;\n};\n\nconst returnNoOut = (call: string, returned: EmittedReturn): string[] =>\n    returned.expr === undefined ? [`${call};`] : [`return ${returned.expr(call)};`];\n\nconst returnStatements = (call: string, returned: EmittedReturn, outs: OutArg[]): string[] => {\n    if (outs.length === 0) {\n        return returnNoOut(call, returned);\n    }\n\n    const outValues = outs.map((out) => `${out.cellName}.value`);\n\n    if (returned.expr === undefined) {\n        const [single] = outValues;\n\n        const tail =\n            single !== undefined && outValues.length === 1\n                ? `return ${single};`\n                : `return [${outValues.join(\", \")}];`;\n\n        return [`${call};`, tail];\n    }\n\n    return [`const result = ${call};`, `return [${returned.expr(\"result\")}, ${outValues.join(\", \")}];`];\n};\n\nconst 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 isInline = plan.params.some((paramPlan) => paramPlan.kind === \"string-out\");\n    const bindingName = isInline ? \"binding\" : toCamelIdentifier(command.name);\n\n    const body = [\n        ...seeds,\n        ...(isInline ? [`const ${bindingName} = ${bindExpression};`] : []),\n        ...returnStatements(`${bindingName}(${argNames})`, returned, outs),\n    ]\n        .map((line) => `    ${line}`)\n        .join(\"\\n\");\n\n    return {\n        exportName,\n        ...(!isInline && { binding: `const ${bindingName} = ${bindExpression};` }),\n        declaration: `${jsDoc}\\nexport function ${exportName}(${signature}): ${tsReturn} {\\n${body}\\n}`,\n    };\n};\n\nconst singularCommandJsDoc = (\n    plan: CommandPlan & { ok: true },\n    feature: string,\n    summary: string,\n    body: string[],\n): string => singularJsDoc({ commandName: plan.command.name, feature, summary, body });\n\nconst genSingularScalars = (\n    plan: CommandPlan & { ok: true },\n): { countScalar: GlScalar; outScalar: GlScalar; lenParamName: string } | undefined => {\n    const countPlan = plan.params.at(-2);\n\n    if (countPlan?.kind !== \"scalar\") {\n        return undefined;\n    }\n\n    const outPlan = plan.params.at(-1);\n\n    if (outPlan?.kind !== \"ref-array-out\") {\n        return undefined;\n    }\n\n    return { countScalar: countPlan.scalar, outScalar: outPlan.scalar, lenParamName: outPlan.lenParamName };\n};\n\nconst genSingularObjectClass = (plan: CommandPlan & { ok: true }, lenParamName: string): string | undefined => {\n    const countParam = plan.command.params[plan.params.length - 2];\n    const outParam = plan.command.params[plan.params.length - 1];\n\n    if (countParam === undefined || outParam === undefined) {\n        return undefined;\n    }\n\n    if (lenParamName !== countParam.name) {\n        return undefined;\n    }\n\n    return outParam.objectClass;\n};\n\nconst genSingularShape = (plan: CommandPlan & { ok: true }): GenSingularShape | undefined => {\n    const scalars = genSingularScalars(plan);\n\n    if (scalars === undefined) {\n        return undefined;\n    }\n\n    const objectClass = genSingularObjectClass(plan, scalars.lenParamName);\n\n    if (objectClass === undefined) {\n        return undefined;\n    }\n\n    return { countScalar: scalars.countScalar, outScalar: scalars.outScalar, objectClass };\n};\n\nconst deriveGenSingular = (\n    plan: CommandPlan & { ok: true },\n    feature: string,\n    usedTypes: Set<string>,\n): RenderedCommand | undefined => {\n    if (!GEN_FAMILY.test(plan.command.name)) {\n        return undefined;\n    }\n\n    const shape = genSingularShape(plan);\n\n    if (shape === undefined) {\n        return undefined;\n    }\n\n    const prefix = scalarPrefixArgs(plan, usedTypes);\n\n    if (prefix === undefined) {\n        return undefined;\n    }\n\n    const { countScalar, outScalar, objectClass } = shape;\n    const exportName = singularize(commandExportName(plan.command.name));\n    const bindingName = `${plan.command.name}Single`;\n    const descriptors = [...prefix.map((arg) => arg.descriptor), countScalar.descriptor, tRef(outScalar.descriptor)];\n    usedTypes.add(outScalar.tsAlias);\n    const signature = prefix.map((arg) => `${arg.name}: ${arg.tsType}`).join(\", \");\n    const callArgs = [...prefix.map((arg) => arg.name), \"1\", \"out\"].join(\", \");\n\n    const jsDoc = singularCommandJsDoc(\n        plan,\n        feature,\n        `Returns one ${objectClass} object name via ` +\n        `\\`${plan.command.name}(${prefix.length > 0 ? \"..., \" : \"\"}1, ...)\\`.`,\n        [...prefix.map((arg) => inParamDocLine(plan.command, arg)), ` * @returns The new ${objectClass} object name`],\n    );\n\n    const body = [\"    const out = { value: 0 };\", `    ${bindingName}(${callArgs});`, \"    return out.value;\"].join(\n        \"\\n\",\n    );\n\n    const binding = glBind(plan.command.name, renderDescriptorList(descriptors), tVoid);\n\n    return {\n        exportName,\n        binding: `const ${bindingName} = ${binding};`,\n        declaration: `${jsDoc}\\nexport function ${exportName}(${signature}): ${outScalar.tsAlias} {\\n${body}\\n}`,\n    };\n};\n\nconst deleteSingularAlias = (plan: CommandPlan & { ok: true }): string | undefined => {\n    if (plan.params.length !== 2) {\n        return undefined;\n    }\n\n    const [countPlan, arrayPlan] = plan.params;\n\n    if (countPlan?.kind !== \"scalar\") {\n        return undefined;\n    }\n\n    if (arrayPlan?.kind !== \"array-in\") {\n        return undefined;\n    }\n\n    return arrayPlan.scalar.tsAlias;\n};\n\nconst deleteSingularObjectClass = (plan: CommandPlan & { ok: true }): string | undefined => {\n    const [countParam, arrayParam] = plan.command.params;\n\n    if (countParam === undefined || arrayParam === undefined) {\n        return undefined;\n    }\n\n    if (arrayParam.len !== countParam.name) {\n        return undefined;\n    }\n\n    return arrayParam.objectClass;\n};\n\nconst deriveDeleteSingular = (\n    plan: CommandPlan & { ok: true },\n    feature: string,\n    usedTypes: Set<string>,\n): RenderedCommand | undefined => {\n    if (!DELETE_FAMILY.test(plan.command.name)) {\n        return undefined;\n    }\n\n    const scalarAlias = deleteSingularAlias(plan);\n\n    if (scalarAlias === undefined) {\n        return undefined;\n    }\n\n    const objectClass = deleteSingularObjectClass(plan);\n\n    if (objectClass === undefined) {\n        return undefined;\n    }\n\n    usedTypes.add(scalarAlias);\n    const exportName = singularize(commandExportName(plan.command.name));\n\n    const jsDoc = singularCommandJsDoc(\n        plan,\n        feature,\n        `Deletes one ${objectClass} object name via \\`${plan.command.name}(1, ...)\\`.`,\n        [` * @param name - The ${objectClass} object name to delete`],\n    );\n\n    return {\n        exportName,\n        declaration:\n            `${jsDoc}\\nexport function ${exportName}(name: ${scalarAlias}): void {\\n` +\n            `    ${plan.command.name}(1, [name]);\\n}`,\n    };\n};\n\nexport { renderCommand, deriveGenSingular, deriveDeleteSingular, type RenderedCommand };\n"]}

package/dist/khronos/select.d.ts

@@ -0,0 +1,15 @@
+import type { GlEnum, GlRegistry } from "./model.js";
+type GlProfile = "core";
+type GlSelection = {
+    api: string;
+    version: number;
+    profile: GlProfile;
+};
+type GlSubset = {
+    commands: Map<string, string>;
+    enums: Map<string, string>;
+};
+declare const selectSubset: (registry: GlRegistry, selection: GlSelection) => GlSubset;
+declare const resolveEnum: (registry: GlRegistry, name: string) => GlEnum;
+export { selectSubset, resolveEnum, type GlSelection };
+//# 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,KAAK,WAAW,GAAG;IACf,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;AAsDF,QAAA,MAAM,YAAY,GAAI,UAAU,UAAU,EAAE,WAAW,WAAW,KAAG,QAiBpE,CAAC;AAEF,QAAA,MAAM,WAAW,GAAI,UAAU,UAAU,EAAE,MAAM,MAAM,KAAG,MAQzD,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,CAAC"}

package/dist/khronos/select.js

@@ -0,0 +1,56 @@
+const isBlockApplicable = (block, selection) => block.profile === undefined || block.profile === selection.profile;
+const addMissing = (target, names, value) => {
+    for (const name of names) {
+        if (!target.has(name)) {
+            target.set(name, value);
+        }
+    }
+};
+const applyRequires = (feature, selection, commands, enums) => {
+    for (const block of feature.requires) {
+        if (!isBlockApplicable(block, selection)) {
+            continue;
+        }
+        addMissing(commands, block.commands, feature.name);
+        addMissing(enums, block.enums, feature.name);
+    }
+};
+const removeBlock = (block, commands, enums) => {
+    for (const name of block.commands) {
+        commands.delete(name);
+    }
+    for (const name of block.enums) {
+        enums.delete(name);
+    }
+};
+const applyRemoves = (feature, selection, commands, enums) => {
+    for (const block of feature.removes) {
+        if (!isBlockApplicable(block, selection)) {
+            continue;
+        }
+        removeBlock(block, commands, enums);
+    }
+};
+const selectSubset = (registry, selection) => {
+    const features = registry.features
+        .filter((feature) => feature.api === selection.api && feature.number <= selection.version)
+        .toSorted((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 };
+};
+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;
+};
+export { selectSubset, resolveEnum };
+//# 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":"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","sourcesContent":["import type { GlEnum, GlFeature, GlInterfaceBlock, GlRegistry } from \"./model.js\";\n\ntype GlProfile = \"core\";\n\ntype 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 isBlockApplicable = (block: GlInterfaceBlock, selection: GlSelection): boolean =>\n    block.profile === undefined || block.profile === selection.profile;\n\nconst addMissing = (target: Map<string, string>, names: string[], value: string): void => {\n    for (const name of names) {\n        if (!target.has(name)) {\n            target.set(name, value);\n        }\n    }\n};\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 (!isBlockApplicable(block, selection)) {\n            continue;\n        }\n\n        addMissing(commands, block.commands, feature.name);\n        addMissing(enums, block.enums, feature.name);\n    }\n};\n\nconst removeBlock = (block: GlInterfaceBlock, commands: Map<string, string>, enums: Map<string, string>): void => {\n    for (const name of block.commands) {\n        commands.delete(name);\n    }\n\n    for (const name of block.enums) {\n        enums.delete(name);\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 (!isBlockApplicable(block, selection)) {\n            continue;\n        }\n\n        removeBlock(block, commands, enums);\n    }\n};\n\nconst selectSubset = (registry: GlRegistry, selection: GlSelection): GlSubset => {\n    const features = registry.features\n        .filter((feature) => feature.api === selection.api && feature.number <= selection.version)\n        .toSorted((a, b) => a.number - b.number);\n\n    const commands: Map<string, string> = new Map();\n    const enums: Map<string, string> = new Map();\n\n    for (const feature of features) {\n        applyRequires(feature, selection, commands, enums);\n    }\n\n    for (const feature of features) {\n        applyRemoves(feature, selection, commands, enums);\n    }\n\n    return { commands, enums };\n};\n\nconst resolveEnum = (registry: GlRegistry, name: string): GlEnum => {\n    const found = registry.enums.find((candidate) => candidate.name === name);\n\n    if (found === undefined) {\n        throw new Error(`Enum token ${name} has no definition in the registry`);\n    }\n\n    return found;\n};\n\nexport { selectSubset, resolveEnum, type GlSelection };\n"]}

package/dist/react/element-config.d.ts

@@ -0,0 +1,17 @@
+import type { ModuleExport } from "@gtkx/react/config";
+/** The codegen-relevant subset of a React element config; behaviors are ignored at codegen time. */
+type BuiltinElement = {
+    component?: ModuleExport;
+    lazy?: boolean;
+    props?: ModuleExport;
+};
+/** The framework's built-in element config, split into the maps codegen consumes. */
+type BuiltinElements = {
+    components: Record<string, ModuleExport>;
+    lazyElements: string[];
+    props: Record<string, ModuleExport>;
+};
+declare const readBuiltinElements: (reactSubexports: string[], giStoreDir: string) => Promise<BuiltinElements>;
+export { type ModuleExport } from "@gtkx/react/config";
+export { readBuiltinElements, type BuiltinElement, type BuiltinElements };
+//# sourceMappingURL=element-config.d.ts.map

package/dist/react/element-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-config.d.ts","sourceRoot":"","sources":["../../src/react/element-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,oGAAoG;AACpG,KAAK,cAAc,GAAG;IAAE,SAAS,CAAC,EAAE,YAAY,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC;AAEzF,qFAAqF;AACrF,KAAK,eAAe,GAAG;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACvC,CAAC;AAkEF,QAAA,MAAM,mBAAmB,GAAU,iBAAiB,MAAM,EAAE,EAAE,YAAY,MAAM,KAAG,OAAO,CAAC,eAAe,CAUzG,CAAC;AAEF,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,CAAC"}