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

package/dist/jsx.d.ts

@@ -0,0 +1,26 @@
+import type { Library } from "./gir/library.js";
+import { type ModuleExport } from "./react/element-config.js";
+import { type JsxStoreOptions } from "./store/jsx-store.js";
+type RunJsxCodegenOptions = {
+    getLibrary: () => Library;
+    jsx: JsxStoreOptions;
+    giStoreDir: string;
+    reactSubexports: string[];
+    userComponents: Record<string, ModuleExport>;
+    userLazyElements: string[];
+    userProps: Record<string, ModuleExport>;
+    giRegenerated: boolean;
+    force: boolean;
+};
+type RunJsxCodegenResult = {
+    regenerated: boolean;
+    intrinsicElementCount: number;
+};
+/**
+ * Generates the `@gtkx/jsx` store, reading the framework's built-in element config from the freshly
+ * linked `@gtkx/react` and layering the project's own element config over it. This is the react-importing
+ * half of codegen: it must run only after the gi store has been written and linked.
+ */
+declare const runJsxCodegen: (options: RunJsxCodegenOptions) => Promise<RunJsxCodegenResult>;
+export { runJsxCodegen, type RunJsxCodegenOptions, type RunJsxCodegenResult };
+//# sourceMappingURL=jsx.d.ts.map

package/dist/jsx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx.d.ts","sourceRoot":"","sources":["../src/jsx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAOhD,OAAO,EAAE,KAAK,YAAY,EAAuB,MAAM,2BAA2B,CAAC;AACnF,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,sBAAsB,CAAC;AAG3E,KAAK,oBAAoB,GAAG;IACxB,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,GAAG,EAAE,eAAe,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC7C,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxC,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,aAAa,GAAU,SAAS,oBAAoB,KAAG,OAAO,CAAC,mBAAmB,CAkCvF,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,CAAC"}

package/dist/jsx.js

@@ -0,0 +1,40 @@
+import { computeJsxFingerprint, FINGERPRINT_FILENAME, jsxStoreFreshness, } from "./fingerprint.js";
+import { readBuiltinElements } from "./react/element-config.js";
+import { writeJsxStore } from "./store/jsx-store.js";
+import { generateJsxFiles } from "./store/jsx/pipeline.js";
+/**
+ * Generates the `@gtkx/jsx` store, reading the framework's built-in element config from the freshly
+ * linked `@gtkx/react` and layering the project's own element config over it. This is the react-importing
+ * half of codegen: it must run only after the gi store has been written and linked.
+ */
+const runJsxCodegen = async (options) => {
+    const builtin = await readBuiltinElements(options.reactSubexports, options.giStoreDir);
+    const components = { ...builtin.components, ...options.userComponents };
+    const lazyElements = [...builtin.lazyElements, ...options.userLazyElements];
+    const props = { ...builtin.props, ...options.userProps };
+    const fingerprintInput = {
+        reactVersion: options.jsx.version,
+        components,
+        lazyElements,
+        props,
+    };
+    if (!options.force && !options.giRegenerated) {
+        const { fresh, intrinsicElementCount } = jsxStoreFreshness(options.jsx.storeDir, fingerprintInput);
+        if (fresh) {
+            return { regenerated: false, intrinsicElementCount };
+        }
+    }
+    const { namespaces, metadata, intrinsicElementCount } = generateJsxFiles(options.getLibrary(), {
+        reactSubexports: options.reactSubexports,
+        components,
+        lazyElements,
+        props,
+    });
+    writeJsxStore(options.jsx, namespaces, metadata, {
+        relativePath: FINGERPRINT_FILENAME,
+        content: `${JSON.stringify(computeJsxFingerprint(fingerprintInput, intrinsicElementCount), null, 2)}\n`,
+    });
+    return { regenerated: true, intrinsicElementCount };
+};
+export { runJsxCodegen };
+//# sourceMappingURL=jsx.js.map

