@gtkx/react 1.0.0-rc.3 → 1.0.0

package/dist/reconciler/placement.js.map

@@ -1 +1 @@
-{"version":3,"file":"placement.js","sourceRoot":"","sources":["../../src/reconciler/placement.ts"],"names":[],"mappings":"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","sourcesContent":["import * as GObject from \"@gtkx/gi/gobject\";\nimport * as Gtk from \"@gtkx/gi/gtk\";\nimport { getOrInsert, indexBeforeOrEnd, remove } from \"@gtkx/utils\";\nimport type { DetachInfo, ElementBehavior, PlaceInfo } from \"./registry.js\";\nimport { applyAdoptedProps, markFlush } from \"./apply-props.js\";\nimport { typeInfoFor } from \"./metadata.js\";\nimport {\n    DEFAULT_SLOT,\n    ELEMENT_KIND,\n    type ElementNode,\n    getOrCreateContext,\n    LAZY_KIND,\n    lazyTarget,\n    nodeObject,\n    type PlaceableNode,\n    type PlacedChild,\n} from \"./node.js\";\nimport { applyWrite } from \"./signals.js\";\nimport { markTextDirty } from \"./text.js\";\n\ntype AttachContext = { parent: ElementNode; entry: PlacedChild; index: number; sibling: GObject.Object | null };\n\nconst createEntry = (slot: string, node: PlaceableNode): PlacedChild | null => {\n    const object = nodeObject(node);\n\n    if (object === null) {\n        return null;\n    }\n\n    return { node, object, adopted: null, slot, behavior: null, attached: false };\n};\n\nconst siblingAt = (entries: PlacedChild[], index: number): GObject.Object | null =>\n    index > 0 ? (entries[index - 1]?.object ?? null) : null;\n\nconst placeInfo = (entry: PlacedChild, index: number, sibling: GObject.Object | null, context: unknown): PlaceInfo => ({\n    slot: entry.slot,\n    index,\n    sibling,\n    adopted: entry.adopted,\n    props: entry.node.props,\n    context,\n});\n\nconst adoptedFrom = (parent: ElementNode, entry: PlacedChild, behavior: ElementBehavior, claim: unknown): void => {\n    if (behavior.resolve !== undefined) {\n        entry.adopted = behavior.resolve(parent.object, entry.object);\n\n        return;\n    }\n\n    entry.adopted = claim instanceof GObject.Object ? claim : null;\n};\n\nconst applyLazyProps = (entry: PlacedChild): void => {\n    if (entry.node.kind !== LAZY_KIND || entry.adopted === null) {\n        return;\n    }\n\n    applyAdoptedProps(lazyTarget(entry.node, entry.adopted), {}, entry.node.props);\n    entry.node.adopted = entry.adopted;\n};\n\nconst wireBufferView = (node: PlaceableNode, parent: ElementNode): void => {\n    if (!(node.kind === ELEMENT_KIND && node.contentKind === \"buffer\" && parent.object instanceof Gtk.TextView)) {\n        return;\n    }\n\n    node.bufferView = parent.object;\n    markTextDirty(node);\n};\n\nconst writeSlot = (parent: ElementNode, entry: PlacedChild, value: GObject.Object | null): void => {\n    applyWrite(() => {\n        Reflect.set(parent.object, entry.slot, value);\n    });\n};\n\nconst setObjectSlot = (parent: ElementNode, entry: PlacedChild): void => {\n    writeSlot(parent, entry, entry.object);\n    wireBufferView(entry.node, parent);\n    entry.behavior = null;\n    entry.attached = true;\n};\n\nconst didAttach = (ctx: AttachContext, behavior: ElementBehavior): boolean => {\n    const attach = behavior.attach;\n\n    if (attach === undefined) {\n        return false;\n    }\n\n    const context = getOrCreateContext(ctx.parent, behavior);\n    const claim = attach(ctx.parent.object, ctx.entry.object, placeInfo(ctx.entry, ctx.index, ctx.sibling, context));\n\n    if (claim === undefined) {\n        return false;\n    }\n\n    ctx.entry.behavior = behavior;\n    adoptedFrom(ctx.parent, ctx.entry, behavior, claim);\n    ctx.entry.attached = true;\n    applyLazyProps(ctx.entry);\n\n    return true;\n};\n\nconst runAttach = (parent: ElementNode, entry: PlacedChild, index: number, sibling: GObject.Object | null): void => {\n    const ctx: AttachContext = { parent, entry, index, sibling };\n\n    for (const behavior of typeInfoFor(parent.typeName).behaviors) {\n        if (didAttach(ctx, behavior)) {\n            return;\n        }\n    }\n\n    if (entry.slot !== DEFAULT_SLOT) {\n        setObjectSlot(parent, entry);\n    }\n};\n\nconst attachEntry = (parent: ElementNode, entry: PlacedChild, index: number, sibling: GObject.Object | null): void => {\n    applyWrite(() => {\n        runAttach(parent, entry, index, sibling);\n    });\n};\n\nconst detachInfo = (entry: PlacedChild, context: unknown): DetachInfo => ({\n    slot: entry.slot,\n    adopted: entry.adopted,\n    props: entry.node.props,\n    context,\n});\n\nconst runDetach = (parent: ElementNode, entry: PlacedChild): void => {\n    const behavior = entry.behavior;\n\n    if (behavior === null) {\n        if (entry.slot !== DEFAULT_SLOT) {\n            writeSlot(parent, entry, null);\n        }\n\n        return;\n    }\n\n    behavior.detach?.(parent.object, entry.object, detachInfo(entry, getOrCreateContext(parent, behavior)));\n};\n\nconst detachEntry = (parent: ElementNode, entry: PlacedChild): void => {\n    if (!entry.attached) {\n        return;\n    }\n\n    entry.attached = false;\n\n    applyWrite(() => {\n        runDetach(parent, entry);\n    });\n};\n\nconst rebuild = (parent: ElementNode, entries: PlacedChild[]): void => {\n    for (const entry of entries) {\n        detachEntry(parent, entry);\n    }\n\n    for (const [index, entry] of entries.entries()) {\n        entry.behavior = null;\n        attachEntry(parent, entry, index, siblingAt(entries, index));\n    }\n};\n\nconst getPosition = (entries: PlacedChild[], before: PlaceableNode | null): number =>\n    indexBeforeOrEnd(entries, before, (entry, target) => entry.node === target);\n\nconst placeNew = (parent: ElementNode, entry: PlacedChild, entries: PlacedChild[], index: number): void => {\n    attachEntry(parent, entry, index, siblingAt(entries, index));\n\n    if (!entry.attached) {\n        remove(entries, entry);\n\n        return;\n    }\n\n    const isInsertedBeforeEnd = index < entries.length - 1;\n    const isCannotReorderInPlace = entry.behavior !== null && entry.behavior.reorder === undefined;\n\n    if (isInsertedBeforeEnd && isCannotReorderInPlace) {\n        rebuild(parent, entries);\n    }\n};\n\nconst moveEntry = (parent: ElementNode, entry: PlacedChild, entries: PlacedChild[], index: number): void => {\n    const behavior = entry.behavior;\n    const reorder = behavior?.reorder;\n\n    if (behavior === null || reorder === undefined) {\n        rebuild(parent, entries);\n\n        return;\n    }\n\n    const context = getOrCreateContext(parent, behavior);\n    const claim = reorder(parent.object, entry.object, placeInfo(entry, index, siblingAt(entries, index), context));\n    adoptedFrom(parent, entry, behavior, claim);\n    applyLazyProps(entry);\n};\n\nconst resolveEntry = (\n    entries: PlacedChild[],\n    existing: number,\n    slot: string,\n    node: PlaceableNode,\n): PlacedChild | null => {\n    if (existing >= 0) {\n        return entries[existing] ?? null;\n    }\n\n    return createEntry(slot, node);\n};\n\nconst placeChild = (\n    parent: ElementNode,\n    slot: string,\n    node: PlaceableNode,\n    before: PlaceableNode | null,\n): void => {\n    const entries = getOrInsert(parent.placements, slot, () => []);\n    const existing = entries.findIndex((entry) => entry.node === node);\n    const entry = resolveEntry(entries, existing, slot, node);\n\n    if (entry === null) {\n        return;\n    }\n\n    const isMove = existing !== -1;\n\n    if (isMove) {\n        entries.splice(existing, 1);\n    }\n\n    const index = getPosition(entries, before);\n    entries.splice(index, 0, entry);\n\n    if (isMove) {\n        moveEntry(parent, entry, entries, index);\n    } else {\n        placeNew(parent, entry, entries, index);\n    }\n\n    markFlush(parent);\n};\n\nconst unplaceChild = (parent: ElementNode, slot: string, node: PlaceableNode): void => {\n    const entries = parent.placements.get(slot);\n\n    if (entries === undefined) {\n        return;\n    }\n\n    const index = entries.findIndex((entry) => entry.node === node);\n\n    if (index === -1) {\n        return;\n    }\n\n    const [entry] = entries.splice(index, 1);\n\n    if (entry !== undefined) {\n        detachEntry(parent, entry);\n    }\n\n    markFlush(parent);\n};\n\nexport { placeChild, unplaceChild };\n"]}
+{"version":3,"file":"placement.js","sourceRoot":"","sources":["../../src/reconciler/placement.ts"],"names":[],"mappings":"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","sourcesContent":["import * as GObject from \"@gtkx/gi/gobject\";\nimport * as Gtk from \"@gtkx/gi/gtk\";\nimport { getOrInsert, indexBeforeOrEnd } from \"@gtkx/utils\";\nimport type { DetachInfo, ElementBehavior, PlaceInfo } from \"./registry.js\";\nimport { applyAdoptedProps, markFlush } from \"./apply-props.js\";\nimport { typeInfoFor } from \"./metadata.js\";\nimport {\n    DEFAULT_SLOT,\n    ELEMENT_KIND,\n    type ElementNode,\n    getOrCreateContext,\n    LAZY_KIND,\n    lazyTarget,\n    leafElement,\n    type PlaceableNode,\n    type PlacedChild,\n} from \"./node.js\";\nimport { applyWrite } from \"./signals.js\";\nimport { markTextDirty } from \"./text.js\";\n\ntype AttachContext = { parent: ElementNode; entry: PlacedChild; index: number; sibling: GObject.Object | null };\n\nconst createEntry = (slot: string, node: PlaceableNode): PlacedChild | null => {\n    const leaf = leafElement(node);\n\n    if (leaf === null) {\n        return null;\n    }\n\n    return {\n        node,\n        object: leaf.object,\n        typeName: leaf.typeName,\n        adopted: null,\n        slot,\n        behavior: null,\n    };\n};\n\nconst siblingAt = (entries: PlacedChild[], index: number): GObject.Object | null =>\n    index > 0 ? (entries[index - 1]?.object ?? null) : null;\n\nconst placeInfo = (entry: PlacedChild, index: number, sibling: GObject.Object | null, context: unknown): PlaceInfo => ({\n    slot: entry.slot,\n    index,\n    sibling,\n    adopted: entry.adopted,\n    props: entry.node.props,\n    context,\n});\n\nconst adoptedFrom = (parent: ElementNode, entry: PlacedChild, behavior: ElementBehavior, claim: unknown): void => {\n    if (behavior.resolve !== undefined) {\n        entry.adopted = behavior.resolve(parent.object, entry.object);\n\n        return;\n    }\n\n    entry.adopted = claim instanceof GObject.Object ? claim : null;\n};\n\nconst applyLazyProps = (entry: PlacedChild): void => {\n    if (entry.node.kind !== LAZY_KIND || entry.adopted === null) {\n        return;\n    }\n\n    applyAdoptedProps(lazyTarget(entry.node, entry.adopted), {}, entry.node.props);\n    entry.node.adopted = entry.adopted;\n};\n\nconst wireBufferView = (node: PlaceableNode, parent: ElementNode): void => {\n    if (!(node.kind === ELEMENT_KIND && node.contentKind === \"buffer\" && parent.object instanceof Gtk.TextView)) {\n        return;\n    }\n\n    node.bufferView = parent.object;\n    markTextDirty(node);\n};\n\nconst writeSlot = (parent: ElementNode, entry: PlacedChild, value: GObject.Object | null): void => {\n    applyWrite(() => {\n        Reflect.set(parent.object, entry.slot, value);\n    });\n};\n\nconst setObjectSlot = (parent: ElementNode, entry: PlacedChild): void => {\n    writeSlot(parent, entry, entry.object);\n    wireBufferView(entry.node, parent);\n    entry.behavior = null;\n};\n\nconst didAttach = (ctx: AttachContext, behavior: ElementBehavior): boolean => {\n    const attach = behavior.attach;\n\n    if (attach === undefined) {\n        return false;\n    }\n\n    const context = getOrCreateContext(ctx.parent, behavior);\n    const claim = attach(ctx.parent.object, ctx.entry.object, placeInfo(ctx.entry, ctx.index, ctx.sibling, context));\n\n    if (claim === undefined) {\n        return false;\n    }\n\n    ctx.entry.behavior = behavior;\n    adoptedFrom(ctx.parent, ctx.entry, behavior, claim);\n    applyLazyProps(ctx.entry);\n\n    return true;\n};\n\nconst unclaimedChildError = (parentTypeName: string, childTypeName: string): Error =>\n    new Error(\n        `<${childTypeName}> cannot be a child of <${parentTypeName}>. Pass it to the ` +\n        `<${parentTypeName}> prop that takes it, if there is one, portal it to rootElement with createPortal ` +\n        `if it does not belong inside <${parentTypeName}>, or register an attach behavior for ` +\n        `<${parentTypeName}> with defineElements from \"@gtkx/react/config\" if it belongs among its children.`,\n    );\n\nconst runAttach = (parent: ElementNode, entry: PlacedChild, index: number, sibling: GObject.Object | null): void => {\n    const ctx: AttachContext = { parent, entry, index, sibling };\n\n    for (const behavior of typeInfoFor(parent.typeName).behaviors) {\n        if (didAttach(ctx, behavior)) {\n            return;\n        }\n    }\n\n    if (entry.slot === DEFAULT_SLOT) {\n        throw unclaimedChildError(parent.typeName, entry.typeName);\n    }\n\n    setObjectSlot(parent, entry);\n};\n\nconst attachEntry = (parent: ElementNode, entry: PlacedChild, index: number, sibling: GObject.Object | null): void => {\n    applyWrite(() => {\n        runAttach(parent, entry, index, sibling);\n    });\n};\n\nconst detachInfo = (entry: PlacedChild, context: unknown): DetachInfo => ({\n    slot: entry.slot,\n    adopted: entry.adopted,\n    props: entry.node.props,\n    context,\n});\n\nconst runDetach = (parent: ElementNode, entry: PlacedChild): void => {\n    const behavior = entry.behavior;\n\n    if (behavior === null) {\n        writeSlot(parent, entry, null);\n\n        return;\n    }\n\n    behavior.detach?.(parent.object, entry.object, detachInfo(entry, getOrCreateContext(parent, behavior)));\n};\n\nconst detachEntry = (parent: ElementNode, entry: PlacedChild): void => {\n    applyWrite(() => {\n        runDetach(parent, entry);\n    });\n};\n\nconst rebuild = (parent: ElementNode, entries: PlacedChild[]): void => {\n    for (const entry of entries) {\n        detachEntry(parent, entry);\n    }\n\n    for (const [index, entry] of entries.entries()) {\n        entry.behavior = null;\n        attachEntry(parent, entry, index, siblingAt(entries, index));\n    }\n};\n\nconst getPosition = (entries: PlacedChild[], before: PlaceableNode | null): number =>\n    indexBeforeOrEnd(entries, before, (entry, target) => entry.node === target);\n\nconst placeNew = (parent: ElementNode, entry: PlacedChild, entries: PlacedChild[], index: number): void => {\n    attachEntry(parent, entry, index, siblingAt(entries, index));\n    const isInsertedBeforeEnd = index < entries.length - 1;\n    const isCannotReorderInPlace = entry.behavior !== null && entry.behavior.reorder === undefined;\n\n    if (isInsertedBeforeEnd && isCannotReorderInPlace) {\n        rebuild(parent, entries);\n    }\n};\n\nconst moveEntry = (parent: ElementNode, entry: PlacedChild, entries: PlacedChild[], index: number): void => {\n    const behavior = entry.behavior;\n    const reorder = behavior?.reorder;\n\n    if (behavior === null || reorder === undefined) {\n        rebuild(parent, entries);\n\n        return;\n    }\n\n    const context = getOrCreateContext(parent, behavior);\n    const claim = reorder(parent.object, entry.object, placeInfo(entry, index, siblingAt(entries, index), context));\n    adoptedFrom(parent, entry, behavior, claim);\n    applyLazyProps(entry);\n};\n\nconst resolveEntry = (\n    entries: PlacedChild[],\n    existing: number,\n    slot: string,\n    node: PlaceableNode,\n): PlacedChild | null => {\n    if (existing >= 0) {\n        return entries[existing] ?? null;\n    }\n\n    return createEntry(slot, node);\n};\n\nconst placeChild = (\n    parent: ElementNode,\n    slot: string,\n    node: PlaceableNode,\n    before: PlaceableNode | null,\n): void => {\n    const entries = getOrInsert(parent.placements, slot, () => []);\n    const existing = entries.findIndex((entry) => entry.node === node);\n    const entry = resolveEntry(entries, existing, slot, node);\n\n    if (entry === null) {\n        return;\n    }\n\n    const isMove = existing !== -1;\n\n    if (isMove) {\n        entries.splice(existing, 1);\n    }\n\n    const index = getPosition(entries, before);\n    entries.splice(index, 0, entry);\n\n    if (isMove) {\n        moveEntry(parent, entry, entries, index);\n    } else {\n        placeNew(parent, entry, entries, index);\n    }\n\n    markFlush(parent);\n};\n\nconst unplaceChild = (parent: ElementNode, slot: string, node: PlaceableNode): void => {\n    const entries = parent.placements.get(slot);\n\n    if (entries === undefined) {\n        return;\n    }\n\n    const index = entries.findIndex((entry) => entry.node === node);\n\n    if (index === -1) {\n        return;\n    }\n\n    const [entry] = entries.splice(index, 1);\n\n    if (entry !== undefined) {\n        detachEntry(parent, entry);\n    }\n\n    markFlush(parent);\n};\n\nexport { placeChild, unplaceChild };\n"]}

