@gtkx/codegen 1.0.0-rc.1 → 1.0.0-rc.2

package/dist/khronos/pipeline.d.ts

@@ -4,14 +4,14 @@ type GlExclusion = {
     command: string;
     reason: GlExclusionReason;
 };
-export type GlGenerationReport = {
+type GlGenerationReport = {
     selection: GlSelection;
     selectedCommands: number;
     emittedCommands: number;
     derivedSingulars: number;
     exclusions: GlExclusion[];
 };
-export type GlGenerationResult = {
+type GlGenerationResult = {
     files: Map<string, string>;
     report: GlGenerationReport;
 };
@@ -19,6 +19,6 @@ type GlGenerationOptions = {
     registryPath: string;
     overrideExports: Set<string>;
 };
-export declare const generateGlModules: (options: GlGenerationOptions) => GlGenerationResult;
-export {};
+declare const generateGlModules: (options: GlGenerationOptions) => GlGenerationResult;
+export { generateGlModules, type GlGenerationReport, type GlGenerationResult };
 //# sourceMappingURL=pipeline.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/khronos/pipeline.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoB,KAAK,iBAAiB,EAAiD,MAAM,WAAW,CAAC;AAEpH,OAAO,EAAE,KAAK,WAAW,EAA6B,MAAM,aAAa,CAAC;AAmD1E,KAAK,WAAW,GAAG;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,iBAAiB,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC7B,SAAS,EAAE,WAAW,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,WAAW,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC7B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,MAAM,EAAE,kBAAkB,CAAC;CAC9B,CAAC;AA0CF,KAAK,mBAAmB,GAAG;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAChC,CAAC;AAiFF,eAAO,MAAM,iBAAiB,YAAa,mBAAmB,KAAG,kBAmChE,CAAC"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/khronos/pipeline.ts"],"names":[],"mappings":"AAIA,OAAO,EAEH,KAAK,iBAAiB,EAKzB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,KAAK,WAAW,EAA6B,MAAM,aAAa,CAAC;AAE1E,KAAK,WAAW,GAAG;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,iBAAiB,CAAC;CAC7B,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACtB,SAAS,EAAE,WAAW,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,WAAW,EAAE,CAAC;CAC7B,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACtB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,MAAM,EAAE,kBAAkB,CAAC;CAC9B,CAAC;AAIF,KAAK,mBAAmB,GAAG;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAChC,CAAC;AAkQF,QAAA,MAAM,iBAAiB,GAAI,SAAS,mBAAmB,KAAG,kBAsCzD,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,CAAC"}

package/dist/khronos/pipeline.js

@@ -1,7 +1,8 @@
 import { sanitizeIdentifier, sortStrings, sortStringsBy } from "@gtkx/utils";
 import { loadGlRegistry } from "./model.js";
 import { renderCommandsModule, renderEnumsModule, renderTypesModule } from "./modules.js";
-import { planCommand } from "./plan.js";
+import { paramPairAt } from "./param-pair.js";
+import { planCommand, } from "./plan.js";
 import { deriveDeleteSingular, deriveGenSingular, renderCommand } from "./render.js";
 import { resolveEnum, selectSubset } from "./select.js";
 const BYTE_OFFSET_PARAMS = new Set([
@@ -49,8 +50,10 @@ const PLAN_POLICY = {
     byteOffsetParams: BYTE_OFFSET_PARAMS,
     singleValuedQueries: SINGLE_VALUED_QUERIES,
 };
-const enumExportName = (name) => sanitizeIdentifier((name.startsWith("GL_") ? name.slice(3) : name).toUpperCase());
 const MAX_SAFE = BigInt(Number.MAX_SAFE_INTEGER);
+const GROUP_BEARING_PARAM_KINDS = new Set(["scalar", "array-in", "ref-out"]);
+const GL_SELECTION = { api: "gl", version: 4.6, profile: "core" };
+const enumExportName = (name) => sanitizeIdentifier((name.startsWith("GL_") ? name.slice(3) : name).toUpperCase());
 const enumLiteral = (token) => {
     const text = token.value.trim();
     let value;
@@ -60,93 +63,129 @@ const enumLiteral = (token) => {
     catch {
         return undefined;
     }
-    if (value > MAX_SAFE)
+    if (value > MAX_SAFE) {
         return undefined;
-    if (/^0[xX]/.test(text))
+    }
+    if (/^0[xX]/.test(text)) {
         return `0x${text.slice(2).toLowerCase()}`;
+    }
     return text;
 };
+const groupAliasValue = (existing, scalarAlias) => {
+    if (scalarAlias === "GLbitfield") {
+        return "GLbitfield";
+    }
+    return existing ?? "GLenum";
+};
+const mergeGroupAlias = (aliases, scalar, group) => {
+    if (group === undefined) {
+        return;
+    }
+    if (scalar.groupBearing !== true) {
+        return;
+    }
+    const existing = aliases.get(group);
+    if (existing === "GLbitfield") {
+        return;
+    }
+    aliases.set(group, groupAliasValue(existing, scalar.tsAlias));
+};
+const isGroupBearingParam = (paramPlan) => GROUP_BEARING_PARAM_KINDS.has(paramPlan.kind);
+const considerParamGroup = (aliases, plan, index) => {
+    const { paramPlan, param } = paramPairAt(plan, index);
+    if (paramPlan === undefined || param === undefined) {
+        return;
+    }
+    if (isGroupBearingParam(paramPlan)) {
+        mergeGroupAlias(aliases, paramPlan.scalar, param.group);
+    }
+};
+const collectPlanGroups = (aliases, plan) => {
+    for (let index = 0; index < plan.params.length; index++) {
+        considerParamGroup(aliases, plan, index);
+    }
+    if (plan.returnPlan.kind === "scalar") {
+        mergeGroupAlias(aliases, plan.returnPlan.scalar, plan.command.returnGroup);
+    }
+};
 const collectGroupAliases = (plans) => {
     const aliases = new Map();
-    const consider = (scalar, group) => {
-        if (group === undefined)
-            return;
-        if (scalar.groupBearing !== true)
-            return;
-        const existing = aliases.get(group);
-        if (existing === "GLbitfield")
-            return;
-        aliases.set(group, scalar.tsAlias === "GLbitfield" ? "GLbitfield" : (existing ?? "GLenum"));
-    };
     for (const plan of plans) {
-        plan.params.forEach((paramPlan, index) => {
-            const param = plan.command.params[index];
-            if (param === undefined)
-                return;
-            if (paramPlan.kind === "scalar" || paramPlan.kind === "array-in" || paramPlan.kind === "ref-out") {
-                consider(paramPlan.scalar, param.group);
-            }
-        });
-        if (plan.returnPlan.kind === "scalar")
-            consider(plan.returnPlan.scalar, plan.command.returnGroup);
+        collectPlanGroups(aliases, plan);
     }
     return aliases;
 };
-const GL_SELECTION = { api: "gl", version: 4.6, profile: "core" };
+const planSelectedCommand = (registry, name) => {
+    const command = registry.commands.get(name);
+    if (command === undefined) {
+        throw new Error(`Selected command ${name} is not defined in the registry`);
+    }
+    if (OVERRIDE_OWNED.has(name)) {
+        return { command: name, reason: "override-owned" };
+    }
+    const plan = planCommand(command, PLAN_POLICY);
+    if (!plan.ok) {
+        return { command: name, reason: plan.reason };
+    }
+    return plan;
+};
 const planSelectedCommands = (registry, commandNames) => {
     const exclusions = [];
     const okPlans = [];
     const planFeatures = new Map();
-    for (const [name, feature] of sortStringsBy(commandNames.entries(), ([key]) => key)) {
-        const command = registry.commands.get(name);
-        if (command === undefined)
-            throw new Error(`Selected command ${name} is not defined in the registry`);
-        if (OVERRIDE_OWNED.has(name)) {
-            exclusions.push({ command: name, reason: "override-owned" });
-            continue;
+    const sortedCommands = sortStringsBy(commandNames.entries(), ([key]) => key);
+    for (const [name, feature] of sortedCommands) {
+        const result = planSelectedCommand(registry, name);
+        if ("ok" in result) {
+            okPlans.push(result);
+            planFeatures.set(name, feature);
         }
-        const plan = planCommand(command, PLAN_POLICY);
-        if (!plan.ok) {
-            exclusions.push({ command: name, reason: plan.reason });
-            continue;
+        else {
+            exclusions.push(result);
         }
-        okPlans.push(plan);
-        planFeatures.set(name, feature);
     }
     return { okPlans, planFeatures, exclusions };
 };
 const buildEnumRows = (registry, enumNames) => {
     const enumRows = [];
-    for (const [name, feature] of sortStringsBy(enumNames.entries(), ([key]) => key)) {
+    const sortedEnums = sortStringsBy(enumNames.entries(), ([key]) => key);
+    for (const [name, feature] of sortedEnums) {
         const token = resolveEnum(registry, name);
         const literal = enumLiteral(token);
-        if (literal === undefined)
+        if (literal === undefined) {
             continue;
+        }
         enumRows.push({ token, exportName: enumExportName(name), literal, feature });
     }
     return enumRows;
 };
+const claimExportName = (exportNames, name, owner) => {
+    const existing = exportNames.get(name);
+    if (existing !== undefined) {
+        throw new Error(`Generated export name collision: ${name} (${existing} vs ${owner})`);
+    }
+    exportNames.set(name, owner);
+};
 const assertExportNamesDisjoint = (rendered, singulars, enumRows, overrideExports) => {
     const exportNames = new Map();
-    const claim = (name, owner) => {
-        const existing = exportNames.get(name);
-        if (existing !== undefined) {
-            throw new Error(`Generated export name collision: ${name} (${existing} vs ${owner})`);
-        }
-        exportNames.set(name, owner);
-    };
-    for (const command of rendered)
-        claim(command.exportName, "command");
-    for (const singular of singulars)
-        claim(singular.exportName, "derived singular");
-    for (const row of enumRows)
-        claim(row.exportName, "enum constant");
-    const overrideCollisions = [...exportNames.keys()].filter((name) => overrideExports.has(name));
+    for (const command of rendered) {
+        claimExportName(exportNames, command.exportName, "command");
+    }
+    for (const singular of singulars) {
+        claimExportName(exportNames, singular.exportName, "derived singular");
+    }
+    for (const row of enumRows) {
+        claimExportName(exportNames, row.exportName, "enum constant");
+    }
+    const overrideCollisions = exportNames
+        .keys()
+        .filter((name) => overrideExports.has(name))
+        .toArray();
     if (overrideCollisions.length > 0) {
         throw new Error(`Override module exports collide with generated exports: ${sortStrings(overrideCollisions).join(", ")}`);
     }
 };
-export const generateGlModules = (options) => {
+const generateGlModules = (options) => {
     const selection = GL_SELECTION;
     const registry = loadGlRegistry(options.registryPath);
     const subset = selectSubset(registry, selection);
@@ -158,8 +197,9 @@ export const generateGlModules = (options) => {
         const feature = planFeatures.get(plan.command.name) ?? "unknown feature";
         rendered.push(renderCommand(plan, feature, usedTypes));
         const singular = deriveGenSingular(plan, feature, usedTypes) ?? deriveDeleteSingular(plan, feature, usedTypes);
-        if (singular !== undefined)
+        if (singular !== undefined) {
             singulars.push(singular);
+        }
     }
     const enumRows = buildEnumRows(registry, subset.enums);
     assertExportNamesDisjoint(rendered, singulars, enumRows, options.overrideExports);
@@ -179,4 +219,5 @@ export const generateGlModules = (options) => {
         },
     };
 };
+export { generateGlModules };
 //# sourceMappingURL=pipeline.js.map

package/dist/khronos/pipeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/khronos/pipeline.ts"],"names":[],"mappings":"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","sourcesContent":["import { sanitizeIdentifier, sortStrings, sortStringsBy } from \"@gtkx/utils\";\nimport { type GlEnum, loadGlRegistry } from \"./model.js\";\nimport { renderCommandsModule, renderEnumsModule, renderTypesModule } from \"./modules.js\";\nimport { type CommandPlan, type GlExclusionReason, type GlPlanPolicy, type GlScalar, planCommand } from \"./plan.js\";\nimport { deriveDeleteSingular, deriveGenSingular, type RenderedCommand, renderCommand } from \"./render.js\";\nimport { type GlSelection, resolveEnum, selectSubset } from \"./select.js\";\n\nconst BYTE_OFFSET_PARAMS: Set<string> = new Set([\n    \"glVertexAttribPointer:pointer\",\n    \"glVertexAttribIPointer:pointer\",\n    \"glVertexAttribLPointer:pointer\",\n    \"glDrawElements:indices\",\n    \"glDrawRangeElements:indices\",\n    \"glDrawElementsBaseVertex:indices\",\n    \"glDrawRangeElementsBaseVertex:indices\",\n    \"glDrawElementsInstanced:indices\",\n    \"glDrawElementsInstancedBaseVertex:indices\",\n    \"glDrawElementsInstancedBaseInstance:indices\",\n    \"glDrawElementsInstancedBaseVertexBaseInstance:indices\",\n    \"glMultiDrawElements:indices\",\n    \"glMultiDrawElementsBaseVertex:indices\",\n    \"glDrawArraysIndirect:indirect\",\n    \"glDrawElementsIndirect:indirect\",\n    \"glMultiDrawArraysIndirect:indirect\",\n    \"glMultiDrawElementsIndirect:indirect\",\n]);\n\nconst SINGLE_VALUED_QUERIES: Set<string> = new Set([\n    \"glGetShaderiv\",\n    \"glGetProgramiv\",\n    \"glGetProgramPipelineiv\",\n    \"glGetBufferParameteriv\",\n    \"glGetBufferParameteri64v\",\n    \"glGetRenderbufferParameteriv\",\n    \"glGetFramebufferParameteriv\",\n    \"glGetFramebufferAttachmentParameteriv\",\n    \"glGetQueryiv\",\n    \"glGetQueryObjectiv\",\n    \"glGetQueryObjectuiv\",\n    \"glGetQueryObjecti64v\",\n    \"glGetQueryObjectui64v\",\n    \"glGetTransformFeedbackiv\",\n    \"glGetVertexArrayiv\",\n]);\n\nconst OVERRIDE_OWNED: Set<string> = new Set([\n    \"glGetShaderInfoLog\",\n    \"glGetProgramInfoLog\",\n    \"glGetProgramPipelineInfoLog\",\n]);\n\nconst PLAN_POLICY: GlPlanPolicy = {\n    byteOffsetParams: BYTE_OFFSET_PARAMS,\n    singleValuedQueries: SINGLE_VALUED_QUERIES,\n};\n\ntype GlExclusion = {\n    command: string;\n    reason: GlExclusionReason;\n};\n\nexport type GlGenerationReport = {\n    selection: GlSelection;\n    selectedCommands: number;\n    emittedCommands: number;\n    derivedSingulars: number;\n    exclusions: GlExclusion[];\n};\n\nexport type GlGenerationResult = {\n    files: Map<string, string>;\n    report: GlGenerationReport;\n};\n\nconst enumExportName = (name: string): string =>\n    sanitizeIdentifier((name.startsWith(\"GL_\") ? name.slice(3) : name).toUpperCase());\n\nconst MAX_SAFE = BigInt(Number.MAX_SAFE_INTEGER);\n\nconst enumLiteral = (token: GlEnum): string | undefined => {\n    const text = token.value.trim();\n    let value: bigint;\n    try {\n        value = BigInt(text);\n    } catch {\n        return undefined;\n    }\n    if (value > MAX_SAFE) return undefined;\n    if (/^0[xX]/.test(text)) return `0x${text.slice(2).toLowerCase()}`;\n    return text;\n};\n\nconst collectGroupAliases = (plans: (CommandPlan & { ok: true })[]): Map<string, string> => {\n    const aliases = new Map<string, string>();\n    const consider = (scalar: GlScalar, group: string | undefined): void => {\n        if (group === undefined) return;\n        if (scalar.groupBearing !== true) return;\n        const existing = aliases.get(group);\n        if (existing === \"GLbitfield\") return;\n        aliases.set(group, scalar.tsAlias === \"GLbitfield\" ? \"GLbitfield\" : (existing ?? \"GLenum\"));\n    };\n    for (const plan of plans) {\n        plan.params.forEach((paramPlan, index) => {\n            const param = plan.command.params[index];\n            if (param === undefined) return;\n            if (paramPlan.kind === \"scalar\" || paramPlan.kind === \"array-in\" || paramPlan.kind === \"ref-out\") {\n                consider(paramPlan.scalar, param.group);\n            }\n        });\n        if (plan.returnPlan.kind === \"scalar\") consider(plan.returnPlan.scalar, plan.command.returnGroup);\n    }\n    return aliases;\n};\n\ntype GlGenerationOptions = {\n    registryPath: string;\n    overrideExports: Set<string>;\n};\n\nconst GL_SELECTION: GlSelection = { api: \"gl\", version: 4.6, profile: \"core\" };\n\ntype OkPlan = CommandPlan & { ok: true };\n\ntype PlannedSelection = {\n    okPlans: OkPlan[];\n    planFeatures: Map<string, string>;\n    exclusions: GlExclusion[];\n};\n\nconst planSelectedCommands = (\n    registry: ReturnType<typeof loadGlRegistry>,\n    commandNames: Map<string, string>,\n): PlannedSelection => {\n    const exclusions: GlExclusion[] = [];\n    const okPlans: OkPlan[] = [];\n    const planFeatures = new Map<string, string>();\n    for (const [name, feature] of sortStringsBy(commandNames.entries(), ([key]) => key)) {\n        const command = registry.commands.get(name);\n        if (command === undefined) throw new Error(`Selected command ${name} is not defined in the registry`);\n        if (OVERRIDE_OWNED.has(name)) {\n            exclusions.push({ command: name, reason: \"override-owned\" });\n            continue;\n        }\n        const plan = planCommand(command, PLAN_POLICY);\n        if (!plan.ok) {\n            exclusions.push({ command: name, reason: plan.reason });\n            continue;\n        }\n        okPlans.push(plan);\n        planFeatures.set(name, feature);\n    }\n    return { okPlans, planFeatures, exclusions };\n};\n\ntype EnumRow = {\n    token: GlEnum;\n    exportName: string;\n    literal: string;\n    feature: string;\n};\n\nconst buildEnumRows = (registry: ReturnType<typeof loadGlRegistry>, enumNames: Map<string, string>): EnumRow[] => {\n    const enumRows: EnumRow[] = [];\n    for (const [name, feature] of sortStringsBy(enumNames.entries(), ([key]) => key)) {\n        const token = resolveEnum(registry, name);\n        const literal = enumLiteral(token);\n        if (literal === undefined) continue;\n        enumRows.push({ token, exportName: enumExportName(name), literal, feature });\n    }\n    return enumRows;\n};\n\nconst assertExportNamesDisjoint = (\n    rendered: RenderedCommand[],\n    singulars: RenderedCommand[],\n    enumRows: EnumRow[],\n    overrideExports: Set<string>,\n): void => {\n    const exportNames = new Map<string, string>();\n    const claim = (name: string, owner: string): void => {\n        const existing = exportNames.get(name);\n        if (existing !== undefined) {\n            throw new Error(`Generated export name collision: ${name} (${existing} vs ${owner})`);\n        }\n        exportNames.set(name, owner);\n    };\n    for (const command of rendered) claim(command.exportName, \"command\");\n    for (const singular of singulars) claim(singular.exportName, \"derived singular\");\n    for (const row of enumRows) claim(row.exportName, \"enum constant\");\n\n    const overrideCollisions = [...exportNames.keys()].filter((name) => overrideExports.has(name));\n    if (overrideCollisions.length > 0) {\n        throw new Error(\n            `Override module exports collide with generated exports: ${sortStrings(overrideCollisions).join(\", \")}`,\n        );\n    }\n};\n\nexport const generateGlModules = (options: GlGenerationOptions): GlGenerationResult => {\n    const selection = GL_SELECTION;\n    const registry = loadGlRegistry(options.registryPath);\n    const subset = selectSubset(registry, selection);\n    const { okPlans, planFeatures, exclusions } = planSelectedCommands(registry, subset.commands);\n\n    const usedTypes = new Set<string>();\n    const rendered: RenderedCommand[] = [];\n    const singulars: RenderedCommand[] = [];\n    for (const plan of okPlans) {\n        const feature = planFeatures.get(plan.command.name) ?? \"unknown feature\";\n        rendered.push(renderCommand(plan, feature, usedTypes));\n        const singular = deriveGenSingular(plan, feature, usedTypes) ?? deriveDeleteSingular(plan, feature, usedTypes);\n        if (singular !== undefined) singulars.push(singular);\n    }\n\n    const enumRows = buildEnumRows(registry, subset.enums);\n    assertExportNamesDisjoint(rendered, singulars, enumRows, options.overrideExports);\n\n    const files = new Map<string, string>([\n        [\"types.ts\", renderTypesModule(collectGroupAliases(okPlans))],\n        [\"enums.ts\", renderEnumsModule(enumRows)],\n        [\"commands.ts\", renderCommandsModule(rendered, singulars, usedTypes)],\n    ]);\n\n    return {\n        files,\n        report: {\n            selection,\n            selectedCommands: subset.commands.size,\n            emittedCommands: rendered.length,\n            derivedSingulars: singulars.length,\n            exclusions,\n        },\n    };\n};\n"]}
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/khronos/pipeline.ts"],"names":[],"mappings":"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","sourcesContent":["import { sanitizeIdentifier, sortStrings, sortStringsBy } from \"@gtkx/utils\";\nimport { type GlEnum, loadGlRegistry } from \"./model.js\";\nimport { renderCommandsModule, renderEnumsModule, renderTypesModule } from \"./modules.js\";\nimport { paramPairAt } from \"./param-pair.js\";\nimport {\n    type CommandPlan,\n    type GlExclusionReason,\n    type GlPlanPolicy,\n    type GlScalar,\n    type ParamPlan,\n    planCommand,\n} from \"./plan.js\";\nimport { deriveDeleteSingular, deriveGenSingular, renderCommand, type RenderedCommand } from \"./render.js\";\nimport { type GlSelection, resolveEnum, selectSubset } from \"./select.js\";\n\ntype GlExclusion = {\n    command: string;\n    reason: GlExclusionReason;\n};\n\ntype GlGenerationReport = {\n    selection: GlSelection;\n    selectedCommands: number;\n    emittedCommands: number;\n    derivedSingulars: number;\n    exclusions: GlExclusion[];\n};\n\ntype GlGenerationResult = {\n    files: Map<string, string>;\n    report: GlGenerationReport;\n};\n\ntype GroupBearingParamPlan = Extract<ParamPlan, { kind: \"scalar\" | \"array-in\" | \"ref-out\" }>;\n\ntype GlGenerationOptions = {\n    registryPath: string;\n    overrideExports: Set<string>;\n};\n\ntype OkPlan = CommandPlan & { ok: true };\n\ntype PlannedSelection = {\n    okPlans: OkPlan[];\n    planFeatures: Map<string, string>;\n    exclusions: GlExclusion[];\n};\n\ntype EnumRow = {\n    token: GlEnum;\n    exportName: string;\n    literal: string;\n    feature: string;\n};\n\nconst BYTE_OFFSET_PARAMS: Set<string> = new Set([\n    \"glVertexAttribPointer:pointer\",\n    \"glVertexAttribIPointer:pointer\",\n    \"glVertexAttribLPointer:pointer\",\n    \"glDrawElements:indices\",\n    \"glDrawRangeElements:indices\",\n    \"glDrawElementsBaseVertex:indices\",\n    \"glDrawRangeElementsBaseVertex:indices\",\n    \"glDrawElementsInstanced:indices\",\n    \"glDrawElementsInstancedBaseVertex:indices\",\n    \"glDrawElementsInstancedBaseInstance:indices\",\n    \"glDrawElementsInstancedBaseVertexBaseInstance:indices\",\n    \"glMultiDrawElements:indices\",\n    \"glMultiDrawElementsBaseVertex:indices\",\n    \"glDrawArraysIndirect:indirect\",\n    \"glDrawElementsIndirect:indirect\",\n    \"glMultiDrawArraysIndirect:indirect\",\n    \"glMultiDrawElementsIndirect:indirect\",\n]);\n\nconst SINGLE_VALUED_QUERIES: Set<string> = new Set([\n    \"glGetShaderiv\",\n    \"glGetProgramiv\",\n    \"glGetProgramPipelineiv\",\n    \"glGetBufferParameteriv\",\n    \"glGetBufferParameteri64v\",\n    \"glGetRenderbufferParameteriv\",\n    \"glGetFramebufferParameteriv\",\n    \"glGetFramebufferAttachmentParameteriv\",\n    \"glGetQueryiv\",\n    \"glGetQueryObjectiv\",\n    \"glGetQueryObjectuiv\",\n    \"glGetQueryObjecti64v\",\n    \"glGetQueryObjectui64v\",\n    \"glGetTransformFeedbackiv\",\n    \"glGetVertexArrayiv\",\n]);\n\nconst OVERRIDE_OWNED: Set<string> = new Set([\n    \"glGetShaderInfoLog\",\n    \"glGetProgramInfoLog\",\n    \"glGetProgramPipelineInfoLog\",\n]);\n\nconst PLAN_POLICY: GlPlanPolicy = {\n    byteOffsetParams: BYTE_OFFSET_PARAMS,\n    singleValuedQueries: SINGLE_VALUED_QUERIES,\n};\n\nconst MAX_SAFE = BigInt(Number.MAX_SAFE_INTEGER);\nconst GROUP_BEARING_PARAM_KINDS: Set<ParamPlan[\"kind\"]> = new Set([\"scalar\", \"array-in\", \"ref-out\"]);\nconst GL_SELECTION: GlSelection = { api: \"gl\", version: 4.6, profile: \"core\" };\n\nconst enumExportName = (name: string): string =>\n    sanitizeIdentifier((name.startsWith(\"GL_\") ? name.slice(3) : name).toUpperCase());\n\nconst enumLiteral = (token: GlEnum): string | undefined => {\n    const text = token.value.trim();\n    let value: bigint;\n\n    try {\n        value = BigInt(text);\n    } catch {\n        return undefined;\n    }\n\n    if (value > MAX_SAFE) {\n        return undefined;\n    }\n\n    if (/^0[xX]/.test(text)) {\n        return `0x${text.slice(2).toLowerCase()}`;\n    }\n\n    return text;\n};\n\nconst groupAliasValue = (existing: string | undefined, scalarAlias: string): string => {\n    if (scalarAlias === \"GLbitfield\") {\n        return \"GLbitfield\";\n    }\n\n    return existing ?? \"GLenum\";\n};\n\nconst mergeGroupAlias = (aliases: Map<string, string>, scalar: GlScalar, group: string | undefined): void => {\n    if (group === undefined) {\n        return;\n    }\n\n    if (scalar.groupBearing !== true) {\n        return;\n    }\n\n    const existing = aliases.get(group);\n\n    if (existing === \"GLbitfield\") {\n        return;\n    }\n\n    aliases.set(group, groupAliasValue(existing, scalar.tsAlias));\n};\n\nconst isGroupBearingParam = (paramPlan: ParamPlan): paramPlan is GroupBearingParamPlan =>\n    GROUP_BEARING_PARAM_KINDS.has(paramPlan.kind);\n\nconst considerParamGroup = (aliases: Map<string, string>, plan: OkPlan, index: number): void => {\n    const { paramPlan, param } = paramPairAt(plan, index);\n\n    if (paramPlan === undefined || param === undefined) {\n        return;\n    }\n\n    if (isGroupBearingParam(paramPlan)) {\n        mergeGroupAlias(aliases, paramPlan.scalar, param.group);\n    }\n};\n\nconst collectPlanGroups = (aliases: Map<string, string>, plan: OkPlan): void => {\n    for (let index = 0; index < plan.params.length; index++) {\n        considerParamGroup(aliases, plan, index);\n    }\n\n    if (plan.returnPlan.kind === \"scalar\") {\n        mergeGroupAlias(aliases, plan.returnPlan.scalar, plan.command.returnGroup);\n    }\n};\n\nconst collectGroupAliases = (plans: OkPlan[]): Map<string, string> => {\n    const aliases: Map<string, string> = new Map();\n\n    for (const plan of plans) {\n        collectPlanGroups(aliases, plan);\n    }\n\n    return aliases;\n};\n\nconst planSelectedCommand = (registry: ReturnType<typeof loadGlRegistry>, name: string): OkPlan | GlExclusion => {\n    const command = registry.commands.get(name);\n\n    if (command === undefined) {\n        throw new Error(`Selected command ${name} is not defined in the registry`);\n    }\n\n    if (OVERRIDE_OWNED.has(name)) {\n        return { command: name, reason: \"override-owned\" };\n    }\n\n    const plan = planCommand(command, PLAN_POLICY);\n\n    if (!plan.ok) {\n        return { command: name, reason: plan.reason };\n    }\n\n    return plan;\n};\n\nconst planSelectedCommands = (\n    registry: ReturnType<typeof loadGlRegistry>,\n    commandNames: Map<string, string>,\n): PlannedSelection => {\n    const exclusions: GlExclusion[] = [];\n    const okPlans: OkPlan[] = [];\n    const planFeatures: Map<string, string> = new Map();\n    const sortedCommands = sortStringsBy(commandNames.entries(), ([key]) => key);\n\n    for (const [name, feature] of sortedCommands) {\n        const result = planSelectedCommand(registry, name);\n\n        if (\"ok\" in result) {\n            okPlans.push(result);\n            planFeatures.set(name, feature);\n        } else {\n            exclusions.push(result);\n        }\n    }\n\n    return { okPlans, planFeatures, exclusions };\n};\n\nconst buildEnumRows = (registry: ReturnType<typeof loadGlRegistry>, enumNames: Map<string, string>): EnumRow[] => {\n    const enumRows: EnumRow[] = [];\n    const sortedEnums = sortStringsBy(enumNames.entries(), ([key]) => key);\n\n    for (const [name, feature] of sortedEnums) {\n        const token = resolveEnum(registry, name);\n        const literal = enumLiteral(token);\n\n        if (literal === undefined) {\n            continue;\n        }\n\n        enumRows.push({ token, exportName: enumExportName(name), literal, feature });\n    }\n\n    return enumRows;\n};\n\nconst claimExportName = (exportNames: Map<string, string>, name: string, owner: string): void => {\n    const existing = exportNames.get(name);\n\n    if (existing !== undefined) {\n        throw new Error(`Generated export name collision: ${name} (${existing} vs ${owner})`);\n    }\n\n    exportNames.set(name, owner);\n};\n\nconst assertExportNamesDisjoint = (\n    rendered: RenderedCommand[],\n    singulars: RenderedCommand[],\n    enumRows: EnumRow[],\n    overrideExports: Set<string>,\n): void => {\n    const exportNames: Map<string, string> = new Map();\n\n    for (const command of rendered) {\n        claimExportName(exportNames, command.exportName, \"command\");\n    }\n\n    for (const singular of singulars) {\n        claimExportName(exportNames, singular.exportName, \"derived singular\");\n    }\n\n    for (const row of enumRows) {\n        claimExportName(exportNames, row.exportName, \"enum constant\");\n    }\n\n    const overrideCollisions = exportNames\n        .keys()\n        .filter((name) => overrideExports.has(name))\n        .toArray();\n\n    if (overrideCollisions.length > 0) {\n        throw new Error(\n            `Override module exports collide with generated exports: ${sortStrings(overrideCollisions).join(\", \")}`,\n        );\n    }\n};\n\nconst generateGlModules = (options: GlGenerationOptions): GlGenerationResult => {\n    const selection = GL_SELECTION;\n    const registry = loadGlRegistry(options.registryPath);\n    const subset = selectSubset(registry, selection);\n    const { okPlans, planFeatures, exclusions } = planSelectedCommands(registry, subset.commands);\n    const usedTypes: Set<string> = new Set();\n    const rendered: RenderedCommand[] = [];\n    const singulars: RenderedCommand[] = [];\n\n    for (const plan of okPlans) {\n        const feature = planFeatures.get(plan.command.name) ?? \"unknown feature\";\n        rendered.push(renderCommand(plan, feature, usedTypes));\n        const singular = deriveGenSingular(plan, feature, usedTypes) ?? deriveDeleteSingular(plan, feature, usedTypes);\n\n        if (singular !== undefined) {\n            singulars.push(singular);\n        }\n    }\n\n    const enumRows = buildEnumRows(registry, subset.enums);\n    assertExportNamesDisjoint(rendered, singulars, enumRows, options.overrideExports);\n\n    const files: Map<string, string> = new Map([\n        [\"types.ts\", renderTypesModule(collectGroupAliases(okPlans))],\n        [\"enums.ts\", renderEnumsModule(enumRows)],\n        [\"commands.ts\", renderCommandsModule(rendered, singulars, usedTypes)],\n    ]);\n\n    return {\n        files,\n        report: {\n            selection,\n            selectedCommands: subset.commands.size,\n            emittedCommands: rendered.length,\n            derivedSingulars: singulars.length,\n            exclusions,\n        },\n    };\n};\n\nexport { generateGlModules, type GlGenerationReport, type GlGenerationResult };\n"]}

package/dist/khronos/plan.d.ts

@@ -1,18 +1,16 @@
 import type { GlCommand } from "./model.js";
-export type GlScalar = {
+type GlScalar = {
     descriptor: string;
     tsAlias: string;
     viewType?: string;
     groupBearing?: boolean;
 };
-export declare const GL_SCALARS: Map<string, GlScalar>;
-export type ParsedCType = {
+type ParsedCType = {
     base: string;
     pointers: number;
     constData: boolean;
 };
-export declare const parseCType: (cType: string) => ParsedCType;
-export type ParamPlan = {
+type ParamPlan = {
     kind: "scalar";
     scalar: GlScalar;
 } | {
@@ -47,7 +45,7 @@ export type ParamPlan = {
 } | {
     kind: "byte-offset-array";
 };
-export type ReturnPlan = {
+type ReturnPlan = {
     kind: "void";
 } | {
     kind: "scalar";
@@ -61,12 +59,12 @@ export type ReturnPlan = {
 } | {
     kind: "opaque-pointer";
 };
-export type GlExclusionReason = "callback-parameter" | "compsize-output" | "computed-output-length" | "unsupported-shape" | "override-owned";
-export type GlPlanPolicy = {
+type GlExclusionReason = "callback-parameter" | "compsize-output" | "computed-output-length" | "unsupported-shape" | "override-owned";
+type GlPlanPolicy = {
     byteOffsetParams: Set<string>;
     singleValuedQueries: Set<string>;
 };
-export type CommandPlan = {
+type CommandPlan = {
     ok: true;
     command: GlCommand;
     params: ParamPlan[];
@@ -76,5 +74,8 @@ export type CommandPlan = {
     command: GlCommand;
     reason: GlExclusionReason;
 };
-export declare const planCommand: (command: GlCommand, policy: GlPlanPolicy) => CommandPlan;
+declare const GL_SCALARS: Map<string, GlScalar>;
+declare const parseCType: (cType: string) => ParsedCType;
+declare const planCommand: (command: GlCommand, policy: GlPlanPolicy) => CommandPlan;
+export { GL_SCALARS, parseCType, planCommand, type GlScalar, type ParsedCType, type ParamPlan, type ReturnPlan, type GlExclusionReason, type GlPlanPolicy, type CommandPlan, };
 //# sourceMappingURL=plan.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/khronos/plan.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAW,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,QAAQ,GAAG;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAmB3C,CAAC;AAOH,MAAM,MAAM,WAAW,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,UAAU,UAAW,MAAM,KAAG,WAS1C,CAAC;AAEF,MAAM,MAAM,SAAS,GACf;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC3B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAEpC,MAAM,MAAM,UAAU,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAEjC,MAAM,MAAM,iBAAiB,GACvB,oBAAoB,GACpB,iBAAiB,GACjB,wBAAwB,GACxB,mBAAmB,GACnB,gBAAgB,CAAC;AAEvB,MAAM,MAAM,YAAY,GAAG;IACvB,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,WAAW,GACjB;IACI,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;CAC1B,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAqFnE,eAAO,MAAM,WAAW,YAAa,SAAS,UAAU,YAAY,KAAG,WAUtE,CAAC"}
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/khronos/plan.ts"],"names":[],"mappings":"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"}

package/dist/khronos/plan.js

@@ -1,5 +1,5 @@
 import { tScalar } from "../analysis/descriptor.js";
-export const GL_SCALARS = new Map([
+const GL_SCALARS = new Map([
     ["GLenum", { descriptor: tScalar("uint32"), tsAlias: "GLenum", viewType: "Uint32Array", groupBearing: true }],
     [
         "GLbitfield",
@@ -23,47 +23,68 @@ const GL_BOOLEAN = "GLboolean";
 const GL_CHAR = "GLchar";
 const GL_SYNC = "GLsync";
 const CALLBACK_BASES = new Set(["GLDEBUGPROC", "GLDEBUGPROCARB", "GLDEBUGPROCKHR", "GLVULKANPROCNV"]);
-export const parseCType = (cType) => {
+const parseCType = (cType) => {
     const pointers = (cType.match(/\*/g) ?? []).length;
-    const constData = /(^|\s)const(\s|\*)/.test(` ${cType} `) && pointers > 0;
+    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 };
+    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")
+    if (len === undefined || len === "1") {
         return { plan: { kind: "ref-out", scalar } };
+    }
     if (isCompsize(len)) {
-        if (policy.singleValuedQueries.has(command.name))
-            return { plan: { kind: "ref-out", scalar } };
-        return { reason: "compsize-output" };
+        return planCompsizeOut(command, scalar, policy);
+    }
+    if (/^\d+$/.test(len)) {
+        return { plan: { kind: "ref-fixed-out", scalar, length: Number(len) } };
     }
-    if (/^\d+$/.test(len))
-        return { plan: { kind: "ref-fixed-out", scalar, length: Number.parseInt(len, 10) } };
     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)
+    if (parsed.pointers === 1) {
         return { plan: { kind: "byte-offset" } };
-    if (parsed.pointers === 2)
+    }
+    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)
+    if (parsed.pointers === 1 && parsed.constData) {
         return { plan: { kind: "string-in" } };
-    if (parsed.pointers === 2 && parsed.constData)
+    }
+    if (parsed.pointers === 2 && parsed.constData) {
         return { plan: { kind: "string-array-in" } };
-    if (parsed.pointers === 1 && param.len !== undefined && command.params.some((other) => other.name === param.len)) {
-        return { plan: { kind: "string-out", lenParamName: param.len } };
+    }
+    const lenParamName = charStringOutLen(command, param, parsed);
+    if (lenParamName !== undefined) {
+        return { plan: { kind: "string-out", lenParamName } };
     }
     return { reason: "unsupported-shape" };
 };
@@ -72,57 +93,99 @@ const planScalarParam = (command, param, parsed, policy) => {
     if (scalar === undefined) {
         throw new Error(`Unmapped C base type "${parsed.base}" on ${command.name}(${param.name}: ${param.cType})`);
     }
-    if (parsed.pointers === 0)
+    if (parsed.pointers === 0) {
         return { plan: { kind: "scalar", scalar } };
-    if (parsed.pointers === 1 && parsed.constData)
+    }
+    if (parsed.pointers === 1 && parsed.constData) {
         return { plan: { kind: "array-in", scalar } };
-    if (parsed.pointers === 1)
+    }
+    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, pointers } = parsed;
+    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);
     }
-    if (base === GL_SYNC && pointers === 0)
-        return { plan: { kind: "sync" } };
+    return planByBase(command, param, parsed, policy);
+};
+const planScalarReturn = (base) => {
     if (base === "void") {
-        if (pointers === 1)
-            return { plan: { kind: "buffer" } };
-        return { reason: "unsupported-shape" };
+        return { kind: "void" };
+    }
+    if (base === GL_SYNC) {
+        return { kind: "sync" };
     }
-    if (base === GL_CHAR || base === "GLcharARB")
-        return planCharParam(command, param, parsed);
     if (base === GL_BOOLEAN) {
-        if (pointers === 0)
-            return { plan: { kind: "boolean" } };
-        return { reason: "unsupported-shape" };
+        return { kind: "boolean" };
     }
-    return planScalarParam(command, param, parsed, policy);
+    const scalar = GL_SCALARS.get(base);
+    if (scalar !== undefined) {
+        return { kind: "scalar", scalar };
+    }
+    return undefined;
 };
-const planReturn = (command) => {
-    const { base, pointers } = parseCType(command.returnCType);
-    if (base === "void" && pointers === 0)
-        return { kind: "void" };
-    if (base === "void" && pointers === 1)
+const planPointerReturn = (base) => {
+    if (base === "void") {
         return { kind: "opaque-pointer" };
-    if (base === GL_SYNC && pointers === 0)
-        return { kind: "sync" };
-    if (base === GL_BOOLEAN && pointers === 0)
-        return { kind: "boolean" };
-    if ((base === "GLubyte" || base === GL_CHAR) && pointers === 1)
+    }
+    if (base === "GLubyte" || base === GL_CHAR) {
         return { kind: "string" };
-    const scalar = GL_SCALARS.get(base);
-    if (scalar !== undefined && pointers === 0)
-        return { kind: "scalar", scalar };
+    }
+    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}`);
 };
-export const planCommand = (command, policy) => {
+const planCommand = (command, policy) => {
     const params = [];
     for (const param of command.params) {
         const outcome = planParam(command, param, policy);
@@ -133,4 +196,5 @@ export const planCommand = (command, policy) => {
     }
     return { ok: true, command, params, returnPlan: planReturn(command) };
 };
+export { GL_SCALARS, parseCType, planCommand, };
 //# sourceMappingURL=plan.js.map