@gtkx/codegen 0.21.0 → 1.0.0-rc.2

package/dist/react/element-config.js

@@ -0,0 +1,61 @@
+import { readdirSync } from "node:fs";
+const CONFIG_ENTRYPOINT = "config";
+const CONFIG_SUFFIX = `/${CONFIG_ENTRYPOINT}`;
+const presentNamespaceDirs = (giStoreDir) => {
+    const dirs = new Set();
+    const entries = readdirSync(giStoreDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            dirs.add(entry.name);
+        }
+    }
+    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;
+    }
+    return sub.endsWith(CONFIG_SUFFIX) && present.has(sub.slice(0, sub.length - CONFIG_SUFFIX.length));
+});
+const importBuiltinElements = async (entrypoint) => {
+    const specifier = `@gtkx/react/${entrypoint}`;
+    const imported = (await import(/* @vite-ignore */ specifier));
+    return imported.BUILTIN_ELEMENTS ?? {};
+};
+const applyBuiltinElement = (target, type, config) => {
+    if (config.component !== undefined) {
+        target.components[type] = config.component;
+    }
+    if (config.props !== undefined) {
+        target.props[type] = config.props;
+    }
+    if (config.lazy === 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);
+    }
+};
+const readBuiltinElements = async (reactSubexports, giStoreDir) => {
+    const present = presentNamespaceDirs(giStoreDir);
+    const entrypoints = configEntrypoints(reactSubexports, present);
+    const result = { components: {}, lazyElements: [], props: {} };
+    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

@@ -0,0 +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\";\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 };\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};\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.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: {} };\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"]}

package/dist/runner.d.ts

