@gtkx/codegen 0.21.0 → 1.0.0-rc.1

package/dist/khronos/args.js

@@ -0,0 +1,150 @@
+import { toCamelIdentifier } from "@gtkx/utils";
+import { tArray, tBoolean, tBuffer, tFixedArray, tInlineStruct, tRef, tSizedArray, tString, tUint64, } from "../analysis/descriptor.js";
+export const scalarAliasOrGroup = (scalar, group) => group !== undefined && scalar.groupBearing === true ? group : scalar.tsAlias;
+const paramIndexByName = (command, name) => {
+    const index = command.params.findIndex((param) => param.name === name);
+    if (index < 0)
+        throw new Error(`Command ${command.name} has no parameter named ${name}`);
+    return index;
+};
+const arrayInTsType = (scalar, group) => {
+    const element = scalarAliasOrGroup(scalar, group);
+    return scalar.viewType === undefined ? `${element}[]` : `${element}[] | ${scalar.viewType}`;
+};
+const inArg = (name, tsType, descriptor) => ({
+    out: false,
+    name,
+    tsType,
+    descriptor,
+});
+const buildInArg = (options, name, track) => {
+    const { command, index, plan } = options;
+    const param = command.params[index];
+    if (param === undefined)
+        throw new Error(`Parameter index ${index} out of range on ${command.name}`);
+    switch (plan.kind) {
+        case "scalar":
+            return inArg(name, track(scalarAliasOrGroup(plan.scalar, param.group)), plan.scalar.descriptor);
+        case "boolean":
+            return inArg(name, "boolean", tBoolean);
+        case "sync":
+            return inArg(name, track("GLsync"), tInlineStruct());
+        case "string-in":
+            return inArg(name, "string", tString("borrowed"));
+        case "string-array-in":
+            return inArg(name, "string[]", tArray(tString("borrowed")));
+        case "array-in": {
+            track(scalarAliasOrGroup(plan.scalar, param.group));
+            return inArg(name, arrayInTsType(plan.scalar, param.group), tArray(plan.scalar.descriptor));
+        }
+        case "buffer":
+            return inArg(name, `ArrayBufferView | ${track("GLintptr")} | null`, tBuffer);
+        case "byte-offset":
+            return inArg(name, track("GLintptr"), tUint64);
+        case "byte-offset-array":
+            return inArg(name, `${track("GLintptr")}[]`, tArray(tUint64));
+        default:
+            throw new Error(`Plan kind ${plan.kind} is not an input parameter`);
+    }
+};
+const buildOutArg = (options, track) => {
+    const { command, index, plan, outIndex } = options;
+    const param = command.params[index];
+    if (param === undefined)
+        throw new Error(`Parameter index ${index} out of range on ${command.name}`);
+    const cellName = `out${outIndex}`;
+    switch (plan.kind) {
+        case "ref-out":
+            return {
+                out: true,
+                cellName,
+                seed: `const ${cellName} = { value: 0 };`,
+                tsType: track(scalarAliasOrGroup(plan.scalar, param.group)),
+                descriptor: tRef(plan.scalar.descriptor),
+                paramIndex: index,
+            };
+        case "ref-array-out": {
+            const sizeIndex = paramIndexByName(command, plan.lenParamName);
+            const lenIdentifier = toCamelIdentifier(plan.lenParamName);
+            return {
+                out: true,
+                cellName,
+                seed: `const ${cellName} = { value: new Array<number>(${lenIdentifier}).fill(0) };`,
+                tsType: `${track(plan.scalar.tsAlias)}[]`,
+                descriptor: tRef(tSizedArray(plan.scalar.descriptor, sizeIndex)),
+                paramIndex: index,
+            };
+        }
+        case "ref-fixed-out":
+            return {
+                out: true,
+                cellName,
+                seed: `const ${cellName} = { value: new Array<number>(${plan.length}).fill(0) };`,
+                tsType: `${track(plan.scalar.tsAlias)}[]`,
+                descriptor: tRef(tFixedArray(plan.scalar.descriptor, plan.length)),
+                paramIndex: index,
+            };
+        case "string-out":
+            return {
+                out: true,
+                cellName,
+                seed: `const ${cellName} = { value: "" };`,
+                tsType: "string",
+                descriptor: tRef(tString("borrowed", toCamelIdentifier(plan.lenParamName))),
+                paramIndex: index,
+            };
+        default:
+            throw new Error(`Plan kind ${plan.kind} is not an output parameter`);
+    }
+};
+const isOutPlan = (plan) => plan.kind === "ref-out" ||
+    plan.kind === "ref-array-out" ||
+    plan.kind === "ref-fixed-out" ||
+    plan.kind === "string-out";
+export const trackInto = (usedTypes) => (alias) => {
+    usedTypes.add(alias);
+    return alias;
+};
+export const planArgs = (plan, usedTypes) => {
+    const track = trackInto(usedTypes);
+    const args = [];
+    const ins = [];
+    const outs = [];
+    plan.params.forEach((paramPlan, index) => {
+        const param = plan.command.params[index];
+        if (param === undefined)
+            throw new Error(`Parameter index ${index} out of range on ${plan.command.name}`);
+        const options = {
+            command: plan.command,
+            index,
+            plan: paramPlan,
+            outIndex: outs.length,
+        };
+        if (isOutPlan(paramPlan)) {
+            const arg = buildOutArg(options, track);
+            args.push(arg);
+            outs.push(arg);
+        }
+        else {
+            const arg = buildInArg(options, toCamelIdentifier(param.name), track);
+            args.push(arg);
+            ins.push(arg);
+        }
+    });
+    return { args, ins, outs };
+};
+export const scalarPrefixArgs = (plan, usedTypes) => {
+    const track = trackInto(usedTypes);
+    const prefix = [];
+    for (let index = 0; index < plan.params.length - 2; index++) {
+        const paramPlan = plan.params[index];
+        const param = plan.command.params[index];
+        if (param === undefined)
+            return undefined;
+        if (paramPlan === undefined || paramPlan.kind !== "scalar")
+            return undefined;
+        prefix.push(buildInArg({ command: plan.command, index, plan: paramPlan, outIndex: 0 }, toCamelIdentifier(param.name), track));
+    }
+    return prefix;
+};
+//# sourceMappingURL=args.js.map

