@gtkx/codegen 1.2.1 → 1.3.0

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);
 };

package/overrides/graphene/structs.ts.ejs

@@ -6,6 +6,7 @@ import { Point as GeneratedPoint, Rect as GeneratedRect, Size as GeneratedSize }
  * @param x the X coordinate
  * @param y the Y coordinate
  * @returns the initialized point
+ * @deprecated Since 1.3. Use `new Point({ x, y })` instead. Removed in v2.
  */
 const createPoint = (x: number, y: number): GeneratedPoint => {
     const point = GeneratedPoint.alloc();
@@ -21,6 +22,7 @@ const createPoint = (x: number, y: number): GeneratedPoint => {
  * @param width the width of the rectangle
  * @param height the height of the rectangle
  * @returns the initialized rectangle
+ * @deprecated Since 1.3. Use `new Rect()` and `init(x, y, width, height)` instead. Removed in v2.
  */
 const createRect = (x: number, y: number, width: number, height: number): GeneratedRect => {
     const rect = GeneratedRect.alloc();
@@ -34,6 +36,7 @@ const createRect = (x: number, y: number, width: number, height: number): Genera
  * @param width the width
  * @param height the height
  * @returns the initialized size
+ * @deprecated Since 1.3. Use `new Size({ width, height })` instead. Removed in v2.
  */
 const createSize = (width: number, height: number): GeneratedSize => {
     const size = GeneratedSize.alloc();
@@ -42,7 +45,17 @@ const createSize = (width: number, height: number): GeneratedSize => {
 };
 
 /** A point with two coordinates. */
-export const Point: typeof GeneratedPoint & { create: typeof createPoint } = Object.assign(GeneratedPoint, {
+export const Point: typeof GeneratedPoint & {
+    /**
+     * Allocates a new `Point` and initializes it to the given coordinates.
+     *
+     * @param x the X coordinate
+     * @param y the Y coordinate
+     * @returns the initialized point
+     * @deprecated Since 1.3. Use `new Point({ x, y })` instead. Removed in v2.
+     */
+    create: typeof createPoint;
+} = Object.assign(GeneratedPoint, {
     create: createPoint,
 });
 
@@ -63,7 +76,19 @@ export type Point = GeneratedPoint;
  * will internally operate on a normalized copy; all functions returning a
  * `graphene_rect_t` will always return a normalized rectangle.
  */
-export const Rect: typeof GeneratedRect & { create: typeof createRect } = Object.assign(GeneratedRect, {
+export const Rect: typeof GeneratedRect & {
+    /**
+     * Allocates a new `Rect` and initializes it to the given origin and size.
+     *
+     * @param x the X coordinate of the origin
+     * @param y the Y coordinate of the origin
+     * @param width the width of the rectangle
+     * @param height the height of the rectangle
+     * @returns the initialized rectangle
+     * @deprecated Since 1.3. Use `new Rect()` and `init(x, y, width, height)` instead. Removed in v2.
+     */
+    create: typeof createRect;
+} = Object.assign(GeneratedRect, {
     create: createRect,
 });
 
@@ -84,7 +109,17 @@ export const Rect: typeof GeneratedRect & { create: typeof createRect } = Object
 export type Rect = GeneratedRect;
 
 /** A size. */
-export const Size: typeof GeneratedSize & { create: typeof createSize } = Object.assign(GeneratedSize, {
+export const Size: typeof GeneratedSize & {
+    /**
+     * Allocates a new `Size` and initializes it to the given width and height.
+     *
+     * @param width the width
+     * @param height the height
+     * @returns the initialized size
+     * @deprecated Since 1.3. Use `new Size({ width, height })` instead. Removed in v2.
+     */
+    create: typeof createSize;
+} = Object.assign(GeneratedSize, {
     create: createSize,
 });
 

package/overrides/gtk/index.ts.ejs

@@ -0,0 +1,2 @@
+export * from "./gtk.js";
+export { WidgetClass } from "./overrides/widget-class.js";

package/overrides/gtk/widget-class.ts.ejs

@@ -0,0 +1,28 @@
+import { type AnyClass, peekTypeClass } from "@gtkx/runtime";
+import { type Type } from "../../gobject/gobject.js";
+import { Widget, WidgetClass as GeneratedWidgetClass } from "../gtk.js";
+
+const peek = (type: Type | AnyClass): GeneratedWidgetClass => peekTypeClass(type, Widget) as GeneratedWidgetClass;
+
+/**
+ * The class structure for the GtkWidget type, with a static `peek` that hands back the class
+ * struct of any widget type so class-level introspection such as `getCssName` works outside a
+ * `classInit` hook.
+ */
+export const WidgetClass: typeof GeneratedWidgetClass & {
+    /**
+     * Returns the class struct of a widget 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 widget type's class struct
+     * @throws when `type` is not a type deriving from `Gtk.Widget`
+     */
+    peek: typeof peek;
+} = Object.assign(GeneratedWidgetClass, { peek });
+
+/**
+ * The class structure for the GtkWidget type.
+ */
+export type WidgetClass = GeneratedWidgetClass;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gtkx/codegen",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Generates the typed GTKX bindings and API reference from GIR and OpenGL registry data",
   "keywords": [
     "gtkx",
@@ -55,11 +55,12 @@
   },
   "dependencies": {
     "@types/node": "^26.2.0",
-    "fast-xml-parser": "^5.10.1",
-    "fast-xml-validator": "^1.4.1",
+    "fast-xml-parser": "^5.11.0",
+    "fast-xml-validator": "^1.4.2",
     "typescript": "^6.0.3",
-    "@gtkx/react": "1.2.1",
-    "@gtkx/utils": "1.2.1"
+    "@gtkx/cairo": "1.3.0",
+    "@gtkx/react": "1.3.0",
+    "@gtkx/utils": "1.3.0"
   },
   "scripts": {
     "release": "tsx ../../scripts/release-package.ts"