@gtkx/codegen 1.0.0-rc.4 → 1.0.0

package/dist/khronos/args.js.map

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

package/dist/khronos/doc-context.d.ts

@@ -0,0 +1,29 @@
+import type { GlExtensionAttribution, GlExtensionIndex } from "./extensions.js";
+import type { GlEnum, GlRegistry, GlType } from "./model.js";
+import type { CommandPlan } from "./plan.js";
+type GlDocEnumRow = {
+    token: GlEnum;
+    exportName: string;
+};
+type GlDocContext = {
+    registryComment?: string;
+    kinds: Map<string, string>;
+    types: Map<string, GlType>;
+    aliasTargets: Map<string, string[]>;
+    extensionCommands: Map<string, GlExtensionAttribution[]>;
+    extensionEnums: Map<string, GlExtensionAttribution[]>;
+    bitmaskGroups: Set<string>;
+    emittedCommands: Set<string>;
+    groupMembers: Map<string, string[]>;
+};
+type BuildDocContextOptions = {
+    registry: GlRegistry;
+    extensions: GlExtensionIndex;
+    plans: (CommandPlan & {
+        isOk: true;
+    })[];
+    enumRows: GlDocEnumRow[];
+};
+declare const buildDocContext: (options: BuildDocContextOptions) => GlDocContext;
+export { buildDocContext, type GlDocContext };
+//# sourceMappingURL=doc-context.d.ts.map

package/dist/khronos/doc-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-context.d.ts","sourceRoot":"","sources":["../../src/khronos/doc-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,KAAK,YAAY,GAAG;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,YAAY,GAAG;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACpC,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAC;IACzD,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAC;IACtD,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACvC,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC1B,QAAQ,EAAE,UAAU,CAAC;IACrB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,KAAK,EAAE,CAAC,WAAW,GAAG;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,EAAE,CAAC;IACxC,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC5B,CAAC;AAkBF,QAAA,MAAM,eAAe,GAAI,SAAS,sBAAsB,KAAG,YAc1D,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,CAAC"}

package/dist/khronos/doc-context.js

@@ -0,0 +1,29 @@
+import { sortStrings } from "@gtkx/utils";
+const buildGroupMembers = (rows) => {
+    const members = new Map();
+    for (const row of rows) {
+        for (const group of row.token.groups) {
+            members.set(group, [...(members.get(group) ?? []), row.exportName]);
+        }
+    }
+    for (const [group, names] of members) {
+        members.set(group, sortStrings(names));
+    }
+    return members;
+};
+const buildDocContext = (options) => {
+    const { registry, extensions, plans, enumRows } = options;
+    return {
+        ...(registry.comment !== undefined && { registryComment: registry.comment }),
+        kinds: registry.kinds,
+        types: registry.types,
+        aliasTargets: registry.aliasTargets,
+        extensionCommands: extensions.commands,
+        extensionEnums: extensions.enums,
+        bitmaskGroups: registry.bitmaskGroups,
+        emittedCommands: new Set(plans.map((plan) => plan.command.name)),
+        groupMembers: buildGroupMembers(enumRows),
+    };
+};
+export { buildDocContext };
+//# sourceMappingURL=doc-context.js.map

package/dist/khronos/doc-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-context.js","sourceRoot":"","sources":["../../src/khronos/doc-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA6B1C,MAAM,iBAAiB,GAAG,CAAC,IAAoB,EAAyB,EAAE;IACtE,MAAM,OAAO,GAA0B,IAAI,GAAG,EAAE,CAAC;IAEjD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;QACxE,CAAC;IACL,CAAC;IAED,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,OAA+B,EAAgB,EAAE;IACtE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAE1D,OAAO;QACH,GAAG,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,eAAe,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC5E,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,iBAAiB,EAAE,UAAU,CAAC,QAAQ;QACtC,cAAc,EAAE,UAAU,CAAC,KAAK;QAChC,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,eAAe,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChE,YAAY,EAAE,iBAAiB,CAAC,QAAQ,CAAC;KAC5C,CAAC;AACN,CAAC,CAAC;AAEF,OAAO,EAAE,eAAe,EAAqB,CAAC","sourcesContent":["import { sortStrings } from \"@gtkx/utils\";\nimport type { GlExtensionAttribution, GlExtensionIndex } from \"./extensions.js\";\nimport type { GlEnum, GlRegistry, GlType } from \"./model.js\";\nimport type { CommandPlan } from \"./plan.js\";\n\ntype GlDocEnumRow = {\n    token: GlEnum;\n    exportName: string;\n};\n\ntype GlDocContext = {\n    registryComment?: string;\n    kinds: Map<string, string>;\n    types: Map<string, GlType>;\n    aliasTargets: Map<string, string[]>;\n    extensionCommands: Map<string, GlExtensionAttribution[]>;\n    extensionEnums: Map<string, GlExtensionAttribution[]>;\n    bitmaskGroups: Set<string>;\n    emittedCommands: Set<string>;\n    groupMembers: Map<string, string[]>;\n};\n\ntype BuildDocContextOptions = {\n    registry: GlRegistry;\n    extensions: GlExtensionIndex;\n    plans: (CommandPlan & { isOk: true })[];\n    enumRows: GlDocEnumRow[];\n};\n\nconst buildGroupMembers = (rows: GlDocEnumRow[]): Map<string, string[]> => {\n    const members: Map<string, string[]> = new Map();\n\n    for (const row of rows) {\n        for (const group of row.token.groups) {\n            members.set(group, [...(members.get(group) ?? []), row.exportName]);\n        }\n    }\n\n    for (const [group, names] of members) {\n        members.set(group, sortStrings(names));\n    }\n\n    return members;\n};\n\nconst buildDocContext = (options: BuildDocContextOptions): GlDocContext => {\n    const { registry, extensions, plans, enumRows } = options;\n\n    return {\n        ...(registry.comment !== undefined && { registryComment: registry.comment }),\n        kinds: registry.kinds,\n        types: registry.types,\n        aliasTargets: registry.aliasTargets,\n        extensionCommands: extensions.commands,\n        extensionEnums: extensions.enums,\n        bitmaskGroups: registry.bitmaskGroups,\n        emittedCommands: new Set(plans.map((plan) => plan.command.name)),\n        groupMembers: buildGroupMembers(enumRows),\n    };\n};\n\nexport { buildDocContext, type GlDocContext };\n"]}