package/dist/khronos/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/khronos/args.ts"],"names":[],"mappings":"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","sourcesContent":["import { toCamelIdentifier } from \"@gtkx/utils\";\nimport {\n    tArray,\n    tBoolean,\n    tBuffer,\n    tFixedArray,\n    tInlineStruct,\n    tRef,\n    tSizedArray,\n    tString,\n    tUint64,\n} from \"../analysis/descriptor.js\";\nimport type { GlCommand } from \"./model.js\";\nimport type { CommandPlan, GlScalar, ParamPlan } from \"./plan.js\";\n\nexport const scalarAliasOrGroup = (scalar: GlScalar, group: string | undefined): string =>\n    group !== undefined && scalar.groupBearing === true ? group : scalar.tsAlias;\n\nconst paramIndexByName = (command: GlCommand, name: string): number => {\n    const index = command.params.findIndex((param) => param.name === name);\n    if (index < 0) throw new Error(`Command ${command.name} has no parameter named ${name}`);\n    return index;\n};\n\nconst arrayInTsType = (scalar: GlScalar, group: string | undefined): string => {\n    const element = scalarAliasOrGroup(scalar, group);\n    return scalar.viewType === undefined ? `${element}[]` : `${element}[] | ${scalar.viewType}`;\n};\n\nexport type InArg = {\n    out: false;\n    name: string;\n    tsType: string;\n    descriptor: string;\n};\n\nexport type OutArg = {\n    out: true;\n    cellName: string;\n    seed: string;\n    tsType: string;\n    descriptor: string;\n    paramIndex: number;\n};\n\ntype PlannedArg = InArg | OutArg;\n\ntype BuildArgOptions = {\n    command: GlCommand;\n    index: number;\n    plan: ParamPlan;\n    outIndex: number;\n};\n\nconst inArg = (name: string, tsType: string, descriptor: string): InArg => ({\n    out: false,\n    name,\n    tsType,\n    descriptor,\n});\n\nconst buildInArg = (options: BuildArgOptions, name: string, track: (alias: string) => string): InArg => {\n    const { command, index, plan } = options;\n    const param = command.params[index];\n    if (param === undefined) throw new Error(`Parameter index ${index} out of range on ${command.name}`);\n    switch (plan.kind) {\n        case \"scalar\":\n            return inArg(name, track(scalarAliasOrGroup(plan.scalar, param.group)), plan.scalar.descriptor);\n        case \"boolean\":\n            return inArg(name, \"boolean\", tBoolean);\n        case \"sync\":\n            return inArg(name, track(\"GLsync\"), tInlineStruct());\n        case \"string-in\":\n            return inArg(name, \"string\", tString(\"borrowed\"));\n        case \"string-array-in\":\n            return inArg(name, \"string[]\", tArray(tString(\"borrowed\")));\n        case \"array-in\": {\n            track(scalarAliasOrGroup(plan.scalar, param.group));\n            return inArg(name, arrayInTsType(plan.scalar, param.group), tArray(plan.scalar.descriptor));\n        }\n        case \"buffer\":\n            return inArg(name, `ArrayBufferView | ${track(\"GLintptr\")} | null`, tBuffer);\n        case \"byte-offset\":\n            return inArg(name, track(\"GLintptr\"), tUint64);\n        case \"byte-offset-array\":\n            return inArg(name, `${track(\"GLintptr\")}[]`, tArray(tUint64));\n        default:\n            throw new Error(`Plan kind ${plan.kind} is not an input parameter`);\n    }\n};\n\nconst buildOutArg = (options: BuildArgOptions, track: (alias: string) => string): OutArg => {\n    const { command, index, plan, outIndex } = options;\n    const param = command.params[index];\n    if (param === undefined) throw new Error(`Parameter index ${index} out of range on ${command.name}`);\n    const cellName = `out${outIndex}`;\n    switch (plan.kind) {\n        case \"ref-out\":\n            return {\n                out: true,\n                cellName,\n                seed: `const ${cellName} = { value: 0 };`,\n                tsType: track(scalarAliasOrGroup(plan.scalar, param.group)),\n                descriptor: tRef(plan.scalar.descriptor),\n                paramIndex: index,\n            };\n        case \"ref-array-out\": {\n            const sizeIndex = paramIndexByName(command, plan.lenParamName);\n            const lenIdentifier = toCamelIdentifier(plan.lenParamName);\n            return {\n                out: true,\n                cellName,\n                seed: `const ${cellName} = { value: new Array<number>(${lenIdentifier}).fill(0) };`,\n                tsType: `${track(plan.scalar.tsAlias)}[]`,\n                descriptor: tRef(tSizedArray(plan.scalar.descriptor, sizeIndex)),\n                paramIndex: index,\n            };\n        }\n        case \"ref-fixed-out\":\n            return {\n                out: true,\n                cellName,\n                seed: `const ${cellName} = { value: new Array<number>(${plan.length}).fill(0) };`,\n                tsType: `${track(plan.scalar.tsAlias)}[]`,\n                descriptor: tRef(tFixedArray(plan.scalar.descriptor, plan.length)),\n                paramIndex: index,\n            };\n        case \"string-out\":\n            return {\n                out: true,\n                cellName,\n                seed: `const ${cellName} = { value: \"\" };`,\n                tsType: \"string\",\n                descriptor: tRef(tString(\"borrowed\", toCamelIdentifier(plan.lenParamName))),\n                paramIndex: index,\n            };\n        default:\n            throw new Error(`Plan kind ${plan.kind} is not an output parameter`);\n    }\n};\n\nconst isOutPlan = (plan: ParamPlan): boolean =>\n    plan.kind === \"ref-out\" ||\n    plan.kind === \"ref-array-out\" ||\n    plan.kind === \"ref-fixed-out\" ||\n    plan.kind === \"string-out\";\n\nexport const trackInto =\n    (usedTypes: Set<string>) =>\n    (alias: string): string => {\n        usedTypes.add(alias);\n        return alias;\n    };\n\nexport const planArgs = (\n    plan: CommandPlan & { ok: true },\n    usedTypes: Set<string>,\n): { args: PlannedArg[]; ins: InArg[]; outs: OutArg[] } => {\n    const track = trackInto(usedTypes);\n    const args: PlannedArg[] = [];\n    const ins: InArg[] = [];\n    const outs: OutArg[] = [];\n    plan.params.forEach((paramPlan, index) => {\n        const param = plan.command.params[index];\n        if (param === undefined) throw new Error(`Parameter index ${index} out of range on ${plan.command.name}`);\n        const options: BuildArgOptions = {\n            command: plan.command,\n            index,\n            plan: paramPlan,\n            outIndex: outs.length,\n        };\n        if (isOutPlan(paramPlan)) {\n            const arg = buildOutArg(options, track);\n            args.push(arg);\n            outs.push(arg);\n        } else {\n            const arg = buildInArg(options, toCamelIdentifier(param.name), track);\n            args.push(arg);\n            ins.push(arg);\n        }\n    });\n    return { args, ins, outs };\n};\n\nexport const scalarPrefixArgs = (plan: CommandPlan & { ok: true }, usedTypes: Set<string>): InArg[] | undefined => {\n    const track = trackInto(usedTypes);\n    const prefix: InArg[] = [];\n    for (let index = 0; index < plan.params.length - 2; index++) {\n        const paramPlan = plan.params[index];\n        const param = plan.command.params[index];\n        if (param === undefined) return undefined;\n        if (paramPlan === undefined || paramPlan.kind !== \"scalar\") return undefined;\n        prefix.push(\n            buildInArg(\n                { command: plan.command, index, plan: paramPlan, outIndex: 0 },\n                toCamelIdentifier(param.name),\n                track,\n            ),\n        );\n    }\n    return prefix;\n};\n"]}

