@xenolithengine/graph-core 0.7.0-beta.0

package/dist/widget.js

@@ -0,0 +1,112 @@
+export function comboOptions(spec) {
+    return spec.values.map((o) => typeof o === 'object' ? { label: o.label, value: o.value } : { label: o, value: o });
+}
+export function defaultWidgetValue(spec) {
+    switch (spec.type) {
+        case 'number': return spec.min ?? 0;
+        case 'slider': return spec.min;
+        case 'combo': return comboOptions(spec)[0]?.value;
+        case 'text': return '';
+        case 'toggle': return false;
+        case 'color': return '#6c8ebf';
+        case 'button':
+        case 'custom': return undefined;
+    }
+}
+const HEX_RE = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/;
+/** Normalise a colour to a 6-digit lowercase hex (`#rrggbb`), expanding 3-digit shorthand. */
+function normalizeHex(raw) {
+    if (typeof raw !== 'string')
+        return null;
+    const s = raw.trim();
+    if (!HEX_RE.test(s))
+        return null;
+    const body = s.slice(1);
+    const full = body.length === 3 ? body.split('').map((ch) => ch + ch).join('') : body;
+    return `#${full.toLowerCase()}`;
+}
+function quantize(value, min, step) {
+    const snapped = min + Math.round((value - min) / step) * step;
+    // Kill floating-point dust from the multiply (e.g. 0.30000000000000004).
+    return Number(snapped.toFixed(10));
+}
+export function clampWidgetValue(spec, raw) {
+    switch (spec.type) {
+        case 'number': {
+            let v = typeof raw === 'number' ? raw : Number(raw);
+            if (!Number.isFinite(v))
+                return defaultWidgetValue(spec);
+            const min = spec.min ?? -Infinity;
+            const max = spec.max ?? Infinity;
+            v = Math.min(max, Math.max(min, v));
+            if (spec.step && spec.step > 0)
+                v = Math.min(max, Math.max(min, quantize(v, Number.isFinite(min) ? min : 0, spec.step)));
+            if (spec.precision !== undefined)
+                v = Number(v.toFixed(spec.precision));
+            return v;
+        }
+        case 'slider': {
+            let v = typeof raw === 'number' ? raw : Number(raw);
+            if (!Number.isFinite(v))
+                return defaultWidgetValue(spec);
+            v = Math.min(spec.max, Math.max(spec.min, v));
+            if (spec.step && spec.step > 0)
+                v = Math.min(spec.max, Math.max(spec.min, quantize(v, spec.min, spec.step)));
+            return v;
+        }
+        case 'combo': {
+            const opts = comboOptions(spec);
+            return opts.some((o) => o.value === raw) ? raw : opts[0]?.value;
+        }
+        case 'text': {
+            let s = String(raw ?? '');
+            if (spec.maxLength !== undefined)
+                s = s.slice(0, spec.maxLength);
+            return s;
+        }
+        case 'toggle':
+            return Boolean(raw);
+        case 'color':
+            return normalizeHex(raw) ?? defaultWidgetValue(spec);
+        case 'button':
+            return undefined;
+        case 'custom':
+            return raw;
+    }
+}
+/** Current value of a widget on a node: the clamped `node.state[key]`, or its default. */
+export function widgetValue(node, spec) {
+    if (spec.key === undefined)
+        return defaultWidgetValue(spec);
+    const stored = node.state[spec.key];
+    return stored === undefined ? defaultWidgetValue(spec) : clampWidgetValue(spec, stored);
+}
+/** Effective widget visibility policy. ALL widget types default to `'whenDisconnected'` — they're
+ *  input controls that the user sets a value for, and connecting a wire makes the widget's value
+ *  redundant. Display/preview widgets (e.g. an Output node's value readout) opt into `'always'`
+ *  explicitly. `button` widgets aren't pin-bound — they live in the actions row. */
+export function widgetVisibility(spec) {
+    return spec.visibility ?? 'whenDisconnected';
+}
+/** Resolve `displayOptions.show(state)` against a node — true (visible) unless the callback exists
+ *  and explicitly returns false. Defensive: a throwing callback fails OPEN so a schema bug doesn't
+ *  blank the node entirely. */
+export function widgetIsVisible(spec, node) {
+    const show = spec.displayOptions?.show;
+    if (!show)
+        return true;
+    try {
+        return show(node.state) !== false;
+    }
+    catch {
+        return true;
+    }
+}
+/** The lookup key used to bind a widget to its pin: explicit `pinKey`, else the widget's `key`.
+ *  Returns undefined for widgets that don't bind to a pin (`button` — actions, not values). */
+export function widgetBindKey(spec) {
+    if (spec.type === 'button')
+        return undefined;
+    return spec.pinKey ?? spec.key;
+}
+//# sourceMappingURL=widget.js.map

package/dist/widget.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@xenolithengine/graph-core",
+  "version": "0.7.0-beta.0",
+  "description": "Headless graph model, type system, command bus, and event emitter for XenolithGraph. Zero runtime dependencies.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "keywords": [
+    "node-editor",
+    "node-graph",
+    "graph",
+    "blueprint",
+    "headless",
+    "zero-dep",
+    "typescript"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/XenolithEngine/xenolith-graph.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://xenolithengine.github.io/xenolith-graph/",
+  "bugs": {
+    "url": "https://github.com/XenolithEngine/xenolith-graph/issues"
+  },
+  "author": "XenolithEngine",
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "tsc -b --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src",
+    "typecheck": "tsc --noEmit"
+  }
+}