@sigx/lynx-runtime-internal 0.2.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Andreas Ekdahl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,14 @@
+# @sigx/lynx-runtime-internal
+
+Shared types for the BG ↔ MT wire protocol used by [`@sigx/lynx-runtime`](../lynx-runtime) and [`@sigx/lynx-runtime-main`](../lynx-runtime-main). Re-exports nothing user-facing; ship-time decoupling only.
+
+## Contents
+
+- **`OP`** — the numeric op codes that travel from the background thread to the main thread (`CREATE`, `SET_STYLE`, `SET_WORKLET_EVENT`, `INIT_MT_REF`, `REGISTER_AV_BRIDGE`, etc.). Both runtime packages import these so they stay aligned.
+- **`MapperParams`, `BuiltinMapperName`, `AnimatedStyleMapper`** — the type signatures consumed by `useAnimatedStyle` (`@sigx/gestures`) and the MT-side mapper registry (`@sigx/lynx-runtime-main`).
+
+> If you're writing application code, you don't need to depend on this package — the public surface is re-exported through [`@sigx/lynx`](../lynx).
+
+## License
+
+MIT

package/dist/animated-style-types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Shared types for the `useAnimatedStyle` linkage.
+ *
+ * The MT-side mapper registry (in lynx-runtime-main) and the BG-side
+ * `useAnimatedStyle` factory (in @sigx/lynx) both need agreement on the
+ * param shape per built-in mapper name. This module is the single source of
+ * truth — adding a new built-in mapper means an entry here AND a matching
+ * implementation in lynx-runtime-main's `mtMappers` table.
+ */
+/**
+ * Range-mapping params: linear interpolation from input domain to output range.
+ * Available on `translateX`, `translateY`, `scale`, `opacity` as an alternative
+ * to the linear `factor`/`offset` shape. Multi-stop ranges (length ≥ 2) work —
+ * each segment is interpolated independently.
+ *
+ * `extrapolate`:
+ *   - `'clamp'` (default): cap at endpoints when input is outside the range.
+ *   - `'identity'`: extend linearly beyond the endpoints using the slope of
+ *     the nearest segment.
+ */
+export interface RangeParams {
+    inputRange: number[];
+    outputRange: number[];
+    extrapolate?: 'clamp' | 'identity';
+}
+/**
+ * Param shapes per built-in mapper. Add an entry here AND a matching
+ * implementation in lynx-runtime-main's `mtMappers` table to ship a new
+ * built-in mapper.
+ */
+export interface MapperParams {
+    /** translateX(value * factor)px — defaults: { factor: 1 }. Or range-map. */
+    translateX: {
+        factor?: number;
+    } | RangeParams;
+    /** translateY(value * factor)px — defaults: { factor: 1 }. Or range-map. */
+    translateY: {
+        factor?: number;
+    } | RangeParams;
+    /** translate(value.x * factorX, value.y * factorY)px — for 2D AVs. */
+    translate: {
+        factorX?: number;
+        factorY?: number;
+    };
+    /** scale(value + offset) — defaults: { offset: 0 }. Or range-map. */
+    scale: {
+        offset?: number;
+    } | RangeParams;
+    /**
+     * opacity = clamp01(value * factor + offset). Or range-map (output is
+     * clamped to [0,1] after interpolation either way).
+     */
+    opacity: {
+        factor?: number;
+        offset?: number;
+    } | RangeParams;
+    /** rotate(value)deg. */
+    rotate: Record<string, never>;
+    /** padding-top: (value * factor)px — defaults: { factor: 1 }. Or range-map. */
+    paddingTop: {
+        factor?: number;
+    } | RangeParams;
+    /** padding-right: (value * factor)px — defaults: { factor: 1 }. Or range-map. */
+    paddingRight: {
+        factor?: number;
+    } | RangeParams;
+    /** padding-bottom: (value * factor)px — defaults: { factor: 1 }. Or range-map. */
+    paddingBottom: {
+        factor?: number;
+    } | RangeParams;
+    /** padding-left: (value * factor)px — defaults: { factor: 1 }. Or range-map. */
+    paddingLeft: {
+        factor?: number;
+    } | RangeParams;
+    /** margin-top: (value * factor)px — defaults: { factor: 1 }. Or range-map. */
+    marginTop: {
+        factor?: number;
+    } | RangeParams;
+    /** margin-right: (value * factor)px — defaults: { factor: 1 }. Or range-map. */
+    marginRight: {
+        factor?: number;
+    } | RangeParams;
+    /** margin-bottom: (value * factor)px — defaults: { factor: 1 }. Or range-map. */
+    marginBottom: {
+        factor?: number;
+    } | RangeParams;
+    /** margin-left: (value * factor)px — defaults: { factor: 1 }. Or range-map. */
+    marginLeft: {
+        factor?: number;
+    } | RangeParams;
+}
+export type BuiltinMapperName = keyof MapperParams;
+export type AnimatedStyleMapper<P = unknown> = (value: unknown, params?: P) => Record<string, string | number>;

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { OP, type OpCode } from './ops';
+export type { MapperParams, RangeParams, BuiltinMapperName, AnimatedStyleMapper, } from './animated-style-types';