package/dist/khronos/jsdoc.d.ts

@@ -0,0 +1,21 @@
+import type { InArg, OutArg } from "./args.js";
+import type { GlCommand } from "./model.js";
+import type { ReturnPlan } from "./plan.js";
+export declare const inParamDocLine: (command: GlCommand, arg: InArg) => string;
+type CommandJsDocOptions = {
+    command: GlCommand;
+    feature: string;
+    ins: InArg[];
+    outs: OutArg[];
+    returnPlan: ReturnPlan;
+};
+type SingularJsDocOptions = {
+    commandName: string;
+    feature: string;
+    summary: string;
+    body: string[];
+};
+export declare const singularJsDoc: ({ commandName, feature, summary, body }: SingularJsDocOptions) => string;
+export declare const commandJsDoc: ({ command, feature, ins, outs, returnPlan }: CommandJsDocOptions) => string;
+export {};
+//# sourceMappingURL=jsdoc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsdoc.d.ts","sourceRoot":"","sources":["../../src/khronos/jsdoc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAW5C,eAAO,MAAM,cAAc,YAAa,SAAS,OAAO,KAAK,KAAG,MAQ/D,CAAC;AAgBF,KAAK,mBAAmB,GAAG;IACvB,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,KAAK,EAAE,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;CAC1B,CAAC;AAEF,KAAK,oBAAoB,GAAG;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,aAAa,4CAA6C,oBAAoB,KAAG,MAS9E,CAAC;AAEjB,eAAO,MAAM,YAAY,gDAAiD,mBAAmB,KAAG,MAW/F,CAAC"}

package/dist/khronos/jsdoc.js

@@ -0,0 +1,59 @@
+import { toCamelIdentifier } from "@gtkx/utils";
+const REFPAGES_BASE = "https://registry.khronos.org/OpenGL-Refpages/gl4/html";
+const formatPrototype = (command) => {
+    const params = command.params
+        .map((param) => (param.cType.endsWith("*") ? `${param.cType}${param.name}` : `${param.cType} ${param.name}`))
+        .join(", ");
+    return `${command.returnCType} ${command.name}(${params})`;
+};
+export const inParamDocLine = (command, arg) => {
+    const param = command.params.find((candidate) => toCamelIdentifier(candidate.name) === arg.name);
+    if (param === undefined)
+        return ` * @param ${arg.name}`;
+    const notes = [`\`${param.cType}\``];
+    if (param.group !== undefined)
+        notes.push(`group \`${param.group}\``);
+    if (param.len !== undefined)
+        notes.push(`length \`${param.len}\``);
+    if (param.objectClass !== undefined)
+        notes.push(`object class \`${param.objectClass}\``);
+    return ` * @param ${arg.name} - ${notes.join(", ")}`;
+};
+const returnsDocLine = (command, returnPlan, outs) => {
+    const members = [];
+    if (returnPlan.kind !== "void")
+        members.push(`\`${command.returnCType}\``);
+    for (const out of outs) {
+        const param = command.params[out.paramIndex];
+        if (param === undefined)
+            throw new Error(`Output parameter index ${out.paramIndex} out of range on ${command.name}`);
+        members.push(`\`${param.name}\` (\`${param.cType}\`)`);
+    }
+    if (members.length === 0)
+        return undefined;
+    if (members.length === 1)
+        return ` * @returns ${members[0]}`;
+    return ` * @returns Tuple of ${members.join(", ")}`;
+};
+export const singularJsDoc = ({ commandName, feature, summary, body }) => [
+    "/**",
+    ` * ${summary}`,
+    " *",
+    ` * Provided by \`${feature}\`.`,
+    ...body,
+    ` * @see ${REFPAGES_BASE}/${commandName}.xhtml`,
+    " */",
+].join("\n");
+export const commandJsDoc = ({ command, feature, ins, outs, returnPlan }) => {
+    const returnsLine = returnsDocLine(command, returnPlan, outs);
+    return singularJsDoc({
+        commandName: command.name,
+        feature,
+        summary: `\`${formatPrototype(command)}\``,
+        body: [
+            ...(ins.length > 0 ? [" *", ...ins.map((arg) => inParamDocLine(command, arg))] : []),
+            ...(returnsLine !== undefined ? [returnsLine] : []),
+        ],
+    });
+};
+//# sourceMappingURL=jsdoc.js.map