@@ -1,55 +1,44 @@
-import { type GiStoreOptions } from "./gi-store.js";
-import { type JsxStoreOptions } from "./jsx-store.js";
-/**
- * Options for {@link CodegenRunner}.
- */
-export type CodegenRunnerOptions = {
-    /** Resolved `Name-Version` namespace identifiers to generate. */
-    readonly libraries: readonly string[];
-    /** Directories searched for `.gir` files. */
-    readonly girPath: readonly string[];
-    /** Optional user slot-prop overrides keyed by JSX element name. */
-    readonly slotProps?: Readonly<Record<string, readonly string[]>>;
-    /** Target for the injected `@gtkx/gi` bindings package. */
-    readonly gi: GiStoreOptions;
-    /** Target for the injected `@gtkx/react-jsx` unit; React is skipped when omitted. */
-    readonly jsx?: JsxStoreOptions;
+import type { GiStoreOptions } from "./store/gi-store.js";
+import type { JsxStoreOptions } from "./store/jsx-store.js";
+import { type GlGenerationReport } from "./khronos/pipeline.js";
+type ModuleExport = {
+    module: string;
+    export: string;
 };
-/**
- * Result returned from {@link CodegenRunner.run}.
- */
-export type CodegenRunnerResult = {
-    /** Number of FFI namespaces produced. */
-    readonly namespaces: number;
-    /** Number of widget intrinsics emitted into `jsx.ts`. */
-    readonly widgets: number;
-    /** Wall-clock duration in milliseconds. */
-    readonly duration: number;
+type GlCodegenOptions = {
+    registryPath: string;
+    overrideExports: Set<string>;
+    outputDir: string;
+    resolveFrom: string;
+};
+type CodegenRunnerOptions = {
+    libraries?: string[];
+    girPath?: string[];
+    gi?: GiStoreOptions;
+    jsx?: JsxStoreOptions | undefined;
+    reactSubexports?: string[];
+    userComponents?: Record<string, ModuleExport>;
+    userLazyElements?: string[];
+    userProps?: Record<string, ModuleExport>;
+    gl?: GlCodegenOptions;
+    force?: boolean;
+};
+type CodegenRunnerResult = {
+    regenerated: boolean;
+    namespaces: number;
+    intrinsicElements: number;
+    duration: number;
+    gl?: GlGenerationReport | undefined;
 };
 /**
- * Single-entry orchestrator for the GTKX codegen.
- *
- * Loads the GIR repository, runs the FFI pipeline per namespace, runs the
- * React pipeline once, and materializes the self-contained `@gtkx/gi` (and
- * optional `@gtkx/react-jsx`) packages into the project's `node_modules`.
- *
- * @example
- * ```ts
- * import { CodegenRunner } from "@gtkx/codegen";
+ * 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.
  *
- * await new CodegenRunner({
- *     libraries: ["Gtk-4.0", "Adw-1"],
- *     girPath: ["/usr/share/gir-1.0"],
- *     gi: { storeDir, linkDir, realFfiDir, realNativeDir, version },
- * }).run();
- * ```
+ * @param options - What to generate and where to write it.
+ * @returns A summary of what was regenerated and how long the run took.
  */
-export declare class CodegenRunner {
-    private readonly options;
-    constructor(options: CodegenRunnerOptions);
-    /**
-     * Executes the full codegen pipeline and materializes the output packages.
-     */
-    run(): Promise<CodegenRunnerResult>;
-}
+declare const runCodegen: (options: CodegenRunnerOptions) => Promise<CodegenRunnerResult>;
+export { runCodegen, type GlCodegenOptions, 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,EAAyB,KAAK,cAAc,EAAgB,MAAM,eAAe,CAAC;AAEzF,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,gBAAgB,CAAC;AAGrE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,mEAAmE;IACnE,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IACjE,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAC5B,qFAAqF;IACrF,QAAQ,CAAC,GAAG,CAAC,EAAE,eAAe,CAAC;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,aAAa;IACV,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,oBAAoB;IAE1D;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,mBAAmB,CAAC;CA6B5C"}
+{"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;AAK5D,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,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;AA8FF,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,CAAC"}

package/dist/runner.js

@@ -1,60 +1,87 @@
-import { generateNamespaceModule } from "./ffi/pipeline.js";
-import { computeFingerprint } from "./fingerprint.js";
-import { writeGiStore } from "./gi-store.js";
-import { loadGirRepository } from "./gir/repository.js";
-import { writeJsxStore } from "./jsx-store.js";
-import { generateReactFiles } from "./react/pipeline.js";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { checkModules } from "./compile.js";
+import { isGiStoreFresh } from "./fingerprint.js";
+import { runGiCodegen } from "./gi.js";
+import { Library } from "./gir/library.js";
+import { generateGlModules } from "./khronos/pipeline.js";
 /**
- * Single-entry orchestrator for the GTKX codegen.
+ * 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.
  *
- * Loads the GIR repository, runs the FFI pipeline per namespace, runs the
- * React pipeline once, and materializes the self-contained `@gtkx/gi` (and
- * optional `@gtkx/react-jsx`) packages into the project's `node_modules`.
- *
- * @example
- * ```ts
- * import { CodegenRunner } from "@gtkx/codegen";
- *
- * await new CodegenRunner({
- *     libraries: ["Gtk-4.0", "Adw-1"],
- *     girPath: ["/usr/share/gir-1.0"],
- *     gi: { storeDir, linkDir, realFfiDir, realNativeDir, version },
- * }).run();
- * ```
+ * @param options - What to generate and where to write it.
+ * @returns A summary of what was regenerated and how long the run took.
  */
-export class CodegenRunner {
-    options;
-    constructor(options) {
-        this.options = options;
+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,
+        namespaces: store.namespaces,
+        intrinsicElements: store.intrinsicElements,
+        duration: Date.now() - start,
+        gl,
+    };
+};
+const emitGlModules = (options) => {
+    const { files, report } = generateGlModules({
+        registryPath: options.registryPath,
+        overrideExports: options.overrideExports,
+    });
+    checkModules({
+        modules: [...files].map(([fileName, source]) => ({ fileName, source })),
+        resolveFrom: options.resolveFrom,
+        label: "the generated gl modules",
+    });
+    mkdirSync(options.outputDir, { recursive: true });
+    for (const [fileName, source] of files) {
+        writeFileSync(join(options.outputDir, fileName), source);
+    }
+    return report;
+};
+const jsxUserOptions = (options) => ({
+    reactSubexports: options.reactSubexports ?? [],
+    userComponents: options.userComponents ?? {},
+    userLazyElements: options.userLazyElements ?? [],
+    userProps: options.userProps ?? {},
+});
+const emitJsxStore = async (input) => {
+    const { options, jsx, gi, loadLibrary, giRegenerated, 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,
+    });
+    return {
+        regenerated: giRegenerated || jsxResult.regenerated,
+        namespaces,
+        intrinsicElements: jsxResult.intrinsicElementCount,
+    };
+};
+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 namespaces = isGiRegenerated ? runGiCodegen(loadLibrary(), gi, libraries, girPath) : 0;
+    if (jsx === undefined) {
+        return { regenerated: isGiRegenerated, namespaces, intrinsicElements: 0 };
     }
-    /**
-     * Executes the full codegen pipeline and materializes the output packages.
-     */
-    async run() {
-        const start = Date.now();
-        const repository = loadGirRepository(this.options.libraries, this.options.girPath);
-        const namespaces = [];
-        for (const namespace of repository.namespaces.values()) {
-            const { source } = generateNamespaceModule(namespace, repository);
-            namespaces.push({ directory: namespace.name.toLowerCase(), rawSource: source });
-        }
-        const libraries = [...this.options.libraries];
-        writeGiStore(this.options.gi, namespaces, {
-            value: computeFingerprint(repository.girFiles, libraries),
-            girFiles: repository.girFiles,
-            libraries,
-        });
-        let widgetCount = 0;
-        if (this.options.jsx !== undefined) {
-            const reactPipeline = generateReactFiles(repository, this.options.slotProps);
-            writeJsxStore(this.options.jsx, reactPipeline.files);
-            widgetCount = reactPipeline.widgetCount;
-        }
-        return {
-            namespaces: repository.namespaces.size,
-            widgets: widgetCount,
-            duration: Date.now() - start,
-        };
+    return emitJsxStore({ options, jsx, gi, loadLibrary, giRegenerated: 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 };
     }
-}
+    return emitStoresWithConfig({ options, gi, jsx, libraries, girPath });
+};
+export { runCodegen };
 //# sourceMappingURL=runner.js.map

package/dist/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAA8C,YAAY,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAwB,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AA8BzD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,aAAa;IACO;IAA7B,YAA6B,OAA6B;QAA7B,YAAO,GAAP,OAAO,CAAsB;IAAG,CAAC;IAE9D;;OAEG;IACH,KAAK,CAAC,GAAG;QACL,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAEnF,MAAM,UAAU,GAAuB,EAAE,CAAC;QAC1C,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;YACrD,MAAM,EAAE,MAAM,EAAE,GAAG,uBAAuB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YAClE,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9C,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,EAAE;YACtC,KAAK,EAAE,kBAAkB,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC;YACzD,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,SAAS;SACZ,CAAC,CAAC;QAEH,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,aAAa,GAAG,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAC7E,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;YACrD,WAAW,GAAG,aAAa,CAAC,WAAW,CAAC;QAC5C,CAAC;QAED,OAAO;YACH,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,IAAI;YACtC,OAAO,EAAE,WAAW;YACpB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAC/B,CAAC;IACN,CAAC;CACJ"}
+{"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 { 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    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} => ({\n    reactSubexports: options.reactSubexports ?? [],\n    userComponents: options.userComponents ?? {},\n    userLazyElements: options.userLazyElements ?? [],\n    userProps: options.userProps ?? {},\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    const namespaces = isGiRegenerated ? runGiCodegen(loadLibrary(), gi, libraries, girPath) : 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"]}

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

