sygnal 5.4.0 → 6.0.0

package/README.md

@@ -14,7 +14,7 @@ A reactive component framework with pure functions, zero side effects, and autom
 - **Pure components** — Views are plain functions. All side effects are handled by drivers, outside your code.
 - **Automatic state management** — Monolithic state tree with no store setup, no providers, no hooks. Trivial undo/redo and time-travel debugging.
 - **Model-View-Intent** — Cleanly separate *what* happens (Model), *when* it happens (Intent), and *how* it looks (View).
-- **Tiny footprint** — Three runtime dependencies: [snabbdom](https://github.com/snabbdom/snabbdom), [xstream](https://github.com/staltz/xstream), and [extend](https://github.com/nicjohnson145/extend).
+- **Tiny footprint** — Two runtime dependencies: [snabbdom](https://github.com/snabbdom/snabbdom) and [xstream](https://github.com/staltz/xstream).
 
 ## Quick Start
 
@@ -186,19 +186,34 @@ import { makeDragDriver } from 'sygnal'
 run(RootComponent, { DND: makeDragDriver() })
 ```
 
+### HTTP and Sockets
+
+Requests name the actions that receive their reply; connections are declared from state:
+
+```jsx
+import { run, makeFetchDriver, makeSocketDriver } from 'sygnal'
+
+Quote.model = {
+  LOAD:   { HTTP: (state, id) => ({ url: `/api/quotes/${id}`, ok: 'LOADED', error: 'FAILED', latest: true }) },
+  LOADED: (state, quote) => ({ ...state, quote }),                 // the parsed body
+  FAILED: (state, { status }) => ({ ...state, error: status }),
+}
+
+Chat.connections = (state) => ({
+  room: state.room && { socket: `/ws/rooms/${state.room}`, message: 'RECEIVED' },
+})
+
+run(App, { HTTP: makeFetchDriver(), WS: makeSocketDriver() })
+```
+
 ### Custom Drivers
 
-Wrap any async operation as a driver:
+Wrap any other async operation as a driver; requests take the same reply actions (`{ value, ok: 'DONE', error: 'FAILED' }`):
 
 ```javascript
 import { driverFromAsync } from 'sygnal'
 
-const apiDriver = driverFromAsync(async (url) => {
-  const res = await fetch(url)
-  return res.json()
-}, { selector: 'endpoint', args: 'url', return: 'data' })
-
-run(RootComponent, { API: apiDriver })
+run(RootComponent, { GEO: driverFromAsync(geocode) })
 ```
 
 ### Error Boundaries
@@ -508,7 +523,7 @@ h('div', [h('h1', 'Hello'), h('button.btn', 'Click')])
 
 ## Acknowledgments
 
-Sygnal's reactive architecture is built on patterns from [Cycle.js](https://cycle.js.org/) by [André Staltz](https://github.com/staltz). The Cycle.js runtime, DOM driver, state management, and isolation modules have been absorbed into the library — snabbdom, xstream, and extend are the only external dependencies.
+Sygnal's reactive architecture is built on patterns from [Cycle.js](https://cycle.js.org/) by [André Staltz](https://github.com/staltz). The Cycle.js runtime, DOM driver, state management, and isolation modules have been absorbed into the library — snabbdom and xstream are the only external dependencies.
 
 ## License
 

package/dist/astro/client.cjs.js

@@ -1,14 +1,14 @@
 'use strict';
 
 var sygnal = require('sygnal');
+var onError = require('virtual:sygnal/astro-on-error');
 
 // The public entry (external in the build), so islands share the app's
 // Sygnal core instead of a bundled copy (B-019).
 function looksLikeSygnalComponent(Component) {
     if (typeof Component !== 'function')
         return false;
-    return Boolean(Component.isSygnalComponent ||
-        Component.model ||
+    return Boolean(Component.model ||
         Component.intent ||
         Component.initialState ||
         Component.componentName);
@@ -35,17 +35,21 @@ var client = (element) => {
         const Wrapped = (args) => Component({ ...islandProps, ...args, props: islandProps });
         Wrapped.model = Component.model;
         Wrapped.intent = Component.intent;
-        Wrapped.hmrActions = Component.hmrActions;
         Wrapped.context = Component.context;
-        Wrapped.peers = Component.peers;
-        Wrapped.components = Component.components;
         Wrapped.initialState = Component.initialState;
         Wrapped.calculated = Component.calculated;
-        Wrapped.storeCalculatedInState = Component.storeCalculatedInState;
-        Wrapped.DOMSourceName = Component.DOMSourceName;
-        Wrapped.stateSourceName = Component.stateSourceName;
         Wrapped.onError = Component.onError;
         Wrapped.debug = Component.debug;
+        Wrapped.connections = Component.connections;
+        Wrapped.resources = Component.resources;
+        Wrapped.route = Component.route;
+        Wrapped.head = Component.head;
+        // PLAN-4 3-B2: more statics the core reads off the root view: persist (root only: the island
+        // is its app's root), uses, timers (they run only with a timer driver) and viewTransitions
+        Wrapped.persist = Component.persist;
+        Wrapped.uses = Component.uses;
+        Wrapped.timers = Component.timers;
+        Wrapped.viewTransitions = Component.viewTransitions;
         Wrapped.componentName = Component.componentName || Component.name;
         // run() names the root by `name` first: diagnostics and devtools should
         // say 'Counter', not 'Wrapped'
@@ -53,7 +57,10 @@ var client = (element) => {
             Object.defineProperty(Wrapped, 'name', { value: Wrapped.componentName, configurable: true });
         }
         catch (_) { }
-        const app = sygnal.run(Wrapped, {}, { mountPoint });
+        // G-206: a `uid` island prop is the island's uid root (as on the server); the view's own
+        // uid() function wins over the prop (args are spread last)
+        // 3-B2: `__hydrate` tells persist() whether the island starts over the server's markup
+        const app = sygnal.run(Wrapped, { __hydrate: () => client !== 'only' && canHydrate }, { mountPoint, onError, uid: islandProps.uid });
         element.__sygnal = app;
     };
 };

package/dist/astro/client.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.cjs.js","sources":["../../src/astro/client.ts"],"sourcesContent":["// The public entry (external in the build), so islands share the app's\n// Sygnal core instead of a bundled copy (B-019).\nimport { run } from 'sygnal'\n\ninterface SygnalComponent {\n  (args: any): any;\n  isSygnalComponent?: boolean;\n  model?: any;\n  intent?: any;\n  hmrActions?: any;\n  context?: any;\n  peers?: any;\n  components?: any;\n  initialState?: any;\n  calculated?: any;\n  storeCalculatedInState?: any;\n  DOMSourceName?: string;\n  stateSourceName?: string;\n  onError?: (error: Error, info: { componentName: string }) => any;\n  debug?: boolean;\n  componentName?: string;\n  name?: string;\n}\n\ninterface AstroMetadata {\n  client?: string;\n}\n\nfunction looksLikeSygnalComponent(Component: any): Component is SygnalComponent {\n  if (typeof Component !== 'function') return false\n  return Boolean(\n    Component.isSygnalComponent ||\n      Component.model ||\n      Component.intent ||\n      Component.initialState ||\n      Component.componentName\n  )\n}\n\nexport default (element: any) => {\n  return async (Component: any, props: any, _slotted: any, metadata: AstroMetadata) => {\n    if (!looksLikeSygnalComponent(Component)) return\n\n    const mountPoint = element\n    const { client } = metadata || {}\n    const canHydrate = element.hasAttribute('ssr')\n\n    if (client !== 'only' && !canHydrate) return\n\n    const previous = element.__sygnal\n    if (previous && typeof previous.dispose === 'function') {\n      previous.dispose()\n    }\n\n    // Island props reach the view like any component's props, spread\n    // top-level (`{ state, title }`), the same as on the server\n    // (renderToString). The view args (state, context, ...) win over a prop\n    // with the same name; `props` is kept for older `({ state, props })`\n    // views (B-026).\n    const islandProps = { ...(props || {}) }\n    const Wrapped: any = (args: any) => Component({ ...islandProps, ...args, props: islandProps })\n    Wrapped.model = Component.model\n    Wrapped.intent = Component.intent\n    Wrapped.hmrActions = Component.hmrActions\n    Wrapped.context = Component.context\n    Wrapped.peers = Component.peers\n    Wrapped.components = Component.components\n    Wrapped.initialState = Component.initialState\n    Wrapped.calculated = Component.calculated\n    Wrapped.storeCalculatedInState = Component.storeCalculatedInState\n    Wrapped.DOMSourceName = Component.DOMSourceName\n    Wrapped.stateSourceName = Component.stateSourceName\n    Wrapped.onError = Component.onError\n    Wrapped.debug = Component.debug\n    Wrapped.componentName = Component.componentName || Component.name\n    // run() names the root by `name` first: diagnostics and devtools should\n    // say 'Counter', not 'Wrapped'\n    try { Object.defineProperty(Wrapped, 'name', { value: Wrapped.componentName, configurable: true }) } catch (_) {}\n\n    const app = run(Wrapped, {}, { mountPoint })\n    element.__sygnal = app\n  }\n}\n"],"names":["run"],"mappings":";;;;AAAA;AACA;AA2BA,SAAS,wBAAwB,CAAC,SAAc,EAAA;IAC9C,IAAI,OAAO,SAAS,KAAK,UAAU;AAAE,QAAA,OAAO,KAAK,CAAA;AACjD,IAAA,OAAO,OAAO,CACZ,SAAS,CAAC,iBAAiB;AACzB,QAAA,SAAS,CAAC,KAAK;AACf,QAAA,SAAS,CAAC,MAAM;AAChB,QAAA,SAAS,CAAC,YAAY;QACtB,SAAS,CAAC,aAAa,CAC1B,CAAA;AACH,CAAC;AAED,aAAe,CAAC,OAAY,KAAI;IAC9B,OAAO,OAAO,SAAc,EAAE,KAAU,EAAE,QAAa,EAAE,QAAuB,KAAI;AAClF,QAAA,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC;YAAE,OAAM;QAEhD,MAAM,UAAU,GAAG,OAAO,CAAA;AAC1B,QAAA,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,IAAI,EAAE,CAAA;QACjC,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;AAE9C,QAAA,IAAI,MAAM,KAAK,MAAM,IAAI,CAAC,UAAU;YAAE,OAAM;AAE5C,QAAA,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;QACjC,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE;YACtD,QAAQ,CAAC,OAAO,EAAE,CAAA;SACnB;;;;;;QAOD,MAAM,WAAW,GAAG,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC,EAAE,CAAA;QACxC,MAAM,OAAO,GAAQ,CAAC,IAAS,KAAK,SAAS,CAAC,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;AAC9F,QAAA,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAA;AAC/B,QAAA,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAA;AACjC,QAAA,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAA;AACzC,QAAA,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,CAAA;AACnC,QAAA,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAA;AAC/B,QAAA,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAA;AACzC,QAAA,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,YAAY,CAAA;AAC7C,QAAA,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAA;AACzC,QAAA,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,sBAAsB,CAAA;AACjE,QAAA,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,aAAa,CAAA;AAC/C,QAAA,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,eAAe,CAAA;AACnD,QAAA,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,CAAA;AACnC,QAAA,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAA;QAC/B,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,aAAa,IAAI,SAAS,CAAC,IAAI,CAAA;;;AAGjE,QAAA,IAAI;AAAE,YAAA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAA;SAAE;AAAC,QAAA,OAAO,CAAC,EAAE,GAAE;AAEjH,QAAA,MAAM,GAAG,GAAGA,UAAG,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAA;AAC5C,QAAA,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAA;AACxB,KAAC,CAAA;AACH,CAAC;;;;"}
+{"version":3,"file":"client.cjs.js","sources":["../../src/astro/client.ts"],"sourcesContent":["// The public entry (external in the build), so islands share the app's\n// Sygnal core instead of a bundled copy (B-019).\nimport { run } from 'sygnal'\n// PLAN-4 GS-11 / D120: the app-level error hook, the default export of the module the\n// integration's `onError` option names (undefined without it); served by sygnal/astro's Vite plugin\n// @ts-ignore — a virtual module\nimport onError from 'virtual:sygnal/astro-on-error'\n\ninterface SygnalComponent {\n  (args: any): any;\n  model?: any;\n  intent?: any;\n  connections?: any;\n  resources?: any;\n  route?: any;\n  head?: any;\n  persist?: any;\n  uses?: any;\n  timers?: any;\n  viewTransitions?: any;\n  context?: any;\n  initialState?: any;\n  calculated?: any;\n  onError?: (error: Error, info: { componentName: string }) => any;\n  debug?: boolean;\n  componentName?: string;\n  name?: string;\n}\n\ninterface AstroMetadata {\n  client?: string;\n}\n\nfunction looksLikeSygnalComponent(Component: any): Component is SygnalComponent {\n  if (typeof Component !== 'function') return false\n  return Boolean(\n    Component.model ||\n      Component.intent ||\n      Component.initialState ||\n      Component.componentName\n  )\n}\n\nexport default (element: any) => {\n  return async (Component: any, props: any, _slotted: any, metadata: AstroMetadata) => {\n    if (!looksLikeSygnalComponent(Component)) return\n\n    const mountPoint = element\n    const { client } = metadata || {}\n    const canHydrate = element.hasAttribute('ssr')\n\n    if (client !== 'only' && !canHydrate) return\n\n    const previous = element.__sygnal\n    if (previous && typeof previous.dispose === 'function') {\n      previous.dispose()\n    }\n\n    // Island props reach the view like any component's props, spread\n    // top-level (`{ state, title }`), the same as on the server\n    // (renderToString). The view args (state, context, ...) win over a prop\n    // with the same name; `props` is kept for older `({ state, props })`\n    // views (B-026).\n    const islandProps = { ...(props || {}) }\n    const Wrapped: any = (args: any) => Component({ ...islandProps, ...args, props: islandProps })\n    Wrapped.model = Component.model\n    Wrapped.intent = Component.intent\n    Wrapped.context = Component.context\n    Wrapped.initialState = Component.initialState\n    Wrapped.calculated = Component.calculated\n    Wrapped.onError = Component.onError\n    Wrapped.debug = Component.debug\n    Wrapped.connections = Component.connections\n    Wrapped.resources = Component.resources\n    Wrapped.route = Component.route\n    Wrapped.head = Component.head\n    // PLAN-4 3-B2: more statics the core reads off the root view: persist (root only: the island\n    // is its app's root), uses, timers (they run only with a timer driver) and viewTransitions\n    Wrapped.persist = Component.persist\n    Wrapped.uses = Component.uses\n    Wrapped.timers = Component.timers\n    Wrapped.viewTransitions = Component.viewTransitions\n    Wrapped.componentName = Component.componentName || Component.name\n    // run() names the root by `name` first: diagnostics and devtools should\n    // say 'Counter', not 'Wrapped'\n    try { Object.defineProperty(Wrapped, 'name', { value: Wrapped.componentName, configurable: true }) } catch (_) {}\n\n    // G-206: a `uid` island prop is the island's uid root (as on the server); the view's own\n    // uid() function wins over the prop (args are spread last)\n    // 3-B2: `__hydrate` tells persist() whether the island starts over the server's markup\n    const app = run(Wrapped, { __hydrate: () => client !== 'only' && canHydrate }, { mountPoint, onError, uid: islandProps.uid })\n    element.__sygnal = app\n  }\n}\n"],"names":["run"],"mappings":"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"}

package/dist/astro/client.mjs

@@ -1,12 +1,12 @@
 import { run } from 'sygnal';
+import onError from 'virtual:sygnal/astro-on-error';
 
 // The public entry (external in the build), so islands share the app's
 // Sygnal core instead of a bundled copy (B-019).
 function looksLikeSygnalComponent(Component) {
     if (typeof Component !== 'function')
         return false;
-    return Boolean(Component.isSygnalComponent ||
-        Component.model ||
+    return Boolean(Component.model ||
         Component.intent ||
         Component.initialState ||
         Component.componentName);
@@ -33,17 +33,21 @@ var client = (element) => {
         const Wrapped = (args) => Component({ ...islandProps, ...args, props: islandProps });
         Wrapped.model = Component.model;
         Wrapped.intent = Component.intent;
-        Wrapped.hmrActions = Component.hmrActions;
         Wrapped.context = Component.context;
-        Wrapped.peers = Component.peers;
-        Wrapped.components = Component.components;
         Wrapped.initialState = Component.initialState;
         Wrapped.calculated = Component.calculated;
-        Wrapped.storeCalculatedInState = Component.storeCalculatedInState;
-        Wrapped.DOMSourceName = Component.DOMSourceName;
-        Wrapped.stateSourceName = Component.stateSourceName;
         Wrapped.onError = Component.onError;
         Wrapped.debug = Component.debug;
+        Wrapped.connections = Component.connections;
+        Wrapped.resources = Component.resources;
+        Wrapped.route = Component.route;
+        Wrapped.head = Component.head;
+        // PLAN-4 3-B2: more statics the core reads off the root view: persist (root only: the island
+        // is its app's root), uses, timers (they run only with a timer driver) and viewTransitions
+        Wrapped.persist = Component.persist;
+        Wrapped.uses = Component.uses;
+        Wrapped.timers = Component.timers;
+        Wrapped.viewTransitions = Component.viewTransitions;
         Wrapped.componentName = Component.componentName || Component.name;
         // run() names the root by `name` first: diagnostics and devtools should
         // say 'Counter', not 'Wrapped'
@@ -51,7 +55,10 @@ var client = (element) => {
             Object.defineProperty(Wrapped, 'name', { value: Wrapped.componentName, configurable: true });
         }
         catch (_) { }
-        const app = run(Wrapped, {}, { mountPoint });
+        // G-206: a `uid` island prop is the island's uid root (as on the server); the view's own
+        // uid() function wins over the prop (args are spread last)
+        // 3-B2: `__hydrate` tells persist() whether the island starts over the server's markup
+        const app = run(Wrapped, { __hydrate: () => client !== 'only' && canHydrate }, { mountPoint, onError, uid: islandProps.uid });
         element.__sygnal = app;
     };
 };

package/dist/astro/client.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"client.mjs","sources":["../../src/astro/client.ts"],"sourcesContent":["// The public entry (external in the build), so islands share the app's\n// Sygnal core instead of a bundled copy (B-019).\nimport { run } from 'sygnal'\n\ninterface SygnalComponent {\n  (args: any): any;\n  isSygnalComponent?: boolean;\n  model?: any;\n  intent?: any;\n  hmrActions?: any;\n  context?: any;\n  peers?: any;\n  components?: any;\n  initialState?: any;\n  calculated?: any;\n  storeCalculatedInState?: any;\n  DOMSourceName?: string;\n  stateSourceName?: string;\n  onError?: (error: Error, info: { componentName: string }) => any;\n  debug?: boolean;\n  componentName?: string;\n  name?: string;\n}\n\ninterface AstroMetadata {\n  client?: string;\n}\n\nfunction looksLikeSygnalComponent(Component: any): Component is SygnalComponent {\n  if (typeof Component !== 'function') return false\n  return Boolean(\n    Component.isSygnalComponent ||\n      Component.model ||\n      Component.intent ||\n      Component.initialState ||\n      Component.componentName\n  )\n}\n\nexport default (element: any) => {\n  return async (Component: any, props: any, _slotted: any, metadata: AstroMetadata) => {\n    if (!looksLikeSygnalComponent(Component)) return\n\n    const mountPoint = element\n    const { client } = metadata || {}\n    const canHydrate = element.hasAttribute('ssr')\n\n    if (client !== 'only' && !canHydrate) return\n\n    const previous = element.__sygnal\n    if (previous && typeof previous.dispose === 'function') {\n      previous.dispose()\n    }\n\n    // Island props reach the view like any component's props, spread\n    // top-level (`{ state, title }`), the same as on the server\n    // (renderToString). The view args (state, context, ...) win over a prop\n    // with the same name; `props` is kept for older `({ state, props })`\n    // views (B-026).\n    const islandProps = { ...(props || {}) }\n    const Wrapped: any = (args: any) => Component({ ...islandProps, ...args, props: islandProps })\n    Wrapped.model = Component.model\n    Wrapped.intent = Component.intent\n    Wrapped.hmrActions = Component.hmrActions\n    Wrapped.context = Component.context\n    Wrapped.peers = Component.peers\n    Wrapped.components = Component.components\n    Wrapped.initialState = Component.initialState\n    Wrapped.calculated = Component.calculated\n    Wrapped.storeCalculatedInState = Component.storeCalculatedInState\n    Wrapped.DOMSourceName = Component.DOMSourceName\n    Wrapped.stateSourceName = Component.stateSourceName\n    Wrapped.onError = Component.onError\n    Wrapped.debug = Component.debug\n    Wrapped.componentName = Component.componentName || Component.name\n    // run() names the root by `name` first: diagnostics and devtools should\n    // say 'Counter', not 'Wrapped'\n    try { Object.defineProperty(Wrapped, 'name', { value: Wrapped.componentName, configurable: true }) } catch (_) {}\n\n    const app = run(Wrapped, {}, { mountPoint })\n    element.__sygnal = app\n  }\n}\n"],"names":[],"mappings":";;AAAA;AACA;AA2BA,SAAS,wBAAwB,CAAC,SAAc,EAAA;IAC9C,IAAI,OAAO,SAAS,KAAK,UAAU;AAAE,QAAA,OAAO,KAAK,CAAA;AACjD,IAAA,OAAO,OAAO,CACZ,SAAS,CAAC,iBAAiB;AACzB,QAAA,SAAS,CAAC,KAAK;AACf,QAAA,SAAS,CAAC,MAAM;AAChB,QAAA,SAAS,CAAC,YAAY;QACtB,SAAS,CAAC,aAAa,CAC1B,CAAA;AACH,CAAC;AAED,aAAe,CAAC,OAAY,KAAI;IAC9B,OAAO,OAAO,SAAc,EAAE,KAAU,EAAE,QAAa,EAAE,QAAuB,KAAI;AAClF,QAAA,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC;YAAE,OAAM;QAEhD,MAAM,UAAU,GAAG,OAAO,CAAA;AAC1B,QAAA,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,IAAI,EAAE,CAAA;QACjC,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;AAE9C,QAAA,IAAI,MAAM,KAAK,MAAM,IAAI,CAAC,UAAU;YAAE,OAAM;AAE5C,QAAA,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;QACjC,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE;YACtD,QAAQ,CAAC,OAAO,EAAE,CAAA;SACnB;;;;;;QAOD,MAAM,WAAW,GAAG,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC,EAAE,CAAA;QACxC,MAAM,OAAO,GAAQ,CAAC,IAAS,KAAK,SAAS,CAAC,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;AAC9F,QAAA,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAA;AAC/B,QAAA,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAA;AACjC,QAAA,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAA;AACzC,QAAA,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,CAAA;AACnC,QAAA,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAA;AAC/B,QAAA,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAA;AACzC,QAAA,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,YAAY,CAAA;AAC7C,QAAA,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAA;AACzC,QAAA,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,sBAAsB,CAAA;AACjE,QAAA,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,aAAa,CAAA;AAC/C,QAAA,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,eAAe,CAAA;AACnD,QAAA,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,CAAA;AACnC,QAAA,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAA;QAC/B,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,aAAa,IAAI,SAAS,CAAC,IAAI,CAAA;;;AAGjE,QAAA,IAAI;AAAE,YAAA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAA;SAAE;AAAC,QAAA,OAAO,CAAC,EAAE,GAAE;AAEjH,QAAA,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAA;AAC5C,QAAA,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAA;AACxB,KAAC,CAAA;AACH,CAAC;;;;"}
+{"version":3,"file":"client.mjs","sources":["../../src/astro/client.ts"],"sourcesContent":["// The public entry (external in the build), so islands share the app's\n// Sygnal core instead of a bundled copy (B-019).\nimport { run } from 'sygnal'\n// PLAN-4 GS-11 / D120: the app-level error hook, the default export of the module the\n// integration's `onError` option names (undefined without it); served by sygnal/astro's Vite plugin\n// @ts-ignore — a virtual module\nimport onError from 'virtual:sygnal/astro-on-error'\n\ninterface SygnalComponent {\n  (args: any): any;\n  model?: any;\n  intent?: any;\n  connections?: any;\n  resources?: any;\n  route?: any;\n  head?: any;\n  persist?: any;\n  uses?: any;\n  timers?: any;\n  viewTransitions?: any;\n  context?: any;\n  initialState?: any;\n  calculated?: any;\n  onError?: (error: Error, info: { componentName: string }) => any;\n  debug?: boolean;\n  componentName?: string;\n  name?: string;\n}\n\ninterface AstroMetadata {\n  client?: string;\n}\n\nfunction looksLikeSygnalComponent(Component: any): Component is SygnalComponent {\n  if (typeof Component !== 'function') return false\n  return Boolean(\n    Component.model ||\n      Component.intent ||\n      Component.initialState ||\n      Component.componentName\n  )\n}\n\nexport default (element: any) => {\n  return async (Component: any, props: any, _slotted: any, metadata: AstroMetadata) => {\n    if (!looksLikeSygnalComponent(Component)) return\n\n    const mountPoint = element\n    const { client } = metadata || {}\n    const canHydrate = element.hasAttribute('ssr')\n\n    if (client !== 'only' && !canHydrate) return\n\n    const previous = element.__sygnal\n    if (previous && typeof previous.dispose === 'function') {\n      previous.dispose()\n    }\n\n    // Island props reach the view like any component's props, spread\n    // top-level (`{ state, title }`), the same as on the server\n    // (renderToString). The view args (state, context, ...) win over a prop\n    // with the same name; `props` is kept for older `({ state, props })`\n    // views (B-026).\n    const islandProps = { ...(props || {}) }\n    const Wrapped: any = (args: any) => Component({ ...islandProps, ...args, props: islandProps })\n    Wrapped.model = Component.model\n    Wrapped.intent = Component.intent\n    Wrapped.context = Component.context\n    Wrapped.initialState = Component.initialState\n    Wrapped.calculated = Component.calculated\n    Wrapped.onError = Component.onError\n    Wrapped.debug = Component.debug\n    Wrapped.connections = Component.connections\n    Wrapped.resources = Component.resources\n    Wrapped.route = Component.route\n    Wrapped.head = Component.head\n    // PLAN-4 3-B2: more statics the core reads off the root view: persist (root only: the island\n    // is its app's root), uses, timers (they run only with a timer driver) and viewTransitions\n    Wrapped.persist = Component.persist\n    Wrapped.uses = Component.uses\n    Wrapped.timers = Component.timers\n    Wrapped.viewTransitions = Component.viewTransitions\n    Wrapped.componentName = Component.componentName || Component.name\n    // run() names the root by `name` first: diagnostics and devtools should\n    // say 'Counter', not 'Wrapped'\n    try { Object.defineProperty(Wrapped, 'name', { value: Wrapped.componentName, configurable: true }) } catch (_) {}\n\n    // G-206: a `uid` island prop is the island's uid root (as on the server); the view's own\n    // uid() function wins over the prop (args are spread last)\n    // 3-B2: `__hydrate` tells persist() whether the island starts over the server's markup\n    const app = run(Wrapped, { __hydrate: () => client !== 'only' && canHydrate }, { mountPoint, onError, uid: islandProps.uid })\n    element.__sygnal = app\n  }\n}\n"],"names":[],"mappings":";;;AAAA;AACA;AAgCA,SAAS,wBAAwB,CAAC,SAAc,EAAA;IAC9C,IAAI,OAAO,SAAS,KAAK,UAAU;AAAE,QAAA,OAAO,KAAK,CAAA;AACjD,IAAA,OAAO,OAAO,CACZ,SAAS,CAAC,KAAK;AACb,QAAA,SAAS,CAAC,MAAM;AAChB,QAAA,SAAS,CAAC,YAAY;QACtB,SAAS,CAAC,aAAa,CAC1B,CAAA;AACH,CAAC;AAED,aAAe,CAAC,OAAY,KAAI;IAC9B,OAAO,OAAO,SAAc,EAAE,KAAU,EAAE,QAAa,EAAE,QAAuB,KAAI;AAClF,QAAA,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC;YAAE,OAAM;QAEhD,MAAM,UAAU,GAAG,OAAO,CAAA;AAC1B,QAAA,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,IAAI,EAAE,CAAA;QACjC,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;AAE9C,QAAA,IAAI,MAAM,KAAK,MAAM,IAAI,CAAC,UAAU;YAAE,OAAM;AAE5C,QAAA,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;QACjC,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE;YACtD,QAAQ,CAAC,OAAO,EAAE,CAAA;SACnB;;;;;;QAOD,MAAM,WAAW,GAAG,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC,EAAE,CAAA;QACxC,MAAM,OAAO,GAAQ,CAAC,IAAS,KAAK,SAAS,CAAC,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;AAC9F,QAAA,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAA;AAC/B,QAAA,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAA;AACjC,QAAA,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,CAAA;AACnC,QAAA,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,YAAY,CAAA;AAC7C,QAAA,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAA;AACzC,QAAA,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,CAAA;AACnC,QAAA,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAA;AAC/B,QAAA,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,WAAW,CAAA;AAC3C,QAAA,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAA;AACvC,QAAA,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAA;AAC/B,QAAA,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAA;;;AAG7B,QAAA,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,CAAA;AACnC,QAAA,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAA;AAC7B,QAAA,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAA;AACjC,QAAA,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,eAAe,CAAA;QACnD,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,aAAa,IAAI,SAAS,CAAC,IAAI,CAAA;;;AAGjE,QAAA,IAAI;AAAE,YAAA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAA;SAAE;AAAC,QAAA,OAAO,CAAC,EAAE,GAAE;;;;AAKjH,QAAA,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,MAAM,KAAK,MAAM,IAAI,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,CAAC,CAAA;AAC7H,QAAA,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAA;AACxB,KAAC,CAAA;AACH,CAAC;;;;"}