@gtkx/codegen 1.0.0-rc.4 → 1.0.0

package/dist/khronos/plan.js

@@ -190,11 +190,11 @@ const planCommand = (command, policy) => {
     for (const param of command.params) {
         const outcome = planParam(command, param, policy);
         if ("reason" in outcome) {
-            return { ok: false, command, reason: outcome.reason };
+            return { isOk: false, command, reason: outcome.reason };
         }
         params.push(outcome.plan);
     }
-    return { ok: true, command, params, returnPlan: planReturn(command) };
+    return { isOk: true, command, params, returnPlan: planReturn(command) };
 };
 export { GL_SCALARS, parseCType, planCommand, };
 //# sourceMappingURL=plan.js.map

package/dist/khronos/plan.js.map

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

package/dist/khronos/render.d.ts

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

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

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

package/dist/khronos/render.js

@@ -1,7 +1,8 @@
-import { lowerFirst, sourceStringLiteral, toCamelIdentifier } from "@gtkx/utils";
+import { sourceStringLiteral, toCamelIdentifier } from "@gtkx/utils";
 import { tBind, tInlineStruct, tRef, tString, tUint8, tVoid } from "../analysis/descriptor.js";
-import { planArgs, scalarAliasOrGroup, scalarPrefixArgs, trackInto } from "./args.js";
-import { commandJsDoc, inParamDocLine, singularJsDoc } from "./jsdoc.js";
+import { planArgs, returnPlanTsType, scalarPrefixArgs, trackInto } from "./args.js";
+import { commandJsDoc, derivedJsDoc, inParamDocLine } from "./jsdoc.js";
+import { commandExportName } from "./notes.js";
 const GL_LIB_EXPRESSION = "LIB";
 const GEN_FAMILY = /^gl(Gen|Create)[A-Z][A-Za-z]*s$/;
 const DELETE_FAMILY = /^glDelete[A-Z][A-Za-z]*s$/;
@@ -11,34 +12,29 @@ const glBind = (name, argList, returnType) => tBind({
     argList,
     returnType,
 });
-const commandExportName = (name) => toCamelIdentifier(name.startsWith("gl") ? lowerFirst(name.slice(2)) : name);
 const singularize = (plural) => plural.endsWith("ies") ? `${plural.slice(0, -3)}y` : plural.replace(/s$/, "");
 const renderDescriptorList = (descriptors) => descriptors.length === 0 ? "[]" : `[${descriptors.join(", ")}]`;
 const buildEmittedReturn = (plan, returnGroup, usedTypes) => {
-    const track = trackInto(usedTypes);
+    const tsType = trackInto(usedTypes)(returnPlanTsType(plan, returnGroup));
+    const cast = (call) => `${call} as ${tsType}`;
     switch (plan.kind) {
         case "void": {
-            return { tsType: "void", descriptor: tVoid };
+            return { tsType, descriptor: tVoid };
         }
         case "scalar": {
-            const alias = track(scalarAliasOrGroup(plan.scalar, returnGroup));
-            return { tsType: alias, descriptor: plan.scalar.descriptor, expr: (call) => `${call} as ${alias}` };
+            return { tsType, descriptor: plan.scalar.descriptor, expr: cast };
         }
         case "boolean": {
-            return { tsType: "boolean", descriptor: tUint8, expr: (call) => `(${call} as number) !== 0` };
+            return { tsType, descriptor: tUint8, expr: (call) => `(${call} as number) !== 0` };
         }
         case "string": {
-            return { tsType: "string", descriptor: tString("borrowed"), expr: (call) => `${call} as string` };
+            return { tsType, descriptor: tString("borrowed"), expr: cast };
         }
         case "sync": {
-            return { tsType: track("GLsync"), descriptor: tInlineStruct(), expr: (call) => `${call} as GLsync` };
+            return { tsType, descriptor: tInlineStruct(), expr: cast };
         }
         case "opaque-pointer": {
-            return {
-                tsType: track("GLpointer"),
-                descriptor: tInlineStruct(),
-                expr: (call) => `${call} as GLpointer`,
-            };
+            return { tsType, descriptor: tInlineStruct(), expr: cast };
         }
     }
 };
@@ -67,16 +63,16 @@ const returnStatements = (call, returned, outs) => {
     }
     return [`const result = ${call};`, `return [${returned.expr("result")}, ${outValues.join(", ")}];`];
 };
