@rippling/rippling-sdk 0.2.0-alpha.59 → 0.2.0-alpha.61

package/lib/sdui/component.js

@@ -1,128 +0,0 @@
-"use strict";
-/**
- * component() — creates a stateful component boundary.
- *
- * Provides ctx.localState (scoped local state slot) and ctx.onMount (an
- * action that fires once when the component mounts on the client). The
- * runtime handles state setup and mount firing; consumers don't need to
- * know how the wrapping is implemented.
- *
- * NOTE: these are NOT React hooks. The factory runs ONCE at spec-build
- * time, producing a JSON description of the UI. `localState` returns a
- * path-builder proxy (not a [value, setter] tuple); `onMount` registers
- * a JSON action that fires on first client render (not an effect that
- * re-runs).
- *
- * Usage:
- *   function MembersGrid(props) {
- *     return component((ctx) => {
- *       const local = ctx.localState({ data: [], loading: true })
- *       ctx.onMount(fetchAction)
- *       return { element: DataGrid({ ... }) }
- *     })
- *   }
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports._resetIdCounter = _resetIdCounter;
-exports.component = component;
-let _idCounter = 0;
-// Counter-only IDs (no Date.now()) so the same factory body produces the
-// same paths across runs. The counter is monotonic per process; calling
-// `_resetIdCounter()` (tests only) brings it back to 0 so snapshot tests
-// stay stable.
-function generateId() {
-    _idCounter += 1;
-    return `auto_${_idCounter.toString(36)}`;
-}
-// Reset counter (for testing)
-function _resetIdCounter() {
-    _idCounter = 0;
-}
-function createScopeProxy(basePath) {
-    const handler = {
-        get(_target, prop) {
-            if (prop === '$bind')
-                return { $bindState: basePath };
-            if (prop === '$path')
-                return basePath;
-            if (prop === '$state')
-                return basePath;
-            if (prop === 'toJSON')
-                return () => ({ $state: basePath });
-            if (prop === Symbol.toPrimitive)
-                return () => `$state:${basePath}`;
-            const childPath = `${basePath}/${String(prop)}`;
-            return createScopeProxy(childPath);
-        },
-    };
-    return new Proxy({}, handler);
-}
-function component(factory) {
-    const states = [];
-    const mountActions = [];
-    const ctx = {
-        localState(initial) {
-            const path = `/${generateId()}`;
-            states.push({ path, initial });
-            return createScopeProxy(path);
-        },
-        onMount(action) {
-            mountActions.push(action);
-        },
-    };
-    const result = factory(ctx);
-    // No state, no effects → return as-is.
-    if (states.length === 0 && mountActions.length === 0) {
-        return result;
-    }
-    // Collapse zero/one/many mount actions for the single onMountAction slot
-    // on the innermost wrapper.
-    let combinedMount;
-    if (mountActions.length === 1) {
-        combinedMount = mountActions[0];
-    }
-    else if (mountActions.length > 1) {
-        combinedMount = mountActions.flatMap((a) => (Array.isArray(a) ? a : [a]));
-    }
-    let wrapped = result.element;
-    if (states.length === 0) {
-        // Mount-only: a single state-provider wrapper carries onMountAction.
-        wrapped = {
-            type: '_LocalStateProvider',
-            props: combinedMount ? { onMountAction: combinedMount } : {},
-            children: [wrapped],
-        };
-    }
-    else {
-        // One state-provider wrapper per localState() call, nested
-        // innermost-first. Mount actions attach to the innermost wrapper so
-        // every state slot is initialized before any action fires.
-        for (let i = states.length - 1; i >= 0; i--) {
-            const state = states[i];
-            if (state) {
-                const isInnermost = i === states.length - 1;
-                const props = {
-                    statePath: state.path,
-                    initialValue: state.initial,
-                    ...(isInnermost && combinedMount ? { onMountAction: combinedMount } : {}),
-                };
-                const wrapper = {
-                    type: '_LocalStateProvider',
-                    props,
-                    children: [wrapped],
-                };
-                // render() picks up this marker to populate spec.state.
-                wrapper._localStateRegistration = {
-                    path: state.path,
-                    initial: state.initial,
-                };
-                wrapped = wrapper;
-            }
-        }
-    }
-    return {
-        ...result,
-        element: wrapped,
-    };
-}
-//# sourceMappingURL=component.js.map

package/lib/sdui/component.js.map

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

package/lib/sdui/component.mjs

@@ -1,124 +0,0 @@
-/**
- * component() — creates a stateful component boundary.
- *
- * Provides ctx.localState (scoped local state slot) and ctx.onMount (an
- * action that fires once when the component mounts on the client). The
- * runtime handles state setup and mount firing; consumers don't need to
- * know how the wrapping is implemented.
- *
- * NOTE: these are NOT React hooks. The factory runs ONCE at spec-build
- * time, producing a JSON description of the UI. `localState` returns a
- * path-builder proxy (not a [value, setter] tuple); `onMount` registers
- * a JSON action that fires on first client render (not an effect that
- * re-runs).
- *
- * Usage:
- *   function MembersGrid(props) {
- *     return component((ctx) => {
- *       const local = ctx.localState({ data: [], loading: true })
- *       ctx.onMount(fetchAction)
- *       return { element: DataGrid({ ... }) }
- *     })
- *   }
- */
-let _idCounter = 0;
-// Counter-only IDs (no Date.now()) so the same factory body produces the
-// same paths across runs. The counter is monotonic per process; calling
-// `_resetIdCounter()` (tests only) brings it back to 0 so snapshot tests
-// stay stable.
-function generateId() {
-    _idCounter += 1;
-    return `auto_${_idCounter.toString(36)}`;
-}
-// Reset counter (for testing)
-export function _resetIdCounter() {
-    _idCounter = 0;
-}
-function createScopeProxy(basePath) {
-    const handler = {
-        get(_target, prop) {
-            if (prop === '$bind')
-                return { $bindState: basePath };
-            if (prop === '$path')
-                return basePath;
-            if (prop === '$state')
-                return basePath;
-            if (prop === 'toJSON')
-                return () => ({ $state: basePath });
-            if (prop === Symbol.toPrimitive)
-                return () => `$state:${basePath}`;
-            const childPath = `${basePath}/${String(prop)}`;
-            return createScopeProxy(childPath);
-        },
-    };
-    return new Proxy({}, handler);
-}
-export function component(factory) {
-    const states = [];
-    const mountActions = [];
-    const ctx = {
-        localState(initial) {
-            const path = `/${generateId()}`;
-            states.push({ path, initial });
-            return createScopeProxy(path);
-        },
-        onMount(action) {
-            mountActions.push(action);
-        },
-    };
-    const result = factory(ctx);
-    // No state, no effects → return as-is.
-    if (states.length === 0 && mountActions.length === 0) {
-        return result;
-    }
-    // Collapse zero/one/many mount actions for the single onMountAction slot
-    // on the innermost wrapper.
-    let combinedMount;
-    if (mountActions.length === 1) {
-        combinedMount = mountActions[0];
-    }
-    else if (mountActions.length > 1) {
-        combinedMount = mountActions.flatMap((a) => (Array.isArray(a) ? a : [a]));
-    }
-    let wrapped = result.element;
-    if (states.length === 0) {
-        // Mount-only: a single state-provider wrapper carries onMountAction.
-        wrapped = {
-            type: '_LocalStateProvider',
-            props: combinedMount ? { onMountAction: combinedMount } : {},
-            children: [wrapped],
-        };
-    }
-    else {
-        // One state-provider wrapper per localState() call, nested
-        // innermost-first. Mount actions attach to the innermost wrapper so
-        // every state slot is initialized before any action fires.
-        for (let i = states.length - 1; i >= 0; i--) {
-            const state = states[i];
-            if (state) {
-                const isInnermost = i === states.length - 1;
-                const props = {
-                    statePath: state.path,
-                    initialValue: state.initial,
-                    ...(isInnermost && combinedMount ? { onMountAction: combinedMount } : {}),
-                };
-                const wrapper = {
-                    type: '_LocalStateProvider',
-                    props,
-                    children: [wrapped],
-                };
-                // render() picks up this marker to populate spec.state.
-                wrapper._localStateRegistration = {
-                    path: state.path,
-                    initial: state.initial,
-                };
-                wrapped = wrapper;
-            }
-        }
-    }
-    return {
-        ...result,
-        element: wrapped,
-    };
-}
-//# sourceMappingURL=component.mjs.map

package/lib/sdui/component.mjs.map

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