@rastr/vue 0.0.0-stage → 0.1.0-beta.1

package/dist/tree-list.cjs

@@ -0,0 +1,133 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/tree-list/index.ts
+var tree_list_exports = {};
+__export(tree_list_exports, {
+  RsTreeList: () => RsTreeList
+});
+module.exports = __toCommonJS(tree_list_exports);
+
+// src/tree-list/RsTreeList.ts
+var import_tree_list = require("@rastr/tree-list");
+var import_vue = require("vue");
+var sameKeys = (a, b) => a.length === b.length && a.every((key, i) => String(key) === String(b[i]));
+var RsTreeList = (0, import_vue.defineComponent)({
+  name: "RsTreeList",
+  props: {
+    /** The rows; a new array (reference) refreshes the tree. */
+    rows: { type: [Array, Function], required: true },
+    keyField: { type: String, required: true },
+    parentField: String,
+    childrenField: String,
+    treeField: String,
+    columns: { type: Array, required: true },
+    expandedKeys: { type: Array, default: () => [] },
+    height: String,
+    selectionMode: String,
+    locale: String,
+    messages: Object,
+    theme: String,
+    density: String
+  },
+  emits: {
+    "update:expandedKeys": (keys) => Array.isArray(keys),
+    rowClick: (payload) => payload !== void 0,
+    rowDblClick: (payload) => payload !== void 0,
+    focusedRowChange: (payload) => payload !== void 0,
+    selectionChange: (selection) => selection !== void 0
+  },
+  setup(props, { emit, expose }) {
+    const host = (0, import_vue.ref)(null);
+    let tree = null;
+    let unsubscribe = null;
+    const create = () => {
+      if (!host.value) return;
+      const expanded = tree ? tree.getExpandedKeys() : (0, import_vue.toRaw)(props.expandedKeys);
+      destroy();
+      tree = (0, import_tree_list.createTreeList)(host.value, {
+        // Read on every load, so a refresh sees the latest rows prop.
+        rows: () => {
+          const rows = (0, import_vue.toRaw)(props.rows);
+          return typeof rows === "function" ? rows() : rows;
+        },
+        keyField: props.keyField,
+        columns: (0, import_vue.toRaw)(props.columns),
+        expandedKeys: expanded,
+        onExpandedChange: (keys) => emit("update:expandedKeys", keys),
+        ...props.parentField ? { parentField: props.parentField } : {},
+        ...props.childrenField ? { childrenField: props.childrenField } : {},
+        ...props.treeField ? { treeField: props.treeField } : {},
+        ...props.height ? { height: props.height } : {},
+        ...props.selectionMode ? { selectionMode: props.selectionMode } : {},
+        ...props.locale ? { locale: props.locale } : {},
+        ...props.messages ? { messages: props.messages } : {},
+        ...props.theme ? { theme: props.theme } : {},
+        ...props.density ? { density: props.density } : {}
+      });
+      tree.grid.on("rowClick", (payload) => emit("rowClick", payload));
+      tree.grid.on("rowDblClick", (payload) => emit("rowDblClick", payload));
+      tree.grid.on("focusedRowChange", (payload) => emit("focusedRowChange", payload));
+      let selection = tree.store.getSnapshot().state.selection;
+      unsubscribe = tree.store.subscribe((snapshot) => {
+        if (snapshot.state.selection === selection) return;
+        selection = snapshot.state.selection;
+        emit("selectionChange", selection);
+      });
+    };
+    const destroy = () => {
+      unsubscribe?.();
+      unsubscribe = null;
+      tree?.destroy();
+      tree = null;
+    };
+    expose({
+      expand: (key) => tree?.expand(key),
+      collapse: (key) => tree?.collapse(key),
+      expandAll: () => tree?.expandAll(),
+      collapseAll: () => tree?.collapseAll(),
+      refresh: () => tree?.refresh(),
+      get store() {
+        return tree?.store ?? null;
+      }
+    });
+    (0, import_vue.onMounted)(create);
+    (0, import_vue.onBeforeUnmount)(destroy);
+    (0, import_vue.watch)(
+      () => props.rows,
+      () => void tree?.refresh()
+    );
+    (0, import_vue.watch)(
+      () => props.expandedKeys,
+      (keys) => {
+        if (!tree || sameKeys((0, import_vue.toRaw)(keys), tree.getExpandedKeys())) return;
+        tree.source.collapseAll();
+        (0, import_vue.toRaw)(keys).forEach((key) => tree.source.setExpanded(key, true));
+        void tree.store.reload();
+      }
+    );
+    (0, import_vue.watch)(() => [props.columns, props.keyField, props.parentField, props.childrenField, props.treeField, props.height, props.selectionMode, props.locale, props.messages, props.theme, props.density], create);
+    return () => (0, import_vue.h)("div", { ref: host, class: "rs-vue-tree-list" });
+  }
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RsTreeList
+});
+//# sourceMappingURL=tree-list.cjs.map