package/dist/reconciler/registry.d.ts

@@ -3,87 +3,103 @@ import type * as GObject from "@gtkx/gi/gobject";
 type Props = Record<string, unknown>;
 /** Per-child values a slot hook receives while placing or moving one child. */
 type PlaceInfo = {
+    /** Name of the slot being filled: `children`, or the prop the child was nested under. */
     slot: string;
+    /** Position of the child among the slot's children. */
     index: number;
+    /** Object of the preceding child in the slot, or null when the child comes first. */
     sibling: GObject.Object | null;
+    /** Object adopted for this child by an earlier attach, or null before it has one. */
     adopted: GObject.Object | null;
+    /** Props of the child element. */
     props: Props;
+    /** Value `initialize` returned for this behavior on the parent. */
     context: unknown;
 };
 /** Per-child values a slot hook receives while removing one child. */
 type DetachInfo = {
+    /** Name of the slot the child is leaving. */
     slot: string;
+    /** Object the container adopted for this child, or null when it adopted none. */
     adopted: GObject.Object | null;
+    /** Props of the child element. */
     props: Props;
+    /** Value `initialize` returned for this behavior on the parent. */
     context: unknown;
 };
 /**
- * Customizes how one element type places children and applies props. Every hook receives the
- * GObject instance and a private per-node `context` built once by `createContext`. A slot hook
- * claims a child by returning a non-`undefined` value; that value, or `resolve`, is the object
- * the container adopts for the child. `update` returns the prop names it consumed so those props
- * are not also set as plain GObject properties. `create` builds the GObject for types whose
- * constructor does more than set properties, and is consulted for its own type only, never
- * inherited by subtypes.
+ * Customizes how one element type places children and applies props. Hooks other than `create` receive the
+ * GObject instance; `update` and `flush` also take the private per-node context `initialize` built, and
+ * `attach`, `reorder` and `detach` read it off their info object. Subtypes inherit a type's behaviors,
+ * except for `create`, which is consulted only for the type it is registered on.
  */
 type ElementBehavior<T extends GObject.Object = GObject.Object> = {
+    /** Builds the GObject from its construct props, for types whose constructor does more than set properties. */
     create?: (props: Props) => GObject.Object;
-    createContext?: (object: T) => unknown;
+    /** Builds the private per-node context the other hooks receive, once per node. */
+    initialize?: (object: T) => unknown;
+    /** Places a child, claiming it by returning anything other than `undefined`. */
     attach?: (object: T, child: GObject.Object, info: PlaceInfo) => unknown;
+    /** Moves an already-attached child; without it, the whole slot is detached and re-attached in order. */
     reorder?: (object: T, child: GObject.Object, info: PlaceInfo) => unknown;
+    /** Removes a child this behavior attached. */
     detach?: (object: T, child: GObject.Object, info: DetachInfo) => void;
+    /** Returns the object the container adopts for a child, overriding whatever `attach` returned. */
     resolve?: (object: T, child: GObject.Object) => GObject.Object | null;
+    /** Applies changed props and returns the names it consumed, which are then not set as GObject properties. */
     update?: (object: T, prev: Props, next: Props, context: unknown) => Iterable<string> | undefined;
+    /** Runs after the commit that touched the node, once every child has been placed. */
     flush?: (object: T, context: unknown) => void;
-    mount?: (object: T, context: unknown) => void;
-    unmount?: (object: T, context: unknown) => void;
+    /** Props to withhold from the constructor, leaving them for a later hook to apply. */
     deferred?: string[];
+    /**
+     * Props the behavior can only apply while the element is being built, because the library exposes no
+     * counterpart to whatever applied them. Changing one after it has been applied throws instead of
+     * silently applying the new value on top of the old.
+     */
+    constructOnly?: string[];
 };
 /** A named export in a module, referenced as plain data (the module is never imported at runtime). */
 type ModuleExport = {
+    /** Specifier the export is imported from. */
     module: string;
+    /** Identifier the module exports it under. */
     export: string;
 };
 /**
- * Per-element configuration keyed by GLib type name: whether the element is lazy (its GObject is
- * created by its parent container, as pages and layout children are), the custom behaviors bound to
- * its type, an optional component that wraps the generated element, the base props interface its
- * generated props extend, and the GObject properties to leave out of the generated props (those a
- * behavior already writes from children, such as the `child` and `content` properties). `component`,
- * `props` and `omitProps` are inert at runtime; they are read only by codegen.
+ * How one GLib type is rendered. `component`, `props` and `omittedProps` are inert at runtime; they are
+ * read only by codegen.
  */
 type ElementConfig<T extends GObject.Object = GObject.Object> = {
-    lazy?: boolean;
+    /** The element has no GObject of its own; its parent container creates one, as it does for pages. */
+    isLazy?: boolean;
+    /** Behaviors bound to the type, consulted in registration order and inherited by its subtypes. */
     behaviors?: ElementBehavior<T>[];
+    /** Component that wraps the generated element. */
     component?: ModuleExport;
+    /** Base props interface the generated props extend. */
     props?: ModuleExport;
-    omitProps?: string[];
+    /** GObject properties to leave out of the generated props, such as those a behavior writes from children. */
+    omittedProps?: string[];
 };
 /**
  * Every registered element config, keyed by GLib type name. Adwaita entries appear once `@gtkx/react/adw`
  * is loaded.
  */
 declare const ELEMENTS: Record<string, ElementConfig>;
