@gtkx/codegen 1.2.2 → 1.4.0

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

@@ -1 +1 @@
-{"version":3,"file":"resolve-store.js","sourceRoot":"","sources":["../../src/store/resolve-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync, realpathSync } from \"node:fs\";\nimport { dirname, join, parse, relative, sep } from \"node:path\";\nimport type { StoreOptions } from \"./store-fs.js\";\nimport { sweepStagingDirs } from \"../staging.js\";\n\n/**\n * Where a project's generated stores live, ready to spread into `runCodegen`. `jsx` is null when the\n * project has no `@gtkx/react` installed, in which case only the `@gtkx/gi` store can be generated.\n */\ntype ResolvedStore = {\n    /** Where the `@gtkx/gi` store goes, versioned by the installed `@gtkx/runtime`. */\n    gi: StoreOptions;\n    /** Where the `@gtkx/jsx` store goes, versioned by the installed `@gtkx/react`; null when it is absent. */\n    jsx: StoreOptions | null;\n    /** Subexport names of the installed `@gtkx/react`, empty when it is absent. */\n    reactSubexports: string[];\n};\n\ntype ResolvedPackage = { dir: string; nodeModules: string; version: string };\ntype StoreConsumer = { name: string; nodeModules: string };\n\nconst STORE_DIR = \".gtkx\";\nconst SCOPE = \"@gtkx\";\nconst STORE_NAMES: string[] = [\"gi\", \"jsx\"];\n\nconst STORE_CONSUMERS: string[] = [\n    \"@gtkx/cli\",\n    \"@gtkx/components\",\n    \"@gtkx/css\",\n    \"@gtkx/react\",\n    \"@gtkx/runtime\",\n    \"@gtkx/testing\",\n];\n\nconst readManifest = (path: string): { version?: string; exports?: Record<string, unknown> } =>\n    JSON.parse(readFileSync(path, \"utf8\")) as { version?: string; exports?: Record<string, unknown> };\n\nconst subexportNames = (packageDir: string): string[] =>\n    Object.keys(readManifest(join(packageDir, \"package.json\")).exports ?? {})\n        .filter((key) => key.startsWith(\"./\") && key !== \"./package.json\")\n        .map((key) => key.slice(2));\n\nconst loadPackage = (manifest: string, nodeModules: string): ResolvedPackage | null => {\n    if (!existsSync(manifest)) {\n        return null;\n    }\n\n    const real = realpathSync(manifest);\n\n    return { dir: dirname(real), nodeModules, version: readManifest(real).version ?? \"0.0.0\" };\n};\n\nconst nodeModulesChain = function* (projectRoot: string): Generator<string> {\n    const { root } = parse(projectRoot);\n    let current = projectRoot;\n\n    while (current !== root) {\n        yield join(current, \"node_modules\");\n        current = dirname(current);\n    }\n\n    yield join(root, \"node_modules\");\n};\n\nconst resolvePackage = (projectRoot: string, packageName: string): ResolvedPackage | null => {\n    for (const nodeModules of nodeModulesChain(projectRoot)) {\n        const found = loadPackage(join(nodeModules, packageName, \"package.json\"), nodeModules);\n\n        if (found !== null) {\n            return found;\n        }\n    }\n\n    const unscoped = packageName.replace(/^@[^/]+\\//, \"\");\n\n    return loadPackage(join(projectRoot, \"packages\", unscoped, \"package.json\"), join(projectRoot, \"node_modules\"));\n};\n\nconst isWithin = (parent: string, child: string): boolean => {\n    const path = relative(parent, child);\n\n    return path === \"\" || (path !== \"..\" && !path.startsWith(`..${sep}`));\n};\n\nconst canImport = (fromNodeModules: string, targetNodeModules: string): boolean =>\n    isWithin(dirname(targetNodeModules), dirname(fromNodeModules));\n\nconst storeOptions = (nodeModules: string, name: string, version: string): StoreOptions => ({\n    storeDir: join(nodeModules, STORE_DIR, name),\n    linkDir: join(nodeModules, SCOPE, name),\n    version,\n});\n\nconst resolveRuntime = (projectRoot: string): ResolvedPackage => {\n    const runtime = resolvePackage(projectRoot, \"@gtkx/runtime\");\n\n    if (runtime === null) {\n        throw new Error(`Cannot resolve @gtkx/runtime from ${projectRoot}; is it installed?`);\n    }\n\n    return runtime;\n};\n\nconst storeNodeModules = (runtime: ResolvedPackage, react: ResolvedPackage | null): string => {\n    if (react !== null && canImport(react.nodeModules, runtime.nodeModules)) {\n        return react.nodeModules;\n    }\n\n    return runtime.nodeModules;\n};\n\nconst findUnreachableConsumer = (projectRoot: string, nodeModules: string): StoreConsumer | null => {\n    for (const name of STORE_CONSUMERS) {\n        const consumer = resolvePackage(projectRoot, name);\n\n        if (consumer !== null && !canImport(consumer.nodeModules, nodeModules)) {\n            return { name, nodeModules: consumer.nodeModules };\n        }\n    }\n\n    return null;\n};\n\nconst unreachableConsumerMessage = (consumer: StoreConsumer, nodeModules: string): string =>\n    `Cannot write the generated store to ${nodeModules}: ${consumer.name} is installed in ` +\n    `${consumer.nodeModules}, above it, so that copy can never import the generated @gtkx/gi. Install every ` +\n    \"@gtkx package in one node_modules, then run gtkx codegen again.\";\n\nconst checkConsumers = (projectRoot: string, nodeModules: string): void => {\n    const consumer = findUnreachableConsumer(projectRoot, nodeModules);\n\n    if (consumer !== null) {\n        throw new Error(unreachableConsumerMessage(consumer, nodeModules));\n    }\n};\n\nconst jsxOptions = (react: ResolvedPackage | null, nodeModules: string): StoreOptions | null =>\n    react === null ? null : storeOptions(nodeModules, \"jsx\", react.version);\n\nconst getReactSubexports = (react: ResolvedPackage | null): string[] =>\n    react === null ? [] : subexportNames(react.dir);\n\nconst storePaths = (nodeModules: string): string[] =>\n    STORE_NAMES.flatMap((name) => [join(nodeModules, STORE_DIR, name), join(nodeModules, SCOPE, name)]);\n\nconst findStoreNodeModules = (projectRoot: string): string | null => {\n    const runtime = resolvePackage(projectRoot, \"@gtkx/runtime\");\n\n    if (runtime === null) {\n        return null;\n    }\n\n    return storeNodeModules(runtime, resolvePackage(projectRoot, \"@gtkx/react\"));\n};\n\nconst getShadowingStorePaths = (projectRoot: string): string[] => {\n    const nodeModules = join(projectRoot, \"node_modules\");\n    const anchored = findStoreNodeModules(projectRoot);\n\n    if (anchored === null || anchored === nodeModules) {\n        return [];\n    }\n\n    return storePaths(nodeModules);\n};\n\nconst stagingRoots = (projectRoot: string): string[] => {\n    const nodeModules = join(projectRoot, \"node_modules\");\n    const anchored = findStoreNodeModules(projectRoot);\n\n    return anchored === null || anchored === nodeModules ? [nodeModules] : [nodeModules, anchored];\n};\n\nconst sweepProjectStaging = (projectRoot: string): void => {\n    for (const nodeModules of stagingRoots(projectRoot)) {\n        for (const name of STORE_NAMES) {\n            sweepStagingDirs(join(nodeModules, STORE_DIR, name));\n        }\n    }\n};\n\n/**\n * Resolves where a project's `@gtkx/gi` and `@gtkx/jsx` stores belong, from the project root alone. The\n * result supplies every `runCodegen` input except `libraries` and `girPath`, so a caller that has\n * already resolved those can spread it straight into the call.\n *\n * Both stores go in one `node_modules`, found by walking the project's `node_modules` chain upwards:\n * the one `@gtkx/react` resolves from, or `@gtkx/runtime`'s when no React is installed. That is the\n * project's own directory when it installs those packages itself, and the workspace root when npm or\n * yarn hoisted them there. Keeping the pair together is what lets the jsx store import the gi store, and\n * anchoring them where the `@gtkx` packages sit is what lets `@gtkx/react`, the CLI, and the project's\n * sources all reach the bindings. A package manager that hoists therefore gives every project sharing\n * that `node_modules` one shared store.\n *\n * Store versions come from the installed `@gtkx/runtime` and `@gtkx/react`, so a dependency upgrade\n * invalidates the stores. Pass explicit `gi` or `jsx` options to `runCodegen` to override any of it.\n *\n * @param projectRoot Directory holding the project's `package.json`, whose `node_modules` chain is walked.\n * @returns The store locations and the React subexports that shape the jsx store.\n * @throws If `@gtkx/runtime` cannot be resolved from the project, or a `@gtkx` package that imports the\n * bindings is installed above the `node_modules` the stores would go in, since it could not reach them.\n */\nconst resolveStore = (projectRoot: string): ResolvedStore => {\n    const runtime = resolveRuntime(projectRoot);\n    const react = resolvePackage(projectRoot, \"@gtkx/react\");\n    const nodeModules = storeNodeModules(runtime, react);\n    checkConsumers(projectRoot, nodeModules);\n\n    return {\n        gi: storeOptions(nodeModules, \"gi\", runtime.version),\n        jsx: jsxOptions(react, nodeModules),\n        reactSubexports: getReactSubexports(react),\n    };\n};\n\nexport { getShadowingStorePaths, resolveStore, sweepProjectStaging, type ResolvedStore };\n"]}
+{"version":3,"file":"resolve-store.js","sourceRoot":"","sources":["../../src/store/resolve-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync, realpathSync } from \"node:fs\";\nimport { dirname, join, parse, relative, sep } from \"node:path\";\nimport type { StoreOptions } from \"./store-fs.js\";\nimport { sweepStagingDirs } from \"../staging.js\";\n\n/**\n * Where a project's generated stores live, ready to spread into `runCodegen`. `jsx` is null when the\n * project has no `@gtkx/react` installed, in which case only the `@gtkx/gi` store can be generated.\n */\ntype ResolvedStore = {\n    /** Where the `@gtkx/gi` store goes, versioned by the installed `@gtkx/runtime`. */\n    gi: StoreOptions;\n    /** Where the `@gtkx/jsx` store goes, versioned by the installed `@gtkx/react`; null when it is absent. */\n    jsx: StoreOptions | null;\n    /** Subexport names of the installed `@gtkx/react`, empty when it is absent. */\n    reactSubexports: string[];\n};\n\ntype ResolvedPackage = { dir: string; nodeModules: string; version: string };\ntype StoreConsumer = { name: string; nodeModules: string };\n\nconst STORE_DIR = \".gtkx\";\nconst SCOPE = \"@gtkx\";\nconst STORE_NAMES: string[] = [\"gi\", \"jsx\"];\n\nconst STORE_CONSUMERS: string[] = [\n    \"@gtkx/animated\",\n    \"@gtkx/cli\",\n    \"@gtkx/components\",\n    \"@gtkx/css\",\n    \"@gtkx/navigation\",\n    \"@gtkx/react\",\n    \"@gtkx/runtime\",\n    \"@gtkx/testing\",\n];\n\nconst readManifest = (path: string): { version?: string; exports?: Record<string, unknown> } =>\n    JSON.parse(readFileSync(path, \"utf8\")) as { version?: string; exports?: Record<string, unknown> };\n\nconst subexportNames = (packageDir: string): string[] =>\n    Object.keys(readManifest(join(packageDir, \"package.json\")).exports ?? {})\n        .filter((key) => key.startsWith(\"./\") && key !== \"./package.json\")\n        .map((key) => key.slice(2));\n\nconst loadPackage = (manifest: string, nodeModules: string): ResolvedPackage | null => {\n    if (!existsSync(manifest)) {\n        return null;\n    }\n\n    const real = realpathSync(manifest);\n\n    return { dir: dirname(real), nodeModules, version: readManifest(real).version ?? \"0.0.0\" };\n};\n\nconst nodeModulesChain = function* (projectRoot: string): Generator<string> {\n    const { root } = parse(projectRoot);\n    let current = projectRoot;\n\n    while (current !== root) {\n        yield join(current, \"node_modules\");\n        current = dirname(current);\n    }\n\n    yield join(root, \"node_modules\");\n};\n\nconst resolvePackage = (projectRoot: string, packageName: string): ResolvedPackage | null => {\n    for (const nodeModules of nodeModulesChain(projectRoot)) {\n        const found = loadPackage(join(nodeModules, packageName, \"package.json\"), nodeModules);\n\n        if (found !== null) {\n            return found;\n        }\n    }\n\n    const unscoped = packageName.replace(/^@[^/]+\\//, \"\");\n\n    return loadPackage(join(projectRoot, \"packages\", unscoped, \"package.json\"), join(projectRoot, \"node_modules\"));\n};\n\nconst isWithin = (parent: string, child: string): boolean => {\n    const path = relative(parent, child);\n\n    return path === \"\" || (path !== \"..\" && !path.startsWith(`..${sep}`));\n};\n\nconst canImport = (fromNodeModules: string, targetNodeModules: string): boolean =>\n    isWithin(dirname(targetNodeModules), dirname(fromNodeModules));\n\nconst storeOptions = (nodeModules: string, name: string, version: string): StoreOptions => ({\n    storeDir: join(nodeModules, STORE_DIR, name),\n    linkDir: join(nodeModules, SCOPE, name),\n    version,\n});\n\nconst resolveRuntime = (projectRoot: string): ResolvedPackage => {\n    const runtime = resolvePackage(projectRoot, \"@gtkx/runtime\");\n\n    if (runtime === null) {\n        throw new Error(`Cannot resolve @gtkx/runtime from ${projectRoot}; is it installed?`);\n    }\n\n    return runtime;\n};\n\nconst storeNodeModules = (runtime: ResolvedPackage, react: ResolvedPackage | null): string => {\n    if (react !== null && canImport(react.nodeModules, runtime.nodeModules)) {\n        return react.nodeModules;\n    }\n\n    return runtime.nodeModules;\n};\n\nconst findUnreachableConsumer = (projectRoot: string, nodeModules: string): StoreConsumer | null => {\n    for (const name of STORE_CONSUMERS) {\n        const consumer = resolvePackage(projectRoot, name);\n\n        if (consumer !== null && !canImport(consumer.nodeModules, nodeModules)) {\n            return { name, nodeModules: consumer.nodeModules };\n        }\n    }\n\n    return null;\n};\n\nconst unreachableConsumerMessage = (consumer: StoreConsumer, nodeModules: string): string =>\n    `Cannot write the generated store to ${nodeModules}: ${consumer.name} is installed in ` +\n    `${consumer.nodeModules}, above it, so that copy can never import the generated @gtkx/gi. Install every ` +\n    \"@gtkx package in one node_modules, then run gtkx codegen again.\";\n\nconst checkConsumers = (projectRoot: string, nodeModules: string): void => {\n    const consumer = findUnreachableConsumer(projectRoot, nodeModules);\n\n    if (consumer !== null) {\n        throw new Error(unreachableConsumerMessage(consumer, nodeModules));\n    }\n};\n\nconst jsxOptions = (react: ResolvedPackage | null, nodeModules: string): StoreOptions | null =>\n    react === null ? null : storeOptions(nodeModules, \"jsx\", react.version);\n\nconst getReactSubexports = (react: ResolvedPackage | null): string[] =>\n    react === null ? [] : subexportNames(react.dir);\n\nconst storePaths = (nodeModules: string): string[] =>\n    STORE_NAMES.flatMap((name) => [join(nodeModules, STORE_DIR, name), join(nodeModules, SCOPE, name)]);\n\nconst findStoreNodeModules = (projectRoot: string): string | null => {\n    const runtime = resolvePackage(projectRoot, \"@gtkx/runtime\");\n\n    if (runtime === null) {\n        return null;\n    }\n\n    return storeNodeModules(runtime, resolvePackage(projectRoot, \"@gtkx/react\"));\n};\n\nconst getShadowingStorePaths = (projectRoot: string): string[] => {\n    const nodeModules = join(projectRoot, \"node_modules\");\n    const anchored = findStoreNodeModules(projectRoot);\n\n    if (anchored === null || anchored === nodeModules) {\n        return [];\n    }\n\n    return storePaths(nodeModules);\n};\n\nconst stagingRoots = (projectRoot: string): string[] => {\n    const nodeModules = join(projectRoot, \"node_modules\");\n    const anchored = findStoreNodeModules(projectRoot);\n\n    return anchored === null || anchored === nodeModules ? [nodeModules] : [nodeModules, anchored];\n};\n\nconst sweepProjectStaging = (projectRoot: string): void => {\n    for (const nodeModules of stagingRoots(projectRoot)) {\n        for (const name of STORE_NAMES) {\n            sweepStagingDirs(join(nodeModules, STORE_DIR, name));\n        }\n    }\n};\n\n/**\n * Resolves where a project's `@gtkx/gi` and `@gtkx/jsx` stores belong, from the project root alone. The\n * result supplies every `runCodegen` input except `libraries` and `girPath`, so a caller that has\n * already resolved those can spread it straight into the call.\n *\n * Both stores go in one `node_modules`, found by walking the project's `node_modules` chain upwards:\n * the one `@gtkx/react` resolves from, or `@gtkx/runtime`'s when no React is installed. That is the\n * project's own directory when it installs those packages itself, and the workspace root when npm or\n * yarn hoisted them there. Keeping the pair together is what lets the jsx store import the gi store, and\n * anchoring them where the `@gtkx` packages sit is what lets `@gtkx/react`, the CLI, and the project's\n * sources all reach the bindings. A package manager that hoists therefore gives every project sharing\n * that `node_modules` one shared store.\n *\n * Store versions come from the installed `@gtkx/runtime` and `@gtkx/react`, so a dependency upgrade\n * invalidates the stores. Pass explicit `gi` or `jsx` options to `runCodegen` to override any of it.\n *\n * @param projectRoot Directory holding the project's `package.json`, whose `node_modules` chain is walked.\n * @returns The store locations and the React subexports that shape the jsx store.\n * @throws If `@gtkx/runtime` cannot be resolved from the project, or a `@gtkx` package that imports the\n * bindings is installed above the `node_modules` the stores would go in, since it could not reach them.\n */\nconst resolveStore = (projectRoot: string): ResolvedStore => {\n    const runtime = resolveRuntime(projectRoot);\n    const react = resolvePackage(projectRoot, \"@gtkx/react\");\n    const nodeModules = storeNodeModules(runtime, react);\n    checkConsumers(projectRoot, nodeModules);\n\n    return {\n        gi: storeOptions(nodeModules, \"gi\", runtime.version),\n        jsx: jsxOptions(react, nodeModules),\n        reactSubexports: getReactSubexports(react),\n    };\n};\n\nexport { getShadowingStorePaths, nodeModulesChain, resolveStore, sweepProjectStaging, type ResolvedStore };\n"]}

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