package/dist/tree-list.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tree-list/index.ts","../src/tree-list/RsTreeList.ts"],"sourcesContent":["export { RsTreeList } from './RsTreeList';\n","import type { GridStore, Key, SelectionState } from '@rastr/core';\nimport type { GridColumn, GridEvents, Messages } from '@rastr/grid';\nimport { createTreeList } from '@rastr/tree-list';\nimport type { TreeList } from '@rastr/tree-list';\nimport { defineComponent, h, onBeforeUnmount, onMounted, ref, toRaw, watch } from 'vue';\nimport type { PropType, Ref } from 'vue';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyRow = any;\n\nconst sameKeys = (a: readonly Key[], b: readonly Key[]): boolean => a.length === b.length && a.every((key, i) => String(key) === String(b[i]));\n\n/** Tree list: hierarchical rows (parentField or childrenField) with v-model:expandedKeys. */\nexport const RsTreeList = defineComponent({\n  name: 'RsTreeList',\n  props: {\n    /** The rows; a new array (reference) refreshes the tree. */\n    rows: { type: [Array, Function] as PropType<readonly AnyRow[] | (() => readonly AnyRow[] | Promise<readonly AnyRow[]>)>, required: true },\n    keyField: { type: String, required: true },\n    parentField: String,\n    childrenField: String,\n    treeField: String,\n    columns: { type: Array as PropType<readonly GridColumn<AnyRow>[]>, required: true },\n    expandedKeys: { type: Array as PropType<readonly Key[]>, default: () => [] },\n    height: String,\n    selectionMode: String as PropType<'none' | 'single' | 'multiple'>,\n    locale: String,\n    messages: Object as PropType<Partial<Messages>>,\n    theme: String as PropType<'light' | 'dark'>,\n    density: String as PropType<'compact' | 'normal' | 'comfortable'>,\n  },\n  emits: {\n    'update:expandedKeys': (keys: readonly Key[]) => Array.isArray(keys),\n    rowClick: (payload: GridEvents<AnyRow>['rowClick']) => payload !== undefined,\n    rowDblClick: (payload: GridEvents<AnyRow>['rowDblClick']) => payload !== undefined,\n    focusedRowChange: (payload: GridEvents<AnyRow>['focusedRowChange']) => payload !== undefined,\n    selectionChange: (selection: SelectionState) => selection !== undefined,\n  },\n  setup(props, { emit, expose }) {\n    const host: Ref<HTMLElement | null> = ref(null);\n    let tree: TreeList<AnyRow> | null = null;\n    let unsubscribe: (() => void) | null = null;\n\n    const create = (): void => {\n      if (!host.value) return;\n      const expanded: readonly Key[] = tree ? tree.getExpandedKeys() : toRaw(props.expandedKeys);\n      destroy();\n      tree = createTreeList<AnyRow>(host.value, {\n        // Read on every load, so a refresh sees the latest rows prop.\n        rows: () => {\n          const rows = toRaw(props.rows);\n          return typeof rows === 'function' ? rows() : rows;\n        },\n        keyField: props.keyField,\n        columns: toRaw(props.columns),\n        expandedKeys: expanded,\n        onExpandedChange: keys => emit('update:expandedKeys', keys),\n        ...(props.parentField ? { parentField: props.parentField } : {}),\n        ...(props.childrenField ? { childrenField: props.childrenField } : {}),\n        ...(props.treeField ? { treeField: props.treeField } : {}),\n        ...(props.height ? { height: props.height } : {}),\n        ...(props.selectionMode ? { selectionMode: props.selectionMode } : {}),\n        ...(props.locale ? { locale: props.locale } : {}),\n        ...(props.messages ? { messages: props.messages } : {}),\n        ...(props.theme ? { theme: props.theme } : {}),\n        ...(props.density ? { density: props.density } : {}),\n      });\n      tree.grid.on('rowClick', payload => emit('rowClick', payload));\n      tree.grid.on('rowDblClick', payload => emit('rowDblClick', payload));\n      tree.grid.on('focusedRowChange', payload => emit('focusedRowChange', payload));\n      let selection: SelectionState = tree.store.getSnapshot().state.selection;\n      unsubscribe = tree.store.subscribe(snapshot => {\n        if (snapshot.state.selection === selection) return;\n        selection = snapshot.state.selection;\n        emit('selectionChange', selection);\n      });\n    };\n\n    const destroy = (): void => {\n      unsubscribe?.();\n      unsubscribe = null;\n      tree?.destroy();\n      tree = null;\n    };\n\n    expose({\n      expand: (key: Key) => tree?.expand(key),\n      collapse: (key: Key) => tree?.collapse(key),\n      expandAll: () => tree?.expandAll(),\n      collapseAll: () => tree?.collapseAll(),\n      refresh: () => tree?.refresh(),\n      get store(): GridStore<AnyRow> | null {\n        return tree?.store ?? null;\n      },\n    });\n\n    onMounted(create);\n    onBeforeUnmount(destroy);\n    watch(\n      () => props.rows,\n      () => void tree?.refresh(),\n    );\n    // v-model: its own keys coming back change nothing; other keys replace the expansion.\n    watch(\n      () => props.expandedKeys,\n      keys => {\n        if (!tree || sameKeys(toRaw(keys), tree.getExpandedKeys())) return;\n        tree.source.collapseAll();\n        toRaw(keys).forEach(key => tree!.source.setExpanded(key, true));\n        void tree.store.reload();\n      },\n    );\n    watch(() => [props.columns, props.keyField, props.parentField, props.childrenField, props.treeField, props.height, props.selectionMode, props.locale, props.messages, props.theme, props.density], create);\n\n    return () => h('div', { ref: host, class: 'rs-vue-tree-list' });\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEA,uBAA+B;AAE/B,iBAAkF;AAMlF,IAAM,WAAW,CAAC,GAAmB,MAA+B,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,KAAK,MAAM,OAAO,GAAG,MAAM,OAAO,EAAE,CAAC,CAAC,CAAC;AAGtI,IAAM,iBAAa,4BAAgB;AAAA,EACxC,MAAM;AAAA,EACN,OAAO;AAAA;AAAA,IAEL,MAAM,EAAE,MAAM,CAAC,OAAO,QAAQ,GAA2F,UAAU,KAAK;AAAA,IACxI,UAAU,EAAE,MAAM,QAAQ,UAAU,KAAK;AAAA,IACzC,aAAa;AAAA,IACb,eAAe;AAAA,IACf,WAAW;AAAA,IACX,SAAS,EAAE,MAAM,OAAkD,UAAU,KAAK;AAAA,IAClF,cAAc,EAAE,MAAM,OAAmC,SAAS,MAAM,CAAC,EAAE;AAAA,IAC3E,QAAQ;AAAA,IACR,eAAe;AAAA,IACf,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,OAAO;AAAA,IACP,SAAS;AAAA,EACX;AAAA,EACA,OAAO;AAAA,IACL,uBAAuB,CAAC,SAAyB,MAAM,QAAQ,IAAI;AAAA,IACnE,UAAU,CAAC,YAA4C,YAAY;AAAA,IACnE,aAAa,CAAC,YAA+C,YAAY;AAAA,IACzE,kBAAkB,CAAC,YAAoD,YAAY;AAAA,IACnF,iBAAiB,CAAC,cAA8B,cAAc;AAAA,EAChE;AAAA,EACA,MAAM,OAAO,EAAE,MAAM,OAAO,GAAG;AAC7B,UAAM,WAAgC,gBAAI,IAAI;AAC9C,QAAI,OAAgC;AACpC,QAAI,cAAmC;AAEvC,UAAM,SAAS,MAAY;AACzB,UAAI,CAAC,KAAK,MAAO;AACjB,YAAM,WAA2B,OAAO,KAAK,gBAAgB,QAAI,kBAAM,MAAM,YAAY;AACzF,cAAQ;AACR,iBAAO,iCAAuB,KAAK,OAAO;AAAA;AAAA,QAExC,MAAM,MAAM;AACV,gBAAM,WAAO,kBAAM,MAAM,IAAI;AAC7B,iBAAO,OAAO,SAAS,aAAa,KAAK,IAAI;AAAA,QAC/C;AAAA,QACA,UAAU,MAAM;AAAA,QAChB,aAAS,kBAAM,MAAM,OAAO;AAAA,QAC5B,cAAc;AAAA,QACd,kBAAkB,UAAQ,KAAK,uBAAuB,IAAI;AAAA,QAC1D,GAAI,MAAM,cAAc,EAAE,aAAa,MAAM,YAAY,IAAI,CAAC;AAAA,QAC9D,GAAI,MAAM,gBAAgB,EAAE,eAAe,MAAM,cAAc,IAAI,CAAC;AAAA,QACpE,GAAI,MAAM,YAAY,EAAE,WAAW,MAAM,UAAU,IAAI,CAAC;AAAA,QACxD,GAAI,MAAM,SAAS,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC;AAAA,QAC/C,GAAI,MAAM,gBAAgB,EAAE,eAAe,MAAM,cAAc,IAAI,CAAC;AAAA,QACpE,GAAI,MAAM,SAAS,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC;AAAA,QAC/C,GAAI,MAAM,WAAW,EAAE,UAAU,MAAM,SAAS,IAAI,CAAC;AAAA,QACrD,GAAI,MAAM,QAAQ,EAAE,OAAO,MAAM,MAAM,IAAI,CAAC;AAAA,QAC5C,GAAI,MAAM,UAAU,EAAE,SAAS,MAAM,QAAQ,IAAI,CAAC;AAAA,MACpD,CAAC;AACD,WAAK,KAAK,GAAG,YAAY,aAAW,KAAK,YAAY,OAAO,CAAC;AAC7D,WAAK,KAAK,GAAG,eAAe,aAAW,KAAK,eAAe,OAAO,CAAC;AACnE,WAAK,KAAK,GAAG,oBAAoB,aAAW,KAAK,oBAAoB,OAAO,CAAC;AAC7E,UAAI,YAA4B,KAAK,MAAM,YAAY,EAAE,MAAM;AAC/D,oBAAc,KAAK,MAAM,UAAU,cAAY;AAC7C,YAAI,SAAS,MAAM,cAAc,UAAW;AAC5C,oBAAY,SAAS,MAAM;AAC3B,aAAK,mBAAmB,SAAS;AAAA,MACnC,CAAC;AAAA,IACH;AAEA,UAAM,UAAU,MAAY;AAC1B,oBAAc;AACd,oBAAc;AACd,YAAM,QAAQ;AACd,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,MACL,QAAQ,CAAC,QAAa,MAAM,OAAO,GAAG;AAAA,MACtC,UAAU,CAAC,QAAa,MAAM,SAAS,GAAG;AAAA,MAC1C,WAAW,MAAM,MAAM,UAAU;AAAA,MACjC,aAAa,MAAM,MAAM,YAAY;AAAA,MACrC,SAAS,MAAM,MAAM,QAAQ;AAAA,MAC7B,IAAI,QAAkC;AACpC,eAAO,MAAM,SAAS;AAAA,MACxB;AAAA,IACF,CAAC;AAED,8BAAU,MAAM;AAChB,oCAAgB,OAAO;AACvB;AAAA,MACE,MAAM,MAAM;AAAA,MACZ,MAAM,KAAK,MAAM,QAAQ;AAAA,IAC3B;AAEA;AAAA,MACE,MAAM,MAAM;AAAA,MACZ,UAAQ;AACN,YAAI,CAAC,QAAQ,aAAS,kBAAM,IAAI,GAAG,KAAK,gBAAgB,CAAC,EAAG;AAC5D,aAAK,OAAO,YAAY;AACxB,8BAAM,IAAI,EAAE,QAAQ,SAAO,KAAM,OAAO,YAAY,KAAK,IAAI,CAAC;AAC9D,aAAK,KAAK,MAAM,OAAO;AAAA,MACzB;AAAA,IACF;AACA,0BAAM,MAAM,CAAC,MAAM,SAAS,MAAM,UAAU,MAAM,aAAa,MAAM,eAAe,MAAM,WAAW,MAAM,QAAQ,MAAM,eAAe,MAAM,QAAQ,MAAM,UAAU,MAAM,OAAO,MAAM,OAAO,GAAG,MAAM;AAEzM,WAAO,UAAM,cAAE,OAAO,EAAE,KAAK,MAAM,OAAO,mBAAmB,CAAC;AAAA,EAChE;AACF,CAAC;","names":[]}

package/dist/tree-list.d.cts

@@ -0,0 +1,91 @@
+import * as vue from 'vue';
+import { PropType } from 'vue';
+import { Key, SelectionState } from '@rastr/core';
+import { GridColumn, Messages, GridEvents } from '@rastr/grid';
+
+type AnyRow = any;
+/** Tree list: hierarchical rows (parentField or childrenField) with v-model:expandedKeys. */
+declare const RsTreeList: vue.DefineComponent<vue.ExtractPropTypes<{
+    /** The rows; a new array (reference) refreshes the tree. */
+    rows: {
+        type: PropType<readonly AnyRow[] | (() => readonly AnyRow[] | Promise<readonly AnyRow[]>)>;
+        required: true;
+    };
+    keyField: {
+        type: StringConstructor;
+        required: true;
+    };
+    parentField: StringConstructor;
+    childrenField: StringConstructor;
+    treeField: StringConstructor;
+    columns: {
+        type: PropType<readonly GridColumn<AnyRow>[]>;
+        required: true;
+    };
+    expandedKeys: {
+        type: PropType<readonly Key[]>;
+        default: () => never[];
+    };
+    height: StringConstructor;
+    selectionMode: PropType<"none" | "single" | "multiple">;
+    locale: StringConstructor;
+    messages: PropType<Partial<Messages>>;
+    theme: PropType<"light" | "dark">;
+    density: PropType<"compact" | "normal" | "comfortable">;
+}>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+    'update:expandedKeys': (keys: readonly Key[]) => keys is any[];
+    rowClick: (payload: GridEvents<AnyRow>["rowClick"]) => boolean;
+    rowDblClick: (payload: GridEvents<AnyRow>["rowDblClick"]) => boolean;
+    focusedRowChange: (payload: GridEvents<AnyRow>["focusedRowChange"]) => boolean;
+    selectionChange: (selection: SelectionState) => boolean;
+}, string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+    /** The rows; a new array (reference) refreshes the tree. */
+    rows: {
+        type: PropType<readonly AnyRow[] | (() => readonly AnyRow[] | Promise<readonly AnyRow[]>)>;
+        required: true;
+    };
+    keyField: {
+        type: StringConstructor;
+        required: true;
+    };
+    parentField: StringConstructor;
+    childrenField: StringConstructor;
+    treeField: StringConstructor;
+    columns: {
+        type: PropType<readonly GridColumn<AnyRow>[]>;
+        required: true;
+    };
+    expandedKeys: {
+        type: PropType<readonly Key[]>;
+        default: () => never[];
+    };
+    height: StringConstructor;
+    selectionMode: PropType<"none" | "single" | "multiple">;
+    locale: StringConstructor;
+    messages: PropType<Partial<Messages>>;
+    theme: PropType<"light" | "dark">;
+    density: PropType<"compact" | "normal" | "comfortable">;
+}>> & Readonly<{
+    onRowClick?: (payload: {
+        readonly row: any;
+        readonly key: Key;
+        readonly event: MouseEvent;
+    }) => any;
+    onRowDblClick?: (payload: {
+        readonly row: any;
+        readonly key: Key;
+        readonly event: MouseEvent;
+    }) => any;
+    onFocusedRowChange?: (payload: {
+        readonly row: any;
+        readonly key: Key | null;
+    }) => any;
+    "onUpdate:expandedKeys"?: (keys: readonly Key[]) => any;
+    onSelectionChange?: (selection: SelectionState) => any;
+}>, {
+    expandedKeys: readonly Key[];
+}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
+
+export { RsTreeList };

package/dist/tree-list.d.ts

@@ -0,0 +1,91 @@
+import * as vue from 'vue';
+import { PropType } from 'vue';
+import { Key, SelectionState } from '@rastr/core';
+import { GridColumn, Messages, GridEvents } from '@rastr/grid';
+
+type AnyRow = any;
+/** Tree list: hierarchical rows (parentField or childrenField) with v-model:expandedKeys. */
+declare const RsTreeList: vue.DefineComponent<vue.ExtractPropTypes<{
+    /** The rows; a new array (reference) refreshes the tree. */
+    rows: {
+        type: PropType<readonly AnyRow[] | (() => readonly AnyRow[] | Promise<readonly AnyRow[]>)>;
+        required: true;
+    };
+    keyField: {
+        type: StringConstructor;
+        required: true;
+    };
+    parentField: StringConstructor;
+    childrenField: StringConstructor;
+    treeField: StringConstructor;
+    columns: {
+        type: PropType<readonly GridColumn<AnyRow>[]>;
+        required: true;
+    };
+    expandedKeys: {
+        type: PropType<readonly Key[]>;
+        default: () => never[];
+    };
+    height: StringConstructor;
+    selectionMode: PropType<"none" | "single" | "multiple">;
+    locale: StringConstructor;
+    messages: PropType<Partial<Messages>>;
+    theme: PropType<"light" | "dark">;
+    density: PropType<"compact" | "normal" | "comfortable">;
+}>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+    'update:expandedKeys': (keys: readonly Key[]) => keys is any[];
+    rowClick: (payload: GridEvents<AnyRow>["rowClick"]) => boolean;
+    rowDblClick: (payload: GridEvents<AnyRow>["rowDblClick"]) => boolean;
+    focusedRowChange: (payload: GridEvents<AnyRow>["focusedRowChange"]) => boolean;
+    selectionChange: (selection: SelectionState) => boolean;
+}, string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+    /** The rows; a new array (reference) refreshes the tree. */
+    rows: {
+        type: PropType<readonly AnyRow[] | (() => readonly AnyRow[] | Promise<readonly AnyRow[]>)>;
+        required: true;
+    };
+    keyField: {
+        type: StringConstructor;
+        required: true;
+    };
+    parentField: StringConstructor;
+    childrenField: StringConstructor;
+    treeField: StringConstructor;
+    columns: {
+        type: PropType<readonly GridColumn<AnyRow>[]>;
+        required: true;
+    };
+    expandedKeys: {
+        type: PropType<readonly Key[]>;
+        default: () => never[];
+    };
+    height: StringConstructor;
+    selectionMode: PropType<"none" | "single" | "multiple">;
+    locale: StringConstructor;
+    messages: PropType<Partial<Messages>>;
+    theme: PropType<"light" | "dark">;
+    density: PropType<"compact" | "normal" | "comfortable">;
+}>> & Readonly<{
+    onRowClick?: (payload: {
+        readonly row: any;
+        readonly key: Key;
+        readonly event: MouseEvent;
+    }) => any;
+    onRowDblClick?: (payload: {
+        readonly row: any;
+        readonly key: Key;
+        readonly event: MouseEvent;
+    }) => any;
+    onFocusedRowChange?: (payload: {
+        readonly row: any;
+        readonly key: Key | null;
+    }) => any;
+    "onUpdate:expandedKeys"?: (keys: readonly Key[]) => any;
+    onSelectionChange?: (selection: SelectionState) => any;
+}>, {
+    expandedKeys: readonly Key[];
+}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
+
+export { RsTreeList };

package/dist/tree-list.js

@@ -0,0 +1,106 @@
+// src/tree-list/RsTreeList.ts
+import { createTreeList } from "@rastr/tree-list";
+import { defineComponent, h, onBeforeUnmount, onMounted, ref, toRaw, watch } from "vue";
+var sameKeys = (a, b) => a.length === b.length && a.every((key, i) => String(key) === String(b[i]));
+var RsTreeList = defineComponent({
+  name: "RsTreeList",
+  props: {
+    /** The rows; a new array (reference) refreshes the tree. */
+    rows: { type: [Array, Function], required: true },
+    keyField: { type: String, required: true },
+    parentField: String,
+    childrenField: String,
+    treeField: String,
+    columns: { type: Array, required: true },
+    expandedKeys: { type: Array, default: () => [] },
+    height: String,
+    selectionMode: String,
+    locale: String,
+    messages: Object,
+    theme: String,
+    density: String
+  },
+  emits: {
+    "update:expandedKeys": (keys) => Array.isArray(keys),
+    rowClick: (payload) => payload !== void 0,
+    rowDblClick: (payload) => payload !== void 0,
+    focusedRowChange: (payload) => payload !== void 0,
+    selectionChange: (selection) => selection !== void 0
+  },
+  setup(props, { emit, expose }) {
+    const host = ref(null);
+    let tree = null;
+    let unsubscribe = null;
+    const create = () => {
+      if (!host.value) return;
+      const expanded = tree ? tree.getExpandedKeys() : toRaw(props.expandedKeys);
+      destroy();
+      tree = createTreeList(host.value, {
+        // Read on every load, so a refresh sees the latest rows prop.
+        rows: () => {
+          const rows = toRaw(props.rows);
+          return typeof rows === "function" ? rows() : rows;
+        },
+        keyField: props.keyField,
+        columns: toRaw(props.columns),
+        expandedKeys: expanded,
+        onExpandedChange: (keys) => emit("update:expandedKeys", keys),
+        ...props.parentField ? { parentField: props.parentField } : {},
+        ...props.childrenField ? { childrenField: props.childrenField } : {},
+        ...props.treeField ? { treeField: props.treeField } : {},
+        ...props.height ? { height: props.height } : {},
+        ...props.selectionMode ? { selectionMode: props.selectionMode } : {},
+        ...props.locale ? { locale: props.locale } : {},
+        ...props.messages ? { messages: props.messages } : {},
+        ...props.theme ? { theme: props.theme } : {},
+        ...props.density ? { density: props.density } : {}
+      });
+      tree.grid.on("rowClick", (payload) => emit("rowClick", payload));
+      tree.grid.on("rowDblClick", (payload) => emit("rowDblClick", payload));
+      tree.grid.on("focusedRowChange", (payload) => emit("focusedRowChange", payload));
+      let selection = tree.store.getSnapshot().state.selection;
+      unsubscribe = tree.store.subscribe((snapshot) => {
+        if (snapshot.state.selection === selection) return;
+        selection = snapshot.state.selection;
+        emit("selectionChange", selection);
+      });
+    };
+    const destroy = () => {
+      unsubscribe?.();
+      unsubscribe = null;
+      tree?.destroy();
+      tree = null;
+    };
+    expose({
+      expand: (key) => tree?.expand(key),
+      collapse: (key) => tree?.collapse(key),
+      expandAll: () => tree?.expandAll(),
+      collapseAll: () => tree?.collapseAll(),
+      refresh: () => tree?.refresh(),
+      get store() {
+        return tree?.store ?? null;
+      }
+    });
+    onMounted(create);
+    onBeforeUnmount(destroy);
+    watch(
+      () => props.rows,
+      () => void tree?.refresh()
+    );
+    watch(
+      () => props.expandedKeys,
+      (keys) => {
+        if (!tree || sameKeys(toRaw(keys), tree.getExpandedKeys())) return;
+        tree.source.collapseAll();
+        toRaw(keys).forEach((key) => tree.source.setExpanded(key, true));
+        void tree.store.reload();
+      }
+    );
+    watch(() => [props.columns, props.keyField, props.parentField, props.childrenField, props.treeField, props.height, props.selectionMode, props.locale, props.messages, props.theme, props.density], create);
+    return () => h("div", { ref: host, class: "rs-vue-tree-list" });
+  }
+});
+export {
+  RsTreeList
+};
+//# sourceMappingURL=tree-list.js.map

package/dist/tree-list.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tree-list/RsTreeList.ts"],"sourcesContent":["import type { GridStore, Key, SelectionState } from '@rastr/core';\nimport type { GridColumn, GridEvents, Messages } from '@rastr/grid';\nimport { createTreeList } from '@rastr/tree-list';\nimport type { TreeList } from '@rastr/tree-list';\nimport { defineComponent, h, onBeforeUnmount, onMounted, ref, toRaw, watch } from 'vue';\nimport type { PropType, Ref } from 'vue';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyRow = any;\n\nconst sameKeys = (a: readonly Key[], b: readonly Key[]): boolean => a.length === b.length && a.every((key, i) => String(key) === String(b[i]));\n\n/** Tree list: hierarchical rows (parentField or childrenField) with v-model:expandedKeys. */\nexport const RsTreeList = defineComponent({\n  name: 'RsTreeList',\n  props: {\n    /** The rows; a new array (reference) refreshes the tree. */\n    rows: { type: [Array, Function] as PropType<readonly AnyRow[] | (() => readonly AnyRow[] | Promise<readonly AnyRow[]>)>, required: true },\n    keyField: { type: String, required: true },\n    parentField: String,\n    childrenField: String,\n    treeField: String,\n    columns: { type: Array as PropType<readonly GridColumn<AnyRow>[]>, required: true },\n    expandedKeys: { type: Array as PropType<readonly Key[]>, default: () => [] },\n    height: String,\n    selectionMode: String as PropType<'none' | 'single' | 'multiple'>,\n    locale: String,\n    messages: Object as PropType<Partial<Messages>>,\n    theme: String as PropType<'light' | 'dark'>,\n    density: String as PropType<'compact' | 'normal' | 'comfortable'>,\n  },\n  emits: {\n    'update:expandedKeys': (keys: readonly Key[]) => Array.isArray(keys),\n    rowClick: (payload: GridEvents<AnyRow>['rowClick']) => payload !== undefined,\n    rowDblClick: (payload: GridEvents<AnyRow>['rowDblClick']) => payload !== undefined,\n    focusedRowChange: (payload: GridEvents<AnyRow>['focusedRowChange']) => payload !== undefined,\n    selectionChange: (selection: SelectionState) => selection !== undefined,\n  },\n  setup(props, { emit, expose }) {\n    const host: Ref<HTMLElement | null> = ref(null);\n    let tree: TreeList<AnyRow> | null = null;\n    let unsubscribe: (() => void) | null = null;\n\n    const create = (): void => {\n      if (!host.value) return;\n      const expanded: readonly Key[] = tree ? tree.getExpandedKeys() : toRaw(props.expandedKeys);\n      destroy();\n      tree = createTreeList<AnyRow>(host.value, {\n        // Read on every load, so a refresh sees the latest rows prop.\n        rows: () => {\n          const rows = toRaw(props.rows);\n          return typeof rows === 'function' ? rows() : rows;\n        },\n        keyField: props.keyField,\n        columns: toRaw(props.columns),\n        expandedKeys: expanded,\n        onExpandedChange: keys => emit('update:expandedKeys', keys),\n        ...(props.parentField ? { parentField: props.parentField } : {}),\n        ...(props.childrenField ? { childrenField: props.childrenField } : {}),\n        ...(props.treeField ? { treeField: props.treeField } : {}),\n        ...(props.height ? { height: props.height } : {}),\n        ...(props.selectionMode ? { selectionMode: props.selectionMode } : {}),\n        ...(props.locale ? { locale: props.locale } : {}),\n        ...(props.messages ? { messages: props.messages } : {}),\n        ...(props.theme ? { theme: props.theme } : {}),\n        ...(props.density ? { density: props.density } : {}),\n      });\n      tree.grid.on('rowClick', payload => emit('rowClick', payload));\n      tree.grid.on('rowDblClick', payload => emit('rowDblClick', payload));\n      tree.grid.on('focusedRowChange', payload => emit('focusedRowChange', payload));\n      let selection: SelectionState = tree.store.getSnapshot().state.selection;\n      unsubscribe = tree.store.subscribe(snapshot => {\n        if (snapshot.state.selection === selection) return;\n        selection = snapshot.state.selection;\n        emit('selectionChange', selection);\n      });\n    };\n\n    const destroy = (): void => {\n      unsubscribe?.();\n      unsubscribe = null;\n      tree?.destroy();\n      tree = null;\n    };\n\n    expose({\n      expand: (key: Key) => tree?.expand(key),\n      collapse: (key: Key) => tree?.collapse(key),\n      expandAll: () => tree?.expandAll(),\n      collapseAll: () => tree?.collapseAll(),\n      refresh: () => tree?.refresh(),\n      get store(): GridStore<AnyRow> | null {\n        return tree?.store ?? null;\n      },\n    });\n\n    onMounted(create);\n    onBeforeUnmount(destroy);\n    watch(\n      () => props.rows,\n      () => void tree?.refresh(),\n    );\n    // v-model: its own keys coming back change nothing; other keys replace the expansion.\n    watch(\n      () => props.expandedKeys,\n      keys => {\n        if (!tree || sameKeys(toRaw(keys), tree.getExpandedKeys())) return;\n        tree.source.collapseAll();\n        toRaw(keys).forEach(key => tree!.source.setExpanded(key, true));\n        void tree.store.reload();\n      },\n    );\n    watch(() => [props.columns, props.keyField, props.parentField, props.childrenField, props.treeField, props.height, props.selectionMode, props.locale, props.messages, props.theme, props.density], create);\n\n    return () => h('div', { ref: host, class: 'rs-vue-tree-list' });\n  },\n});\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,99 @@
 {
   "name": "@rastr/vue",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0-beta.1",
+  "description": "Vue 3 components for the Rastr data grid.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./pdf-designer": {
+      "import": {
+        "types": "./dist/pdf-designer.d.ts",
+        "default": "./dist/pdf-designer.js"
+      },
+      "require": {
+        "types": "./dist/pdf-designer.d.cts",
+        "default": "./dist/pdf-designer.cjs"
+      }
+    },
+    "./tree-list": {
+      "import": {
+        "types": "./dist/tree-list.d.ts",
+        "default": "./dist/tree-list.js"
+      },
+      "require": {
+        "types": "./dist/tree-list.d.cts",
+        "default": "./dist/tree-list.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "vue": "^3.3.0",
+    "@rastr/pdf-designer": "0.1.0-beta.1",
+    "@rastr/export-pdf": "0.1.0-beta.1",
+    "@rastr/pdf-template": "0.1.0-beta.1",
+    "@rastr/tree-list": "0.1.0-beta.1"
+  },
+  "dependencies": {
+    "@rastr/core": "0.1.0-beta.1",
+    "@rastr/grid": "0.1.0-beta.1",
+    "@rastr/filter-builder": "0.1.0-beta.1",
+    "@rastr/controls": "0.1.0-beta.1"
+  },
+  "devDependencies": {
+    "@playwright/test": "1.48.2",
+    "@types/node": "^22",
+    "@vitejs/plugin-vue": "^5",
+    "@vue/test-utils": "^2.4",
+    "jsdom": "^25",
+    "tsup": "^8",
+    "vite": "^5",
+    "vitest": "^2",
+    "vue": "^3.5",
+    "@rastr/export-pdf": "0.1.0-beta.1",
+    "@rastr/pdf-template": "0.1.0-beta.1",
+    "@rastr/pdf-designer": "0.1.0-beta.1",
+    "@rastr/tree-list": "0.1.0-beta.1"
+  },
+  "peerDependenciesMeta": {
+    "@rastr/pdf-designer": {
+      "optional": true
+    },
+    "@rastr/export-pdf": {
+      "optional": true
+    },
+    "@rastr/pdf-template": {
+      "optional": true
+    },
+    "@rastr/tree-list": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "lint": "eslint src test e2e",
+    "typecheck": "tsc --noEmit",
+    "dev": "vite --config vite.config.ts",
+    "e2e": "playwright test --workers=1"
+  }
 }