@gtkx/codegen 1.0.0-rc.3 → 1.0.0

package/dist/khronos/modules.js

@@ -1,42 +1,112 @@
 import { sortStrings, sortStringsBy } from "@gtkx/utils";
 import { ModuleBuilder } from "../writer/module.js";
+import { asSentence, backtick, backtickList, provenanceLines } from "./notes.js";
 import { GL_SCALARS } from "./plan.js";
-const LIB_CONSTANT = "export const LIB = \"libGL.so.1\";";
-const GENERATED_HEADER = `/**
- * GENERATED FILE: do not edit.
- */`;
+const LIB_CONSTANT = "/** The shared library the generated OpenGL bindings are loaded from. */\n" +
+    "export const LIB = \"libGL.so.1\";";
+const SYNC_SUMMARY = "An opaque `GLsync` fence handle";
 const TS_PRIMITIVES = new Set(["boolean", "string", "void", "number"]);
-const quotedGroupList = (groups) => groups.map((group) => `\`${group}\``).join(", ");
-const renderEnumsModule = (tokens) => {
-    const builder = new ModuleBuilder();
-    for (const { token, exportName, literal, feature } of tokens) {
-        const groupNote = token.groups.length > 0 ? ` Groups: ${quotedGroupList(token.groups)}.` : "";
-        builder.appendDeclaration(`/** \`${token.name}\`, provided by \`${feature}\`.${groupNote} */\n` +
-            `export const ${exportName} = ${literal};`);
+const attributionLine = (line) => (line.length === 0 ? " *" : ` * ${line}`);
+const attributionLines = (registryComment) => registryComment === undefined
+    ? []
+    : [" *", ...registryComment.split("\n").map((line) => attributionLine(line))];
+const generatedHeader = (docs) => [
+    "/**",
+    " * GENERATED FILE: do not edit.",
+    " *",
+    " * Derived from the Khronos OpenGL registry (gl.xml).",
+    ...attributionLines(docs.registryComment),
+    " */",
+].join("\n");
+const groupsLine = (groups) => (groups.length === 0 ? [] : [` * Groups: ${backtickList(groups)}.`]);
+const rangePhrase = (vendor) => vendor === undefined ? "Registry enumerant block" : `Allocated from the ${backtick(vendor)} enumerant range`;
+const rangeLine = ({ vendor, blockComment }) => {
+    if (vendor === undefined && blockComment === undefined) {
+        return [];
     }
-    return `${GENERATED_HEADER}\n\n${builder.toSource()}`;
+    const phrase = rangePhrase(vendor);
+    const text = blockComment === undefined ? phrase : `${phrase}: ${blockComment}`;
+    return [` * ${asSentence(text)}`];
 };
-const renderTypesModule = (groupAliases) => {
+const tokenNoteLines = (token) => [
+    ...groupsLine(token.groups),
+    ...(token.comment === undefined ? [] : [` * Token note: ${asSentence(token.comment)}`]),
+    ...(token.alias === undefined ? [] : [` * Also known as ${backtick(token.alias)}.`]),
+    ...(token.valueType === undefined ? [] : [` * Tagged ${backtick(token.valueType)} in the registry.`]),
+    ...rangeLine(token),
+];
+const enumJsDoc = ({ token, provenance }, docs) => [
+    "/**",
+    ` * ${backtick(token.name)}.`,
+    " *",
+    ...provenanceLines(provenance, docs.extensionEnums.get(token.name) ?? []),
+    ...tokenNoteLines(token),
+    " */",
+].join("\n");
+const renderEnumsModule = (tokens, docs) => {
     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). */\n" +
-        "export type GLpointer = ExternalObject<Handle>;");
+    for (const row of tokens) {
+        builder.appendDeclaration(`${enumJsDoc(row, docs)}\nexport const ${row.exportName} = ${row.literal};`);
+    }
+    return `${generatedHeader(docs)}\n\n${builder.toSource()}`;
+};
+const scalarSentences = (alias, type) => [
+    `The C ${backtick(alias)} scalar: ${backtick(type.declaration)}.`,
+    ...(type.requires === undefined ? [] : [`Requires the ${backtick(type.requires)} header.`]),
+    ...(type.comment === undefined ? [] : [`Registry note: ${asSentence(type.comment)}`]),
+];
+const scalarJsDoc = (alias, docs) => {
+    const type = docs.types.get(alias);
+    if (type === undefined) {
+        return `/** The C ${backtick(alias)} scalar. */`;
+    }
+    return `/** ${scalarSentences(alias, type).join(" ")} */`;
+};
+const syncJsDoc = (docs) => {
+    const type = docs.types.get("GLsync");
+    if (type === undefined) {
+        return `/** ${SYNC_SUMMARY}. */`;
+    }
+    return `/** ${SYNC_SUMMARY}: ${backtick(type.declaration)}. */`;
+};
+const groupSummary = (group, isBitmask) => isBitmask
+    ? `Registry enum group ${backtick(group)}, declared as a bitmask: members are combined with \`|\`.`
+    : `Registry enum group ${backtick(group)}.`;
+const memberLines = (members) => members.length === 0 ? [] : [" *", ` * Members: ${backtickList(members)}.`];
+const groupAliasJsDoc = (group, base, docs) => [
+    "/**",
+    ` * ${groupSummary(group, docs.bitmaskGroups.has(group))}`,
+    " *",
+    ` * Open and documentation-only; any ${backtick(base)} value is accepted.`,
+    ...memberLines(docs.groupMembers.get(group) ?? []),
+    " */",
+].join("\n");
+const appendScalarAliases = (builder, docs) => {
     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;`);
+        builder.appendDeclaration(`${scalarJsDoc(scalar.tsAlias, docs)}\nexport type ${scalar.tsAlias} = number;`);
     }
-    const sortedAliases = sortStringsBy(groupAliases.entries(), ([key]) => key);
-    for (const [group, base] of sortedAliases) {
-        builder.appendDeclaration(`/** Registry enum group \`${group}\`; open and documentation-only, ` +
-            `any \`${base}\` value is accepted. */\nexport type ${group} = ${base};`);
+};
+const appendGroupAliases = (builder, groupAliases, docs) => {
+    const sorted = sortStringsBy(groupAliases.entries(), ([key]) => key);
+    for (const [group, base] of sorted) {
+        builder.appendDeclaration(`${groupAliasJsDoc(group, base, docs)}\nexport type ${group} = ${base};`);
     }
-    return `${GENERATED_HEADER}\n\n${builder.toSource()}`;
+};
+const renderTypesModule = (groupAliases, docs) => {
+    const builder = new ModuleBuilder();
+    builder.imports.addNamed("@gtkx/native", "ExternalObject", true);
+    builder.imports.addNamed("@gtkx/native", "Handle", true);
+    builder.appendDeclaration(`${syncJsDoc(docs)}\nexport type GLsync = ExternalObject<Handle>;`);
+    builder.appendDeclaration("/** An opaque native pointer handle (e.g. a `glMapBufferRange` mapping). */\n" +
+        "export type GLpointer = ExternalObject<Handle>;");
+    appendScalarAliases(builder, docs);
+    appendGroupAliases(builder, groupAliases, docs);
+    return `${generatedHeader(docs)}\n\n${builder.toSource()}`;
 };
 const appendTypeImports = (builder, usedTypes) => {
     for (const alias of sortStrings(usedTypes)) {
@@ -58,7 +128,7 @@ const appendCommandDeclarations = (builder, commands) => {
         builder.appendDeclaration(command.declaration);
     }
 };
-const renderCommandsModule = (rendered, singulars, usedTypes) => {
+const renderCommandsModule = (rendered, singulars, usedTypes, docs) => {
     const builder = new ModuleBuilder();
     builder.imports.addNamed("@gtkx/runtime", "t");
     appendTypeImports(builder, usedTypes);
@@ -67,7 +137,7 @@ const renderCommandsModule = (rendered, singulars, usedTypes) => {
     appendCommandBindings(builder, singulars);
     appendCommandDeclarations(builder, rendered);
     appendCommandDeclarations(builder, singulars);
-    return `${GENERATED_HEADER}\n\n${builder.toSource()}`;
+    return `${generatedHeader(docs)}\n\n${builder.toSource()}`;
 };
 export { renderEnumsModule, renderTypesModule, renderCommandsModule };
 //# sourceMappingURL=modules.js.map

package/dist/khronos/modules.js.map

@@ -1 +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 type { GlEnum } from \"./model.js\";\nimport type { RenderedCommand } from \"./render.js\";\nimport { ModuleBuilder } from \"../writer/module.js\";\nimport { GL_SCALARS } from \"./plan.js\";\n\nconst LIB_CONSTANT = \"export const LIB = \\\"libGL.so.1\\\";\";\n\nconst GENERATED_HEADER = `/**\n * GENERATED FILE: do not edit.\n */`;\n\nconst TS_PRIMITIVES: Set<string> = new Set([\"boolean\", \"string\", \"void\", \"number\"]);\n\nconst quotedGroupList = (groups: string[]): string => groups.map((group) => `\\`${group}\\``).join(\", \");\n\nconst renderEnumsModule = (\n    tokens: { token: GlEnum; exportName: string; literal: string; feature: string }[],\n): string => {\n    const builder = new ModuleBuilder();\n\n    for (const { token, exportName, literal, feature } of tokens) {\n        const groupNote = token.groups.length > 0 ? ` Groups: ${quotedGroupList(token.groups)}.` : \"\";\n\n        builder.appendDeclaration(\n            `/** \\`${token.name}\\`, provided by \\`${feature}\\`.${groupNote} */\\n` +\n            `export const ${exportName} = ${literal};`,\n        );\n    }\n\n    return `${GENERATED_HEADER}\\n\\n${builder.toSource()}`;\n};\n\nconst 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\n    builder.appendDeclaration(\n        \"/** An opaque `GLsync` fence handle. */\\nexport type GLsync = ExternalObject<Handle>;\",\n    );\n\n    builder.appendDeclaration(\n        \"/** An opaque native pointer handle (e.g. a `glMapBufferRange` mapping). */\\n\" +\n        \"export type GLpointer = ExternalObject<Handle>;\",\n    );\n\n    const seen: Set<string> = new Set();\n\n    for (const scalar of GL_SCALARS.values()) {\n        if (seen.has(scalar.tsAlias)) {\n            continue;\n        }\n\n        seen.add(scalar.tsAlias);\n\n        builder.appendDeclaration(\n            `/** The C \\`${scalar.tsAlias}\\` scalar. */\\nexport type ${scalar.tsAlias} = number;`,\n        );\n    }\n\n    const sortedAliases = sortStringsBy(groupAliases.entries(), ([key]) => key);\n\n    for (const [group, base] of sortedAliases) {\n        builder.appendDeclaration(\n            `/** Registry enum group \\`${group}\\`; open and documentation-only, ` +\n            `any \\`${base}\\` value is accepted. */\\nexport type ${group} = ${base};`,\n        );\n    }\n\n    return `${GENERATED_HEADER}\\n\\n${builder.toSource()}`;\n};\n\nconst appendTypeImports = (builder: ModuleBuilder, usedTypes: Set<string>): void => {\n    for (const alias of sortStrings(usedTypes)) {\n        if (TS_PRIMITIVES.has(alias)) {\n            continue;\n        }\n\n        builder.imports.addNamed(\"./types.js\", alias, true);\n    }\n};\n\nconst appendCommandBindings = (builder: ModuleBuilder, commands: RenderedCommand[]): void => {\n    for (const command of commands) {\n        if (command.binding !== undefined) {\n            builder.appendBinding(command.binding, command.binding);\n        }\n    }\n};\n\nconst appendCommandDeclarations = (builder: ModuleBuilder, commands: RenderedCommand[]): void => {\n    for (const command of commands) {\n        builder.appendDeclaration(command.declaration);\n    }\n};\n\nconst 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    appendTypeImports(builder, usedTypes);\n    builder.appendBinding(LIB_CONSTANT);\n    appendCommandBindings(builder, rendered);\n    appendCommandBindings(builder, singulars);\n    appendCommandDeclarations(builder, rendered);\n    appendCommandDeclarations(builder, singulars);\n\n    return `${GENERATED_HEADER}\\n\\n${builder.toSource()}`;\n};\n\nexport { renderEnumsModule, renderTypesModule, renderCommandsModule };\n"]}
+{"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 type { GlDocContext } from \"./doc-context.js\";\nimport type { GlEnum, GlType } from \"./model.js\";\nimport type { RenderedCommand } from \"./render.js\";\nimport type { GlSymbolProvenance } from \"./select.js\";\nimport { ModuleBuilder } from \"../writer/module.js\";\nimport { asSentence, backtick, backtickList, provenanceLines } from \"./notes.js\";\nimport { GL_SCALARS } from \"./plan.js\";\n\ntype EnumRow = {\n    token: GlEnum;\n    exportName: string;\n    literal: string;\n    provenance: GlSymbolProvenance;\n};\n\nconst LIB_CONSTANT =\n    \"/** The shared library the generated OpenGL bindings are loaded from. */\\n\" +\n    \"export const LIB = \\\"libGL.so.1\\\";\";\n\nconst SYNC_SUMMARY = \"An opaque `GLsync` fence handle\";\nconst TS_PRIMITIVES: Set<string> = new Set([\"boolean\", \"string\", \"void\", \"number\"]);\n\nconst attributionLine = (line: string): string => (line.length === 0 ? \" *\" : ` * ${line}`);\n\nconst attributionLines = (registryComment: string | undefined): string[] =>\n    registryComment === undefined\n        ? []\n        : [\" *\", ...registryComment.split(\"\\n\").map((line) => attributionLine(line))];\n\nconst generatedHeader = (docs: GlDocContext): string =>\n    [\n        \"/**\",\n        \" * GENERATED FILE: do not edit.\",\n        \" *\",\n        \" * Derived from the Khronos OpenGL registry (gl.xml).\",\n        ...attributionLines(docs.registryComment),\n        \" */\",\n    ].join(\"\\n\");\n\nconst groupsLine = (groups: string[]): string[] => (groups.length === 0 ? [] : [` * Groups: ${backtickList(groups)}.`]);\n\nconst rangePhrase = (vendor: string | undefined): string =>\n    vendor === undefined ? \"Registry enumerant block\" : `Allocated from the ${backtick(vendor)} enumerant range`;\n\nconst rangeLine = ({ vendor, blockComment }: GlEnum): string[] => {\n    if (vendor === undefined && blockComment === undefined) {\n        return [];\n    }\n\n    const phrase = rangePhrase(vendor);\n    const text = blockComment === undefined ? phrase : `${phrase}: ${blockComment}`;\n\n    return [` * ${asSentence(text)}`];\n};\n\nconst tokenNoteLines = (token: GlEnum): string[] => [\n    ...groupsLine(token.groups),\n    ...(token.comment === undefined ? [] : [` * Token note: ${asSentence(token.comment)}`]),\n    ...(token.alias === undefined ? [] : [` * Also known as ${backtick(token.alias)}.`]),\n    ...(token.valueType === undefined ? [] : [` * Tagged ${backtick(token.valueType)} in the registry.`]),\n    ...rangeLine(token),\n];\n\nconst enumJsDoc = ({ token, provenance }: EnumRow, docs: GlDocContext): string =>\n    [\n        \"/**\",\n        ` * ${backtick(token.name)}.`,\n        \" *\",\n        ...provenanceLines(provenance, docs.extensionEnums.get(token.name) ?? []),\n        ...tokenNoteLines(token),\n        \" */\",\n    ].join(\"\\n\");\n\nconst renderEnumsModule = (tokens: EnumRow[], docs: GlDocContext): string => {\n    const builder = new ModuleBuilder();\n\n    for (const row of tokens) {\n        builder.appendDeclaration(`${enumJsDoc(row, docs)}\\nexport const ${row.exportName} = ${row.literal};`);\n    }\n\n    return `${generatedHeader(docs)}\\n\\n${builder.toSource()}`;\n};\n\nconst scalarSentences = (alias: string, type: GlType): string[] => [\n    `The C ${backtick(alias)} scalar: ${backtick(type.declaration)}.`,\n    ...(type.requires === undefined ? [] : [`Requires the ${backtick(type.requires)} header.`]),\n    ...(type.comment === undefined ? [] : [`Registry note: ${asSentence(type.comment)}`]),\n];\n\nconst scalarJsDoc = (alias: string, docs: GlDocContext): string => {\n    const type = docs.types.get(alias);\n\n    if (type === undefined) {\n        return `/** The C ${backtick(alias)} scalar. */`;\n    }\n\n    return `/** ${scalarSentences(alias, type).join(\" \")} */`;\n};\n\nconst syncJsDoc = (docs: GlDocContext): string => {\n    const type = docs.types.get(\"GLsync\");\n\n    if (type === undefined) {\n        return `/** ${SYNC_SUMMARY}. */`;\n    }\n\n    return `/** ${SYNC_SUMMARY}: ${backtick(type.declaration)}. */`;\n};\n\nconst groupSummary = (group: string, isBitmask: boolean): string =>\n    isBitmask\n        ? `Registry enum group ${backtick(group)}, declared as a bitmask: members are combined with \\`|\\`.`\n        : `Registry enum group ${backtick(group)}.`;\n\nconst memberLines = (members: string[]): string[] =>\n    members.length === 0 ? [] : [\" *\", ` * Members: ${backtickList(members)}.`];\n\nconst groupAliasJsDoc = (group: string, base: string, docs: GlDocContext): string =>\n    [\n        \"/**\",\n        ` * ${groupSummary(group, docs.bitmaskGroups.has(group))}`,\n        \" *\",\n        ` * Open and documentation-only; any ${backtick(base)} value is accepted.`,\n        ...memberLines(docs.groupMembers.get(group) ?? []),\n        \" */\",\n    ].join(\"\\n\");\n\nconst appendScalarAliases = (builder: ModuleBuilder, docs: GlDocContext): void => {\n    const seen: Set<string> = new Set();\n\n    for (const scalar of GL_SCALARS.values()) {\n        if (seen.has(scalar.tsAlias)) {\n            continue;\n        }\n\n        seen.add(scalar.tsAlias);\n        builder.appendDeclaration(`${scalarJsDoc(scalar.tsAlias, docs)}\\nexport type ${scalar.tsAlias} = number;`);\n    }\n};\n\nconst appendGroupAliases = (builder: ModuleBuilder, groupAliases: Map<string, string>, docs: GlDocContext): void => {\n    const sorted = sortStringsBy(groupAliases.entries(), ([key]) => key);\n\n    for (const [group, base] of sorted) {\n        builder.appendDeclaration(`${groupAliasJsDoc(group, base, docs)}\\nexport type ${group} = ${base};`);\n    }\n};\n\nconst renderTypesModule = (groupAliases: Map<string, string>, docs: GlDocContext): 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(`${syncJsDoc(docs)}\\nexport type GLsync = ExternalObject<Handle>;`);\n\n    builder.appendDeclaration(\n        \"/** An opaque native pointer handle (e.g. a `glMapBufferRange` mapping). */\\n\" +\n        \"export type GLpointer = ExternalObject<Handle>;\",\n    );\n\n    appendScalarAliases(builder, docs);\n    appendGroupAliases(builder, groupAliases, docs);\n\n    return `${generatedHeader(docs)}\\n\\n${builder.toSource()}`;\n};\n\nconst appendTypeImports = (builder: ModuleBuilder, usedTypes: Set<string>): void => {\n    for (const alias of sortStrings(usedTypes)) {\n        if (TS_PRIMITIVES.has(alias)) {\n            continue;\n        }\n\n        builder.imports.addNamed(\"./types.js\", alias, true);\n    }\n};\n\nconst appendCommandBindings = (builder: ModuleBuilder, commands: RenderedCommand[]): void => {\n    for (const command of commands) {\n        if (command.binding !== undefined) {\n            builder.appendBinding(command.binding, command.binding);\n        }\n    }\n};\n\nconst appendCommandDeclarations = (builder: ModuleBuilder, commands: RenderedCommand[]): void => {\n    for (const command of commands) {\n        builder.appendDeclaration(command.declaration);\n    }\n};\n\nconst renderCommandsModule = (\n    rendered: RenderedCommand[],\n    singulars: RenderedCommand[],\n    usedTypes: Set<string>,\n    docs: GlDocContext,\n): string => {\n    const builder = new ModuleBuilder();\n    builder.imports.addNamed(\"@gtkx/runtime\", \"t\");\n    appendTypeImports(builder, usedTypes);\n    builder.appendBinding(LIB_CONSTANT);\n    appendCommandBindings(builder, rendered);\n    appendCommandBindings(builder, singulars);\n    appendCommandDeclarations(builder, rendered);\n    appendCommandDeclarations(builder, singulars);\n\n    return `${generatedHeader(docs)}\\n\\n${builder.toSource()}`;\n};\n\nexport { renderEnumsModule, renderTypesModule, renderCommandsModule, type EnumRow };\n"]}

package/dist/khronos/notes.d.ts

@@ -0,0 +1,19 @@
+import type { GlExtensionAttribution } from "./extensions.js";
+import type { GlSymbolProvenance } from "./select.js";
+type MetadataNotesOptions = {
+    type: string;
+    group?: string;
+    len?: string;
+    objectClass?: string;
+    kinds: string[];
+    note?: string;
+};
+declare const commandExportName: (name: string) => string;
+declare const backtick: (text: string) => string;
+declare const backtickList: (values: string[]) => string;
+declare const asSentence: (text: string) => string;
+declare const provenanceLines: (provenance: GlSymbolProvenance, extensions: GlExtensionAttribution[]) => string[];
+declare const metadataNotes: ({ type, group, len, objectClass, kinds, note }: MetadataNotesOptions) => string;
+declare const kindDescriptions: (kinds: string[], table: Map<string, string>) => string;
+export { asSentence, backtick, backtickList, commandExportName, kindDescriptions, metadataNotes, type MetadataNotesOptions, provenanceLines, };
+//# sourceMappingURL=notes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notes.d.ts","sourceRoot":"","sources":["../../src/khronos/notes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,KAAK,EAAa,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjE,KAAK,oBAAoB,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,QAAA,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,MACqC,CAAC;AAEhF,QAAA,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAG,MAAuB,CAAC;AACzD,QAAA,MAAM,YAAY,GAAI,QAAQ,MAAM,EAAE,KAAG,MAA2D,CAAC;AACrG,QAAA,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,MAAkD,CAAC;AA0BtF,QAAA,MAAM,eAAe,GAAI,YAAY,kBAAkB,EAAE,YAAY,sBAAsB,EAAE,KAAG,MAAM,EAKrG,CAAC;AAEF,QAAA,MAAM,aAAa,GAAI,gDAAgD,oBAAoB,KAAG,MAQ9E,CAAC;AAEjB,QAAA,MAAM,gBAAgB,GAAI,OAAO,MAAM,EAAE,EAAE,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAAG,MACZ,CAAC;AAE7D,OAAO,EACH,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,KAAK,oBAAoB,EACzB,eAAe,GAClB,CAAC"}

package/dist/khronos/notes.js

@@ -0,0 +1,35 @@
+import { lowerFirst, toCamelIdentifier } from "@gtkx/utils";
+const commandExportName = (name) => toCamelIdentifier(name.startsWith("gl") ? lowerFirst(name.slice(2)) : name);
+const backtick = (text) => `\`${text}\``;
+const backtickList = (values) => values.map((value) => backtick(value)).join(", ");
+const asSentence = (text) => (text.endsWith(".") ? text : `${text}.`);
+const removalPhrase = (removal) => removal.comment === undefined
+    ? backtick(removal.feature)
+    : `${backtick(removal.feature)} (${removal.comment})`;
+const removalLine = (provenance) => {
+    const phrases = provenance.removals.map((removal) => removalPhrase(removal)).join(", ");
+    return ` * Removed from the core profile by ${phrases}, then restored by ${backtick(provenance.feature)}.`;
+};
+const extensionLine = (extensions) => {
+    const names = backtickList(extensions.map((extension) => extension.name));
+    return ` * Also provided by the ${names} extension${extensions.length === 1 ? "" : "s"}.`;
+};
+const extensionNoteLines = (extensions) => extensions.flatMap((extension) => extension.notes.map((note) => ` * ${backtick(extension.name)} note: ${asSentence(note)}`));
+const extensionLines = (extensions) => extensions.length === 0 ? [] : [extensionLine(extensions), ...extensionNoteLines(extensions)];
+const provenanceLines = (provenance, extensions) => [
+    ` * Provided by ${backtick(provenance.feature)}.`,
+    ...(provenance.removals.length > 0 ? [removalLine(provenance)] : []),
+    ...(provenance.requireComment === undefined ? [] : [` * Registry note: ${provenance.requireComment}`]),
+    ...extensionLines(extensions),
+];
+const metadataNotes = ({ type, group, len, objectClass, kinds, note }) => [
+    backtick(type),
+    ...(group === undefined ? [] : [`group ${backtick(group)}`]),
+    ...(len === undefined ? [] : [`length ${backtick(len)}`]),
+    ...(objectClass === undefined ? [] : [`object class ${backtick(objectClass)}`]),
+    ...kinds.map((kind) => `kind ${backtick(kind)}`),
+    ...(note === undefined ? [] : [note]),
+].join(", ");
+const kindDescriptions = (kinds, table) => kinds.flatMap((kind) => table.get(kind) ?? []).join(" ");
+export { asSentence, backtick, backtickList, commandExportName, kindDescriptions, metadataNotes, provenanceLines, };
+//# sourceMappingURL=notes.js.map

package/dist/khronos/notes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notes.js","sourceRoot":"","sources":["../../src/khronos/notes.ts"],"names":[],"mappings":"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","sourcesContent":["import { lowerFirst, toCamelIdentifier } from \"@gtkx/utils\";\nimport type { GlExtensionAttribution } from \"./extensions.js\";\nimport type { GlRemoval, GlSymbolProvenance } from \"./select.js\";\n\ntype MetadataNotesOptions = {\n    type: string;\n    group?: string;\n    len?: string;\n    objectClass?: string;\n    kinds: string[];\n    note?: string;\n};\n\nconst commandExportName = (name: string): string =>\n    toCamelIdentifier(name.startsWith(\"gl\") ? lowerFirst(name.slice(2)) : name);\n\nconst backtick = (text: string): string => `\\`${text}\\``;\nconst backtickList = (values: string[]): string => values.map((value) => backtick(value)).join(\", \");\nconst asSentence = (text: string): string => (text.endsWith(\".\") ? text : `${text}.`);\n\nconst removalPhrase = (removal: GlRemoval): string =>\n    removal.comment === undefined\n        ? backtick(removal.feature)\n        : `${backtick(removal.feature)} (${removal.comment})`;\n\nconst removalLine = (provenance: GlSymbolProvenance): string => {\n    const phrases = provenance.removals.map((removal) => removalPhrase(removal)).join(\", \");\n\n    return ` * Removed from the core profile by ${phrases}, then restored by ${backtick(provenance.feature)}.`;\n};\n\nconst extensionLine = (extensions: GlExtensionAttribution[]): string => {\n    const names = backtickList(extensions.map((extension) => extension.name));\n\n    return ` * Also provided by the ${names} extension${extensions.length === 1 ? \"\" : \"s\"}.`;\n};\n\nconst extensionNoteLines = (extensions: GlExtensionAttribution[]): string[] =>\n    extensions.flatMap((extension) =>\n        extension.notes.map((note) => ` * ${backtick(extension.name)} note: ${asSentence(note)}`));\n\nconst extensionLines = (extensions: GlExtensionAttribution[]): string[] =>\n    extensions.length === 0 ? [] : [extensionLine(extensions), ...extensionNoteLines(extensions)];\n\nconst provenanceLines = (provenance: GlSymbolProvenance, extensions: GlExtensionAttribution[]): string[] => [\n    ` * Provided by ${backtick(provenance.feature)}.`,\n    ...(provenance.removals.length > 0 ? [removalLine(provenance)] : []),\n    ...(provenance.requireComment === undefined ? [] : [` * Registry note: ${provenance.requireComment}`]),\n    ...extensionLines(extensions),\n];\n\nconst metadataNotes = ({ type, group, len, objectClass, kinds, note }: MetadataNotesOptions): string =>\n    [\n        backtick(type),\n        ...(group === undefined ? [] : [`group ${backtick(group)}`]),\n        ...(len === undefined ? [] : [`length ${backtick(len)}`]),\n        ...(objectClass === undefined ? [] : [`object class ${backtick(objectClass)}`]),\n        ...kinds.map((kind) => `kind ${backtick(kind)}`),\n        ...(note === undefined ? [] : [note]),\n    ].join(\", \");\n\nconst kindDescriptions = (kinds: string[], table: Map<string, string>): string =>\n    kinds.flatMap((kind) => table.get(kind) ?? []).join(\" \");\n\nexport {\n    asSentence,\n    backtick,\n    backtickList,\n    commandExportName,\n    kindDescriptions,\n    metadataNotes,\n    type MetadataNotesOptions,\n    provenanceLines,\n};\n"]}