@@ -0,0 +1,11 @@
+import { type SourceModule } from "../compile.js";
+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;
+};
+declare const compileStore: (params: CompileStoreParams) => void;
+export { compileStore, type CompileStoreParams };
+//# sourceMappingURL=compile-store.d.ts.map

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

@@ -0,0 +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"}

package/dist/store/compile-store.js

@@ -0,0 +1,40 @@
+import { rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { compileProject } from "../compile.js";
+const EMIT_OPTIONS = {
+    declaration: true,
+    removeComments: false,
+    sourceMap: false,
+    declarationMap: false,
+    rootDir: ".",
+    outDir: ".",
+};
+const ENV_REFERENCE_FILE = "__gtkx-env__.d.ts";
+const writeEnvReference = (storeDir) => {
+    writeFileSync(join(storeDir, ENV_REFERENCE_FILE), "/// <reference types=\"@gtkx/react/env\" />\n");
+    return () => {
+        rmSync(join(storeDir, ENV_REFERENCE_FILE), { force: true });
+    };
+};
+const compileStore = (params) => {
+    const fileNames = params.files.map((file) => file.fileName);
+    const removeEnvReference = params.configEnv === true
+        ? writeEnvReference(params.storeDir)
+        : () => undefined;
+    try {
+        compileProject({
+            projectDir: params.storeDir,
+            fileNames: params.configEnv === true ? [ENV_REFERENCE_FILE, ...fileNames] : fileNames,
+            compilerOptions: EMIT_OPTIONS,
+            label: `the generated ${params.packageName} store`,
+        });
+    }
+    finally {
+        removeEnvReference();
+    }
+    for (const file of params.files) {
+        rmSync(join(params.storeDir, file.fileName), { force: true });
+    }
+};
+export { compileStore };
+//# sourceMappingURL=compile-store.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,5 @@
+import type { GirFunction } from "../../gir/function.js";
+import type { Library } from "../../gir/library.js";
+declare const matchAsyncFinish: (library: Library, fn: GirFunction, siblings: GirFunction[]) => GirFunction | undefined;
+export { matchAsyncFinish };
+//# sourceMappingURL=async.d.ts.map

package/dist/store/gi/async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../../../src/store/gi/async.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAIpD,QAAA,MAAM,gBAAgB,GAClB,SAAS,OAAO,EAChB,IAAI,WAAW,EACf,UAAU,WAAW,EAAE,KACxB,WAAW,GAAG,SAYhB,CAAC;AA+CF,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/store/gi/async.js

@@ -0,0 +1,45 @@
+import { inputParameters } from "../../analysis/param-structure.js";
+const matchAsyncFinish = (library, fn, siblings) => {
+    if (!hasCanonicalAsyncCallback(library, fn)) {
+        return undefined;
+    }
+    const finishFn = findFinishSibling(fn, siblings);
+    if (finishFn === undefined || !isPromisifiableFinish(library, finishFn)) {
+        return undefined;
+    }
+    return finishFn;
+};
+const findFinishSibling = (fn, siblings) => {
+    const annotated = fn.finishFunc;
+    if (annotated !== undefined) {
+        return siblings.find((sibling) => sibling.name === annotated || sibling.cIdentifier === annotated);
+    }
+    if (fn.name.endsWith("_finish")) {
+        return undefined;
+    }
+    const root = fn.name.endsWith("_async") ? fn.name.slice(0, -"_async".length) : fn.name;
+    const finishName = `${root}_finish`;
+    return siblings.find((sibling) => sibling.name === finishName);
+};
+const callbackParameterName = (library, ref) => {
+    if (ref === undefined || library.typeFor(ref)?.kind !== "callback") {
+        return undefined;
+    }
+    return library.nameFor(ref)?.typeName;
+};
+const hasCanonicalAsyncCallback = (library, fn) => {
+    const callbackNames = fn.parameters
+        .map((parameter) => callbackParameterName(library, parameter.type))
+        .filter((name) => name !== undefined);
+    return callbackNames.length === 1 && callbackNames[0] === "AsyncReadyCallback";
+};
+const isPromisifiableFinish = (library, finishFn) => {
+    const inputs = inputParameters(library, finishFn);
+    if (inputs.length !== 1) {
+        return false;
+    }
+    const only = inputs[0];
+    return only?.parameter.type !== undefined && library.nameFor(only.parameter.type)?.typeName === "AsyncResult";
+};
+export { matchAsyncFinish };
+//# sourceMappingURL=async.js.map

package/dist/store/gi/async.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.js","sourceRoot":"","sources":["../../../src/store/gi/async.ts"],"names":[],"mappings":"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","sourcesContent":["import type { GirFunction } from \"../../gir/function.js\";\nimport type { Library } from \"../../gir/library.js\";\nimport type { TypeId } from \"../../gir/type-id.js\";\nimport { inputParameters } from \"../../analysis/param-structure.js\";\n\nconst matchAsyncFinish = (\n    library: Library,\n    fn: GirFunction,\n    siblings: GirFunction[],\n): GirFunction | undefined => {\n    if (!hasCanonicalAsyncCallback(library, fn)) {\n        return undefined;\n    }\n\n    const finishFn = findFinishSibling(fn, siblings);\n\n    if (finishFn === undefined || !isPromisifiableFinish(library, finishFn)) {\n        return undefined;\n    }\n\n    return finishFn;\n};\n\nconst findFinishSibling = (fn: GirFunction, siblings: GirFunction[]): GirFunction | undefined => {\n    const annotated = fn.finishFunc;\n\n    if (annotated !== undefined) {\n        return siblings.find((sibling) => sibling.name === annotated || sibling.cIdentifier === annotated);\n    }\n\n    if (fn.name.endsWith(\"_finish\")) {\n        return undefined;\n    }\n\n    const root = fn.name.endsWith(\"_async\") ? fn.name.slice(0, -\"_async\".length) : fn.name;\n    const finishName = `${root}_finish`;\n\n    return siblings.find((sibling) => sibling.name === finishName);\n};\n\nconst callbackParameterName = (library: Library, ref: TypeId | undefined): string | undefined => {\n    if (ref === undefined || library.typeFor(ref)?.kind !== \"callback\") {\n        return undefined;\n    }\n\n    return library.nameFor(ref)?.typeName;\n};\n\nconst hasCanonicalAsyncCallback = (library: Library, fn: GirFunction): boolean => {\n    const callbackNames = fn.parameters\n        .map((parameter) => callbackParameterName(library, parameter.type))\n        .filter((name): name is string => name !== undefined);\n\n    return callbackNames.length === 1 && callbackNames[0] === \"AsyncReadyCallback\";\n};\n\nconst isPromisifiableFinish = (library: Library, finishFn: GirFunction): boolean => {\n    const inputs = inputParameters(library, finishFn);\n\n    if (inputs.length !== 1) {\n        return false;\n    }\n\n    const only = inputs[0];\n\n    return only?.parameter.type !== undefined && library.nameFor(only.parameter.type)?.typeName === \"AsyncResult\";\n};\n\nexport { matchAsyncFinish };\n"]}

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