package/dist/jsx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx.js","sourceRoot":"","sources":["../src/jsx.ts"],"names":[],"mappings":"AACA,OAAO,EACH,qBAAqB,EACrB,oBAAoB,EAEpB,iBAAiB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAqB,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,EAAwB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAmB3D;;;;GAIG;AACH,MAAM,aAAa,GAAG,KAAK,EAAE,OAA6B,EAAgC,EAAE;IACxF,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACvF,MAAM,UAAU,GAAG,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IACxE,MAAM,YAAY,GAAG,CAAC,GAAG,OAAO,CAAC,YAAY,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAEzD,MAAM,gBAAgB,GAAwB;QAC1C,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO;QACjC,UAAU;QACV,YAAY;QACZ,KAAK;KACR,CAAC;IAEF,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC3C,MAAM,EAAE,KAAK,EAAE,qBAAqB,EAAE,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QAEnG,IAAI,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC;QACzD,CAAC;IACL,CAAC;IAED,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,qBAAqB,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE;QAC3F,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,UAAU;QACV,YAAY;QACZ,KAAK;KACR,CAAC,CAAC;IAEH,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE;QAC7C,YAAY,EAAE,oBAAoB;QAClC,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC,gBAAgB,EAAE,qBAAqB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI;KAC1G,CAAC,CAAC;IAEH,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC;AACxD,CAAC,CAAC;AAEF,OAAO,EAAE,aAAa,EAAuD,CAAC","sourcesContent":["import type { Library } from \"./gir/library.js\";\nimport {\n    computeJsxFingerprint,\n    FINGERPRINT_FILENAME,\n    type JsxFingerprintInput,\n    jsxStoreFreshness,\n} from \"./fingerprint.js\";\nimport { type ModuleExport, readBuiltinElements } from \"./react/element-config.js\";\nimport { type JsxStoreOptions, writeJsxStore } from \"./store/jsx-store.js\";\nimport { generateJsxFiles } from \"./store/jsx/pipeline.js\";\n\ntype RunJsxCodegenOptions = {\n    getLibrary: () => Library;\n    jsx: JsxStoreOptions;\n    giStoreDir: string;\n    reactSubexports: string[];\n    userComponents: Record<string, ModuleExport>;\n    userLazyElements: string[];\n    userProps: Record<string, ModuleExport>;\n    giRegenerated: boolean;\n    force: boolean;\n};\n\ntype RunJsxCodegenResult = {\n    regenerated: boolean;\n    intrinsicElementCount: number;\n};\n\n/**\n * Generates the `@gtkx/jsx` store, reading the framework's built-in element config from the freshly\n * linked `@gtkx/react` and layering the project's own element config over it. This is the react-importing\n * half of codegen: it must run only after the gi store has been written and linked.\n */\nconst runJsxCodegen = async (options: RunJsxCodegenOptions): Promise<RunJsxCodegenResult> => {\n    const builtin = await readBuiltinElements(options.reactSubexports, options.giStoreDir);\n    const components = { ...builtin.components, ...options.userComponents };\n    const lazyElements = [...builtin.lazyElements, ...options.userLazyElements];\n    const props = { ...builtin.props, ...options.userProps };\n\n    const fingerprintInput: JsxFingerprintInput = {\n        reactVersion: options.jsx.version,\n        components,\n        lazyElements,\n        props,\n    };\n\n    if (!options.force && !options.giRegenerated) {\n        const { fresh, intrinsicElementCount } = jsxStoreFreshness(options.jsx.storeDir, fingerprintInput);\n\n        if (fresh) {\n            return { regenerated: false, intrinsicElementCount };\n        }\n    }\n\n    const { namespaces, metadata, intrinsicElementCount } = generateJsxFiles(options.getLibrary(), {\n        reactSubexports: options.reactSubexports,\n        components,\n        lazyElements,\n        props,\n    });\n\n    writeJsxStore(options.jsx, namespaces, metadata, {\n        relativePath: FINGERPRINT_FILENAME,\n        content: `${JSON.stringify(computeJsxFingerprint(fingerprintInput, intrinsicElementCount), null, 2)}\\n`,\n    });\n\n    return { regenerated: true, intrinsicElementCount };\n};\n\nexport { runJsxCodegen, type RunJsxCodegenOptions, type RunJsxCodegenResult };\n"]}