package/dist/khronos/extensions.d.ts

@@ -0,0 +1,13 @@
+import type { GlRegistry } from "./model.js";
+import type { GlSelection } from "./select.js";
+type GlExtensionAttribution = {
+    name: string;
+    notes: string[];
+};
+type GlExtensionIndex = {
+    commands: Map<string, GlExtensionAttribution[]>;
+    enums: Map<string, GlExtensionAttribution[]>;
+};
+declare const buildExtensionIndex: (registry: GlRegistry, selection: GlSelection) => GlExtensionIndex;
+export { buildExtensionIndex, type GlExtensionAttribution, type GlExtensionIndex };
+//# sourceMappingURL=extensions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../src/khronos/extensions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiC,UAAU,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,KAAK,sBAAsB,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACpB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAC;IAChD,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAC;CAChD,CAAC;AA4DF,QAAA,MAAM,mBAAmB,GAAI,UAAU,UAAU,EAAE,WAAW,WAAW,KAAG,gBAU3E,CAAC;AAEF,OAAO,EAAE,mBAAmB,EAAE,KAAK,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,CAAC"}

package/dist/khronos/extensions.js

@@ -0,0 +1,49 @@
+import { sortStrings } from "@gtkx/utils";
+const SUPPORTED_APIS = new Set(["gl", "glcore"]);
+const isExtensionSupported = (extension) => extension.supported.some((api) => SUPPORTED_APIS.has(api));
+const isBlockIncluded = (block, selection) => block.kind === "require" &&
+    (block.api === undefined || block.api === selection.api) &&
+    (block.profile === undefined || block.profile === selection.profile);
+const blockNotes = (extension, block) => [
+    ...(extension.comment === undefined ? [] : [extension.comment]),
+    ...(block.comment === undefined ? [] : [block.comment]),
+];
+const appendMembers = (index, names, extension, notes) => {
+    for (const name of names) {
+        const byExtension = index.get(name) ?? new Map();
+        byExtension.set(extension, [...(byExtension.get(extension) ?? []), ...notes]);
+        index.set(name, byExtension);
+    }
+};
+const indexExtension = (index, extension, selection) => {
+    for (const block of extension.blocks) {
+        if (!isBlockIncluded(block, selection)) {
+            continue;
+        }
+        const notes = blockNotes(extension, block);
+        appendMembers(index.commands, block.commands, extension.name, notes);
+        appendMembers(index.enums, block.enums, extension.name, notes);
+    }
+};
+const attributionsFor = (byExtension) => sortStrings(byExtension.keys()).map((name) => ({
+    name,
+    notes: [...new Set(byExtension.get(name))],
+}));
+const finalizeIndex = (pending) => {
+    const index = new Map();
+    for (const [name, byExtension] of pending) {
+        index.set(name, attributionsFor(byExtension));
+    }
+    return index;
+};
+const buildExtensionIndex = (registry, selection) => {
+    const pending = { commands: new Map(), enums: new Map() };
+    for (const extension of registry.extensions) {
+        if (isExtensionSupported(extension)) {
+            indexExtension(pending, extension, selection);
+        }
+    }
+    return { commands: finalizeIndex(pending.commands), enums: finalizeIndex(pending.enums) };
+};
+export { buildExtensionIndex };
+//# sourceMappingURL=extensions.js.map