-/** Props a behavior applies after construction; the constructor is never given them. */
 declare const deferredProps: (behavior: ElementBehavior) => string[];
 /**
  * Merges maps of {@link ElementConfig} keyed by GLib type name into one, concatenating each type's
- * behaviors and omitted props in the order the maps are given (an earlier map's behaviors come first)
- * and taking the last lazy flag, component, and props seen. Use it to combine an app's element config
- * with its behaviors.
+ * behaviors and omitted props in the order the maps are given (an earlier map's behaviors come first),
+ * taking the last component and props seen, and marking a type lazy if any map does. Use it to combine
+ * an app's element config with its behaviors.
  */
 declare const mergeElementConfigs: (...maps: Record<string, ElementConfig<never>>[]) => Record<string, ElementConfig>;
-/**
- * Registers a map of {@link ElementConfig} keyed by GLib type name, merging each entry into the
- * registry. Behaviors are appended by default (the framework's built-ins register this way); pass
- * `{ prepend: true }` for an app's own configuration so its behaviors are consulted before the
- * built-ins for the same slot, letting it override them regardless of registration order.
- */
 declare const registerElements: (map: Record<string, ElementConfig<never>>, options?: {
-    prepend?: boolean;
+    isPrepended?: boolean;
 }) => void;
 /**
- * Identity helper that types the module named by the `elements` entry of `gtkx.config.ts`, enabling
+ * Identity helper that types the module named by `elements.behaviors` in `gtkx.config.ts`, enabling
  * editor autocompletion and type checking. Key each entry by GLib type name and write each behavior
  * with {@link defineBehavior} so its hooks receive the concrete GObject class.
  */
@@ -99,9 +115,7 @@ declare const defineElements: (elements: Record<string, ElementConfig<never>>) =
  * ```
  */
 declare const defineBehavior: <T extends GObject.Object>(hooks: ElementBehavior<T>) => ElementBehavior<never>;
-/** Spreads one config across many GLib type names. */
 declare const forTypes: (types: string[], config: ElementConfig<never>) => Record<string, ElementConfig<never>>;
-/** References a base props interface exported from `@gtkx/react/internal`. */
 declare const internal: (name: string) => ModuleExport;
 export { ELEMENTS, deferredProps, mergeElementConfigs, registerElements, defineElements, defineBehavior, forTypes, internal, type Props, type PlaceInfo, type DetachInfo, type ElementBehavior, type ModuleExport, type ElementConfig, };
 //# sourceMappingURL=registry.d.ts.map

package/dist/reconciler/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/reconciler/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAEjD,wFAAwF;AACxF,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErC,+EAA+E;AAC/E,KAAK,SAAS,GAAG;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,sEAAsE;AACtE,KAAK,UAAU,GAAG;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;;;;;;GAQG;AACH,KAAK,eAAe,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI;IAC9D,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,MAAM,CAAC;IAC1C,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC;IACvC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC;IACxE,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC;IACzE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACtE,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IACtE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,KAAK,QAAQ,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACjG,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9C,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9C,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,sGAAsG;AACtG,KAAK,YAAY,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD;;;;;;;GAOG;AACH,KAAK,aAAa,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI;IAC5D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IACjC,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAM,CAAC;AAEnD,wFAAwF;AACxF,QAAA,MAAM,aAAa,GAAI,UAAU,eAAe,KAAG,MAAM,EAA6B,CAAC;AA2BvF;;;;;GAKG;AACH,QAAA,MAAM,mBAAmB,GAAI,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,KAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAU1G,CAAC;AAEF;;;;;GAKG;AACH,QAAA,MAAM,gBAAgB,GAClB,KAAK,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,EACzC,UAAS;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,KACpC,IAIF,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,cAAc,GAAI,UAAU,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,KAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAChG,CAAC;AAEb;;;;;;;;;GASG;AACH,QAAA,MAAM,cAAc,GAAI,CAAC,SAAS,OAAO,CAAC,MAAM,EAAE,OAAO,eAAe,CAAC,CAAC,CAAC,KAAG,eAAe,CAAC,KAAK,CAAU,CAAC;AAE9G,sDAAsD;AACtD,QAAA,MAAM,QAAQ,GAAI,OAAO,MAAM,EAAE,EAAE,QAAQ,aAAa,CAAC,KAAK,CAAC,KAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAC1C,CAAC;AAE5D,8EAA8E;AAC9E,QAAA,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAG,YAAkE,CAAC;AAEpG,OAAO,EACH,QAAQ,EACR,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,KAAK,KAAK,EACV,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,aAAa,GACrB,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/reconciler/registry.ts"],"names":[],"mappings":"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"}

package/dist/reconciler/registry.js

@@ -3,31 +3,30 @@
  * is loaded.
  */
 const ELEMENTS = {};
-/** Props a behavior applies after construction; the constructor is never given them. */
 const deferredProps = (behavior) => behavior.deferred ?? [];
 const mergeBehaviors = (base, added, isPrepended) => {
     const baseBehaviors = base.behaviors ?? [];
     return isPrepended ? [...added, ...baseBehaviors] : [...baseBehaviors, ...added];
 };
 const mergeConfigEntry = (base, added, isPrepended = false) => {
-    const { behaviors, lazy, omitProps, ...rest } = added;
+    const { behaviors, isLazy, omittedProps, ...rest } = added;
     const entry = { ...base, ...rest };
     if (behaviors !== undefined) {
         entry.behaviors = mergeBehaviors(base, behaviors, isPrepended);
     }
-    if (omitProps !== undefined) {
-        entry.omitProps = [...(base.omitProps ?? []), ...omitProps];
+    if (omittedProps !== undefined) {
+        entry.omittedProps = [...(base.omittedProps ?? []), ...omittedProps];
     }
-    if (lazy === true) {
-        entry.lazy = true;
+    if (isLazy === true) {
+        entry.isLazy = true;
     }
     return entry;
 };
 /**
  * Merges maps of {@link ElementConfig} keyed by GLib type name into one, concatenating each type's
- * behaviors and omitted props in the order the maps are given (an earlier map's behaviors come first)
- * and taking the last lazy flag, component, and props seen. Use it to combine an app's element config
- * with its behaviors.
+ * behaviors and omitted props in the order the maps are given (an earlier map's behaviors come first),
+ * taking the last component and props seen, and marking a type lazy if any map does. Use it to combine
+ * an app's element config with its behaviors.
  */
 const mergeElementConfigs = (...maps) => {
     const merged = {};
@@ -38,19 +37,13 @@ const mergeElementConfigs = (...maps) => {
     }
     return merged;
 };
-/**
- * Registers a map of {@link ElementConfig} keyed by GLib type name, merging each entry into the
- * registry. Behaviors are appended by default (the framework's built-ins register this way); pass
- * `{ prepend: true }` for an app's own configuration so its behaviors are consulted before the
- * built-ins for the same slot, letting it override them regardless of registration order.
- */
 const registerElements = (map, options = {}) => {
     for (const [type, config] of Object.entries(map)) {
-        ELEMENTS[type] = mergeConfigEntry(ELEMENTS[type] ?? {}, config, options.prepend === true);
+        ELEMENTS[type] = mergeConfigEntry(ELEMENTS[type] ?? {}, config, options.isPrepended === true);
     }
 };
 /**
- * Identity helper that types the module named by the `elements` entry of `gtkx.config.ts`, enabling
+ * Identity helper that types the module named by `elements.behaviors` in `gtkx.config.ts`, enabling
  * editor autocompletion and type checking. Key each entry by GLib type name and write each behavior
  * with {@link defineBehavior} so its hooks receive the concrete GObject class.
  */
@@ -66,9 +59,7 @@ const defineElements = (elements) => elements;
  * ```
  */
 const defineBehavior = (hooks) => hooks;