package/dist/khronos/jsdoc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsdoc.js","sourceRoot":"","sources":["../../src/khronos/jsdoc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAKhD,MAAM,aAAa,GAAG,uDAAuD,CAAC;AAE9E,MAAM,eAAe,GAAG,CAAC,OAAkB,EAAU,EAAE;IACnD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM;SACxB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;SAC5G,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,OAAO,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,IAAI,IAAI,MAAM,GAAG,CAAC;AAC/D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAkB,EAAE,GAAU,EAAU,EAAE;IACrE,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC;IACjG,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,aAAa,GAAG,CAAC,IAAI,EAAE,CAAC;IACxD,MAAM,KAAK,GAAa,CAAC,KAAK,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;IAC/C,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;IACtE,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACnE,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;IACzF,OAAO,aAAa,GAAG,CAAC,IAAI,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACzD,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,OAAkB,EAAE,UAAsB,EAAE,IAAc,EAAsB,EAAE;IACtG,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,UAAU,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;IAC3E,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,KAAK,KAAK,SAAS;YACnB,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,UAAU,oBAAoB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAChG,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,eAAe,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,OAAO,wBAAwB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACxD,CAAC,CAAC;AAiBF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAwB,EAAU,EAAE,CACnG;IACI,KAAK;IACL,MAAM,OAAO,EAAE;IACf,IAAI;IACJ,oBAAoB,OAAO,KAAK;IAChC,GAAG,IAAI;IACP,WAAW,aAAa,IAAI,WAAW,QAAQ;IAC/C,KAAK;CACR,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEjB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAuB,EAAU,EAAE;IACrG,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IAC9D,OAAO,aAAa,CAAC;QACjB,WAAW,EAAE,OAAO,CAAC,IAAI;QACzB,OAAO;QACP,OAAO,EAAE,KAAK,eAAe,CAAC,OAAO,CAAC,IAAI;QAC1C,IAAI,EAAE;YACF,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACpF,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD;KACJ,CAAC,CAAC;AACP,CAAC,CAAC","sourcesContent":["import { toCamelIdentifier } from \"@gtkx/utils\";\nimport type { InArg, OutArg } from \"./args.js\";\nimport type { GlCommand } from \"./model.js\";\nimport type { ReturnPlan } from \"./plan.js\";\n\nconst REFPAGES_BASE = \"https://registry.khronos.org/OpenGL-Refpages/gl4/html\";\n\nconst formatPrototype = (command: GlCommand): string => {\n    const params = command.params\n        .map((param) => (param.cType.endsWith(\"*\") ? `${param.cType}${param.name}` : `${param.cType} ${param.name}`))\n        .join(\", \");\n    return `${command.returnCType} ${command.name}(${params})`;\n};\n\nexport const inParamDocLine = (command: GlCommand, arg: InArg): string => {\n    const param = command.params.find((candidate) => toCamelIdentifier(candidate.name) === arg.name);\n    if (param === undefined) return ` * @param ${arg.name}`;\n    const notes: string[] = [`\\`${param.cType}\\``];\n    if (param.group !== undefined) notes.push(`group \\`${param.group}\\``);\n    if (param.len !== undefined) notes.push(`length \\`${param.len}\\``);\n    if (param.objectClass !== undefined) notes.push(`object class \\`${param.objectClass}\\``);\n    return ` * @param ${arg.name} - ${notes.join(\", \")}`;\n};\n\nconst returnsDocLine = (command: GlCommand, returnPlan: ReturnPlan, outs: OutArg[]): string | undefined => {\n    const members: string[] = [];\n    if (returnPlan.kind !== \"void\") members.push(`\\`${command.returnCType}\\``);\n    for (const out of outs) {\n        const param = command.params[out.paramIndex];\n        if (param === undefined)\n            throw new Error(`Output parameter index ${out.paramIndex} out of range on ${command.name}`);\n        members.push(`\\`${param.name}\\` (\\`${param.cType}\\`)`);\n    }\n    if (members.length === 0) return undefined;\n    if (members.length === 1) return ` * @returns ${members[0]}`;\n    return ` * @returns Tuple of ${members.join(\", \")}`;\n};\n\ntype CommandJsDocOptions = {\n    command: GlCommand;\n    feature: string;\n    ins: InArg[];\n    outs: OutArg[];\n    returnPlan: ReturnPlan;\n};\n\ntype SingularJsDocOptions = {\n    commandName: string;\n    feature: string;\n    summary: string;\n    body: string[];\n};\n\nexport const singularJsDoc = ({ commandName, feature, summary, body }: SingularJsDocOptions): string =>\n    [\n        \"/**\",\n        ` * ${summary}`,\n        \" *\",\n        ` * Provided by \\`${feature}\\`.`,\n        ...body,\n        ` * @see ${REFPAGES_BASE}/${commandName}.xhtml`,\n        \" */\",\n    ].join(\"\\n\");\n\nexport const commandJsDoc = ({ command, feature, ins, outs, returnPlan }: CommandJsDocOptions): string => {\n    const returnsLine = returnsDocLine(command, returnPlan, outs);\n    return singularJsDoc({\n        commandName: command.name,\n        feature,\n        summary: `\\`${formatPrototype(command)}\\``,\n        body: [\n            ...(ins.length > 0 ? [\" *\", ...ins.map((arg) => inParamDocLine(command, arg))] : []),\n            ...(returnsLine !== undefined ? [returnsLine] : []),\n        ],\n    });\n};\n"]}

