@gtkx/components 0.21.0 → 1.0.0-rc.1

package/dist/column-view-column.d.ts

@@ -1,17 +1,27 @@
+import type * as Gtk from "@gtkx/gi/gtk";
 import { type GtkColumnViewColumnProps } from "@gtkx/jsx/gtk";
 import { type ReactNode } from "react";
-import type { ColumnViewColumnProps } from "./types.js";
-/**
- * Props for the {@link ColumnViewColumn} component: the raw
- * `GtkColumnViewColumn` element surface (minus its imperative `factory` and
- * `sorter` properties) with its cell wiring replaced by the declarative
- * {@link ColumnViewColumnProps} API.
- */
-export type ColumnViewColumnComponentProps<T = unknown> = Omit<GtkColumnViewColumnProps, "factory" | "sorter"> & ColumnViewColumnProps<T>;
-/**
- * A single column of a {@link ColumnView}, rendering each row's cell through
- * the declarative `renderCell` callback and optionally attaching a header
- * context menu.
- */
-export declare const ColumnViewColumn: <T = unknown>(props: ColumnViewColumnComponentProps<T>) => ReactNode;
+import { type TreeRenderContext } from "./cell.js";
+import type { RenderItemProps } from "./types.js";
+import type { ItemResolver } from "./utils/item-resolver.js";
+export type ColumnDefDeclarativeProps<T = unknown> = {
+    title: string;
+    expand?: boolean | undefined;
+    resizable?: boolean | undefined;
+    fixedWidth?: number | undefined;
+    id: string;
+    sortable?: boolean | undefined;
+    visible?: boolean | undefined;
+    renderCell: (props: RenderItemProps<T>) => ReactNode;
+    headerMenu?: ReactNode;
+};
+export type ColumnDef<T = unknown> = Omit<GtkColumnViewColumnProps, "factory" | "sorter"> & ColumnDefDeclarativeProps<T>;
+type ColumnViewColumnProps<T = unknown> = ColumnDef<T> & {
+    resolver: ItemResolver<unknown, unknown>;
+    tree: TreeRenderContext;
+    estimatedItemHeight?: number | undefined;
+    onInstance: (id: string, column: Gtk.ColumnViewColumn | null) => void;
+};
+export declare const ColumnViewColumn: <T = unknown>(props: ColumnViewColumnProps<T>) => ReactNode;
+export {};
 //# sourceMappingURL=column-view-column.d.ts.map