package/dist/index.js

@@ -0,0 +1,28 @@
+//#region src/ops.ts
+var e = {
+	CREATE: 0,
+	CREATE_TEXT: 1,
+	INSERT: 2,
+	REMOVE: 3,
+	SET_PROP: 4,
+	SET_TEXT: 5,
+	SET_EVENT: 6,
+	REMOVE_EVENT: 7,
+	SET_STYLE: 8,
+	SET_CLASS: 9,
+	SET_ID: 10,
+	SET_WORKLET_EVENT: 11,
+	SET_MT_REF: 12,
+	INIT_MT_REF: 13,
+	RELEASE_MT_REF: 14,
+	REGISTER_AV_BRIDGE: 15,
+	UNREGISTER_AV_BRIDGE: 16,
+	REGISTER_AV_STYLE_BINDING: 17,
+	UNREGISTER_AV_STYLE_BINDING: 18,
+	SET_GESTURE_DETECTOR: 19,
+	REMOVE_GESTURE_DETECTOR: 20
+};
+//#endregion
+export { e as OP };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/ops.ts"],"sourcesContent":["/**\n * Flat-array operation codes — the wire protocol between BG Thread and Main Thread.\n *\n * Format (all numbers/strings, JSON-serializable):\n *   CREATE:            [0, id, type]\n *   CREATE_TEXT:       [1, id]\n *   INSERT:            [2, parentId, childId, anchorId]   anchorId=-1 means append\n *   REMOVE:            [3, parentId, childId]\n *   SET_PROP:          [4, id, key, value]\n *   SET_TEXT:          [5, id, text]\n *   SET_EVENT:         [6, id, eventType, eventName, sign]\n *   REMOVE_EVENT:      [7, id, eventType, eventName]\n *   SET_STYLE:         [8, id, styleObject]\n *   SET_CLASS:         [9, id, classString]\n *   SET_ID:            [10, id, idString]\n *   SET_WORKLET_EVENT: [11, id, eventType, eventName, workletCtx]\n *   SET_MT_REF:        [12, id, refImpl]\n *   INIT_MT_REF:       [13, wvid, initValue]\n *   RELEASE_MT_REF:    [14, wvid]\n *   REGISTER_AV_BRIDGE:        [15, wvid, initValue]\n *   UNREGISTER_AV_BRIDGE:      [16, wvid]\n *   REGISTER_AV_STYLE_BINDING: [17, bindingId, elementWvid, avWvid, mapperName, params]\n *   UNREGISTER_AV_STYLE_BINDING: [18, bindingId]\n *   SET_GESTURE_DETECTOR:    [19, elementId, gestureId, type, config, relationMap]\n *   REMOVE_GESTURE_DETECTOR: [20, elementId, gestureId]\n */\nexport const OP = {\n  CREATE: 0,\n  CREATE_TEXT: 1,\n  INSERT: 2,\n  REMOVE: 3,\n  SET_PROP: 4,\n  SET_TEXT: 5,\n  SET_EVENT: 6,\n  REMOVE_EVENT: 7,\n  SET_STYLE: 8,\n  SET_CLASS: 9,\n  SET_ID: 10,\n  SET_WORKLET_EVENT: 11,\n  SET_MT_REF: 12,\n  INIT_MT_REF: 13,\n  RELEASE_MT_REF: 14,\n  REGISTER_AV_BRIDGE: 15,\n  UNREGISTER_AV_BRIDGE: 16,\n  REGISTER_AV_STYLE_BINDING: 17,\n  UNREGISTER_AV_STYLE_BINDING: 18,\n  SET_GESTURE_DETECTOR: 19,\n  REMOVE_GESTURE_DETECTOR: 20,\n} as const;\n\nexport type OpCode = (typeof OP)[keyof typeof OP];\n"],"mappings":";AA0BA,IAAa,IAAK;CAChB,QAAQ;CACR,aAAa;CACb,QAAQ;CACR,QAAQ;CACR,UAAU;CACV,UAAU;CACV,WAAW;CACX,cAAc;CACd,WAAW;CACX,WAAW;CACX,QAAQ;CACR,mBAAmB;CACnB,YAAY;CACZ,aAAa;CACb,gBAAgB;CAChB,oBAAoB;CACpB,sBAAsB;CACtB,2BAA2B;CAC3B,6BAA6B;CAC7B,sBAAsB;CACtB,yBAAyB;CAC1B"}