package/dist/khronos/model.d.ts

@@ -0,0 +1,37 @@
+export type GlParam = {
+    name: string;
+    cType: string;
+    group?: string;
+    len?: string;
+    objectClass?: string;
+};
+export type GlCommand = {
+    name: string;
+    returnCType: string;
+    returnGroup?: string;
+    params: GlParam[];
+};
+export type GlEnum = {
+    name: string;
+    value: string;
+    groups: string[];
+};
+export type GlInterfaceBlock = {
+    profile?: string;
+    commands: string[];
+    enums: string[];
+};
+export type GlFeature = {
+    api: string;
+    name: string;
+    number: number;
+    requires: GlInterfaceBlock[];
+    removes: GlInterfaceBlock[];
+};
+export type GlRegistry = {
+    commands: Map<string, GlCommand>;
+    enums: GlEnum[];
+    features: GlFeature[];
+};
+export declare const loadGlRegistry: (path: string) => GlRegistry;
+//# sourceMappingURL=model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/khronos/model.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,OAAO,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACrB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,SAAS,EAAE,CAAC;CACzB,CAAC;AA4GF,eAAO,MAAM,cAAc,SAAU,MAAM,KAAG,UAgB7C,CAAC"}

package/dist/khronos/model.js

@@ -0,0 +1,132 @@
+import { collectText, nodeAttr, nodeChildren, nodeTag, parseRegistryFile } from "./parse.js";
+const NAME_TAG = "name";
+const SKIP_IN_C_TYPE = new Set([NAME_TAG, "comment"]);
+const normalizeWhitespace = (text) => text.replace(/\s+/g, " ").trim();
+const childNamed = (node, tag) => {
+    for (const child of nodeChildren(node)) {
+        if (nodeTag(child) === tag)
+            return child;
+    }
+    return undefined;
+};
+const elementName = (node) => {
+    const nameChild = childNamed(node, NAME_TAG);
+    if (nameChild === undefined)
+        return "";
+    return normalizeWhitespace(collectText(nameChild, new Set()));
+};
+const parseParam = (node) => {
+    const param = {
+        name: elementName(node),
+        cType: normalizeWhitespace(collectText(node, SKIP_IN_C_TYPE)),
+    };
+    const group = nodeAttr(node, "group");
+    const len = nodeAttr(node, "len");
+    const objectClass = nodeAttr(node, "class");
+    return {
+        ...param,
+        ...(group !== undefined ? { group } : {}),
+        ...(len !== undefined ? { len } : {}),
+        ...(objectClass !== undefined ? { objectClass } : {}),
+    };
+};
+const parseCommand = (node) => {
+    const proto = childNamed(node, "proto");
+    if (proto === undefined)
+        return undefined;
+    const params = [];
+    for (const child of nodeChildren(node)) {
+        if (nodeTag(child) === "param")
+            params.push(parseParam(child));
+    }
+    const returnGroup = nodeAttr(proto, "group");
+    return {
+        name: elementName(proto),
+        returnCType: normalizeWhitespace(collectText(proto, SKIP_IN_C_TYPE)),
+        ...(returnGroup !== undefined ? { returnGroup } : {}),
+        params,
+    };
+};
+const parseEnums = (node, into) => {
+    for (const child of nodeChildren(node)) {
+        if (nodeTag(child) !== "enum")
+            continue;
+        const name = nodeAttr(child, "name");
+        const value = nodeAttr(child, "value");
+        if (name === undefined || value === undefined)
+            continue;
+        const group = nodeAttr(child, "group");
+        into.push({
+            name,
+            value,
+            groups: group === undefined ? [] : group.split(",").map((part) => part.trim()),
+        });
+    }
+};
+const parseInterfaceBlock = (node) => {
+    const commands = [];
+    const enums = [];
+    for (const child of nodeChildren(node)) {
+        const name = nodeAttr(child, "name");
+        if (name === undefined)
+            continue;
+        const tag = nodeTag(child);
+        if (tag === "command")
+            commands.push(name);
+        else if (tag === "enum")
+            enums.push(name);
+    }
+    const profile = nodeAttr(node, "profile");
+    return {
+        ...(profile !== undefined ? { profile } : {}),
+        commands,
+        enums,
+    };
+};
+const parseFeature = (node) => {
+    const api = nodeAttr(node, "api");
+    const name = nodeAttr(node, "name");
+    const number = nodeAttr(node, "number");
+    if (api === undefined || name === undefined || number === undefined)
+        return undefined;
+    const requires = [];
+    const removes = [];
+    for (const child of nodeChildren(node)) {
+        const tag = nodeTag(child);
+        if (tag === "require")
+            requires.push(parseInterfaceBlock(child));
+        else if (tag === "remove")
+            removes.push(parseInterfaceBlock(child));
+    }
+    return { api, name, number: Number.parseFloat(number), requires, removes };
+};
+const parseCommandsSection = (section, into) => {
+    for (const child of nodeChildren(section)) {
+        if (nodeTag(child) !== "command")
+            continue;
+        const command = parseCommand(child);
+        if (command !== undefined && command.name.length > 0)
+            into.set(command.name, command);
+    }
+};
+export const loadGlRegistry = (path) => {
+    const commands = new Map();
+    const enums = [];
+    const features = [];
+    for (const section of parseRegistryFile(path)) {
+        const tag = nodeTag(section);
+        if (tag === "commands") {
+            parseCommandsSection(section, commands);
+        }
+        else if (tag === "enums") {
+            parseEnums(section, enums);
+        }
+        else if (tag === "feature") {
+            const feature = parseFeature(section);
+            if (feature !== undefined)
+                features.push(feature);
+        }
+    }
+    return { commands, enums, features };
+};
+//# sourceMappingURL=model.js.map

