@gtkx/codegen 1.0.0-rc.4 → 1.0.0

package/dist/store/jsx/props.js.map

@@ -1 +1 @@
-{"version":3,"file":"props.js","sourceRoot":"","sources":["../../../src/store/jsx/props.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAM5D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACrG,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAqB,MAAM,2BAA2B,CAAC;AAChG,OAAO,EAAoB,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACpH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAyDnD,MAAM,mBAAmB,GAAG,CAAC,KAAyB,EAAE,QAAqB,EAAE,MAAc,EAAQ,EAAE;IACnG,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACtE,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAEtC,IAAI,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC9C,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,MAAM,MAAM,MAAM,qCAAqC,CAAC,CAAC;QACvF,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEnC,OAAO;IACX,CAAC;IAED,MAAM,UAAU,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAErD,IAAI,UAAU,EAAE,CAAC;QACb,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,MAAM,MAAM,MAAM,sBAAsB,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,WAAW,GAAG,YAAY,MAAM,kDAAkD,CAAC;IACzF,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,WAAW,UAAU,CAAC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AACpG,CAAC,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAAC,KAAyB,EAAE,QAAqB,EAAQ,EAAE;IACvF,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC3B,OAAO;IACX,CAAC;IAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEhD,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC;QAClF,OAAO;IACX,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC,KAAyB,EAAE,MAAmB,EAAQ,EAAE;IACnF,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAEnD,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9B,OAAO;IACX,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC5B,MAAM,SAAS,GAAG,mBAAmB,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACxF,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,OAAO,SAAS,gBAAgB,CAAC,CAAC;AACnG,CAAC,CAAC;AAEF,MAAM,wBAAwB,GAAG,CAAC,KAA4B,EAAsB,EAAE;IAClF,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAC1B,MAAM,OAAO,GAAwB,IAAI,GAAG,EAAE,CAAC;IAC/C,MAAM,KAAK,GAA0B,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAE1D,MAAM,KAAK,GAAuB;QAC9B,KAAK;QACL,KAAK;QACL,SAAS,EAAE,EAAE;QACb,eAAe,EAAE,EAAE;QACnB,IAAI,EAAE,IAAI,GAAG,EAAU;KAC1B,CAAC;IAEF,OAAO;QACH,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO;QACP,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,cAAc,EAAE,CAAC,QAAQ,EAAE,EAAE;YACzB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC7C,CAAC;QACD,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;YACrB,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;KACJ,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,wBAAwB,GAAG,CAAC,OAAqC,EAAgC,EAAE;IACrG,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,0BAA0B,GAAG,GAAG,EAAE,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC;IACxF,MAAM,SAAS,GAAG,wBAAwB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAE1E,2BAA2B,CAAC;QACxB,OAAO;QACP,KAAK;QACL,SAAS;QACT,0BAA0B;QAC1B,cAAc,EAAE,SAAS,CAAC,cAAc;QACxC,YAAY,EAAE,SAAS,CAAC,YAAY;KACvC,CAAC,CAAC;IAEH,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,eAAe,EAAE,SAAS,CAAC,eAAe,EAAE,CAAC;AACtH,CAAC,CAAC;AAEF,MAAM,0BAA0B,GAAG,CAAC,OAA8B,EAAgC,EAAE;IAChG,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAC9C,MAAM,SAAS,GAAG,wBAAwB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAEjF,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACtC,SAAS,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACjC,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,eAAe,EAAE,SAAS,CAAC,eAAe,EAAE,CAAC;AACtH,CAAC,CAAC;AAEF,MAAM,2BAA2B,GAAG,CAAC,IAAgC,EAAQ,EAAE;IAC3E,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,0BAA0B,EAAE,cAAc,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAErG,MAAM,YAAY,GAAG,CAAC,WAAqB,EAAQ,EAAE;QACjD,KAAK,MAAM,QAAQ,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;YAC5C,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;QAED,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;YACvC,YAAY,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IACxC,YAAY,CAAC,KAAK,CAAC,CAAC;IAEpB,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,EAAE;QAC1C,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC,EAAE,0BAA0B,CAAC,CAAC;AACnC,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,OAAgB,EAAE,GAAuB,EAAW,EAAE;IACzE,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEtC,IAAI,QAAQ,EAAE,IAAI,KAAK,WAAW,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,QAAQ,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,OAAO,uBAAuB,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAChF,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,OAAgB,EAAE,QAAqB,EAAW,EAAE;IACtE,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC;QAC/C,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,OAAO,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,OAA4B,EAAU,EAAE;IACjE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAE5C,MAAM,MAAM,GAAG;QACX,GAAG,uBAAuB,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,mBAAmB,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC3G,SAAS,QAAQ,EAAE;KACtB,CAAC;IAEF,MAAM,MAAM,GAAG,uBAAuB,CAAC;QACnC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM;QACN,UAAU,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,mBAAmB,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC;QACxE,4BAA4B,EAAE,KAAK;QACnC,QAAQ,EAAE,IAAI;KACjB,CAAC,CAAC;IAEH,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,MAAM,EAAE,CAAC;AACjD,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,OAA8B,EAAgB,EAAE,CACjE,gBAAgB,CACZ,OAAO,CAAC,OAAO,EACf,CAAC,IAAI,EAAE,EAAE;IACL,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,gBAAgB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IAE9E,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;AACtE,CAAC,EACD,GAAG,EAAE;IACD,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC;IAE5D,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,OAAO,CAAC;AACjD,CAAC,CACJ,CAAC;AAEN,MAAM,mBAAmB,GAAG,CAAC,OAA8B,EAAE,GAAuB,EAAE,UAAmB,EAAU,EAAE;IACjH,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC;IAExE,OAAO,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC,CAAC;AAEF,OAAO,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC","sourcesContent":["import { toCamelIdentifier, upperFirst } from \"@gtkx/utils\";\nimport type { GirClass } from \"../../gir/class.js\";\nimport type { Library } from \"../../gir/library.js\";\nimport type { GirNamespace } from \"../../gir/namespace.js\";\nimport type { GirCallable } from \"../../gir/parameter.js\";\nimport type { TypeId } from \"../../gir/type-id.js\";\nimport { forEachAncestor } from \"../../analysis/inheritance.js\";\nimport { renderHandlerParameters, renderHandlerResultType } from \"../../analysis/param-structure.js\";\nimport { recordTypeTarget, renderBaseType, type TsTypeTarget } from \"../../analysis/ts-type.js\";\nimport { type GirProperty, isConstructableProperty } from \"../../gir/property.js\";\nimport { renderJsDoc } from \"../../writer/doc.js\";\nimport { getGlibName, giNamespaceAlias, isIntrinsicElementClass, signalHandlerName } from \"./intrinsic-elements.js\";\nimport { isOmittedProp } from \"./omitted-props.js\";\n\ntype IntrinsicElementPropsEntries = {\n    propLines: string[];\n    imports: Map<string, string>;\n    objectPropNames: string[];\n};\n\ntype IntrinsicElementScope = {\n    library: Library;\n    klass: GirClass;\n    namespace: GirNamespace;\n};\n\ntype IntrinsicElementPropsOptions = IntrinsicElementScope & {\n    isIntrinsicElementAncestor?: (candidate: GirClass) => boolean;\n};\n\ntype PropTypeRenderContext = {\n    library: Library;\n    imports: Map<string, string>;\n};\n\ntype SignalRenderOptions = {\n    types: PropTypeRenderContext;\n    signal: GirCallable;\n    selfType: string;\n};\n\ntype PropEntryCollector = {\n    propLines: string[];\n    imports: Map<string, string>;\n    objectPropNames: string[];\n    acceptProperty: (property: GirProperty) => void;\n    acceptSignal: (signal: GirCallable) => void;\n};\n\ntype PropCollectorState = {\n    owner: IntrinsicElementScope;\n    types: PropTypeRenderContext;\n    propLines: string[];\n    objectPropNames: string[];\n    seen: Set<string>;\n};\n\ntype InterfacePropsOptions = {\n    library: Library;\n    iface: GirClass;\n    namespace: GirNamespace;\n};\n\ntype IntrinsicElementMemberWalk = IntrinsicElementScope & {\n    isIntrinsicElementAncestor: (candidate: GirClass) => boolean;\n    acceptProperty: (property: GirProperty) => void;\n    acceptSignal: (signal: GirCallable) => void;\n};\n\nconst appendPropertyLines = (state: PropCollectorState, property: GirProperty, jsName: string): void => {\n    const tsType = renderReactPropType(state.types, property.type, false);\n    const doc = renderJsDoc(property.doc);\n\n    if (isObjectProp(state.owner.library, property)) {\n        state.propLines.push(`${doc}${jsName}?: ${tsType} | ReactElement | null | undefined;`);\n        state.objectPropNames.push(jsName);\n\n        return;\n    }\n\n    const isSettable = isConstructableProperty(property);\n\n    if (isSettable) {\n        state.propLines.push(`${doc}${jsName}?: ${tsType} | null | undefined;`);\n    }\n\n    const handlerType = `((value: ${tsType} | null, self: Self) => void) | null | undefined`;\n    state.propLines.push(`${isSettable ? \"\" : doc}onNotify${upperFirst(jsName)}?: ${handlerType};`);\n};\n\nconst acceptCollectorProperty = (state: PropCollectorState, property: GirProperty): void => {\n    if (!property.introspectable) {\n        return;\n    }\n\n    const jsName = toCamelIdentifier(property.name);\n\n    if (state.seen.has(jsName) || isOmittedProp(getGlibName(state.owner.klass), jsName)) {\n        return;\n    }\n\n    state.seen.add(jsName);\n    appendPropertyLines(state, property, jsName);\n};\n\nconst acceptCollectorSignal = (state: PropCollectorState, signal: GirCallable): void => {\n    const handlerName = signalHandlerName(signal.name);\n\n    if (state.seen.has(handlerName)) {\n        return;\n    }\n\n    state.seen.add(handlerName);\n    const signature = renderSignalHandler({ types: state.types, signal, selfType: \"Self\" });\n    state.propLines.push(`${renderJsDoc(signal.doc)}${handlerName}?: (${signature}) | undefined;`);\n};\n\nconst createPropEntryCollector = (owner: IntrinsicElementScope): PropEntryCollector => {\n    const { library } = owner;\n    const imports: Map<string, string> = new Map();\n    const types: PropTypeRenderContext = { library, imports };\n\n    const state: PropCollectorState = {\n        owner,\n        types,\n        propLines: [],\n        objectPropNames: [],\n        seen: new Set<string>(),\n    };\n\n    return {\n        propLines: state.propLines,\n        imports,\n        objectPropNames: state.objectPropNames,\n        acceptProperty: (property) => {\n            acceptCollectorProperty(state, property);\n        },\n        acceptSignal: (signal) => {\n            acceptCollectorSignal(state, signal);\n        },\n    };\n};\n\nconst buildElementPropsEntries = (options: IntrinsicElementPropsOptions): IntrinsicElementPropsEntries => {\n    const { library, klass, namespace, isIntrinsicElementAncestor = () => false } = options;\n    const collector = createPropEntryCollector({ library, klass, namespace });\n\n    walkIntrinsicElementMembers({\n        library,\n        klass,\n        namespace,\n        isIntrinsicElementAncestor,\n        acceptProperty: collector.acceptProperty,\n        acceptSignal: collector.acceptSignal,\n    });\n\n    return { propLines: collector.propLines, imports: collector.imports, objectPropNames: collector.objectPropNames };\n};\n\nconst buildInterfacePropsEntries = (options: InterfacePropsOptions): IntrinsicElementPropsEntries => {\n    const { library, iface, namespace } = options;\n    const collector = createPropEntryCollector({ library, klass: iface, namespace });\n\n    for (const property of iface.properties) {\n        collector.acceptProperty(property);\n    }\n\n    for (const signal of iface.signals) {\n        collector.acceptSignal(signal);\n    }\n\n    return { propLines: collector.propLines, imports: collector.imports, objectPropNames: collector.objectPropNames };\n};\n\nconst walkIntrinsicElementMembers = (walk: IntrinsicElementMemberWalk): void => {\n    const { library, klass, namespace, isIntrinsicElementAncestor, acceptProperty, acceptSignal } = walk;\n\n    const visitMembers = (memberClass: GirClass): void => {\n        for (const property of memberClass.properties) {\n            acceptProperty(property);\n        }\n\n        for (const signal of memberClass.signals) {\n            acceptSignal(signal);\n        }\n    };\n\n    const ancestry = { library, namespace };\n    visitMembers(klass);\n\n    forEachAncestor(ancestry, klass, (ancestor) => {\n        visitMembers(ancestor.klass);\n    }, isIntrinsicElementAncestor);\n};\n\nconst isGObjectType = (library: Library, ref: TypeId | undefined): boolean => {\n    if (ref === undefined) {\n        return false;\n    }\n\n    const resolved = library.typeFor(ref);\n\n    if (resolved?.kind === \"interface\") {\n        return true;\n    }\n\n    if (resolved?.kind !== \"class\") {\n        return false;\n    }\n\n    return isIntrinsicElementClass(resolved.value, resolved.namespace, library);\n};\n\nconst isObjectProp = (library: Library, property: GirProperty): boolean => {\n    if (!property.writable || property.constructOnly) {\n        return false;\n    }\n\n    return isGObjectType(library, property.type);\n};\n\nconst renderSignalHandler = (options: SignalRenderOptions): string => {\n    const { types, signal, selfType } = options;\n\n    const params = [\n        ...renderHandlerParameters(signal.parameters, (ref, nullable) => renderReactPropType(types, ref, nullable)),\n        `self: ${selfType}`,\n    ];\n\n    const result = renderHandlerResultType({\n        library: types.library,\n        signal,\n        renderType: (ref, nullable) => renderReactPropType(types, ref, nullable),\n        shouldIncludeCallerAllocated: false,\n        isOptOut: true,\n    });\n\n    return `(${params.join(\", \")}) => ${result}`;\n};\n\nconst reactTarget = (context: PropTypeRenderContext): TsTypeTarget =>\n    recordTypeTarget(\n        context.library,\n        (name) => {\n            context.imports.set(name.namespaceName, giNamespaceAlias(name.namespaceName));\n\n            return `${giNamespaceAlias(name.namespaceName)}.${name.typeName}`;\n        },\n        () => {\n            context.imports.set(\"GObject\", giNamespaceAlias(\"GObject\"));\n\n            return `${giNamespaceAlias(\"GObject\")}.Type`;\n        },\n    );\n\nconst renderReactPropType = (context: PropTypeRenderContext, ref: TypeId | undefined, isNullable: boolean): string => {\n    const base = renderBaseType(context.library, reactTarget(context), ref);\n\n    return isNullable ? `${base} | null` : base;\n};\n\nexport { buildElementPropsEntries, buildInterfacePropsEntries, isObjectProp, reactTarget };\n"]}
+{"version":3,"file":"props.js","sourceRoot":"","sources":["../../../src/store/jsx/props.ts"],"names":[],"mappings":"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","sourcesContent":["import { toCamelIdentifier, upperFirst } from \"@gtkx/utils\";\nimport type { GirClass } from \"../../gir/class.js\";\nimport type { Library } from \"../../gir/library.js\";\nimport type { GirNamespace } from \"../../gir/namespace.js\";\nimport type { GirCallable } from \"../../gir/parameter.js\";\nimport type { TypeId } from \"../../gir/type-id.js\";\nimport type { JsDocSpec } from \"../../writer/doc.js\";\nimport { forEachAncestor } from \"../../analysis/inheritance.js\";\nimport { renderHandlerParameters, renderHandlerResultType } from \"../../analysis/param-structure.js\";\nimport { recordTypeTarget, renderBaseType, type TsTypeTarget } from \"../../analysis/ts-type.js\";\nimport { type GirProperty, isConstructableProperty } from \"../../gir/property.js\";\nimport { renderJsDoc } from \"../../writer/doc.js\";\nimport { annotationSpec, selfHandlerSpec } from \"../gi/doc-spec.js\";\nimport { getGlibName, giNamespaceAlias, isIntrinsicElementClass, signalHandlerName } from \"./intrinsic-elements.js\";\nimport { isOmittedProp } from \"./omitted-props.js\";\n\ntype IntrinsicElementPropsEntries = {\n    propLines: string[];\n    imports: Map<string, string>;\n    objectPropNames: string[];\n};\n\ntype IntrinsicElementScope = {\n    library: Library;\n    klass: GirClass;\n    namespace: GirNamespace;\n};\n\ntype IntrinsicElementPropsOptions = IntrinsicElementScope & {\n    isIntrinsicElementAncestor?: (candidate: GirClass) => boolean;\n};\n\ntype PropTypeRenderContext = {\n    library: Library;\n    imports: Map<string, string>;\n};\n\ntype SignalRenderOptions = {\n    types: PropTypeRenderContext;\n    signal: GirCallable;\n    selfType: string;\n};\n\ntype PropEntryCollector = {\n    propLines: string[];\n    imports: Map<string, string>;\n    objectPropNames: string[];\n    acceptProperty: (property: GirProperty) => void;\n    acceptSignal: (signal: GirCallable) => void;\n};\n\ntype PropCollectorState = {\n    owner: IntrinsicElementScope;\n    types: PropTypeRenderContext;\n    propLines: string[];\n    objectPropNames: string[];\n    seen: Set<string>;\n};\n\ntype InterfacePropsOptions = {\n    library: Library;\n    iface: GirClass;\n    namespace: GirNamespace;\n};\n\ntype IntrinsicElementMemberWalk = IntrinsicElementScope & {\n    isIntrinsicElementAncestor: (candidate: GirClass) => boolean;\n    acceptProperty: (property: GirProperty) => void;\n    acceptSignal: (signal: GirCallable) => void;\n};\n\nconst notifyDoc = (property: GirProperty, jsName: string, spec: JsDocSpec): string => {\n    const note = `Called with the new value when \\`${jsName}\\` changes.`;\n    const doc = property.doc;\n    const text = doc === undefined || doc.length === 0 ? note : `${note}\\n\\n${doc}`;\n\n    return renderJsDoc(text, undefined, spec);\n};\n\nconst appendPropertyLines = (state: PropCollectorState, property: GirProperty, jsName: string): void => {\n    const tsType = renderReactPropType(state.types, property.type, false);\n    const spec = annotationSpec(property.annotations);\n    const doc = renderJsDoc(property.doc, undefined, spec);\n\n    if (isObjectProp(state.owner.library, property)) {\n        state.propLines.push(`${doc}${jsName}?: ${tsType} | ReactElement | null | undefined;`);\n        state.objectPropNames.push(jsName);\n\n        return;\n    }\n\n    if (isConstructableProperty(property)) {\n        state.propLines.push(`${doc}${jsName}?: ${tsType} | null | undefined;`);\n    }\n\n    const handlerType = `((value: ${tsType} | null, self: Self) => void) | null | undefined`;\n\n    state.propLines.push(\n        `${notifyDoc(property, jsName, spec)}onNotify${upperFirst(jsName)}?: ${handlerType};`,\n    );\n};\n\nconst acceptCollectorProperty = (state: PropCollectorState, property: GirProperty): void => {\n    if (!property.introspectable) {\n        return;\n    }\n\n    const jsName = toCamelIdentifier(property.name);\n\n    if (state.seen.has(jsName) || isOmittedProp(getGlibName(state.owner.klass), jsName)) {\n        return;\n    }\n\n    state.seen.add(jsName);\n    appendPropertyLines(state, property, jsName);\n};\n\nconst acceptCollectorSignal = (state: PropCollectorState, signal: GirCallable): void => {\n    const handlerName = signalHandlerName(signal.name);\n\n    if (state.seen.has(handlerName)) {\n        return;\n    }\n\n    state.seen.add(handlerName);\n    const signature = renderSignalHandler({ types: state.types, signal, selfType: \"Self\" });\n    const doc = renderJsDoc(signal.doc, undefined, selfHandlerSpec(signal));\n    state.propLines.push(`${doc}${handlerName}?: (${signature}) | undefined;`);\n};\n\nconst createPropEntryCollector = (owner: IntrinsicElementScope): PropEntryCollector => {\n    const { library } = owner;\n    const imports: Map<string, string> = new Map();\n    const types: PropTypeRenderContext = { library, imports };\n\n    const state: PropCollectorState = {\n        owner,\n        types,\n        propLines: [],\n        objectPropNames: [],\n        seen: new Set<string>(),\n    };\n\n    return {\n        propLines: state.propLines,\n        imports,\n        objectPropNames: state.objectPropNames,\n        acceptProperty: (property) => {\n            acceptCollectorProperty(state, property);\n        },\n        acceptSignal: (signal) => {\n            acceptCollectorSignal(state, signal);\n        },\n    };\n};\n\nconst buildElementPropsEntries = (options: IntrinsicElementPropsOptions): IntrinsicElementPropsEntries => {\n    const { library, klass, namespace, isIntrinsicElementAncestor = () => false } = options;\n    const collector = createPropEntryCollector({ library, klass, namespace });\n\n    walkIntrinsicElementMembers({\n        library,\n        klass,\n        namespace,\n        isIntrinsicElementAncestor,\n        acceptProperty: collector.acceptProperty,\n        acceptSignal: collector.acceptSignal,\n    });\n\n    return { propLines: collector.propLines, imports: collector.imports, objectPropNames: collector.objectPropNames };\n};\n\nconst buildInterfacePropsEntries = (options: InterfacePropsOptions): IntrinsicElementPropsEntries => {\n    const { library, iface, namespace } = options;\n    const collector = createPropEntryCollector({ library, klass: iface, namespace });\n\n    for (const property of iface.properties) {\n        collector.acceptProperty(property);\n    }\n\n    for (const signal of iface.signals) {\n        collector.acceptSignal(signal);\n    }\n\n    return { propLines: collector.propLines, imports: collector.imports, objectPropNames: collector.objectPropNames };\n};\n\nconst walkIntrinsicElementMembers = (walk: IntrinsicElementMemberWalk): void => {\n    const { library, klass, namespace, isIntrinsicElementAncestor, acceptProperty, acceptSignal } = walk;\n\n    const visitMembers = (memberClass: GirClass): void => {\n        for (const property of memberClass.properties) {\n            acceptProperty(property);\n        }\n\n        for (const signal of memberClass.signals) {\n            acceptSignal(signal);\n        }\n    };\n\n    const ancestry = { library, namespace };\n    visitMembers(klass);\n\n    forEachAncestor(ancestry, klass, (ancestor) => {\n        visitMembers(ancestor.klass);\n    }, isIntrinsicElementAncestor);\n};\n\nconst isGObjectType = (library: Library, ref: TypeId | undefined): boolean => {\n    if (ref === undefined) {\n        return false;\n    }\n\n    const resolved = library.typeFor(ref);\n\n    if (resolved?.kind === \"interface\") {\n        return true;\n    }\n\n    if (resolved?.kind !== \"class\") {\n        return false;\n    }\n\n    return isIntrinsicElementClass(resolved.value, resolved.namespace, library);\n};\n\nconst isObjectProp = (library: Library, property: GirProperty): boolean => {\n    if (!property.writable || property.constructOnly) {\n        return false;\n    }\n\n    return isGObjectType(library, property.type);\n};\n\nconst renderSignalHandler = (options: SignalRenderOptions): string => {\n    const { types, signal, selfType } = options;\n\n    const params = [\n        ...renderHandlerParameters(signal.parameters, (ref, nullable) => renderReactPropType(types, ref, nullable)),\n        `self: ${selfType}`,\n    ];\n\n    const result = renderHandlerResultType({\n        library: types.library,\n        signal,\n        renderType: (ref, nullable) => renderReactPropType(types, ref, nullable),\n        shouldIncludeCallerAllocated: false,\n        isOptOut: true,\n    });\n\n    return `(${params.join(\", \")}) => ${result}`;\n};\n\nconst reactTarget = (context: PropTypeRenderContext): TsTypeTarget =>\n    recordTypeTarget(\n        context.library,\n        (name) => {\n            context.imports.set(name.namespaceName, giNamespaceAlias(name.namespaceName));\n\n            return `${giNamespaceAlias(name.namespaceName)}.${name.typeName}`;\n        },\n        () => {\n            context.imports.set(\"GObject\", giNamespaceAlias(\"GObject\"));\n\n            return `${giNamespaceAlias(\"GObject\")}.Type`;\n        },\n    );\n\nconst renderReactPropType = (context: PropTypeRenderContext, ref: TypeId | undefined, isNullable: boolean): string => {\n    const base = renderBaseType(context.library, reactTarget(context), ref);\n\n    return isNullable ? `${base} | null` : base;\n};\n\nexport { buildElementPropsEntries, buildInterfacePropsEntries, isObjectProp };\n"]}

package/dist/writer/context.d.ts

@@ -1,6 +1,6 @@
 import type { Library } from "../gir/library.js";
 import type { GirNamespace } from "../gir/namespace.js";
-import { ModuleBuilder } from "./module.js";
+import { type DeclaredType, ModuleBuilder } from "./module.js";
 declare class ModuleContext {
     module: ModuleBuilder;
     namespace: GirNamespace;
@@ -11,6 +11,7 @@ declare class ModuleContext {
     hoistDescriptor(expression: string): string;
     addGObjectBootstrapImports(): void;
     addCrossNamespaceImport(namespaceName: string): string;
+    declaredType(owner: string, name?: string): DeclaredType;
     qualify(namespaceName: string, typeName: string): string;
 }
 export { ModuleContext };

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,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,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,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;CAO3D;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;AACxD,OAAO,EAAE,KAAK,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE/D,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,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAc,GAAG,YAAY;IAI/D,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;CAO3D;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/writer/context.js

@@ -39,6 +39,9 @@ class ModuleContext {
         this.module.imports.addNamespace(path, namespaceName);
         return namespaceName;
     }
+    declaredType(owner, name = owner) {
+        return { name, owner: `${this.namespace.name}.${owner}` };
+    }
     qualify(namespaceName, typeName) {
         if (namespaceName === this.namespace.name) {
             return typeName;

package/dist/writer/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/writer/context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,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,aAAqB,EAAE,QAAgB;QAC3C,IAAI,aAAa,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACxC,OAAO,QAAQ,CAAC;QACpB,CAAC;QAED,OAAO,GAAG,IAAI,CAAC,uBAAuB,CAAC,aAAa,CAAC,IAAI,QAAQ,EAAE,CAAC;IACxE,CAAC;CACJ;AAED,OAAO,EAAE,aAAa,EAAE,CAAC","sourcesContent":["import type { Library } from \"../gir/library.js\";\nimport type { GirNamespace } from \"../gir/namespace.js\";\nimport { 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    qualify(namespaceName: string, typeName: string): string {\n        if (namespaceName === this.namespace.name) {\n            return typeName;\n        }\n\n        return `${this.addCrossNamespaceImport(namespaceName)}.${typeName}`;\n    }\n}\n\nexport { ModuleContext };\n"]}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/writer/context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,aAAa,EAAE,MAAM,aAAa,CAAC;AAE/D,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,YAAY,CAAC,KAAa,EAAE,OAAe,KAAK;QAC5C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;IAC9D,CAAC;IAED,OAAO,CAAC,aAAqB,EAAE,QAAgB;QAC3C,IAAI,aAAa,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACxC,OAAO,QAAQ,CAAC;QACpB,CAAC;QAED,OAAO,GAAG,IAAI,CAAC,uBAAuB,CAAC,aAAa,CAAC,IAAI,QAAQ,EAAE,CAAC;IACxE,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 DeclaredType, 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    declaredType(owner: string, name: string = owner): DeclaredType {\n        return { name, owner: `${this.namespace.name}.${owner}` };\n    }\n\n    qualify(namespaceName: string, typeName: string): string {\n        if (namespaceName === this.namespace.name) {\n            return typeName;\n        }\n\n        return `${this.addCrossNamespaceImport(namespaceName)}.${typeName}`;\n    }\n}\n\nexport { ModuleContext };\n"]}

package/dist/writer/doc-tags.d.ts

@@ -0,0 +1,21 @@
+type JsDocParam = {
+    name: string;
+    doc: string;
+};
+type JsDocDeprecation = {
+    since: string | undefined;
+    doc: string | undefined;
+};
+type JsDocSpec = {
+    params?: JsDocParam[];
+    returns?: string | undefined;
+    throws?: string | undefined;
+    deprecated?: JsDocDeprecation | undefined;
+    since?: string | undefined;
+    identifiers?: Map<string, string> | undefined;
+};
+type DocConverter = (text: string) => string;
+declare const stripDocMedia: (markdown: string) => string;
+declare const renderDocTagLines: (spec: JsDocSpec, convert: DocConverter) => string[];
+export { renderDocTagLines, stripDocMedia, type JsDocDeprecation, type JsDocParam, type JsDocSpec };
+//# sourceMappingURL=doc-tags.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doc-tags.d.ts","sourceRoot":"","sources":["../../src/writer/doc-tags.ts"],"names":[],"mappings":"AAAA,KAAK,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAChD,KAAK,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE/E,KAAK,SAAS,GAAG;IACb,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,UAAU,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CACjD,CAAC;AAEF,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAO7C,QAAA,MAAM,aAAa,GAAI,UAAU,MAAM,KAAG,MAC8D,CAAC;AAyCzG,QAAA,MAAM,iBAAiB,GAAI,MAAM,SAAS,EAAE,SAAS,YAAY,KAAG,MAAM,EAMzE,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,CAAC"}

package/dist/writer/doc-tags.js

@@ -0,0 +1,38 @@
+const WHITESPACE_RUN_PATTERN = /\s+/g;
+const PICTURE_PATTERN = /<picture[\s\S]*?<\/picture>/g;
+const VIDEO_PATTERN = /<video[\s\S]*?(?:<\/video>|\/>)/g;
+const IMAGE_PATTERN = /<img[^>]*>/g;
+const stripDocMedia = (markdown) => markdown.replaceAll(PICTURE_PATTERN, "").replaceAll(VIDEO_PATTERN, "").replaceAll(IMAGE_PATTERN, "");
+const flatten = (text, convert) => convert(text).replaceAll(WHITESPACE_RUN_PATTERN, " ").trim();
+const paramLines = (params, convert) => (params ?? [])
+    .map((param) => ({ name: param.name, text: flatten(param.doc, convert) }))
+    .filter((entry) => entry.text.length > 0)
+    .map((entry) => `@param ${entry.name} ${entry.text}`);
+const returnsLines = (returns, convert) => {
+    const text = convert(returns ?? "").trim();
+    return text.length === 0 ? [] : `@returns ${text}`.split("\n");
+};
+const simpleTagLine = (tag, value, convert) => {
+    const text = flatten(value ?? "", convert);
+    return text.length === 0 ? [] : [`${tag} ${text}`];
+};
+const sinceClause = (since) => since === undefined || since.length === 0 ? "" : `Since ${since}.`;
+const deprecatedText = (deprecation, convert) => [sinceClause(deprecation.since), flatten(deprecation.doc ?? "", convert)]
+    .filter((part) => part.length > 0)
+    .join(" ");
+const deprecatedLine = (deprecation, convert) => {
+    if (deprecation === undefined) {
+        return [];
+    }
+    const text = deprecatedText(deprecation, convert);
+    return [text.length === 0 ? "@deprecated" : `@deprecated ${text}`];
+};
+const renderDocTagLines = (spec, convert) => [
+    ...paramLines(spec.params, convert),
+    ...returnsLines(spec.returns, convert),
+    ...simpleTagLine("@throws", spec.throws, convert),
+    ...deprecatedLine(spec.deprecated, convert),
+    ...simpleTagLine("@since", spec.since, convert),
+];
+export { renderDocTagLines, stripDocMedia };
+//# sourceMappingURL=doc-tags.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doc-tags.js","sourceRoot":"","sources":["../../src/writer/doc-tags.ts"],"names":[],"mappings":"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","sourcesContent":["type JsDocParam = { name: string; doc: string };\ntype JsDocDeprecation = { since: string | undefined; doc: string | undefined };\n\ntype JsDocSpec = {\n    params?: JsDocParam[];\n    returns?: string | undefined;\n    throws?: string | undefined;\n    deprecated?: JsDocDeprecation | undefined;\n    since?: string | undefined;\n    identifiers?: Map<string, string> | undefined;\n};\n\ntype DocConverter = (text: string) => string;\n\nconst WHITESPACE_RUN_PATTERN = /\\s+/g;\nconst PICTURE_PATTERN = /<picture[\\s\\S]*?<\\/picture>/g;\nconst VIDEO_PATTERN = /<video[\\s\\S]*?(?:<\\/video>|\\/>)/g;\nconst IMAGE_PATTERN = /<img[^>]*>/g;\n\nconst stripDocMedia = (markdown: string): string =>\n    markdown.replaceAll(PICTURE_PATTERN, \"\").replaceAll(VIDEO_PATTERN, \"\").replaceAll(IMAGE_PATTERN, \"\");\n\nconst flatten = (text: string, convert: DocConverter): string =>\n    convert(text).replaceAll(WHITESPACE_RUN_PATTERN, \" \").trim();\n\nconst paramLines = (params: JsDocParam[] | undefined, convert: DocConverter): string[] =>\n    (params ?? [])\n        .map((param) => ({ name: param.name, text: flatten(param.doc, convert) }))\n        .filter((entry) => entry.text.length > 0)\n        .map((entry) => `@param ${entry.name} ${entry.text}`);\n\nconst returnsLines = (returns: string | undefined, convert: DocConverter): string[] => {\n    const text = convert(returns ?? \"\").trim();\n\n    return text.length === 0 ? [] : `@returns ${text}`.split(\"\\n\");\n};\n\nconst simpleTagLine = (tag: string, value: string | undefined, convert: DocConverter): string[] => {\n    const text = flatten(value ?? \"\", convert);\n\n    return text.length === 0 ? [] : [`${tag} ${text}`];\n};\n\nconst sinceClause = (since: string | undefined): string =>\n    since === undefined || since.length === 0 ? \"\" : `Since ${since}.`;\n\nconst deprecatedText = (deprecation: JsDocDeprecation, convert: DocConverter): string =>\n    [sinceClause(deprecation.since), flatten(deprecation.doc ?? \"\", convert)]\n        .filter((part) => part.length > 0)\n        .join(\" \");\n\nconst deprecatedLine = (deprecation: JsDocDeprecation | undefined, convert: DocConverter): string[] => {\n    if (deprecation === undefined) {\n        return [];\n    }\n\n    const text = deprecatedText(deprecation, convert);\n\n    return [text.length === 0 ? \"@deprecated\" : `@deprecated ${text}`];\n};\n\nconst renderDocTagLines = (spec: JsDocSpec, convert: DocConverter): string[] => [\n    ...paramLines(spec.params, convert),\n    ...returnsLines(spec.returns, convert),\n    ...simpleTagLine(\"@throws\", spec.throws, convert),\n    ...deprecatedLine(spec.deprecated, convert),\n    ...simpleTagLine(\"@since\", spec.since, convert),\n];\n\nexport { renderDocTagLines, stripDocMedia, type JsDocDeprecation, type JsDocParam, type JsDocSpec };\n"]}

package/dist/writer/doc.d.ts

@@ -1,3 +1,5 @@
-declare const renderJsDoc: (doc: string | undefined) => string;
+import { type JsDocSpec } from "./doc-tags.js";
+declare const renderJsDoc: (doc: string | undefined, note?: string, spec?: JsDocSpec) => string;
+export { type JsDocSpec } from "./doc-tags.js";
 export { renderJsDoc };
 //# sourceMappingURL=doc.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"doc.d.ts","sourceRoot":"","sources":["../../src/writer/doc.ts"],"names":[],"mappings":"AAgBA,QAAA,MAAM,WAAW,GAAI,KAAK,MAAM,GAAG,SAAS,KAAG,MAM9C,CAAC;AAEF,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"doc.d.ts","sourceRoot":"","sources":["../../src/writer/doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAoC,MAAM,eAAe,CAAC;AAqCjF,QAAA,MAAM,WAAW,GAAI,KAAK,MAAM,GAAG,SAAS,EAAE,OAAO,MAAM,EAAE,OAAO,SAAS,KAAG,MAO/E,CAAC;AAEF,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/writer/doc.js

@@ -1,18 +1,31 @@
+import { renderDocTagLines, stripDocMedia } from "./doc-tags.js";
 import { gtkDocToMarkdown } from "./gtk-doc.js";
 const escapeCommentTerminators = (doc) => doc.replaceAll("*/", String.raw `*\/`);
-const renderJsDocLines = (lines) => {
+const convertDoc = (doc, identifiers) => escapeCommentTerminators(stripDocMedia(gtkDocToMarkdown(doc, identifiers)));
+const renderJsDocLines = (lines, isCollapsible) => {
     const [single, ...rest] = lines;
-    if (single !== undefined && rest.length === 0) {
+    if (isCollapsible && single !== undefined && rest.length === 0) {
         return `/** ${single} */\n`;
     }
     const body = lines.map((line) => (line.length === 0 ? " *" : ` * ${line}`)).join("\n");
     return `/**\n${body}\n */\n`;
 };
-const renderJsDoc = (doc) => {
-    if (doc === undefined || doc.length === 0) {
-        return "";
+const docLines = (doc, identifiers) => doc === undefined || doc.length === 0 ? [] : convertDoc(doc, identifiers).split("\n");
+const appendNote = (lines, note) => lines.length === 0 ? note.split("\n") : [...lines, "", ...note.split("\n")];
+const appendTags = (lines, tagLines) => {
+    if (lines.length === 0 || tagLines.length === 0) {
+        return [...lines, ...tagLines];
     }
-    return renderJsDocLines(escapeCommentTerminators(gtkDocToMarkdown(doc)).split("\n"));
+    return [...lines, "", ...tagLines];
 };
+const specLines = (spec) => spec === undefined ? [] : renderDocTagLines(spec, (text) => convertDoc(text, spec.identifiers));
+const renderJsDoc = (doc, note, spec) => {
+    const described = docLines(doc, spec?.identifiers);
+    const withNote = note === undefined ? described : appendNote(described, note);
+    const tagLines = specLines(spec);
+    const lines = appendTags(withNote, tagLines);
+    return lines.length === 0 ? "" : renderJsDocLines(lines, tagLines.length === 0);
+};
+export {} from "./doc-tags.js";
 export { renderJsDoc };
 //# sourceMappingURL=doc.js.map

package/dist/writer/doc.js.map

@@ -1 +1 @@
-{"version":3,"file":"doc.js","sourceRoot":"","sources":["../../src/writer/doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,wBAAwB,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAA,KAAK,CAAC,CAAC;AAEhG,MAAM,gBAAgB,GAAG,CAAC,KAAe,EAAU,EAAE;IACjD,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC;IAEhC,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO,OAAO,MAAM,OAAO,CAAC;IAChC,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEvF,OAAO,QAAQ,IAAI,SAAS,CAAC;AACjC,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,GAAuB,EAAU,EAAE;IACpD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,OAAO,EAAE,CAAC;IACd,CAAC;IAED,OAAO,gBAAgB,CAAC,wBAAwB,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AACzF,CAAC,CAAC;AAEF,OAAO,EAAE,WAAW,EAAE,CAAC","sourcesContent":["import { gtkDocToMarkdown } from \"./gtk-doc.js\";\n\nconst escapeCommentTerminators = (doc: string): string => doc.replaceAll(\"*/\", String.raw`*\\/`);\n\nconst renderJsDocLines = (lines: string[]): string => {\n    const [single, ...rest] = lines;\n\n    if (single !== undefined && rest.length === 0) {\n        return `/** ${single} */\\n`;\n    }\n\n    const body = lines.map((line) => (line.length === 0 ? \" *\" : ` * ${line}`)).join(\"\\n\");\n\n    return `/**\\n${body}\\n */\\n`;\n};\n\nconst renderJsDoc = (doc: string | undefined): string => {\n    if (doc === undefined || doc.length === 0) {\n        return \"\";\n    }\n\n    return renderJsDocLines(escapeCommentTerminators(gtkDocToMarkdown(doc)).split(\"\\n\"));\n};\n\nexport { renderJsDoc };\n"]}
+{"version":3,"file":"doc.js","sourceRoot":"","sources":["../../src/writer/doc.ts"],"names":[],"mappings":"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","sourcesContent":["import { type JsDocSpec, renderDocTagLines, stripDocMedia } from \"./doc-tags.js\";\nimport { gtkDocToMarkdown } from \"./gtk-doc.js\";\n\nconst escapeCommentTerminators = (doc: string): string => doc.replaceAll(\"*/\", String.raw`*\\/`);\n\nconst convertDoc = (doc: string, identifiers: Map<string, string> | undefined): string =>\n    escapeCommentTerminators(stripDocMedia(gtkDocToMarkdown(doc, identifiers)));\n\nconst renderJsDocLines = (lines: string[], isCollapsible: boolean): string => {\n    const [single, ...rest] = lines;\n\n    if (isCollapsible && single !== undefined && rest.length === 0) {\n        return `/** ${single} */\\n`;\n    }\n\n    const body = lines.map((line) => (line.length === 0 ? \" *\" : ` * ${line}`)).join(\"\\n\");\n\n    return `/**\\n${body}\\n */\\n`;\n};\n\nconst docLines = (doc: string | undefined, identifiers: Map<string, string> | undefined): string[] =>\n    doc === undefined || doc.length === 0 ? [] : convertDoc(doc, identifiers).split(\"\\n\");\n\nconst appendNote = (lines: string[], note: string): string[] =>\n    lines.length === 0 ? note.split(\"\\n\") : [...lines, \"\", ...note.split(\"\\n\")];\n\nconst appendTags = (lines: string[], tagLines: string[]): string[] => {\n    if (lines.length === 0 || tagLines.length === 0) {\n        return [...lines, ...tagLines];\n    }\n\n    return [...lines, \"\", ...tagLines];\n};\n\nconst specLines = (spec: JsDocSpec | undefined): string[] =>\n    spec === undefined ? [] : renderDocTagLines(spec, (text) => convertDoc(text, spec.identifiers));\n\nconst renderJsDoc = (doc: string | undefined, note?: string, spec?: JsDocSpec): string => {\n    const described = docLines(doc, spec?.identifiers);\n    const withNote = note === undefined ? described : appendNote(described, note);\n    const tagLines = specLines(spec);\n    const lines = appendTags(withNote, tagLines);\n\n    return lines.length === 0 ? \"\" : renderJsDocLines(lines, tagLines.length === 0);\n};\n\nexport { type JsDocSpec } from \"./doc-tags.js\";\nexport { renderJsDoc };\n"]}

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

@@ -1,3 +1,3 @@
-declare const gtkDocToMarkdown: (raw: string) => string;
+declare const gtkDocToMarkdown: (raw: string, identifiers?: Map<string, string>) => string;
 export { gtkDocToMarkdown };
 //# sourceMappingURL=gtk-doc.d.ts.map

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":"AAyEA,QAAA,MAAM,gBAAgB,GAAI,KAAK,MAAM,KAAG,MAyBvC,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,CAAC"}
+{"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"}

package/dist/writer/gtk-doc.js

@@ -1,6 +1,6 @@
 import { camelCase } from "@gtkx/utils";
 const CONSTANT_MAP = { TRUE: "true", FALSE: "false", NULL: "null" };
-const CALLABLE_LINK_KINDS = new Set(["method", "func", "ctor", "vfunc"]);
+const CALLABLE_LINK_KINDS = new Set(["method", "func", "ctor", "vfunc", "id"]);
 const SENTINEL = String.fromCodePoint(0xE0_00);
 const CODE_BLOCK_OPEN = "|[";
 const CODE_BLOCK_CLOSE = "]|";
@@ -8,10 +8,23 @@ const CODE_LANGUAGE_PATTERN = /^\s*<!--\s*language="([^"]*)"\s*-->/;
 const FENCED_BLOCK_PATTERN = /```[\s\S]*?```/g;
 const INLINE_CODE_PATTERN = /`[^`\n]*`/g;
 const LINK_PATTERN = /\[(\w+)@([\w.:%#-]+)\]/g;
-const CONSTANT_PATTERN = /(?<!\w)%(\w+)/g;
-const TYPE_REF_PATTERN = /(?<!\w)#(\w+)/g;
+const CONSTANT_PATTERN = /(?<![\w\\])%(\w+)/g;
+const ESCAPED_CONSTANT_PATTERN = /\\%/g;
+const TYPE_REF_PATTERN = /(?<!\w)#(\w+)(::[\w-]+|:[\w-]+)?/g;
 const PARAM_REF_PATTERN = /(?<!\w)@(\w+)/g;
 const FUNCTION_REF_PATTERN = /\b([a-z_][a-z0-9_]*)\(\)/g;
+const HTML_COMMENT_PATTERN = /<!--[\s\S]*?-->/g;
+const DOCBOOK_TAG_PATTERN = /<\/?(?:itemizedlist|listitem|para|literal|link|informalexample|programlisting)[\s>]/;
+const DOCBOOK_LISTING_OPEN = "<programlisting>";
+const DOCBOOK_LISTING_CLOSE = "</programlisting>";
+const DOCBOOK_EXAMPLE_PATTERN = /<\/?informalexample>\s*/g;
+const DOCBOOK_ITEM_OPEN_PATTERN = /<listitem>\s*(?:<para>\s*)?/g;
+const DOCBOOK_ITEM_CLOSE_PATTERN = /(?:<\/para>\s*)?<\/listitem>\s*/g;
+const DOCBOOK_LINK_PATTERN = /<link\s+linkend="[^"]*">([\s\S]*?)<\/link>/g;
+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 renderLink = (kind, target) => {
     const segments = target.split(/::|[.:]/);
     const lastIndex = segments.length - 1;
@@ -21,6 +34,13 @@ const renderLink = (kind, target) => {
     const symbol = segments.join(".");
     return `\`${symbol}${CALLABLE_LINK_KINDS.has(kind) ? "()" : ""}\``;
 };
+const renderTypeRef = (name, member) => {
+    if (member === undefined) {
+        return `\`${name}\``;
+    }
+    return renderLink(member.startsWith("::") ? "signal" : "property", `${name}${member}`);
+};
+const renderParamRef = (name, identifiers) => `\`${identifiers?.get(name) ?? name}\``;
 const trimTrailingNewlines = (value) => {
     let end = value.length;
     while (end > 0 && value[end - 1] === "\n") {
@@ -35,39 +55,68 @@ const renderCodeFence = (body) => {
     const code = trimTrailingNewlines(rest.trimStart());
     return `\`\`\`${fence}\n${code}\n\`\`\``;
 };
-const protectCodeBlocks = (raw, protect) => {
+const renderListing = (code) => `\n\`\`\`\n${code.trim()}\n\`\`\`\n`;
+const replaceDocBookTags = (text) => replaceDelimited(text, [DOCBOOK_LISTING_OPEN, DOCBOOK_LISTING_CLOSE], renderListing)
+    .replaceAll(DOCBOOK_EXAMPLE_PATTERN, "\n")
+    .replaceAll(DOCBOOK_ITEM_OPEN_PATTERN, "\n- ")
+    .replaceAll(DOCBOOK_ITEM_CLOSE_PATTERN, "\n")
+    .replaceAll(DOCBOOK_LINK_PATTERN, (_match, label) => label)
+    .replaceAll(DOCBOOK_LITERAL_PATTERN, (_match, literal) => `\`${literal}\``)
+    .replaceAll(DOCBOOK_LIST_PATTERN, "\n\n")
+    .replaceAll(DOCBOOK_PARA_PATTERN, "\n\n");
+const docBookToMarkdown = (text) => {
+    if (!DOCBOOK_TAG_PATTERN.test(text)) {
+        return text;
+    }
+    return replaceDocBookTags(text).replaceAll(BLANK_LINE_RUN_PATTERN, "\n\n").trim();
+};
+const replaceDelimited = (raw, bounds, render) => {
+    const [open, close] = bounds;
     let result = "";
     let cursor = 0;
     while (cursor < raw.length) {
-        const open = raw.indexOf(CODE_BLOCK_OPEN, cursor);
-        if (open === -1) {
+        const start = raw.indexOf(open, cursor);
+        if (start === -1) {
             break;
         }
-        const close = raw.indexOf(CODE_BLOCK_CLOSE, open + CODE_BLOCK_OPEN.length);
-        if (close === -1) {
+        const end = raw.indexOf(close, start + open.length);
+        if (end === -1) {
             break;
         }
-        result += raw.slice(cursor, open);
-        result += protect(renderCodeFence(raw.slice(open + CODE_BLOCK_OPEN.length, close)));
-        cursor = close + CODE_BLOCK_CLOSE.length;
+        result += raw.slice(cursor, start);
+        result += render(raw.slice(start + open.length, end));
+        cursor = end + close.length;
     }
     return result + raw.slice(cursor);
 };
-const gtkDocToMarkdown = (raw) => {
+const protectCodeBlocks = (raw, protect) => replaceDelimited(raw, [CODE_BLOCK_OPEN, CODE_BLOCK_CLOSE], (body) => protect(renderCodeFence(body)));
+const stripHtmlComments = (text) => {
+    let current = text;
+    let previous = "";
+    while (current !== previous) {
+        previous = current;
+        current = current.replaceAll(HTML_COMMENT_PATTERN, "");
+    }
+    return current;
+};
+// eslint-disable-next-line gtkx/no-library-prefix
+const gtkDocToMarkdown = (raw, identifiers) => {
     const stash = [];
     const protect = (value) => {
         const token = `${SENTINEL}${String(stash.length)}${SENTINEL}`;
         stash.push(value);
         return token;
     };
-    let text = protectCodeBlocks(raw, protect);
+    let text = protectCodeBlocks(docBookToMarkdown(raw), protect);
     text = text.replaceAll(FENCED_BLOCK_PATTERN, (block) => protect(block));
     text = text.replaceAll(INLINE_CODE_PATTERN, (span) => protect(span));
     text = text.replaceAll(LINK_PATTERN, (_match, kind, target) => protect(renderLink(kind, target)));
     text = text.replaceAll(CONSTANT_PATTERN, (_match, name) => protect(`\`${CONSTANT_MAP[name] ?? name}\``));
-    text = text.replaceAll(TYPE_REF_PATTERN, (_match, name) => protect(`\`${name}\``));
-    text = text.replaceAll(PARAM_REF_PATTERN, (_match, name) => protect(`\`${name}\``));
+    text = text.replaceAll(ESCAPED_CONSTANT_PATTERN, "%");
+    text = text.replaceAll(TYPE_REF_PATTERN, (_match, name, member) => protect(renderTypeRef(name, member)));
+    text = text.replaceAll(PARAM_REF_PATTERN, (_match, name) => protect(renderParamRef(name, identifiers)));
     text = text.replaceAll(FUNCTION_REF_PATTERN, (_match, name) => protect(`\`${name}()\``));
+    text = stripHtmlComments(text);
     for (let index = stash.length - 1; index >= 0; index -= 1) {
         const value = stash[index] ?? "";
         text = text.replaceAll(`${SENTINEL}${String(index)}${SENTINEL}`, () => value);

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\"]);\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 TYPE_REF_PATTERN = /(?<!\\w)#(\\w+)/g;\nconst PARAM_REF_PATTERN = /(?<!\\w)@(\\w+)/g;\nconst FUNCTION_REF_PATTERN = /\\b([a-z_][a-z0-9_]*)\\(\\)/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 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 protectCodeBlocks = (raw: string, protect: (value: string) => string): string => {\n    let result = \"\";\n    let cursor = 0;\n\n    while (cursor < raw.length) {\n        const open = raw.indexOf(CODE_BLOCK_OPEN, cursor);\n\n        if (open === -1) {\n            break;\n        }\n\n        const close = raw.indexOf(CODE_BLOCK_CLOSE, open + CODE_BLOCK_OPEN.length);\n\n        if (close === -1) {\n            break;\n        }\n\n        result += raw.slice(cursor, open);\n        result += protect(renderCodeFence(raw.slice(open + CODE_BLOCK_OPEN.length, close)));\n        cursor = close + CODE_BLOCK_CLOSE.length;\n    }\n\n    return result + raw.slice(cursor);\n};\n\nconst gtkDocToMarkdown = (raw: 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(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(TYPE_REF_PATTERN, (_match, name: string) => protect(`\\`${name}\\``));\n    text = text.replaceAll(PARAM_REF_PATTERN, (_match, name: string) => protect(`\\`${name}\\``));\n    text = text.replaceAll(FUNCTION_REF_PATTERN, (_match, name: string) => protect(`\\`${name}()\\``));\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 } 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"]}

package/dist/writer/module.d.ts

@@ -1,16 +1,22 @@
 import { ImportsBuilder } from "./imports.js";
+type DeclaredType = {
+    name: string;
+    owner: string;
+};
 declare class ModuleBuilder {
     private bindings;
     private bindingNames;
     private hoistedDescriptors;
     private declarations;
+    private declaredTypes;
     private registrations;
     imports: ImportsBuilder;
+    private claimTypeName;
     appendBinding(code: string, name?: string): void;
     hoistDescriptor(expression: string): string;
-    appendDeclaration(code: string): void;
+    appendDeclaration(code: string, declared?: DeclaredType): void;
     appendRegistration(code: string): void;
     toSource(): string;
 }
-export { ModuleBuilder };
+export { type DeclaredType, ModuleBuilder };
 //# sourceMappingURL=module.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../src/writer/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,cAAM,aAAa;IACf,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,kBAAkB,CAAkC;IAC5D,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,aAAa,CAAgB;IAC9B,OAAO,EAAE,cAAc,CAAwB;IAEtD,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAYhD,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAc3C,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIrC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAItC,QAAQ,IAAI,MAAM;CAsBrB;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../src/writer/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,KAAK,YAAY,GAAG;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,cAAM,aAAa;IACf,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,kBAAkB,CAAkC;IAC5D,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,aAAa,CAAgB;IAC9B,OAAO,EAAE,cAAc,CAAwB;IAEtD,OAAO,CAAC,aAAa;IAarB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAYhD,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAc3C,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,IAAI;IAQ9D,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAItC,QAAQ,IAAI,MAAM;CAsBrB;AAED,OAAO,EAAE,KAAK,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/writer/module.js

@@ -4,8 +4,17 @@ class ModuleBuilder {
     bindingNames = new Set();
     hoistedDescriptors = new Map();
     declarations = [];
+    declaredTypes = new Map();
     registrations = [];
     imports = new ImportsBuilder();
+    claimTypeName(declared) {
+        const owner = this.declaredTypes.get(declared.name);
+        if (owner !== undefined && owner !== declared.owner) {
+            throw new Error(`The generated type '${declared.name}' is declared for both ${owner} and ${declared.owner}. ` +
+                "Rename one of them, or drop the namespace from the configuration.");
+        }
+        this.declaredTypes.set(declared.name, declared.owner);
+    }
     appendBinding(code, name) {
         if (name !== undefined) {
             if (this.bindingNames.has(name)) {
@@ -25,7 +34,10 @@ class ModuleBuilder {
         this.appendBinding(`const ${name} = ${expression};`, name);
         return name;
     }
-    appendDeclaration(code) {
+    appendDeclaration(code, declared) {
+        if (declared !== undefined) {
+            this.claimTypeName(declared);
+        }
         this.declarations.push(code);
     }
     appendRegistration(code) {

package/dist/writer/module.js.map

@@ -1 +1 @@
-{"version":3,"file":"module.js","sourceRoot":"","sources":["../../src/writer/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,aAAa;IACP,QAAQ,GAAa,EAAE,CAAC;IACxB,YAAY,GAAgB,IAAI,GAAG,EAAE,CAAC;IACtC,kBAAkB,GAAwB,IAAI,GAAG,EAAE,CAAC;IACpD,YAAY,GAAa,EAAE,CAAC;IAC5B,aAAa,GAAa,EAAE,CAAC;IAC9B,OAAO,GAAmB,IAAI,cAAc,EAAE,CAAC;IAEtD,aAAa,CAAC,IAAY,EAAE,IAAa;QACrC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACrB,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,OAAO;YACX,CAAC;YAED,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,eAAe,CAAC,UAAkB;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAEzD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,QAAQ,CAAC;QACpB,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,aAAa,CAAC,SAAS,IAAI,MAAM,UAAU,GAAG,EAAE,IAAI,CAAC,CAAC;QAE3D,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,iBAAiB,CAAC,IAAY;QAC1B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,kBAAkB,CAAC,IAAY;QAC3B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,QAAQ;QACJ,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QAE7C,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1C,CAAC;QAED,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IACxC,CAAC;CACJ;AAED,OAAO,EAAE,aAAa,EAAE,CAAC","sourcesContent":["import { ImportsBuilder } from \"./imports.js\";\n\nclass ModuleBuilder {\n    private bindings: string[] = [];\n    private bindingNames: Set<string> = new Set();\n    private hoistedDescriptors: Map<string, string> = new Map();\n    private declarations: string[] = [];\n    private registrations: string[] = [];\n    public imports: ImportsBuilder = new ImportsBuilder();\n\n    appendBinding(code: string, name?: string): void {\n        if (name !== undefined) {\n            if (this.bindingNames.has(name)) {\n                return;\n            }\n\n            this.bindingNames.add(name);\n        }\n\n        this.bindings.push(code);\n    }\n\n    hoistDescriptor(expression: string): string {\n        const existing = this.hoistedDescriptors.get(expression);\n\n        if (existing !== undefined) {\n            return existing;\n        }\n\n        const name = `_desc${String(this.hoistedDescriptors.size)}`;\n        this.hoistedDescriptors.set(expression, name);\n        this.appendBinding(`const ${name} = ${expression};`, name);\n\n        return name;\n    }\n\n    appendDeclaration(code: string): void {\n        this.declarations.push(code);\n    }\n\n    appendRegistration(code: string): void {\n        this.registrations.push(code);\n    }\n\n    toSource(): string {\n        const sections: string[] = [];\n        const importsBlock = this.imports.toSource();\n\n        if (importsBlock.length > 0) {\n            sections.push(importsBlock.trimEnd());\n        }\n\n        if (this.declarations.length > 0) {\n            sections.push(this.declarations.join(\"\\n\\n\"));\n        }\n\n        if (this.bindings.length > 0) {\n            sections.push(this.bindings.join(\"\\n\\n\"));\n        }\n\n        if (this.registrations.length > 0) {\n            sections.push(this.registrations.join(\"\\n\\n\"));\n        }\n\n        return `${sections.join(\"\\n\\n\")}\\n`;\n    }\n}\n\nexport { ModuleBuilder };\n"]}
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../src/writer/module.ts"],"names":[],"mappings":"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","sourcesContent":["import { ImportsBuilder } from \"./imports.js\";\n\ntype DeclaredType = {\n    name: string;\n    owner: string;\n};\n\nclass ModuleBuilder {\n    private bindings: string[] = [];\n    private bindingNames: Set<string> = new Set();\n    private hoistedDescriptors: Map<string, string> = new Map();\n    private declarations: string[] = [];\n    private declaredTypes: Map<string, string> = new Map();\n    private registrations: string[] = [];\n    public imports: ImportsBuilder = new ImportsBuilder();\n\n    private claimTypeName(declared: DeclaredType): void {\n        const owner = this.declaredTypes.get(declared.name);\n\n        if (owner !== undefined && owner !== declared.owner) {\n            throw new Error(\n                `The generated type '${declared.name}' is declared for both ${owner} and ${declared.owner}. ` +\n                \"Rename one of them, or drop the namespace from the configuration.\",\n            );\n        }\n\n        this.declaredTypes.set(declared.name, declared.owner);\n    }\n\n    appendBinding(code: string, name?: string): void {\n        if (name !== undefined) {\n            if (this.bindingNames.has(name)) {\n                return;\n            }\n\n            this.bindingNames.add(name);\n        }\n\n        this.bindings.push(code);\n    }\n\n    hoistDescriptor(expression: string): string {\n        const existing = this.hoistedDescriptors.get(expression);\n\n        if (existing !== undefined) {\n            return existing;\n        }\n\n        const name = `_desc${String(this.hoistedDescriptors.size)}`;\n        this.hoistedDescriptors.set(expression, name);\n        this.appendBinding(`const ${name} = ${expression};`, name);\n\n        return name;\n    }\n\n    appendDeclaration(code: string, declared?: DeclaredType): void {\n        if (declared !== undefined) {\n            this.claimTypeName(declared);\n        }\n\n        this.declarations.push(code);\n    }\n\n    appendRegistration(code: string): void {\n        this.registrations.push(code);\n    }\n\n    toSource(): string {\n        const sections: string[] = [];\n        const importsBlock = this.imports.toSource();\n\n        if (importsBlock.length > 0) {\n            sections.push(importsBlock.trimEnd());\n        }\n\n        if (this.declarations.length > 0) {\n            sections.push(this.declarations.join(\"\\n\\n\"));\n        }\n\n        if (this.bindings.length > 0) {\n            sections.push(this.bindings.join(\"\\n\\n\"));\n        }\n\n        if (this.registrations.length > 0) {\n            sections.push(this.registrations.join(\"\\n\\n\"));\n        }\n\n        return `${sections.join(\"\\n\\n\")}\\n`;\n    }\n}\n\nexport { type DeclaredType, ModuleBuilder };\n"]}

package/overrides/gdk/rgba.ts.ejs

@@ -1,11 +1,37 @@
 import { RGBA as GeneratedRGBA } from "../gdk.js";
 
+/**
+ * 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
+ */
 const create = (value: string): GeneratedRGBA => {
     const rgba = new GeneratedRGBA();
     rgba.parse(value);
     return rgba;
 };
 
+/**
+ * Represents a color, in a way that is compatible with cairo's notion of color.
+ *
+ * `GdkRGBA` is a convenient way to pass colors around. It's based on
+ * cairo's way to deal with colors and mirrors its behavior. All values
+ * are in the range from 0.0 to 1.0 inclusive. So the color
+ * (0.0, 0.0, 0.0, 0.0) represents transparent black and
+ * (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 });
 
+/**
+ * Represents a color, in a way that is compatible with cairo's notion of color.
+ *
+ * `GdkRGBA` is a convenient way to pass colors around. It's based on
+ * cairo's way to deal with colors and mirrors its behavior. All values
+ * are in the range from 0.0 to 1.0 inclusive. So the color
+ * (0.0, 0.0, 0.0, 0.0) represents transparent black and
+ * (1.0, 1.0, 1.0, 1.0) is opaque white. Other values will
+ * be clamped to this range when drawing.
+ */
 export type RGBA = GeneratedRGBA;