@@ -44,6 +44,7 @@ declare const namespaceBarrel: (directory: string) => {
 };
 declare const buildManifest: (input: ManifestInput) => Manifest;
 declare const writeStore: (params: WriteStoreParams) => void;
+declare const symlinkRelative: (linkPath: string, realTarget: string) => void;
 declare const ensureStoreLink: (link: StoreLink) => void;
-export { subpathExport, buildManifest, ensureStoreLink, namespaceBarrel, writeStore, type StoreOptions, type RawFile, };
+export { subpathExport, buildManifest, ensureStoreLink, namespaceBarrel, symlinkRelative, writeStore, type StoreLink, type StoreOptions, type RawFile, };
 //# sourceMappingURL=store-fs.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"store-fs.d.ts","sourceRoot":"","sources":["../../src/store/store-fs.ts"],"names":[],"mappings":"AAYA,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAIrE,kEAAkE;AAClE,KAAK,YAAY,GAAG;IAChB,sFAAsF;IACtF,QAAQ,EAAE,MAAM,CAAC;IACjB,uGAAuG;IACvG,OAAO,EAAE,MAAM,CAAC;IAChB,2GAA2G;IAC3G,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,SAAS,CAAC,CAAC;AAE5D,KAAK,QAAQ,GAAG;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,IAAI,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C,CAAC;AAEF,KAAK,aAAa,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C,CAAC;AAEF,KAAK,OAAO,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,KAAK,gBAAgB,GAAG;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACxB,CAAC;AAKF,QAAA,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAGpE,CAAC;AAEH,QAAA,MAAM,eAAe,GAAI,WAAW,MAAM,KAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAG7E,CAAC;AAEH,QAAA,MAAM,aAAa,GAAI,OAAO,aAAa,KAAG,QAc7C,CAAC;AAEF,QAAA,MAAM,UAAU,GAAI,QAAQ,gBAAgB,KAAG,IAa9C,CAAC;AAqDF,QAAA,MAAM,eAAe,GAAI,MAAM,SAAS,KAAG,IAM1C,CAAC;AAkBF,OAAO,EACH,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,UAAU,EACV,KAAK,YAAY,EACjB,KAAK,OAAO,GACf,CAAC"}