package/dist/ops.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Flat-array operation codes — the wire protocol between BG Thread and Main Thread.
+ *
+ * Format (all numbers/strings, JSON-serializable):
+ *   CREATE:            [0, id, type]
+ *   CREATE_TEXT:       [1, id]
+ *   INSERT:            [2, parentId, childId, anchorId]   anchorId=-1 means append
+ *   REMOVE:            [3, parentId, childId]
+ *   SET_PROP:          [4, id, key, value]
+ *   SET_TEXT:          [5, id, text]
+ *   SET_EVENT:         [6, id, eventType, eventName, sign]
+ *   REMOVE_EVENT:      [7, id, eventType, eventName]
+ *   SET_STYLE:         [8, id, styleObject]
+ *   SET_CLASS:         [9, id, classString]
+ *   SET_ID:            [10, id, idString]
+ *   SET_WORKLET_EVENT: [11, id, eventType, eventName, workletCtx]
+ *   SET_MT_REF:        [12, id, refImpl]
+ *   INIT_MT_REF:       [13, wvid, initValue]
+ *   RELEASE_MT_REF:    [14, wvid]
+ *   REGISTER_AV_BRIDGE:        [15, wvid, initValue]
+ *   UNREGISTER_AV_BRIDGE:      [16, wvid]
+ *   REGISTER_AV_STYLE_BINDING: [17, bindingId, elementWvid, avWvid, mapperName, params]
+ *   UNREGISTER_AV_STYLE_BINDING: [18, bindingId]
+ *   SET_GESTURE_DETECTOR:    [19, elementId, gestureId, type, config, relationMap]
+ *   REMOVE_GESTURE_DETECTOR: [20, elementId, gestureId]
+ */
+export declare const OP: {
+    readonly CREATE: 0;
+    readonly CREATE_TEXT: 1;
+    readonly INSERT: 2;
+    readonly REMOVE: 3;
+    readonly SET_PROP: 4;
+    readonly SET_TEXT: 5;
+    readonly SET_EVENT: 6;
+    readonly REMOVE_EVENT: 7;
+    readonly SET_STYLE: 8;
+    readonly SET_CLASS: 9;
+    readonly SET_ID: 10;
+    readonly SET_WORKLET_EVENT: 11;
+    readonly SET_MT_REF: 12;
+    readonly INIT_MT_REF: 13;
+    readonly RELEASE_MT_REF: 14;
+    readonly REGISTER_AV_BRIDGE: 15;
+    readonly UNREGISTER_AV_BRIDGE: 16;
+    readonly REGISTER_AV_STYLE_BINDING: 17;
+    readonly UNREGISTER_AV_STYLE_BINDING: 18;
+    readonly SET_GESTURE_DETECTOR: 19;
+    readonly REMOVE_GESTURE_DETECTOR: 20;
+};
+export type OpCode = (typeof OP)[keyof typeof OP];

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@sigx/lynx-runtime-internal",
+  "version": "0.2.4",
+  "description": "Shared op types for SignalX Lynx renderer (BG ↔ MTS wire protocol)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "sigx",
+    "lynx",
+    "internal",
+    "ops"
+  ],
+  "author": "Andreas Ekdahl",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/signalxjs/lynx.git",
+    "directory": "packages/lynx-runtime-internal"
+  },
+  "homepage": "https://github.com/signalxjs/lynx/tree/main/packages/lynx-runtime-internal",
+  "bugs": {
+    "url": "https://github.com/signalxjs/lynx/issues"
+  },
+  "devDependencies": {
+    "@sigx/vite": "^0.4.3",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.12"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vite build && tsgo --emitDeclarationOnly",
+    "dev": "vite build --watch"
+  }
+}