sygnal 5.4.0 → 6.0.0

package/dist/react.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.esm.js","sources":["../src/react.ts"],"sourcesContent":["/*\n * 'sygnal/react' (PLAN-5 W-2, D203): `fromReact(Component, { events })`, a React component as a\n * widget tag (defineWidget). An escape hatch for the one component you can't replace: context\n * and providers don't cross the boundary, a React portal renders outside the host, and the mock\n * DOM can't run it (test with `dom: 'real'`).\n *\n *   const Stars = fromReact(StarRating, { events: { rate: 'onChange' } })\n *   // view:   <Stars className=\"rating\" value={state.rating} max={5} />\n *   // intent: RATE: DOM.select('.rating').events('rate').detail()\n *\n * - Each host is a React root (react-dom/client createRoot). `mount` and `update` render the\n *   component with the newest props in flushSync, so the DOM is up to date when they return.\n * - `events`: `{ eventName: 'onCallback' }`, or an array of callback names, each dispatched under\n *   its own name (`['onChange']` → 'onChange'; React's names never collide with native events).\n *   The detail is the callback's argument (an array when it gets more than one). The component\n *   gets a callback for each, and a callback passed as a prop runs first.\n * - Props (D215): `className`, `class`, `id`, `style`, `attrs`, `tabIndex` and `hidden` go to the\n *   host only (one tab stop); `aria-*`, `role` and `title` to the component only (a labelled\n *   React control gets its own name; the host div is generic); `data-*` to both; the rest to the\n *   component (`name`, `placeholder`, `lang`, `dir` also to the host, as for any widget).\n *   `ownProps: ['tabIndex']` sends a host prop to the component instead; `hostProps: ['role']`\n *   puts a component-only one on the host too. `props` maps the component's props:\n *   `props: (p) => ({ ...p, size: 'small' })`.\n * - Unmount: `root.unmount()` in a microtask (React refuses a synchronous unmount while it is\n *   rendering, which a callback → action → re-render chain can be in), and only once the host\n *   has left the document (G-412: inside a <Transition>, the content stays during the leave),\n *   seen in shadow roots too (G-437); a destroyed host still in the DOM after 10 s unmounts then.\n * - SSR: the host with the `fallback` (no React on the server here).\n * - preact/compat: alias `react` and `react-dom` to `preact/compat`, and `react-dom/client` to\n *   `preact/compat/client`, in the bundler; the adapter only uses createElement, createRoot and\n *   flushSync.\n *\n * Separate entry: './index' becomes the external 'sygnal'; react and react-dom stay external\n * (optional peerDependencies, D209).\n */\nimport {createElement} from 'react'\nimport {flushSync} from 'react-dom'\nimport {createRoot} from 'react-dom/client'\nimport {defineWidget} from './index'\n\n// D215: the host's own props (the component doesn't get them): tabIndex / hidden too, so a\n// focusable host isn't doubled inside (two tab stops)\nconst HOST = /^(className|class|id|style|attrs|tab[iI]ndex|hidden)$/\n// D215 (G-436): the component's own (kept off the host): a React control names itself\nconst OWN = /^(aria-|role$|title$)/\n\nconst fail = (m: string): never => {\n  throw new Error(`[Sygnal SYG667] ${m}. https://sygnal.js.org/reference/errors#syg667`)\n}\n\n// G-412: run f once the host has left the document. A host still in it is leaving with a delay\n// (a <Transition> leave animation): its React content stays until the element is removed.\n// G-437: the removal can happen inside a shadow root (sygnal/element `shadow: true`), which a\n// document observer doesn't see: every root on the way up (shadow roots, then the document) is\n// observed. A destroyed host that stays in the DOM (a leave whose transitionend never comes, a\n// tree left in place) is unmounted after LATE ms anyway, so no React root or observer leaks.\nconst LATE = 10000\nconst gone = (el: any, f: () => void) => {\n  if (!el.isConnected) return f()\n  let t: any\n  const done = () => { o.disconnect(); clearTimeout(t); f() }\n  const o: MutationObserver = new MutationObserver(() => { if (!el.isConnected) done() })\n  for (let r = el.getRootNode(); r; r = r.host?.getRootNode()) o.observe(r, {childList: true, subtree: true})\n  t = setTimeout(done, LATE)\n}\n\n/**\n * A React component as a widget tag: `fromReact(Comp, { events, props, tag, name, fallback,\n * hostProps, commands })`. `commands` are called with the instance `{ root, el, props }`.\n */\nexport function fromReact(Comp: any, options: any = {}): any {\n  if (typeof Comp != 'function' && !(Comp && typeof Comp == 'object' && Comp.$$typeof)) {\n    fail('fromReact(Component): the first argument is not a React component')\n  }\n  const o = options, ev = o.events || {}\n  // event name → callback prop name\n  const events: Record<string, string> = Array.isArray(ev) ? Object.fromEntries(ev.map((c: string) => [c, c])) : ev\n  const draw = (i: any, p: any) => {\n    const q: any = {}\n    for (const k in p) if (!HOST.test(k) || o.ownProps?.includes(k)) q[k] = p[k]\n    const rp = o.props ? o.props(q) : q\n    for (const name in events) {\n      const cb = events[name], own = rp[cb]\n      rp[cb] = (...a: any[]) => {\n        own?.(...a)\n        i.d(name, a.length > 1 ? a : a[0])\n      }\n    }\n    i.props = rp\n    flushSync(() => i.root.render(createElement(Comp, rp)))\n  }\n  return defineWidget({\n    tag: o.tag,\n    name: o.name || Comp.displayName || Comp.name,\n    fallback: o.fallback,\n    hostProps: o.hostProps,\n    // D215: aria-* / role / title stay off the host unless hostProps names one (the list is the\n    // option's; its includes() also matches those patterns, which is all defineWidget asks of it)\n    ownProps: Object.assign([...(o.ownProps || [])], {includes: (k: string) => !!o.ownProps?.includes(k) || OWN.test(k) && !o.hostProps?.includes(k)}),\n    events: Object.keys(events),\n    commands: o.commands,\n    mount: (el: any, p: any, d: any) => {\n      const i = {root: createRoot(el), el, d, props: null}\n      draw(i, p)\n      return i\n    },\n    update: draw,\n    unmount: (i: any) => { queueMicrotask(() => gone(i.el, () => i.root.unmount())) },\n  })\n}\n"],"names":[],"mappings":"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"}

package/dist/shims/globalthis.cjs

@@ -0,0 +1,20 @@
+'use strict';
+
+/**
+ * Stand-in for the `globalthis` npm package (built to dist/shims/globalthis.cjs).
+ *
+ * xstream does `require('globalthis').getPolyfill()`, which pulls a polyfill
+ * chain (define-properties, get-intrinsic, object-keys, has-symbols, ...) into
+ * every app bundle (~4 KB gzip). Every browser and Node version Sygnal supports
+ * has a native `globalThis`, so `sygnal/vite` aliases `globalthis` to this
+ * module (opt out with `sygnal({ nativeGlobalThis: false })`).
+ *
+ * Same shape as the package's main export (the es-shim API): a function that
+ * returns the global object, with `getPolyfill`, `implementation` and `shim`.
+ */
+const getGlobal = () => globalThis;
+getGlobal.getPolyfill = getGlobal;
+getGlobal.implementation = globalThis;
+getGlobal.shim = getGlobal;
+
+module.exports = getGlobal;