package/dist/khronos/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/khronos/model.ts"],"names":[],"mappings":"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","sourcesContent":["import { collectText, nodeAttr, nodeChildren, nodeTag, type OrderedNode, parseRegistryFile } from \"./parse.js\";\n\nexport type GlParam = {\n    name: string;\n    cType: string;\n    group?: string;\n    len?: string;\n    objectClass?: string;\n};\n\nexport type GlCommand = {\n    name: string;\n    returnCType: string;\n    returnGroup?: string;\n    params: GlParam[];\n};\n\nexport type GlEnum = {\n    name: string;\n    value: string;\n    groups: string[];\n};\n\nexport type GlInterfaceBlock = {\n    profile?: string;\n    commands: string[];\n    enums: string[];\n};\n\nexport type GlFeature = {\n    api: string;\n    name: string;\n    number: number;\n    requires: GlInterfaceBlock[];\n    removes: GlInterfaceBlock[];\n};\n\nexport type GlRegistry = {\n    commands: Map<string, GlCommand>;\n    enums: GlEnum[];\n    features: GlFeature[];\n};\n\nconst NAME_TAG = \"name\";\nconst SKIP_IN_C_TYPE: Set<string> = new Set([NAME_TAG, \"comment\"]);\n\nconst normalizeWhitespace = (text: string): string => text.replace(/\\s+/g, \" \").trim();\n\nconst childNamed = (node: OrderedNode, tag: string): OrderedNode | undefined => {\n    for (const child of nodeChildren(node)) {\n        if (nodeTag(child) === tag) return child;\n    }\n    return undefined;\n};\n\nconst elementName = (node: OrderedNode): string => {\n    const nameChild = childNamed(node, NAME_TAG);\n    if (nameChild === undefined) return \"\";\n    return normalizeWhitespace(collectText(nameChild, new Set()));\n};\n\nconst parseParam = (node: OrderedNode): GlParam => {\n    const param: GlParam = {\n        name: elementName(node),\n        cType: normalizeWhitespace(collectText(node, SKIP_IN_C_TYPE)),\n    };\n    const group = nodeAttr(node, \"group\");\n    const len = nodeAttr(node, \"len\");\n    const objectClass = nodeAttr(node, \"class\");\n    return {\n        ...param,\n        ...(group !== undefined ? { group } : {}),\n        ...(len !== undefined ? { len } : {}),\n        ...(objectClass !== undefined ? { objectClass } : {}),\n    };\n};\n\nconst parseCommand = (node: OrderedNode): GlCommand | undefined => {\n    const proto = childNamed(node, \"proto\");\n    if (proto === undefined) return undefined;\n    const params: GlParam[] = [];\n    for (const child of nodeChildren(node)) {\n        if (nodeTag(child) === \"param\") params.push(parseParam(child));\n    }\n    const returnGroup = nodeAttr(proto, \"group\");\n    return {\n        name: elementName(proto),\n        returnCType: normalizeWhitespace(collectText(proto, SKIP_IN_C_TYPE)),\n        ...(returnGroup !== undefined ? { returnGroup } : {}),\n        params,\n    };\n};\n\nconst parseEnums = (node: OrderedNode, into: GlEnum[]): void => {\n    for (const child of nodeChildren(node)) {\n        if (nodeTag(child) !== \"enum\") continue;\n        const name = nodeAttr(child, \"name\");\n        const value = nodeAttr(child, \"value\");\n        if (name === undefined || value === undefined) continue;\n        const group = nodeAttr(child, \"group\");\n        into.push({\n            name,\n            value,\n            groups: group === undefined ? [] : group.split(\",\").map((part) => part.trim()),\n        });\n    }\n};\n\nconst parseInterfaceBlock = (node: OrderedNode): GlInterfaceBlock => {\n    const commands: string[] = [];\n    const enums: string[] = [];\n    for (const child of nodeChildren(node)) {\n        const name = nodeAttr(child, \"name\");\n        if (name === undefined) continue;\n        const tag = nodeTag(child);\n        if (tag === \"command\") commands.push(name);\n        else if (tag === \"enum\") enums.push(name);\n    }\n    const profile = nodeAttr(node, \"profile\");\n    return {\n        ...(profile !== undefined ? { profile } : {}),\n        commands,\n        enums,\n    };\n};\n\nconst parseFeature = (node: OrderedNode): GlFeature | undefined => {\n    const api = nodeAttr(node, \"api\");\n    const name = nodeAttr(node, \"name\");\n    const number = nodeAttr(node, \"number\");\n    if (api === undefined || name === undefined || number === undefined) return undefined;\n    const requires: GlInterfaceBlock[] = [];\n    const removes: GlInterfaceBlock[] = [];\n    for (const child of nodeChildren(node)) {\n        const tag = nodeTag(child);\n        if (tag === \"require\") requires.push(parseInterfaceBlock(child));\n        else if (tag === \"remove\") removes.push(parseInterfaceBlock(child));\n    }\n    return { api, name, number: Number.parseFloat(number), requires, removes };\n};\n\nconst parseCommandsSection = (section: OrderedNode, into: Map<string, GlCommand>): void => {\n    for (const child of nodeChildren(section)) {\n        if (nodeTag(child) !== \"command\") continue;\n        const command = parseCommand(child);\n        if (command !== undefined && command.name.length > 0) into.set(command.name, command);\n    }\n};\n\nexport const loadGlRegistry = (path: string): GlRegistry => {\n    const commands = new Map<string, GlCommand>();\n    const enums: GlEnum[] = [];\n    const features: GlFeature[] = [];\n    for (const section of parseRegistryFile(path)) {\n        const tag = nodeTag(section);\n        if (tag === \"commands\") {\n            parseCommandsSection(section, commands);\n        } else if (tag === \"enums\") {\n            parseEnums(section, enums);\n        } else if (tag === \"feature\") {\n            const feature = parseFeature(section);\n            if (feature !== undefined) features.push(feature);\n        }\n    }\n    return { commands, enums, features };\n};\n"]}

package/dist/khronos/modules.d.ts