+{"version":3,"file":"store-fs.d.ts","sourceRoot":"","sources":["../../src/store/store-fs.ts"],"names":[],"mappings":"AAYA,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAKrE,kEAAkE;AAClE,KAAK,YAAY,GAAG;IAChB,sFAAsF;IACtF,QAAQ,EAAE,MAAM,CAAC;IACjB,uGAAuG;IACvG,OAAO,EAAE,MAAM,CAAC;IAChB,2GAA2G;IAC3G,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,SAAS,CAAC,CAAC;AAE5D,KAAK,QAAQ,GAAG;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,IAAI,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C,CAAC;AAEF,KAAK,aAAa,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C,CAAC;AAEF,KAAK,OAAO,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,KAAK,gBAAgB,GAAG;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACxB,CAAC;AAKF,QAAA,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAGpE,CAAC;AAEH,QAAA,MAAM,eAAe,GAAI,WAAW,MAAM,KAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAG7E,CAAC;AAEH,QAAA,MAAM,aAAa,GAAI,OAAO,aAAa,KAAG,QAc7C,CAAC;AAEF,QAAA,MAAM,UAAU,GAAI,QAAQ,gBAAgB,KAAG,IAc9C,CAAC;AAuBF,QAAA,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,YAAY,MAAM,KAAG,IAI/D,CAAC;AA0BF,QAAA,MAAM,eAAe,GAAI,MAAM,SAAS,KAAG,IAU1C,CAAC;AAkBF,OAAO,EACH,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,eAAe,EACf,UAAU,EACV,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,OAAO,GACf,CAAC"}

package/dist/store/store-fs.js

@@ -4,6 +4,7 @@ import { dirname, join, relative } from "node:path";
 import { keepFailedProject } from "../compile.js";
 import { createStagingDir } from "../staging.js";
 import { compileStore } from "./compile-store.js";
