@fluixi/reactive 1.0.0-alpha.83 → 1.0.0-alpha.84

package/dist/lib/signal/graph/observe.cjs

@@ -1 +1,163 @@
-"use strict";var v=Object.defineProperty;var l=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var b=Object.prototype.hasOwnProperty;var k=(e,n)=>{for(var t in n)v(e,t,{get:n[t],enumerable:!0})},f=(e,n,t,s)=>{if(n&&typeof n=="object"||typeof n=="function")for(let i of p(n))!b.call(e,i)&&i!==t&&v(e,i,{get:()=>n[i],enumerable:!(s=l(n,i))||s.enumerable});return e};var w=e=>f(v({},"__esModule",{value:!0}),e);var H={};k(H,{enterReactiveRun:()=>m,exitReactiveRun:()=>O,isObserved:()=>K,observeReactiveNodes:()=>d,reportReactiveBinding:()=>N,reportReactiveContext:()=>T,reportReactiveContextCreated:()=>E,reportReactiveDirective:()=>D,reportReactiveDispose:()=>C,reportReactiveMove:()=>q,reportReactiveNode:()=>x,reportReactiveProps:()=>S,reportReactiveRun:()=>y,reportReactiveWrite:()=>_,withReactiveOrigin:()=>h});module.exports=w(H);var R="__fluixi_signal_next_state__",g=e=>{typeof queueMicrotask=="function"?queueMicrotask(e):Promise.resolve().then(e)},o=globalThis[R]??={consumer:null,untracked:!1,owner:null,queue:[],scheduled:!1,flushing:!1,batchDepth:0,hostSchedule:g,onSuspend:null,onError:null,observer:null};var a="1.0.0-alpha.83";function d(e){return o.observer=e,()=>{o.observer===e&&(o.observer=null)}}var r=[],u;function h(e,n){if(!o.observer)return n();let t=u;u=e;try{return n()}finally{u=t}}function x(e){let n=o.observer;n&&n.created(e.parents===void 0?{...e,parents:r,origin:e.origin??u}:e)}function m(e){return o.observer?(r.push(e),!0):!1}function O(){r.pop()}function y(e){o.observer?.ran?.(e)}function _(e,n){o.observer?.wrote?.(e,n)}function N(e,n,t,s){let i=o.observer;!i?.bound||!r.length||i.bound(r[r.length-1],e,n,t,s)}function S(e){let n=o.observer;!n?.props||!r.length||!e||n.props(r[r.length-1],e)}function D(e,n,t,s){let i=o.observer;!i?.directive||!r.length||i.directive(r[r.length-1],e,n,t,s)}function E(e){o.observer?.contextCreated?.(e)}function T(e,n,t){let s=o.observer;!s?.context||!r.length||s.context(r[r.length-1],e,n,t)}function q(e,n,t){o.observer?.moved?.(e,n,t)}function C(e){o.observer?.disposed?.(e)}var G="__FLUIXI_DEVTOOLS_HOOK__",c=globalThis[G];if(typeof c?.inject=="function")try{c.inject({observeReactiveNodes:d,version:a})}catch{}function K(){return o.observer!=null}
+"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/lib/signal/graph/observe.ts
+var observe_exports = {};
+__export(observe_exports, {
+  enterReactiveRun: () => enterReactiveRun,
+  exitReactiveRun: () => exitReactiveRun,
+  isObserved: () => isObserved,
+  observeReactiveNodes: () => observeReactiveNodes,
+  reportReactiveBinding: () => reportReactiveBinding,
+  reportReactiveContext: () => reportReactiveContext,
+  reportReactiveContextCreated: () => reportReactiveContextCreated,
+  reportReactiveDirective: () => reportReactiveDirective,
+  reportReactiveDispose: () => reportReactiveDispose,
+  reportReactiveMove: () => reportReactiveMove,
+  reportReactiveNode: () => reportReactiveNode,
+  reportReactiveProps: () => reportReactiveProps,
+  reportReactiveRun: () => reportReactiveRun,
+  reportReactiveWrite: () => reportReactiveWrite,
+  withReactiveOrigin: () => withReactiveOrigin
+});
+module.exports = __toCommonJS(observe_exports);
+
+// src/version.generated.ts
+var VERSION = "1.0.0-alpha.84";
+
+// src/lib/signal/graph/state.ts
+var MAJOR = VERSION.split(".")[0];
+var KEY = `__fluixi_signal_state_v${MAJOR}__`;
+var VERSIONS_KEY = `__fluixi_signal_builds_v${MAJOR}__`;
+var defaultSchedule = (run) => {
+  if (typeof queueMicrotask === "function") queueMicrotask(run);
+  else void Promise.resolve().then(run);
+};
+function defaults() {
+  return {
+    consumer: null,
+    untracked: false,
+    owner: null,
+    queue: [],
+    scheduled: false,
+    flushing: false,
+    batchDepth: 0,
+    hostSchedule: defaultSchedule,
+    onSuspend: null,
+    onError: null,
+    observer: null
+  };
+}
+var realm = globalThis;
+function backfillState(existing) {
+  const fresh = defaults();
+  const target = existing;
+  for (const field of Object.keys(fresh)) {
+    if (!(field in existing)) target[field] = fresh[field];
+  }
+  return existing;
+}
+function claim() {
+  const existing = realm[KEY];
+  return existing ? backfillState(existing) : realm[KEY] = defaults();
+}
+var G = claim();
+(realm[VERSIONS_KEY] ??= []).push(VERSION);
+
+// src/lib/signal/graph/observe.ts
+function observeReactiveNodes(next) {
+  G.observer = next;
+  return () => {
+    if (G.observer === next) G.observer = null;
+  };
+}
+var running = [];
+var origin;
+function withReactiveOrigin(owner, fn) {
+  if (!G.observer) return fn();
+  const previous = origin;
+  origin = owner;
+  try {
+    return fn();
+  } finally {
+    origin = previous;
+  }
+}
+function reportReactiveNode(report) {
+  const observer = G.observer;
+  if (observer) {
+    observer.created(
+      report.parents === void 0 ? { ...report, parents: running, origin: report.origin ?? origin } : report
+    );
+  }
+}
+function enterReactiveRun(node) {
+  if (!G.observer) return false;
+  running.push(node);
+  return true;
+}
+function exitReactiveRun() {
+  running.pop();
+}
+function reportReactiveRun(node) {
+  G.observer?.ran?.(node);
+}
+function reportReactiveWrite(node, by) {
+  G.observer?.wrote?.(node, by);
+}
+function reportReactiveBinding(target, kind, name, accessor) {
+  const observer = G.observer;
+  if (!observer?.bound || !running.length) return;
+  observer.bound(running[running.length - 1], target, kind, name, accessor);
+}
+function reportReactiveProps(props) {
+  const observer = G.observer;
+  if (!observer?.props || !running.length || !props) return;
+  observer.props(running[running.length - 1], props);
+}
+function reportReactiveDirective(target, kind, name, accessor) {
+  const observer = G.observer;
+  if (!observer?.directive || !running.length) return;
+  observer.directive(running[running.length - 1], target, kind, name, accessor);
+}
+function reportReactiveContextCreated(id) {
+  G.observer?.contextCreated?.(id);
+}
+function reportReactiveContext(id, kind, value) {
+  const observer = G.observer;
+  if (!observer?.context || !running.length) return;
+  observer.context(running[running.length - 1], id, kind, value);
+}
+function reportReactiveMove(node, origin2, name) {
+  G.observer?.moved?.(node, origin2, name);
+}
+function reportReactiveDispose(node) {
+  G.observer?.disposed?.(node);
+}
+var HOOK = "__FLUIXI_DEVTOOLS_HOOK__";
+var hook = globalThis[HOOK];
+if (typeof hook?.inject === "function") {
+  try {
+    hook.inject({ observeReactiveNodes, version: VERSION });
+  } catch {
+  }
+}
+function isObserved() {
+  return G.observer != null;
+}