@@ -0,0 +1,42 @@
+import type { GirFunction } from "../../gir/function.js";
+import type { ModuleContext } from "../../writer/context.js";
+type Callables = {
+    constructors: GirFunction[];
+    functions: GirFunction[];
+    methods: GirFunction[];
+};
+type InstanceScope = {
+    ownerName: string;
+    methodByName: Map<string, GirFunction>;
+    statics: GirFunction[];
+};
+type InstanceMemberRenderer = (context: ModuleContext, callable: GirFunction, scope: InstanceScope, nameOverride?: string) => string | undefined;
+type PlainTypeMembersOptions = {
+    context: ModuleContext;
+    className: string;
+    callables: Callables;
+    hasGtype: boolean;
+};
+declare const renderInstanceMethodSignature: InstanceMemberRenderer;
+declare const renderClassInstanceMember: InstanceMemberRenderer;
+declare const instanceScope: (ownerName: string, callables: Callables) => InstanceScope;
+declare const dedupeCallables: (callables: GirFunction[]) => GirFunction[];
+declare const generateBindings: (context: ModuleContext, callables: Callables) => void;
+declare const matchStaticFinishFunction: (context: ModuleContext, callable: GirFunction, siblings: GirFunction[]) => GirFunction | undefined;
+declare const indexMethodsByName: (methods: GirFunction[]) => Map<string, GirFunction>;
+declare const isEmittableCallable: (context: ModuleContext, callable: GirFunction) => boolean;
+declare const renderStaticSignature: (context: ModuleContext, callable: GirFunction, options?: {
+    returnTypeOverride?: string | undefined;
+    siblings?: GirFunction[] | undefined;
+}) => {
+    name: string;
+    signature: string;
+} | undefined;
+declare const classConstructorMemberNames: (context: ModuleContext, callables: Callables) => 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, };
+//# sourceMappingURL=callables.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callables.d.ts","sourceRoot":"","sources":["../../../src/store/gi/callables.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAmB7D,KAAK,SAAS,GAAG;IACb,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,OAAO,EAAE,WAAW,EAAE,CAAC;CAC1B,CAAC;AAEF,KAAK,aAAa,GAAG;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACvC,OAAO,EAAE,WAAW,EAAE,CAAC;CAC1B,CAAC;AAoBF,KAAK,sBAAsB,GAAG,CAC1B,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,aAAa,EACpB,YAAY,CAAC,EAAE,MAAM,KACpB,MAAM,GAAG,SAAS,CAAC;AAExB,KAAK,uBAAuB,GAAG;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,QAAA,MAAM,6BAA6B,EAAE,sBAGpC,CAAC;AAEF,QAAA,MAAM,yBAAyB,EAAE,sBAShC,CAAC;AAEF,QAAA,MAAM,aAAa,GAAI,WAAW,MAAM,EAAE,WAAW,SAAS,KAAG,aAI/D,CAAC;AAEH,QAAA,MAAM,eAAe,GAAI,WAAW,WAAW,EAAE,KAAG,WAAW,EAM1D,CAAC;AAiCN,QAAA,MAAM,gBAAgB,GAAI,SAAS,aAAa,EAAE,WAAW,SAAS,KAAG,IAUxE,CAAC;AAkLF,QAAA,MAAM,yBAAyB,GAC3B,SAAS,aAAa,EACtB,UAAU,WAAW,EACrB,UAAU,WAAW,EAAE,KACxB,WAAW,GAAG,SAYhB,CAAC;AA6BF,QAAA,MAAM,kBAAkB,GAAI,SAAS,WAAW,EAAE,KAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAQ3E,CAAC;AAEF,QAAA,MAAM,mBAAmB,GAAI,SAAS,aAAa,EAAE,UAAU,WAAW,KAAG,OAKhB,CAAC;AAY9D,QAAA,MAAM,qBAAqB,GACvB,SAAS,aAAa,EACtB,UAAU,WAAW,EACrB,UAAU;IAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,CAAA;CAAE,KAC5F;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,SAqBxC,CAAC;AAEF,QAAA,MAAM,2BAA2B,GAAI,SAAS,aAAa,EAAE,WAAW,SAAS,KAAG,MAAM,EAgBzF,CAAC;AAqBF,QAAA,MAAM,gBAAgB,GAAI,SAAS,aAAa,EAAE,WAAW,SAAS,EAAE,gBAAgB,MAAM,KAAG,MAAM,EActG,CAAC;AAuBF,QAAA,MAAM,sBAAsB,GACxB,SAAS,uBAAuB,KACjC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAWhD,CAAC;AAEF,OAAO,EACH,6BAA6B,EAC7B,yBAAyB,EACzB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,2BAA2B,EAC3B,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,SAAS,EACd,KAAK,aAAa,GACrB,CAAC"}