@@ -0,0 +1,11 @@
+import type { GlEnum } from "./model.js";
+import type { RenderedCommand } from "./render.js";
+export declare const renderEnumsModule: (tokens: {
+    token: GlEnum;
+    exportName: string;
+    literal: string;
+    feature: string;
+}[]) => string;
+export declare const renderTypesModule: (groupAliases: Map<string, string>) => string;
+export declare const renderCommandsModule: (rendered: RenderedCommand[], singulars: RenderedCommand[], usedTypes: Set<string>) => string;
+//# sourceMappingURL=modules.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"modules.d.ts","sourceRoot":"","sources":["../../src/khronos/modules.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAQnD,eAAO,MAAM,iBAAiB,WAClB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,KAClF,MASF,CAAC;AAEF,eAAO,MAAM,iBAAiB,iBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAAG,MAwBrE,CAAC;AAIF,eAAO,MAAM,oBAAoB,aACnB,eAAe,EAAE,aAChB,eAAe,EAAE,aACjB,GAAG,CAAC,MAAM,CAAC,KACvB,MAiBF,CAAC"}

package/dist/khronos/modules.js

@@ -0,0 +1,58 @@
+import { sortStrings, sortStringsBy } from "@gtkx/utils";
+import { ModuleBuilder } from "../writer/module.js";
+import { GL_SCALARS } from "./plan.js";
+const LIB_CONSTANT = `export const LIB = "libGL.so.1";`;
+const GENERATED_HEADER = `/**
+ * GENERATED FILE: do not edit.
+ */`;
+export const renderEnumsModule = (tokens) => {
+    const builder = new ModuleBuilder();
+    for (const { token, exportName, literal, feature } of tokens) {
+        const groupNote = token.groups.length > 0 ? ` Groups: ${token.groups.map((g) => `\`${g}\``).join(", ")}.` : "";
+        builder.appendDeclaration(`/** \`${token.name}\`, provided by \`${feature}\`.${groupNote} */\nexport const ${exportName} = ${literal};`);
+    }
+    return `${GENERATED_HEADER}\n\n${builder.toSource()}`;
+};
+export const renderTypesModule = (groupAliases) => {
+    const builder = new ModuleBuilder();
+    builder.imports.addNamed("@gtkx/native", "ExternalObject", true);
+    builder.imports.addNamed("@gtkx/native", "Handle", true);
+    builder.appendDeclaration(`/** An opaque \`GLsync\` fence handle. */\nexport type GLsync = ExternalObject<Handle>;`);
+    builder.appendDeclaration(`/** An opaque native pointer handle (e.g. a \`glMapBufferRange\` mapping). */\nexport type GLpointer = ExternalObject<Handle>;`);
+    const seen = new Set();
+    for (const scalar of GL_SCALARS.values()) {
+        if (seen.has(scalar.tsAlias))
+            continue;
+        seen.add(scalar.tsAlias);
+        builder.appendDeclaration(`/** The C \`${scalar.tsAlias}\` scalar. */\nexport type ${scalar.tsAlias} = number;`);
+    }
+    for (const [group, base] of sortStringsBy(groupAliases.entries(), ([key]) => key)) {
+        builder.appendDeclaration(`/** Registry enum group \`${group}\`; open and documentation-only, any \`${base}\` value is accepted. */\nexport type ${group} = ${base};`);
+    }
+    return `${GENERATED_HEADER}\n\n${builder.toSource()}`;
+};
+const TS_PRIMITIVES = new Set(["boolean", "string", "void", "number"]);
+export const renderCommandsModule = (rendered, singulars, usedTypes) => {
+    const builder = new ModuleBuilder();
+    builder.imports.addNamed("@gtkx/runtime", "t");
+    for (const alias of sortStrings(usedTypes)) {
+        if (TS_PRIMITIVES.has(alias))
+            continue;
+        builder.imports.addNamed("./types.js", alias, true);
+    }
+    builder.appendBinding(LIB_CONSTANT);
+    for (const command of rendered) {
+        if (command.binding !== undefined)
+            builder.appendBinding(command.binding, command.binding);
+    }
+    for (const singular of singulars) {
+        if (singular.binding !== undefined)
+            builder.appendBinding(singular.binding, singular.binding);
+    }
+    for (const command of rendered)
+        builder.appendDeclaration(command.declaration);
+    for (const singular of singulars)
+        builder.appendDeclaration(singular.declaration);
+    return `${GENERATED_HEADER}\n\n${builder.toSource()}`;
+};
+//# sourceMappingURL=modules.js.map

package/dist/khronos/modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.js","sourceRoot":"","sources":["../../src/khronos/modules.ts"],"names":[],"mappings":"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","sourcesContent":["import { sortStrings, sortStringsBy } from \"@gtkx/utils\";\nimport { ModuleBuilder } from \"../writer/module.js\";\nimport type { GlEnum } from \"./model.js\";\nimport { GL_SCALARS } from \"./plan.js\";\nimport type { RenderedCommand } from \"./render.js\";\n\nconst LIB_CONSTANT = `export const LIB = \"libGL.so.1\";`;\n\nconst GENERATED_HEADER = `/**\n * GENERATED FILE: do not edit.\n */`;\n\nexport const renderEnumsModule = (\n    tokens: { token: GlEnum; exportName: string; literal: string; feature: string }[],\n): string => {\n    const builder = new ModuleBuilder();\n    for (const { token, exportName, literal, feature } of tokens) {\n        const groupNote = token.groups.length > 0 ? ` Groups: ${token.groups.map((g) => `\\`${g}\\``).join(\", \")}.` : \"\";\n        builder.appendDeclaration(\n            `/** \\`${token.name}\\`, provided by \\`${feature}\\`.${groupNote} */\\nexport const ${exportName} = ${literal};`,\n        );\n    }\n    return `${GENERATED_HEADER}\\n\\n${builder.toSource()}`;\n};\n\nexport const renderTypesModule = (groupAliases: Map<string, string>): string => {\n    const builder = new ModuleBuilder();\n    builder.imports.addNamed(\"@gtkx/native\", \"ExternalObject\", true);\n    builder.imports.addNamed(\"@gtkx/native\", \"Handle\", true);\n    builder.appendDeclaration(\n        `/** An opaque \\`GLsync\\` fence handle. */\\nexport type GLsync = ExternalObject<Handle>;`,\n    );\n    builder.appendDeclaration(\n        `/** An opaque native pointer handle (e.g. a \\`glMapBufferRange\\` mapping). */\\nexport type GLpointer = ExternalObject<Handle>;`,\n    );\n    const seen = new Set<string>();\n    for (const scalar of GL_SCALARS.values()) {\n        if (seen.has(scalar.tsAlias)) continue;\n        seen.add(scalar.tsAlias);\n        builder.appendDeclaration(\n            `/** The C \\`${scalar.tsAlias}\\` scalar. */\\nexport type ${scalar.tsAlias} = number;`,\n        );\n    }\n    for (const [group, base] of sortStringsBy(groupAliases.entries(), ([key]) => key)) {\n        builder.appendDeclaration(\n            `/** Registry enum group \\`${group}\\`; open and documentation-only, any \\`${base}\\` value is accepted. */\\nexport type ${group} = ${base};`,\n        );\n    }\n    return `${GENERATED_HEADER}\\n\\n${builder.toSource()}`;\n};\n\nconst TS_PRIMITIVES: Set<string> = new Set([\"boolean\", \"string\", \"void\", \"number\"]);\n\nexport const renderCommandsModule = (\n    rendered: RenderedCommand[],\n    singulars: RenderedCommand[],\n    usedTypes: Set<string>,\n): string => {\n    const builder = new ModuleBuilder();\n    builder.imports.addNamed(\"@gtkx/runtime\", \"t\");\n    for (const alias of sortStrings(usedTypes)) {\n        if (TS_PRIMITIVES.has(alias)) continue;\n        builder.imports.addNamed(\"./types.js\", alias, true);\n    }\n    builder.appendBinding(LIB_CONSTANT);\n    for (const command of rendered) {\n        if (command.binding !== undefined) builder.appendBinding(command.binding, command.binding);\n    }\n    for (const singular of singulars) {\n        if (singular.binding !== undefined) builder.appendBinding(singular.binding, singular.binding);\n    }\n    for (const command of rendered) builder.appendDeclaration(command.declaration);\n    for (const singular of singulars) builder.appendDeclaration(singular.declaration);\n    return `${GENERATED_HEADER}\\n\\n${builder.toSource()}`;\n};\n"]}