package/dist/khronos/extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../../src/khronos/extensions.ts"],"names":[],"mappings":"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","sourcesContent":["import { sortStrings } from \"@gtkx/utils\";\nimport type { GlExtension, GlInterfaceBlock, GlRegistry } from \"./model.js\";\nimport type { GlSelection } from \"./select.js\";\n\ntype GlExtensionAttribution = {\n    name: string;\n    notes: string[];\n};\n\ntype GlExtensionIndex = {\n    commands: Map<string, GlExtensionAttribution[]>;\n    enums: Map<string, GlExtensionAttribution[]>;\n};\n\ntype PendingIndex = Map<string, Map<string, string[]>>;\n\ntype PendingExtensionIndex = {\n    commands: PendingIndex;\n    enums: PendingIndex;\n};\n\nconst SUPPORTED_APIS: Set<string> = new Set([\"gl\", \"glcore\"]);\n\nconst isExtensionSupported = (extension: GlExtension): boolean =>\n    extension.supported.some((api) => SUPPORTED_APIS.has(api));\n\nconst isBlockIncluded = (block: GlInterfaceBlock, selection: GlSelection): boolean =>\n    block.kind === \"require\" &&\n    (block.api === undefined || block.api === selection.api) &&\n    (block.profile === undefined || block.profile === selection.profile);\n\nconst blockNotes = (extension: GlExtension, block: GlInterfaceBlock): string[] => [\n    ...(extension.comment === undefined ? [] : [extension.comment]),\n    ...(block.comment === undefined ? [] : [block.comment]),\n];\n\nconst appendMembers = (index: PendingIndex, names: string[], extension: string, notes: string[]): void => {\n    for (const name of names) {\n        const byExtension = index.get(name) ?? new Map<string, string[]>();\n        byExtension.set(extension, [...(byExtension.get(extension) ?? []), ...notes]);\n        index.set(name, byExtension);\n    }\n};\n\nconst indexExtension = (index: PendingExtensionIndex, extension: GlExtension, selection: GlSelection): void => {\n    for (const block of extension.blocks) {\n        if (!isBlockIncluded(block, selection)) {\n            continue;\n        }\n\n        const notes = blockNotes(extension, block);\n        appendMembers(index.commands, block.commands, extension.name, notes);\n        appendMembers(index.enums, block.enums, extension.name, notes);\n    }\n};\n\nconst attributionsFor = (byExtension: Map<string, string[]>): GlExtensionAttribution[] =>\n    sortStrings(byExtension.keys()).map((name) => ({\n        name,\n        notes: [...new Set(byExtension.get(name))],\n    }));\n\nconst finalizeIndex = (pending: PendingIndex): Map<string, GlExtensionAttribution[]> => {\n    const index: Map<string, GlExtensionAttribution[]> = new Map();\n\n    for (const [name, byExtension] of pending) {\n        index.set(name, attributionsFor(byExtension));\n    }\n\n    return index;\n};\n\nconst buildExtensionIndex = (registry: GlRegistry, selection: GlSelection): GlExtensionIndex => {\n    const pending: PendingExtensionIndex = { commands: new Map(), enums: new Map() };\n\n    for (const extension of registry.extensions) {\n        if (isExtensionSupported(extension)) {\n            indexExtension(pending, extension, selection);\n        }\n    }\n\n    return { commands: finalizeIndex(pending.commands), enums: finalizeIndex(pending.enums) };\n};\n\nexport { buildExtensionIndex, type GlExtensionAttribution, type GlExtensionIndex };\n"]}

package/dist/khronos/jsdoc.d.ts

@@ -1,21 +1,27 @@
 import type { InArg, OutArg } from "./args.js";
+import type { GlDocContext } from "./doc-context.js";
 import type { GlCommand } from "./model.js";
-import type { ReturnPlan } from "./plan.js";
+import type { CommandPlan } from "./plan.js";
+import type { GlSymbolProvenance } from "./select.js";
+type OkPlan = CommandPlan & {
+    isOk: true;
+};
 type CommandJsDocOptions = {
-    command: GlCommand;
-    feature: string;
+    plan: OkPlan;
+    provenance: GlSymbolProvenance;
     ins: InArg[];
     outs: OutArg[];
-    returnPlan: ReturnPlan;
+    docs: GlDocContext;
 };
