@polyxd/core 0.3.0

package/dist/tree.js

@@ -0,0 +1,93 @@
+/** Tree: the open part of a hierarchy flattened into rows, and the moves between them. */
+import { absolute, asList, childPointer, get } from "./data.js";
+/** Beyond this many visible rows the tree renders only the rows in (and just around) its viewport. */
+export const VIRTUAL_LIMIT = 200;
+/** Rows rendered above and below the viewport so keyboard moves and quick scrolls don't flash blank. */
+export const OVERSCAN = 10;
+/** Type-ahead resets after this pause. */
+export const TYPEAHEAD_MS = 500;
+const asText = (v) => (v === undefined || v === null ? "" : String(v));
+/** Flatten the open part of the hierarchy, depth first. Without an expanded set, the first level is open. */
+export function treeRows(node, data, scope, expanded) {
+    const rows = [];
+    const indexByKey = new Map();
+    const topValues = [];
+    const isExpanded = (value, level) => (expanded ? expanded.has(value) : level === 1);
+    const walk = (list, pointer, level, parent) => {
+        list.forEach((_, i) => {
+            const s = { pointer: childPointer(pointer, i) };
+            const label = asText(get(data, absolute(node.labelPath, s)));
+            const rawValue = node.valuePath ? get(data, absolute(node.valuePath, s)) : label;
+            const value = rawValue === undefined || rawValue === null ? label || s.pointer : rawValue;
+            const detailRaw = node.detailPath ? get(data, absolute(node.detailPath, s)) : undefined;
+            const detail = detailRaw === undefined || detailRaw === null || detailRaw === "" ? undefined : String(detailRaw);
+            const children = asList(get(data, absolute(node.childrenPath, s)));
+            if (level === 1)
+                topValues.push(value);
+            const hasChildren = children.length > 0;
+            const open = hasChildren && isExpanded(value, level);
+            const index = rows.length;
+            indexByKey.set(s.pointer, index);
+            rows.push({ key: s.pointer, scope: s, level, setsize: list.length, posinset: i + 1, label, value, detail, hasChildren, expanded: open, parent });
+            if (open)
+                walk(children, absolute(node.childrenPath, s), level + 1, index);
+        });
+    };
+    const itemsPointer = absolute(node.items.path, scope);
+    walk(asList(get(data, itemsPointer)), itemsPointer, 1, -1);
+    return { rows, indexByKey, topValues };
+}
+/** Type-ahead: the next row whose label starts with what was typed; the same letter repeated cycles. */
+export function typeAheadTarget(rows, from, buffer) {
+    const find = (prefix) => {
+        for (let step = 1; step <= rows.length; step++) {
+            const j = (from + step) % rows.length;
+            if (rows[j].label.toLowerCase().startsWith(prefix))
+                return j;
+        }
+        return -1;
+    };
+    const single = buffer.length > 1 && [...buffer].every((c) => c === buffer[0]);
+    let j = single ? find(buffer[0]) : find(buffer);
+    if (j < 0 && buffer.length > 1)
+        j = find(buffer[0]);
+    return j;
+}
+export function treeKey(rows, index, e) {
+    const row = rows[index];
+    if (!row)
+        return undefined;
+    switch (e.key) {
+        case "ArrowDown":
+            return { focus: Math.min(rows.length - 1, index + 1) };
+        case "ArrowUp":
+            return { focus: Math.max(0, index - 1) };
+        case "ArrowRight":
+            if (row.hasChildren && !row.expanded)
+                return { toggle: true };
+            return row.expanded ? { focus: Math.min(rows.length - 1, index + 1) } : undefined;
+        case "ArrowLeft":
+            if (row.expanded)
+                return { toggle: true };
+            return row.parent >= 0 ? { focus: row.parent } : undefined;
+        case "Home":
+            return { focus: 0 };
+        case "End":
+            return { focus: rows.length - 1 };
+        case "Enter":
+            return { activate: true };
+        case " ":
+            return { select: true };
+        case "*":
+            return { expandSiblings: true };
+        default:
+            return e.key.length === 1 && !e.ctrlKey && !e.metaKey && !e.altKey ? { typeAhead: e.key } : undefined;
+    }
+}
+/** The window of rows to draw when virtualised. */
+export function visibleWindow(rowCount, scrollTop, rowHeight, viewportHeight) {
+    if (rowCount <= VIRTUAL_LIMIT)
+        return { start: 0, end: rowCount };
+    return { start: Math.max(0, Math.floor(scrollTop / rowHeight) - OVERSCAN), end: Math.min(rowCount, Math.ceil((scrollTop + viewportHeight) / rowHeight) + OVERSCAN) };
+}
+//# sourceMappingURL=tree.js.map

package/dist/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":"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"}

package/dist/views.d.ts

@@ -0,0 +1,11 @@
+/** Views (tabs): which view shows. Bound to data when the document says; local otherwise. */
+export interface View {
+    key: string;
+    label?: unknown;
+    count?: unknown;
+    content?: string;
+}
+/** The selected view: the binding's value when it names a view, else the local choice, else the first. */
+export declare function selectedView(views: View[], bound: unknown, local: string | undefined): string;
+/** Selecting a view: a bound Views writes the key; an unbound one keeps it locally. */
+export declare const viewsReducer: (_current: string, key: string) => string;

package/dist/views.js

@@ -0,0 +1,10 @@
+/** Views (tabs): which view shows. Bound to data when the document says; local otherwise. */
+/** The selected view: the binding's value when it names a view, else the local choice, else the first. */
+export function selectedView(views, bound, local) {
+    if (typeof bound === "string" && bound)
+        return bound;
+    return local ?? views[0]?.key;
+}
+/** Selecting a view: a bound Views writes the key; an unbound one keeps it locally. */
+export const viewsReducer = (_current, key) => key;
+//# sourceMappingURL=views.js.map

package/dist/views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.js","sourceRoot":"","sources":["../src/views.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAS7F,0GAA0G;AAC1G,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,KAAc,EAAE,KAAyB;IACnF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACrD,OAAO,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;AAChC,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAgB,EAAE,GAAW,EAAU,EAAE,CAAC,GAAG,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@polyxd/core",
+  "version": "0.3.0",
+  "description": "The framework-free heart of Polyxd rendering: document types, JSON Pointer bindings, localised formatting, the renderer's decisions, and a headless surface model every renderer walks the same way",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "test": "node --test \"test/**/*.test.ts\""
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/visualfart/polyxd.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://polyxd.com",
+  "bugs": "https://github.com/visualfart/polyxd/issues",
+  "publishConfig": {
+    "access": "public"
+  }
+}