-/** Spreads one config across many GLib type names. */
 const forTypes = (types, config) => Object.fromEntries(types.map((type) => [type, config]));
-/** References a base props interface exported from `@gtkx/react/internal`. */
 const internal = (name) => ({ module: "@gtkx/react/internal", export: name });
 export { ELEMENTS, deferredProps, mergeElementConfigs, registerElements, defineElements, defineBehavior, forTypes, internal, };
 //# sourceMappingURL=registry.js.map

package/dist/reconciler/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/reconciler/registry.ts"],"names":[],"mappings":"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","sourcesContent":["import type * as GObject from \"@gtkx/gi/gobject\";\n\n/** The props of a host element or node, as React passes them through the reconciler. */\ntype Props = Record<string, unknown>;\n\n/** Per-child values a slot hook receives while placing or moving one child. */\ntype PlaceInfo = {\n    slot: string;\n    index: number;\n    sibling: GObject.Object | null;\n    adopted: GObject.Object | null;\n    props: Props;\n    context: unknown;\n};\n\n/** Per-child values a slot hook receives while removing one child. */\ntype DetachInfo = {\n    slot: string;\n    adopted: GObject.Object | null;\n    props: Props;\n    context: unknown;\n};\n\n/**\n * Customizes how one element type places children and applies props. Every hook receives the\n * GObject instance and a private per-node `context` built once by `createContext`. A slot hook\n * claims a child by returning a non-`undefined` value; that value, or `resolve`, is the object\n * the container adopts for the child. `update` returns the prop names it consumed so those props\n * are not also set as plain GObject properties. `create` builds the GObject for types whose\n * constructor does more than set properties, and is consulted for its own type only, never\n * inherited by subtypes.\n */\ntype ElementBehavior<T extends GObject.Object = GObject.Object> = {\n    create?: (props: Props) => GObject.Object;\n    createContext?: (object: T) => unknown;\n    attach?: (object: T, child: GObject.Object, info: PlaceInfo) => unknown;\n    reorder?: (object: T, child: GObject.Object, info: PlaceInfo) => unknown;\n    detach?: (object: T, child: GObject.Object, info: DetachInfo) => void;\n    resolve?: (object: T, child: GObject.Object) => GObject.Object | null;\n    update?: (object: T, prev: Props, next: Props, context: unknown) => Iterable<string> | undefined;\n    flush?: (object: T, context: unknown) => void;\n    mount?: (object: T, context: unknown) => void;\n    unmount?: (object: T, context: unknown) => void;\n    deferred?: string[];\n};\n\n/** A named export in a module, referenced as plain data (the module is never imported at runtime). */\ntype ModuleExport = { module: string; export: string };\n\n/**\n * Per-element configuration keyed by GLib type name: whether the element is lazy (its GObject is\n * created by its parent container, as pages and layout children are), the custom behaviors bound to\n * its type, an optional component that wraps the generated element, the base props interface its\n * generated props extend, and the GObject properties to leave out of the generated props (those a\n * behavior already writes from children, such as the `child` and `content` properties). `component`,\n * `props` and `omitProps` are inert at runtime; they are read only by codegen.\n */\ntype ElementConfig<T extends GObject.Object = GObject.Object> = {\n    lazy?: boolean;\n    behaviors?: ElementBehavior<T>[];\n    component?: ModuleExport;\n    props?: ModuleExport;\n    omitProps?: string[];\n};\n\n/**\n * Every registered element config, keyed by GLib type name. Adwaita entries appear once `@gtkx/react/adw`\n * is loaded.\n */\nconst ELEMENTS: Record<string, ElementConfig> = {};\n\n/** Props a behavior applies after construction; the constructor is never given them. */\nconst deferredProps = (behavior: ElementBehavior): string[] => behavior.deferred ?? [];\n\nconst mergeBehaviors = (base: ElementConfig, added: ElementBehavior[], isPrepended: boolean): ElementBehavior[] => {\n    const baseBehaviors = base.behaviors ?? [];\n\n    return isPrepended ? [...added, ...baseBehaviors] : [...baseBehaviors, ...added];\n};\n\nconst mergeConfigEntry = (base: ElementConfig, added: ElementConfig<never>, isPrepended = false): ElementConfig => {\n    const { behaviors, lazy, omitProps, ...rest } = added;\n    const entry: ElementConfig = { ...base, ...rest };\n\n    if (behaviors !== undefined) {\n        entry.behaviors = mergeBehaviors(base, behaviors as ElementBehavior[], isPrepended);\n    }\n\n    if (omitProps !== undefined) {\n        entry.omitProps = [...(base.omitProps ?? []), ...omitProps];\n    }\n\n    if (lazy === true) {\n        entry.lazy = true;\n    }\n\n    return entry;\n};\n\n/**\n * Merges maps of {@link ElementConfig} keyed by GLib type name into one, concatenating each type's\n * behaviors and omitted props in the order the maps are given (an earlier map's behaviors come first)\n * and taking the last lazy flag, component, and props seen. Use it to combine an app's element config\n * with its behaviors.\n */\nconst mergeElementConfigs = (...maps: Record<string, ElementConfig<never>>[]): Record<string, ElementConfig> => {\n    const merged: Record<string, ElementConfig> = {};\n\n    for (const map of maps) {\n        for (const [type, config] of Object.entries(map)) {\n            merged[type] = mergeConfigEntry(merged[type] ?? {}, config);\n        }\n    }\n\n    return merged;\n};\n\n/**\n * Registers a map of {@link ElementConfig} keyed by GLib type name, merging each entry into the\n * registry. Behaviors are appended by default (the framework's built-ins register this way); pass\n * `{ prepend: true }` for an app's own configuration so its behaviors are consulted before the\n * built-ins for the same slot, letting it override them regardless of registration order.\n */\nconst registerElements = (\n    map: Record<string, ElementConfig<never>>,\n    options: { prepend?: boolean } = {},\n): void => {\n    for (const [type, config] of Object.entries(map)) {\n        ELEMENTS[type] = mergeConfigEntry(ELEMENTS[type] ?? {}, config, options.prepend === true);\n    }\n};\n\n/**\n * Identity helper that types the module named by the `elements` entry of `gtkx.config.ts`, enabling\n * editor autocompletion and type checking. Key each entry by GLib type name and write each behavior\n * with {@link defineBehavior} so its hooks receive the concrete GObject class.\n */\nconst defineElements = (elements: Record<string, ElementConfig<never>>): Record<string, ElementConfig<never>> =>\n    elements;\n\n/**\n * Types one behavior against the GObject class it applies to, so every hook's object parameter is\n * inferred rather than annotated by hand. Pass the class as the type argument.\n *\n * ```ts\n * defineElements({\n *     GtkFrame: { behaviors: [defineBehavior<Gtk.Frame>({ attach: (frame, child) => frame.setChild(child) })] },\n * });\n * ```\n */\nconst defineBehavior = <T extends GObject.Object>(hooks: ElementBehavior<T>): ElementBehavior<never> => hooks;\n\n/** Spreads one config across many GLib type names. */\nconst forTypes = (types: string[], config: ElementConfig<never>): Record<string, ElementConfig<never>> =>\n    Object.fromEntries(types.map((type) => [type, config]));\n\n/** References a base props interface exported from `@gtkx/react/internal`. */\nconst internal = (name: string): ModuleExport => ({ module: \"@gtkx/react/internal\", export: name });\n\nexport {\n    ELEMENTS,\n    deferredProps,\n    mergeElementConfigs,\n    registerElements,\n    defineElements,\n    defineBehavior,\n    forTypes,\n    internal,\n    type Props,\n    type PlaceInfo,\n    type DetachInfo,\n    type ElementBehavior,\n    type ModuleExport,\n    type ElementConfig,\n};\n"]}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/reconciler/registry.ts"],"names":[],"mappings":"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","sourcesContent":["import type * as GObject from \"@gtkx/gi/gobject\";\n\n/** The props of a host element or node, as React passes them through the reconciler. */\ntype Props = Record<string, unknown>;\n\n/** Per-child values a slot hook receives while placing or moving one child. */\ntype PlaceInfo = {\n    /** Name of the slot being filled: `children`, or the prop the child was nested under. */\n    slot: string;\n    /** Position of the child among the slot's children. */\n    index: number;\n    /** Object of the preceding child in the slot, or null when the child comes first. */\n    sibling: GObject.Object | null;\n    /** Object adopted for this child by an earlier attach, or null before it has one. */\n    adopted: GObject.Object | null;\n    /** Props of the child element. */\n    props: Props;\n    /** Value `initialize` returned for this behavior on the parent. */\n    context: unknown;\n};\n\n/** Per-child values a slot hook receives while removing one child. */\ntype DetachInfo = {\n    /** Name of the slot the child is leaving. */\n    slot: string;\n    /** Object the container adopted for this child, or null when it adopted none. */\n    adopted: GObject.Object | null;\n    /** Props of the child element. */\n    props: Props;\n    /** Value `initialize` returned for this behavior on the parent. */\n    context: unknown;\n};\n\n/**\n * Customizes how one element type places children and applies props. Hooks other than `create` receive the\n * GObject instance; `update` and `flush` also take the private per-node context `initialize` built, and\n * `attach`, `reorder` and `detach` read it off their info object. Subtypes inherit a type's behaviors,\n * except for `create`, which is consulted only for the type it is registered on.\n */\ntype ElementBehavior<T extends GObject.Object = GObject.Object> = {\n    /** Builds the GObject from its construct props, for types whose constructor does more than set properties. */\n    create?: (props: Props) => GObject.Object;\n    /** Builds the private per-node context the other hooks receive, once per node. */\n    initialize?: (object: T) => unknown;\n    /** Places a child, claiming it by returning anything other than `undefined`. */\n    attach?: (object: T, child: GObject.Object, info: PlaceInfo) => unknown;\n    /** Moves an already-attached child; without it, the whole slot is detached and re-attached in order. */\n    reorder?: (object: T, child: GObject.Object, info: PlaceInfo) => unknown;\n    /** Removes a child this behavior attached. */\n    detach?: (object: T, child: GObject.Object, info: DetachInfo) => void;\n    /** Returns the object the container adopts for a child, overriding whatever `attach` returned. */\n    resolve?: (object: T, child: GObject.Object) => GObject.Object | null;\n    /** Applies changed props and returns the names it consumed, which are then not set as GObject properties. */\n    update?: (object: T, prev: Props, next: Props, context: unknown) => Iterable<string> | undefined;\n    /** Runs after the commit that touched the node, once every child has been placed. */\n    flush?: (object: T, context: unknown) => void;\n    /** Props to withhold from the constructor, leaving them for a later hook to apply. */\n    deferred?: string[];\n    /**\n     * Props the behavior can only apply while the element is being built, because the library exposes no\n     * counterpart to whatever applied them. Changing one after it has been applied throws instead of\n     * silently applying the new value on top of the old.\n     */\n    constructOnly?: string[];\n};\n\n/** A named export in a module, referenced as plain data (the module is never imported at runtime). */\ntype ModuleExport = {\n    /** Specifier the export is imported from. */\n    module: string;\n    /** Identifier the module exports it under. */\n    export: string;\n};\n\n/**\n * How one GLib type is rendered. `component`, `props` and `omittedProps` are inert at runtime; they are\n * read only by codegen.\n */\ntype ElementConfig<T extends GObject.Object = GObject.Object> = {\n    /** The element has no GObject of its own; its parent container creates one, as it does for pages. */\n    isLazy?: boolean;\n    /** Behaviors bound to the type, consulted in registration order and inherited by its subtypes. */\n    behaviors?: ElementBehavior<T>[];\n    /** Component that wraps the generated element. */\n    component?: ModuleExport;\n    /** Base props interface the generated props extend. */\n    props?: ModuleExport;\n    /** GObject properties to leave out of the generated props, such as those a behavior writes from children. */\n    omittedProps?: string[];\n};\n\n/**\n * Every registered element config, keyed by GLib type name. Adwaita entries appear once `@gtkx/react/adw`\n * is loaded.\n */\nconst ELEMENTS: Record<string, ElementConfig> = {};\n\nconst deferredProps = (behavior: ElementBehavior): string[] => behavior.deferred ?? [];\n\nconst mergeBehaviors = (base: ElementConfig, added: ElementBehavior[], isPrepended: boolean): ElementBehavior[] => {\n    const baseBehaviors = base.behaviors ?? [];\n\n    return isPrepended ? [...added, ...baseBehaviors] : [...baseBehaviors, ...added];\n};\n\nconst mergeConfigEntry = (base: ElementConfig, added: ElementConfig<never>, isPrepended = false): ElementConfig => {\n    const { behaviors, isLazy, omittedProps, ...rest } = added;\n    const entry: ElementConfig = { ...base, ...rest };\n\n    if (behaviors !== undefined) {\n        entry.behaviors = mergeBehaviors(base, behaviors as ElementBehavior[], isPrepended);\n    }\n\n    if (omittedProps !== undefined) {\n        entry.omittedProps = [...(base.omittedProps ?? []), ...omittedProps];\n    }\n\n    if (isLazy === true) {\n        entry.isLazy = true;\n    }\n\n    return entry;\n};\n\n/**\n * Merges maps of {@link ElementConfig} keyed by GLib type name into one, concatenating each type's\n * behaviors and omitted props in the order the maps are given (an earlier map's behaviors come first),\n * taking the last component and props seen, and marking a type lazy if any map does. Use it to combine\n * an app's element config with its behaviors.\n */\nconst mergeElementConfigs = (...maps: Record<string, ElementConfig<never>>[]): Record<string, ElementConfig> => {\n    const merged: Record<string, ElementConfig> = {};\n\n    for (const map of maps) {\n        for (const [type, config] of Object.entries(map)) {\n            merged[type] = mergeConfigEntry(merged[type] ?? {}, config);\n        }\n    }\n\n    return merged;\n};\n\nconst registerElements = (\n    map: Record<string, ElementConfig<never>>,\n    options: { isPrepended?: boolean } = {},\n): void => {\n    for (const [type, config] of Object.entries(map)) {\n        ELEMENTS[type] = mergeConfigEntry(ELEMENTS[type] ?? {}, config, options.isPrepended === true);\n    }\n};\n\n/**\n * Identity helper that types the module named by `elements.behaviors` in `gtkx.config.ts`, enabling\n * editor autocompletion and type checking. Key each entry by GLib type name and write each behavior\n * with {@link defineBehavior} so its hooks receive the concrete GObject class.\n */\nconst defineElements = (elements: Record<string, ElementConfig<never>>): Record<string, ElementConfig<never>> =>\n    elements;\n\n/**\n * Types one behavior against the GObject class it applies to, so every hook's object parameter is\n * inferred rather than annotated by hand. Pass the class as the type argument.\n *\n * ```ts\n * defineElements({\n *     GtkFrame: { behaviors: [defineBehavior<Gtk.Frame>({ attach: (frame, child) => frame.setChild(child) })] },\n * });\n * ```\n */\nconst defineBehavior = <T extends GObject.Object>(hooks: ElementBehavior<T>): ElementBehavior<never> => hooks;\n\nconst forTypes = (types: string[], config: ElementConfig<never>): Record<string, ElementConfig<never>> =>\n    Object.fromEntries(types.map((type) => [type, config]));\n\nconst internal = (name: string): ModuleExport => ({ module: \"@gtkx/react/internal\", export: name });\n\nexport {\n    ELEMENTS,\n    deferredProps,\n    mergeElementConfigs,\n    registerElements,\n    defineElements,\n    defineBehavior,\n    forTypes,\n    internal,\n    type Props,\n    type PlaceInfo,\n    type DetachInfo,\n    type ElementBehavior,\n    type ModuleExport,\n    type ElementConfig,\n};\n"]}