package/dist/khronos/parse.d.ts

@@ -0,0 +1,9 @@
+export type OrderedNode = {
+    [key: string]: unknown;
+};
+export declare const parseRegistryFile: (path: string) => OrderedNode[];
+export declare const nodeTag: (node: OrderedNode) => string;
+export declare const nodeChildren: (node: OrderedNode) => OrderedNode[];
+export declare const nodeAttr: (node: OrderedNode, name: string) => string | undefined;
+export declare const collectText: (node: OrderedNode, skipTags: Set<string>) => string;
+//# sourceMappingURL=parse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/khronos/parse.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAcrD,eAAO,MAAM,iBAAiB,SAAU,MAAM,KAAG,WAAW,EAO3D,CAAC;AAEF,eAAO,MAAM,OAAO,SAAU,WAAW,KAAG,MAK3C,CAAC;AAEF,eAAO,MAAM,YAAY,SAAU,WAAW,KAAG,WAAW,EAK3D,CAAC;AAEF,eAAO,MAAM,QAAQ,SAAU,WAAW,QAAQ,MAAM,KAAG,MAAM,GAAG,SAKnE,CAAC;AAOF,eAAO,MAAM,WAAW,SAAU,WAAW,YAAY,GAAG,CAAC,MAAM,CAAC,KAAG,MAatE,CAAC"}

package/dist/khronos/parse.js

@@ -0,0 +1,61 @@
+import { readFileSync } from "node:fs";
+import { XMLParser } from "fast-xml-parser";
+const ATTRIBUTES_KEY = ":@";
+const TEXT_KEY = "#text";
+const PARSER = new XMLParser({
+    ignoreAttributes: false,
+    attributeNamePrefix: "@_",
+    parseAttributeValue: false,
+    parseTagValue: false,
+    trimValues: false,
+    preserveOrder: true,
+});
+export const parseRegistryFile = (path) => {
+    const xml = readFileSync(path, "utf-8");
+    const documentNodes = PARSER.parse(xml);
+    for (const node of documentNodes) {
+        if (nodeTag(node) === "registry")
+            return nodeChildren(node);
+    }
+    throw new Error(`No <registry> root element found in ${path}`);
+};
+export const nodeTag = (node) => {
+    for (const key of Object.keys(node)) {
+        if (key !== ATTRIBUTES_KEY && key !== TEXT_KEY)
+            return key;
+    }
+    return TEXT_KEY;
+};
+export const nodeChildren = (node) => {
+    const tag = nodeTag(node);
+    if (tag === TEXT_KEY)
+        return [];
+    const children = node[tag];
+    return Array.isArray(children) ? children : [];
+};
+export const nodeAttr = (node, name) => {
+    const attributes = node[ATTRIBUTES_KEY];
+    if (typeof attributes !== "object" || attributes === null)
+        return undefined;
+    const value = attributes[`@_${name}`];
+    return typeof value === "string" ? value : undefined;
+};
+const nodeText = (node) => {
+    const value = node[TEXT_KEY];
+    return typeof value === "string" ? value : undefined;
+};
+export const collectText = (node, skipTags) => {
+    let text = "";
+    for (const child of nodeChildren(node)) {
+        const childText = nodeText(child);
+        if (childText !== undefined) {
+            text += childText;
+            continue;
+        }
+        if (!skipTags.has(nodeTag(child))) {
+            text += collectText(child, skipTags);
+        }
+    }
+    return text;
+};
+//# sourceMappingURL=parse.js.map