package/dist/khronos/param-pair.d.ts

@@ -5,7 +5,7 @@ type ParamPair = {
     param: GlParam | undefined;
 };
 declare const paramPairAt: (plan: CommandPlan & {
-    ok: true;
+    isOk: true;
 }, index: number) => ParamPair;
 export { paramPairAt };
 //# sourceMappingURL=param-pair.d.ts.map

package/dist/khronos/param-pair.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"param-pair.d.ts","sourceRoot":"","sources":["../../src/khronos/param-pair.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAExD,KAAK,SAAS,GAAG;IACb,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;IACjC,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9B,CAAC;AAEF,QAAA,MAAM,WAAW,GAAI,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,EAAE,OAAO,MAAM,KAAG,SAGrE,CAAC;AAEH,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"param-pair.d.ts","sourceRoot":"","sources":["../../src/khronos/param-pair.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAExD,KAAK,SAAS,GAAG;IACb,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;IACjC,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9B,CAAC;AAEF,QAAA,MAAM,WAAW,GAAI,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,EAAE,OAAO,MAAM,KAAG,SAGvE,CAAC;AAEH,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/khronos/param-pair.js.map

@@ -1 +1 @@
-{"version":3,"file":"param-pair.js","sourceRoot":"","sources":["../../src/khronos/param-pair.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,GAAG,CAAC,IAAgC,EAAE,KAAa,EAAa,EAAE,CAAC,CAAC;IACjF,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC7B,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;CACpC,CAAC,CAAC;AAEH,OAAO,EAAE,WAAW,EAAE,CAAC","sourcesContent":["import type { GlParam } from \"./model.js\";\nimport type { CommandPlan, ParamPlan } from \"./plan.js\";\n\ntype ParamPair = {\n    paramPlan: ParamPlan | undefined;\n    param: GlParam | undefined;\n};\n\nconst paramPairAt = (plan: CommandPlan & { ok: true }, index: number): ParamPair => ({\n    paramPlan: plan.params[index],\n    param: plan.command.params[index],\n});\n\nexport { paramPairAt };\n"]}
+{"version":3,"file":"param-pair.js","sourceRoot":"","sources":["../../src/khronos/param-pair.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,GAAG,CAAC,IAAkC,EAAE,KAAa,EAAa,EAAE,CAAC,CAAC;IACnF,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC7B,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;CACpC,CAAC,CAAC;AAEH,OAAO,EAAE,WAAW,EAAE,CAAC","sourcesContent":["import type { GlParam } from \"./model.js\";\nimport type { CommandPlan, ParamPlan } from \"./plan.js\";\n\ntype ParamPair = {\n    paramPlan: ParamPlan | undefined;\n    param: GlParam | undefined;\n};\n\nconst paramPairAt = (plan: CommandPlan & { isOk: true }, index: number): ParamPair => ({\n    paramPlan: plan.params[index],\n    param: plan.command.params[index],\n});\n\nexport { paramPairAt };\n"]}

package/dist/khronos/pipeline.d.ts

@@ -1,5 +1,5 @@
 import { type GlExclusionReason } from "./plan.js";
-import { type GlSelection } from "./select.js";
+import { type GlSelection, type GlSubset } from "./select.js";
 type GlExclusion = {
     command: string;
     reason: GlExclusionReason;
@@ -10,6 +10,8 @@ type GlGenerationReport = {
     emittedCommands: number;
     derivedSingulars: number;
     exclusions: GlExclusion[];
+    enumExclusions: string[];
+    coreRemovals: GlSubset["removed"];
 };
 type GlGenerationResult = {
     files: Map<string, string>;

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/khronos/pipeline.ts"],"names":[],"mappings":"AAMA,OAAO,EAEH,KAAK,iBAAiB,EAKzB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAsD,MAAM,aAAa,CAAC;AAElH,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;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;CACrC,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;AAoTF,QAAA,MAAM,iBAAiB,GAAI,SAAS,mBAAmB,KAAG,kBAqCzD,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,CAAC"}

package/dist/khronos/pipeline.js

@@ -1,4 +1,6 @@
 import { sanitizeIdentifier, sortStrings, sortStringsBy } from "@gtkx/utils";
+import { buildDocContext } from "./doc-context.js";
+import { buildExtensionIndex } from "./extensions.js";
 import { loadGlRegistry } from "./model.js";
 import { renderCommandsModule, renderEnumsModule, renderTypesModule } from "./modules.js";
 import { paramPairAt } from "./param-pair.js";
@@ -51,7 +53,12 @@ const PLAN_POLICY = {
     singleValuedQueries: SINGLE_VALUED_QUERIES,
 };
 const MAX_SAFE = BigInt(Number.MAX_SAFE_INTEGER);
-const GROUP_BEARING_PARAM_KINDS = new Set(["scalar", "array-in", "ref-out"]);
+const GROUP_BEARING_PARAM_KINDS = new Set([
+    "scalar",
+    "array-in",
+    "ref-out",
+    "ref-array-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) => {
@@ -81,7 +88,7 @@ const mergeGroupAlias = (aliases, scalar, group) => {
     if (group === undefined) {
         return;
     }
-    if (scalar.groupBearing !== true) {
+    if (scalar.isGroupBearing !== true) {
         return;
     }
     const existing = aliases.get(group);
@@ -124,7 +131,7 @@ const planSelectedCommand = (registry, name) => {
         return { command: name, reason: "override-owned" };
     }
     const plan = planCommand(command, PLAN_POLICY);
-    if (!plan.ok) {
+    if (!plan.isOk) {
         return { command: name, reason: plan.reason };
     }
     return plan;
@@ -134,11 +141,11 @@ const planSelectedCommands = (registry, commandNames) => {
     const okPlans = [];
     const planFeatures = new Map();
     const sortedCommands = sortStringsBy(commandNames.entries(), ([key]) => key);
-    for (const [name, feature] of sortedCommands) {
+    for (const [name, provenance] of sortedCommands) {
         const result = planSelectedCommand(registry, name);
-        if ("ok" in result) {
+        if ("isOk" in result) {
             okPlans.push(result);
-            planFeatures.set(name, feature);
+            planFeatures.set(name, provenance);
         }
         else {
             exclusions.push(result);
@@ -146,18 +153,42 @@ const planSelectedCommands = (registry, commandNames) => {
     }
     return { okPlans, planFeatures, exclusions };
 };
-const buildEnumRows = (registry, enumNames) => {
-    const enumRows = [];
+const buildEnumRows = (registry, enumNames, selection) => {
+    const rows = [];
+    const enumExclusions = [];
     const sortedEnums = sortStringsBy(enumNames.entries(), ([key]) => key);
-    for (const [name, feature] of sortedEnums) {
-        const token = resolveEnum(registry, name);
+    for (const [name, provenance] of sortedEnums) {
+        const token = resolveEnum(registry, name, selection.api);
         const literal = enumLiteral(token);
         if (literal === undefined) {
-            continue;
+            enumExclusions.push(name);
+        }
+        else {
+            rows.push({ token, exportName: enumExportName(name), literal, provenance });
         }
-        enumRows.push({ token, exportName: enumExportName(name), literal, feature });
     }
-    return enumRows;
+    return { rows, enumExclusions };
+};
+const provenanceFor = (planFeatures, name) => {
+    const found = planFeatures.get(name);
+    if (found === undefined) {
+        throw new Error(`Command ${name} was planned without a selection provenance`);
+    }
+    return found;
+};
+const renderCommands = (plans, planFeatures, usedTypes, docs) => {
+    const rendered = [];
+    const singulars = [];
+    for (const plan of plans) {
+        const provenance = provenanceFor(planFeatures, plan.command.name);
+        rendered.push(renderCommand(plan, provenance, usedTypes, docs));
+        const singular = deriveGenSingular(plan, provenance, usedTypes, docs) ??
+            deriveDeleteSingular(plan, provenance, usedTypes, docs);
+        if (singular !== undefined) {
+            singulars.push(singular);
+        }
+    }
+    return { rendered, singulars };
 };
 const claimExportName = (exportNames, name, owner) => {
     const existing = exportNames.get(name);
@@ -190,23 +221,21 @@ const generateGlModules = (options) => {
     const registry = loadGlRegistry(options.registryPath);
     const subset = selectSubset(registry, selection);
     const { okPlans, planFeatures, exclusions } = planSelectedCommands(registry, subset.commands);
+    const { rows, enumExclusions } = buildEnumRows(registry, subset.enums, selection);
+    const groupAliases = collectGroupAliases(okPlans);
+    const docs = buildDocContext({
+        registry,
+        extensions: buildExtensionIndex(registry, selection),
+        plans: okPlans,
+        enumRows: rows,
+    });
     const usedTypes = new Set();
-    const rendered = [];
-    const singulars = [];
-    for (const plan of okPlans) {
-        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) {
-            singulars.push(singular);
-        }
-    }
-    const enumRows = buildEnumRows(registry, subset.enums);
-    assertExportNamesDisjoint(rendered, singulars, enumRows, options.overrideExports);
+    const { rendered, singulars } = renderCommands(okPlans, planFeatures, usedTypes, docs);
+    assertExportNamesDisjoint(rendered, singulars, rows, options.overrideExports);
     const files = new Map([
-        ["types.ts", renderTypesModule(collectGroupAliases(okPlans))],
-        ["enums.ts", renderEnumsModule(enumRows)],
-        ["commands.ts", renderCommandsModule(rendered, singulars, usedTypes)],
+        ["types.ts", renderTypesModule(groupAliases, docs)],
+        ["enums.ts", renderEnumsModule(rows, docs)],
+        ["commands.ts", renderCommandsModule(rendered, singulars, usedTypes, docs)],
     ]);
     return {
         files,
@@ -216,6 +245,8 @@ const generateGlModules = (options) => {
             emittedCommands: rendered.length,
             derivedSingulars: singulars.length,
             exclusions,
+            enumExclusions,
+            coreRemovals: subset.removed,
         },
     };
 };

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 { 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"]}
+{"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 { buildDocContext, type GlDocContext } from \"./doc-context.js\";\nimport { buildExtensionIndex } from \"./extensions.js\";\nimport { type GlEnum, loadGlRegistry } from \"./model.js\";\nimport { type EnumRow, 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, type GlSubset, type GlSymbolProvenance, 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    enumExclusions: string[];\n    coreRemovals: GlSubset[\"removed\"];\n};\n\ntype GlGenerationResult = {\n    files: Map<string, string>;\n    report: GlGenerationReport;\n};\n\ntype GroupBearingParamPlan = Extract<ParamPlan, { kind: \"scalar\" | \"array-in\" | \"ref-out\" | \"ref-array-out\" }>;\n\ntype GlGenerationOptions = {\n    registryPath: string;\n    overrideExports: Set<string>;\n};\n\ntype OkPlan = CommandPlan & { isOk: true };\n\ntype PlannedSelection = {\n    okPlans: OkPlan[];\n    planFeatures: Map<string, GlSymbolProvenance>;\n    exclusions: GlExclusion[];\n};\n\ntype EnumSelection = {\n    rows: EnumRow[];\n    enumExclusions: string[];\n};\n\ntype RenderedCommands = {\n    rendered: RenderedCommand[];\n    singulars: RenderedCommand[];\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);\n\nconst GROUP_BEARING_PARAM_KINDS: Set<ParamPlan[\"kind\"]> = new Set([\n    \"scalar\",\n    \"array-in\",\n    \"ref-out\",\n    \"ref-array-out\",\n]);\n\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.isGroupBearing !== 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.isOk) {\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, GlSymbolProvenance>,\n): PlannedSelection => {\n    const exclusions: GlExclusion[] = [];\n    const okPlans: OkPlan[] = [];\n    const planFeatures: Map<string, GlSymbolProvenance> = new Map();\n    const sortedCommands = sortStringsBy(commandNames.entries(), ([key]) => key);\n\n    for (const [name, provenance] of sortedCommands) {\n        const result = planSelectedCommand(registry, name);\n\n        if (\"isOk\" in result) {\n            okPlans.push(result);\n            planFeatures.set(name, provenance);\n        } else {\n            exclusions.push(result);\n        }\n    }\n\n    return { okPlans, planFeatures, exclusions };\n};\n\nconst buildEnumRows = (\n    registry: ReturnType<typeof loadGlRegistry>,\n    enumNames: Map<string, GlSymbolProvenance>,\n    selection: GlSelection,\n): EnumSelection => {\n    const rows: EnumRow[] = [];\n    const enumExclusions: string[] = [];\n    const sortedEnums = sortStringsBy(enumNames.entries(), ([key]) => key);\n\n    for (const [name, provenance] of sortedEnums) {\n        const token = resolveEnum(registry, name, selection.api);\n        const literal = enumLiteral(token);\n\n        if (literal === undefined) {\n            enumExclusions.push(name);\n        } else {\n            rows.push({ token, exportName: enumExportName(name), literal, provenance });\n        }\n    }\n\n    return { rows, enumExclusions };\n};\n\nconst provenanceFor = (planFeatures: Map<string, GlSymbolProvenance>, name: string): GlSymbolProvenance => {\n    const found = planFeatures.get(name);\n\n    if (found === undefined) {\n        throw new Error(`Command ${name} was planned without a selection provenance`);\n    }\n\n    return found;\n};\n\nconst renderCommands = (\n    plans: OkPlan[],\n    planFeatures: Map<string, GlSymbolProvenance>,\n    usedTypes: Set<string>,\n    docs: GlDocContext,\n): RenderedCommands => {\n    const rendered: RenderedCommand[] = [];\n    const singulars: RenderedCommand[] = [];\n\n    for (const plan of plans) {\n        const provenance = provenanceFor(planFeatures, plan.command.name);\n        rendered.push(renderCommand(plan, provenance, usedTypes, docs));\n\n        const singular =\n            deriveGenSingular(plan, provenance, usedTypes, docs) ??\n            deriveDeleteSingular(plan, provenance, usedTypes, docs);\n\n        if (singular !== undefined) {\n            singulars.push(singular);\n        }\n    }\n\n    return { rendered, singulars };\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 { rows, enumExclusions } = buildEnumRows(registry, subset.enums, selection);\n    const groupAliases = collectGroupAliases(okPlans);\n\n    const docs = buildDocContext({\n        registry,\n        extensions: buildExtensionIndex(registry, selection),\n        plans: okPlans,\n        enumRows: rows,\n    });\n\n    const usedTypes: Set<string> = new Set();\n    const { rendered, singulars } = renderCommands(okPlans, planFeatures, usedTypes, docs);\n    assertExportNamesDisjoint(rendered, singulars, rows, options.overrideExports);\n\n    const files: Map<string, string> = new Map([\n        [\"types.ts\", renderTypesModule(groupAliases, docs)],\n        [\"enums.ts\", renderEnumsModule(rows, docs)],\n        [\"commands.ts\", renderCommandsModule(rendered, singulars, usedTypes, docs)],\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            enumExclusions,\n            coreRemovals: subset.removed,\n        },\n    };\n};\n\nexport { generateGlModules, type GlGenerationReport, type GlGenerationResult };\n"]}

package/dist/khronos/plan.d.ts

@@ -3,12 +3,12 @@ type GlScalar = {
     descriptor: string;
     tsAlias: string;
     viewType?: string;
-    groupBearing?: boolean;
+    isGroupBearing?: boolean;
 };
 type ParsedCType = {
     base: string;
     pointers: number;
-    constData: boolean;
+    isConstData: boolean;
 };
 type ParamPlan = {
     kind: "scalar";
@@ -65,17 +65,17 @@ type GlPlanPolicy = {
     singleValuedQueries: Set<string>;
 };
 type CommandPlan = {
-    ok: true;
+    isOk: true;
     command: GlCommand;
     params: ParamPlan[];
     returnPlan: ReturnPlan;
 } | {
-    ok: false;
+    isOk: false;
     command: GlCommand;
     reason: GlExclusionReason;
 };
 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, };
+export { GL_SCALARS, parseCType, planCommand, type GlScalar, type ParamPlan, type ReturnPlan, type GlExclusionReason, type GlPlanPolicy, type CommandPlan, };
 //# sourceMappingURL=plan.d.ts.map