package/dist/column-view-column.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"column-view-column.d.ts","sourceRoot":"","sources":["../src/column-view-column.tsx"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EAAiB,KAAK,SAAS,EAAqC,MAAM,OAAO,CAAC;AAMzF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAOxD;;;;;GAKG;AACH,MAAM,MAAM,8BAA8B,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,wBAAwB,EAAE,SAAS,GAAG,QAAQ,CAAC,GAC1G,qBAAqB,CAAC,CAAC,CAAC,CAAC;AAE7B;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,GAAG,OAAO,EAAE,OAAO,8BAA8B,CAAC,CAAC,CAAC,KAAG,SA2CxF,CAAC"}
+{"version":3,"file":"column-view-column.d.ts","sourceRoot":"","sources":["../src/column-view-column.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AACzC,OAAO,EAAuB,KAAK,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAEnF,OAAO,EAAE,KAAK,SAAS,EAAqC,MAAM,OAAO,CAAC;AAC1E,OAAO,EAAmD,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGpG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI7D,MAAM,MAAM,yBAAyB,CAAC,CAAC,GAAG,OAAO,IAAI;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,UAAU,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;IACrD,UAAU,CAAC,EAAE,SAAS,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,SAAS,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,wBAAwB,EAAE,SAAS,GAAG,QAAQ,CAAC,GACrF,yBAAyB,CAAC,CAAC,CAAC,CAAC;AAEjC,KAAK,qBAAqB,CAAC,CAAC,GAAG,OAAO,IAAI,SAAS,CAAC,CAAC,CAAC,GAAG;IACrD,QAAQ,EAAE,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzC,IAAI,EAAE,iBAAiB,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,gBAAgB,GAAG,IAAI,KAAK,IAAI,CAAC;CACzE,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,CAAC,GAAG,OAAO,SAAS,qBAAqB,CAAC,CAAC,CAAC,KAAG,SA+C/E,CAAC"}

package/dist/column-view-column.js

@@ -1,51 +1,30 @@
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { GtkColumnViewColumn } from "@gtkx/jsx/gtk";
-import { createElement, useLayoutEffect, useRef, useState } from "react";
-import { useColumnViewContext } from "./contexts/column-view-context.js";
+import { useMergeRefs } from "@gtkx/react/internal";
+import { useLayoutEffect, useRef, useState } from "react";
+import { CellRenderHost, itemRenderer } from "./cell.js";
+import { makeFactoryInstaller, useCellContainers } from "./hooks/use-cell-containers.js";
 import { useHeaderMenu } from "./hooks/use-header-menu.js";
-import { useRealizedSlots } from "./hooks/use-realized-slots.js";
-import { ListPortalHost } from "./list-portal-host.js";
-const factoryBinding = {
-    install: (column, factory) => column.setFactory(factory),
-    uninstall: (column) => column.setFactory(null),
-};
-/**
- * A single column of a {@link ColumnView}, rendering each row's cell through
- * the declarative `renderCell` callback and optionally attaching a header
- * context menu.
- */
+const factoryInstaller = makeFactoryInstaller((column, factory) => column.setFactory(factory));
 export const ColumnViewColumn = (props) => {
-    const { id, title, expand, resizable, fixedWidth, visible, sortable, renderCell, headerMenu } = props;
-    const context = useColumnViewContext();
+    const { id, title, sortable, renderCell, headerMenu, resolver, tree, estimatedItemHeight, onInstance, ref, ...intrinsicProps } = props;
     const [column, setColumn] = useState(null);
-    const captureColumn = useRef((value) => {
-        setColumn(value);
-    }).current;
-    const { store } = useRealizedSlots({
-        target: column,
-        binding: factoryBinding,
+    const captureColumn = useMergeRefs(ref, setColumn);
+    const store = useCellContainers({
+        object: column,
+        installer: factoryInstaller,
+        estimatedHeight: estimatedItemHeight,
     });
-    const registerRef = useRef(context.register);
-    registerRef.current = context.register;
-    const unregisterRef = useRef(context.unregister);
-    unregisterRef.current = context.unregister;
+    const onInstanceRef = useRef(onInstance);
+    onInstanceRef.current = onInstance;
     useLayoutEffect(() => {
         if (column === null)
             return;
-        registerRef.current({ id, column, sortable: sortable ?? false });
-        return () => unregisterRef.current(id);
-    }, [column, id, sortable]);
+        onInstanceRef.current(id, column);
+        return () => onInstanceRef.current(id, null);
+    }, [column, id]);
     const headerMenuPortal = useHeaderMenu(column, headerMenu);
-    const slotRenderer = (value, _treeRow, isHeader) => isHeader ? null : renderCell(value);
-    const intrinsicProps = { id, title, ref: captureColumn };
-    if (expand !== undefined)
-        intrinsicProps["expand"] = expand;
-    if (resizable !== undefined)
-        intrinsicProps["resizable"] = resizable;
-    if (fixedWidth !== undefined)
-        intrinsicProps["fixedWidth"] = fixedWidth;
-    if (visible !== undefined)
-        intrinsicProps["visible"] = visible;
-    return (_jsxs(_Fragment, { children: [createElement(GtkColumnViewColumn, intrinsicProps), _jsx(ListPortalHost, { store: store, resolver: context.resolver, render: slotRenderer }), headerMenuPortal] }));
+    const cellRenderer = itemRenderer((cellProps) => renderCell({ ...cellProps, item: cellProps.item }), tree);
+    return (_jsxs(_Fragment, { children: [_jsx(GtkColumnViewColumn, { ...intrinsicProps, id: id, title: title, ref: captureColumn }), _jsx(CellRenderHost, { store: store, resolver: resolver, render: cellRenderer }), headerMenuPortal] }));
 };
 //# sourceMappingURL=column-view-column.js.map

package/dist/column-view-column.js.map

@@ -1 +1 @@
-{"version":3,"file":"column-view-column.js","sourceRoot":"","sources":["../src/column-view-column.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"column-view-column.js","sourceRoot":"","sources":["../src/column-view-column.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,mBAAmB,EAAiC,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAkB,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC1E,OAAO,EAAqB,cAAc,EAAE,YAAY,EAA0B,MAAM,WAAW,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAI3D,MAAM,gBAAgB,GAAG,oBAAoB,CAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;AAwBrH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAc,KAA+B,EAAa,EAAE;IACxF,MAAM,EACF,EAAE,EACF,KAAK,EACL,QAAQ,EACR,UAAU,EACV,UAAU,EACV,QAAQ,EACR,IAAI,EACJ,mBAAmB,EACnB,UAAU,EACV,GAAG,EACH,GAAG,cAAc,EACpB,GAAG,KAA8D,CAAC;IACnE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAA8B,IAAI,CAAC,CAAC;IAExE,MAAM,aAAa,GAAG,YAAY,CAAuB,GAAG,EAAE,SAAS,CAAC,CAAC;IAEzE,MAAM,KAAK,GAAG,iBAAiB,CAAuB;QAClD,MAAM,EAAE,MAAM;QACd,SAAS,EAAE,gBAAgB;QAC3B,eAAe,EAAE,mBAAmB;KACvC,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IACzC,aAAa,CAAC,OAAO,GAAG,UAAU,CAAC;IAEnC,eAAe,CAAC,GAAG,EAAE;QACjB,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO;QAC5B,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAClC,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;IAEjB,MAAM,gBAAgB,GAAG,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAE3D,MAAM,YAAY,GAAmC,YAAY,CAC7D,CAAC,SAAS,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,GAAG,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,IAAS,EAAE,CAAC,EACtE,IAAI,CACP,CAAC;IAEF,OAAO,CACH,8BACI,KAAC,mBAAmB,OAAK,cAAc,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,GAAI,EACrF,KAAC,cAAc,IAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAI,EACzE,gBAAgB,IAClB,CACN,CAAC;AACN,CAAC,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { GtkColumnViewColumn, type GtkColumnViewColumnProps } from \"@gtkx/jsx/gtk\";\nimport { useMergeRefs } from \"@gtkx/react/internal\";\nimport { type ReactNode, useLayoutEffect, useRef, useState } from \"react\";\nimport { type CellRenderer, CellRenderHost, itemRenderer, type TreeRenderContext } from \"./cell.js\";\nimport { makeFactoryInstaller, useCellContainers } from \"./hooks/use-cell-containers.js\";\nimport { useHeaderMenu } from \"./hooks/use-header-menu.js\";\nimport type { RenderItemProps } from \"./types.js\";\nimport type { ItemResolver } from \"./utils/item-resolver.js\";\n\nconst factoryInstaller = makeFactoryInstaller<Gtk.ColumnViewColumn>((column, factory) => column.setFactory(factory));\n\nexport type ColumnDefDeclarativeProps<T = unknown> = {\n    title: string;\n    expand?: boolean | undefined;\n    resizable?: boolean | undefined;\n    fixedWidth?: number | undefined;\n    id: string;\n    sortable?: boolean | undefined;\n    visible?: boolean | undefined;\n    renderCell: (props: RenderItemProps<T>) => ReactNode;\n    headerMenu?: ReactNode;\n};\n\nexport type ColumnDef<T = unknown> = Omit<GtkColumnViewColumnProps, \"factory\" | \"sorter\"> &\n    ColumnDefDeclarativeProps<T>;\n\ntype ColumnViewColumnProps<T = unknown> = ColumnDef<T> & {\n    resolver: ItemResolver<unknown, unknown>;\n    tree: TreeRenderContext;\n    estimatedItemHeight?: number | undefined;\n    onInstance: (id: string, column: Gtk.ColumnViewColumn | null) => void;\n};\n\nexport const ColumnViewColumn = <T = unknown>(props: ColumnViewColumnProps<T>): ReactNode => {\n    const {\n        id,\n        title,\n        sortable,\n        renderCell,\n        headerMenu,\n        resolver,\n        tree,\n        estimatedItemHeight,\n        onInstance,\n        ref,\n        ...intrinsicProps\n    } = props as ColumnViewColumnProps<T> & { [key: string]: unknown };\n    const [column, setColumn] = useState<Gtk.ColumnViewColumn | null>(null);\n\n    const captureColumn = useMergeRefs<Gtk.ColumnViewColumn>(ref, setColumn);\n\n    const store = useCellContainers<Gtk.ColumnViewColumn>({\n        object: column,\n        installer: factoryInstaller,\n        estimatedHeight: estimatedItemHeight,\n    });\n\n    const onInstanceRef = useRef(onInstance);\n    onInstanceRef.current = onInstance;\n\n    useLayoutEffect(() => {\n        if (column === null) return;\n        onInstanceRef.current(id, column);\n        return () => onInstanceRef.current(id, null);\n    }, [column, id]);\n\n    const headerMenuPortal = useHeaderMenu(column, headerMenu);\n\n    const cellRenderer: CellRenderer<unknown, unknown> = itemRenderer<unknown, unknown>(\n        (cellProps) => renderCell({ ...cellProps, item: cellProps.item as T }),\n        tree,\n    );\n\n    return (\n        <>\n            <GtkColumnViewColumn {...intrinsicProps} id={id} title={title} ref={captureColumn} />\n            <CellRenderHost store={store} resolver={resolver} render={cellRenderer} />\n            {headerMenuPortal}\n        </>\n    );\n};\n"]}

package/dist/column-view.d.ts

@@ -1,18 +1,32 @@
+import type * as Gtk from "@gtkx/gi/gtk";
 import { type GtkColumnViewProps } from "@gtkx/jsx/gtk";
 import { type ReactNode } from "react";
-import type { ColumnViewProps } from "./types.js";
+import { type ColumnDef } from "./column-view-column.js";
+import type { CollectionItemSizeProps, ControlledExpansionProps, ControlledSelectionProps, ItemNode, SectionNode } from "./types.js";
+export type { ColumnDef, ColumnDefDeclarativeProps } from "./column-view-column.js";
+export type ColumnViewSortProps = {
+    sortColumn?: string | null | undefined;
+    sortOrder?: Gtk.SortType | null | undefined;
+    onSortChanged?: ((column: string | null, order: Gtk.SortType) => void) | null | undefined;
+};
+export type ColumnViewDeclarativeProps<T = unknown, S = unknown> = ColumnViewSortProps & Omit<CollectionItemSizeProps, "estimatedItemWidth"> & ControlledSelectionProps & ControlledExpansionProps & {
+    items?: ItemNode<T>[] | undefined;
+    sections?: SectionNode<S, T>[] | undefined;
+    renderHeader?: ((info: {
+        section: S;
+    }) => ReactNode) | null | undefined;
+    columns: ColumnDef<T>[];
+};
 /**
- * Props for the {@link ColumnView} component: the raw `GtkColumnView` element
- * surface (minus its imperative `columns` property) with its model/sort wiring
- * replaced by the declarative {@link ColumnViewProps} API. Columns are declared
- * as {@link ColumnViewColumn} children.
+ * Props for {@link ColumnView}. Combines the underlying Gtk.ColumnView props with
+ * declarative collection props: flat items or grouped sections, controlled selection
+ * and expansion, sorting (sortColumn, sortOrder, onSortChanged), an optional section
+ * header renderer, and the columns to render.
  */
-export type ColumnViewComponentProps<T = unknown, S = unknown> = Omit<GtkColumnViewProps, "columns" | keyof ColumnViewProps<T, S>> & ColumnViewProps<T, S>;
+export type ColumnViewProps<T = unknown, S = unknown> = Omit<GtkColumnViewProps, "columns" | "model" | "headerFactory" | keyof ColumnViewDeclarativeProps<T, S>> & ColumnViewDeclarativeProps<T, S>;
 /**
- * A `GtkColumnView` driven by a declarative `items` model with optional
- * controlled selection, controlled sorting, and section headers. Columns are
- * declared as {@link ColumnViewColumn} children. Supplying an external `model`
- * switches to the uncontrolled form.
+ * Renders a Gtk.ColumnView: a multi-column, scrollable list backed by a collection
+ * model. Columns are declared through the columns prop, each a {@link ColumnDef}.
  */
-export declare const ColumnView: <T = unknown, S = unknown>(props: ColumnViewComponentProps<T, S>) => ReactNode;
+export declare const ColumnView: <T = unknown, S = unknown>(props: ColumnViewProps<T, S>) => ReactNode;
 //# sourceMappingURL=column-view.d.ts.map

package/dist/column-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"column-view.d.ts","sourceRoot":"","sources":["../src/column-view.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEvE,OAAO,EAAiB,KAAK,SAAS,EAAoD,MAAM,OAAO,CAAC;AAaxG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAmClD;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI,IAAI,CACjE,kBAAkB,EAClB,SAAS,GAAG,MAAM,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAC1C,GACG,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAoF1B;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,OAAO,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,SAqD5F,CAAC"}
+{"version":3,"file":"column-view.d.ts","sourceRoot":"","sources":["../src/column-view.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AACzC,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,KAAK,SAAS,EAA4C,MAAM,OAAO,CAAC;AAEjF,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,yBAAyB,CAAC;AAI3E,OAAO,KAAK,EACR,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,QAAQ,EACR,WAAW,EACd,MAAM,YAAY,CAAC;AAIpB,YAAY,EAAE,SAAS,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAMpF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACvC,SAAS,CAAC,EAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5C,aAAa,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;CAC7F,CAAC;AAEF,MAAM,MAAM,0BAA0B,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI,mBAAmB,GAClF,IAAI,CAAC,uBAAuB,EAAE,oBAAoB,CAAC,GACnD,wBAAwB,GACxB,wBAAwB,GAAG;IACvB,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC;IAC3C,YAAY,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC,CAAA;KAAE,KAAK,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACxE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;CAC3B,CAAC;AAEN;;;;;GAKG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI,IAAI,CACxD,kBAAkB,EAClB,SAAS,GAAG,OAAO,GAAG,eAAe,GAAG,MAAM,0BAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,CACjF,GACG,0BAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AA4FrC;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,SAAS,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,SA2CnF,CAAC"}

package/dist/column-view.js

@@ -1,108 +1,78 @@
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { GtkColumnView } from "@gtkx/jsx/gtk";
-import { useForwardedRef } from "@gtkx/react";
-import { createElement, useCallback, useMemo, useRef, useState } from "react";
-import { ColumnViewContext, } from "./contexts/column-view-context.js";
-import { useListModel } from "./hooks/use-list-model.js";
-import { useModelInstallation } from "./hooks/use-model-installation.js";
-import { useRealizedSlots } from "./hooks/use-realized-slots.js";
-import { useSelectionModel } from "./hooks/use-selection-model.js";
+import { useCallback, useMemo, useState } from "react";
+import { createTreeRenderContext, HeaderRenderHost } from "./cell.js";
+import { ColumnViewColumn } from "./column-view-column.js";
+import { makeFactoryInstaller, useCellContainers } from "./hooks/use-cell-containers.js";
+import { useCollectionWidget } from "./hooks/use-collection-widget.js";
 import { useSortHandler } from "./hooks/use-sort-handler.js";
-import { ListPortalHost } from "./list-portal-host.js";
-const headerFactoryBinding = {
-    install: (widget, factory) => widget.setHeaderFactory(factory),
-    uninstall: (widget) => widget.setHeaderFactory(null),
-};
-const useColumnRegistry = () => {
-    const [registrations, setRegistrations] = useState(() => new Map());
-    const register = useCallback((registration) => {
-        setRegistrations((current) => {
-            const next = new Map(current);
-            next.set(registration.id, registration);
-            return next;
-        });
-    }, []);
-    const unregister = useCallback((id) => {
-        setRegistrations((current) => {
-            if (!current.has(id))
+const headerFactoryInstaller = makeFactoryInstaller((widget, factory) => widget.setHeaderFactory(factory));
+const useColumnInstances = () => {
+    const [instances, setInstances] = useState(() => new Map());
+    const setInstance = useCallback((id, column) => {
+        setInstances((current) => {
+            if (column === null) {
+                if (!current.has(id))
+                    return current;
+                const next = new Map(current);
+                next.delete(id);
+                return next;
+            }
+            if (current.get(id) === column)
                 return current;
             const next = new Map(current);
-            next.delete(id);
+            next.set(id, column);
             return next;
         });
     }, []);
-    const columns = useMemo(() => [...registrations.values()], [registrations]);
-    return { columns, register, unregister };
+    return { instances, setInstance };
 };
-const headerRenderer = (renderHeader) => (value) => renderHeader ? renderHeader(value) : null;
-const useColumnViewWiring = (props, registry) => {
-    const widgetRef = useRef(null);
-    const captureWidget = useCallback((value) => {
-        widgetRef.current = value;
-    }, []);
-    const [, setRef] = useForwardedRef(props.ref, captureWidget);
-    const externalModel = props.model;
-    const listModel = useListModel(externalModel === undefined ? { items: props.items } : { model: externalModel });
-    const controlledSelection = useSelectionModel({
-        base: listModel.model,
-        selectionMode: props.selectionMode,
-        selected: props.selected,
-        onSelectionChanged: props.onSelectionChanged,
-        resolver: listModel.resolver,
-    });
-    const installedModel = externalModel === undefined ? controlledSelection : externalModel;
-    useModelInstallation(widgetRef, installedModel, (widget, model) => widget.setModel(model));
-    const useHeader = externalModel === undefined && typeof props.renderHeader === "function";
-    const headers = useRealizedSlots({
-        target: useHeader ? widgetRef : null,
-        binding: headerFactoryBinding,
-        estimatedHeight: props.estimatedRowHeight ?? undefined,
+const buildRegistrations = (columns, instances) => {
+    const result = [];
+    for (const column of columns) {
+        const instance = instances.get(column.id);
+        if (instance)
+            result.push({ id: column.id, column: instance, sortable: column.sortable ?? false });
+    }
+    return result;
+};
+const useColumnViewWiring = (props) => {
+    const { widgetRef, setRef, collection } = useCollectionWidget(props);
+    const useHeader = collection.useHeader;
+    const headerStore = useCellContainers({
+        object: useHeader ? widgetRef : null,
+        installer: headerFactoryInstaller,
+        estimatedHeight: props.estimatedItemHeight,
     });
+    const { instances, setInstance } = useColumnInstances();
+    const registrations = useMemo(() => buildRegistrations(props.columns, instances), [props.columns, instances]);
     useSortHandler({
         columnView: widgetRef,
         sortColumn: props.sortColumn,
         sortOrder: props.sortOrder,
         onSortChanged: props.onSortChanged,
-        columns: registry.columns,
+        columns: registrations,
     });
-    const contextValue = useMemo(() => ({
-        columnView: widgetRef,
-        resolver: listModel.resolver,
-        register: registry.register,
-        unregister: registry.unregister,
-    }), [listModel.resolver, registry.register, registry.unregister]);
+    const expandedIds = props.expandedIds;
+    const tree = useMemo(() => createTreeRenderContext(expandedIds, collection.rowId), [expandedIds, collection.rowId]);
     return {
         setRef,
-        resolver: listModel.resolver,
-        headerResolver: listModel.headerResolver,
-        headerStore: headers.store,
         useHeader,
-        contextValue,
+        headerStore,
+        headerResolver: collection.headerResolver,
+        resolver: collection.resolver,
+        tree,
+        setInstance,
     };
 };
 /**
- * A `GtkColumnView` driven by a declarative `items` model with optional
- * controlled selection, controlled sorting, and section headers. Columns are
- * declared as {@link ColumnViewColumn} children. Supplying an external `model`
- * switches to the uncontrolled form.
+ * Renders a Gtk.ColumnView: a multi-column, scrollable list backed by a collection
+ * model. Columns are declared through the columns prop, each a {@link ColumnDef}.
  */
 export const ColumnView = (props) => {
-    const { ref, items, model, selected, selectionMode, onSelectionChanged, sortColumn, sortOrder, onSortChanged, renderHeader, estimatedRowHeight, children, ...intrinsicProps } = props;
-    const registry = useColumnRegistry();
-    const wiring = useColumnViewWiring({
-        ref,
-        items,
-        model,
-        selected,
-        selectionMode,
-        onSelectionChanged,
-        sortColumn,
-        sortOrder,
-        onSortChanged,
-        renderHeader,
-        estimatedRowHeight,
-    }, registry);
-    const intrinsic = createElement(GtkColumnView, { ...intrinsicProps, ref: wiring.setRef }, _jsx(ColumnViewContext.Provider, { value: wiring.contextValue, children: children }));
-    return (_jsxs(_Fragment, { children: [intrinsic, wiring.useHeader ? (_jsx(ListPortalHost, { store: wiring.headerStore, resolver: wiring.headerResolver, render: headerRenderer(renderHeader) })) : null] }));
+    const normalized = props;
+    const wiring = useColumnViewWiring(normalized);
+    const { ref, items, sections, columns, selectedIds, selectionMode, onSelectionChanged, expandedIds, onExpandedChange, sortColumn, sortOrder, onSortChanged, renderHeader, estimatedItemHeight, ...intrinsicProps } = normalized;
+    return (_jsxs(_Fragment, { children: [_jsx(GtkColumnView, { ...intrinsicProps, ref: wiring.setRef, children: columns.map((column) => (_jsx(ColumnViewColumn, { ...column, resolver: wiring.resolver, tree: wiring.tree, estimatedItemHeight: estimatedItemHeight, onInstance: wiring.setInstance }, column.id))) }), _jsx(HeaderRenderHost, { useHeader: wiring.useHeader, store: wiring.headerStore, resolver: wiring.headerResolver, renderHeader: renderHeader })] }));
 };
 //# sourceMappingURL=column-view.js.map

package/dist/column-view.js.map

@@ -1 +1 @@
-{"version":3,"file":"column-view.js","sourceRoot":"","sources":["../src/column-view.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"column-view.js","sourceRoot":"","sources":["../src/column-view.tsx"],"names":[],"mappings":"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","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { GtkColumnView, type GtkColumnViewProps } from \"@gtkx/jsx/gtk\";\nimport { type ReactNode, type Ref, useCallback, useMemo, useState } from \"react\";\nimport { createTreeRenderContext, HeaderRenderHost, type TreeRenderContext } from \"./cell.js\";\nimport { type ColumnDef, ColumnViewColumn } from \"./column-view-column.js\";\nimport { makeFactoryInstaller, useCellContainers } from \"./hooks/use-cell-containers.js\";\nimport { useCollectionWidget } from \"./hooks/use-collection-widget.js\";\nimport { type ColumnRegistration, useSortHandler } from \"./hooks/use-sort-handler.js\";\nimport type {\n    CollectionItemSizeProps,\n    ControlledExpansionProps,\n    ControlledSelectionProps,\n    ItemNode,\n    SectionNode,\n} from \"./types.js\";\nimport type { CellContainerStore } from \"./utils/cell-container-store.js\";\nimport type { ItemResolver } from \"./utils/item-resolver.js\";\n\nexport type { ColumnDef, ColumnDefDeclarativeProps } from \"./column-view-column.js\";\n\nconst headerFactoryInstaller = makeFactoryInstaller<Gtk.ColumnView>((widget, factory) =>\n    widget.setHeaderFactory(factory),\n);\n\nexport type ColumnViewSortProps = {\n    sortColumn?: string | null | undefined;\n    sortOrder?: Gtk.SortType | null | undefined;\n    onSortChanged?: ((column: string | null, order: Gtk.SortType) => void) | null | undefined;\n};\n\nexport type ColumnViewDeclarativeProps<T = unknown, S = unknown> = ColumnViewSortProps &\n    Omit<CollectionItemSizeProps, \"estimatedItemWidth\"> &\n    ControlledSelectionProps &\n    ControlledExpansionProps & {\n        items?: ItemNode<T>[] | undefined;\n        sections?: SectionNode<S, T>[] | undefined;\n        renderHeader?: ((info: { section: S }) => ReactNode) | null | undefined;\n        columns: ColumnDef<T>[];\n    };\n\n/**\n * Props for {@link ColumnView}. Combines the underlying Gtk.ColumnView props with\n * declarative collection props: flat items or grouped sections, controlled selection\n * and expansion, sorting (sortColumn, sortOrder, onSortChanged), an optional section\n * header renderer, and the columns to render.\n */\nexport type ColumnViewProps<T = unknown, S = unknown> = Omit<\n    GtkColumnViewProps,\n    \"columns\" | \"model\" | \"headerFactory\" | keyof ColumnViewDeclarativeProps<T, S>\n> &\n    ColumnViewDeclarativeProps<T, S>;\n\ntype NormalizedColumnViewProps<T, S> = ColumnViewDeclarativeProps<T, S> & {\n    ref?: Ref<Gtk.ColumnView | null>;\n    [key: string]: unknown;\n};\n\ninterface ColumnViewWiring<T, S> {\n    setRef: (value: Gtk.ColumnView | null) => void;\n    useHeader: boolean;\n    headerStore: CellContainerStore;\n    headerResolver: ItemResolver<T, S>;\n    resolver: ItemResolver<unknown, unknown>;\n    tree: TreeRenderContext;\n    setInstance: (id: string, column: Gtk.ColumnViewColumn | null) => void;\n}\n\nconst useColumnInstances = (): {\n    instances: Map<string, Gtk.ColumnViewColumn>;\n    setInstance: (id: string, column: Gtk.ColumnViewColumn | null) => void;\n} => {\n    const [instances, setInstances] = useState<Map<string, Gtk.ColumnViewColumn>>(() => new Map());\n    const setInstance = useCallback((id: string, column: Gtk.ColumnViewColumn | null): void => {\n        setInstances((current) => {\n            if (column === null) {\n                if (!current.has(id)) return current;\n                const next = new Map(current);\n                next.delete(id);\n                return next;\n            }\n            if (current.get(id) === column) return current;\n            const next = new Map(current);\n            next.set(id, column);\n            return next;\n        });\n    }, []);\n    return { instances, setInstance };\n};\n\nconst buildRegistrations = <T,>(\n    columns: ColumnDef<T>[],\n    instances: Map<string, Gtk.ColumnViewColumn>,\n): ColumnRegistration[] => {\n    const result: ColumnRegistration[] = [];\n    for (const column of columns) {\n        const instance = instances.get(column.id);\n        if (instance) result.push({ id: column.id, column: instance, sortable: column.sortable ?? false });\n    }\n    return result;\n};\n\nconst useColumnViewWiring = <T, S>(props: NormalizedColumnViewProps<T, S>): ColumnViewWiring<T, S> => {\n    const { widgetRef, setRef, collection } = useCollectionWidget<Gtk.ColumnView, T, S>(props);\n\n    const useHeader = collection.useHeader;\n    const headerStore = useCellContainers<Gtk.ColumnView>({\n        object: useHeader ? widgetRef : null,\n        installer: headerFactoryInstaller,\n        estimatedHeight: props.estimatedItemHeight,\n    });\n\n    const { instances, setInstance } = useColumnInstances();\n    const registrations = useMemo<ColumnRegistration[]>(\n        () => buildRegistrations(props.columns, instances),\n        [props.columns, instances],\n    );\n\n    useSortHandler({\n        columnView: widgetRef,\n        sortColumn: props.sortColumn,\n        sortOrder: props.sortOrder,\n        onSortChanged: props.onSortChanged,\n        columns: registrations,\n    });\n\n    const expandedIds = props.expandedIds;\n    const tree = useMemo<TreeRenderContext>(\n        () => createTreeRenderContext(expandedIds, collection.rowId),\n        [expandedIds, collection.rowId],\n    );\n\n    return {\n        setRef,\n        useHeader,\n        headerStore,\n        headerResolver: collection.headerResolver,\n        resolver: collection.resolver as ItemResolver<unknown, unknown>,\n        tree,\n        setInstance,\n    };\n};\n\n/**\n * Renders a Gtk.ColumnView: a multi-column, scrollable list backed by a collection\n * model. Columns are declared through the columns prop, each a {@link ColumnDef}.\n */\nexport const ColumnView = <T = unknown, S = unknown>(props: ColumnViewProps<T, S>): ReactNode => {\n    const normalized = props as NormalizedColumnViewProps<T, S>;\n    const wiring = useColumnViewWiring<T, S>(normalized);\n    const {\n        ref,\n        items,\n        sections,\n        columns,\n        selectedIds,\n        selectionMode,\n        onSelectionChanged,\n        expandedIds,\n        onExpandedChange,\n        sortColumn,\n        sortOrder,\n        onSortChanged,\n        renderHeader,\n        estimatedItemHeight,\n        ...intrinsicProps\n    } = normalized;\n\n    return (\n        <>\n            <GtkColumnView {...intrinsicProps} ref={wiring.setRef}>\n                {columns.map((column) => (\n                    <ColumnViewColumn\n                        key={column.id}\n                        {...column}\n                        resolver={wiring.resolver}\n                        tree={wiring.tree}\n                        estimatedItemHeight={estimatedItemHeight}\n                        onInstance={wiring.setInstance}\n                    />\n                ))}\n            </GtkColumnView>\n            <HeaderRenderHost\n                useHeader={wiring.useHeader}\n                store={wiring.headerStore}\n                resolver={wiring.headerResolver}\n                renderHeader={renderHeader}\n            />\n        </>\n    );\n};\n"]}

package/dist/constraint-layout-apply.d.ts

@@ -1,5 +1,54 @@
 import * as Gtk from "@gtkx/gi/gtk";
-import type { ConstraintGuideProps, ConstraintProps, ConstraintVflProps } from "./types.js";
+/**
+ * Describes one constraint added by `<ConstraintLayout.Constraint>`, relating a
+ * target widget attribute to a source attribute of another widget or guide.
+ */
+export type ConstraintProps = {
+    /** Name of the target widget or guide. Use "super" or omit to reference the layout's own widget. */
+    target?: string;
+    targetAttribute: Gtk.ConstraintAttribute;
+    /** Relation between the target and source attributes (defaults to equality). */
+    relation?: Gtk.ConstraintRelation;
+    /** Name of the source widget or guide. Use "super" or omit for a constant constraint. */
+    source?: string;
+    sourceAttribute?: Gtk.ConstraintAttribute;
+    /** Factor applied to the source attribute (defaults to 1). */
+    multiplier?: number;
+    /** Constant offset added to the relation (defaults to 0). */
+    constant?: number;
+    /** Constraint strength, higher values winning conflicts (defaults to required). */
+    strength?: number;
+};
+/**
+ * Describes an invisible spacing guide added by `<ConstraintLayout.Guide>`,
+ * usable as a constraint target under its id.
+ */
+export type ConstraintGuideProps = {
+    /** Identifier used to reference this guide from constraints. */
+    id: string;
+    minWidth?: number;
+    minHeight?: number;
+    /** Preferred (natural) width. */
+    natWidth?: number;
+    /** Preferred (natural) height. */
+    natHeight?: number;
+    maxWidth?: number;
+    maxHeight?: number;
+    /** Strength of the guide's own size constraints. */
+    strength?: Gtk.ConstraintStrength;
+};
+/**
+ * Describes constraints authored with the Visual Format Language (VFL), applied by
+ * `<ConstraintLayout.Vfl>`.
+ */
+export type ConstraintVflProps = {
+    /** VFL lines describing the constraints between named widgets and guides. */
+    lines: string[];
+    /** Default horizontal spacing used by the layout operator (defaults to 0). */
+    hspacing?: number;
+    /** Default vertical spacing used by the layout operator (defaults to 0). */
+    vspacing?: number;
+};
 export declare function applyConstraint(layout: Gtk.ConstraintLayout, props: ConstraintProps): () => void;
 export declare function applyVfl(layout: Gtk.ConstraintLayout, props: ConstraintVflProps): () => void;
 export declare function applyGuide(layout: Gtk.ConstraintLayout, props: ConstraintGuideProps): () => void;

package/dist/constraint-layout-apply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constraint-layout-apply.d.ts","sourceRoot":"","sources":["../src/constraint-layout-apply.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA8D5F,wBAAgB,eAAe,CAAC,MAAM,EAAE,GAAG,CAAC,gBAAgB,EAAE,KAAK,EAAE,eAAe,GAAG,MAAM,IAAI,CAqBhG;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,gBAAgB,EAAE,KAAK,EAAE,kBAAkB,GAAG,MAAM,IAAI,CAa5F;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,gBAAgB,EAAE,KAAK,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAkBhG"}
+{"version":3,"file":"constraint-layout-apply.d.ts","sourceRoot":"","sources":["../src/constraint-layout-apply.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAEpC;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B,oGAAoG;IACpG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,GAAG,CAAC,mBAAmB,CAAC;IACzC,gFAAgF;IAChF,QAAQ,CAAC,EAAE,GAAG,CAAC,kBAAkB,CAAC;IAClC,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,GAAG,CAAC,mBAAmB,CAAC;IAC1C,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAC/B,gEAAgE;IAChE,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,GAAG,CAAC,kBAAkB,CAAC;CACrC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC7B,6EAA6E;IAC7E,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AA8DF,wBAAgB,eAAe,CAAC,MAAM,EAAE,GAAG,CAAC,gBAAgB,EAAE,KAAK,EAAE,eAAe,GAAG,MAAM,IAAI,CAqBhG;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,gBAAgB,EAAE,KAAK,EAAE,kBAAkB,GAAG,MAAM,IAAI,CAa5F;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,gBAAgB,EAAE,KAAK,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAkBhG"}

package/dist/constraint-layout-apply.js.map

@@ -1 +1 @@
-{"version":3,"file":"constraint-layout-apply.js","sourceRoot":"","sources":["../src/constraint-layout-apply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAGpC,MAAM,QAAQ,GAAG,OAAO,CAAC;AAEzB,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,EAAU,EAAU,EAAE,CAC1D,wDAAwD,EAAE,KAAK;IAC/D,aAAa,EAAE,YAAY,IAAI,iDAAiD,EAAE,KAAK,CAAC;AAE5F,MAAM,aAAa,GAAG,IAAI,OAAO,EAA0D,CAAC;AAE5F,MAAM,SAAS,GAAG,CAAC,MAA4B,EAAoC,EAAE;IACjF,IAAI,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG,EAAE,CAAC;QACP,GAAG,GAAG,IAAI,GAAG,EAA+B,CAAC;QAC7C,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,MAAkB,EAAiB,EAAE;IAC7D,MAAM,KAAK,GAAG,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAChC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;IAC/B,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1D,CAAC,CAAC;AAEF,QAAQ,CAAC,CAAC,aAAa,CAAC,MAA4B;IAChD,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAChC,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,KAAK,IAAI,KAAK,GAAG,IAAI,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;QAC3E,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,IAAI,KAAK,IAAI;YAAE,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;AACL,CAAC;AAED,MAAM,eAAe,GAAG,CAAC,MAA4B,EAAE,EAAU,EAA0B,EAAE;IACzF,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,IAAI,IAAI,KAAK,EAAE;YAAE,OAAO,KAAK,CAAC;IAClC,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAC5B,MAA4B,EAC5B,EAAsB,EACiB,EAAE;IACzC,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrD,OAAO,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACpE,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,MAA4B,EAAqC,EAAE;IACxF,MAAM,KAAK,GAAG,IAAI,GAAG,EAAgC,CAAC;IACtD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC1E,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,MAA4B,EAAW,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,IAAI,CAAC;AAE5F,MAAM,UAAU,eAAe,CAAC,MAA4B,EAAE,KAAsB;IAChF,MAAM,MAAM,GAAG,uBAAuB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7D,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5F,MAAM,MAAM,GAAG,uBAAuB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7D,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAE5F,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC;QAClC,MAAM;QACN,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,GAAG,CAAC,kBAAkB,CAAC,EAAE;QACrD,MAAM;QACN,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,GAAG,CAAC,mBAAmB,CAAC,IAAI;QACtE,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,CAAC;QACjC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC;QAC7B,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,GAAG,CAAC,kBAAkB,CAAC,QAAQ;KAC9D,CAAC,CAAC;IACH,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAEjC,OAAO,GAAG,EAAE;QACR,IAAI,YAAY,CAAC,MAAM,CAAC;YAAE,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAClE,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAA4B,EAAE,KAAyB;IAC5E,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,WAAW,GAAG,MAAM,CAAC,6BAA6B,CACpD,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,QAAQ,IAAI,CAAC,EACnB,KAAK,CAAC,QAAQ,IAAI,CAAC,EACnB,KAAK,CACR,CAAC;IAEF,OAAO,GAAG,EAAE;QACR,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;YAAE,OAAO;QAClC,KAAK,MAAM,UAAU,IAAI,WAAW;YAAE,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC9E,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAA4B,EAAE,KAA2B;IAChF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC;QAClC,IAAI,EAAE,KAAK,CAAC,EAAE;QACd,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;KAC3B,CAAC,CAAC;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvB,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAEvC,OAAO,GAAG,EAAE;QACR,SAAS,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,YAAY,CAAC,MAAM,CAAC;YAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"constraint-layout-apply.js","sourceRoot":"","sources":["../src/constraint-layout-apply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAuDpC,MAAM,QAAQ,GAAG,OAAO,CAAC;AAEzB,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,EAAU,EAAU,EAAE,CAC1D,wDAAwD,EAAE,KAAK;IAC/D,aAAa,EAAE,YAAY,IAAI,iDAAiD,EAAE,KAAK,CAAC;AAE5F,MAAM,aAAa,GAAG,IAAI,OAAO,EAA0D,CAAC;AAE5F,MAAM,SAAS,GAAG,CAAC,MAA4B,EAAoC,EAAE;IACjF,IAAI,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG,EAAE,CAAC;QACP,GAAG,GAAG,IAAI,GAAG,EAA+B,CAAC;QAC7C,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,MAAkB,EAAiB,EAAE;IAC7D,MAAM,KAAK,GAAG,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAChC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;IAC/B,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1D,CAAC,CAAC;AAEF,QAAQ,CAAC,CAAC,aAAa,CAAC,MAA4B;IAChD,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAChC,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,KAAK,IAAI,KAAK,GAAG,IAAI,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;QAC3E,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,IAAI,KAAK,IAAI;YAAE,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;AACL,CAAC;AAED,MAAM,eAAe,GAAG,CAAC,MAA4B,EAAE,EAAU,EAA0B,EAAE;IACzF,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,IAAI,IAAI,KAAK,EAAE;YAAE,OAAO,KAAK,CAAC;IAClC,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAC5B,MAA4B,EAC5B,EAAsB,EACiB,EAAE;IACzC,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrD,OAAO,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACpE,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,MAA4B,EAAqC,EAAE;IACxF,MAAM,KAAK,GAAG,IAAI,GAAG,EAAgC,CAAC;IACtD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC1E,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,MAA4B,EAAW,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,IAAI,CAAC;AAE5F,MAAM,UAAU,eAAe,CAAC,MAA4B,EAAE,KAAsB;IAChF,MAAM,MAAM,GAAG,uBAAuB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7D,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5F,MAAM,MAAM,GAAG,uBAAuB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7D,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAE5F,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC;QAClC,MAAM;QACN,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,GAAG,CAAC,kBAAkB,CAAC,EAAE;QACrD,MAAM;QACN,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,GAAG,CAAC,mBAAmB,CAAC,IAAI;QACtE,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,CAAC;QACjC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC;QAC7B,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,GAAG,CAAC,kBAAkB,CAAC,QAAQ;KAC9D,CAAC,CAAC;IACH,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAEjC,OAAO,GAAG,EAAE;QACR,IAAI,YAAY,CAAC,MAAM,CAAC;YAAE,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAClE,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAA4B,EAAE,KAAyB;IAC5E,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,WAAW,GAAG,MAAM,CAAC,6BAA6B,CACpD,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,QAAQ,IAAI,CAAC,EACnB,KAAK,CAAC,QAAQ,IAAI,CAAC,EACnB,KAAK,CACR,CAAC;IAEF,OAAO,GAAG,EAAE;QACR,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;YAAE,OAAO;QAClC,KAAK,MAAM,UAAU,IAAI,WAAW;YAAE,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC9E,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAA4B,EAAE,KAA2B;IAChF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC;QAClC,IAAI,EAAE,KAAK,CAAC,EAAE;QACd,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;KAC3B,CAAC,CAAC;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvB,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAEvC,OAAO,GAAG,EAAE;QACR,SAAS,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,YAAY,CAAC,MAAM,CAAC;YAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC,CAAC;AACN,CAAC","sourcesContent":["import * as GObject from \"@gtkx/gi/gobject\";\nimport * as Gtk from \"@gtkx/gi/gtk\";\n\n/**\n * Describes one constraint added by `<ConstraintLayout.Constraint>`, relating a\n * target widget attribute to a source attribute of another widget or guide.\n */\nexport type ConstraintProps = {\n    /** Name of the target widget or guide. Use \"super\" or omit to reference the layout's own widget. */\n    target?: string;\n    targetAttribute: Gtk.ConstraintAttribute;\n    /** Relation between the target and source attributes (defaults to equality). */\n    relation?: Gtk.ConstraintRelation;\n    /** Name of the source widget or guide. Use \"super\" or omit for a constant constraint. */\n    source?: string;\n    sourceAttribute?: Gtk.ConstraintAttribute;\n    /** Factor applied to the source attribute (defaults to 1). */\n    multiplier?: number;\n    /** Constant offset added to the relation (defaults to 0). */\n    constant?: number;\n    /** Constraint strength, higher values winning conflicts (defaults to required). */\n    strength?: number;\n};\n\n/**\n * Describes an invisible spacing guide added by `<ConstraintLayout.Guide>`,\n * usable as a constraint target under its id.\n */\nexport type ConstraintGuideProps = {\n    /** Identifier used to reference this guide from constraints. */\n    id: string;\n    minWidth?: number;\n    minHeight?: number;\n    /** Preferred (natural) width. */\n    natWidth?: number;\n    /** Preferred (natural) height. */\n    natHeight?: number;\n    maxWidth?: number;\n    maxHeight?: number;\n    /** Strength of the guide's own size constraints. */\n    strength?: Gtk.ConstraintStrength;\n};\n\n/**\n * Describes constraints authored with the Visual Format Language (VFL), applied by\n * `<ConstraintLayout.Vfl>`.\n */\nexport type ConstraintVflProps = {\n    /** VFL lines describing the constraints between named widgets and guides. */\n    lines: string[];\n    /** Default horizontal spacing used by the layout operator (defaults to 0). */\n    hspacing?: number;\n    /** Default vertical spacing used by the layout operator (defaults to 0). */\n    vspacing?: number;\n};\n\nconst SUPER_ID = \"super\";\n\nconst unknownIdMessage = (role: string, id: string): string =>\n    `<ConstraintLayout.Constraint> references unknown id '${id}'. ` +\n    `Set name=\"${id}\" on the ${role} widget, or add a <ConstraintLayout.Guide id=\"${id}\">.`;\n\nconst guideRegistry = new WeakMap<Gtk.ConstraintLayout, Map<string, Gtk.ConstraintGuide>>();\n\nconst guidesFor = (layout: Gtk.ConstraintLayout): Map<string, Gtk.ConstraintGuide> => {\n    let map = guideRegistry.get(layout);\n    if (!map) {\n        map = new Map<string, Gtk.ConstraintGuide>();\n        guideRegistry.set(layout, map);\n    }\n    return map;\n};\n\nconst explicitWidgetName = (widget: Gtk.Widget): string | null => {\n    const value = new GObject.Value();\n    value.init(GObject.TYPE_STRING);\n    widget.getProperty(\"name\", value);\n    const name = value.getString();\n    return name !== null && name.length > 0 ? name : null;\n};\n\nfunction* namedChildren(layout: Gtk.ConstraintLayout): Generator<[string, Gtk.Widget]> {\n    const host = layout.getWidget();\n    if (!host) return;\n    for (let child = host.getFirstChild(); child; child = child.getNextSibling()) {\n        const name = explicitWidgetName(child);\n        if (name !== null) yield [name, child];\n    }\n}\n\nconst findChildByName = (layout: Gtk.ConstraintLayout, id: string): Gtk.Widget | undefined => {\n    for (const [name, child] of namedChildren(layout)) {\n        if (name === id) return child;\n    }\n    return undefined;\n};\n\nconst resolveConstraintTarget = (\n    layout: Gtk.ConstraintLayout,\n    id: string | undefined,\n): Gtk.ConstraintTarget | null | undefined => {\n    if (id === undefined || id === SUPER_ID) return null;\n    return findChildByName(layout, id) ?? guidesFor(layout).get(id);\n};\n\nconst constraintViews = (layout: Gtk.ConstraintLayout): Map<string, Gtk.ConstraintTarget> => {\n    const views = new Map<string, Gtk.ConstraintTarget>();\n    for (const [name, child] of namedChildren(layout)) views.set(name, child);\n    for (const [name, guide] of guidesFor(layout)) {\n        if (!views.has(name)) views.set(name, guide);\n    }\n    return views;\n};\n\nconst isLayoutLive = (layout: Gtk.ConstraintLayout): boolean => layout.getWidget() !== null;\n\nexport function applyConstraint(layout: Gtk.ConstraintLayout, props: ConstraintProps): () => void {\n    const target = resolveConstraintTarget(layout, props.target);\n    if (target === undefined) throw new Error(unknownIdMessage(\"target\", String(props.target)));\n    const source = resolveConstraintTarget(layout, props.source);\n    if (source === undefined) throw new Error(unknownIdMessage(\"source\", String(props.source)));\n\n    const constraint = new Gtk.Constraint({\n        target,\n        targetAttribute: props.targetAttribute,\n        relation: props.relation ?? Gtk.ConstraintRelation.EQ,\n        source,\n        sourceAttribute: props.sourceAttribute ?? Gtk.ConstraintAttribute.NONE,\n        multiplier: props.multiplier ?? 1,\n        constant: props.constant ?? 0,\n        strength: props.strength ?? Gtk.ConstraintStrength.REQUIRED,\n    });\n    layout.addConstraint(constraint);\n\n    return () => {\n        if (isLayoutLive(layout)) layout.removeConstraint(constraint);\n    };\n}\n\nexport function applyVfl(layout: Gtk.ConstraintLayout, props: ConstraintVflProps): () => void {\n    const views = constraintViews(layout);\n    const constraints = layout.addConstraintsFromDescription(\n        props.lines,\n        props.hspacing ?? 0,\n        props.vspacing ?? 0,\n        views,\n    );\n\n    return () => {\n        if (!isLayoutLive(layout)) return;\n        for (const constraint of constraints) layout.removeConstraint(constraint);\n    };\n}\n\nexport function applyGuide(layout: Gtk.ConstraintLayout, props: ConstraintGuideProps): () => void {\n    const guide = new Gtk.ConstraintGuide({\n        name: props.id,\n        minWidth: props.minWidth,\n        minHeight: props.minHeight,\n        natWidth: props.natWidth,\n        natHeight: props.natHeight,\n        maxWidth: props.maxWidth,\n        maxHeight: props.maxHeight,\n        strength: props.strength,\n    });\n    layout.addGuide(guide);\n    guidesFor(layout).set(props.id, guide);\n\n    return () => {\n        guidesFor(layout).delete(props.id);\n        if (isLayoutLive(layout)) layout.removeGuide(guide);\n    };\n}\n"]}

package/dist/constraint-layout.d.ts

@@ -1,10 +1,17 @@
 import type * as Gtk from "@gtkx/gi/gtk";
 import { type ReactNode, type Ref } from "react";
-import type { ConstraintGuideProps, ConstraintProps, ConstraintVflProps } from "./types.js";
+import { type ConstraintGuideProps, type ConstraintProps, type ConstraintVflProps } from "./constraint-layout-apply.js";
+/** Props for {@link ConstraintLayout}. */
 export type ConstraintLayoutProps = {
     children?: ReactNode;
     ref?: Ref<Gtk.ConstraintLayout | null>;
 };
+/**
+ * Installs a Gtk.ConstraintLayout on a host widget and exposes child components to
+ * populate it: {@link ConstraintProps | ConstraintLayout.Constraint} for individual constraints,
+ * {@link ConstraintGuideProps | ConstraintLayout.Guide} for spacing guides, and {@link ConstraintVflProps | ConstraintLayout.Vfl}
+ * for constraints authored in the Visual Format Language.
+ */
 export declare const ConstraintLayout: ((props: ConstraintLayoutProps) => ReactNode) & {
     Guide: (props: ConstraintGuideProps) => ReactNode;
     Constraint: (props: ConstraintProps) => ReactNode;

package/dist/constraint-layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constraint-layout.d.ts","sourceRoot":"","sources":["../src/constraint-layout.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AAGzC,OAAO,EAIH,KAAK,SAAS,EACd,KAAK,GAAG,EAOX,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAa5F,MAAM,MAAM,qBAAqB,GAAG;IAChC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CAC1C,CAAC;AAqCF,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,KAAK,EAAE,qBAAqB,KAAK,SAAS,CAAC,GAAG;IAC3E,KAAK,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,SAAS,CAAC;IAClD,UAAU,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,SAAS,CAAC;IAClD,GAAG,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,SAAS,CAAC;CAwDjD,CAAC"}
+{"version":3,"file":"constraint-layout.d.ts","sourceRoot":"","sources":["../src/constraint-layout.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AAGzC,OAAO,EAGH,KAAK,SAAS,EACd,KAAK,GAAG,EAMX,MAAM,OAAO,CAAC;AACf,OAAO,EAIH,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EAC1B,MAAM,8BAA8B,CAAC;AAatC,0CAA0C;AAC1C,MAAM,MAAM,qBAAqB,GAAG;IAChC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CAC1C,CAAC;AAqCF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,KAAK,EAAE,qBAAqB,KAAK,SAAS,CAAC,GAAG;IAC3E,KAAK,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,SAAS,CAAC;IAClD,UAAU,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,SAAS,CAAC;IAClD,GAAG,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,SAAS,CAAC;CAkDjD,CAAC"}

package/dist/constraint-layout.js

@@ -1,8 +1,8 @@
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { GtkConstraintLayout } from "@gtkx/jsx/gtk";
-import { useForwardedRef } from "@gtkx/react";
-import { createContext, createElement, useCallback, useContext, useEffect, useLayoutEffect, useRef, } from "react";
-import { applyConstraint, applyGuide, applyVfl } from "./constraint-layout-apply.js";
+import { useMergeRefs } from "@gtkx/react/internal";
+import { createContext, useContext, useEffect, useLayoutEffect, useRef, } from "react";
+import { applyConstraint, applyGuide, applyVfl, } from "./constraint-layout-apply.js";
 const ORPHAN_MESSAGE = "<ConstraintLayout.Constraint> / <Guide> / <Vfl> must be a child of <ConstraintLayout>";
 const ConstraintLayoutContext = createContext(null);
 const useConstraintLayoutRef = () => {
@@ -43,13 +43,16 @@ const useDeferredContribution = (apply, deps) => {
         };
     }, deps);
 };
+/**
+ * Installs a Gtk.ConstraintLayout on a host widget and exposes child components to
+ * populate it: {@link ConstraintProps | ConstraintLayout.Constraint} for individual constraints,
+ * {@link ConstraintGuideProps | ConstraintLayout.Guide} for spacing guides, and {@link ConstraintVflProps | ConstraintLayout.Vfl}
+ * for constraints authored in the Visual Format Language.
+ */
 export const ConstraintLayout = Object.assign(({ children, ref }) => {
     const layoutRef = useRef(null);
-    const captureLayout = useCallback((layout) => {
-        layoutRef.current = layout;
-    }, [layoutRef]);
-    const [, mergedRef] = useForwardedRef(ref, captureLayout);
-    return (_jsxs(_Fragment, { children: [createElement(GtkConstraintLayout, { ref: mergedRef }), _jsx(ConstraintLayoutContext.Provider, { value: layoutRef, children: children })] }));
+    const mergedRef = useMergeRefs(ref, layoutRef);
+    return (_jsxs(_Fragment, { children: [_jsx(GtkConstraintLayout, { ref: mergedRef }), _jsx(ConstraintLayoutContext.Provider, { value: layoutRef, children: children })] }));
 }, {
     Guide: (props) => {
         useLayoutContribution((layout) => applyGuide(layout, props), [

package/dist/constraint-layout.js.map

@@ -1 +1 @@
-{"version":3,"file":"constraint-layout.js","sourceRoot":"","sources":["../src/constraint-layout.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"constraint-layout.js","sourceRoot":"","sources":["../src/constraint-layout.tsx"],"names":[],"mappings":"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","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { GtkConstraintLayout } from \"@gtkx/jsx/gtk\";\nimport { useMergeRefs } from \"@gtkx/react/internal\";\nimport {\n    type Context,\n    createContext,\n    type ReactNode,\n    type Ref,\n    type RefObject,\n    useContext,\n    useEffect,\n    useLayoutEffect,\n    useRef,\n} from \"react\";\nimport {\n    applyConstraint,\n    applyGuide,\n    applyVfl,\n    type ConstraintGuideProps,\n    type ConstraintProps,\n    type ConstraintVflProps,\n} from \"./constraint-layout-apply.js\";\n\nconst ORPHAN_MESSAGE = \"<ConstraintLayout.Constraint> / <Guide> / <Vfl> must be a child of <ConstraintLayout>\";\n\nconst ConstraintLayoutContext: Context<RefObject<Gtk.ConstraintLayout | null> | null> =\n    createContext<RefObject<Gtk.ConstraintLayout | null> | null>(null);\n\nconst useConstraintLayoutRef = (): RefObject<Gtk.ConstraintLayout | null> => {\n    const ref = useContext(ConstraintLayoutContext);\n    if (!ref) throw new Error(ORPHAN_MESSAGE);\n    return ref;\n};\n\n/** Props for {@link ConstraintLayout}. */\nexport type ConstraintLayoutProps = {\n    children?: ReactNode;\n    ref?: Ref<Gtk.ConstraintLayout | null>;\n};\n\ntype ContributionCleanupRef = { current: (() => void) | null };\n\nconst cleanupContribution = (cleanupRef: ContributionCleanupRef): void => {\n    const cleanup = cleanupRef.current;\n    if (!cleanup) return;\n    cleanupRef.current = null;\n    cleanup();\n};\n\nconst useLayoutContribution = (apply: (layout: Gtk.ConstraintLayout) => () => void, deps: unknown[]): void => {\n    const layoutRef = useConstraintLayoutRef();\n    useLayoutEffect(() => {\n        const layout = layoutRef.current;\n        if (!layout) return;\n        return apply(layout);\n    }, deps);\n};\n\nconst useDeferredContribution = (apply: (layout: Gtk.ConstraintLayout) => () => void, deps: unknown[]): void => {\n    const layoutRef = useConstraintLayoutRef();\n    const cleanupRef = useRef<(() => void) | null>(null);\n\n    useLayoutEffect(() => () => cleanupContribution(cleanupRef), deps);\n\n    useEffect(() => {\n        const layout = layoutRef.current;\n        if (!layout) return;\n        const cleanup = apply(layout);\n        cleanupRef.current = cleanup;\n        return () => {\n            if (cleanupRef.current === cleanup) cleanupContribution(cleanupRef);\n        };\n    }, deps);\n};\n\n/**\n * Installs a Gtk.ConstraintLayout on a host widget and exposes child components to\n * populate it: {@link ConstraintProps | ConstraintLayout.Constraint} for individual constraints,\n * {@link ConstraintGuideProps | ConstraintLayout.Guide} for spacing guides, and {@link ConstraintVflProps | ConstraintLayout.Vfl}\n * for constraints authored in the Visual Format Language.\n */\nexport const ConstraintLayout: ((props: ConstraintLayoutProps) => ReactNode) & {\n    Guide: (props: ConstraintGuideProps) => ReactNode;\n    Constraint: (props: ConstraintProps) => ReactNode;\n    Vfl: (props: ConstraintVflProps) => ReactNode;\n} = Object.assign(\n    ({ children, ref }: ConstraintLayoutProps): ReactNode => {\n        const layoutRef = useRef<Gtk.ConstraintLayout | null>(null);\n        const mergedRef = useMergeRefs<Gtk.ConstraintLayout>(ref, layoutRef);\n        return (\n            <>\n                <GtkConstraintLayout ref={mergedRef} />\n                <ConstraintLayoutContext.Provider value={layoutRef}>{children}</ConstraintLayoutContext.Provider>\n            </>\n        );\n    },\n    {\n        Guide: (props: ConstraintGuideProps): ReactNode => {\n            useLayoutContribution(\n                (layout) => applyGuide(layout, props),\n                [\n                    props.id,\n                    props.minWidth,\n                    props.minHeight,\n                    props.natWidth,\n                    props.natHeight,\n                    props.maxWidth,\n                    props.maxHeight,\n                    props.strength,\n                ],\n            );\n            return null;\n        },\n        Constraint: (props: ConstraintProps): ReactNode => {\n            useDeferredContribution(\n                (layout) => applyConstraint(layout, props),\n                [\n                    props.target,\n                    props.targetAttribute,\n                    props.relation,\n                    props.source,\n                    props.sourceAttribute,\n                    props.multiplier,\n                    props.constant,\n                    props.strength,\n                ],\n            );\n            return null;\n        },\n        Vfl: (props: ConstraintVflProps): ReactNode => {\n            useDeferredContribution((layout) => applyVfl(layout, props), [props.lines, props.hspacing, props.vspacing]);\n            return null;\n        },\n    },\n);\n"]}