sygnal 6.3.0 → 6.4.0

package/dist/index.d.ts

@@ -2495,7 +2495,7 @@ type EventNextFunction = (action: string, data?: any, delay?: number) => void
 
 /** Payload function for `event()` / `emit()`: receives the reducer arguments, returns the event data. */
 type EventPayloadFunction<TYPE extends string = string, STATE = any, DATA = any> =
-  (state: STATE, data: DATA, next: EventNextFunction, props: any) => EventPayload<TYPE>
+  (state: STATE, data: DATA, next: EventNextFunction, props: any) => EventPayload<TYPE> | ABORT
 
 /**
  * Remaining arguments of `event()` / `emit()` when the payload is a static value.
@@ -4301,7 +4301,8 @@ declare function emit<TYPE extends EventName>(
  *   }
  *
  * The payload is either a function `(state, data, next, props) => payload` or a static value:
- *   `event('RESET')`, `event('SET_MODE', 'dark')`.
+ *   `event('RESET')`, `event('SET_MODE', 'dark')`. A payload function that returns `ABORT` sends
+ *   nothing: `event('SAVED', (state) => state.dirty ? { id: state.id } : ABORT)`.
  *
  * With a `SygnalEvents` registry, `type` must be a registered name and the payload must match
  * its type. When used inside a model, the payload function's `state` and `data` parameters are
@@ -5329,6 +5330,12 @@ interface ServiceWorkerCommand {
 
 interface ServiceWorkerOptions {
   scope?: string;
+  /**
+   * `false`: the driver registers no service worker, ignores commands and emits nothing, so the
+   * app keeps its `SW` wiring where a worker must not run: `enabled: import.meta.env.PROD`.
+   * Default `true`.
+   */
+  enabled?: boolean;
 }
 
 declare function makeServiceWorkerDriver(

package/dist/index.esm.js

@@ -766,6 +766,8 @@ const DEV_CODE_SEVERITY = {
     SYG425: 'warn',
     // PLAN-9 (checks/next.ts): D471 a lowercase <collection> / <switchable> tag (deprecated in 6.3.0)
     SYG426: 'warn',
+    // checks/next.ts: CHILD.select(undefined), usually a missing export
+    SYG427: 'error',
     // PLAN-9 (checks/next.ts): D470 key identity, two children with one identity
     SYG453: 'warn',
     SYG612: 'error',
@@ -17441,10 +17443,14 @@ function toggle(field) {
     return (state) => ({ ...state, [field]: !state[field] });
 }
 // event(type, payload?) → EVENTS sink fn for the object form:
-// `ACTION: { EVENTS: event('TYPE', (state, data) => payload) }` (static payloads allowed)
+// `ACTION: { EVENTS: event('TYPE', (state, data) => payload) }` (static payloads allowed).
+// A payload function that returns ABORT sends nothing, as ABORT does from any other sink.
 function event(type, payload) {
     return typeof payload === 'function'
-        ? (state, data, next, props) => ({ type, data: payload(state, data, next, props) })
+        ? (state, data, next, props) => {
+            const d = payload(state, data, next, props);
+            return isAbort(d) ? ABORT : { type, data: d };
+        }
         : () => ({ type, data: payload });
 }
 // ── emit() ─────────────────────────────────────────────────────────
@@ -17482,7 +17488,7 @@ function trackWorker(worker, events) {
 function makeServiceWorkerDriver(scriptUrl, options = {}) {
     return function serviceWorkerDriver(sink$) {
         const events = new EventTarget();
-        if (typeof navigator !== 'undefined' && 'serviceWorker' in navigator) {
+        if (options.enabled !== false && typeof navigator !== 'undefined' && 'serviceWorker' in navigator) {
             navigator.serviceWorker
                 .register(scriptUrl, { scope: options.scope })
                 .then((reg) => {