@gtkx/codegen 1.0.0-rc.4 → 1.1.0

package/dist/khronos/select.js

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

package/dist/khronos/select.js.map

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

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

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

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

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

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/internal\";\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/internal\";\nexport { readBuiltinElements, type BuiltinElements };\n"]}
+{"version":3,"file":"element-config.js","sourceRoot":"","sources":["../../src/react/element-config.ts"],"names":[],"mappings":";;;;;;;;AACA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAiBtC,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AACnC,MAAM,aAAa,GAAG,IAAI,iBAAiB,EAAE,CAAC;AAE9C,MAAM,oBAAoB,GAAG,CAAC,UAAkB,EAAe,EAAE;IAC7D,MAAM,IAAI,GAAgB,IAAI,GAAG,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,WAAW,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAEjE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,eAAyB,EAAE,OAAoB,EAAY,EAAE,CACpF,eAAe,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;IAC3B,IAAI,GAAG,KAAK,iBAAiB,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;AACvG,CAAC,CAAC,CAAC;AAEP,MAAM,qBAAqB,GAAG,KAAK,EAAE,UAAkB,EAA2C,EAAE;IAChG,MAAM,SAAS,GAAG,eAAe,UAAU,EAAE,CAAC;IAE9C,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,kCAAC,kBAAkB,CAAC,SAAS,EAAC,CAE3D,CAAC;IAEF,OAAO,QAAQ,CAAC,gBAAgB,IAAI,EAAE,CAAC;AAC3C,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,MAAuB,EAAE,IAAY,EAAE,MAAsB,EAAQ,EAAE;IAChG,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;IACtC,CAAC;IAED,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IAC/F,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,CAAC,MAAuB,EAAE,QAAwC,EAAQ,EAAE;IACvG,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,mBAAmB,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,mBAAmB,GAAG,KAAK,EAAE,eAAyB,EAAE,UAAkB,EAA4B,EAAE;IAC1G,MAAM,OAAO,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,iBAAiB,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IAChE,MAAM,MAAM,GAAoB,EAAE,UAAU,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAElG,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACnC,sBAAsB,CAAC,MAAM,EAAE,MAAM,qBAAqB,CAAC,UAAU,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC;AAGF,OAAO,EAAE,mBAAmB,EAAwB,CAAC","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,13 +1,7 @@
+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";
-/** A named export in a module, referenced as plain data (the module is never imported at runtime). */
-type ModuleExport = {
-    /** Specifier the export is imported from. */
-    module: string;
-    /** Identifier the module exports it under. */
-    export: string;
-};
+import { type StoreOptions } from "./store/store-fs.js";
 type GlCodegenOptions = {
     registryPath: string;
     overrideExports: Set<string>;
@@ -54,6 +48,10 @@ type CodegenRunnerResult = {
  * store or the React element config changed, unless `options.isForced` is set. Pass the spread of
  * `resolveStore(projectRoot)` for everything but `libraries` and `girPath`.
  *
+ * Every store already on disk is linked at its `linkDir` before anything is generated, so a link an install
+ * pruned out of `node_modules` is restored without regenerating the store, and the gi store is reachable
+ * under its own specifier while the jsx store is type checked.
+ *
  * @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.

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,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKxD,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,sGAAsG;AACtG,KAAK,YAAY,GAAG;IAChB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,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"}
+{"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;AAKjE,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEzE,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;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,UAAU,GAAU,SAAS,oBAAoB,KAAG,OAAO,CAAC,mBAAmB,CAUpF,CAAC;AAEF,QAAA,MAAM,YAAY,GAAI,SAAS,gBAAgB,KAAG,kBAmBjD,CAAC;AA2FF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,CAAC"}

package/dist/runner.js

@@ -5,12 +5,18 @@ import { isGiStoreFresh } from "./fingerprint.js";
 import { runGiCodegen } from "./gi.js";
 import { Library } from "./gir/library.js";
 import { generateGlModules } from "./khronos/pipeline.js";
+import { sweepStagingDirs } from "./staging.js";
+import { ensureStoreLink } from "./store/store-fs.js";
 /**
  * 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`.
  *
+ * Every store already on disk is linked at its `linkDir` before anything is generated, so a link an install
+ * pruned out of `node_modules` is restored without regenerating the store, and the gi store is reachable
+ * under its own specifier while the jsx store is type checked.
+ *
  * @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.
@@ -78,11 +84,21 @@ const emitStoresWithConfig = async (config) => {
     }
     return emitJsxStore({ options, jsx, gi, loadLibrary, isGiRegenerated, namespaces });
 };
+const prepareStores = (stores) => {
+    for (const store of stores) {
+        if (store === undefined) {
+            continue;
+        }
+        sweepStagingDirs(store.storeDir);
+        ensureStoreLink(store);
+    }
+};
 const emitStores = async (options) => {
     const { gi, jsx, libraries, girPath } = options;
     if (girPath.length === 0) {
         throw new Error("codegen needs at least one GIR search path; pass the result of resolveGirPath");
     }
+    prepareStores([gi, jsx]);
     return emitStoresWithConfig({ options, gi, jsx, libraries, girPath });
 };
 export { runCodegen, runGlCodegen };

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 { 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\n/** A named export in a module, referenced as plain data (the module is never imported at runtime). */\ntype ModuleExport = {\n    /** Specifier the export is imported from. */\n    module: string;\n    /** Identifier the module exports it under. */\n    export: string;\n};\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"]}
+{"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 { 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\";\nimport { sweepStagingDirs } from \"./staging.js\";\nimport { ensureStoreLink, type StoreOptions } from \"./store/store-fs.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 * Every store already on disk is linked at its `linkDir` before anything is generated, so a link an install\n * pruned out of `node_modules` is restored without regenerating the store, and the gi store is reachable\n * under its own specifier while the jsx store is type checked.\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 prepareStores = (stores: (StoreOptions | undefined)[]): void => {\n    for (const store of stores) {\n        if (store === undefined) {\n            continue;\n        }\n\n        sweepStagingDirs(store.storeDir);\n        ensureStoreLink(store);\n    }\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    prepareStores([gi, jsx]);\n\n    return emitStoresWithConfig({ options, gi, jsx, libraries, girPath });\n};\n\nexport { runCodegen, runGlCodegen, type CodegenRunnerOptions, type CodegenRunnerResult };\n"]}

package/dist/staging.d.ts

@@ -0,0 +1,5 @@
+declare const sweepStrandedDirs: (parentDir: string, prefix: string) => void;
+declare const sweepStagingDirs: (target: string) => void;
+declare const createStagingDir: (target: string) => string;
+export { createStagingDir, sweepStagingDirs, sweepStrandedDirs };
+//# sourceMappingURL=staging.d.ts.map

package/dist/staging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staging.d.ts","sourceRoot":"","sources":["../src/staging.ts"],"names":[],"mappings":"AAiDA,QAAA,MAAM,iBAAiB,GAAI,WAAW,MAAM,EAAE,QAAQ,MAAM,KAAG,IAM9D,CAAC;AAEF,QAAA,MAAM,gBAAgB,GAAI,QAAQ,MAAM,KAAG,IAE1C,CAAC;AAEF,QAAA,MAAM,gBAAgB,GAAI,QAAQ,MAAM,KAAG,MAK1C,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/staging.js

@@ -0,0 +1,57 @@
+import { mkdirSync, mkdtempSync, readdirSync, rmSync } from "node:fs";
+import { basename, dirname, join } from "node:path";
+const STAGING_SUFFIX = ".tmp-";
+const OWNER_PATTERN = /^(?<pid>\d+)-/;
+const errorCode = (error) => error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : undefined;
+const isOwnerRunning = (pid) => {
+    if (!Number.isSafeInteger(pid) || pid <= 0) {
+        return false;
+    }
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return errorCode(error) === "EPERM";
+    }
+};
+const isStranded = (entry, prefix) => {
+    if (!entry.startsWith(prefix)) {
+        return false;
+    }
+    const owner = OWNER_PATTERN.exec(entry.slice(prefix.length))?.groups?.pid;
+    return owner === undefined || !isOwnerRunning(Number(owner));
+};
+const readEntries = (parentDir) => {
+    try {
+        return readdirSync(parentDir);
+    }
+    catch {
+        return [];
+    }
+};
+const removeStrandedDir = (path) => {
+    try {
+        rmSync(path, { recursive: true, force: true });
+    }
+    catch {
+        return;
+    }
+};
+const sweepStrandedDirs = (parentDir, prefix) => {
+    for (const entry of readEntries(parentDir)) {
+        if (isStranded(entry, prefix)) {
+            removeStrandedDir(join(parentDir, entry));
+        }
+    }
+};
+const sweepStagingDirs = (target) => {
+    sweepStrandedDirs(dirname(target), `${basename(target)}${STAGING_SUFFIX}`);
+};
+const createStagingDir = (target) => {
+    mkdirSync(dirname(target), { recursive: true });
+    sweepStagingDirs(target);
+    return mkdtempSync(`${target}${STAGING_SUFFIX}${String(process.pid)}-`);
+};
+export { createStagingDir, sweepStagingDirs, sweepStrandedDirs };
+//# sourceMappingURL=staging.js.map

package/dist/staging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staging.js","sourceRoot":"","sources":["../src/staging.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdirSync, mkdtempSync, readdirSync, rmSync } from \"node:fs\";\nimport { basename, dirname, join } from \"node:path\";\n\nconst STAGING_SUFFIX = \".tmp-\";\nconst OWNER_PATTERN = /^(?<pid>\\d+)-/;\n\nconst errorCode = (error: unknown): string | undefined =>\n    error instanceof Error && \"code\" in error && typeof error.code === \"string\" ? error.code : undefined;\n\nconst isOwnerRunning = (pid: number): boolean => {\n    if (!Number.isSafeInteger(pid) || pid <= 0) {\n        return false;\n    }\n\n    try {\n        process.kill(pid, 0);\n\n        return true;\n    } catch (error) {\n        return errorCode(error) === \"EPERM\";\n    }\n};\n\nconst isStranded = (entry: string, prefix: string): boolean => {\n    if (!entry.startsWith(prefix)) {\n        return false;\n    }\n\n    const owner = OWNER_PATTERN.exec(entry.slice(prefix.length))?.groups?.pid;\n\n    return owner === undefined || !isOwnerRunning(Number(owner));\n};\n\nconst readEntries = (parentDir: string): string[] => {\n    try {\n        return readdirSync(parentDir);\n    } catch {\n        return [];\n    }\n};\n\nconst removeStrandedDir = (path: string): void => {\n    try {\n        rmSync(path, { recursive: true, force: true });\n    } catch {\n        return;\n    }\n};\n\nconst sweepStrandedDirs = (parentDir: string, prefix: string): void => {\n    for (const entry of readEntries(parentDir)) {\n        if (isStranded(entry, prefix)) {\n            removeStrandedDir(join(parentDir, entry));\n        }\n    }\n};\n\nconst sweepStagingDirs = (target: string): void => {\n    sweepStrandedDirs(dirname(target), `${basename(target)}${STAGING_SUFFIX}`);\n};\n\nconst createStagingDir = (target: string): string => {\n    mkdirSync(dirname(target), { recursive: true });\n    sweepStagingDirs(target);\n\n    return mkdtempSync(`${target}${STAGING_SUFFIX}${String(process.pid)}-`);\n};\n\nexport { createStagingDir, sweepStagingDirs, sweepStrandedDirs };\n"]}

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