package/dist/reconciler/root-element.d.ts

@@ -1,11 +1,11 @@
 /** The type of the shared {@link rootElement} marker used as a default top-level container. */
 type RootElement = {
+    /** Marks a container as the top level rather than a GObject; `isRootElement` tests for it. */
     [ROOT_ELEMENT_BRAND]: true;
 };
 declare const ROOT_ELEMENT_BRAND: unique symbol;
 /** A shared marker value used as the default top-level container for rendering and portals. */
 declare const rootElement: RootElement;
-/** Reports whether an arbitrary value is a {@link rootElement} marker. */
 declare const isRootElement: (value: unknown) => value is RootElement;
 export { rootElement, isRootElement, type RootElement };
 //# sourceMappingURL=root-element.d.ts.map

package/dist/reconciler/root-element.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"root-element.d.ts","sourceRoot":"","sources":["../../src/reconciler/root-element.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,KAAK,WAAW,GAAG;IAAE,CAAC,kBAAkB,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAElD,QAAA,MAAM,kBAAkB,EAAE,OAAO,MAAwC,CAAC;AAC1E,+FAA+F;AAC/F,QAAA,MAAM,WAAW,EAAE,WAA4C,CAAC;AAEhE,0EAA0E;AAC1E,QAAA,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,WAC0C,CAAC;AAE5F,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,CAAC"}
+{"version":3,"file":"root-element.d.ts","sourceRoot":"","sources":["../../src/reconciler/root-element.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,KAAK,WAAW,GAAG;IACf,8FAA8F;IAC9F,CAAC,kBAAkB,CAAC,EAAE,IAAI,CAAC;CAC9B,CAAC;AAEF,QAAA,MAAM,kBAAkB,EAAE,OAAO,MAAwC,CAAC;AAC1E,+FAA+F;AAC/F,QAAA,MAAM,WAAW,EAAE,WAA4C,CAAC;AAEhE,QAAA,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,WAC0C,CAAC;AAE5F,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,CAAC"}

package/dist/reconciler/root-element.js

@@ -1,7 +1,6 @@
 const ROOT_ELEMENT_BRAND = Symbol.for("gtkx:root-element");
 /** A shared marker value used as the default top-level container for rendering and portals. */
 const rootElement = { [ROOT_ELEMENT_BRAND]: true };
-/** Reports whether an arbitrary value is a {@link rootElement} marker. */
 const isRootElement = (value) => typeof value === "object" && value !== null && Object.hasOwn(value, ROOT_ELEMENT_BRAND);
 export { rootElement, isRootElement };
 //# sourceMappingURL=root-element.js.map

package/dist/reconciler/root-element.js.map

@@ -1 +1 @@
-{"version":3,"file":"root-element.js","sourceRoot":"","sources":["../../src/reconciler/root-element.ts"],"names":[],"mappings":"AAGA,MAAM,kBAAkB,GAAkB,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AAC1E,+FAA+F;AAC/F,MAAM,WAAW,GAAgB,EAAE,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,CAAC;AAEhE,0EAA0E;AAC1E,MAAM,aAAa,GAAG,CAAC,KAAc,EAAwB,EAAE,CAC3D,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC;AAE5F,OAAO,EAAE,WAAW,EAAE,aAAa,EAAoB,CAAC","sourcesContent":["/** The type of the shared {@link rootElement} marker used as a default top-level container. */\ntype RootElement = { [ROOT_ELEMENT_BRAND]: true };\n\nconst ROOT_ELEMENT_BRAND: unique symbol = Symbol.for(\"gtkx:root-element\");\n/** A shared marker value used as the default top-level container for rendering and portals. */\nconst rootElement: RootElement = { [ROOT_ELEMENT_BRAND]: true };\n\n/** Reports whether an arbitrary value is a {@link rootElement} marker. */\nconst isRootElement = (value: unknown): value is RootElement =>\n    typeof value === \"object\" && value !== null && Object.hasOwn(value, ROOT_ELEMENT_BRAND);\n\nexport { rootElement, isRootElement, type RootElement };\n"]}
+{"version":3,"file":"root-element.js","sourceRoot":"","sources":["../../src/reconciler/root-element.ts"],"names":[],"mappings":"AAMA,MAAM,kBAAkB,GAAkB,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AAC1E,+FAA+F;AAC/F,MAAM,WAAW,GAAgB,EAAE,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,CAAC;AAEhE,MAAM,aAAa,GAAG,CAAC,KAAc,EAAwB,EAAE,CAC3D,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC;AAE5F,OAAO,EAAE,WAAW,EAAE,aAAa,EAAoB,CAAC","sourcesContent":["/** The type of the shared {@link rootElement} marker used as a default top-level container. */\ntype RootElement = {\n    /** Marks a container as the top level rather than a GObject; `isRootElement` tests for it. */\n    [ROOT_ELEMENT_BRAND]: true;\n};\n\nconst ROOT_ELEMENT_BRAND: unique symbol = Symbol.for(\"gtkx:root-element\");\n/** A shared marker value used as the default top-level container for rendering and portals. */\nconst rootElement: RootElement = { [ROOT_ELEMENT_BRAND]: true };\n\nconst isRootElement = (value: unknown): value is RootElement =>\n    typeof value === \"object\" && value !== null && Object.hasOwn(value, ROOT_ELEMENT_BRAND);\n\nexport { rootElement, isRootElement, type RootElement };\n"]}

package/dist/reconciler/root.d.ts

@@ -9,36 +9,28 @@ type RootErrorCallbacks = {
 type ReconcilerRootOptions = RootErrorCallbacks & {
     containerInfo: Container;
 };
-/** A root that mounts an element tree into an explicit container and reports render errors. */
+/** A render root whose updates and teardown the caller drives, with error handling left to it. */
 type ReconcilerRoot = {
+    /** Mounts an element tree into the container, or updates the tree already mounted there. */
     update: (element: ReactNode) => void;
+    /** Hands the root to `teardown`, then stops {@link quit} from unmounting the container. */
     unmount: (teardown: (root: ReconcilerRoot) => Promise<void>) => Promise<void>;
 };
 /** The object {@link createRoot} returns: it renders an element tree into a container and can tear it down. */
 type Root = {
+    /** Mounts an element tree into the container, or updates the tree already mounted there. */
     render: (element: ReactNode) => void;
+    /** Unmounts the rendered tree and runs its effect cleanups. */
     unmount: () => void;
 };
 type ErrorHandler = (error: unknown) => void;
-/**
- * Installs a process-wide handler for errors thrown while rendering or applying an update.
- *
- * @param handler The handler to install.
- * @returns The previously installed handler, or null.
- */
 declare const setReconcilerErrorHandler: (handler: ErrorHandler) => ErrorHandler | null;
-/**
- * Creates a root that mounts an element tree into a container, routing render errors to the supplied callbacks.
- *
- * @param options The container to render into and the error callbacks to route failures to.
- * @returns A {@link ReconcilerRoot}.
- */
 declare const createReconcilerRoot: (options: ReconcilerRootOptions) => ReconcilerRoot;
 /**
- * Creates a render root for a GTKX application.
+ * Creates a render root for a GTKX application. Uncaught render errors are rethrown and errors caught by an
+ * error boundary are logged.
  *
- * @param container The top-level container to render into; defaults to the shared {@link rootElement}.
- * @returns A {@link Root} exposing render and unmount.
+ * @param container The GObject to render into; defaults to the shared {@link rootElement}, which holds no object.
  */
 declare const createRoot: (container?: Container) => Root;
 /** Unmounts every active render root and stops the originating signal from propagating further. */
@@ -46,10 +38,7 @@ declare const quit: () => typeof Gdk.EVENT_STOP;
 /**
  * Renders children into a container other than the surrounding tree.
  *
- * @param children The element tree to render.
- * @param container The GObject, application, or {@link rootElement} to render into.
- * @param key An optional stable key.
- * @returns A React portal.
+ * @param container The GObject to render into, or {@link rootElement} to render at the top level.
  */
 declare const createPortal: (children: ReactNode, container: Container, key?: string) => ReactPortal;
 export { setReconcilerErrorHandler, createReconcilerRoot, createRoot, quit, createPortal, type ReconcilerRoot, type Root, };

package/dist/reconciler/root.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../../src/reconciler/root.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAC/D,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAGpC,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,kBAAkB,CAAC;AAK9D,KAAK,kBAAkB,GAAG;IACtB,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAC5D,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAC1D,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;CAClE,CAAC;AAEF,KAAK,qBAAqB,GAAG,kBAAkB,GAAG;IAAE,aAAa,EAAE,SAAS,CAAA;CAAE,CAAC;AAE/E,+FAA+F;AAC/F,KAAK,cAAc,GAAG;IAClB,MAAM,EAAE,CAAC,OAAO,EAAE,SAAS,KAAK,IAAI,CAAC;IACrC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjF,CAAC;AAEF,+GAA+G;AAC/G,KAAK,IAAI,GAAG;IACR,MAAM,EAAE,CAAC,OAAO,EAAE,SAAS,KAAK,IAAI,CAAC;IACrC,OAAO,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AAEF,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AAsB7C;;;;;GAKG;AACH,QAAA,MAAM,yBAAyB,GAAI,SAAS,YAAY,KAAG,YAAY,GAAG,IAAqC,CAAC;AA0ChH;;;;;GAKG;AACH,QAAA,MAAM,oBAAoB,GAAI,SAAS,qBAAqB,KAAG,cAc9D,CAAC;AAEF;;;;;GAKG;AACH,QAAA,MAAM,UAAU,GAAI,YAAW,SAAuB,KAAG,IAcxD,CAAC;AAEF,mGAAmG;AACnG,QAAA,MAAM,IAAI,QAAO,OAAO,GAAG,CAAC,UAM3B,CAAC;AAEF;;;;;;;GAOG;AACH,QAAA,MAAM,YAAY,GAAI,UAAU,SAAS,EAAE,WAAW,SAAS,EAAE,MAAM,MAAM,KAAG,WACa,CAAC;AAE9F,OAAO,EACH,yBAAyB,EACzB,oBAAoB,EACpB,UAAU,EACV,IAAI,EACJ,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,IAAI,GACZ,CAAC"}
+{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../../src/reconciler/root.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAC/D,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAIpC,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,kBAAkB,CAAC;AAK9D,KAAK,kBAAkB,GAAG;IACtB,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAC5D,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAC1D,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;CAClE,CAAC;AAEF,KAAK,qBAAqB,GAAG,kBAAkB,GAAG;IAAE,aAAa,EAAE,SAAS,CAAA;CAAE,CAAC;AAE/E,kGAAkG;AAClG,KAAK,cAAc,GAAG;IAClB,4FAA4F;IAC5F,MAAM,EAAE,CAAC,OAAO,EAAE,SAAS,KAAK,IAAI,CAAC;IACrC,2FAA2F;IAC3F,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjF,CAAC;AAEF,+GAA+G;AAC/G,KAAK,IAAI,GAAG;IACR,4FAA4F;IAC5F,MAAM,EAAE,CAAC,OAAO,EAAE,SAAS,KAAK,IAAI,CAAC;IACrC,+DAA+D;IAC/D,OAAO,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AAEF,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AAsB7C,QAAA,MAAM,yBAAyB,GAAI,SAAS,YAAY,KAAG,YAAY,GAAG,IAAqC,CAAC;AA4ChH,QAAA,MAAM,oBAAoB,GAAI,SAAS,qBAAqB,KAAG,cAc9D,CAAC;AAEF;;;;;GAKG;AACH,QAAA,MAAM,UAAU,GAAI,YAAW,SAAuB,KAAG,IAcxD,CAAC;AAEF,mGAAmG;AACnG,QAAA,MAAM,IAAI,QAAO,OAAO,GAAG,CAAC,UAM3B,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,YAAY,GAAI,UAAU,SAAS,EAAE,WAAW,SAAS,EAAE,MAAM,MAAM,KAAG,WACa,CAAC;AAE9F,OAAO,EACH,yBAAyB,EACzB,oBAAoB,EACpB,UAAU,EACV,IAAI,EACJ,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,IAAI,GACZ,CAAC"}

package/dist/reconciler/root.js

@@ -1,6 +1,7 @@
 import * as Gdk from "@gtkx/gi/gdk";
 import { createLogger } from "@gtkx/utils";
 import { ConcurrentRoot } from "react-reconciler/constants.js";
+import { injectIntoDevTools } from "./devtools.js";
 import { reconciler } from "./host-config.js";
 import { rootElement } from "./root-element.js";
 const log = createLogger("react");
@@ -17,12 +18,6 @@ function createErrorHandlerSlot() {
         },
     };
 }
-/**
- * Installs a process-wide handler for errors thrown while rendering or applying an update.
- *
- * @param handler The handler to install.
- * @returns The previously installed handler, or null.
- */
 const setReconcilerErrorHandler = (handler) => errorHandlerSlot.set(handler);
 const rethrowUncaughtRenderError = (error) => {
     throw error;
@@ -31,6 +26,7 @@ const logCaughtRenderError = (error) => {
     log.error("caught render error", error);
 };
 const openContainer = (containerInfo, callbacks) => {
+    injectIntoDevTools(reconciler);
     const container = reconciler.createContainer(containerInfo, ConcurrentRoot, null, false, null, "", (error, info) => {
         errorHandlerSlot.get()?.(error);
         callbacks.onUncaughtError?.(error, info);
@@ -47,12 +43,6 @@ const unmountContainer = (container) => {
     reconciler.updateContainer(null, container, null, null);
     activeRoots.delete(container);
 };
-/**
- * Creates a root that mounts an element tree into a container, routing render errors to the supplied callbacks.
- *
- * @param options The container to render into and the error callbacks to route failures to.
- * @returns A {@link ReconcilerRoot}.
- */
 const createReconcilerRoot = (options) => {
     const container = openContainer(options.containerInfo, options);
     const root = {
@@ -67,10 +57,10 @@ const createReconcilerRoot = (options) => {
     return root;
 };
 /**
- * Creates a render root for a GTKX application.
+ * Creates a render root for a GTKX application. Uncaught render errors are rethrown and errors caught by an
+ * error boundary are logged.
  *
- * @param container The top-level container to render into; defaults to the shared {@link rootElement}.
- * @returns A {@link Root} exposing render and unmount.
+ * @param container The GObject to render into; defaults to the shared {@link rootElement}, which holds no object.
  */
 const createRoot = (container = rootElement) => {
     const opaque = openContainer(container, {
@@ -96,10 +86,7 @@ const quit = () => {
 /**
  * Renders children into a container other than the surrounding tree.
  *
- * @param children The element tree to render.
- * @param container The GObject, application, or {@link rootElement} to render into.
- * @param key An optional stable key.
- * @returns A React portal.
+ * @param container The GObject to render into, or {@link rootElement} to render at the top level.
  */
 const createPortal = (children, container, key) => reconciler.createPortal(children, container, null, key ?? null);
 export { setReconcilerErrorHandler, createReconcilerRoot, createRoot, quit, createPortal, };

package/dist/reconciler/root.js.map

@@ -1 +1 @@
-{"version":3,"file":"root.js","sourceRoot":"","sources":["../../src/reconciler/root.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ErrorInfo, ReactNode, ReactPortal } from \"react\";\nimport * as Gdk from \"@gtkx/gi/gdk\";\nimport { createLogger, type Logger } from \"@gtkx/utils\";\nimport { ConcurrentRoot } from \"react-reconciler/constants.js\";\nimport { type Container, reconciler } from \"./host-config.js\";\nimport { rootElement } from \"./root-element.js\";\n\ntype OpaqueRoot = { [opaqueRoot]: true };\n\ntype RootErrorCallbacks = {\n    onUncaughtError?: (error: unknown, info: ErrorInfo) => void;\n    onCaughtError?: (error: unknown, info: ErrorInfo) => void;\n    onRecoverableError?: (error: unknown, info: ErrorInfo) => void;\n};\n\ntype ReconcilerRootOptions = RootErrorCallbacks & { containerInfo: Container };\n\n/** A root that mounts an element tree into an explicit container and reports render errors. */\ntype ReconcilerRoot = {\n    update: (element: ReactNode) => void;\n    unmount: (teardown: (root: ReconcilerRoot) => Promise<void>) => Promise<void>;\n};\n\n/** The object {@link createRoot} returns: it renders an element tree into a container and can tear it down. */\ntype Root = {\n    render: (element: ReactNode) => void;\n    unmount: () => void;\n};\n\ntype ErrorHandler = (error: unknown) => void;\ntype ErrorHandlerSlot = { get: () => ErrorHandler | null; set: (handler: ErrorHandler) => ErrorHandler | null };\n\ndeclare const opaqueRoot: unique symbol;\nconst log: Logger = createLogger(\"react\");\nconst activeRoots: Set<OpaqueRoot> = new Set();\nconst errorHandlerSlot = createErrorHandlerSlot();\n\nfunction createErrorHandlerSlot(): ErrorHandlerSlot {\n    let current: ErrorHandler | null = null;\n\n    return {\n        get: () => current,\n        set: (handler) => {\n            const previous = current;\n            current = handler;\n\n            return previous;\n        },\n    };\n}\n\n/**\n * Installs a process-wide handler for errors thrown while rendering or applying an update.\n *\n * @param handler The handler to install.\n * @returns The previously installed handler, or null.\n */\nconst setReconcilerErrorHandler = (handler: ErrorHandler): ErrorHandler | null => errorHandlerSlot.set(handler);\n\nconst rethrowUncaughtRenderError = (error: unknown): never => {\n    throw error;\n};\n\nconst logCaughtRenderError = (error: unknown): void => {\n    log.error(\"caught render error\", error);\n};\n\nconst openContainer = (containerInfo: Container, callbacks: RootErrorCallbacks): OpaqueRoot => {\n    const container = reconciler.createContainer(\n        containerInfo,\n        ConcurrentRoot,\n        null,\n        false,\n        null,\n        \"\",\n        (error, info) => {\n            errorHandlerSlot.get()?.(error);\n            callbacks.onUncaughtError?.(error, info);\n        },\n        (error, info) => {\n            errorHandlerSlot.get()?.(error);\n            callbacks.onCaughtError?.(error, info);\n        },\n        (error, info) => {\n            callbacks.onRecoverableError?.(error, info);\n        },\n        (): void => undefined,\n    ) as OpaqueRoot;\n\n    activeRoots.add(container);\n\n    return container;\n};\n\nconst unmountContainer = (container: OpaqueRoot): void => {\n    reconciler.updateContainer(null, container, null, null);\n    activeRoots.delete(container);\n};\n\n/**\n * Creates a root that mounts an element tree into a container, routing render errors to the supplied callbacks.\n *\n * @param options The container to render into and the error callbacks to route failures to.\n * @returns A {@link ReconcilerRoot}.\n */\nconst createReconcilerRoot = (options: ReconcilerRootOptions): ReconcilerRoot => {\n    const container = openContainer(options.containerInfo, options);\n\n    const root: ReconcilerRoot = {\n        update: (element) => {\n            reconciler.updateContainer(element, container, null, null);\n        },\n        unmount: async (teardown) => {\n            await teardown(root);\n            activeRoots.delete(container);\n        },\n    };\n\n    return root;\n};\n\n/**\n * Creates a render root for a GTKX application.\n *\n * @param container The top-level container to render into; defaults to the shared {@link rootElement}.\n * @returns A {@link Root} exposing render and unmount.\n */\nconst createRoot = (container: Container = rootElement): Root => {\n    const opaque = openContainer(container, {\n        onUncaughtError: rethrowUncaughtRenderError,\n        onCaughtError: logCaughtRenderError,\n    });\n\n    return {\n        render: (element) => {\n            reconciler.updateContainer(element, opaque, null, null);\n        },\n        unmount: () => {\n            unmountContainer(opaque);\n        },\n    };\n};\n\n/** Unmounts every active render root and stops the originating signal from propagating further. */\nconst quit = (): typeof Gdk.EVENT_STOP => {\n    for (const container of activeRoots) {\n        unmountContainer(container);\n    }\n\n    return Gdk.EVENT_STOP;\n};\n\n/**\n * Renders children into a container other than the surrounding tree.\n *\n * @param children The element tree to render.\n * @param container The GObject, application, or {@link rootElement} to render into.\n * @param key An optional stable key.\n * @returns A React portal.\n */\nconst createPortal = (children: ReactNode, container: Container, key?: string): ReactPortal =>\n    reconciler.createPortal(children, container, null, key ?? null) as unknown as ReactPortal;\n\nexport {\n    setReconcilerErrorHandler,\n    createReconcilerRoot,\n    createRoot,\n    quit,\n    createPortal,\n    type ReconcilerRoot,\n    type Root,\n};\n"]}
+{"version":3,"file":"root.js","sourceRoot":"","sources":["../../src/reconciler/root.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ErrorInfo, ReactNode, ReactPortal } from \"react\";\nimport * as Gdk from \"@gtkx/gi/gdk\";\nimport { createLogger, type Logger } from \"@gtkx/utils\";\nimport { ConcurrentRoot } from \"react-reconciler/constants.js\";\nimport { injectIntoDevTools } from \"./devtools.js\";\nimport { type Container, reconciler } from \"./host-config.js\";\nimport { rootElement } from \"./root-element.js\";\n\ntype OpaqueRoot = { [opaqueRoot]: true };\n\ntype RootErrorCallbacks = {\n    onUncaughtError?: (error: unknown, info: ErrorInfo) => void;\n    onCaughtError?: (error: unknown, info: ErrorInfo) => void;\n    onRecoverableError?: (error: unknown, info: ErrorInfo) => void;\n};\n\ntype ReconcilerRootOptions = RootErrorCallbacks & { containerInfo: Container };\n\n/** A render root whose updates and teardown the caller drives, with error handling left to it. */\ntype ReconcilerRoot = {\n    /** Mounts an element tree into the container, or updates the tree already mounted there. */\n    update: (element: ReactNode) => void;\n    /** Hands the root to `teardown`, then stops {@link quit} from unmounting the container. */\n    unmount: (teardown: (root: ReconcilerRoot) => Promise<void>) => Promise<void>;\n};\n\n/** The object {@link createRoot} returns: it renders an element tree into a container and can tear it down. */\ntype Root = {\n    /** Mounts an element tree into the container, or updates the tree already mounted there. */\n    render: (element: ReactNode) => void;\n    /** Unmounts the rendered tree and runs its effect cleanups. */\n    unmount: () => void;\n};\n\ntype ErrorHandler = (error: unknown) => void;\ntype ErrorHandlerSlot = { get: () => ErrorHandler | null; set: (handler: ErrorHandler) => ErrorHandler | null };\n\ndeclare const opaqueRoot: unique symbol;\nconst log: Logger = createLogger(\"react\");\nconst activeRoots: Set<OpaqueRoot> = new Set();\nconst errorHandlerSlot = createErrorHandlerSlot();\n\nfunction createErrorHandlerSlot(): ErrorHandlerSlot {\n    let current: ErrorHandler | null = null;\n\n    return {\n        get: () => current,\n        set: (handler) => {\n            const previous = current;\n            current = handler;\n\n            return previous;\n        },\n    };\n}\n\nconst setReconcilerErrorHandler = (handler: ErrorHandler): ErrorHandler | null => errorHandlerSlot.set(handler);\n\nconst rethrowUncaughtRenderError = (error: unknown): never => {\n    throw error;\n};\n\nconst logCaughtRenderError = (error: unknown): void => {\n    log.error(\"caught render error\", error);\n};\n\nconst openContainer = (containerInfo: Container, callbacks: RootErrorCallbacks): OpaqueRoot => {\n    injectIntoDevTools(reconciler);\n\n    const container = reconciler.createContainer(\n        containerInfo,\n        ConcurrentRoot,\n        null,\n        false,\n        null,\n        \"\",\n        (error, info) => {\n            errorHandlerSlot.get()?.(error);\n            callbacks.onUncaughtError?.(error, info);\n        },\n        (error, info) => {\n            errorHandlerSlot.get()?.(error);\n            callbacks.onCaughtError?.(error, info);\n        },\n        (error, info) => {\n            callbacks.onRecoverableError?.(error, info);\n        },\n        (): void => undefined,\n    ) as OpaqueRoot;\n\n    activeRoots.add(container);\n\n    return container;\n};\n\nconst unmountContainer = (container: OpaqueRoot): void => {\n    reconciler.updateContainer(null, container, null, null);\n    activeRoots.delete(container);\n};\n\nconst createReconcilerRoot = (options: ReconcilerRootOptions): ReconcilerRoot => {\n    const container = openContainer(options.containerInfo, options);\n\n    const root: ReconcilerRoot = {\n        update: (element) => {\n            reconciler.updateContainer(element, container, null, null);\n        },\n        unmount: async (teardown) => {\n            await teardown(root);\n            activeRoots.delete(container);\n        },\n    };\n\n    return root;\n};\n\n/**\n * Creates a render root for a GTKX application. Uncaught render errors are rethrown and errors caught by an\n * error boundary are logged.\n *\n * @param container The GObject to render into; defaults to the shared {@link rootElement}, which holds no object.\n */\nconst createRoot = (container: Container = rootElement): Root => {\n    const opaque = openContainer(container, {\n        onUncaughtError: rethrowUncaughtRenderError,\n        onCaughtError: logCaughtRenderError,\n    });\n\n    return {\n        render: (element) => {\n            reconciler.updateContainer(element, opaque, null, null);\n        },\n        unmount: () => {\n            unmountContainer(opaque);\n        },\n    };\n};\n\n/** Unmounts every active render root and stops the originating signal from propagating further. */\nconst quit = (): typeof Gdk.EVENT_STOP => {\n    for (const container of activeRoots) {\n        unmountContainer(container);\n    }\n\n    return Gdk.EVENT_STOP;\n};\n\n/**\n * Renders children into a container other than the surrounding tree.\n *\n * @param container The GObject to render into, or {@link rootElement} to render at the top level.\n */\nconst createPortal = (children: ReactNode, container: Container, key?: string): ReactPortal =>\n    reconciler.createPortal(children, container, null, key ?? null) as unknown as ReactPortal;\n\nexport {\n    setReconcilerErrorHandler,\n    createReconcilerRoot,\n    createRoot,\n    quit,\n    createPortal,\n    type ReconcilerRoot,\n    type Root,\n};\n"]}

package/dist/reconciler/signals.d.ts

@@ -1,9 +1,8 @@
 import { type SignalHandler } from "@gtkx/runtime";
 import type { SignalTarget } from "./node.js";
-declare const isApplyingWrite: () => boolean;
 declare const applyWrite: <T>(write: () => T) => T;
 declare const connectHandler: (target: SignalTarget, prop: string, signal: string, handler: SignalHandler) => void;
 declare const disconnectHandler: (target: SignalTarget, prop: string) => void;
 declare const disconnectAllHandlers: (target: SignalTarget) => void;
-export { applyWrite, isApplyingWrite, connectHandler, disconnectHandler, disconnectAllHandlers, };
+export { applyWrite, connectHandler, disconnectHandler, disconnectAllHandlers, };
 //# sourceMappingURL=signals.d.ts.map

package/dist/reconciler/signals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../src/reconciler/signals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAEtE,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,WAAW,CAAC;AAM7D,QAAA,MAAM,eAAe,QAAO,OAA+B,CAAC;AAE5D,QAAA,MAAM,UAAU,GAAI,CAAC,EAAE,OAAO,MAAM,CAAC,KAAG,CAQvC,CAAC;AA2BF,QAAA,MAAM,cAAc,GAAI,QAAQ,YAAY,EAAE,MAAM,MAAM,EAAE,QAAQ,MAAM,EAAE,SAAS,aAAa,KAAG,IAmBpG,CAAC;AAEF,QAAA,MAAM,iBAAiB,GAAI,QAAQ,YAAY,EAAE,MAAM,MAAM,KAAG,IAS/D,CAAC;AAEF,QAAA,MAAM,qBAAqB,GAAI,QAAQ,YAAY,KAAG,IAMrD,CAAC;AAEF,OAAO,EACH,UAAU,EACV,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,qBAAqB,GACxB,CAAC"}
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../src/reconciler/signals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAEtE,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,WAAW,CAAC;AAQ7D,QAAA,MAAM,UAAU,GAAI,CAAC,EAAE,OAAO,MAAM,CAAC,KAAG,CAQvC,CAAC;AA2BF,QAAA,MAAM,cAAc,GAAI,QAAQ,YAAY,EAAE,MAAM,MAAM,EAAE,QAAQ,MAAM,EAAE,SAAS,aAAa,KAAG,IAmBpG,CAAC;AAEF,QAAA,MAAM,iBAAiB,GAAI,QAAQ,YAAY,EAAE,MAAM,MAAM,KAAG,IAS/D,CAAC;AAEF,QAAA,MAAM,qBAAqB,GAAI,QAAQ,YAAY,KAAG,IAMrD,CAAC;AAEF,OAAO,EACH,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,qBAAqB,GACxB,CAAC"}