-type SingularJsDocOptions = {
-    commandName: string;
-    feature: string;
+type DerivedJsDocOptions = {
+    command: GlCommand;
+    provenance: GlSymbolProvenance;
     summary: string;
     body: string[];
+    docs: GlDocContext;
 };
-declare const inParamDocLine: (command: GlCommand, arg: InArg) => string;
-declare const singularJsDoc: ({ commandName, feature, summary, body }: SingularJsDocOptions) => string;
-declare const commandJsDoc: ({ command, feature, ins, outs, returnPlan }: CommandJsDocOptions) => string;
-export { inParamDocLine, singularJsDoc, commandJsDoc };
+declare const inParamDocLine: (plan: OkPlan, arg: InArg, docs: GlDocContext) => string;
+declare const derivedJsDoc: ({ command, provenance, summary, body, docs }: DerivedJsDocOptions) => string;
+declare const commandJsDoc: ({ plan, provenance, ins, outs, docs }: CommandJsDocOptions) => string;
+export { commandJsDoc, derivedJsDoc, inParamDocLine };
 //# sourceMappingURL=jsdoc.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"jsdoc.d.ts","sourceRoot":"","sources":["../../src/khronos/jsdoc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,KAAK,mBAAmB,GAAG;IACvB,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,KAAK,EAAE,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;CAC1B,CAAC;AAEF,KAAK,oBAAoB,GAAG;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAYF,QAAA,MAAM,cAAc,GAAI,SAAS,SAAS,EAAE,KAAK,KAAK,KAAG,MAsBxD,CAAC;AAoCF,QAAA,MAAM,aAAa,GAAI,yCAAyC,oBAAoB,KAAG,MASvE,CAAC;AAEjB,QAAA,MAAM,YAAY,GAAI,6CAA6C,mBAAmB,KAAG,MAYxF,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"jsdoc.d.ts","sourceRoot":"","sources":["../../src/khronos/jsdoc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAyB,MAAM,WAAW,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AActD,KAAK,MAAM,GAAG,WAAW,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC;AAO3C,KAAK,mBAAmB,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,kBAAkB,CAAC;IAC/B,GAAG,EAAE,KAAK,EAAE,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,YAAY,CAAC;CACtB,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACvB,OAAO,EAAE,SAAS,CAAC;IACnB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,YAAY,CAAC;CACtB,CAAC;AA8FF,QAAA,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,KAAG,MAYtE,CAAC;AAiCF,QAAA,MAAM,YAAY,GAAI,8CAA8C,mBAAmB,KAAG,MAQ1E,CAAC;AAEjB,QAAA,MAAM,YAAY,GAAI,uCAAuC,mBAAmB,KAAG,MAkBlF,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/khronos/jsdoc.js

@@ -1,72 +1,130 @@
 import { toCamelIdentifier } from "@gtkx/utils";
-const REFPAGES_BASE = "https://registry.khronos.org/OpenGL-Refpages/gl4/html";
+import { returnPlanTsType, scalarAliasOrGroup } from "./args.js";
+import { asSentence, backtick, backtickList, commandExportName, kindDescriptions, metadataNotes, provenanceLines, } from "./notes.js";
+import { paramPairAt } from "./param-pair.js";
+const GROUPED_PLAN_KINDS = new Set(["scalar", "array-in", "ref-out", "ref-array-out"]);
+const LENGTHLESS_PLAN_KINDS = new Set(["byte-offset", "byte-offset-array", "ref-out"]);
+const OFFSET_NOTES = new Map([
+    ["byte-offset", "byte offset into the bound buffer"],
+    ["byte-offset-array", "byte offsets into the bound buffer"],
+]);
 const formatPrototype = (command) => {
     const params = command.params
         .map((param) => (param.cType.endsWith("*") ? `${param.cType}${param.name}` : `${param.cType} ${param.name}`))
         .join(", ");
     return `${command.returnCType} ${command.name}(${params})`;
 };
-const inParamDocLine = (command, arg) => {
-    const param = command.params.find((candidate) => toCamelIdentifier(candidate.name) === arg.name);
-    if (param === undefined) {
-        return ` * @param ${arg.name}`;
-    }
-    const notes = [`\`${param.cType}\``];
-    if (param.group !== undefined) {
-        notes.push(`group \`${param.group}\``);
-    }
-    if (param.len !== undefined) {
-        notes.push(`length \`${param.len}\``);
-    }
-    if (param.objectClass !== undefined) {
-        notes.push(`object class \`${param.objectClass}\``);
+const glxLine = (glx) => {
+    const opcode = ` * GLX ${glx.type} opcode ${glx.opcode}.`;
+    return glx.comment === undefined ? opcode : `${opcode} ${asSentence(glx.comment)}`;
+};
+const aliasLine = (aliases) => ` * Also known as ${backtickList(aliases)}.`;
+const vectorFormLines = (command, docs) => {
+    const target = command.vecEquiv;
+    if (target === undefined || !docs.emittedCommands.has(target)) {
+        return [];
     }
-    return ` * @param ${arg.name} - ${notes.join(", ")}`;
+    return [` * Vector form: ${backtick(commandExportName(target))}.`];
+};
+const commandNotes = (command, docs) => {
+    const aliases = docs.aliasTargets.get(command.name) ?? [];
+    return [
+        ...(command.comment === undefined ? [] : [` * Registry note: ${command.comment}`]),
+        ...(aliases.length > 0 ? [aliasLine(aliases)] : []),
+        ...vectorFormLines(command, docs),
+        ...(command.glx === undefined ? [] : [glxLine(command.glx)]),
+    ];
+};
+const isGroupFolded = (plan, group) => GROUPED_PLAN_KINDS.has(plan.kind) &&
+    "scalar" in plan &&
+    scalarAliasOrGroup(plan.scalar, group) !== plan.scalar.tsAlias;
+const groupEntry = (param, paramPlan) => param.group === undefined || isGroupFolded(paramPlan, param.group) ? {} : { group: param.group };
+const lengthEntry = (param, paramPlan) => param.len === undefined || LENGTHLESS_PLAN_KINDS.has(paramPlan.kind) ? {} : { len: param.len };
+const paramShape = (param, paramPlan, type) => {
+    const note = OFFSET_NOTES.get(paramPlan.kind);
+    return {
+        type,
+        ...groupEntry(param, paramPlan),
+        ...lengthEntry(param, paramPlan),
+        ...(param.objectClass !== undefined && { objectClass: param.objectClass }),
+        ...(note !== undefined && { note }),
+        kinds: param.kinds,
+    };
 };
-const outMember = (command, out) => {
-    const param = command.params[out.paramIndex];
-    if (param === undefined) {
-        throw new Error(`Output parameter index ${String(out.paramIndex)} out of range on ${command.name}`);
+const returnShape = (plan) => {
+    const { command, returnPlan } = plan;
+    const group = command.returnGroup;
+    return {
+        type: returnPlanTsType(returnPlan, group),
+        ...(group !== undefined && !isGroupFolded(returnPlan, group) && { group }),
+        ...(command.returnObjectClass !== undefined && { objectClass: command.returnObjectClass }),
+        kinds: command.returnKinds,
+    };
+};
+const paramPairFor = (plan, argName) => {
+    const index = plan.command.params.findIndex((candidate) => toCamelIdentifier(candidate.name) === argName);
+    const { param, paramPlan } = paramPairAt(plan, index);
+    if (param === undefined || paramPlan === undefined) {
+        return undefined;
     }
-    return `\`${param.name}\` (\`${param.cType}\`)`;
+    return { param, paramPlan };
 };
-const returnsDocLine = (command, returnPlan, outs) => {
-    const members = [];
-    if (returnPlan.kind !== "void") {
-        members.push(`\`${command.returnCType}\``);
+const inParamDocLine = (plan, arg, docs) => {
+    const pair = paramPairFor(plan, arg.name);
+    if (pair === undefined) {
+        return ` * @param ${arg.name}`;
     }
-    for (const out of outs) {
-        members.push(outMember(command, out));
+    const descriptions = kindDescriptions(pair.param.kinds, docs.kinds);
+    const sentence = descriptions.length === 0 ? "" : `. ${descriptions}`;
+    const notes = metadataNotes(paramShape(pair.param, pair.paramPlan, arg.tsType));
+    return ` * @param ${arg.name} - ${notes}${sentence}`;
+};
+const outMember = (plan, out) => {
+    const { param, paramPlan } = paramPairAt(plan, out.paramIndex);
+    if (param === undefined || paramPlan === undefined) {
+        throw new Error(`Output parameter index ${String(out.paramIndex)} out of range on ${plan.command.name}`);
     }
-    if (members.length === 0) {
+    return `${backtick(param.name)} (${metadataNotes(paramShape(param, paramPlan, out.tsType))})`;
+};
+const returnsDocLine = (plan, outs) => {
+    const members = [
+        ...(plan.returnPlan.kind === "void" ? [] : [metadataNotes(returnShape(plan))]),
+        ...outs.map((out) => outMember(plan, out)),
+    ];
+    const [single] = members;
+    if (single === undefined) {
         return undefined;
     }
-    const [single] = members;
-    if (single !== undefined && members.length === 1) {
+    if (members.length === 1) {
         return ` * @returns ${single}`;
     }
     return ` * @returns Tuple of ${members.join(", ")}`;
 };
-const singularJsDoc = ({ commandName, feature, summary, body }) => [
+const tagBlock = (tags) => (tags.length === 0 ? [] : [" *", ...tags]);
+const derivedJsDoc = ({ command, provenance, summary, body, docs }) => [
     "/**",
     ` * ${summary}`,
     " *",
-    ` * Provided by \`${feature}\`.`,
-    ...body,
-    ` * @see ${REFPAGES_BASE}/${commandName}.xhtml`,
+    ...provenanceLines(provenance, docs.extensionCommands.get(command.name) ?? []),
+    ...tagBlock(body),
     " */",
 ].join("\n");
-const commandJsDoc = ({ command, feature, ins, outs, returnPlan }) => {
-    const returnsLine = returnsDocLine(command, returnPlan, outs);
-    return singularJsDoc({
-        commandName: command.name,
-        feature,
-        summary: `\`${formatPrototype(command)}\``,
-        body: [
-            ...(ins.length > 0 ? [" *", ...ins.map((arg) => inParamDocLine(command, arg))] : []),
-            ...(returnsLine === undefined ? [] : [returnsLine]),
-        ],
-    });
+const commandJsDoc = ({ plan, provenance, ins, outs, docs }) => {
+    const { command } = plan;
+    const returnsLine = returnsDocLine(plan, outs);
+    const tags = [
+        ...ins.map((arg) => inParamDocLine(plan, arg, docs)),
+        ...(returnsLine === undefined ? [] : [returnsLine]),
+    ];
+    return [
+        "/**",
+        ` * ${backtick(formatPrototype(command))}`,
+        " *",
+        ...provenanceLines(provenance, docs.extensionCommands.get(command.name) ?? []),
+        ...commandNotes(command, docs),
+        ...tagBlock(tags),
+        " */",
+    ].join("\n");
 };
-export { inParamDocLine, singularJsDoc, commandJsDoc };
+export { commandJsDoc, derivedJsDoc, inParamDocLine };
 //# sourceMappingURL=jsdoc.js.map

package/dist/khronos/jsdoc.js.map

@@ -1 +1 @@
-{"version":3,"file":"jsdoc.js","sourceRoot":"","sources":["../../src/khronos/jsdoc.ts"],"names":[],"mappings":"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","sourcesContent":["import { toCamelIdentifier } from \"@gtkx/utils\";\nimport type { InArg, OutArg } from \"./args.js\";\nimport type { GlCommand } from \"./model.js\";\nimport type { ReturnPlan } from \"./plan.js\";\n\ntype CommandJsDocOptions = {\n    command: GlCommand;\n    feature: string;\n    ins: InArg[];\n    outs: OutArg[];\n    returnPlan: ReturnPlan;\n};\n\ntype SingularJsDocOptions = {\n    commandName: string;\n    feature: string;\n    summary: string;\n    body: string[];\n};\n\nconst REFPAGES_BASE = \"https://registry.khronos.org/OpenGL-Refpages/gl4/html\";\n\nconst formatPrototype = (command: GlCommand): string => {\n    const params = command.params\n        .map((param) => (param.cType.endsWith(\"*\") ? `${param.cType}${param.name}` : `${param.cType} ${param.name}`))\n        .join(\", \");\n\n    return `${command.returnCType} ${command.name}(${params})`;\n};\n\nconst inParamDocLine = (command: GlCommand, arg: InArg): string => {\n    const param = command.params.find((candidate) => toCamelIdentifier(candidate.name) === arg.name);\n\n    if (param === undefined) {\n        return ` * @param ${arg.name}`;\n    }\n\n    const notes: string[] = [`\\`${param.cType}\\``];\n\n    if (param.group !== undefined) {\n        notes.push(`group \\`${param.group}\\``);\n    }\n\n    if (param.len !== undefined) {\n        notes.push(`length \\`${param.len}\\``);\n    }\n\n    if (param.objectClass !== undefined) {\n        notes.push(`object class \\`${param.objectClass}\\``);\n    }\n\n    return ` * @param ${arg.name} - ${notes.join(\", \")}`;\n};\n\nconst outMember = (command: GlCommand, out: OutArg): string => {\n    const param = command.params[out.paramIndex];\n\n    if (param === undefined) {\n        throw new Error(`Output parameter index ${String(out.paramIndex)} out of range on ${command.name}`);\n    }\n\n    return `\\`${param.name}\\` (\\`${param.cType}\\`)`;\n};\n\nconst returnsDocLine = (command: GlCommand, returnPlan: ReturnPlan, outs: OutArg[]): string | undefined => {\n    const members: string[] = [];\n\n    if (returnPlan.kind !== \"void\") {\n        members.push(`\\`${command.returnCType}\\``);\n    }\n\n    for (const out of outs) {\n        members.push(outMember(command, out));\n    }\n\n    if (members.length === 0) {\n        return undefined;\n    }\n\n    const [single] = members;\n\n    if (single !== undefined && members.length === 1) {\n        return ` * @returns ${single}`;\n    }\n\n    return ` * @returns Tuple of ${members.join(\", \")}`;\n};\n\nconst singularJsDoc = ({ commandName, feature, summary, body }: SingularJsDocOptions): string =>\n    [\n        \"/**\",\n        ` * ${summary}`,\n        \" *\",\n        ` * Provided by \\`${feature}\\`.`,\n        ...body,\n        ` * @see ${REFPAGES_BASE}/${commandName}.xhtml`,\n        \" */\",\n    ].join(\"\\n\");\n\nconst commandJsDoc = ({ command, feature, ins, outs, returnPlan }: CommandJsDocOptions): string => {\n    const returnsLine = returnsDocLine(command, returnPlan, outs);\n\n    return singularJsDoc({\n        commandName: command.name,\n        feature,\n        summary: `\\`${formatPrototype(command)}\\``,\n        body: [\n            ...(ins.length > 0 ? [\" *\", ...ins.map((arg) => inParamDocLine(command, arg))] : []),\n            ...(returnsLine === undefined ? [] : [returnsLine]),\n        ],\n    });\n};\n\nexport { inParamDocLine, singularJsDoc, commandJsDoc };\n"]}
+{"version":3,"file":"jsdoc.js","sourceRoot":"","sources":["../../src/khronos/jsdoc.ts"],"names":[],"mappings":"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","sourcesContent":["import { toCamelIdentifier } from \"@gtkx/utils\";\nimport type { InArg, OutArg } from \"./args.js\";\nimport type { GlDocContext } from \"./doc-context.js\";\nimport type { GlCommand, GlGlx, GlParam } from \"./model.js\";\nimport type { CommandPlan, ParamPlan, ReturnPlan } from \"./plan.js\";\nimport type { GlSymbolProvenance } from \"./select.js\";\nimport { returnPlanTsType, scalarAliasOrGroup } from \"./args.js\";\nimport {\n    asSentence,\n    backtick,\n    backtickList,\n    commandExportName,\n    kindDescriptions,\n    metadataNotes,\n    type MetadataNotesOptions,\n    provenanceLines,\n} from \"./notes.js\";\nimport { paramPairAt } from \"./param-pair.js\";\n\ntype OkPlan = CommandPlan & { isOk: true };\n\ntype ParamPair = {\n    param: GlParam;\n    paramPlan: ParamPlan;\n};\n\ntype CommandJsDocOptions = {\n    plan: OkPlan;\n    provenance: GlSymbolProvenance;\n    ins: InArg[];\n    outs: OutArg[];\n    docs: GlDocContext;\n};\n\ntype DerivedJsDocOptions = {\n    command: GlCommand;\n    provenance: GlSymbolProvenance;\n    summary: string;\n    body: string[];\n    docs: GlDocContext;\n};\n\nconst GROUPED_PLAN_KINDS: Set<string> = new Set([\"scalar\", \"array-in\", \"ref-out\", \"ref-array-out\"]);\nconst LENGTHLESS_PLAN_KINDS: Set<string> = new Set([\"byte-offset\", \"byte-offset-array\", \"ref-out\"]);\n\nconst OFFSET_NOTES: Map<string, string> = new Map([\n    [\"byte-offset\", \"byte offset into the bound buffer\"],\n    [\"byte-offset-array\", \"byte offsets into the bound buffer\"],\n]);\n\nconst formatPrototype = (command: GlCommand): string => {\n    const params = command.params\n        .map((param) => (param.cType.endsWith(\"*\") ? `${param.cType}${param.name}` : `${param.cType} ${param.name}`))\n        .join(\", \");\n\n    return `${command.returnCType} ${command.name}(${params})`;\n};\n\nconst glxLine = (glx: GlGlx): string => {\n    const opcode = ` * GLX ${glx.type} opcode ${glx.opcode}.`;\n\n    return glx.comment === undefined ? opcode : `${opcode} ${asSentence(glx.comment)}`;\n};\n\nconst aliasLine = (aliases: string[]): string => ` * Also known as ${backtickList(aliases)}.`;\n\nconst vectorFormLines = (command: GlCommand, docs: GlDocContext): string[] => {\n    const target = command.vecEquiv;\n\n    if (target === undefined || !docs.emittedCommands.has(target)) {\n        return [];\n    }\n\n    return [` * Vector form: ${backtick(commandExportName(target))}.`];\n};\n\nconst commandNotes = (command: GlCommand, docs: GlDocContext): string[] => {\n    const aliases = docs.aliasTargets.get(command.name) ?? [];\n\n    return [\n        ...(command.comment === undefined ? [] : [` * Registry note: ${command.comment}`]),\n        ...(aliases.length > 0 ? [aliasLine(aliases)] : []),\n        ...vectorFormLines(command, docs),\n        ...(command.glx === undefined ? [] : [glxLine(command.glx)]),\n    ];\n};\n\nconst isGroupFolded = (plan: ParamPlan | ReturnPlan, group: string): boolean =>\n    GROUPED_PLAN_KINDS.has(plan.kind) &&\n    \"scalar\" in plan &&\n    scalarAliasOrGroup(plan.scalar, group) !== plan.scalar.tsAlias;\n\nconst groupEntry = (param: GlParam, paramPlan: ParamPlan): { group?: string } =>\n    param.group === undefined || isGroupFolded(paramPlan, param.group) ? {} : { group: param.group };\n\nconst lengthEntry = (param: GlParam, paramPlan: ParamPlan): { len?: string } =>\n    param.len === undefined || LENGTHLESS_PLAN_KINDS.has(paramPlan.kind) ? {} : { len: param.len };\n\nconst paramShape = (param: GlParam, paramPlan: ParamPlan, type: string): MetadataNotesOptions => {\n    const note = OFFSET_NOTES.get(paramPlan.kind);\n\n    return {\n        type,\n        ...groupEntry(param, paramPlan),\n        ...lengthEntry(param, paramPlan),\n        ...(param.objectClass !== undefined && { objectClass: param.objectClass }),\n        ...(note !== undefined && { note }),\n        kinds: param.kinds,\n    };\n};\n\nconst returnShape = (plan: OkPlan): MetadataNotesOptions => {\n    const { command, returnPlan } = plan;\n    const group = command.returnGroup;\n\n    return {\n        type: returnPlanTsType(returnPlan, group),\n        ...(group !== undefined && !isGroupFolded(returnPlan, group) && { group }),\n        ...(command.returnObjectClass !== undefined && { objectClass: command.returnObjectClass }),\n        kinds: command.returnKinds,\n    };\n};\n\nconst paramPairFor = (plan: OkPlan, argName: string): ParamPair | undefined => {\n    const index = plan.command.params.findIndex((candidate) => toCamelIdentifier(candidate.name) === argName);\n    const { param, paramPlan } = paramPairAt(plan, index);\n\n    if (param === undefined || paramPlan === undefined) {\n        return undefined;\n    }\n\n    return { param, paramPlan };\n};\n\nconst inParamDocLine = (plan: OkPlan, arg: InArg, docs: GlDocContext): string => {\n    const pair = paramPairFor(plan, arg.name);\n\n    if (pair === undefined) {\n        return ` * @param ${arg.name}`;\n    }\n\n    const descriptions = kindDescriptions(pair.param.kinds, docs.kinds);\n    const sentence = descriptions.length === 0 ? \"\" : `. ${descriptions}`;\n    const notes = metadataNotes(paramShape(pair.param, pair.paramPlan, arg.tsType));\n\n    return ` * @param ${arg.name} - ${notes}${sentence}`;\n};\n\nconst outMember = (plan: OkPlan, out: OutArg): string => {\n    const { param, paramPlan } = paramPairAt(plan, out.paramIndex);\n\n    if (param === undefined || paramPlan === undefined) {\n        throw new Error(`Output parameter index ${String(out.paramIndex)} out of range on ${plan.command.name}`);\n    }\n\n    return `${backtick(param.name)} (${metadataNotes(paramShape(param, paramPlan, out.tsType))})`;\n};\n\nconst returnsDocLine = (plan: OkPlan, outs: OutArg[]): string | undefined => {\n    const members = [\n        ...(plan.returnPlan.kind === \"void\" ? [] : [metadataNotes(returnShape(plan))]),\n        ...outs.map((out) => outMember(plan, out)),\n    ];\n\n    const [single] = members;\n\n    if (single === undefined) {\n        return undefined;\n    }\n\n    if (members.length === 1) {\n        return ` * @returns ${single}`;\n    }\n\n    return ` * @returns Tuple of ${members.join(\", \")}`;\n};\n\nconst tagBlock = (tags: string[]): string[] => (tags.length === 0 ? [] : [\" *\", ...tags]);\n\nconst derivedJsDoc = ({ command, provenance, summary, body, docs }: DerivedJsDocOptions): string =>\n    [\n        \"/**\",\n        ` * ${summary}`,\n        \" *\",\n        ...provenanceLines(provenance, docs.extensionCommands.get(command.name) ?? []),\n        ...tagBlock(body),\n        \" */\",\n    ].join(\"\\n\");\n\nconst commandJsDoc = ({ plan, provenance, ins, outs, docs }: CommandJsDocOptions): string => {\n    const { command } = plan;\n    const returnsLine = returnsDocLine(plan, outs);\n\n    const tags = [\n        ...ins.map((arg) => inParamDocLine(plan, arg, docs)),\n        ...(returnsLine === undefined ? [] : [returnsLine]),\n    ];\n\n    return [\n        \"/**\",\n        ` * ${backtick(formatPrototype(command))}`,\n        \" *\",\n        ...provenanceLines(provenance, docs.extensionCommands.get(command.name) ?? []),\n        ...commandNotes(command, docs),\n        ...tagBlock(tags),\n        \" */\",\n    ].join(\"\\n\");\n};\n\nexport { commandJsDoc, derivedJsDoc, inParamDocLine };\n"]}

package/dist/khronos/model.d.ts

@@ -4,20 +4,42 @@ type GlParam = {
     group?: string;
     len?: string;
     objectClass?: string;
+    kinds: string[];
+};
+type GlGlx = {
+    type: string;
+    opcode: string;
+    comment?: string;
 };
 type GlCommand = {
     name: string;
     returnCType: string;
     returnGroup?: string;
+    returnObjectClass?: string;
+    returnKinds: string[];
+    comment?: string;
+    aliasTarget?: string;
+    vecEquiv?: string;
+    glx?: GlGlx;
     params: GlParam[];
 };
 type GlEnum = {
     name: string;
     value: string;
     groups: string[];
+    comment?: string;
+    alias?: string;
+    api?: string;
+    valueType?: string;
+    vendor?: string;
+    blockComment?: string;
+    isBitmask: boolean;
 };
 type GlInterfaceBlock = {
+    kind: "require" | "remove";
+    api?: string;
     profile?: string;
+    comment?: string;
     commands: string[];
     enums: string[];
 };
@@ -25,14 +47,31 @@ type GlFeature = {
     api: string;
     name: string;
     number: number;
-    requires: GlInterfaceBlock[];
-    removes: GlInterfaceBlock[];
+    blocks: GlInterfaceBlock[];
+};
+type GlExtension = {
+    name: string;
+    supported: string[];
+    comment?: string;
+    blocks: GlInterfaceBlock[];
+};
+type GlType = {
+    name: string;
+    declaration: string;
+    requires?: string;
+    comment?: string;
 };
 type GlRegistry = {
+    comment?: string;
+    types: Map<string, GlType>;
+    kinds: Map<string, string>;
     commands: Map<string, GlCommand>;
     enums: GlEnum[];
     features: GlFeature[];
+    extensions: GlExtension[];
+    aliasTargets: Map<string, string[]>;
+    bitmaskGroups: Set<string>;
 };
 declare const loadGlRegistry: (path: string) => GlRegistry;
-export { loadGlRegistry, type GlParam, type GlCommand, type GlEnum, type GlInterfaceBlock, type GlFeature, type GlRegistry, };
+export { loadGlRegistry, type GlParam, type GlGlx, type GlCommand, type GlEnum, type GlInterfaceBlock, type GlFeature, type GlExtension, type GlType, type GlRegistry, };
 //# sourceMappingURL=model.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/khronos/model.ts"],"names":[],"mappings":"AAEA,KAAK,OAAO,GAAG;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,KAAK,SAAS,GAAG;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,EAAE,CAAC;CACrB,CAAC;AAEF,KAAK,MAAM,GAAG;IACV,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,KAAK,SAAS,GAAG;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC/B,CAAC;AAEF,KAAK,UAAU,GAAG;IACd,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,SAAS,EAAE,CAAC;CACzB,CAAC;AA+MF,QAAA,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,UAQtC,CAAC;AAEF,OAAO,EACH,cAAc,EACd,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,MAAM,EACX,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,UAAU,GAClB,CAAC"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/khronos/model.ts"],"names":[],"mappings":"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"}