+import { ensureExternalPackageLinks, resetExternalPackageLinks } from "./external-package-links.js";
 const STORE_DIR_MODE = 0o755;
 const FAILED_STORE_SUFFIX = ".failed";
 const subpathExport = (stem) => ({
@@ -33,6 +34,7 @@ const writeStore = (params) => {
     try {
         buildTempStore(tmp, params);
         swapStore(tmp, params.storeDir);
+        resetExternalPackageLinks(params.storeDir);
         ensureStoreLink(params);
     }
     catch (error) {
@@ -82,10 +84,13 @@ const isStoreLinked = (link) => {
     }
 };
 const ensureStoreLink = (link) => {
-    if (!existsSync(join(link.storeDir, "package.json")) || isStoreLinked(link)) {
+    if (!existsSync(join(link.storeDir, "package.json"))) {
         return;
     }
-    symlinkRelative(link.linkDir, link.storeDir);
+    if (!isStoreLinked(link)) {
+        symlinkRelative(link.linkDir, link.storeDir);
+    }
+    ensureExternalPackageLinks(link);
 };
 const storeWriteMessage = (storeDir, error) => `Cannot write the generated store to ${storeDir}: ${errorMessage(error)}. ` +
     "Codegen writes the store into the node_modules the @gtkx packages resolve from, " +
@@ -100,5 +105,5 @@ const createTempStore = (storeDir) => {
         throw new Error(storeWriteMessage(storeDir, error), { cause: error });
     }
 };
-export { subpathExport, buildManifest, ensureStoreLink, namespaceBarrel, writeStore, };
+export { subpathExport, buildManifest, ensureStoreLink, namespaceBarrel, symlinkRelative, writeStore, };
 //# sourceMappingURL=store-fs.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"store-fs.js","sourceRoot":"","sources":["../../src/store/store-fs.ts"],"names":[],"mappings":"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","sourcesContent":["import { errorMessage } from \"@gtkx/utils\";\nimport {\n    chmodSync,\n    existsSync,\n    mkdirSync,\n    realpathSync,\n    renameSync,\n    rmSync,\n    symlinkSync,\n    writeFileSync,\n} from \"node:fs\";\nimport { dirname, join, relative } from \"node:path\";\nimport { keepFailedProject, type SourceModule } from \"../compile.js\";\nimport { createStagingDir } from \"../staging.js\";\nimport { compileStore } from \"./compile-store.js\";\n\n/** Where one generated store is written and how it is reached. */\ntype StoreOptions = {\n    /** Directory the generated package is written to, replaced atomically on each run. */\n    storeDir: string;\n    /** Path the store is symlinked at, which is the specifier's resolution target under `node_modules`. */\n    linkDir: string;\n    /** Version stamped on the store's `package.json`, taken from the dependency the store is generated for. */\n    version: string;\n};\n\ntype StoreLink = Pick<StoreOptions, \"storeDir\" | \"linkDir\">;\n\ntype Manifest = {\n    name: string;\n    type: \"module\";\n    version: string;\n    sideEffects: true;\n    exports: Record<string, unknown>;\n    peerDependencies?: Record<string, string>;\n};\n\ntype ManifestInput = {\n    name: string;\n    version: string;\n    exports: Record<string, unknown>;\n    peerDependencies?: Record<string, string>;\n};\n\ntype RawFile = { relativePath: string; content: string };\n\ntype WriteStoreParams = {\n    storeDir: string;\n    linkDir: string;\n    files: SourceModule[];\n    manifest: Manifest;\n    rawFiles?: RawFile[];\n};\n\nconst STORE_DIR_MODE = 0o755;\nconst FAILED_STORE_SUFFIX = \".failed\";\n\nconst subpathExport = (stem: string): { types: string; default: string } => ({\n    types: `./${stem}.d.ts`,\n    default: `./${stem}.js`,\n});\n\nconst namespaceBarrel = (directory: string): { fileName: string; source: string } => ({\n    fileName: `${directory}/index.ts`,\n    source: `export * from \"./${directory}.js\";\\n`,\n});\n\nconst buildManifest = (input: ManifestInput): Manifest => {\n    const manifest: Manifest = {\n        name: input.name,\n        type: \"module\",\n        version: input.version,\n        sideEffects: true,\n        exports: { \"./package.json\": \"./package.json\", ...input.exports },\n    };\n\n    if (input.peerDependencies) {\n        manifest.peerDependencies = input.peerDependencies;\n    }\n\n    return manifest;\n};\n\nconst writeStore = (params: WriteStoreParams): void => {\n    const tmp = createTempStore(params.storeDir);\n    const keepAt = `${params.storeDir}${FAILED_STORE_SUFFIX}`;\n\n    try {\n        buildTempStore(tmp, params);\n        swapStore(tmp, params.storeDir);\n        ensureStoreLink(params);\n    } catch (error) {\n        throw keepFailedProject({ projectDir: tmp, keepAt, error });\n    }\n\n    rmSync(keepAt, { recursive: true, force: true });\n};\n\nconst buildTempStore = (tmp: string, params: WriteStoreParams): void => {\n    writePackageJson(tmp, params.manifest);\n\n    for (const file of params.files) {\n        writeSourceFile(tmp, file.fileName, file.source);\n    }\n\n    compileStore({ storeDir: tmp, files: params.files, packageName: params.manifest.name });\n    const rawFiles = params.rawFiles ?? [];\n\n    for (const raw of rawFiles) {\n        writeFileSync(join(tmp, raw.relativePath), raw.content);\n    }\n};\n\nconst writeSourceFile = (storeDir: string, fileName: string, source: string): void => {\n    const filePath = join(storeDir, fileName);\n    mkdirSync(dirname(filePath), { recursive: true });\n    writeFileSync(filePath, source);\n};\n\nconst symlinkRelative = (linkPath: string, realTarget: string): void => {\n    mkdirSync(dirname(linkPath), { recursive: true });\n    rmSync(linkPath, { recursive: true, force: true });\n    symlinkSync(relative(dirname(linkPath), realTarget), linkPath, \"dir\");\n};\n\nconst writePackageJson = (storeDir: string, manifest: Manifest): void => {\n    writeFileSync(join(storeDir, \"package.json\"), `${JSON.stringify(manifest, null, 2)}\\n`);\n};\n\nconst swapStore = (tmp: string, storeDir: string): void => {\n    const previous = `${storeDir}.old`;\n    rmSync(previous, { recursive: true, force: true });\n\n    if (existsSync(storeDir)) {\n        renameSync(storeDir, previous);\n    }\n\n    renameSync(tmp, storeDir);\n    rmSync(previous, { recursive: true, force: true });\n};\n\nconst isStoreLinked = (link: StoreLink): boolean => {\n    try {\n        return realpathSync(link.linkDir) === realpathSync(link.storeDir);\n    } catch {\n        return false;\n    }\n};\n\nconst ensureStoreLink = (link: StoreLink): void => {\n    if (!existsSync(join(link.storeDir, \"package.json\")) || isStoreLinked(link)) {\n        return;\n    }\n\n    symlinkRelative(link.linkDir, link.storeDir);\n};\n\nconst storeWriteMessage = (storeDir: string, error: unknown): string =>\n    `Cannot write the generated store to ${storeDir}: ${errorMessage(error)}. ` +\n    \"Codegen writes the store into the node_modules the @gtkx packages resolve from, \" +\n    `so ${dirname(storeDir)} has to be writable.`;\n\nconst createTempStore = (storeDir: string): string => {\n    try {\n        const tmp = createStagingDir(storeDir);\n        chmodSync(tmp, STORE_DIR_MODE);\n\n        return tmp;\n    } catch (error) {\n        throw new Error(storeWriteMessage(storeDir, error), { cause: error });\n    }\n};\n\nexport {\n    subpathExport,\n    buildManifest,\n    ensureStoreLink,\n    namespaceBarrel,\n    writeStore,\n    type StoreOptions,\n    type RawFile,\n};\n"]}
+{"version":3,"file":"store-fs.js","sourceRoot":"","sources":["../../src/store/store-fs.ts"],"names":[],"mappings":"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","sourcesContent":["import { errorMessage } from \"@gtkx/utils\";\nimport {\n    chmodSync,\n    existsSync,\n    mkdirSync,\n    realpathSync,\n    renameSync,\n    rmSync,\n    symlinkSync,\n    writeFileSync,\n} from \"node:fs\";\nimport { dirname, join, relative } from \"node:path\";\nimport { keepFailedProject, type SourceModule } from \"../compile.js\";\nimport { createStagingDir } from \"../staging.js\";\nimport { compileStore } from \"./compile-store.js\";\nimport { ensureExternalPackageLinks, resetExternalPackageLinks } from \"./external-package-links.js\";\n\n/** Where one generated store is written and how it is reached. */\ntype StoreOptions = {\n    /** Directory the generated package is written to, replaced atomically on each run. */\n    storeDir: string;\n    /** Path the store is symlinked at, which is the specifier's resolution target under `node_modules`. */\n    linkDir: string;\n    /** Version stamped on the store's `package.json`, taken from the dependency the store is generated for. */\n    version: string;\n};\n\ntype StoreLink = Pick<StoreOptions, \"storeDir\" | \"linkDir\">;\n\ntype Manifest = {\n    name: string;\n    type: \"module\";\n    version: string;\n    sideEffects: true;\n    exports: Record<string, unknown>;\n    peerDependencies?: Record<string, string>;\n};\n\ntype ManifestInput = {\n    name: string;\n    version: string;\n    exports: Record<string, unknown>;\n    peerDependencies?: Record<string, string>;\n};\n\ntype RawFile = { relativePath: string; content: string };\n\ntype WriteStoreParams = {\n    storeDir: string;\n    linkDir: string;\n    files: SourceModule[];\n    manifest: Manifest;\n    rawFiles?: RawFile[];\n};\n\nconst STORE_DIR_MODE = 0o755;\nconst FAILED_STORE_SUFFIX = \".failed\";\n\nconst subpathExport = (stem: string): { types: string; default: string } => ({\n    types: `./${stem}.d.ts`,\n    default: `./${stem}.js`,\n});\n\nconst namespaceBarrel = (directory: string): { fileName: string; source: string } => ({\n    fileName: `${directory}/index.ts`,\n    source: `export * from \"./${directory}.js\";\\n`,\n});\n\nconst buildManifest = (input: ManifestInput): Manifest => {\n    const manifest: Manifest = {\n        name: input.name,\n        type: \"module\",\n        version: input.version,\n        sideEffects: true,\n        exports: { \"./package.json\": \"./package.json\", ...input.exports },\n    };\n\n    if (input.peerDependencies) {\n        manifest.peerDependencies = input.peerDependencies;\n    }\n\n    return manifest;\n};\n\nconst writeStore = (params: WriteStoreParams): void => {\n    const tmp = createTempStore(params.storeDir);\n    const keepAt = `${params.storeDir}${FAILED_STORE_SUFFIX}`;\n\n    try {\n        buildTempStore(tmp, params);\n        swapStore(tmp, params.storeDir);\n        resetExternalPackageLinks(params.storeDir);\n        ensureStoreLink(params);\n    } catch (error) {\n        throw keepFailedProject({ projectDir: tmp, keepAt, error });\n    }\n\n    rmSync(keepAt, { recursive: true, force: true });\n};\n\nconst buildTempStore = (tmp: string, params: WriteStoreParams): void => {\n    writePackageJson(tmp, params.manifest);\n\n    for (const file of params.files) {\n        writeSourceFile(tmp, file.fileName, file.source);\n    }\n\n    compileStore({ storeDir: tmp, files: params.files, packageName: params.manifest.name });\n    const rawFiles = params.rawFiles ?? [];\n\n    for (const raw of rawFiles) {\n        writeFileSync(join(tmp, raw.relativePath), raw.content);\n    }\n};\n\nconst writeSourceFile = (storeDir: string, fileName: string, source: string): void => {\n    const filePath = join(storeDir, fileName);\n    mkdirSync(dirname(filePath), { recursive: true });\n    writeFileSync(filePath, source);\n};\n\nconst symlinkRelative = (linkPath: string, realTarget: string): void => {\n    mkdirSync(dirname(linkPath), { recursive: true });\n    rmSync(linkPath, { recursive: true, force: true });\n    symlinkSync(relative(dirname(linkPath), realTarget), linkPath, \"dir\");\n};\n\nconst writePackageJson = (storeDir: string, manifest: Manifest): void => {\n    writeFileSync(join(storeDir, \"package.json\"), `${JSON.stringify(manifest, null, 2)}\\n`);\n};\n\nconst swapStore = (tmp: string, storeDir: string): void => {\n    const previous = `${storeDir}.old`;\n    rmSync(previous, { recursive: true, force: true });\n\n    if (existsSync(storeDir)) {\n        renameSync(storeDir, previous);\n    }\n\n    renameSync(tmp, storeDir);\n    rmSync(previous, { recursive: true, force: true });\n};\n\nconst isStoreLinked = (link: StoreLink): boolean => {\n    try {\n        return realpathSync(link.linkDir) === realpathSync(link.storeDir);\n    } catch {\n        return false;\n    }\n};\n\nconst ensureStoreLink = (link: StoreLink): void => {\n    if (!existsSync(join(link.storeDir, \"package.json\"))) {\n        return;\n    }\n\n    if (!isStoreLinked(link)) {\n        symlinkRelative(link.linkDir, link.storeDir);\n    }\n\n    ensureExternalPackageLinks(link);\n};\n\nconst storeWriteMessage = (storeDir: string, error: unknown): string =>\n    `Cannot write the generated store to ${storeDir}: ${errorMessage(error)}. ` +\n    \"Codegen writes the store into the node_modules the @gtkx packages resolve from, \" +\n    `so ${dirname(storeDir)} has to be writable.`;\n\nconst createTempStore = (storeDir: string): string => {\n    try {\n        const tmp = createStagingDir(storeDir);\n        chmodSync(tmp, STORE_DIR_MODE);\n\n        return tmp;\n    } catch (error) {\n        throw new Error(storeWriteMessage(storeDir, error), { cause: error });\n    }\n};\n\nexport {\n    subpathExport,\n    buildManifest,\n    ensureStoreLink,\n    namespaceBarrel,\n    symlinkRelative,\n    writeStore,\n    type StoreLink,\n    type StoreOptions,\n    type RawFile,\n};\n"]}

package/dist/writer/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/writer/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,KAAK,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE9D,cAAM,aAAa;IACR,MAAM,EAAE,aAAa,CAAuB;IAC5C,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;gBAEZ,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO;IAKrD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIpC,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxC,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAI3C,0BAA0B,IAAI,IAAI;IAalC,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAkBtD,OAAO,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAUvC,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;CAOvD;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/writer/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,KAAK,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE9D,cAAM,aAAa;IACR,MAAM,EAAE,aAAa,CAAuB;IAC5C,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;gBAEZ,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO;IAKrD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIpC,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxC,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAI3C,0BAA0B,IAAI,IAAI;IAclC,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IA2BtD,OAAO,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAUvC,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;CAOvD;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/writer/context.js

@@ -1,3 +1,4 @@
+import { externalPackageFor } from "../gir/external-namespaces.js";
 import { ModuleBuilder } from "./module.js";
 class ModuleContext {
     module = new ModuleBuilder();
@@ -24,12 +25,19 @@ class ModuleContext {
             return;
         }
         this.module.imports.addSideEffect("../gobject/overrides/object.js");
+        this.module.imports.addSideEffect("../gobject/overrides/param-spec-getters.js");
         this.module.imports.addSideEffect("../gobject/overrides/value.js");
     }
     addCrossNamespaceImport(namespaceName) {
         if (namespaceName === this.namespace.name) {
             return namespaceName;
         }
+        const packageName = externalPackageFor(namespaceName);
+        if (packageName !== undefined) {
+            this.module.imports.addSideEffect(packageName);
+            this.module.imports.addNamespace(packageName, namespaceName);
+            return namespaceName;
+        }
         const directory = namespaceName.toLowerCase();
         const isFoundational = directory === "gobject" || directory === "glib";
         const path = isFoundational ? `../${directory}/${directory}.js` : `../${directory}/index.js`;

package/dist/writer/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/writer/context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,aAAa,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,aAAa;IACR,MAAM,GAAkB,IAAI,aAAa,EAAE,CAAC;IAC5C,SAAS,CAAe;IACxB,OAAO,CAAU;IAExB,YAAY,SAAuB,EAAE,OAAgB;QACjD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED,gBAAgB,CAAC,IAAY;QACzB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,oBAAoB,CAAC,IAAY;QAC7B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED,eAAe,CAAC,UAAkB;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC;IAED,0BAA0B;QACtB,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACpC,OAAO;QACX,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACjC,OAAO;QACX,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,gCAAgC,CAAC,CAAC;QACpE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,+BAA+B,CAAC,CAAC;IACvE,CAAC;IAED,uBAAuB,CAAC,aAAqB;QACzC,IAAI,aAAa,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACxC,OAAO,aAAa,CAAC;QACzB,CAAC;QAED,MAAM,SAAS,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;QAC9C,MAAM,cAAc,GAAG,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,MAAM,CAAC;QACvE,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,CAAC,MAAM,SAAS,IAAI,SAAS,KAAK,CAAC,CAAC,CAAC,MAAM,SAAS,WAAW,CAAC;QAE7F,IAAI,CAAC,cAAc,EAAE,CAAC;YAClB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QAEtD,OAAO,aAAa,CAAC;IACzB,CAAC;IAED,OAAO,CAAC,WAAwB;QAC5B,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC;QAE1C,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC;YAC1B,IAAI;YACJ,IAAI;YACJ,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,KAAK,EAAE;SAC7E,CAAC,CAAC;IACP,CAAC;IAED,OAAO,CAAC,aAAqB,EAAE,IAAY;QACvC,IAAI,aAAa,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,OAAO,GAAG,IAAI,CAAC,uBAAuB,CAAC,aAAa,CAAC,IAAI,IAAI,EAAE,CAAC;IACpE,CAAC;CACJ;AAED,OAAO,EAAE,aAAa,EAAE,CAAC","sourcesContent":["import type { Library } from \"../gir/library.js\";\nimport type { GirNamespace } from \"../gir/namespace.js\";\nimport { type Declaration, ModuleBuilder } from \"./module.js\";\n\nclass ModuleContext {\n    public module: ModuleBuilder = new ModuleBuilder();\n    public namespace: GirNamespace;\n    public library: Library;\n\n    constructor(namespace: GirNamespace, library: Library) {\n        this.namespace = namespace;\n        this.library = library;\n    }\n\n    addRuntimeImport(name: string): void {\n        this.module.imports.addNamed(\"@gtkx/runtime\", name);\n    }\n\n    addRuntimeTypeImport(name: string): void {\n        this.module.imports.addNamed(\"@gtkx/runtime\", name, true);\n    }\n\n    hoistDescriptor(expression: string): string {\n        return this.module.hoistDescriptor(expression);\n    }\n\n    addGObjectBootstrapImports(): void {\n        if (this.namespace.name === \"GObject\") {\n            return;\n        }\n\n        if (this.namespace.name === \"GLib\") {\n            return;\n        }\n\n        this.module.imports.addSideEffect(\"../gobject/overrides/object.js\");\n        this.module.imports.addSideEffect(\"../gobject/overrides/value.js\");\n    }\n\n    addCrossNamespaceImport(namespaceName: string): string {\n        if (namespaceName === this.namespace.name) {\n            return namespaceName;\n        }\n\n        const directory = namespaceName.toLowerCase();\n        const isFoundational = directory === \"gobject\" || directory === \"glib\";\n        const path = isFoundational ? `../${directory}/${directory}.js` : `../${directory}/index.js`;\n\n        if (!isFoundational) {\n            this.module.imports.addSideEffect(path);\n        }\n\n        this.module.imports.addNamespace(path, namespaceName);\n\n        return namespaceName;\n    }\n\n    declare(declaration: Declaration): void {\n        const { name, code, owner } = declaration;\n\n        this.module.appendDeclaration({\n            name,\n            code,\n            owner: owner === undefined ? undefined : `${this.namespace.name}.${owner}`,\n        });\n    }\n\n    qualify(namespaceName: string, name: string): string {\n        if (namespaceName === this.namespace.name) {\n            return name;\n        }\n\n        return `${this.addCrossNamespaceImport(namespaceName)}.${name}`;\n    }\n}\n\nexport { ModuleContext };\n"]}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/writer/context.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Library } from \"../gir/library.js\";\nimport type { GirNamespace } from \"../gir/namespace.js\";\nimport { externalPackageFor } from \"../gir/external-namespaces.js\";\nimport { type Declaration, ModuleBuilder } from \"./module.js\";\n\nclass ModuleContext {\n    public module: ModuleBuilder = new ModuleBuilder();\n    public namespace: GirNamespace;\n    public library: Library;\n\n    constructor(namespace: GirNamespace, library: Library) {\n        this.namespace = namespace;\n        this.library = library;\n    }\n\n    addRuntimeImport(name: string): void {\n        this.module.imports.addNamed(\"@gtkx/runtime\", name);\n    }\n\n    addRuntimeTypeImport(name: string): void {\n        this.module.imports.addNamed(\"@gtkx/runtime\", name, true);\n    }\n\n    hoistDescriptor(expression: string): string {\n        return this.module.hoistDescriptor(expression);\n    }\n\n    addGObjectBootstrapImports(): void {\n        if (this.namespace.name === \"GObject\") {\n            return;\n        }\n\n        if (this.namespace.name === \"GLib\") {\n            return;\n        }\n\n        this.module.imports.addSideEffect(\"../gobject/overrides/object.js\");\n        this.module.imports.addSideEffect(\"../gobject/overrides/param-spec-getters.js\");\n        this.module.imports.addSideEffect(\"../gobject/overrides/value.js\");\n    }\n\n    addCrossNamespaceImport(namespaceName: string): string {\n        if (namespaceName === this.namespace.name) {\n            return namespaceName;\n        }\n\n        const packageName = externalPackageFor(namespaceName);\n\n        if (packageName !== undefined) {\n            this.module.imports.addSideEffect(packageName);\n            this.module.imports.addNamespace(packageName, namespaceName);\n\n            return namespaceName;\n        }\n\n        const directory = namespaceName.toLowerCase();\n        const isFoundational = directory === \"gobject\" || directory === \"glib\";\n        const path = isFoundational ? `../${directory}/${directory}.js` : `../${directory}/index.js`;\n\n        if (!isFoundational) {\n            this.module.imports.addSideEffect(path);\n        }\n\n        this.module.imports.addNamespace(path, namespaceName);\n\n        return namespaceName;\n    }\n\n    declare(declaration: Declaration): void {\n        const { name, code, owner } = declaration;\n\n        this.module.appendDeclaration({\n            name,\n            code,\n            owner: owner === undefined ? undefined : `${this.namespace.name}.${owner}`,\n        });\n    }\n\n    qualify(namespaceName: string, name: string): string {\n        if (namespaceName === this.namespace.name) {\n            return name;\n        }\n\n        return `${this.addCrossNamespaceImport(namespaceName)}.${name}`;\n    }\n}\n\nexport { ModuleContext };\n"]}