package/dist/khronos/args.d.ts

@@ -1,12 +1,11 @@
 import type { CommandPlan, GlScalar } from "./plan.js";
-export declare const scalarAliasOrGroup: (scalar: GlScalar, group: string | undefined) => string;
-export type InArg = {
+type InArg = {
     out: false;
     name: string;
     tsType: string;
     descriptor: string;
 };
-export type OutArg = {
+type OutArg = {
     out: true;
     cellName: string;
     seed: string;
@@ -15,16 +14,17 @@ export type OutArg = {
     paramIndex: number;
 };
 type PlannedArg = InArg | OutArg;
-export declare const trackInto: (usedTypes: Set<string>) => (alias: string) => string;
-export declare const planArgs: (plan: CommandPlan & {
+declare const scalarAliasOrGroup: (scalar: GlScalar, group: string | undefined) => string;
+declare const trackInto: (usedTypes: Set<string>) => (alias: string) => string;
+declare const planArgs: (plan: CommandPlan & {
     ok: true;
 }, usedTypes: Set<string>) => {
     args: PlannedArg[];
     ins: InArg[];
     outs: OutArg[];
 };
-export declare const scalarPrefixArgs: (plan: CommandPlan & {
+declare const scalarPrefixArgs: (plan: CommandPlan & {
     ok: true;
 }, usedTypes: Set<string>) => InArg[] | undefined;
-export {};
+export { scalarAliasOrGroup, trackInto, planArgs, scalarPrefixArgs, type InArg, type OutArg };
 //# sourceMappingURL=args.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/khronos/args.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAa,MAAM,WAAW,CAAC;AAElE,eAAO,MAAM,kBAAkB,WAAY,QAAQ,SAAS,MAAM,GAAG,SAAS,KAAG,MACD,CAAC;AAajF,MAAM,MAAM,KAAK,GAAG;IAChB,GAAG,EAAE,KAAK,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACjB,GAAG,EAAE,IAAI,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,UAAU,GAAG,KAAK,GAAG,MAAM,CAAC;AAsGjC,eAAO,MAAM,SAAS,cACN,GAAG,CAAC,MAAM,CAAC,aACf,MAAM,KAAG,MAGhB,CAAC;AAEN,eAAO,MAAM,QAAQ,SACX,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,aACrB,GAAG,CAAC,MAAM,CAAC,KACvB;IAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAAC,GAAG,EAAE,KAAK,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAyBpD,CAAC;AAEF,eAAO,MAAM,gBAAgB,SAAU,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,aAAa,GAAG,CAAC,MAAM,CAAC,KAAG,KAAK,EAAE,GAAG,SAiBrG,CAAC"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/khronos/args.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAa,MAAM,WAAW,CAAC;AAclE,KAAK,KAAK,GAAG;IACT,GAAG,EAAE,KAAK,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,MAAM,GAAG;IACV,GAAG,EAAE,IAAI,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,UAAU,GAAG,KAAK,GAAG,MAAM,CAAC;AAqBjC,QAAA,MAAM,kBAAkB,GAAI,QAAQ,QAAQ,EAAE,OAAO,MAAM,GAAG,SAAS,KAAG,MACM,CAAC;AA8IjF,QAAA,MAAM,SAAS,GACV,WAAW,GAAG,CAAC,MAAM,CAAC,MAClB,OAAO,MAAM,KAAG,MAIhB,CAAC;AAEV,QAAA,MAAM,QAAQ,GACV,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,EAChC,WAAW,GAAG,CAAC,MAAM,CAAC,KACvB;IAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAAC,GAAG,EAAE,KAAK,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAsBpD,CAAC;AAwBF,QAAA,MAAM,gBAAgB,GAAI,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,EAAE,WAAW,GAAG,CAAC,MAAM,CAAC,KAAG,KAAK,EAAE,GAAG,SAe9F,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,KAAK,KAAK,EAAE,KAAK,MAAM,EAAE,CAAC"}

package/dist/khronos/args.js

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

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

package/dist/khronos/jsdoc.d.ts

@@ -1,7 +1,6 @@
 import type { InArg, OutArg } from "./args.js";
 import type { GlCommand } from "./model.js";
 import type { ReturnPlan } from "./plan.js";
-export declare const inParamDocLine: (command: GlCommand, arg: InArg) => string;
 type CommandJsDocOptions = {
     command: GlCommand;
     feature: string;
@@ -15,7 +14,8 @@ type SingularJsDocOptions = {
     summary: string;
     body: string[];
 };
-export declare const singularJsDoc: ({ commandName, feature, summary, body }: SingularJsDocOptions) => string;
-export declare const commandJsDoc: ({ command, feature, ins, outs, returnPlan }: CommandJsDocOptions) => string;
-export {};
+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 };
 //# 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;AAW5C,eAAO,MAAM,cAAc,YAAa,SAAS,OAAO,KAAK,KAAG,MAQ/D,CAAC;AAgBF,KAAK,mBAAmB,GAAG;IACvB,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,KAAK,EAAE,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;CAC1B,CAAC;AAEF,KAAK,oBAAoB,GAAG;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,aAAa,4CAA6C,oBAAoB,KAAG,MAS9E,CAAC;AAEjB,eAAO,MAAM,YAAY,gDAAiD,mBAAmB,KAAG,MAW/F,CAAC"}
+{"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"}

package/dist/khronos/jsdoc.js

@@ -6,36 +6,48 @@ const formatPrototype = (command) => {
         .join(", ");
     return `${command.returnCType} ${command.name}(${params})`;
 };
-export const inParamDocLine = (command, arg) => {
+const inParamDocLine = (command, arg) => {
     const param = command.params.find((candidate) => toCamelIdentifier(candidate.name) === arg.name);
-    if (param === undefined)
+    if (param === undefined) {
         return ` * @param ${arg.name}`;
+    }
     const notes = [`\`${param.cType}\``];
-    if (param.group !== undefined)
+    if (param.group !== undefined) {
         notes.push(`group \`${param.group}\``);
-    if (param.len !== undefined)
+    }
+    if (param.len !== undefined) {
         notes.push(`length \`${param.len}\``);
-    if (param.objectClass !== undefined)
+    }
+    if (param.objectClass !== undefined) {
         notes.push(`object class \`${param.objectClass}\``);
+    }
     return ` * @param ${arg.name} - ${notes.join(", ")}`;
 };
+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}`);
+    }
+    return `\`${param.name}\` (\`${param.cType}\`)`;
+};
 const returnsDocLine = (command, returnPlan, outs) => {
     const members = [];
-    if (returnPlan.kind !== "void")
+    if (returnPlan.kind !== "void") {
         members.push(`\`${command.returnCType}\``);
+    }
     for (const out of outs) {
-        const param = command.params[out.paramIndex];
-        if (param === undefined)
-            throw new Error(`Output parameter index ${out.paramIndex} out of range on ${command.name}`);
-        members.push(`\`${param.name}\` (\`${param.cType}\`)`);
+        members.push(outMember(command, out));
     }
-    if (members.length === 0)
+    if (members.length === 0) {
         return undefined;
-    if (members.length === 1)
-        return ` * @returns ${members[0]}`;
+    }
+    const [single] = members;
+    if (single !== undefined && members.length === 1) {
+        return ` * @returns ${single}`;
+    }
     return ` * @returns Tuple of ${members.join(", ")}`;
 };
-export const singularJsDoc = ({ commandName, feature, summary, body }) => [
+const singularJsDoc = ({ commandName, feature, summary, body }) => [
     "/**",
     ` * ${summary}`,
     " *",
@@ -44,7 +56,7 @@ export const singularJsDoc = ({ commandName, feature, summary, body }) => [
     ` * @see ${REFPAGES_BASE}/${commandName}.xhtml`,
     " */",
 ].join("\n");
-export const commandJsDoc = ({ command, feature, ins, outs, returnPlan }) => {
+const commandJsDoc = ({ command, feature, ins, outs, returnPlan }) => {
     const returnsLine = returnsDocLine(command, returnPlan, outs);
     return singularJsDoc({
         commandName: command.name,
@@ -52,8 +64,9 @@ export const commandJsDoc = ({ command, feature, ins, outs, returnPlan }) => {
         summary: `\`${formatPrototype(command)}\``,
         body: [
             ...(ins.length > 0 ? [" *", ...ins.map((arg) => inParamDocLine(command, arg))] : []),
-            ...(returnsLine !== undefined ? [returnsLine] : []),
+            ...(returnsLine === undefined ? [] : [returnsLine]),
         ],
     });
 };
+export { inParamDocLine, singularJsDoc, commandJsDoc };
 //# 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\nconst REFPAGES_BASE = \"https://registry.khronos.org/OpenGL-Refpages/gl4/html\";\n\nconst formatPrototype = (command: GlCommand): string => {\n    const params = command.params\n        .map((param) => (param.cType.endsWith(\"*\") ? `${param.cType}${param.name}` : `${param.cType} ${param.name}`))\n        .join(\", \");\n    return `${command.returnCType} ${command.name}(${params})`;\n};\n\nexport const inParamDocLine = (command: GlCommand, arg: InArg): string => {\n    const param = command.params.find((candidate) => toCamelIdentifier(candidate.name) === arg.name);\n    if (param === undefined) return ` * @param ${arg.name}`;\n    const notes: string[] = [`\\`${param.cType}\\``];\n    if (param.group !== undefined) notes.push(`group \\`${param.group}\\``);\n    if (param.len !== undefined) notes.push(`length \\`${param.len}\\``);\n    if (param.objectClass !== undefined) notes.push(`object class \\`${param.objectClass}\\``);\n    return ` * @param ${arg.name} - ${notes.join(\", \")}`;\n};\n\nconst returnsDocLine = (command: GlCommand, returnPlan: ReturnPlan, outs: OutArg[]): string | undefined => {\n    const members: string[] = [];\n    if (returnPlan.kind !== \"void\") members.push(`\\`${command.returnCType}\\``);\n    for (const out of outs) {\n        const param = command.params[out.paramIndex];\n        if (param === undefined)\n            throw new Error(`Output parameter index ${out.paramIndex} out of range on ${command.name}`);\n        members.push(`\\`${param.name}\\` (\\`${param.cType}\\`)`);\n    }\n    if (members.length === 0) return undefined;\n    if (members.length === 1) return ` * @returns ${members[0]}`;\n    return ` * @returns Tuple of ${members.join(\", \")}`;\n};\n\ntype CommandJsDocOptions = {\n    command: GlCommand;\n    feature: string;\n    ins: InArg[];\n    outs: OutArg[];\n    returnPlan: ReturnPlan;\n};\n\ntype SingularJsDocOptions = {\n    commandName: string;\n    feature: string;\n    summary: string;\n    body: string[];\n};\n\nexport const singularJsDoc = ({ commandName, feature, summary, body }: SingularJsDocOptions): string =>\n    [\n        \"/**\",\n        ` * ${summary}`,\n        \" *\",\n        ` * Provided by \\`${feature}\\`.`,\n        ...body,\n        ` * @see ${REFPAGES_BASE}/${commandName}.xhtml`,\n        \" */\",\n    ].join(\"\\n\");\n\nexport const commandJsDoc = ({ command, feature, ins, outs, returnPlan }: CommandJsDocOptions): string => {\n    const returnsLine = returnsDocLine(command, returnPlan, outs);\n    return singularJsDoc({\n        commandName: command.name,\n        feature,\n        summary: `\\`${formatPrototype(command)}\\``,\n        body: [\n            ...(ins.length > 0 ? [\" *\", ...ins.map((arg) => inParamDocLine(command, arg))] : []),\n            ...(returnsLine !== undefined ? [returnsLine] : []),\n        ],\n    });\n};\n"]}
+{"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"]}

package/dist/khronos/model.d.ts

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