-const renderCommand = (plan, feature, usedTypes) => {
+const renderCommand = (plan, provenance, usedTypes, docs) => {
     const { command } = plan;
     const exportName = commandExportName(command.name);
     const { args, ins, outs } = planArgs(plan, usedTypes);
     const returned = buildEmittedReturn(plan.returnPlan, command.returnGroup, usedTypes);
     const signature = ins.map((arg) => `${arg.name}: ${arg.tsType}`).join(", ");
-    const argNames = args.map((arg) => (arg.out ? arg.cellName : arg.name)).join(", ");
+    const argNames = args.map((arg) => (arg.isOut ? arg.cellName : arg.name)).join(", ");
     const descriptors = renderDescriptorList(args.map((arg) => arg.descriptor));
     const tsReturn = returnTsType(returned, outs);
-    const jsDoc = commandJsDoc({ command, feature, ins, outs, returnPlan: plan.returnPlan });
+    const jsDoc = commandJsDoc({ plan, provenance, ins, outs, docs });
     const seeds = outs.map((out) => out.seed);
     const bindExpression = glBind(command.name, descriptors, returned.descriptor);
     const isInline = plan.params.some((paramPlan) => paramPlan.kind === "string-out");
@@ -94,7 +90,13 @@ const renderCommand = (plan, feature, usedTypes) => {
         declaration: `${jsDoc}\nexport function ${exportName}(${signature}): ${tsReturn} {\n${body}\n}`,
     };
 };
-const singularCommandJsDoc = (plan, feature, summary, body) => singularJsDoc({ commandName: plan.command.name, feature, summary, body });
+const singularCommandJsDoc = (context, summary, body) => derivedJsDoc({
+    command: context.plan.command,
+    provenance: context.provenance,
+    docs: context.docs,
+    summary,
+    body,
+});
 const genSingularScalars = (plan) => {
     const countPlan = plan.params.at(-2);
     if (countPlan?.kind !== "scalar") {
@@ -128,7 +130,15 @@ const genSingularShape = (plan) => {
     }
     return { countScalar: scalars.countScalar, outScalar: scalars.outScalar, objectClass };
 };
-const deriveGenSingular = (plan, feature, usedTypes) => {
+const genSingularJsDoc = (context, prefix, shape) => {
+    const { command } = context.plan;
+    return singularCommandJsDoc(context, `Returns one ${shape.objectClass} object name via ` +
+        `\`${command.name}(${prefix.length > 0 ? "..., " : ""}1, ...)\`.`, [
+        ...prefix.map((arg) => inParamDocLine(context.plan, arg, context.docs)),
+        ` * @returns \`${shape.outScalar.tsAlias}\`, object class \`${shape.objectClass}\``,
+    ]);
+};
+const deriveGenSingular = (plan, provenance, usedTypes, docs) => {
     if (!GEN_FAMILY.test(plan.command.name)) {
         return undefined;
     }
@@ -140,15 +150,14 @@ const deriveGenSingular = (plan, feature, usedTypes) => {
     if (prefix === undefined) {
         return undefined;
     }
-    const { countScalar, outScalar, objectClass } = shape;
+    const { countScalar, outScalar } = shape;
     const exportName = singularize(commandExportName(plan.command.name));
     const bindingName = `${plan.command.name}Single`;
     const descriptors = [...prefix.map((arg) => arg.descriptor), countScalar.descriptor, tRef(outScalar.descriptor)];
     usedTypes.add(outScalar.tsAlias);
     const signature = prefix.map((arg) => `${arg.name}: ${arg.tsType}`).join(", ");
     const callArgs = [...prefix.map((arg) => arg.name), "1", "out"].join(", ");
-    const jsDoc = singularCommandJsDoc(plan, feature, `Returns one ${objectClass} object name via ` +
-        `\`${plan.command.name}(${prefix.length > 0 ? "..., " : ""}1, ...)\`.`, [...prefix.map((arg) => inParamDocLine(plan.command, arg)), ` * @returns The new ${objectClass} object name`]);
+    const jsDoc = genSingularJsDoc({ plan, provenance, docs }, prefix, shape);
     const body = ["    const out = { value: 0 };", `    ${bindingName}(${callArgs});`, "    return out.value;"].join("\n");
     const binding = glBind(plan.command.name, renderDescriptorList(descriptors), tVoid);
     return {
@@ -180,7 +189,7 @@ const deleteSingularObjectClass = (plan) => {
     }
     return arrayParam.objectClass;
 };
-const deriveDeleteSingular = (plan, feature, usedTypes) => {
+const deriveDeleteSingular = (plan, provenance, usedTypes, docs) => {
     if (!DELETE_FAMILY.test(plan.command.name)) {
         return undefined;
     }
@@ -194,7 +203,7 @@ const deriveDeleteSingular = (plan, feature, usedTypes) => {
     }
     usedTypes.add(scalarAlias);
     const exportName = singularize(commandExportName(plan.command.name));
-    const jsDoc = singularCommandJsDoc(plan, feature, `Deletes one ${objectClass} object name via \`${plan.command.name}(1, ...)\`.`, [` * @param name - The ${objectClass} object name to delete`]);
+    const jsDoc = singularCommandJsDoc({ plan, provenance, docs }, `Deletes one ${objectClass} object name via \`${plan.command.name}(1, ...)\`.`, [` * @param name - \`${scalarAlias}\`, object class \`${objectClass}\``]);
     return {
         exportName,
         declaration: `${jsDoc}\nexport function ${exportName}(name: ${scalarAlias}): void {\n` +

package/dist/khronos/render.js.map

@@ -1 +1 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/khronos/render.ts"],"names":[],"mappings":"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","sourcesContent":["import { lowerFirst, sourceStringLiteral, toCamelIdentifier } from \"@gtkx/utils\";\nimport type { CommandPlan, GlScalar, ReturnPlan } from \"./plan.js\";\nimport { tBind, tInlineStruct, tRef, tString, tUint8, tVoid } from \"../analysis/descriptor.js\";\nimport { type OutArg, planArgs, scalarAliasOrGroup, scalarPrefixArgs, trackInto } from \"./args.js\";\nimport { commandJsDoc, inParamDocLine, singularJsDoc } from \"./jsdoc.js\";\n\ntype RenderedCommand = {\n    exportName: string;\n    binding?: string;\n    declaration: string;\n};\n\ntype EmittedReturn = {\n    tsType: string;\n    descriptor: string;\n    expr?: (call: string) => string;\n};\n\ntype GenSingularShape = {\n    countScalar: GlScalar;\n    outScalar: GlScalar;\n    objectClass: string;\n};\n\nconst GL_LIB_EXPRESSION = \"LIB\";\nconst GEN_FAMILY = /^gl(Gen|Create)[A-Z][A-Za-z]*s$/;\nconst DELETE_FAMILY = /^glDelete[A-Z][A-Za-z]*s$/;\n\nconst glBind = (name: string, argList: string, returnType: string): string =>\n    tBind({\n        libExpr: GL_LIB_EXPRESSION,\n        symbolExpr: sourceStringLiteral(name),\n        argList,\n        returnType,\n    });\n\nconst commandExportName = (name: string): string =>\n    toCamelIdentifier(name.startsWith(\"gl\") ? lowerFirst(name.slice(2)) : name);\n\nconst singularize = (plural: string): string =>\n    plural.endsWith(\"ies\") ? `${plural.slice(0, -3)}y` : plural.replace(/s$/, \"\");\n\nconst renderDescriptorList = (descriptors: string[]): string =>\n    descriptors.length === 0 ? \"[]\" : `[${descriptors.join(\", \")}]`;\n\nconst buildEmittedReturn = (\n    plan: ReturnPlan,\n    returnGroup: string | undefined,\n    usedTypes: Set<string>,\n): EmittedReturn => {\n    const track = trackInto(usedTypes);\n\n    switch (plan.kind) {\n        case \"void\": {\n            return { tsType: \"void\", descriptor: tVoid };\n        }\n        case \"scalar\": {\n            const alias = track(scalarAliasOrGroup(plan.scalar, returnGroup));\n\n            return { tsType: alias, descriptor: plan.scalar.descriptor, expr: (call) => `${call} as ${alias}` };\n        }\n        case \"boolean\": {\n            return { tsType: \"boolean\", descriptor: tUint8, expr: (call) => `(${call} as number) !== 0` };\n        }\n        case \"string\": {\n            return { tsType: \"string\", descriptor: tString(\"borrowed\"), expr: (call) => `${call} as string` };\n        }\n        case \"sync\": {\n            return { tsType: track(\"GLsync\"), descriptor: tInlineStruct(), expr: (call) => `${call} as GLsync` };\n        }\n        case \"opaque-pointer\": {\n            return {\n                tsType: track(\"GLpointer\"),\n                descriptor: tInlineStruct(),\n                expr: (call) => `${call} as GLpointer`,\n            };\n        }\n    }\n};\n\nconst returnTsType = (returned: EmittedReturn, outs: OutArg[]): string => {\n    if (outs.length === 0) {\n        return returned.tsType;\n    }\n\n    const outTypes = outs.map((out) => out.tsType);\n\n    if (returned.expr === undefined) {\n        return outTypes.length === 1 && outTypes[0] !== undefined ? outTypes[0] : `[${outTypes.join(\", \")}]`;\n    }\n\n    return `[${returned.tsType}, ${outTypes.join(\", \")}]`;\n};\n\nconst returnNoOut = (call: string, returned: EmittedReturn): string[] =>\n    returned.expr === undefined ? [`${call};`] : [`return ${returned.expr(call)};`];\n\nconst returnStatements = (call: string, returned: EmittedReturn, outs: OutArg[]): string[] => {\n    if (outs.length === 0) {\n        return returnNoOut(call, returned);\n    }\n\n    const outValues = outs.map((out) => `${out.cellName}.value`);\n\n    if (returned.expr === undefined) {\n        const [single] = outValues;\n\n        const tail =\n            single !== undefined && outValues.length === 1\n                ? `return ${single};`\n                : `return [${outValues.join(\", \")}];`;\n\n        return [`${call};`, tail];\n    }\n\n    return [`const result = ${call};`, `return [${returned.expr(\"result\")}, ${outValues.join(\", \")}];`];\n};\n\nconst renderCommand = (\n    plan: CommandPlan & { ok: true },\n    feature: string,\n    usedTypes: Set<string>,\n): RenderedCommand => {\n    const { command } = plan;\n    const exportName = commandExportName(command.name);\n    const { args, ins, outs } = planArgs(plan, usedTypes);\n    const returned = buildEmittedReturn(plan.returnPlan, command.returnGroup, usedTypes);\n    const signature = ins.map((arg) => `${arg.name}: ${arg.tsType}`).join(\", \");\n    const argNames = args.map((arg) => (arg.out ? arg.cellName : arg.name)).join(\", \");\n    const descriptors = renderDescriptorList(args.map((arg) => arg.descriptor));\n    const tsReturn = returnTsType(returned, outs);\n    const jsDoc = commandJsDoc({ command, feature, ins, outs, returnPlan: plan.returnPlan });\n    const seeds = outs.map((out) => out.seed);\n    const bindExpression = glBind(command.name, descriptors, returned.descriptor);\n    const isInline = plan.params.some((paramPlan) => paramPlan.kind === \"string-out\");\n    const bindingName = isInline ? \"binding\" : toCamelIdentifier(command.name);\n\n    const body = [\n        ...seeds,\n        ...(isInline ? [`const ${bindingName} = ${bindExpression};`] : []),\n        ...returnStatements(`${bindingName}(${argNames})`, returned, outs),\n    ]\n        .map((line) => `    ${line}`)\n        .join(\"\\n\");\n\n    return {\n        exportName,\n        ...(!isInline && { binding: `const ${bindingName} = ${bindExpression};` }),\n        declaration: `${jsDoc}\\nexport function ${exportName}(${signature}): ${tsReturn} {\\n${body}\\n}`,\n    };\n};\n\nconst singularCommandJsDoc = (\n    plan: CommandPlan & { ok: true },\n    feature: string,\n    summary: string,\n    body: string[],\n): string => singularJsDoc({ commandName: plan.command.name, feature, summary, body });\n\nconst genSingularScalars = (\n    plan: CommandPlan & { ok: true },\n): { countScalar: GlScalar; outScalar: GlScalar; lenParamName: string } | undefined => {\n    const countPlan = plan.params.at(-2);\n\n    if (countPlan?.kind !== \"scalar\") {\n        return undefined;\n    }\n\n    const outPlan = plan.params.at(-1);\n\n    if (outPlan?.kind !== \"ref-array-out\") {\n        return undefined;\n    }\n\n    return { countScalar: countPlan.scalar, outScalar: outPlan.scalar, lenParamName: outPlan.lenParamName };\n};\n\nconst genSingularObjectClass = (plan: CommandPlan & { ok: true }, lenParamName: string): string | undefined => {\n    const countParam = plan.command.params[plan.params.length - 2];\n    const outParam = plan.command.params[plan.params.length - 1];\n\n    if (countParam === undefined || outParam === undefined) {\n        return undefined;\n    }\n\n    if (lenParamName !== countParam.name) {\n        return undefined;\n    }\n\n    return outParam.objectClass;\n};\n\nconst genSingularShape = (plan: CommandPlan & { ok: true }): GenSingularShape | undefined => {\n    const scalars = genSingularScalars(plan);\n\n    if (scalars === undefined) {\n        return undefined;\n    }\n\n    const objectClass = genSingularObjectClass(plan, scalars.lenParamName);\n\n    if (objectClass === undefined) {\n        return undefined;\n    }\n\n    return { countScalar: scalars.countScalar, outScalar: scalars.outScalar, objectClass };\n};\n\nconst deriveGenSingular = (\n    plan: CommandPlan & { ok: true },\n    feature: string,\n    usedTypes: Set<string>,\n): RenderedCommand | undefined => {\n    if (!GEN_FAMILY.test(plan.command.name)) {\n        return undefined;\n    }\n\n    const shape = genSingularShape(plan);\n\n    if (shape === undefined) {\n        return undefined;\n    }\n\n    const prefix = scalarPrefixArgs(plan, usedTypes);\n\n    if (prefix === undefined) {\n        return undefined;\n    }\n\n    const { countScalar, outScalar, objectClass } = shape;\n    const exportName = singularize(commandExportName(plan.command.name));\n    const bindingName = `${plan.command.name}Single`;\n    const descriptors = [...prefix.map((arg) => arg.descriptor), countScalar.descriptor, tRef(outScalar.descriptor)];\n    usedTypes.add(outScalar.tsAlias);\n    const signature = prefix.map((arg) => `${arg.name}: ${arg.tsType}`).join(\", \");\n    const callArgs = [...prefix.map((arg) => arg.name), \"1\", \"out\"].join(\", \");\n\n    const jsDoc = singularCommandJsDoc(\n        plan,\n        feature,\n        `Returns one ${objectClass} object name via ` +\n        `\\`${plan.command.name}(${prefix.length > 0 ? \"..., \" : \"\"}1, ...)\\`.`,\n        [...prefix.map((arg) => inParamDocLine(plan.command, arg)), ` * @returns The new ${objectClass} object name`],\n    );\n\n    const body = [\"    const out = { value: 0 };\", `    ${bindingName}(${callArgs});`, \"    return out.value;\"].join(\n        \"\\n\",\n    );\n\n    const binding = glBind(plan.command.name, renderDescriptorList(descriptors), tVoid);\n\n    return {\n        exportName,\n        binding: `const ${bindingName} = ${binding};`,\n        declaration: `${jsDoc}\\nexport function ${exportName}(${signature}): ${outScalar.tsAlias} {\\n${body}\\n}`,\n    };\n};\n\nconst deleteSingularAlias = (plan: CommandPlan & { ok: true }): string | undefined => {\n    if (plan.params.length !== 2) {\n        return undefined;\n    }\n\n    const [countPlan, arrayPlan] = plan.params;\n\n    if (countPlan?.kind !== \"scalar\") {\n        return undefined;\n    }\n\n    if (arrayPlan?.kind !== \"array-in\") {\n        return undefined;\n    }\n\n    return arrayPlan.scalar.tsAlias;\n};\n\nconst deleteSingularObjectClass = (plan: CommandPlan & { ok: true }): string | undefined => {\n    const [countParam, arrayParam] = plan.command.params;\n\n    if (countParam === undefined || arrayParam === undefined) {\n        return undefined;\n    }\n\n    if (arrayParam.len !== countParam.name) {\n        return undefined;\n    }\n\n    return arrayParam.objectClass;\n};\n\nconst deriveDeleteSingular = (\n    plan: CommandPlan & { ok: true },\n    feature: string,\n    usedTypes: Set<string>,\n): RenderedCommand | undefined => {\n    if (!DELETE_FAMILY.test(plan.command.name)) {\n        return undefined;\n    }\n\n    const scalarAlias = deleteSingularAlias(plan);\n\n    if (scalarAlias === undefined) {\n        return undefined;\n    }\n\n    const objectClass = deleteSingularObjectClass(plan);\n\n    if (objectClass === undefined) {\n        return undefined;\n    }\n\n    usedTypes.add(scalarAlias);\n    const exportName = singularize(commandExportName(plan.command.name));\n\n    const jsDoc = singularCommandJsDoc(\n        plan,\n        feature,\n        `Deletes one ${objectClass} object name via \\`${plan.command.name}(1, ...)\\`.`,\n        [` * @param name - The ${objectClass} object name to delete`],\n    );\n\n    return {\n        exportName,\n        declaration:\n            `${jsDoc}\\nexport function ${exportName}(name: ${scalarAlias}): void {\\n` +\n            `    ${plan.command.name}(1, [name]);\\n}`,\n    };\n};\n\nexport { renderCommand, deriveGenSingular, deriveDeleteSingular, type RenderedCommand };\n"]}
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/khronos/render.ts"],"names":[],"mappings":"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","sourcesContent":["import { sourceStringLiteral, toCamelIdentifier } from \"@gtkx/utils\";\nimport type { GlDocContext } from \"./doc-context.js\";\nimport type { CommandPlan, GlScalar, ReturnPlan } from \"./plan.js\";\nimport type { GlSymbolProvenance } from \"./select.js\";\nimport { tBind, tInlineStruct, tRef, tString, tUint8, tVoid } from \"../analysis/descriptor.js\";\nimport { type InArg, type OutArg, planArgs, returnPlanTsType, scalarPrefixArgs, trackInto } from \"./args.js\";\nimport { commandJsDoc, derivedJsDoc, inParamDocLine } from \"./jsdoc.js\";\nimport { commandExportName } from \"./notes.js\";\n\ntype RenderedCommand = {\n    exportName: string;\n    binding?: string;\n    declaration: string;\n};\n\ntype SingularContext = {\n    plan: CommandPlan & { isOk: true };\n    provenance: GlSymbolProvenance;\n    docs: GlDocContext;\n};\n\ntype EmittedReturn = {\n    tsType: string;\n    descriptor: string;\n    expr?: (call: string) => string;\n};\n\ntype GenSingularShape = {\n    countScalar: GlScalar;\n    outScalar: GlScalar;\n    objectClass: string;\n};\n\nconst GL_LIB_EXPRESSION = \"LIB\";\nconst GEN_FAMILY = /^gl(Gen|Create)[A-Z][A-Za-z]*s$/;\nconst DELETE_FAMILY = /^glDelete[A-Z][A-Za-z]*s$/;\n\nconst glBind = (name: string, argList: string, returnType: string): string =>\n    tBind({\n        libExpr: GL_LIB_EXPRESSION,\n        symbolExpr: sourceStringLiteral(name),\n        argList,\n        returnType,\n    });\n\nconst singularize = (plural: string): string =>\n    plural.endsWith(\"ies\") ? `${plural.slice(0, -3)}y` : plural.replace(/s$/, \"\");\n\nconst renderDescriptorList = (descriptors: string[]): string =>\n    descriptors.length === 0 ? \"[]\" : `[${descriptors.join(\", \")}]`;\n\nconst buildEmittedReturn = (\n    plan: ReturnPlan,\n    returnGroup: string | undefined,\n    usedTypes: Set<string>,\n): EmittedReturn => {\n    const tsType = trackInto(usedTypes)(returnPlanTsType(plan, returnGroup));\n    const cast = (call: string): string => `${call} as ${tsType}`;\n\n    switch (plan.kind) {\n        case \"void\": {\n            return { tsType, descriptor: tVoid };\n        }\n        case \"scalar\": {\n            return { tsType, descriptor: plan.scalar.descriptor, expr: cast };\n        }\n        case \"boolean\": {\n            return { tsType, descriptor: tUint8, expr: (call) => `(${call} as number) !== 0` };\n        }\n        case \"string\": {\n            return { tsType, descriptor: tString(\"borrowed\"), expr: cast };\n        }\n        case \"sync\": {\n            return { tsType, descriptor: tInlineStruct(), expr: cast };\n        }\n        case \"opaque-pointer\": {\n            return { tsType, descriptor: tInlineStruct(), expr: cast };\n        }\n    }\n};\n\nconst returnTsType = (returned: EmittedReturn, outs: OutArg[]): string => {\n    if (outs.length === 0) {\n        return returned.tsType;\n    }\n\n    const outTypes = outs.map((out) => out.tsType);\n\n    if (returned.expr === undefined) {\n        return outTypes.length === 1 && outTypes[0] !== undefined ? outTypes[0] : `[${outTypes.join(\", \")}]`;\n    }\n\n    return `[${returned.tsType}, ${outTypes.join(\", \")}]`;\n};\n\nconst returnNoOut = (call: string, returned: EmittedReturn): string[] =>\n    returned.expr === undefined ? [`${call};`] : [`return ${returned.expr(call)};`];\n\nconst returnStatements = (call: string, returned: EmittedReturn, outs: OutArg[]): string[] => {\n    if (outs.length === 0) {\n        return returnNoOut(call, returned);\n    }\n\n    const outValues = outs.map((out) => `${out.cellName}.value`);\n\n    if (returned.expr === undefined) {\n        const [single] = outValues;\n\n        const tail =\n            single !== undefined && outValues.length === 1\n                ? `return ${single};`\n                : `return [${outValues.join(\", \")}];`;\n\n        return [`${call};`, tail];\n    }\n\n    return [`const result = ${call};`, `return [${returned.expr(\"result\")}, ${outValues.join(\", \")}];`];\n};\n\nconst renderCommand = (\n    plan: CommandPlan & { isOk: true },\n    provenance: GlSymbolProvenance,\n    usedTypes: Set<string>,\n    docs: GlDocContext,\n): RenderedCommand => {\n    const { command } = plan;\n    const exportName = commandExportName(command.name);\n    const { args, ins, outs } = planArgs(plan, usedTypes);\n    const returned = buildEmittedReturn(plan.returnPlan, command.returnGroup, usedTypes);\n    const signature = ins.map((arg) => `${arg.name}: ${arg.tsType}`).join(\", \");\n    const argNames = args.map((arg) => (arg.isOut ? arg.cellName : arg.name)).join(\", \");\n    const descriptors = renderDescriptorList(args.map((arg) => arg.descriptor));\n    const tsReturn = returnTsType(returned, outs);\n    const jsDoc = commandJsDoc({ plan, provenance, ins, outs, docs });\n    const seeds = outs.map((out) => out.seed);\n    const bindExpression = glBind(command.name, descriptors, returned.descriptor);\n    const isInline = plan.params.some((paramPlan) => paramPlan.kind === \"string-out\");\n    const bindingName = isInline ? \"binding\" : toCamelIdentifier(command.name);\n\n    const body = [\n        ...seeds,\n        ...(isInline ? [`const ${bindingName} = ${bindExpression};`] : []),\n        ...returnStatements(`${bindingName}(${argNames})`, returned, outs),\n    ]\n        .map((line) => `    ${line}`)\n        .join(\"\\n\");\n\n    return {\n        exportName,\n        ...(!isInline && { binding: `const ${bindingName} = ${bindExpression};` }),\n        declaration: `${jsDoc}\\nexport function ${exportName}(${signature}): ${tsReturn} {\\n${body}\\n}`,\n    };\n};\n\nconst singularCommandJsDoc = (context: SingularContext, summary: string, body: string[]): string =>\n    derivedJsDoc({\n        command: context.plan.command,\n        provenance: context.provenance,\n        docs: context.docs,\n        summary,\n        body,\n    });\n\nconst genSingularScalars = (\n    plan: CommandPlan & { isOk: true },\n): { countScalar: GlScalar; outScalar: GlScalar; lenParamName: string } | undefined => {\n    const countPlan = plan.params.at(-2);\n\n    if (countPlan?.kind !== \"scalar\") {\n        return undefined;\n    }\n\n    const outPlan = plan.params.at(-1);\n\n    if (outPlan?.kind !== \"ref-array-out\") {\n        return undefined;\n    }\n\n    return { countScalar: countPlan.scalar, outScalar: outPlan.scalar, lenParamName: outPlan.lenParamName };\n};\n\nconst genSingularObjectClass = (plan: CommandPlan & { isOk: true }, lenParamName: string): string | undefined => {\n    const countParam = plan.command.params[plan.params.length - 2];\n    const outParam = plan.command.params[plan.params.length - 1];\n\n    if (countParam === undefined || outParam === undefined) {\n        return undefined;\n    }\n\n    if (lenParamName !== countParam.name) {\n        return undefined;\n    }\n\n    return outParam.objectClass;\n};\n\nconst genSingularShape = (plan: CommandPlan & { isOk: true }): GenSingularShape | undefined => {\n    const scalars = genSingularScalars(plan);\n\n    if (scalars === undefined) {\n        return undefined;\n    }\n\n    const objectClass = genSingularObjectClass(plan, scalars.lenParamName);\n\n    if (objectClass === undefined) {\n        return undefined;\n    }\n\n    return { countScalar: scalars.countScalar, outScalar: scalars.outScalar, objectClass };\n};\n\nconst genSingularJsDoc = (context: SingularContext, prefix: InArg[], shape: GenSingularShape): string => {\n    const { command } = context.plan;\n\n    return singularCommandJsDoc(\n        context,\n        `Returns one ${shape.objectClass} object name via ` +\n        `\\`${command.name}(${prefix.length > 0 ? \"..., \" : \"\"}1, ...)\\`.`,\n        [\n            ...prefix.map((arg) => inParamDocLine(context.plan, arg, context.docs)),\n            ` * @returns \\`${shape.outScalar.tsAlias}\\`, object class \\`${shape.objectClass}\\``,\n        ],\n    );\n};\n\nconst deriveGenSingular = (\n    plan: CommandPlan & { isOk: true },\n    provenance: GlSymbolProvenance,\n    usedTypes: Set<string>,\n    docs: GlDocContext,\n): RenderedCommand | undefined => {\n    if (!GEN_FAMILY.test(plan.command.name)) {\n        return undefined;\n    }\n\n    const shape = genSingularShape(plan);\n\n    if (shape === undefined) {\n        return undefined;\n    }\n\n    const prefix = scalarPrefixArgs(plan, usedTypes);\n\n    if (prefix === undefined) {\n        return undefined;\n    }\n\n    const { countScalar, outScalar } = shape;\n    const exportName = singularize(commandExportName(plan.command.name));\n    const bindingName = `${plan.command.name}Single`;\n    const descriptors = [...prefix.map((arg) => arg.descriptor), countScalar.descriptor, tRef(outScalar.descriptor)];\n    usedTypes.add(outScalar.tsAlias);\n    const signature = prefix.map((arg) => `${arg.name}: ${arg.tsType}`).join(\", \");\n    const callArgs = [...prefix.map((arg) => arg.name), \"1\", \"out\"].join(\", \");\n    const jsDoc = genSingularJsDoc({ plan, provenance, docs }, prefix, shape);\n\n    const body = [\"    const out = { value: 0 };\", `    ${bindingName}(${callArgs});`, \"    return out.value;\"].join(\n        \"\\n\",\n    );\n\n    const binding = glBind(plan.command.name, renderDescriptorList(descriptors), tVoid);\n\n    return {\n        exportName,\n        binding: `const ${bindingName} = ${binding};`,\n        declaration: `${jsDoc}\\nexport function ${exportName}(${signature}): ${outScalar.tsAlias} {\\n${body}\\n}`,\n    };\n};\n\nconst deleteSingularAlias = (plan: CommandPlan & { isOk: true }): string | undefined => {\n    if (plan.params.length !== 2) {\n        return undefined;\n    }\n\n    const [countPlan, arrayPlan] = plan.params;\n\n    if (countPlan?.kind !== \"scalar\") {\n        return undefined;\n    }\n\n    if (arrayPlan?.kind !== \"array-in\") {\n        return undefined;\n    }\n\n    return arrayPlan.scalar.tsAlias;\n};\n\nconst deleteSingularObjectClass = (plan: CommandPlan & { isOk: true }): string | undefined => {\n    const [countParam, arrayParam] = plan.command.params;\n\n    if (countParam === undefined || arrayParam === undefined) {\n        return undefined;\n    }\n\n    if (arrayParam.len !== countParam.name) {\n        return undefined;\n    }\n\n    return arrayParam.objectClass;\n};\n\nconst deriveDeleteSingular = (\n    plan: CommandPlan & { isOk: true },\n    provenance: GlSymbolProvenance,\n    usedTypes: Set<string>,\n    docs: GlDocContext,\n): RenderedCommand | undefined => {\n    if (!DELETE_FAMILY.test(plan.command.name)) {\n        return undefined;\n    }\n\n    const scalarAlias = deleteSingularAlias(plan);\n\n    if (scalarAlias === undefined) {\n        return undefined;\n    }\n\n    const objectClass = deleteSingularObjectClass(plan);\n\n    if (objectClass === undefined) {\n        return undefined;\n    }\n\n    usedTypes.add(scalarAlias);\n    const exportName = singularize(commandExportName(plan.command.name));\n\n    const jsDoc = singularCommandJsDoc(\n        { plan, provenance, docs },\n        `Deletes one ${objectClass} object name via \\`${plan.command.name}(1, ...)\\`.`,\n        [` * @param name - \\`${scalarAlias}\\`, object class \\`${objectClass}\\``],\n    );\n\n    return {\n        exportName,\n        declaration:\n            `${jsDoc}\\nexport function ${exportName}(name: ${scalarAlias}): void {\\n` +\n            `    ${plan.command.name}(1, [name]);\\n}`,\n    };\n};\n\nexport { renderCommand, deriveGenSingular, deriveDeleteSingular, type RenderedCommand };\n"]}

package/dist/khronos/select.d.ts

@@ -5,11 +5,28 @@ type GlSelection = {
     version: number;
     profile: GlProfile;
 };
+type GlSymbolKind = "command" | "enum";
+type GlRemoval = {
+    feature: string;
+    comment?: string;
+};
+type GlSymbolProvenance = {
+    feature: string;
+    requireComment?: string;
+    removals: GlRemoval[];
+};
+type GlRemovedSymbol = {
+    name: string;
+    kind: GlSymbolKind;
+    feature: string;
+    comment?: string;
+};
 type GlSubset = {
-    commands: Map<string, string>;
-    enums: Map<string, string>;
+    commands: Map<string, GlSymbolProvenance>;
+    enums: Map<string, GlSymbolProvenance>;
+    removed: GlRemovedSymbol[];
 };
 declare const selectSubset: (registry: GlRegistry, selection: GlSelection) => GlSubset;
-declare const resolveEnum: (registry: GlRegistry, name: string) => GlEnum;
-export { selectSubset, resolveEnum, type GlSelection };
+declare const resolveEnum: (registry: GlRegistry, name: string, api: string) => GlEnum;
+export { selectSubset, resolveEnum, type GlRemoval, type GlSelection, type GlSubset, type GlSymbolProvenance };
 //# sourceMappingURL=select.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../src/khronos/select.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAA+B,UAAU,EAAE,MAAM,YAAY,CAAC;AAElF,KAAK,SAAS,GAAG,MAAM,CAAC;AAExB,KAAK,WAAW,GAAG;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF,KAAK,QAAQ,GAAG;IACZ,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B,CAAC;AAsDF,QAAA,MAAM,YAAY,GAAI,UAAU,UAAU,EAAE,WAAW,WAAW,KAAG,QAiBpE,CAAC;AAEF,QAAA,MAAM,WAAW,GAAI,UAAU,UAAU,EAAE,MAAM,MAAM,KAAG,MAQzD,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,CAAC"}
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../src/khronos/select.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAA+B,UAAU,EAAE,MAAM,YAAY,CAAC;AAElF,KAAK,SAAS,GAAG,MAAM,CAAC;AAExB,KAAK,WAAW,GAAG;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF,KAAK,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;AAEvC,KAAK,SAAS,GAAG;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,SAAS,EAAE,CAAC;CACzB,CAAC;AAEF,KAAK,eAAe,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,KAAK,QAAQ,GAAG;IACZ,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC1C,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACvC,OAAO,EAAE,eAAe,EAAE,CAAC;CAC9B,CAAC;AAmEF,QAAA,MAAM,YAAY,GAAI,UAAU,UAAU,EAAE,WAAW,WAAW,KAAG,QAqBpE,CAAC;AAEF,QAAA,MAAM,WAAW,GAAI,UAAU,UAAU,EAAE,MAAM,MAAM,EAAE,KAAK,MAAM,KAAG,MAUtE,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EAAE,CAAC"}

package/dist/khronos/select.js

@@ -1,52 +1,65 @@
-const isBlockApplicable = (block, selection) => block.profile === undefined || block.profile === selection.profile;
-const addMissing = (target, names, value) => {
-    for (const name of names) {
-        if (!target.has(name)) {
-            target.set(name, value);
-        }
+import { sortStringsBy } from "@gtkx/utils";
+const isBlockApplicable = (block, selection) => (block.profile === undefined || block.profile === selection.profile) &&
+    (block.api === undefined || block.api === selection.api);
+const targetFor = (state, kind) => kind === "command" ? state.commands : state.enums;
+const commentEntry = (comment) => comment === undefined ? {} : { comment };
+const requireMember = (state, name, context) => {
+    const target = targetFor(state, context.kind);
+    if (target.has(name)) {
+        return;
     }
+    const { block, feature } = context;
+    target.set(name, {
+        feature: feature.name,
+        ...(block.comment !== undefined && { requireComment: block.comment }),
+        removals: [...(state.history.get(name) ?? [])],
+    });
 };
-const applyRequires = (feature, selection, commands, enums) => {
-    for (const block of feature.requires) {
-        if (!isBlockApplicable(block, selection)) {
-            continue;
-        }
-        addMissing(commands, block.commands, feature.name);
-        addMissing(enums, block.enums, feature.name);
-    }
+const removeMember = (state, name, context) => {
+    const { block, feature, kind } = context;
+    const removal = { feature: feature.name, ...commentEntry(block.comment) };
+    targetFor(state, kind).delete(name);
+    state.history.set(name, [...(state.history.get(name) ?? []), removal]);
+    state.removed.push({ name, kind, ...removal });
 };
-const removeBlock = (block, commands, enums) => {
-    for (const name of block.commands) {
-        commands.delete(name);
-    }
-    for (const name of block.enums) {
-        enums.delete(name);
+const applyMembers = (state, names, context) => {
+    const apply = context.block.kind === "require" ? requireMember : removeMember;
+    for (const name of names) {
+        apply(state, name, context);
     }
 };
-const applyRemoves = (feature, selection, commands, enums) => {
-    for (const block of feature.removes) {
-        if (!isBlockApplicable(block, selection)) {
-            continue;
+const applyBlock = (state, feature, block) => {
+    applyMembers(state, block.commands, { feature, block, kind: "command" });
+    applyMembers(state, block.enums, { feature, block, kind: "enum" });
+};
+const applyFeature = (state, feature, selection) => {
+    for (const block of feature.blocks) {
+        if (isBlockApplicable(block, selection)) {
+            applyBlock(state, feature, block);
         }
-        removeBlock(block, commands, enums);
     }
 };
 const selectSubset = (registry, selection) => {
     const features = registry.features
         .filter((feature) => feature.api === selection.api && feature.number <= selection.version)
         .toSorted((a, b) => a.number - b.number);
-    const commands = new Map();
-    const enums = new Map();
-    for (const feature of features) {
-        applyRequires(feature, selection, commands, enums);
-    }
+    const state = {
+        commands: new Map(),
+        enums: new Map(),
+        removed: [],
+        history: new Map(),
+    };
     for (const feature of features) {
-        applyRemoves(feature, selection, commands, enums);
+        applyFeature(state, feature, selection);
     }
-    return { commands, enums };
+    return {
+        commands: state.commands,
+        enums: state.enums,
+        removed: sortStringsBy(state.removed, (entry) => entry.name),
+    };
 };
-const resolveEnum = (registry, name) => {
-    const found = registry.enums.find((candidate) => candidate.name === name);
+const resolveEnum = (registry, name, api) => {
+    const found = registry.enums.find((candidate) => candidate.name === name && (candidate.api === undefined || candidate.api === api));
     if (found === undefined) {
         throw new Error(`Enum token ${name} has no definition in the registry`);
     }

package/dist/khronos/select.js.map

@@ -1 +1 @@
-{"version":3,"file":"select.js","sourceRoot":"","sources":["../../src/khronos/select.ts"],"names":[],"mappings":"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","sourcesContent":["import type { GlEnum, GlFeature, GlInterfaceBlock, GlRegistry } from \"./model.js\";\n\ntype GlProfile = \"core\";\n\ntype GlSelection = {\n    api: string;\n    version: number;\n    profile: GlProfile;\n};\n\ntype GlSubset = {\n    commands: Map<string, string>;\n    enums: Map<string, string>;\n};\n\nconst isBlockApplicable = (block: GlInterfaceBlock, selection: GlSelection): boolean =>\n    block.profile === undefined || block.profile === selection.profile;\n\nconst addMissing = (target: Map<string, string>, names: string[], value: string): void => {\n    for (const name of names) {\n        if (!target.has(name)) {\n            target.set(name, value);\n        }\n    }\n};\n\nconst applyRequires = (\n    feature: GlFeature,\n    selection: GlSelection,\n    commands: Map<string, string>,\n    enums: Map<string, string>,\n): void => {\n    for (const block of feature.requires) {\n        if (!isBlockApplicable(block, selection)) {\n            continue;\n        }\n\n        addMissing(commands, block.commands, feature.name);\n        addMissing(enums, block.enums, feature.name);\n    }\n};\n\nconst removeBlock = (block: GlInterfaceBlock, commands: Map<string, string>, enums: Map<string, string>): void => {\n    for (const name of block.commands) {\n        commands.delete(name);\n    }\n\n    for (const name of block.enums) {\n        enums.delete(name);\n    }\n};\n\nconst applyRemoves = (\n    feature: GlFeature,\n    selection: GlSelection,\n    commands: Map<string, string>,\n    enums: Map<string, string>,\n): void => {\n    for (const block of feature.removes) {\n        if (!isBlockApplicable(block, selection)) {\n            continue;\n        }\n\n        removeBlock(block, commands, enums);\n    }\n};\n\nconst selectSubset = (registry: GlRegistry, selection: GlSelection): GlSubset => {\n    const features = registry.features\n        .filter((feature) => feature.api === selection.api && feature.number <= selection.version)\n        .toSorted((a, b) => a.number - b.number);\n\n    const commands: Map<string, string> = new Map();\n    const enums: Map<string, string> = new Map();\n\n    for (const feature of features) {\n        applyRequires(feature, selection, commands, enums);\n    }\n\n    for (const feature of features) {\n        applyRemoves(feature, selection, commands, enums);\n    }\n\n    return { commands, enums };\n};\n\nconst resolveEnum = (registry: GlRegistry, name: string): GlEnum => {\n    const found = registry.enums.find((candidate) => candidate.name === name);\n\n    if (found === undefined) {\n        throw new Error(`Enum token ${name} has no definition in the registry`);\n    }\n\n    return found;\n};\n\nexport { selectSubset, resolveEnum, type GlSelection };\n"]}
+{"version":3,"file":"select.js","sourceRoot":"","sources":["../../src/khronos/select.ts"],"names":[],"mappings":"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","sourcesContent":["import { sortStringsBy } from \"@gtkx/utils\";\nimport type { GlEnum, GlFeature, GlInterfaceBlock, GlRegistry } from \"./model.js\";\n\ntype GlProfile = \"core\";\n\ntype GlSelection = {\n    api: string;\n    version: number;\n    profile: GlProfile;\n};\n\ntype GlSymbolKind = \"command\" | \"enum\";\n\ntype GlRemoval = {\n    feature: string;\n    comment?: string;\n};\n\ntype GlSymbolProvenance = {\n    feature: string;\n    requireComment?: string;\n    removals: GlRemoval[];\n};\n\ntype GlRemovedSymbol = {\n    name: string;\n    kind: GlSymbolKind;\n    feature: string;\n    comment?: string;\n};\n\ntype GlSubset = {\n    commands: Map<string, GlSymbolProvenance>;\n    enums: Map<string, GlSymbolProvenance>;\n    removed: GlRemovedSymbol[];\n};\n\ntype SelectionState = GlSubset & {\n    history: Map<string, GlRemoval[]>;\n};\n\ntype MemberContext = {\n    feature: GlFeature;\n    block: GlInterfaceBlock;\n    kind: GlSymbolKind;\n};\n\nconst isBlockApplicable = (block: GlInterfaceBlock, selection: GlSelection): boolean =>\n    (block.profile === undefined || block.profile === selection.profile) &&\n    (block.api === undefined || block.api === selection.api);\n\nconst targetFor = (state: SelectionState, kind: GlSymbolKind): Map<string, GlSymbolProvenance> =>\n    kind === \"command\" ? state.commands : state.enums;\n\nconst commentEntry = (comment: string | undefined): { comment?: string } =>\n    comment === undefined ? {} : { comment };\n\nconst requireMember = (state: SelectionState, name: string, context: MemberContext): void => {\n    const target = targetFor(state, context.kind);\n\n    if (target.has(name)) {\n        return;\n    }\n\n    const { block, feature } = context;\n\n    target.set(name, {\n        feature: feature.name,\n        ...(block.comment !== undefined && { requireComment: block.comment }),\n        removals: [...(state.history.get(name) ?? [])],\n    });\n};\n\nconst removeMember = (state: SelectionState, name: string, context: MemberContext): void => {\n    const { block, feature, kind } = context;\n    const removal: GlRemoval = { feature: feature.name, ...commentEntry(block.comment) };\n    targetFor(state, kind).delete(name);\n    state.history.set(name, [...(state.history.get(name) ?? []), removal]);\n    state.removed.push({ name, kind, ...removal });\n};\n\nconst applyMembers = (state: SelectionState, names: string[], context: MemberContext): void => {\n    const apply = context.block.kind === \"require\" ? requireMember : removeMember;\n\n    for (const name of names) {\n        apply(state, name, context);\n    }\n};\n\nconst applyBlock = (state: SelectionState, feature: GlFeature, block: GlInterfaceBlock): void => {\n    applyMembers(state, block.commands, { feature, block, kind: \"command\" });\n    applyMembers(state, block.enums, { feature, block, kind: \"enum\" });\n};\n\nconst applyFeature = (state: SelectionState, feature: GlFeature, selection: GlSelection): void => {\n    for (const block of feature.blocks) {\n        if (isBlockApplicable(block, selection)) {\n            applyBlock(state, feature, block);\n        }\n    }\n};\n\nconst selectSubset = (registry: GlRegistry, selection: GlSelection): GlSubset => {\n    const features = registry.features\n        .filter((feature) => feature.api === selection.api && feature.number <= selection.version)\n        .toSorted((a, b) => a.number - b.number);\n\n    const state: SelectionState = {\n        commands: new Map(),\n        enums: new Map(),\n        removed: [],\n        history: new Map(),\n    };\n\n    for (const feature of features) {\n        applyFeature(state, feature, selection);\n    }\n\n    return {\n        commands: state.commands,\n        enums: state.enums,\n        removed: sortStringsBy(state.removed, (entry) => entry.name),\n    };\n};\n\nconst resolveEnum = (registry: GlRegistry, name: string, api: string): GlEnum => {\n    const found = registry.enums.find(\n        (candidate) => candidate.name === name && (candidate.api === undefined || candidate.api === api),\n    );\n\n    if (found === undefined) {\n        throw new Error(`Enum token ${name} has no definition in the registry`);\n    }\n\n    return found;\n};\n\nexport { selectSubset, resolveEnum, type GlRemoval, type GlSelection, type GlSubset, type GlSymbolProvenance };\n"]}

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

@@ -1,4 +1,4 @@
-import type { ModuleExport } from "@gtkx/react/internal";
+import type { ModuleExport } from "@gtkx/react/config";
 import type { OmittedProps } from "../store/jsx/omitted-props.js";
 /** The framework's built-in element config, split into the maps codegen consumes. */
 type BuiltinElements = {
@@ -21,6 +21,6 @@ type BuiltinElements = {
  * @param giStoreDir The gi store directory, whose subdirectories name the generated namespaces.
  */
 declare const readBuiltinElements: (reactSubexports: string[], giStoreDir: string) => Promise<BuiltinElements>;
-export type { ModuleExport } from "@gtkx/react/internal";
+export type { ModuleExport } from "@gtkx/react/config";
 export { readBuiltinElements, type BuiltinElements };
 //# sourceMappingURL=element-config.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"element-config.d.ts","sourceRoot":"","sources":["../../src/react/element-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAIlE,qFAAqF;AACrF,KAAK,eAAe,GAAG;IACnB,0GAA0G;IAC1G,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,+GAA+G;IAC/G,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,yFAAyF;IACzF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACpC,8EAA8E;IAC9E,YAAY,EAAE,YAAY,CAAC;CAC9B,CAAC;AA6DF;;;;;;;;GAQG;AACH,QAAA,MAAM,mBAAmB,GAAU,iBAAiB,MAAM,EAAE,EAAE,YAAY,MAAM,KAAG,OAAO,CAAC,eAAe,CAUzG,CAAC;AAEF,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,KAAK,eAAe,EAAE,CAAC"}
+{"version":3,"file":"element-config.d.ts","sourceRoot":"","sources":["../../src/react/element-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAIlE,qFAAqF;AACrF,KAAK,eAAe,GAAG;IACnB,0GAA0G;IAC1G,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,+GAA+G;IAC/G,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,yFAAyF;IACzF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACpC,8EAA8E;IAC9E,YAAY,EAAE,YAAY,CAAC;CAC9B,CAAC;AA6DF;;;;;;;;GAQG;AACH,QAAA,MAAM,mBAAmB,GAAU,iBAAiB,MAAM,EAAE,EAAE,YAAY,MAAM,KAAG,OAAO,CAAC,eAAe,CAUzG,CAAC;AAEF,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,KAAK,eAAe,EAAE,CAAC"}