package/dist/writer/gtk-doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gtk-doc.d.ts","sourceRoot":"","sources":["../../src/writer/gtk-doc.ts"],"names":[],"mappings":"AAsIA,QAAA,MAAM,gBAAgB,GAAI,KAAK,MAAM,EAAE,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAAG,MA+B1E,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"gtk-doc.d.ts","sourceRoot":"","sources":["../../src/writer/gtk-doc.ts"],"names":[],"mappings":"AA2KA,QAAA,MAAM,gBAAgB,GAAI,KAAK,MAAM,EAAE,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAAG,MA+B1E,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/writer/gtk-doc.js

@@ -1,5 +1,11 @@
-import { camelCase } from "@gtkx/utils";
+import { camelCase, kebabCase } from "@gtkx/utils";
+import { HIDDEN_SYMBOLS } from "../gir/hidden-symbols.js";
 const CONSTANT_MAP = { TRUE: "true", FALSE: "false", NULL: "null" };
+const HIDDEN_LINK_PREFIXES = new Map([
+    ["GLib", "g"],
+    ["GObject", "g"],
+    ["Gio", "g"],
+]);
 const CALLABLE_LINK_KINDS = new Set(["method", "func", "ctor", "vfunc", "id"]);
 const SENTINEL = String.fromCodePoint(0xE0_00);
 const CODE_BLOCK_OPEN = "|[";
@@ -25,8 +31,28 @@ const DOCBOOK_LITERAL_PATTERN = /<literal>([\s\S]*?)<\/literal>/g;
 const DOCBOOK_LIST_PATTERN = /<\/?itemizedlist>\s*/g;
 const DOCBOOK_PARA_PATTERN = /<\/?para>\s*/g;
 const BLANK_LINE_RUN_PATTERN = /\n{3,}/g;
