@gtkx/codegen 1.0.0-rc.3 → 1.0.0

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,20 +1,26 @@
 import type { ModuleExport } from "@gtkx/react/config";
 import type { OmittedProps } from "../store/jsx/omitted-props.js";
-/** The codegen-relevant subset of a React element config; behaviors are ignored at codegen time. */
-type BuiltinElement = {
-    component?: ModuleExport;
-    lazy?: boolean;
-    props?: ModuleExport;
-    omitProps?: string[];
-};
 /** The framework's built-in element config, split into the maps codegen consumes. */
 type BuiltinElements = {
+    /** Component wrappers keyed by GLib type name; an element without one inherits its nearest ancestor's. */
     components: Record<string, ModuleExport>;
+    /** GLib type names with no GObject of their own, exported as elements that drop their construct-only props. */
     lazyElements: string[];
+    /** Base props interfaces the generated element props extend, keyed by GLib type name. */
     props: Record<string, ModuleExport>;
-    omitProps: OmittedProps;
+    /** Props left out of the generated element props, keyed by GLib type name. */
+    omittedProps: OmittedProps;
 };
+/**
+ * Reads the framework's built-in element config by importing the `config` entrypoints of the installed
+ * `@gtkx/react`, skipping the per-namespace ones whose namespace the gi store does not carry. Those
+ * entrypoints are reconciler-free, so importing them resolves `@gtkx/gi` but never `virtual:gtkx-config`,
+ * which means this must run only after the gi store has been written and linked.
+ *
+ * @param reactSubexports Subexport names of the installed `@gtkx/react`, as `resolveStore` reports them.
+ * @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/config";
-export { readBuiltinElements, type BuiltinElement, type BuiltinElements };
+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,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,oGAAoG;AACpG,KAAK,cAAc,GAAG;IAAE,SAAS,CAAC,EAAE,YAAY,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE/G,qFAAqF;AACrF,KAAK,eAAe,GAAG;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACpC,SAAS,EAAE,YAAY,CAAC;CAC3B,CAAC;AAsEF,QAAA,MAAM,mBAAmB,GAAU,iBAAiB,MAAM,EAAE,EAAE,YAAY,MAAM,KAAG,OAAO,CAAC,eAAe,CAUzG,CAAC;AAEF,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,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"}

package/dist/react/element-config.js

@@ -1,3 +1,11 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
 import { readdirSync } from "node:fs";
 const CONFIG_ENTRYPOINT = "config";
 const CONFIG_SUFFIX = `/${CONFIG_ENTRYPOINT}`;
@@ -11,10 +19,6 @@ const presentNamespaceDirs = (giStoreDir) => {
     }
     return dirs;
 };
-/**
- * The clean, reconciler-free `@gtkx/react` config entrypoints to import: the base `config` entry plus
- * each namespace's `<ns>/config` entry whose GIR namespace is present in the gi store.
- */
 const configEntrypoints = (reactSubexports, present) => reactSubexports.filter((sub) => {
     if (sub === CONFIG_ENTRYPOINT) {
         return true;
@@ -23,7 +27,7 @@ const configEntrypoints = (reactSubexports, present) => reactSubexports.filter((
 });
 const importBuiltinElements = async (entrypoint) => {
     const specifier = `@gtkx/react/${entrypoint}`;
-    const imported = (await import(/* @vite-ignore */ specifier));
+    const imported = (await import(__rewriteRelativeImportExtension(/* @vite-ignore */ specifier)));
     return imported.BUILTIN_ELEMENTS ?? {};
 };
 const applyBuiltinElement = (target, type, config) => {
@@ -33,32 +37,35 @@ const applyBuiltinElement = (target, type, config) => {
     if (config.props !== undefined) {
         target.props[type] = config.props;
     }
-    if (config.omitProps !== undefined) {
-        target.omitProps[type] = [...(target.omitProps[type] ?? []), ...config.omitProps];
+    if (config.omittedProps !== undefined) {
+        target.omittedProps[type] = [...(target.omittedProps[type] ?? []), ...config.omittedProps];
     }
-    if (config.lazy === true) {
+    if (config.isLazy === true) {
         target.lazyElements.push(type);
     }
 };
-/**
- * Reads the framework's built-in element config by importing the freshly linked `@gtkx/react` config
- * entrypoints. These are reconciler-free, so importing them resolves `@gtkx/gi` but never `virtual:gtkx-config`;
- * it must run only after the gi store has been linked.
- */
 const collectBuiltinElements = (target, elements) => {
     for (const [type, config] of Object.entries(elements)) {
         applyBuiltinElement(target, type, config);
     }
 };
+/**
+ * Reads the framework's built-in element config by importing the `config` entrypoints of the installed
+ * `@gtkx/react`, skipping the per-namespace ones whose namespace the gi store does not carry. Those
+ * entrypoints are reconciler-free, so importing them resolves `@gtkx/gi` but never `virtual:gtkx-config`,
+ * which means this must run only after the gi store has been written and linked.
+ *
+ * @param reactSubexports Subexport names of the installed `@gtkx/react`, as `resolveStore` reports them.
+ * @param giStoreDir The gi store directory, whose subdirectories name the generated namespaces.
+ */
 const readBuiltinElements = async (reactSubexports, giStoreDir) => {
     const present = presentNamespaceDirs(giStoreDir);
     const entrypoints = configEntrypoints(reactSubexports, present);
-    const result = { components: {}, lazyElements: [], props: {}, omitProps: {} };
+    const result = { components: {}, lazyElements: [], props: {}, omittedProps: {} };
     for (const entrypoint of entrypoints) {
         collectBuiltinElements(result, await importBuiltinElements(entrypoint));
     }
     return result;
 };
-export {} from "@gtkx/react/config";
 export { readBuiltinElements };
 //# sourceMappingURL=element-config.js.map

package/dist/react/element-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"element-config.js","sourceRoot":"","sources":["../../src/react/element-config.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ModuleExport } from \"@gtkx/react/config\";\nimport { readdirSync } from \"node:fs\";\nimport type { OmittedProps } from \"../store/jsx/omitted-props.js\";\n\n/** The codegen-relevant subset of a React element config; behaviors are ignored at codegen time. */\ntype BuiltinElement = { component?: ModuleExport; lazy?: boolean; props?: ModuleExport; omitProps?: string[] };\n\n/** The framework's built-in element config, split into the maps codegen consumes. */\ntype BuiltinElements = {\n    components: Record<string, ModuleExport>;\n    lazyElements: string[];\n    props: Record<string, ModuleExport>;\n    omitProps: OmittedProps;\n};\n\nconst CONFIG_ENTRYPOINT = \"config\";\nconst CONFIG_SUFFIX = `/${CONFIG_ENTRYPOINT}`;\n\nconst presentNamespaceDirs = (giStoreDir: string): Set<string> => {\n    const dirs: Set<string> = new Set();\n    const entries = readdirSync(giStoreDir, { withFileTypes: true });\n\n    for (const entry of entries) {\n        if (entry.isDirectory()) {\n            dirs.add(entry.name);\n        }\n    }\n\n    return dirs;\n};\n\n/**\n * The clean, reconciler-free `@gtkx/react` config entrypoints to import: the base `config` entry plus\n * each namespace's `<ns>/config` entry whose GIR namespace is present in the gi store.\n */\nconst configEntrypoints = (reactSubexports: string[], present: Set<string>): string[] =>\n    reactSubexports.filter((sub) => {\n        if (sub === CONFIG_ENTRYPOINT) {\n            return true;\n        }\n\n        return sub.endsWith(CONFIG_SUFFIX) && present.has(sub.slice(0, sub.length - CONFIG_SUFFIX.length));\n    });\n\nconst importBuiltinElements = async (entrypoint: string): Promise<Record<string, BuiltinElement>> => {\n    const specifier = `@gtkx/react/${entrypoint}`;\n\n    const imported = (await import(/* @vite-ignore */ specifier)) as {\n        BUILTIN_ELEMENTS?: Record<string, BuiltinElement>;\n    };\n\n    return imported.BUILTIN_ELEMENTS ?? {};\n};\n\nconst applyBuiltinElement = (target: BuiltinElements, type: string, config: BuiltinElement): void => {\n    if (config.component !== undefined) {\n        target.components[type] = config.component;\n    }\n\n    if (config.props !== undefined) {\n        target.props[type] = config.props;\n    }\n\n    if (config.omitProps !== undefined) {\n        target.omitProps[type] = [...(target.omitProps[type] ?? []), ...config.omitProps];\n    }\n\n    if (config.lazy === true) {\n        target.lazyElements.push(type);\n    }\n};\n\n/**\n * Reads the framework's built-in element config by importing the freshly linked `@gtkx/react` config\n * entrypoints. These are reconciler-free, so importing them resolves `@gtkx/gi` but never `virtual:gtkx-config`;\n * it must run only after the gi store has been linked.\n */\nconst collectBuiltinElements = (target: BuiltinElements, elements: Record<string, BuiltinElement>): void => {\n    for (const [type, config] of Object.entries(elements)) {\n        applyBuiltinElement(target, type, config);\n    }\n};\n\nconst readBuiltinElements = async (reactSubexports: string[], giStoreDir: string): Promise<BuiltinElements> => {\n    const present = presentNamespaceDirs(giStoreDir);\n    const entrypoints = configEntrypoints(reactSubexports, present);\n    const result: BuiltinElements = { components: {}, lazyElements: [], props: {}, omitProps: {} };\n\n    for (const entrypoint of entrypoints) {\n        collectBuiltinElements(result, await importBuiltinElements(entrypoint));\n    }\n\n    return result;\n};\n\nexport { type ModuleExport } from \"@gtkx/react/config\";\nexport { readBuiltinElements, type BuiltinElement, type BuiltinElements };\n"]}
+{"version":3,"file":"element-config.js","sourceRoot":"","sources":["../../src/react/element-config.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ModuleExport } from \"@gtkx/react/config\";\nimport { readdirSync } from \"node:fs\";\nimport type { OmittedProps } from \"../store/jsx/omitted-props.js\";\n\ntype BuiltinElement = { component?: ModuleExport; isLazy?: boolean; props?: ModuleExport; omittedProps?: string[] };\n\n/** The framework's built-in element config, split into the maps codegen consumes. */\ntype BuiltinElements = {\n    /** Component wrappers keyed by GLib type name; an element without one inherits its nearest ancestor's. */\n    components: Record<string, ModuleExport>;\n    /** GLib type names with no GObject of their own, exported as elements that drop their construct-only props. */\n    lazyElements: string[];\n    /** Base props interfaces the generated element props extend, keyed by GLib type name. */\n    props: Record<string, ModuleExport>;\n    /** Props left out of the generated element props, keyed by GLib type name. */\n    omittedProps: OmittedProps;\n};\n\nconst CONFIG_ENTRYPOINT = \"config\";\nconst CONFIG_SUFFIX = `/${CONFIG_ENTRYPOINT}`;\n\nconst presentNamespaceDirs = (giStoreDir: string): Set<string> => {\n    const dirs: Set<string> = new Set();\n    const entries = readdirSync(giStoreDir, { withFileTypes: true });\n\n    for (const entry of entries) {\n        if (entry.isDirectory()) {\n            dirs.add(entry.name);\n        }\n    }\n\n    return dirs;\n};\n\nconst configEntrypoints = (reactSubexports: string[], present: Set<string>): string[] =>\n    reactSubexports.filter((sub) => {\n        if (sub === CONFIG_ENTRYPOINT) {\n            return true;\n        }\n\n        return sub.endsWith(CONFIG_SUFFIX) && present.has(sub.slice(0, sub.length - CONFIG_SUFFIX.length));\n    });\n\nconst importBuiltinElements = async (entrypoint: string): Promise<Record<string, BuiltinElement>> => {\n    const specifier = `@gtkx/react/${entrypoint}`;\n\n    const imported = (await import(/* @vite-ignore */ specifier)) as {\n        BUILTIN_ELEMENTS?: Record<string, BuiltinElement>;\n    };\n\n    return imported.BUILTIN_ELEMENTS ?? {};\n};\n\nconst applyBuiltinElement = (target: BuiltinElements, type: string, config: BuiltinElement): void => {\n    if (config.component !== undefined) {\n        target.components[type] = config.component;\n    }\n\n    if (config.props !== undefined) {\n        target.props[type] = config.props;\n    }\n\n    if (config.omittedProps !== undefined) {\n        target.omittedProps[type] = [...(target.omittedProps[type] ?? []), ...config.omittedProps];\n    }\n\n    if (config.isLazy === true) {\n        target.lazyElements.push(type);\n    }\n};\n\nconst collectBuiltinElements = (target: BuiltinElements, elements: Record<string, BuiltinElement>): void => {\n    for (const [type, config] of Object.entries(elements)) {\n        applyBuiltinElement(target, type, config);\n    }\n};\n\n/**\n * Reads the framework's built-in element config by importing the `config` entrypoints of the installed\n * `@gtkx/react`, skipping the per-namespace ones whose namespace the gi store does not carry. Those\n * entrypoints are reconciler-free, so importing them resolves `@gtkx/gi` but never `virtual:gtkx-config`,\n * which means this must run only after the gi store has been written and linked.\n *\n * @param reactSubexports Subexport names of the installed `@gtkx/react`, as `resolveStore` reports them.\n * @param giStoreDir The gi store directory, whose subdirectories name the generated namespaces.\n */\nconst readBuiltinElements = async (reactSubexports: string[], giStoreDir: string): Promise<BuiltinElements> => {\n    const present = presentNamespaceDirs(giStoreDir);\n    const entrypoints = configEntrypoints(reactSubexports, present);\n    const result: BuiltinElements = { components: {}, lazyElements: [], props: {}, omittedProps: {} };\n\n    for (const entrypoint of entrypoints) {\n        collectBuiltinElements(result, await importBuiltinElements(entrypoint));\n    }\n\n    return result;\n};\n\nexport type { ModuleExport } from \"@gtkx/react/config\";\nexport { readBuiltinElements, type BuiltinElements };\n"]}

package/dist/runner.d.ts

@@ -1,46 +1,58 @@
-import type { GiStoreOptions } from "./store/gi-store.js";
-import type { JsxStoreOptions } from "./store/jsx-store.js";
+import type { ModuleExport } from "./react/element-config.js";
 import type { OmittedProps } from "./store/jsx/omitted-props.js";
+import type { StoreOptions } from "./store/store-fs.js";
 import { type GlGenerationReport } from "./khronos/pipeline.js";
-type ModuleExport = {
-    module: string;
-    export: string;
-};
 type GlCodegenOptions = {
     registryPath: string;
     overrideExports: Set<string>;
     outputDir: string;
     resolveFrom: string;
 };
+/** What to generate and where to write it. */
 type CodegenRunnerOptions = {
-    libraries?: string[];
-    girPath?: string[];
-    gi?: GiStoreOptions;
-    jsx?: JsxStoreOptions | undefined;
+    /** GIR library identifiers such as `"Gtk-4.0"`; a `"*"` selection must be expanded before it gets here. */
+    libraries: string[];
+    /** Directories to search for `.gir` files. */
+    girPath: string[];
+    /** Where to write and link the `@gtkx/gi` store. */
+    gi: StoreOptions;
+    /** Where to write and link the `@gtkx/jsx` store; omit to generate the gi store alone. */
+    jsx?: StoreOptions | undefined;
+    /** Subexport names of the installed `@gtkx/react`, whose element config shapes the jsx store. */
     reactSubexports?: string[];
+    /** Component wrappers the project layers over the built-ins, keyed by GLib type name. */
     userComponents?: Record<string, ModuleExport>;
+    /** GLib type names whose GObject their parent container creates, added to the framework's own. */
     userLazyElements?: string[];
+    /** Base props interfaces the project's elements extend, keyed by GLib type name. */
     userProps?: Record<string, ModuleExport>;
-    userOmitProps?: OmittedProps;
-    gl?: GlCodegenOptions;
-    force?: boolean;
+    /** Props the project drops from the generated element props, keyed by GLib type name. */
+    userOmittedProps?: OmittedProps;
+    /** Regenerates both stores even when their fingerprints are fresh. */
+    isForced?: boolean;
 };
+/** What a `runCodegen` run produced. */
 type CodegenRunnerResult = {
-    regenerated: boolean;
+    /** Whether either store was rewritten; false means both were already fresh. */
+    isRegenerated: boolean;
+    /** How many namespaces the gi store was written with, zero when it was already fresh. */
     namespaces: number;
+    /** How many JSX elements the jsx store binds, zero when no jsx store was requested. */
     intrinsicElements: number;
+    /** Wall-clock duration of the run, in milliseconds. */
     duration: number;
-    gl?: GlGenerationReport | undefined;
 };
 /**
- * Runs the `@gtkx` code generators, producing the `@gtkx/gi`, `@gtkx/jsx`, and `@gtkx/gl` bindings from the
- * configured GObject-introspection libraries and OpenGL registry. The gi store is regenerated only when its
- * fingerprint is stale unless `options.force` is set, then the jsx store is regenerated when the gi store or
- * the React element config changed; the OpenGL modules are regenerated whenever `options.gl` is provided.
+ * Writes and links a project's `@gtkx/gi` and `@gtkx/jsx` stores from the given GObject-Introspection
+ * libraries. The gi store is rewritten only when its GIR inputs changed, and the jsx store only when the gi
+ * store or the React element config changed, unless `options.isForced` is set. Pass the spread of
+ * `resolveStore(projectRoot)` for everything but `libraries` and `girPath`.
  *
- * @param options - What to generate and where to write it.
+ * @param options What to generate and where to write it.
  * @returns A summary of what was regenerated and how long the run took.
+ * @throws If `girPath` is empty, which would otherwise generate nothing and report success.
  */
 declare const runCodegen: (options: CodegenRunnerOptions) => Promise<CodegenRunnerResult>;
-export { runCodegen, type GlCodegenOptions, type CodegenRunnerOptions, type CodegenRunnerResult };
+declare const runGlCodegen: (options: GlCodegenOptions) => GlGenerationReport;
+export { runCodegen, runGlCodegen, type CodegenRunnerOptions, type CodegenRunnerResult };
 //# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAKjE,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,KAAK,YAAY,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,KAAK,gBAAgB,GAAG;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,KAAK,oBAAoB,GAAG;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,EAAE,CAAC,EAAE,cAAc,CAAC;IACpB,GAAG,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC9C,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,EAAE,CAAC,EAAE,gBAAgB,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;CACvC,CAAC;AAQF;;;;;;;;GAQG;AACH,QAAA,MAAM,UAAU,GAAU,SAAS,oBAAoB,KAAG,OAAO,CAAC,mBAAmB,CAYpF,CAAC;AAmGF,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,CAAC"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKxD,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,KAAK,gBAAgB,GAAG;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,8CAA8C;AAC9C,KAAK,oBAAoB,GAAG;IACxB,2GAA2G;IAC3G,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oDAAoD;IACpD,EAAE,EAAE,YAAY,CAAC;IACjB,0FAA0F;IAC1F,GAAG,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAC/B,iGAAiG;IACjG,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,yFAAyF;IACzF,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC9C,kGAAkG;IAClG,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,yFAAyF;IACzF,gBAAgB,CAAC,EAAE,YAAY,CAAC;IAChC,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,wCAAwC;AACxC,KAAK,mBAAmB,GAAG;IACvB,+EAA+E;IAC/E,aAAa,EAAE,OAAO,CAAC;IACvB,yFAAyF;IACzF,UAAU,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAQF;;;;;;;;;GASG;AACH,QAAA,MAAM,UAAU,GAAU,SAAS,oBAAoB,KAAG,OAAO,CAAC,mBAAmB,CAUpF,CAAC;AAEF,QAAA,MAAM,YAAY,GAAI,SAAS,gBAAgB,KAAG,kBAmBjD,CAAC;AA8EF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,CAAC"}

package/dist/runner.js

@@ -6,27 +6,26 @@ import { runGiCodegen } from "./gi.js";
 import { Library } from "./gir/library.js";
 import { generateGlModules } from "./khronos/pipeline.js";
 /**
- * Runs the `@gtkx` code generators, producing the `@gtkx/gi`, `@gtkx/jsx`, and `@gtkx/gl` bindings from the
- * configured GObject-introspection libraries and OpenGL registry. The gi store is regenerated only when its
- * fingerprint is stale unless `options.force` is set, then the jsx store is regenerated when the gi store or
- * the React element config changed; the OpenGL modules are regenerated whenever `options.gl` is provided.
+ * Writes and links a project's `@gtkx/gi` and `@gtkx/jsx` stores from the given GObject-Introspection
+ * libraries. The gi store is rewritten only when its GIR inputs changed, and the jsx store only when the gi
+ * store or the React element config changed, unless `options.isForced` is set. Pass the spread of
+ * `resolveStore(projectRoot)` for everything but `libraries` and `girPath`.
  *
- * @param options - What to generate and where to write it.
+ * @param options What to generate and where to write it.
  * @returns A summary of what was regenerated and how long the run took.
+ * @throws If `girPath` is empty, which would otherwise generate nothing and report success.
  */
 const runCodegen = async (options) => {
     const start = Date.now();
-    const gl = options.gl === undefined ? undefined : emitGlModules(options.gl);
     const store = await emitStores(options);
     return {
-        regenerated: store.regenerated,
+        isRegenerated: store.isRegenerated,
         namespaces: store.namespaces,
         intrinsicElements: store.intrinsicElements,
         duration: Date.now() - start,
-        gl,
     };
 };
-const emitGlModules = (options) => {
+const runGlCodegen = (options) => {
     const { files, report } = generateGlModules({
         registryPath: options.registryPath,
         overrideExports: options.overrideExports,
@@ -47,21 +46,21 @@ const jsxUserOptions = (options) => ({
     userComponents: options.userComponents ?? {},
     userLazyElements: options.userLazyElements ?? [],
     userProps: options.userProps ?? {},
-    userOmitProps: options.userOmitProps ?? {},
+    userOmittedProps: options.userOmittedProps ?? {},
 });
 const emitJsxStore = async (input) => {
-    const { options, jsx, gi, loadLibrary, giRegenerated, namespaces } = input;
+    const { options, jsx, gi, loadLibrary, isGiRegenerated, namespaces } = input;
     const { runJsxCodegen } = await import("./jsx.js");
     const jsxResult = await runJsxCodegen({
         getLibrary: loadLibrary,
         jsx,
         giStoreDir: gi.storeDir,
         ...jsxUserOptions(options),
-        giRegenerated,
-        force: options.force === true,
+        isGiRegenerated,
+        isForced: options.isForced === true,
     });
     return {
-        regenerated: giRegenerated || jsxResult.regenerated,
+        isRegenerated: isGiRegenerated || jsxResult.isRegenerated,
         namespaces,
         intrinsicElements: jsxResult.intrinsicElementCount,
     };
@@ -70,21 +69,21 @@ const emitStoresWithConfig = async (config) => {
     const { options, gi, jsx, libraries, girPath } = config;
     let library;
     const loadLibrary = () => (library ??= Library.load(libraries, girPath));
-    const isGiRegenerated = options.force === true || !isGiStoreFresh(gi.storeDir, libraries, girPath);
+    const isGiRegenerated = options.isForced === true || !isGiStoreFresh(gi.storeDir, libraries, girPath);
     const namespaces = isGiRegenerated
         ? runGiCodegen(loadLibrary(), { gi, libraries, girPath })
         : 0;
     if (jsx === undefined) {
-        return { regenerated: isGiRegenerated, namespaces, intrinsicElements: 0 };
+        return { isRegenerated: isGiRegenerated, namespaces, intrinsicElements: 0 };
     }
-    return emitJsxStore({ options, jsx, gi, loadLibrary, giRegenerated: isGiRegenerated, namespaces });
+    return emitJsxStore({ options, jsx, gi, loadLibrary, isGiRegenerated, namespaces });
 };
 const emitStores = async (options) => {
     const { gi, jsx, libraries, girPath } = options;
-    if (gi === undefined || libraries === undefined || girPath === undefined) {
-        return { regenerated: false, namespaces: 0, intrinsicElements: 0 };
+    if (girPath.length === 0) {
+        throw new Error("codegen needs at least one GIR search path; pass the result of resolveGirPath");
     }
     return emitStoresWithConfig({ options, gi, jsx, libraries, girPath });
 };
-export { runCodegen };
+export { runCodegen, runGlCodegen };
 //# sourceMappingURL=runner.js.map

package/dist/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdirSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { GiStoreOptions } from \"./store/gi-store.js\";\nimport type { JsxStoreOptions } from \"./store/jsx-store.js\";\nimport type { OmittedProps } from \"./store/jsx/omitted-props.js\";\nimport { checkModules } from \"./compile.js\";\nimport { isGiStoreFresh } from \"./fingerprint.js\";\nimport { runGiCodegen } from \"./gi.js\";\nimport { Library } from \"./gir/library.js\";\nimport { generateGlModules, type GlGenerationReport } from \"./khronos/pipeline.js\";\n\ntype ModuleExport = { module: string; export: string };\n\ntype GlCodegenOptions = {\n    registryPath: string;\n    overrideExports: Set<string>;\n    outputDir: string;\n    resolveFrom: string;\n};\n\ntype CodegenRunnerOptions = {\n    libraries?: string[];\n    girPath?: string[];\n    gi?: GiStoreOptions;\n    jsx?: JsxStoreOptions | undefined;\n    reactSubexports?: string[];\n    userComponents?: Record<string, ModuleExport>;\n    userLazyElements?: string[];\n    userProps?: Record<string, ModuleExport>;\n    userOmitProps?: OmittedProps;\n    gl?: GlCodegenOptions;\n    force?: boolean;\n};\n\ntype CodegenRunnerResult = {\n    regenerated: boolean;\n    namespaces: number;\n    intrinsicElements: number;\n    duration: number;\n    gl?: GlGenerationReport | undefined;\n};\n\ntype StoreResult = {\n    regenerated: boolean;\n    namespaces: number;\n    intrinsicElements: number;\n};\n\n/**\n * Runs the `@gtkx` code generators, producing the `@gtkx/gi`, `@gtkx/jsx`, and `@gtkx/gl` bindings from the\n * configured GObject-introspection libraries and OpenGL registry. The gi store is regenerated only when its\n * fingerprint is stale unless `options.force` is set, then the jsx store is regenerated when the gi store or\n * the React element config changed; the OpenGL modules are regenerated whenever `options.gl` is provided.\n *\n * @param options - What to generate and where to write it.\n * @returns A summary of what was regenerated and how long the run took.\n */\nconst runCodegen = async (options: CodegenRunnerOptions): Promise<CodegenRunnerResult> => {\n    const start = Date.now();\n    const gl = options.gl === undefined ? undefined : emitGlModules(options.gl);\n    const store = await emitStores(options);\n\n    return {\n        regenerated: store.regenerated,\n        namespaces: store.namespaces,\n        intrinsicElements: store.intrinsicElements,\n        duration: Date.now() - start,\n        gl,\n    };\n};\n\nconst emitGlModules = (options: GlCodegenOptions): GlGenerationReport => {\n    const { files, report } = generateGlModules({\n        registryPath: options.registryPath,\n        overrideExports: options.overrideExports,\n    });\n\n    checkModules({\n        modules: [...files].map(([fileName, source]) => ({ fileName, source })),\n        resolveFrom: options.resolveFrom,\n        label: \"the generated gl modules\",\n    });\n\n    mkdirSync(options.outputDir, { recursive: true });\n\n    for (const [fileName, source] of files) {\n        writeFileSync(join(options.outputDir, fileName), source);\n    }\n\n    return report;\n};\n\nconst jsxUserOptions = (\n    options: CodegenRunnerOptions,\n): {\n    reactSubexports: string[];\n    userComponents: Record<string, ModuleExport>;\n    userLazyElements: string[];\n    userProps: Record<string, ModuleExport>;\n    userOmitProps: OmittedProps;\n} => ({\n    reactSubexports: options.reactSubexports ?? [],\n    userComponents: options.userComponents ?? {},\n    userLazyElements: options.userLazyElements ?? [],\n    userProps: options.userProps ?? {},\n    userOmitProps: options.userOmitProps ?? {},\n});\n\nconst emitJsxStore = async (input: {\n    options: CodegenRunnerOptions;\n    jsx: JsxStoreOptions;\n    gi: GiStoreOptions;\n    loadLibrary: () => Library;\n    giRegenerated: boolean;\n    namespaces: number;\n}): Promise<StoreResult> => {\n    const { options, jsx, gi, loadLibrary, giRegenerated, namespaces } = input;\n    const { runJsxCodegen } = await import(\"./jsx.js\");\n\n    const jsxResult = await runJsxCodegen({\n        getLibrary: loadLibrary,\n        jsx,\n        giStoreDir: gi.storeDir,\n        ...jsxUserOptions(options),\n        giRegenerated,\n        force: options.force === true,\n    });\n\n    return {\n        regenerated: giRegenerated || jsxResult.regenerated,\n        namespaces,\n        intrinsicElements: jsxResult.intrinsicElementCount,\n    };\n};\n\nconst emitStoresWithConfig = async (config: {\n    options: CodegenRunnerOptions;\n    gi: GiStoreOptions;\n    jsx: JsxStoreOptions | undefined;\n    libraries: string[];\n    girPath: string[];\n}): Promise<StoreResult> => {\n    const { options, gi, jsx, libraries, girPath } = config;\n    let library: Library | undefined;\n    const loadLibrary = (): Library => (library ??= Library.load(libraries, girPath));\n    const isGiRegenerated = options.force === true || !isGiStoreFresh(gi.storeDir, libraries, girPath);\n\n    const namespaces = isGiRegenerated\n        ? runGiCodegen(loadLibrary(), { gi, libraries, girPath })\n        : 0;\n\n    if (jsx === undefined) {\n        return { regenerated: isGiRegenerated, namespaces, intrinsicElements: 0 };\n    }\n\n    return emitJsxStore({ options, jsx, gi, loadLibrary, giRegenerated: isGiRegenerated, namespaces });\n};\n\nconst emitStores = async (options: CodegenRunnerOptions): Promise<StoreResult> => {\n    const { gi, jsx, libraries, girPath } = options;\n\n    if (gi === undefined || libraries === undefined || girPath === undefined) {\n        return { regenerated: false, namespaces: 0, intrinsicElements: 0 };\n    }\n\n    return emitStoresWithConfig({ options, gi, jsx, libraries, girPath });\n};\n\nexport { runCodegen, type GlCodegenOptions, type CodegenRunnerOptions, type CodegenRunnerResult };\n"]}
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdirSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { ModuleExport } from \"./react/element-config.js\";\nimport type { OmittedProps } from \"./store/jsx/omitted-props.js\";\nimport type { StoreOptions } from \"./store/store-fs.js\";\nimport { checkModules } from \"./compile.js\";\nimport { isGiStoreFresh } from \"./fingerprint.js\";\nimport { runGiCodegen } from \"./gi.js\";\nimport { Library } from \"./gir/library.js\";\nimport { generateGlModules, type GlGenerationReport } from \"./khronos/pipeline.js\";\n\ntype GlCodegenOptions = {\n    registryPath: string;\n    overrideExports: Set<string>;\n    outputDir: string;\n    resolveFrom: string;\n};\n\n/** What to generate and where to write it. */\ntype CodegenRunnerOptions = {\n    /** GIR library identifiers such as `\"Gtk-4.0\"`; a `\"*\"` selection must be expanded before it gets here. */\n    libraries: string[];\n    /** Directories to search for `.gir` files. */\n    girPath: string[];\n    /** Where to write and link the `@gtkx/gi` store. */\n    gi: StoreOptions;\n    /** Where to write and link the `@gtkx/jsx` store; omit to generate the gi store alone. */\n    jsx?: StoreOptions | undefined;\n    /** Subexport names of the installed `@gtkx/react`, whose element config shapes the jsx store. */\n    reactSubexports?: string[];\n    /** Component wrappers the project layers over the built-ins, keyed by GLib type name. */\n    userComponents?: Record<string, ModuleExport>;\n    /** GLib type names whose GObject their parent container creates, added to the framework's own. */\n    userLazyElements?: string[];\n    /** Base props interfaces the project's elements extend, keyed by GLib type name. */\n    userProps?: Record<string, ModuleExport>;\n    /** Props the project drops from the generated element props, keyed by GLib type name. */\n    userOmittedProps?: OmittedProps;\n    /** Regenerates both stores even when their fingerprints are fresh. */\n    isForced?: boolean;\n};\n\n/** What a `runCodegen` run produced. */\ntype CodegenRunnerResult = {\n    /** Whether either store was rewritten; false means both were already fresh. */\n    isRegenerated: boolean;\n    /** How many namespaces the gi store was written with, zero when it was already fresh. */\n    namespaces: number;\n    /** How many JSX elements the jsx store binds, zero when no jsx store was requested. */\n    intrinsicElements: number;\n    /** Wall-clock duration of the run, in milliseconds. */\n    duration: number;\n};\n\ntype StoreResult = {\n    isRegenerated: boolean;\n    namespaces: number;\n    intrinsicElements: number;\n};\n\n/**\n * Writes and links a project's `@gtkx/gi` and `@gtkx/jsx` stores from the given GObject-Introspection\n * libraries. The gi store is rewritten only when its GIR inputs changed, and the jsx store only when the gi\n * store or the React element config changed, unless `options.isForced` is set. Pass the spread of\n * `resolveStore(projectRoot)` for everything but `libraries` and `girPath`.\n *\n * @param options What to generate and where to write it.\n * @returns A summary of what was regenerated and how long the run took.\n * @throws If `girPath` is empty, which would otherwise generate nothing and report success.\n */\nconst runCodegen = async (options: CodegenRunnerOptions): Promise<CodegenRunnerResult> => {\n    const start = Date.now();\n    const store = await emitStores(options);\n\n    return {\n        isRegenerated: store.isRegenerated,\n        namespaces: store.namespaces,\n        intrinsicElements: store.intrinsicElements,\n        duration: Date.now() - start,\n    };\n};\n\nconst runGlCodegen = (options: GlCodegenOptions): GlGenerationReport => {\n    const { files, report } = generateGlModules({\n        registryPath: options.registryPath,\n        overrideExports: options.overrideExports,\n    });\n\n    checkModules({\n        modules: [...files].map(([fileName, source]) => ({ fileName, source })),\n        resolveFrom: options.resolveFrom,\n        label: \"the generated gl modules\",\n    });\n\n    mkdirSync(options.outputDir, { recursive: true });\n\n    for (const [fileName, source] of files) {\n        writeFileSync(join(options.outputDir, fileName), source);\n    }\n\n    return report;\n};\n\nconst jsxUserOptions = (\n    options: CodegenRunnerOptions,\n): {\n    reactSubexports: string[];\n    userComponents: Record<string, ModuleExport>;\n    userLazyElements: string[];\n    userProps: Record<string, ModuleExport>;\n    userOmittedProps: OmittedProps;\n} => ({\n    reactSubexports: options.reactSubexports ?? [],\n    userComponents: options.userComponents ?? {},\n    userLazyElements: options.userLazyElements ?? [],\n    userProps: options.userProps ?? {},\n    userOmittedProps: options.userOmittedProps ?? {},\n});\n\nconst emitJsxStore = async (input: {\n    options: CodegenRunnerOptions;\n    jsx: StoreOptions;\n    gi: StoreOptions;\n    loadLibrary: () => Library;\n    isGiRegenerated: boolean;\n    namespaces: number;\n}): Promise<StoreResult> => {\n    const { options, jsx, gi, loadLibrary, isGiRegenerated, namespaces } = input;\n    const { runJsxCodegen } = await import(\"./jsx.js\");\n\n    const jsxResult = await runJsxCodegen({\n        getLibrary: loadLibrary,\n        jsx,\n        giStoreDir: gi.storeDir,\n        ...jsxUserOptions(options),\n        isGiRegenerated,\n        isForced: options.isForced === true,\n    });\n\n    return {\n        isRegenerated: isGiRegenerated || jsxResult.isRegenerated,\n        namespaces,\n        intrinsicElements: jsxResult.intrinsicElementCount,\n    };\n};\n\nconst emitStoresWithConfig = async (config: {\n    options: CodegenRunnerOptions;\n    gi: StoreOptions;\n    jsx: StoreOptions | undefined;\n    libraries: string[];\n    girPath: string[];\n}): Promise<StoreResult> => {\n    const { options, gi, jsx, libraries, girPath } = config;\n    let library: Library | undefined;\n    const loadLibrary = (): Library => (library ??= Library.load(libraries, girPath));\n    const isGiRegenerated = options.isForced === true || !isGiStoreFresh(gi.storeDir, libraries, girPath);\n\n    const namespaces = isGiRegenerated\n        ? runGiCodegen(loadLibrary(), { gi, libraries, girPath })\n        : 0;\n\n    if (jsx === undefined) {\n        return { isRegenerated: isGiRegenerated, namespaces, intrinsicElements: 0 };\n    }\n\n    return emitJsxStore({ options, jsx, gi, loadLibrary, isGiRegenerated, namespaces });\n};\n\nconst emitStores = async (options: CodegenRunnerOptions): Promise<StoreResult> => {\n    const { gi, jsx, libraries, girPath } = options;\n\n    if (girPath.length === 0) {\n        throw new Error(\"codegen needs at least one GIR search path; pass the result of resolveGirPath\");\n    }\n\n    return emitStoresWithConfig({ options, gi, jsx, libraries, girPath });\n};\n\nexport { runCodegen, runGlCodegen, type CodegenRunnerOptions, type CodegenRunnerResult };\n"]}

package/dist/store/compile-store.d.ts

@@ -3,9 +3,8 @@ type CompileStoreParams = {
     storeDir: string;
     files: SourceModule[];
     packageName: string;
-    /** Declare `virtual:gtkx-config` for the typecheck, needed when it follows imports into `@gtkx/react` source. */
-    configEnv?: boolean;
+    requiresEnvReference?: boolean;
 };
 declare const compileStore: (params: CompileStoreParams) => void;
-export { compileStore, type CompileStoreParams };
+export { compileStore };
 //# sourceMappingURL=compile-store.d.ts.map

package/dist/store/compile-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compile-store.d.ts","sourceRoot":"","sources":["../../src/store/compile-store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAElE,KAAK,kBAAkB,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,iHAAiH;IACjH,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAqBF,QAAA,MAAM,YAAY,GAAI,QAAQ,kBAAkB,KAAG,IAqBlD,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"compile-store.d.ts","sourceRoot":"","sources":["../../src/store/compile-store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAElE,KAAK,kBAAkB,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AAqBF,QAAA,MAAM,YAAY,GAAI,QAAQ,kBAAkB,KAAG,IAqBlD,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/store/compile-store.js

@@ -18,13 +18,13 @@ const writeEnvReference = (storeDir) => {
 };
 const compileStore = (params) => {
     const fileNames = params.files.map((file) => file.fileName);
-    const removeEnvReference = params.configEnv === true
+    const removeEnvReference = params.requiresEnvReference === true
         ? writeEnvReference(params.storeDir)
         : () => undefined;
     try {
         compileProject({
             projectDir: params.storeDir,
-            fileNames: params.configEnv === true ? [ENV_REFERENCE_FILE, ...fileNames] : fileNames,
+            fileNames: params.requiresEnvReference === true ? [ENV_REFERENCE_FILE, ...fileNames] : fileNames,
             compilerOptions: EMIT_OPTIONS,
             label: `the generated ${params.packageName} store`,
         });

package/dist/store/compile-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"compile-store.js","sourceRoot":"","sources":["../../src/store/compile-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAqB,MAAM,eAAe,CAAC;AAUlE,MAAM,YAAY,GAAG;IACjB,WAAW,EAAE,IAAI;IACjB,cAAc,EAAE,KAAK;IACrB,SAAS,EAAE,KAAK;IAChB,cAAc,EAAE,KAAK;IACrB,OAAO,EAAE,GAAG;IACZ,MAAM,EAAE,GAAG;CACd,CAAC;AAEF,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;AAE/C,MAAM,iBAAiB,GAAG,CAAC,QAAgB,EAAgB,EAAE;IACzD,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,EAAE,+CAA+C,CAAC,CAAC;IAEnG,OAAO,GAAG,EAAE;QACR,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,MAA0B,EAAQ,EAAE;IACtD,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE5D,MAAM,kBAAkB,GAAG,MAAM,CAAC,SAAS,KAAK,IAAI;QAChD,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC;QACpC,CAAC,CAAC,GAAS,EAAE,CAAC,SAAS,CAAC;IAE5B,IAAI,CAAC;QACD,cAAc,CAAC;YACX,UAAU,EAAE,MAAM,CAAC,QAAQ;YAC3B,SAAS,EAAE,MAAM,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,kBAAkB,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;YACrF,eAAe,EAAE,YAAY;YAC7B,KAAK,EAAE,iBAAiB,MAAM,CAAC,WAAW,QAAQ;SACrD,CAAC,CAAC;IACP,CAAC;YAAS,CAAC;QACP,kBAAkB,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;AACL,CAAC,CAAC;AAEF,OAAO,EAAE,YAAY,EAA2B,CAAC","sourcesContent":["import { rmSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { compileProject, type SourceModule } from \"../compile.js\";\n\ntype CompileStoreParams = {\n    storeDir: string;\n    files: SourceModule[];\n    packageName: string;\n    /** Declare `virtual:gtkx-config` for the typecheck, needed when it follows imports into `@gtkx/react` source. */\n    configEnv?: boolean;\n};\n\nconst EMIT_OPTIONS = {\n    declaration: true,\n    removeComments: false,\n    sourceMap: false,\n    declarationMap: false,\n    rootDir: \".\",\n    outDir: \".\",\n};\n\nconst ENV_REFERENCE_FILE = \"__gtkx-env__.d.ts\";\n\nconst writeEnvReference = (storeDir: string): (() => void) => {\n    writeFileSync(join(storeDir, ENV_REFERENCE_FILE), \"/// <reference types=\\\"@gtkx/react/env\\\" />\\n\");\n\n    return () => {\n        rmSync(join(storeDir, ENV_REFERENCE_FILE), { force: true });\n    };\n};\n\nconst compileStore = (params: CompileStoreParams): void => {\n    const fileNames = params.files.map((file) => file.fileName);\n\n    const removeEnvReference = params.configEnv === true\n        ? writeEnvReference(params.storeDir)\n        : (): void => undefined;\n\n    try {\n        compileProject({\n            projectDir: params.storeDir,\n            fileNames: params.configEnv === true ? [ENV_REFERENCE_FILE, ...fileNames] : fileNames,\n            compilerOptions: EMIT_OPTIONS,\n            label: `the generated ${params.packageName} store`,\n        });\n    } finally {\n        removeEnvReference();\n    }\n\n    for (const file of params.files) {\n        rmSync(join(params.storeDir, file.fileName), { force: true });\n    }\n};\n\nexport { compileStore, type CompileStoreParams };\n"]}
+{"version":3,"file":"compile-store.js","sourceRoot":"","sources":["../../src/store/compile-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAqB,MAAM,eAAe,CAAC;AASlE,MAAM,YAAY,GAAG;IACjB,WAAW,EAAE,IAAI;IACjB,cAAc,EAAE,KAAK;IACrB,SAAS,EAAE,KAAK;IAChB,cAAc,EAAE,KAAK;IACrB,OAAO,EAAE,GAAG;IACZ,MAAM,EAAE,GAAG;CACd,CAAC;AAEF,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;AAE/C,MAAM,iBAAiB,GAAG,CAAC,QAAgB,EAAgB,EAAE;IACzD,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,EAAE,+CAA+C,CAAC,CAAC;IAEnG,OAAO,GAAG,EAAE;QACR,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,MAA0B,EAAQ,EAAE;IACtD,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE5D,MAAM,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,KAAK,IAAI;QAC3D,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC;QACpC,CAAC,CAAC,GAAS,EAAE,CAAC,SAAS,CAAC;IAE5B,IAAI,CAAC;QACD,cAAc,CAAC;YACX,UAAU,EAAE,MAAM,CAAC,QAAQ;YAC3B,SAAS,EAAE,MAAM,CAAC,oBAAoB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,kBAAkB,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;YAChG,eAAe,EAAE,YAAY;YAC7B,KAAK,EAAE,iBAAiB,MAAM,CAAC,WAAW,QAAQ;SACrD,CAAC,CAAC;IACP,CAAC;YAAS,CAAC;QACP,kBAAkB,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;AACL,CAAC,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,CAAC","sourcesContent":["import { rmSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { compileProject, type SourceModule } from \"../compile.js\";\n\ntype CompileStoreParams = {\n    storeDir: string;\n    files: SourceModule[];\n    packageName: string;\n    requiresEnvReference?: boolean;\n};\n\nconst EMIT_OPTIONS = {\n    declaration: true,\n    removeComments: false,\n    sourceMap: false,\n    declarationMap: false,\n    rootDir: \".\",\n    outDir: \".\",\n};\n\nconst ENV_REFERENCE_FILE = \"__gtkx-env__.d.ts\";\n\nconst writeEnvReference = (storeDir: string): (() => void) => {\n    writeFileSync(join(storeDir, ENV_REFERENCE_FILE), \"/// <reference types=\\\"@gtkx/react/env\\\" />\\n\");\n\n    return () => {\n        rmSync(join(storeDir, ENV_REFERENCE_FILE), { force: true });\n    };\n};\n\nconst compileStore = (params: CompileStoreParams): void => {\n    const fileNames = params.files.map((file) => file.fileName);\n\n    const removeEnvReference = params.requiresEnvReference === true\n        ? writeEnvReference(params.storeDir)\n        : (): void => undefined;\n\n    try {\n        compileProject({\n            projectDir: params.storeDir,\n            fileNames: params.requiresEnvReference === true ? [ENV_REFERENCE_FILE, ...fileNames] : fileNames,\n            compilerOptions: EMIT_OPTIONS,\n            label: `the generated ${params.packageName} store`,\n        });\n    } finally {\n        removeEnvReference();\n    }\n\n    for (const file of params.files) {\n        rmSync(join(params.storeDir, file.fileName), { force: true });\n    }\n};\n\nexport { compileStore };\n"]}

package/dist/store/gi/callable-doc.d.ts

@@ -0,0 +1,11 @@
+import type { GirFunction } from "../../gir/function.js";
+import type { ModuleContext } from "../../writer/context.js";
+import type { JsDocSpec } from "../../writer/doc.js";
+type CallableDocOptions = {
+    finishFn?: GirFunction | undefined;
+    renames?: Map<string, string> | undefined;
+};
+declare const callableSpec: (context: ModuleContext, callable: GirFunction, options: CallableDocOptions) => JsDocSpec;
+declare const callableDoc: (context: ModuleContext, callable: GirFunction, options?: CallableDocOptions) => string;
+export { callableDoc, callableSpec };
+//# sourceMappingURL=callable-doc.d.ts.map

package/dist/store/gi/callable-doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callable-doc.d.ts","sourceRoot":"","sources":["../../../src/store/gi/callable-doc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAarD,KAAK,kBAAkB,GAAG;IACtB,QAAQ,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACnC,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC7C,CAAC;AAkEF,QAAA,MAAM,YAAY,GAAI,SAAS,aAAa,EAAE,UAAU,WAAW,EAAE,SAAS,kBAAkB,KAAG,SAWjG,CAAC;AAEH,QAAA,MAAM,WAAW,GAAI,SAAS,aAAa,EAAE,UAAU,WAAW,EAAE,UAAS,kBAAuB,KAAG,MACM,CAAC;AAE9G,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC"}

package/dist/store/gi/callable-doc.js

@@ -0,0 +1,62 @@
+import { shouldOmitPrimaryReturn } from "../../analysis/descriptor-render.js";
+import { nulTerminatedByteParams } from "../../analysis/nul-terminated-bytes.js";
+import { documentedParameters, parameterIdentifier, renamesWithInstance, } from "../../analysis/param-structure.js";
+import { renderJsDoc } from "../../writer/doc.js";
+import { annotationSpec, THROWS_TEXT } from "./doc-spec.js";
+import { isCallbackParameter, returnedOutParameters } from "./method.js";
+const WHITESPACE_RUN_PATTERN = /\s+/g;
+const nulTerminatedNote = (context, callable) => {
+    const parameters = nulTerminatedByteParams(context.library, callable);
+    if (parameters.length === 0) {
+        return undefined;
+    }
+    const names = parameters.map((parameter) => `\`${parameter.name}\``).join(", ");
+    return [
+        `The C function reads ${names} as a NUL-terminated string, so it stops at the`,
+        "first zero byte and drops every byte after it without reporting an error.",
+        "Pass binary data through a `GLib.Bytes` route such as `GLib.Variant.newFromBytes`",
+        "instead.",
+    ].join("\n");
+};
+const tupleBullet = (name, doc) => {
+    const text = (doc ?? "").replaceAll(WHITESPACE_RUN_PATTERN, " ").trim();
+    return text.length === 0 ? undefined : `- \`${name}\`: ${text}`;
+};
+const tupleReturnsText = (primary, outs) => {
+    const bullets = [
+        tupleBullet("result", primary),
+        ...outs.map(({ parameter, index }) => tupleBullet(parameterIdentifier(parameter, index), parameter.doc)),
+    ].filter((bullet) => bullet !== undefined);
+    return bullets.length === 0 ? undefined : `Tuple of:\n\n${bullets.join("\n")}`;
+};
+const returnsText = (context, fn) => {
+    const outs = returnedOutParameters(context, fn);
+    const isPrimaryOmitted = shouldOmitPrimaryReturn(context.library, fn.returnValue);
+    const primary = isPrimaryOmitted ? undefined : fn.returnValue.doc;
+    if (outs.length === 0) {
+        return primary;
+    }
+    if (isPrimaryOmitted && outs.length === 1) {
+        return outs[0]?.parameter.doc;
+    }
+    return tupleReturnsText(primary, outs);
+};
+const docIdentifiers = (callable, renames) => {
+    const identifiers = renamesWithInstance(callable.parameters, callable.instance);
+    const overrides = renames ?? new Map();
+    for (const [girName, declaredName] of overrides) {
+        identifiers.set(girName, declaredName);
+    }
+    return identifiers;
+};
+const canCallableThrow = (callable, finishFn) => callable.throws || finishFn?.throws === true;
+const callableSpec = (context, callable, options) => ({
+    ...annotationSpec(callable.annotations),
+    identifiers: docIdentifiers(callable, options.renames),
+    params: documentedParameters(context.library, callable, (parameter) => options.finishFn !== undefined && isCallbackParameter(context, parameter), options.renames),
+    returns: returnsText(context, options.finishFn ?? callable),
+    throws: canCallableThrow(callable, options.finishFn) ? THROWS_TEXT : undefined,
+});
+const callableDoc = (context, callable, options = {}) => renderJsDoc(callable.doc, nulTerminatedNote(context, callable), callableSpec(context, callable, options));
+export { callableDoc, callableSpec };
+//# sourceMappingURL=callable-doc.js.map

package/dist/store/gi/callable-doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callable-doc.js","sourceRoot":"","sources":["../../../src/store/gi/callable-doc.ts"],"names":[],"mappings":"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","sourcesContent":["import type { GirFunction } from \"../../gir/function.js\";\nimport type { GirCallable } from \"../../gir/parameter.js\";\nimport type { ModuleContext } from \"../../writer/context.js\";\nimport type { JsDocSpec } from \"../../writer/doc.js\";\nimport { shouldOmitPrimaryReturn } from \"../../analysis/descriptor-render.js\";\nimport { nulTerminatedByteParams } from \"../../analysis/nul-terminated-bytes.js\";\nimport {\n    documentedParameters,\n    type InputParameter,\n    parameterIdentifier,\n    renamesWithInstance,\n} from \"../../analysis/param-structure.js\";\nimport { renderJsDoc } from \"../../writer/doc.js\";\nimport { annotationSpec, THROWS_TEXT } from \"./doc-spec.js\";\nimport { isCallbackParameter, returnedOutParameters } from \"./method.js\";\n\ntype CallableDocOptions = {\n    finishFn?: GirFunction | undefined;\n    renames?: Map<string, string> | undefined;\n};\n\nconst WHITESPACE_RUN_PATTERN = /\\s+/g;\n\nconst nulTerminatedNote = (context: ModuleContext, callable: GirCallable): string | undefined => {\n    const parameters = nulTerminatedByteParams(context.library, callable);\n\n    if (parameters.length === 0) {\n        return undefined;\n    }\n\n    const names = parameters.map((parameter) => `\\`${parameter.name}\\``).join(\", \");\n\n    return [\n        `The C function reads ${names} as a NUL-terminated string, so it stops at the`,\n        \"first zero byte and drops every byte after it without reporting an error.\",\n        \"Pass binary data through a `GLib.Bytes` route such as `GLib.Variant.newFromBytes`\",\n        \"instead.\",\n    ].join(\"\\n\");\n};\n\nconst tupleBullet = (name: string, doc: string | undefined): string | undefined => {\n    const text = (doc ?? \"\").replaceAll(WHITESPACE_RUN_PATTERN, \" \").trim();\n\n    return text.length === 0 ? undefined : `- \\`${name}\\`: ${text}`;\n};\n\nconst tupleReturnsText = (primary: string | undefined, outs: InputParameter[]): string | undefined => {\n    const bullets = [\n        tupleBullet(\"result\", primary),\n        ...outs.map(({ parameter, index }) => tupleBullet(parameterIdentifier(parameter, index), parameter.doc)),\n    ].filter((bullet) => bullet !== undefined);\n\n    return bullets.length === 0 ? undefined : `Tuple of:\\n\\n${bullets.join(\"\\n\")}`;\n};\n\nconst returnsText = (context: ModuleContext, fn: GirFunction): string | undefined => {\n    const outs = returnedOutParameters(context, fn);\n    const isPrimaryOmitted = shouldOmitPrimaryReturn(context.library, fn.returnValue);\n    const primary = isPrimaryOmitted ? undefined : fn.returnValue.doc;\n\n    if (outs.length === 0) {\n        return primary;\n    }\n\n    if (isPrimaryOmitted && outs.length === 1) {\n        return outs[0]?.parameter.doc;\n    }\n\n    return tupleReturnsText(primary, outs);\n};\n\nconst docIdentifiers = (callable: GirFunction, renames: Map<string, string> | undefined): Map<string, string> => {\n    const identifiers = renamesWithInstance(callable.parameters, callable.instance);\n    const overrides = renames ?? new Map<string, string>();\n\n    for (const [girName, declaredName] of overrides) {\n        identifiers.set(girName, declaredName);\n    }\n\n    return identifiers;\n};\n\nconst canCallableThrow = (callable: GirFunction, finishFn: GirFunction | undefined): boolean =>\n    callable.throws || finishFn?.throws === true;\n\nconst callableSpec = (context: ModuleContext, callable: GirFunction, options: CallableDocOptions): JsDocSpec => ({\n    ...annotationSpec(callable.annotations),\n    identifiers: docIdentifiers(callable, options.renames),\n    params: documentedParameters(\n        context.library,\n        callable,\n        (parameter) => options.finishFn !== undefined && isCallbackParameter(context, parameter),\n        options.renames,\n    ),\n    returns: returnsText(context, options.finishFn ?? callable),\n    throws: canCallableThrow(callable, options.finishFn) ? THROWS_TEXT : undefined,\n});\n\nconst callableDoc = (context: ModuleContext, callable: GirFunction, options: CallableDocOptions = {}): string =>\n    renderJsDoc(callable.doc, nulTerminatedNote(context, callable), callableSpec(context, callable, options));\n\nexport { callableDoc, callableSpec };\n"]}