package/dist/lib/signal/graph/observe.d.ts

@@ -9,24 +9,24 @@ export interface ReactiveNodeReport {
     name?: string;
     /**
      * How to write it, for a signal. A watcher setting the value through this goes through
-     * the same path the application does — writing the node directly marks its readers dirty
+     * the same path the application does, writing the node directly marks its readers dirty
      * without ever flushing them, so the page keeps whatever it last rendered.
      */
     set?: (value: unknown) => void;
     /**
      * The node this one was built for. A store creates a signal per key, lazily, wherever it
-     * is first read — the useful location is the store's, not the reader's.
+     * is first read, the useful location is the store's, not the reader's.
      */
     origin?: unknown;
     /**
-     * The node is the framework's own plumbing — a render effect, one per dom binding. A graph
+     * The node is the framework's own plumbing, a render effect, one per dom binding. A graph
      * does not show these, but it needs to know they exist: a row added to a list is created
      * inside one, and without it the row has no ancestor it can be attached to.
      */
     internal?: boolean;
     /**
      * The computations running when this node was made, outermost first. A component's wrapper
-     * memo reads nothing itself, so what it created is the only thing tying it to the graph —
+     * memo reads nothing itself, so what it created is the only thing tying it to the graph
      * and the whole chain is given because the nearest one is often a render effect, which no
      * graph shows.
      *
@@ -41,15 +41,15 @@ export interface ReactiveObserver {
     /** An effect was disposed. Memos and signals go with their owner and are not reported. */
     disposed?(node: unknown): void;
     /**
-     * A signal was written, and by which computation — nothing, when the write came from an
+     * A signal was written, and by which computation, nothing, when the write came from an
      * event handler, which is where most of them come from.
      */
     wrote?(node: unknown, by: unknown): void;
     /**
      * A node now belongs somewhere else, and is called something else.
      *
-     * A store write replaces the object that held a value — `set({ items: [...items, one] })`
-     * builds a new array — and the signals underneath it are the same signals in a new place.
+     * A store write replaces the object that held a value: `set({ items: [...items, one] })`
+     * builds a new array, and the signals underneath it are the same signals in a new place.
      * Without this they keep pointing at a node that no longer exists.
      */
     moved?(node: unknown, origin: unknown, name?: string): void;
@@ -93,7 +93,7 @@ export interface ReactiveObserver {
 /**
  * Watch the graph. Returns a function that stops watching.
  *
- * One observer at a time — the last to register wins. Two tools watching one page at once is
+ * One observer at a time, the last to register wins. Two tools watching one page at once is
  * not a case worth carrying state for.
  */
 export declare function observeReactiveNodes(next: ReactiveObserver): () => void;

package/dist/lib/signal/graph/observe.js

@@ -2,8 +2,8 @@
  * A place for a tool to watch the reactive graph from outside it.
  *
  * The runtime says a node exists, a computation re-ran, or an effect went away, and hands
- * over the node itself. It does nothing else. Edges are already on the node — a source keeps
- * its `observers`, a consumer keeps its `sources` — so a watcher reads the graph rather than
+ * over the node itself. It does nothing else. Edges are already on the node, a source keeps
+ * its `observers`, a consumer keeps its `sources`, so a watcher reads the graph rather than
  * reconstructing it, and nothing here wraps or replaces a primitive.
  *
  * Nothing is registered by default: an unwatched runtime pays one null check per node
@@ -12,14 +12,14 @@
  * @fluixi/devtools is the intended caller. Nothing in the framework reads it back.
  *
  * The observer lives on the shared graph state rather than in a module `let`, so a bundle
- * carrying two copies of this module still has one observer — the same reason G exists.
+ * carrying two copies of this module still has one observer, the same reason G exists.
  */
 import { G } from './state.js';
 import { VERSION } from '../../../version.generated.js';
 /**
  * Watch the graph. Returns a function that stops watching.
  *
- * One observer at a time — the last to register wins. Two tools watching one page at once is
+ * One observer at a time, the last to register wins. Two tools watching one page at once is
  * not a case worth carrying state for.
  */
 export function observeReactiveNodes(next) {
@@ -130,7 +130,7 @@ export function reportReactiveDispose(node) {
  * have to import a debugger to be debuggable. So a tool sets this global before any of the
  * app loads, and the runtime hands it the door on the way past.
  *
- * Set it too late and nothing happens — the runtime only offers once, when this module is
+ * Set it too late and nothing happens, the runtime only offers once, when this module is
  * first evaluated. A browser agent has to run at document_start for that reason.
  */
 const HOOK = '__FLUIXI_DEVTOOLS_HOOK__';

package/dist/lib/signal/graph/observe.mjs

@@ -1 +1,140 @@
-var c="__fluixi_signal_next_state__",d=e=>{typeof queueMicrotask=="function"?queueMicrotask(e):Promise.resolve().then(e)},o=globalThis[c]??={consumer:null,untracked:!1,owner:null,queue:[],scheduled:!1,flushing:!1,batchDepth:0,hostSchedule:d,onSuspend:null,onError:null,observer:null};var v="1.0.0-alpha.83";function l(e){return o.observer=e,()=>{o.observer===e&&(o.observer=null)}}var r=[],u;function R(e,n){if(!o.observer)return n();let t=u;u=e;try{return n()}finally{u=t}}function g(e){let n=o.observer;n&&n.created(e.parents===void 0?{...e,parents:r,origin:e.origin??u}:e)}function h(e){return o.observer?(r.push(e),!0):!1}function x(){r.pop()}function m(e){o.observer?.ran?.(e)}function O(e,n){o.observer?.wrote?.(e,n)}function y(e,n,t,i){let s=o.observer;!s?.bound||!r.length||s.bound(r[r.length-1],e,n,t,i)}function _(e){let n=o.observer;!n?.props||!r.length||!e||n.props(r[r.length-1],e)}function N(e,n,t,i){let s=o.observer;!s?.directive||!r.length||s.directive(r[r.length-1],e,n,t,i)}function S(e){o.observer?.contextCreated?.(e)}function D(e,n,t){let i=o.observer;!i?.context||!r.length||i.context(r[r.length-1],e,n,t)}function E(e,n,t){o.observer?.moved?.(e,n,t)}function T(e){o.observer?.disposed?.(e)}var p="__FLUIXI_DEVTOOLS_HOOK__",a=globalThis[p];if(typeof a?.inject=="function")try{a.inject({observeReactiveNodes:l,version:v})}catch{}function q(){return o.observer!=null}export{h as enterReactiveRun,x as exitReactiveRun,q as isObserved,l as observeReactiveNodes,y as reportReactiveBinding,D as reportReactiveContext,S as reportReactiveContextCreated,N as reportReactiveDirective,T as reportReactiveDispose,E as reportReactiveMove,g as reportReactiveNode,_ as reportReactiveProps,m as reportReactiveRun,O as reportReactiveWrite,R as withReactiveOrigin};
+// src/version.generated.ts
+var VERSION = "1.0.0-alpha.84";
+
+// src/lib/signal/graph/state.ts
+var MAJOR = VERSION.split(".")[0];
+var KEY = `__fluixi_signal_state_v${MAJOR}__`;
+var VERSIONS_KEY = `__fluixi_signal_builds_v${MAJOR}__`;
+var defaultSchedule = (run) => {
+  if (typeof queueMicrotask === "function") queueMicrotask(run);
+  else void Promise.resolve().then(run);
+};
+function defaults() {
+  return {
+    consumer: null,
+    untracked: false,
+    owner: null,
+    queue: [],
+    scheduled: false,
+    flushing: false,
+    batchDepth: 0,
+    hostSchedule: defaultSchedule,
+    onSuspend: null,
+    onError: null,
+    observer: null
+  };
+}
+var realm = globalThis;
+function backfillState(existing) {
+  const fresh = defaults();
+  const target = existing;
+  for (const field of Object.keys(fresh)) {
+    if (!(field in existing)) target[field] = fresh[field];
+  }
+  return existing;
+}
+function claim() {
+  const existing = realm[KEY];
+  return existing ? backfillState(existing) : realm[KEY] = defaults();
+}
+var G = claim();
+(realm[VERSIONS_KEY] ??= []).push(VERSION);
+
+// src/lib/signal/graph/observe.ts
+function observeReactiveNodes(next) {
+  G.observer = next;
+  return () => {
+    if (G.observer === next) G.observer = null;
+  };
+}
+var running = [];
+var origin;
+function withReactiveOrigin(owner, fn) {
+  if (!G.observer) return fn();
+  const previous = origin;
+  origin = owner;
+  try {
+    return fn();
+  } finally {
+    origin = previous;
+  }
+}
+function reportReactiveNode(report) {
+  const observer = G.observer;
+  if (observer) {
+    observer.created(
+      report.parents === void 0 ? { ...report, parents: running, origin: report.origin ?? origin } : report
+    );
+  }
+}
+function enterReactiveRun(node) {
+  if (!G.observer) return false;
+  running.push(node);
+  return true;
+}
+function exitReactiveRun() {
+  running.pop();
+}
+function reportReactiveRun(node) {
+  G.observer?.ran?.(node);
+}
+function reportReactiveWrite(node, by) {
+  G.observer?.wrote?.(node, by);
+}
+function reportReactiveBinding(target, kind, name, accessor) {
+  const observer = G.observer;
+  if (!observer?.bound || !running.length) return;
+  observer.bound(running[running.length - 1], target, kind, name, accessor);
+}
+function reportReactiveProps(props) {
+  const observer = G.observer;
+  if (!observer?.props || !running.length || !props) return;
+  observer.props(running[running.length - 1], props);
+}
+function reportReactiveDirective(target, kind, name, accessor) {
+  const observer = G.observer;
+  if (!observer?.directive || !running.length) return;
+  observer.directive(running[running.length - 1], target, kind, name, accessor);
+}
+function reportReactiveContextCreated(id) {
+  G.observer?.contextCreated?.(id);
+}
+function reportReactiveContext(id, kind, value) {
+  const observer = G.observer;
+  if (!observer?.context || !running.length) return;
+  observer.context(running[running.length - 1], id, kind, value);
+}
+function reportReactiveMove(node, origin2, name) {
+  G.observer?.moved?.(node, origin2, name);
+}
+function reportReactiveDispose(node) {
+  G.observer?.disposed?.(node);
+}
+var HOOK = "__FLUIXI_DEVTOOLS_HOOK__";
+var hook = globalThis[HOOK];
+if (typeof hook?.inject === "function") {
+  try {
+    hook.inject({ observeReactiveNodes, version: VERSION });
+  } catch {
+  }
+}
+function isObserved() {
+  return G.observer != null;
+}
+export {
+  enterReactiveRun,
+  exitReactiveRun,
+  isObserved,
+  observeReactiveNodes,
+  reportReactiveBinding,
+  reportReactiveContext,
+  reportReactiveContextCreated,
+  reportReactiveDirective,
+  reportReactiveDispose,
+  reportReactiveMove,
+  reportReactiveNode,
+  reportReactiveProps,
+  reportReactiveRun,
+  reportReactiveWrite,
+  withReactiveOrigin
+};