+const cSymbolSegment = (segment) => kebabCase(segment).replaceAll("-", "_");
+const hiddenLinkCandidate = (segments) => {
+    const [namespace, ...rest] = segments;
+    const prefix = namespace === undefined ? undefined : HIDDEN_LINK_PREFIXES.get(namespace);
+    if (prefix === undefined || rest.length === 0) {
+        return undefined;
+    }
+    return [prefix, ...rest.map((segment) => cSymbolSegment(segment))].join("_");
+};
+const hiddenCIdentifier = (kind, target, segments) => {
+    if (!CALLABLE_LINK_KINDS.has(kind)) {
+        return undefined;
+    }
+    const candidate = kind === "id" ? target : hiddenLinkCandidate(segments);
+    return candidate !== undefined && HIDDEN_SYMBOLS.has(candidate) ? candidate : undefined;
+};
 const renderLink = (kind, target) => {
     const segments = target.split(/::|[.:]/);
+    const hidden = hiddenCIdentifier(kind, target, segments);
+    if (hidden !== undefined) {
+        return `\`${hidden}()\``;
+    }
     const lastIndex = segments.length - 1;
     if (kind === "property" || CALLABLE_LINK_KINDS.has(kind)) {
         segments[lastIndex] = camelCase(segments[lastIndex] ?? "");

package/dist/writer/gtk-doc.js.map

@@ -1 +1 @@
-{"version":3,"file":"gtk-doc.js","sourceRoot":"","sources":["../../src/writer/gtk-doc.ts"],"names":[],"mappings":"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","sourcesContent":["import { camelCase } from \"@gtkx/utils\";\n\nconst CONSTANT_MAP: Record<string, string> = { TRUE: \"true\", FALSE: \"false\", NULL: \"null\" };\nconst CALLABLE_LINK_KINDS: Set<string> = new Set([\"method\", \"func\", \"ctor\", \"vfunc\", \"id\"]);\nconst SENTINEL = String.fromCodePoint(0xE0_00);\nconst CODE_BLOCK_OPEN = \"|[\";\nconst CODE_BLOCK_CLOSE = \"]|\";\nconst CODE_LANGUAGE_PATTERN = /^\\s*<!--\\s*language=\"([^\"]*)\"\\s*-->/;\nconst FENCED_BLOCK_PATTERN = /```[\\s\\S]*?```/g;\nconst INLINE_CODE_PATTERN = /`[^`\\n]*`/g;\nconst LINK_PATTERN = /\\[(\\w+)@([\\w.:%#-]+)\\]/g;\nconst CONSTANT_PATTERN = /(?<![\\w\\\\])%(\\w+)/g;\nconst ESCAPED_CONSTANT_PATTERN = /\\\\%/g;\nconst TYPE_REF_PATTERN = /(?<!\\w)#(\\w+)(::[\\w-]+|:[\\w-]+)?/g;\nconst PARAM_REF_PATTERN = /(?<!\\w)@(\\w+)/g;\nconst FUNCTION_REF_PATTERN = /\\b([a-z_][a-z0-9_]*)\\(\\)/g;\nconst HTML_COMMENT_PATTERN = /<!--[\\s\\S]*?-->/g;\nconst DOCBOOK_TAG_PATTERN = /<\\/?(?:itemizedlist|listitem|para|literal|link|informalexample|programlisting)[\\s>]/;\nconst DOCBOOK_LISTING_OPEN = \"<programlisting>\";\nconst DOCBOOK_LISTING_CLOSE = \"</programlisting>\";\nconst DOCBOOK_EXAMPLE_PATTERN = /<\\/?informalexample>\\s*/g;\nconst DOCBOOK_ITEM_OPEN_PATTERN = /<listitem>\\s*(?:<para>\\s*)?/g;\nconst DOCBOOK_ITEM_CLOSE_PATTERN = /(?:<\\/para>\\s*)?<\\/listitem>\\s*/g;\nconst DOCBOOK_LINK_PATTERN = /<link\\s+linkend=\"[^\"]*\">([\\s\\S]*?)<\\/link>/g;\nconst DOCBOOK_LITERAL_PATTERN = /<literal>([\\s\\S]*?)<\\/literal>/g;\nconst DOCBOOK_LIST_PATTERN = /<\\/?itemizedlist>\\s*/g;\nconst DOCBOOK_PARA_PATTERN = /<\\/?para>\\s*/g;\nconst BLANK_LINE_RUN_PATTERN = /\\n{3,}/g;\n\nconst renderLink = (kind: string, target: string): string => {\n    const segments = target.split(/::|[.:]/);\n    const lastIndex = segments.length - 1;\n\n    if (kind === \"property\" || CALLABLE_LINK_KINDS.has(kind)) {\n        segments[lastIndex] = camelCase(segments[lastIndex] ?? \"\");\n    }\n\n    const symbol = segments.join(\".\");\n\n    return `\\`${symbol}${CALLABLE_LINK_KINDS.has(kind) ? \"()\" : \"\"}\\``;\n};\n\nconst renderTypeRef = (name: string, member: string | undefined): string => {\n    if (member === undefined) {\n        return `\\`${name}\\``;\n    }\n\n    return renderLink(member.startsWith(\"::\") ? \"signal\" : \"property\", `${name}${member}`);\n};\n\nconst renderParamRef = (name: string, identifiers: Map<string, string> | undefined): string =>\n    `\\`${identifiers?.get(name) ?? name}\\``;\n\nconst trimTrailingNewlines = (value: string): string => {\n    let end = value.length;\n\n    while (end > 0 && value[end - 1] === \"\\n\") {\n        end -= 1;\n    }\n\n    return value.slice(0, end);\n};\n\nconst renderCodeFence = (body: string): string => {\n    const languageMatch = CODE_LANGUAGE_PATTERN.exec(body);\n    const fence = (languageMatch?.[1] ?? \"\").trim().toLowerCase();\n    const rest = languageMatch === null ? body : body.slice(languageMatch[0].length);\n    const code = trimTrailingNewlines(rest.trimStart());\n\n    return `\\`\\`\\`${fence}\\n${code}\\n\\`\\`\\``;\n};\n\nconst renderListing = (code: string): string => `\\n\\`\\`\\`\\n${code.trim()}\\n\\`\\`\\`\\n`;\n\nconst replaceDocBookTags = (text: string): string =>\n    replaceDelimited(text, [DOCBOOK_LISTING_OPEN, DOCBOOK_LISTING_CLOSE], renderListing)\n        .replaceAll(DOCBOOK_EXAMPLE_PATTERN, \"\\n\")\n        .replaceAll(DOCBOOK_ITEM_OPEN_PATTERN, \"\\n- \")\n        .replaceAll(DOCBOOK_ITEM_CLOSE_PATTERN, \"\\n\")\n        .replaceAll(DOCBOOK_LINK_PATTERN, (_match, label: string) => label)\n        .replaceAll(DOCBOOK_LITERAL_PATTERN, (_match, literal: string) => `\\`${literal}\\``)\n        .replaceAll(DOCBOOK_LIST_PATTERN, \"\\n\\n\")\n        .replaceAll(DOCBOOK_PARA_PATTERN, \"\\n\\n\");\n\nconst docBookToMarkdown = (text: string): string => {\n    if (!DOCBOOK_TAG_PATTERN.test(text)) {\n        return text;\n    }\n\n    return replaceDocBookTags(text).replaceAll(BLANK_LINE_RUN_PATTERN, \"\\n\\n\").trim();\n};\n\nconst replaceDelimited = (raw: string, bounds: [string, string], render: (body: string) => string): string => {\n    const [open, close] = bounds;\n    let result = \"\";\n    let cursor = 0;\n\n    while (cursor < raw.length) {\n        const start = raw.indexOf(open, cursor);\n\n        if (start === -1) {\n            break;\n        }\n\n        const end = raw.indexOf(close, start + open.length);\n\n        if (end === -1) {\n            break;\n        }\n\n        result += raw.slice(cursor, start);\n        result += render(raw.slice(start + open.length, end));\n        cursor = end + close.length;\n    }\n\n    return result + raw.slice(cursor);\n};\n\nconst protectCodeBlocks = (raw: string, protect: (value: string) => string): string =>\n    replaceDelimited(raw, [CODE_BLOCK_OPEN, CODE_BLOCK_CLOSE], (body) => protect(renderCodeFence(body)));\n\nconst stripHtmlComments = (text: string): string => {\n    let current = text;\n    let previous = \"\";\n\n    while (current !== previous) {\n        previous = current;\n        current = current.replaceAll(HTML_COMMENT_PATTERN, \"\");\n    }\n\n    return current;\n};\n\n// eslint-disable-next-line gtkx/no-library-prefix\nconst gtkDocToMarkdown = (raw: string, identifiers?: Map<string, string>): string => {\n    const stash: string[] = [];\n\n    const protect = (value: string): string => {\n        const token = `${SENTINEL}${String(stash.length)}${SENTINEL}`;\n        stash.push(value);\n\n        return token;\n    };\n\n    let text = protectCodeBlocks(docBookToMarkdown(raw), protect);\n    text = text.replaceAll(FENCED_BLOCK_PATTERN, (block) => protect(block));\n    text = text.replaceAll(INLINE_CODE_PATTERN, (span) => protect(span));\n    text = text.replaceAll(LINK_PATTERN, (_match, kind: string, target: string) => protect(renderLink(kind, target)));\n    text = text.replaceAll(CONSTANT_PATTERN, (_match, name: string) => protect(`\\`${CONSTANT_MAP[name] ?? name}\\``));\n    text = text.replaceAll(ESCAPED_CONSTANT_PATTERN, \"%\");\n\n    text = text.replaceAll(TYPE_REF_PATTERN, (_match, name: string, member: string | undefined) =>\n        protect(renderTypeRef(name, member)),\n    );\n\n    text = text.replaceAll(PARAM_REF_PATTERN, (_match, name: string) => protect(renderParamRef(name, identifiers)));\n    text = text.replaceAll(FUNCTION_REF_PATTERN, (_match, name: string) => protect(`\\`${name}()\\``));\n    text = stripHtmlComments(text);\n\n    for (let index = stash.length - 1; index >= 0; index -= 1) {\n        const value = stash[index] ?? \"\";\n        text = text.replaceAll(`${SENTINEL}${String(index)}${SENTINEL}`, () => value);\n    }\n\n    return text;\n};\n\nexport { gtkDocToMarkdown };\n"]}
+{"version":3,"file":"gtk-doc.js","sourceRoot":"","sources":["../../src/writer/gtk-doc.ts"],"names":[],"mappings":"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","sourcesContent":["import { camelCase, kebabCase } from \"@gtkx/utils\";\nimport { HIDDEN_SYMBOLS } from \"../gir/hidden-symbols.js\";\n\nconst CONSTANT_MAP: Record<string, string> = { TRUE: \"true\", FALSE: \"false\", NULL: \"null\" };\n\nconst HIDDEN_LINK_PREFIXES: Map<string, string> = new Map([\n    [\"GLib\", \"g\"],\n    [\"GObject\", \"g\"],\n    [\"Gio\", \"g\"],\n]);\n\nconst CALLABLE_LINK_KINDS: Set<string> = new Set([\"method\", \"func\", \"ctor\", \"vfunc\", \"id\"]);\nconst SENTINEL = String.fromCodePoint(0xE0_00);\nconst CODE_BLOCK_OPEN = \"|[\";\nconst CODE_BLOCK_CLOSE = \"]|\";\nconst CODE_LANGUAGE_PATTERN = /^\\s*<!--\\s*language=\"([^\"]*)\"\\s*-->/;\nconst FENCED_BLOCK_PATTERN = /```[\\s\\S]*?```/g;\nconst INLINE_CODE_PATTERN = /`[^`\\n]*`/g;\nconst LINK_PATTERN = /\\[(\\w+)@([\\w.:%#-]+)\\]/g;\nconst CONSTANT_PATTERN = /(?<![\\w\\\\])%(\\w+)/g;\nconst ESCAPED_CONSTANT_PATTERN = /\\\\%/g;\nconst TYPE_REF_PATTERN = /(?<!\\w)#(\\w+)(::[\\w-]+|:[\\w-]+)?/g;\nconst PARAM_REF_PATTERN = /(?<!\\w)@(\\w+)/g;\nconst FUNCTION_REF_PATTERN = /\\b([a-z_][a-z0-9_]*)\\(\\)/g;\nconst HTML_COMMENT_PATTERN = /<!--[\\s\\S]*?-->/g;\nconst DOCBOOK_TAG_PATTERN = /<\\/?(?:itemizedlist|listitem|para|literal|link|informalexample|programlisting)[\\s>]/;\nconst DOCBOOK_LISTING_OPEN = \"<programlisting>\";\nconst DOCBOOK_LISTING_CLOSE = \"</programlisting>\";\nconst DOCBOOK_EXAMPLE_PATTERN = /<\\/?informalexample>\\s*/g;\nconst DOCBOOK_ITEM_OPEN_PATTERN = /<listitem>\\s*(?:<para>\\s*)?/g;\nconst DOCBOOK_ITEM_CLOSE_PATTERN = /(?:<\\/para>\\s*)?<\\/listitem>\\s*/g;\nconst DOCBOOK_LINK_PATTERN = /<link\\s+linkend=\"[^\"]*\">([\\s\\S]*?)<\\/link>/g;\nconst DOCBOOK_LITERAL_PATTERN = /<literal>([\\s\\S]*?)<\\/literal>/g;\nconst DOCBOOK_LIST_PATTERN = /<\\/?itemizedlist>\\s*/g;\nconst DOCBOOK_PARA_PATTERN = /<\\/?para>\\s*/g;\nconst BLANK_LINE_RUN_PATTERN = /\\n{3,}/g;\n\nconst cSymbolSegment = (segment: string): string => kebabCase(segment).replaceAll(\"-\", \"_\");\n\nconst hiddenLinkCandidate = (segments: string[]): string | undefined => {\n    const [namespace, ...rest] = segments;\n    const prefix = namespace === undefined ? undefined : HIDDEN_LINK_PREFIXES.get(namespace);\n\n    if (prefix === undefined || rest.length === 0) {\n        return undefined;\n    }\n\n    return [prefix, ...rest.map((segment) => cSymbolSegment(segment))].join(\"_\");\n};\n\nconst hiddenCIdentifier = (kind: string, target: string, segments: string[]): string | undefined => {\n    if (!CALLABLE_LINK_KINDS.has(kind)) {\n        return undefined;\n    }\n\n    const candidate = kind === \"id\" ? target : hiddenLinkCandidate(segments);\n\n    return candidate !== undefined && HIDDEN_SYMBOLS.has(candidate) ? candidate : undefined;\n};\n\nconst renderLink = (kind: string, target: string): string => {\n    const segments = target.split(/::|[.:]/);\n    const hidden = hiddenCIdentifier(kind, target, segments);\n\n    if (hidden !== undefined) {\n        return `\\`${hidden}()\\``;\n    }\n\n    const lastIndex = segments.length - 1;\n\n    if (kind === \"property\" || CALLABLE_LINK_KINDS.has(kind)) {\n        segments[lastIndex] = camelCase(segments[lastIndex] ?? \"\");\n    }\n\n    const symbol = segments.join(\".\");\n\n    return `\\`${symbol}${CALLABLE_LINK_KINDS.has(kind) ? \"()\" : \"\"}\\``;\n};\n\nconst renderTypeRef = (name: string, member: string | undefined): string => {\n    if (member === undefined) {\n        return `\\`${name}\\``;\n    }\n\n    return renderLink(member.startsWith(\"::\") ? \"signal\" : \"property\", `${name}${member}`);\n};\n\nconst renderParamRef = (name: string, identifiers: Map<string, string> | undefined): string =>\n    `\\`${identifiers?.get(name) ?? name}\\``;\n\nconst trimTrailingNewlines = (value: string): string => {\n    let end = value.length;\n\n    while (end > 0 && value[end - 1] === \"\\n\") {\n        end -= 1;\n    }\n\n    return value.slice(0, end);\n};\n\nconst renderCodeFence = (body: string): string => {\n    const languageMatch = CODE_LANGUAGE_PATTERN.exec(body);\n    const fence = (languageMatch?.[1] ?? \"\").trim().toLowerCase();\n    const rest = languageMatch === null ? body : body.slice(languageMatch[0].length);\n    const code = trimTrailingNewlines(rest.trimStart());\n\n    return `\\`\\`\\`${fence}\\n${code}\\n\\`\\`\\``;\n};\n\nconst renderListing = (code: string): string => `\\n\\`\\`\\`\\n${code.trim()}\\n\\`\\`\\`\\n`;\n\nconst replaceDocBookTags = (text: string): string =>\n    replaceDelimited(text, [DOCBOOK_LISTING_OPEN, DOCBOOK_LISTING_CLOSE], renderListing)\n        .replaceAll(DOCBOOK_EXAMPLE_PATTERN, \"\\n\")\n        .replaceAll(DOCBOOK_ITEM_OPEN_PATTERN, \"\\n- \")\n        .replaceAll(DOCBOOK_ITEM_CLOSE_PATTERN, \"\\n\")\n        .replaceAll(DOCBOOK_LINK_PATTERN, (_match, label: string) => label)\n        .replaceAll(DOCBOOK_LITERAL_PATTERN, (_match, literal: string) => `\\`${literal}\\``)\n        .replaceAll(DOCBOOK_LIST_PATTERN, \"\\n\\n\")\n        .replaceAll(DOCBOOK_PARA_PATTERN, \"\\n\\n\");\n\nconst docBookToMarkdown = (text: string): string => {\n    if (!DOCBOOK_TAG_PATTERN.test(text)) {\n        return text;\n    }\n\n    return replaceDocBookTags(text).replaceAll(BLANK_LINE_RUN_PATTERN, \"\\n\\n\").trim();\n};\n\nconst replaceDelimited = (raw: string, bounds: [string, string], render: (body: string) => string): string => {\n    const [open, close] = bounds;\n    let result = \"\";\n    let cursor = 0;\n\n    while (cursor < raw.length) {\n        const start = raw.indexOf(open, cursor);\n\n        if (start === -1) {\n            break;\n        }\n\n        const end = raw.indexOf(close, start + open.length);\n\n        if (end === -1) {\n            break;\n        }\n\n        result += raw.slice(cursor, start);\n        result += render(raw.slice(start + open.length, end));\n        cursor = end + close.length;\n    }\n\n    return result + raw.slice(cursor);\n};\n\nconst protectCodeBlocks = (raw: string, protect: (value: string) => string): string =>\n    replaceDelimited(raw, [CODE_BLOCK_OPEN, CODE_BLOCK_CLOSE], (body) => protect(renderCodeFence(body)));\n\nconst stripHtmlComments = (text: string): string => {\n    let current = text;\n    let previous = \"\";\n\n    while (current !== previous) {\n        previous = current;\n        current = current.replaceAll(HTML_COMMENT_PATTERN, \"\");\n    }\n\n    return current;\n};\n\n// eslint-disable-next-line gtkx/no-library-prefix\nconst gtkDocToMarkdown = (raw: string, identifiers?: Map<string, string>): string => {\n    const stash: string[] = [];\n\n    const protect = (value: string): string => {\n        const token = `${SENTINEL}${String(stash.length)}${SENTINEL}`;\n        stash.push(value);\n\n        return token;\n    };\n\n    let text = protectCodeBlocks(docBookToMarkdown(raw), protect);\n    text = text.replaceAll(FENCED_BLOCK_PATTERN, (block) => protect(block));\n    text = text.replaceAll(INLINE_CODE_PATTERN, (span) => protect(span));\n    text = text.replaceAll(LINK_PATTERN, (_match, kind: string, target: string) => protect(renderLink(kind, target)));\n    text = text.replaceAll(CONSTANT_PATTERN, (_match, name: string) => protect(`\\`${CONSTANT_MAP[name] ?? name}\\``));\n    text = text.replaceAll(ESCAPED_CONSTANT_PATTERN, \"%\");\n\n    text = text.replaceAll(TYPE_REF_PATTERN, (_match, name: string, member: string | undefined) =>\n        protect(renderTypeRef(name, member)),\n    );\n\n    text = text.replaceAll(PARAM_REF_PATTERN, (_match, name: string) => protect(renderParamRef(name, identifiers)));\n    text = text.replaceAll(FUNCTION_REF_PATTERN, (_match, name: string) => protect(`\\`${name}()\\``));\n    text = stripHtmlComments(text);\n\n    for (let index = stash.length - 1; index >= 0; index -= 1) {\n        const value = stash[index] ?? \"\";\n        text = text.replaceAll(`${SENTINEL}${String(index)}${SENTINEL}`, () => value);\n    }\n\n    return text;\n};\n\nexport { gtkDocToMarkdown };\n"]}

package/overrides/gdk/rgba.ts.ejs

@@ -5,6 +5,9 @@ import { RGBA as GeneratedRGBA } from "../gdk.js";
  *
  * @param value a CSS color string, such as `#rgb`, `rgb(r,g,b)`, or a named color
  * @returns the parsed color
+ * @deprecated Since 1.3. Use `new RGBA()` and `parse`, checking what `parse` returns so a string GDK cannot
+ * read is rejected rather than left as transparent black, or `new RGBA({ red, green, blue, alpha })` when the
+ * components are known. Removed in v2.
  */
 const create = (value: string): GeneratedRGBA => {
     const rgba = new GeneratedRGBA();
@@ -22,7 +25,18 @@ const create = (value: string): GeneratedRGBA => {
  * (1.0, 1.0, 1.0, 1.0) is opaque white. Other values will
  * be clamped to this range when drawing.
  */
-export const RGBA: typeof GeneratedRGBA & { create: typeof create } = Object.assign(GeneratedRGBA, { create });
+export const RGBA: typeof GeneratedRGBA & {
+    /**
+     * Parses a CSS color string into a new `RGBA`.
+     *
+     * @param value a CSS color string, such as `#rgb`, `rgb(r,g,b)`, or a named color
+     * @returns the parsed color
+     * @deprecated Since 1.3. Use `new RGBA()` and `parse`, checking what `parse` returns so a string GDK cannot
+     * read is rejected rather than left as transparent black, or `new RGBA({ red, green, blue, alpha })` when the
+     * components are known. Removed in v2.
+     */
+    create: typeof create;
+} = Object.assign(GeneratedRGBA, { create });
 
 /**
  * Represents a color, in a way that is compatible with cairo's notion of color.

package/overrides/glib/index.ts.ejs

@@ -0,0 +1,3 @@
+export * from "./glib.js";
+
+import "./overrides/regex.js";

package/overrides/glib/regex.ts.ejs

@@ -0,0 +1,66 @@
+import { matchAllRegex, matchRegex } from "@gtkx/runtime";
+import { type MatchInfo, Regex, type RegexMatchFlags } from "../glib.js";
+
+declare module "../glib.js" {
+    interface Regex {
+        /**
+         * Scans for a match in `string` for the pattern in `this`.
+         *
+         * The returned `MatchInfo` keeps the searched string alive, so its fetch
+         * methods stay valid for as long as the `MatchInfo` is reachable.
+         *
+         * @param string the string to scan for matches
+         * @param startPosition starting index of the string to match, in bytes
+         * @param matchOptions match options
+         * @returns Tuple of:
+         *
+         * - `result`: `true` if the string matched, `false` otherwise
+         * - `matchInfo`: pointer to location where to store the `GMatchInfo`, or `null` if you do not need it
+         * @throws A `GLib.Error` carrying the failing operation's domain, code, and message.
+         * @since 2.14
+         */
+        matchFull(string: string, startPosition: number, matchOptions: RegexMatchFlags): [boolean, MatchInfo];
+        /**
+         * Using the DFA algorithm, scans for all the possible matches in `string`,
+         * including overlapping ones.
+         *
+         * The returned `MatchInfo` keeps the searched string alive, so its fetch
+         * methods stay valid for as long as the `MatchInfo` is reachable.
+         *
+         * @param string the string to scan for matches
+         * @param startPosition starting index of the string to match, in bytes
+         * @param matchOptions match options
+         * @returns Tuple of:
+         *
+         * - `result`: `true` if the string matched, `false` otherwise
+         * - `matchInfo`: pointer to location where to store the `GMatchInfo`, or `null` if you do not need it
+         * @throws A `GLib.Error` carrying the failing operation's domain, code, and message.
+         * @since 2.14
+         */
+        matchAllFull(string: string, startPosition: number, matchOptions: RegexMatchFlags): [boolean, MatchInfo];
+    }
+}
+
+Regex.prototype.match = function match(string: string, matchOptions: RegexMatchFlags): [boolean, MatchInfo] {
+    return matchRegex<MatchInfo>(this, string, 0, matchOptions);
+};
+
+Regex.prototype.matchAll = function matchAll(string: string, matchOptions: RegexMatchFlags): [boolean, MatchInfo] {
+    return matchAllRegex<MatchInfo>(this, string, 0, matchOptions);
+};
+
+Regex.prototype.matchFull = function matchFull(
+    string: string | string[],
+    startPosition: number,
+    matchOptions: RegexMatchFlags,
+): [boolean, MatchInfo] {
+    return matchRegex<MatchInfo>(this, string, startPosition, matchOptions);
+};
+
+Regex.prototype.matchAllFull = function matchAllFull(
+    string: string | string[],
+    startPosition: number,
+    matchOptions: RegexMatchFlags,
+): [boolean, MatchInfo] {
+    return matchAllRegex<MatchInfo>(this, string, startPosition, matchOptions);
+};

package/overrides/gobject/index.ts.ejs

@@ -26,4 +26,7 @@ export {
 } from "@gtkx/runtime";
 export * from "./gobject.js";
 export * from "./overrides/object.js";
+export { ObjectClass } from "./overrides/object-class.js";
+export * from "./overrides/param-spec.js";
+export * from "./overrides/param-spec-getters.js";
 export * from "./overrides/value.js";

package/overrides/gobject/object-class.ts.ejs

@@ -0,0 +1,27 @@
+import { type AnyClass, peekTypeClass } from "@gtkx/runtime";
+import { ObjectClass as GeneratedObjectClass, type Type } from "../gobject.js";
+
+const peek = (type: Type | AnyClass): GeneratedObjectClass => peekTypeClass(type) as GeneratedObjectClass;
+
+/**
+ * The class structure for the GObject type, with a static `peek` that hands back the class struct
+ * of any GObject type so class-level introspection such as `findProperty` and `listProperties`
+ * works outside a `classInit` hook.
+ */
+export const ObjectClass: typeof GeneratedObjectClass & {
+    /**
+     * Returns the class struct of a GObject type, referencing the class so it exists even before
+     * the type's first instance. The reference is deliberately never released: once created, a
+     * class struct lives for the rest of the process.
+     *
+     * @param type GType to peek the class struct of, or a registered wrapper class of the type.
+     * @returns the type's class struct
+     * @throws when `type` is not a GObject type
+     */
+    peek: typeof peek;
+} = Object.assign(GeneratedObjectClass, { peek });
+
+/**
+ * The class structure for the GObject type.
+ */
+export type ObjectClass = GeneratedObjectClass;

package/overrides/gobject/param-spec-getters.ts.ejs

@@ -0,0 +1,57 @@
+import { getParamSpecFlags, getParamSpecOwnerType, getParamSpecValueType } from "@gtkx/runtime";
+import { type ParamFlags, ParamSpec, type Type } from "../gobject.js";
+
+declare module "../gobject.js" {
+    interface ParamSpec {
+        /** The `GParamFlags` the spec was created with, such as `ParamFlags.READWRITE` or `ParamFlags.CONSTRUCT_ONLY`. */
+        readonly flags: ParamFlags;
+
+        /** GType of the values the spec describes, such as `TYPE_INT` for a `paramSpecInt` spec. */
+        readonly valueType: Type;
+
+        /** GType the spec is installed on, or `TYPE_INVALID` while it is not installed on any type. */
+        readonly ownerType: Type;
+
+        /** Canonical name of the spec, as `getName` returns it. */
+        readonly name: string;
+
+        /** Nickname of the spec, as `getNick` returns it. */
+        readonly nick: string;
+
+        /** Short description of the spec, as `getBlurb` returns it. */
+        readonly blurb: string | null;
+    }
+}
+
+Object.defineProperties(ParamSpec.prototype, {
+    flags: {
+        get(this: ParamSpec): ParamFlags {
+            return getParamSpecFlags(this) as ParamFlags;
+        },
+    },
+    valueType: {
+        get(this: ParamSpec): Type {
+            return getParamSpecValueType(this);
+        },
+    },
+    ownerType: {
+        get(this: ParamSpec): Type {
+            return getParamSpecOwnerType(this);
+        },
+    },
+    name: {
+        get(this: ParamSpec): string {
+            return this.getName();
+        },
+    },
+    nick: {
+        get(this: ParamSpec): string {
+            return this.getNick();
+        },
+    },
+    blurb: {
+        get(this: ParamSpec): string | null {
+            return this.getBlurb();
+        },
+    },
+});

package/overrides/gobject/param-spec.ts.ejs

@@ -0,0 +1,21 @@
+import { type AnyClass, newParamSpecOverride, wrapHandle } from "@gtkx/runtime";
+import { ParamSpec, type Type } from "../gobject.js";
+
+/**
+ * Creates a `ParamSpec` that redirects to the property `source` declares under `name`, for
+ * redeclaring in a subclass a property a parent class or an implemented interface already
+ * carries — the equivalent of `g_param_spec_override`, which introspection does not expose.
+ *
+ * Installing the returned spec through the `properties` option of `registerClass` gives the
+ * subclass its own storage and change notification for the property, while its value type,
+ * flags and default stay the ones the overridden spec declares.
+ *
+ * Throws when `source` is neither a GType nor a registered class or interface, and when it
+ * declares no property under `name`.
+ *
+ * @param name Canonical name of the property to override.
+ * @param source The GType, wrapper class or interface declaring the property.
+ * @returns The override spec, ready to install on a subclass.
+ */
+export const paramSpecOverride = (name: string, source: Type | AnyClass): ParamSpec =>
+    wrapHandle(newParamSpecOverride(name, source), ParamSpec);

package/overrides/gobject/value.ts.ejs

@@ -7,6 +7,8 @@ import { type Type, Value } from "../gobject.js";
  * @param gtype GType the value holds.
  * @param populate Called with the initialized value to write the contents.
  * @returns The populated value.
+ * @deprecated Since 1.3. Pass the value itself where a `Value` is expected, or build one with `new Value()`
+ * and `init` when it has to hold a GType inference cannot name. Removed in v2.
  */
 export const buildValue = (gtype: Type, populate: (value: Value) => void): Value => {
     const value = new Value();
@@ -19,6 +21,9 @@ Value.prototype.getBoxed = function <T = unknown>(this: Value): T {
     return getBoxedValue(getHandle(this)) as T;
 };
 
-Value.prototype.setBoxed = function (this: Value, boxed: object | null): void {
+Value.prototype.setBoxed = function (
+    this: Value,
+    boxed: object | string | number | bigint | boolean | null,
+): void {
     setBoxedValue(getHandle(this), boxed);
 };