@@ -6,5 +6,5 @@ type CompileStoreParams = {
     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,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAClC,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,EAAoC,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAEpF,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,IAuBlD,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/store/compile-store.js

@@ -17,14 +17,16 @@ const writeEnvReference = (storeDir) => {
     };
 };
 const compileStore = (params) => {
-    const fileNames = params.files.map((file) => file.fileName);
     const removeEnvReference = params.requiresEnvReference === true
         ? writeEnvReference(params.storeDir)
         : () => undefined;
+    const files = params.requiresEnvReference === true
+        ? [{ fileName: ENV_REFERENCE_FILE }, ...params.files]
+        : params.files;
     try {
         compileProject({
             projectDir: params.storeDir,
-            fileNames: params.requiresEnvReference === true ? [ENV_REFERENCE_FILE, ...fileNames] : fileNames,
+            files,
             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;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,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    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, 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,EAAuC,MAAM,eAAe,CAAC;AASpF,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,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,MAAM,KAAK,GAAkB,MAAM,CAAC,oBAAoB,KAAK,IAAI;QAC7D,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC;QACrD,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;IAEnB,IAAI,CAAC;QACD,cAAc,CAAC;YACX,UAAU,EAAE,MAAM,CAAC,QAAQ;YAC3B,KAAK;YACL,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 ProjectFile, 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 removeEnvReference = params.requiresEnvReference === true\n        ? writeEnvReference(params.storeDir)\n        : (): void => undefined;\n\n    const files: ProjectFile[] = params.requiresEnvReference === true\n        ? [{ fileName: ENV_REFERENCE_FILE }, ...params.files]\n        : params.files;\n\n    try {\n        compileProject({\n            projectDir: params.storeDir,\n            files,\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"]}

package/dist/store/gi/callables.d.ts

@@ -1,5 +1,6 @@
 import type { GirFunction } from "../../gir/function.js";
 import type { ModuleContext } from "../../writer/context.js";
+import type { JsDocSpec } from "../../writer/doc.js";
 type Callables = {
     constructors: GirFunction[];
     functions: GirFunction[];
@@ -10,6 +11,10 @@ type InstanceScope = {
     methodByName: Map<string, GirFunction>;
     statics: GirFunction[];
 };
+type StaticMember = {
+    callable: GirFunction;
+    name: string;
+};
 type InstanceMemberRenderer = (context: ModuleContext, callable: GirFunction, scope: InstanceScope, nameOverride?: string) => string | undefined;
 type PlainTypeMembersOptions = {
     context: ModuleContext;
@@ -19,6 +24,7 @@ type PlainTypeMembersOptions = {
 };
 declare const renderInstanceMethodSignature: InstanceMemberRenderer;
 declare const renderClassInstanceMember: InstanceMemberRenderer;
+declare const instanceMemberSpec: (context: ModuleContext, callable: GirFunction, scope: InstanceScope) => JsDocSpec;
 declare const instanceScope: (ownerName: string, callables: Callables) => InstanceScope;
 declare const dedupeCallables: (callables: GirFunction[]) => GirFunction[];
 declare const generateBindings: (context: ModuleContext, callables: Callables) => void;
@@ -32,11 +38,12 @@ declare const renderStaticSignature: (context: ModuleContext, callable: GirFunct
     name: string;
     signature: string;
 } | undefined;
-declare const classConstructorMemberNames: (context: ModuleContext, callables: Callables) => string[];
+declare const staticMembers: (context: ModuleContext, callables: Callables) => StaticMember[];
+declare const constructorMemberNames: (context: ModuleContext, constructors: GirFunction[]) => string[];
 declare const renderStaticHead: (context: ModuleContext, callables: Callables, ownerClassName: string) => string[];
 declare const renderPlainTypeMembers: (options: PlainTypeMembersOptions) => {
     members: string[];
     claimedNames: Set<string>;
 };
-export { renderInstanceMethodSignature, renderClassInstanceMember, instanceScope, dedupeCallables, generateBindings, matchStaticFinishFunction, indexMethodsByName, isEmittableCallable, renderStaticSignature, classConstructorMemberNames, renderStaticHead, renderPlainTypeMembers, type Callables, type InstanceScope, };
+export { renderInstanceMethodSignature, renderClassInstanceMember, instanceMemberSpec, instanceScope, dedupeCallables, generateBindings, matchStaticFinishFunction, indexMethodsByName, isEmittableCallable, renderStaticSignature, constructorMemberNames, renderStaticHead, renderPlainTypeMembers, staticMembers, type Callables, type InstanceMemberRenderer, type InstanceScope, };
 //# sourceMappingURL=callables.d.ts.map