reifyui 0.11.1 → 0.13.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +31 -2
- package/dist/chart.js +2 -0
- package/dist/chart.js.map +1 -1
- package/dist/chunk-EL2DHWOH.js +1710 -0
- package/dist/chunk-EL2DHWOH.js.map +1 -0
- package/dist/chunk-J633KV57.js +41 -0
- package/dist/chunk-J633KV57.js.map +1 -0
- package/dist/chunk-J7SECRIG.js +295 -0
- package/dist/chunk-J7SECRIG.js.map +1 -0
- package/dist/chunk-PIRPLH2Z.js +231 -0
- package/dist/chunk-PIRPLH2Z.js.map +1 -0
- package/dist/chunk-PZ5AY32C.js +10 -0
- package/dist/chunk-PZ5AY32C.js.map +1 -0
- package/dist/chunk-UKG4Z6QK.js +130 -0
- package/dist/chunk-UKG4Z6QK.js.map +1 -0
- package/dist/chunk-ZYWE47EO.js +19 -0
- package/dist/chunk-ZYWE47EO.js.map +1 -0
- package/dist/collab.cjs +169 -0
- package/dist/collab.cjs.map +1 -0
- package/dist/collab.d.ts +30 -0
- package/dist/collab.js +18 -0
- package/dist/collab.js.map +1 -0
- package/dist/graph.cjs +2244 -0
- package/dist/graph.cjs.map +1 -0
- package/dist/graph.d.ts +41 -0
- package/dist/graph.js +1870 -0
- package/dist/graph.js.map +1 -0
- package/dist/harness.js +1 -0
- package/dist/harness.js.map +1 -1
- package/dist/index.cjs +2044 -867
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +20 -2
- package/dist/index.js +892 -1686
- package/dist/index.js.map +1 -1
- package/dist/sheet-doc.cjs +235 -0
- package/dist/sheet-doc.cjs.map +1 -0
- package/dist/sheet-doc.d.ts +16 -0
- package/dist/sheet-doc.js +20 -0
- package/dist/sheet-doc.js.map +1 -0
- package/dist/sheet.cjs +2322 -0
- package/dist/sheet.cjs.map +1 -0
- package/dist/sheet.d.ts +23 -0
- package/dist/sheet.js +237 -0
- package/dist/sheet.js.map +1 -0
- package/dist/slides.js +2 -0
- package/dist/slides.js.map +1 -1
- package/package.json +35 -3
- package/src/auth/client.js +4 -2
- package/src/collab/colors.js +18 -0
- package/src/collab/index.d.ts +30 -0
- package/src/collab/index.js +8 -0
- package/src/collab/keepAlive.js +34 -0
- package/src/collab/useLiveDoc.js +76 -0
- package/src/components/CascadeMenu.jsx +216 -0
- package/src/components/ChatMessages.jsx +30 -9
- package/src/components/Chip.jsx +37 -10
- package/src/components/Composer.jsx +80 -2
- package/src/components/resizable.jsx +82 -12
- package/src/graph/ConnectPane.jsx +634 -0
- package/src/graph/ConnectToolDetail.jsx +565 -0
- package/src/graph/LogsPane.jsx +328 -0
- package/src/graph/Skeleton.jsx +13 -0
- package/src/graph/draft.js +108 -0
- package/src/graph/format.js +37 -0
- package/src/graph/index.d.ts +41 -0
- package/src/graph/index.js +14 -0
- package/src/graph/useGraphCollab.js +299 -0
- package/src/graph/vgraph.js +215 -0
- package/src/index.d.ts +20 -2
- package/src/index.js +6 -1
- package/src/mention/MentionInput.jsx +420 -0
- package/src/mention/mentionModel.js +177 -0
- package/src/sheet/RunStrip.jsx +57 -0
- package/src/sheet/SheetGrid.jsx +444 -353
- package/src/sheet/doc.d.ts +16 -0
- package/src/sheet/index.d.ts +23 -0
- package/src/sheet/index.js +10 -0
- package/src/sheet/sheetDoc.js +203 -0
- package/src/sheet/useSheetCollab.js +102 -0
- package/src/sheet/useSheetRun.js +80 -0
- package/styles/chat.css +47 -5
- package/styles/chip.css +36 -0
- package/styles/graph.css +395 -0
- package/styles/mention.css +79 -0
- package/styles/sheet.css +156 -112
package/README.md
CHANGED
|
@@ -53,7 +53,7 @@ A production-grade surface for rendering and interacting with a live agent turn:
|
|
|
53
53
|
| **Block state** | `withText`, `withReasoning`, `withStep`, `withResult`, `asstText`, `createConversationStore` — session-continuation state machine |
|
|
54
54
|
| **Chat surface** | `ChatMessages`, `UserTurn`, `AssistantTurn`, `ToolGroup`, `ToolRow`, `Composer` — message list + a collapsible "ran 5 commands, wrote a file" tool-step timeline |
|
|
55
55
|
| **Chat panel** | `ChatPanel` — the whole conversation column beside a document: history replay, the live turn, connecting-and-retry, attachments, dictation, composer. You supply `runTurn` and `loadHistory`; it owns everything else. `turnsToMessages`, `createDictation`, `bytesLabel` |
|
|
56
|
-
| **Library page** | `Carousel`, `Card`, `Chip`, `SearchField`, `Popover`, `Modal`, `useTypewriter` — the surface a document product opens on: a prompt box, a strip of templates, the things you already made |
|
|
56
|
+
| **Library page** | `Carousel`, `Card`, `Chip`, `SearchField`, `Popover`, `CascadeMenu`, `Modal`, `useTypewriter` — the surface a document product opens on: a prompt box, a strip of templates, the things you already made |
|
|
57
57
|
| **Rich blocks** | `CodeBlock` (highlight.js + mermaid + charts), `useResizablePane`, `PaneResizer` |
|
|
58
58
|
| **Task list** | `TaskList`, `taskStatusGroup` — the master list beside a conversation: live status, filtering, cursor pagination. Transport-agnostic: you supply `fetchPage(cursor)` |
|
|
59
59
|
| **Dialogs** | `DialogHost`, `useDialog` — awaited in-app `alert` / `confirm` / `prompt`, so a destructive tool call or a "name this" step never falls back to a browser popup |
|
|
@@ -148,7 +148,7 @@ import 'reifyui/styles/chat.css'; // chat surface + tool steps + compos
|
|
|
148
148
|
import 'reifyui/styles/themes/light.css'; // light theme variables
|
|
149
149
|
import 'reifyui/styles/themes/dark.css'; // dark theme variables
|
|
150
150
|
import 'reifyui/styles/library.css'; // shell, hero, prompt box, carousel, card, table
|
|
151
|
-
import 'reifyui/styles/chip.css'; // Chip + Popover
|
|
151
|
+
import 'reifyui/styles/chip.css'; // Chip + Popover + CascadeMenu
|
|
152
152
|
import 'reifyui/styles/preview.css'; // Modal
|
|
153
153
|
import 'reifyui/styles/slides.css'; // slides
|
|
154
154
|
import 'reifyui/styles/sheet.css'; // spreadsheet grid
|
|
@@ -326,6 +326,35 @@ Three pieces a board needs are stylesheet-only, with no component to import: `.u
|
|
|
326
326
|
headline number, `.uic-dtable` for a result table that scrolls inside its own box, and `.uic-note`
|
|
327
327
|
for a panel that ran and found nothing. Compose them directly.
|
|
328
328
|
|
|
329
|
+
## Collaboration
|
|
330
|
+
|
|
331
|
+
Any surface can be live: `reifyui/collab` is one document core (Yjs through a Hocuspocus
|
|
332
|
+
provider) with presence colours and a worker-clock keep-alive, so a hidden tab's cursor never
|
|
333
|
+
lapses. It is a separate entry because it pulls in `yjs` and `@hocuspocus/provider`; importing
|
|
334
|
+
a Button never costs a CRDT.
|
|
335
|
+
|
|
336
|
+
```js
|
|
337
|
+
import { useLiveDoc, keepPresenceAlive, peerColor } from 'reifyui/collab';
|
|
338
|
+
|
|
339
|
+
const live = useLiveDoc({ url, name: `cg-sheet:${id}`, token });
|
|
340
|
+
```
|
|
341
|
+
|
|
342
|
+
`reifyui/sheet` binds the spreadsheet to it: `useSheetCollab` turns the live document into the
|
|
343
|
+
grid's `sheet` + `ops` + `peers`, `useSheetRun` and `RunStrip` drive a batch run, and `sheetDoc`
|
|
344
|
+
is the document family every writer speaks (browsers and services alike). A service that has no
|
|
345
|
+
React imports the family alone from `reifyui/sheet-doc`.
|
|
346
|
+
|
|
347
|
+
`reifyui/graph` does the same for a graph resource: `useGraphCollab` makes the canvas live, and
|
|
348
|
+
the `ConnectPane` / `LogsPane` surfaces take an injected `client` (`getConnect`, `putConnect`,
|
|
349
|
+
`testConnectTool`, `listConnectKeys`, `createConnectKey`, `revokeConnectKey`, `fetchAudit`,
|
|
350
|
+
`endpointUrl(path)`) bound to the host's API and auth; the graph transport is configured once
|
|
351
|
+
with `configureVgraph(transport)`. Nothing in the package knows a host's API base.
|
|
352
|
+
|
|
353
|
+
Stylesheets: `reifyui/styles/sheet.css`, `reifyui/styles/graph.css` (the panes; they render
|
|
354
|
+
their dialogs in the package's Modal, so also `reifyui/styles/preview.css`) and
|
|
355
|
+
`reifyui/styles/mention.css` for `MentionInput`, the field that holds people, columns and files
|
|
356
|
+
as pills with a menu at the caret.
|
|
357
|
+
|
|
329
358
|
## Optional: auth client
|
|
330
359
|
|
|
331
360
|
ReifyUI includes a small, framework-agnostic auth client for products whose backend exposes a JSON
|
package/dist/chart.js
CHANGED
package/dist/chart.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/chart/Chart.jsx","../src/chart/tokens.js","../src/chart/useChartTokens.js"],"sourcesContent":["// Chart — an ECharts option, drawn. That is the whole component.\n//\n// It deliberately knows nothing about series, axes or data shape: the option IS the contract, so\n// anything ECharts can draw, this draws, and the thing that decides what a chart should look like\n// (a person, or an agent writing the option) is not limited by a props table. What it does own is\n// the part every hand-rolled wrapper gets wrong: creating the instance once, disposing it on\n// unmount, and resizing it when its box changes — a chart inside a resizable panel that never\n// hears about the resize is the most common broken dashboard there is.\n//\n// echarts is an OPTIONAL peer, loaded lazily here, which is why this lives at `reifyui/chart` and\n// not in the root index — the same reason `reifyui/slides` is its own entry. An app that imports\n// a Button must not resolve a charting library.\nimport { useEffect, useRef, useState } from 'react';\n\n/**\n * option the ECharts option. Applied whenever the REFERENCE changes, so build it in a\n * useMemo — a fresh object every render redraws the chart every render\n * renderer 'canvas' (default) or 'svg'; svg stays crisp when the page is printed or scaled\n * notMerge replace the previous option rather than merging into it (default true: a redraw\n * after new data should not inherit last query's series)\n * onInit the instance, once, for the things only the instance can do (export an image)\n * label the chart's accessible name; a canvas has no text for a screen reader to find\n * fallback drawn instead when the chart code cannot be loaded at all\n */\nexport function Chart(props) {\n const { option, renderer = 'canvas', notMerge = true, onInit, label, fallback = null, className = '' } = props;\n const host = useRef(null);\n const inst = useRef(null);\n const applied = useRef(null); // the option the instance is currently showing\n const [failed, setFailed] = useState(false);\n // Read through refs inside the init effect so a new option or callback does not tear the\n // instance down and rebuild it.\n const latest = useRef({ option, notMerge, onInit });\n latest.current = { option, notMerge, onInit };\n\n useEffect(() => {\n let dead = false;\n (async () => {\n try {\n const mod = await import('echarts');\n const echarts = typeof mod.init === 'function' ? mod : (mod.default || mod);\n if (dead || !host.current) return;\n const chart = echarts.init(host.current, null, { renderer });\n inst.current = chart;\n const { option: opt, notMerge: nm, onInit: cb } = latest.current;\n if (opt) { chart.setOption(opt, nm); applied.current = opt; }\n if (cb) cb(chart);\n } catch {\n if (!dead) setFailed(true); // no chart code: say so, never draw a fake one\n }\n })();\n return () => {\n dead = true;\n try { inst.current?.dispose(); } catch { /* already gone with the DOM */ }\n inst.current = null;\n applied.current = null;\n };\n }, [renderer]);\n\n // `applied` keeps this from redrawing the option the init above just drew — the instance\n // arrives asynchronously, so both paths run on the first render that has one.\n useEffect(() => {\n if (!inst.current || !option || applied.current === option) return;\n inst.current.setOption(option, notMerge);\n applied.current = option;\n }, [option, notMerge]);\n\n useEffect(() => {\n const el = host.current;\n if (!el || typeof ResizeObserver !== 'function') return undefined;\n let frame = 0;\n const ro = new ResizeObserver(() => {\n // One resize per frame: a drag on a panel corner fires the observer on every pointer move.\n cancelAnimationFrame(frame);\n frame = requestAnimationFrame(() => inst.current?.resize());\n });\n ro.observe(el);\n return () => { cancelAnimationFrame(frame); ro.disconnect(); };\n }, []);\n\n if (failed) return <div className={['uic-chart', 'is-unavailable', className].filter(Boolean).join(' ')}>{fallback}</div>;\n return (\n <div\n ref={host}\n className={['uic-chart', className].filter(Boolean).join(' ')}\n role={label ? 'img' : undefined}\n aria-label={label}\n />\n );\n}\n","// The theme, as values a chart library can use.\n//\n// A chart draws into a canvas, where CSS custom properties do not reach: series colours, axis\n// labels and tooltip chrome all arrive as strings in an option object. Without this, every app\n// hardcodes hex in its chart code and the charts are the one part of the product that does not\n// follow the theme. Reading the same --uic-* tokens the stylesheets read keeps them together.\n\n// Same policy as the `var(--uic-x, …)` fallbacks in the stylesheets: a host that never loaded a\n// token layer still gets the library's own light palette rather than whatever the chart library\n// defaults to. Values are themes/light.css verbatim.\nconst FALLBACK = {\n cat: ['#2a78d6', '#eb6834', '#1baf7a', '#eda100', '#e87ba4', '#008300', '#4a3aa7', '#e34948'],\n ink: '#111317', ink2: '#3A3D45', mute: '#5B5D66',\n line: '#DDDFE6', lineSoft: '#EFF1F4', surface: '#FFFFFF',\n brand: '#285AFF', ok: '#16a34a', warn: '#F59E0B', bad: '#b91c1c',\n font: 'inherit',\n};\n\nfunction read(style, name, fallback) {\n const v = style.getPropertyValue(name).trim();\n return v || fallback;\n}\n\n/**\n * Resolve the chart tokens in effect for `el` — pass the element the chart lives in, so a panel\n * inside a dark region resolves the dark values even when the page is light.\n *\n * `palette` is a categorical scale: assign it IN ORDER, one colour per series, and never cycle\n * it. Past eight series, colour has stopped being an encoding — fold the tail into one \"other\"\n * series or split the chart. On a light surface three of the eight sit below 3:1 against white,\n * so identity must not rest on colour alone: keep the legend, or label the series directly.\n */\nexport function chartTokens(el) {\n const target = (el && el.nodeType === 1 ? el : null)\n || (typeof document !== 'undefined' ? document.documentElement : null);\n if (!target || typeof getComputedStyle !== 'function') return { ...FALLBACK, palette: FALLBACK.cat };\n const s = getComputedStyle(target);\n return {\n palette: FALLBACK.cat.map((hex, i) => read(s, `--uic-cat-${i + 1}`, hex)),\n ink: read(s, '--uic-ink', FALLBACK.ink),\n ink2: read(s, '--uic-ink-2', FALLBACK.ink2),\n mute: read(s, '--uic-mute', FALLBACK.mute),\n line: read(s, '--uic-line', FALLBACK.line),\n lineSoft: read(s, '--uic-line-soft', FALLBACK.lineSoft),\n surface: read(s, '--uic-surface', FALLBACK.surface),\n brand: read(s, '--uic-brand', FALLBACK.brand),\n ok: read(s, '--uic-ok', FALLBACK.ok),\n warn: read(s, '--uic-warn', FALLBACK.warn),\n bad: read(s, '--uic-fail-ink', FALLBACK.bad),\n font: read(s, '--uic-font', FALLBACK.font),\n };\n}\n","import { useCallback, useEffect, useRef, useState } from 'react';\nimport { chartTokens } from './tokens.js';\n\n/**\n * chartTokens(), re-read when the theme changes.\n *\n * A chart's colours are baked into its option at build time, so flipping light↔dark leaves every\n * chart on the page painted for the theme that is gone until something re-renders it. There is no\n * event for \"the tokens changed\", so this watches the two things that change them: the attributes\n * a theme is switched with (a class or data-* on <html>/<body>), and the OS preference.\n *\n * Returns [tokens, ref] — put the ref on the element the chart lives in, or leave it unused and\n * the document's own tokens are read.\n */\nexport function useChartTokens() {\n const ref = useRef(null);\n const [tokens, setTokens] = useState(() => chartTokens(null));\n const reread = useCallback(() => setTokens(chartTokens(ref.current)), []);\n\n useEffect(() => {\n reread();\n if (typeof MutationObserver !== 'function') return undefined;\n const obs = new MutationObserver(reread);\n const opts = { attributes: true, attributeFilter: ['class', 'style', 'data-theme'] };\n obs.observe(document.documentElement, opts);\n if (document.body) obs.observe(document.body, opts);\n const mq = typeof matchMedia === 'function' ? matchMedia('(prefers-color-scheme: dark)') : null;\n mq?.addEventListener?.('change', reread);\n return () => { obs.disconnect(); mq?.removeEventListener?.('change', reread); };\n }, [reread]);\n\n return [tokens, ref];\n}\n"],"mappings":"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","names":["useEffect","useRef","useState","useRef","useState","useEffect"]}
|
|
1
|
+
{"version":3,"sources":["../src/chart/Chart.jsx","../src/chart/tokens.js","../src/chart/useChartTokens.js"],"sourcesContent":["// Chart — an ECharts option, drawn. That is the whole component.\n//\n// It deliberately knows nothing about series, axes or data shape: the option IS the contract, so\n// anything ECharts can draw, this draws, and the thing that decides what a chart should look like\n// (a person, or an agent writing the option) is not limited by a props table. What it does own is\n// the part every hand-rolled wrapper gets wrong: creating the instance once, disposing it on\n// unmount, and resizing it when its box changes — a chart inside a resizable panel that never\n// hears about the resize is the most common broken dashboard there is.\n//\n// echarts is an OPTIONAL peer, loaded lazily here, which is why this lives at `reifyui/chart` and\n// not in the root index — the same reason `reifyui/slides` is its own entry. An app that imports\n// a Button must not resolve a charting library.\nimport { useEffect, useRef, useState } from 'react';\n\n/**\n * option the ECharts option. Applied whenever the REFERENCE changes, so build it in a\n * useMemo — a fresh object every render redraws the chart every render\n * renderer 'canvas' (default) or 'svg'; svg stays crisp when the page is printed or scaled\n * notMerge replace the previous option rather than merging into it (default true: a redraw\n * after new data should not inherit last query's series)\n * onInit the instance, once, for the things only the instance can do (export an image)\n * label the chart's accessible name; a canvas has no text for a screen reader to find\n * fallback drawn instead when the chart code cannot be loaded at all\n */\nexport function Chart(props) {\n const { option, renderer = 'canvas', notMerge = true, onInit, label, fallback = null, className = '' } = props;\n const host = useRef(null);\n const inst = useRef(null);\n const applied = useRef(null); // the option the instance is currently showing\n const [failed, setFailed] = useState(false);\n // Read through refs inside the init effect so a new option or callback does not tear the\n // instance down and rebuild it.\n const latest = useRef({ option, notMerge, onInit });\n latest.current = { option, notMerge, onInit };\n\n useEffect(() => {\n let dead = false;\n (async () => {\n try {\n const mod = await import('echarts');\n const echarts = typeof mod.init === 'function' ? mod : (mod.default || mod);\n if (dead || !host.current) return;\n const chart = echarts.init(host.current, null, { renderer });\n inst.current = chart;\n const { option: opt, notMerge: nm, onInit: cb } = latest.current;\n if (opt) { chart.setOption(opt, nm); applied.current = opt; }\n if (cb) cb(chart);\n } catch {\n if (!dead) setFailed(true); // no chart code: say so, never draw a fake one\n }\n })();\n return () => {\n dead = true;\n try { inst.current?.dispose(); } catch { /* already gone with the DOM */ }\n inst.current = null;\n applied.current = null;\n };\n }, [renderer]);\n\n // `applied` keeps this from redrawing the option the init above just drew — the instance\n // arrives asynchronously, so both paths run on the first render that has one.\n useEffect(() => {\n if (!inst.current || !option || applied.current === option) return;\n inst.current.setOption(option, notMerge);\n applied.current = option;\n }, [option, notMerge]);\n\n useEffect(() => {\n const el = host.current;\n if (!el || typeof ResizeObserver !== 'function') return undefined;\n let frame = 0;\n const ro = new ResizeObserver(() => {\n // One resize per frame: a drag on a panel corner fires the observer on every pointer move.\n cancelAnimationFrame(frame);\n frame = requestAnimationFrame(() => inst.current?.resize());\n });\n ro.observe(el);\n return () => { cancelAnimationFrame(frame); ro.disconnect(); };\n }, []);\n\n if (failed) return <div className={['uic-chart', 'is-unavailable', className].filter(Boolean).join(' ')}>{fallback}</div>;\n return (\n <div\n ref={host}\n className={['uic-chart', className].filter(Boolean).join(' ')}\n role={label ? 'img' : undefined}\n aria-label={label}\n />\n );\n}\n","// The theme, as values a chart library can use.\n//\n// A chart draws into a canvas, where CSS custom properties do not reach: series colours, axis\n// labels and tooltip chrome all arrive as strings in an option object. Without this, every app\n// hardcodes hex in its chart code and the charts are the one part of the product that does not\n// follow the theme. Reading the same --uic-* tokens the stylesheets read keeps them together.\n\n// Same policy as the `var(--uic-x, …)` fallbacks in the stylesheets: a host that never loaded a\n// token layer still gets the library's own light palette rather than whatever the chart library\n// defaults to. Values are themes/light.css verbatim.\nconst FALLBACK = {\n cat: ['#2a78d6', '#eb6834', '#1baf7a', '#eda100', '#e87ba4', '#008300', '#4a3aa7', '#e34948'],\n ink: '#111317', ink2: '#3A3D45', mute: '#5B5D66',\n line: '#DDDFE6', lineSoft: '#EFF1F4', surface: '#FFFFFF',\n brand: '#285AFF', ok: '#16a34a', warn: '#F59E0B', bad: '#b91c1c',\n font: 'inherit',\n};\n\nfunction read(style, name, fallback) {\n const v = style.getPropertyValue(name).trim();\n return v || fallback;\n}\n\n/**\n * Resolve the chart tokens in effect for `el` — pass the element the chart lives in, so a panel\n * inside a dark region resolves the dark values even when the page is light.\n *\n * `palette` is a categorical scale: assign it IN ORDER, one colour per series, and never cycle\n * it. Past eight series, colour has stopped being an encoding — fold the tail into one \"other\"\n * series or split the chart. On a light surface three of the eight sit below 3:1 against white,\n * so identity must not rest on colour alone: keep the legend, or label the series directly.\n */\nexport function chartTokens(el) {\n const target = (el && el.nodeType === 1 ? el : null)\n || (typeof document !== 'undefined' ? document.documentElement : null);\n if (!target || typeof getComputedStyle !== 'function') return { ...FALLBACK, palette: FALLBACK.cat };\n const s = getComputedStyle(target);\n return {\n palette: FALLBACK.cat.map((hex, i) => read(s, `--uic-cat-${i + 1}`, hex)),\n ink: read(s, '--uic-ink', FALLBACK.ink),\n ink2: read(s, '--uic-ink-2', FALLBACK.ink2),\n mute: read(s, '--uic-mute', FALLBACK.mute),\n line: read(s, '--uic-line', FALLBACK.line),\n lineSoft: read(s, '--uic-line-soft', FALLBACK.lineSoft),\n surface: read(s, '--uic-surface', FALLBACK.surface),\n brand: read(s, '--uic-brand', FALLBACK.brand),\n ok: read(s, '--uic-ok', FALLBACK.ok),\n warn: read(s, '--uic-warn', FALLBACK.warn),\n bad: read(s, '--uic-fail-ink', FALLBACK.bad),\n font: read(s, '--uic-font', FALLBACK.font),\n };\n}\n","import { useCallback, useEffect, useRef, useState } from 'react';\nimport { chartTokens } from './tokens.js';\n\n/**\n * chartTokens(), re-read when the theme changes.\n *\n * A chart's colours are baked into its option at build time, so flipping light↔dark leaves every\n * chart on the page painted for the theme that is gone until something re-renders it. There is no\n * event for \"the tokens changed\", so this watches the two things that change them: the attributes\n * a theme is switched with (a class or data-* on <html>/<body>), and the OS preference.\n *\n * Returns [tokens, ref] — put the ref on the element the chart lives in, or leave it unused and\n * the document's own tokens are read.\n */\nexport function useChartTokens() {\n const ref = useRef(null);\n const [tokens, setTokens] = useState(() => chartTokens(null));\n const reread = useCallback(() => setTokens(chartTokens(ref.current)), []);\n\n useEffect(() => {\n reread();\n if (typeof MutationObserver !== 'function') return undefined;\n const obs = new MutationObserver(reread);\n const opts = { attributes: true, attributeFilter: ['class', 'style', 'data-theme'] };\n obs.observe(document.documentElement, opts);\n if (document.body) obs.observe(document.body, opts);\n const mq = typeof matchMedia === 'function' ? matchMedia('(prefers-color-scheme: dark)') : null;\n mq?.addEventListener?.('change', reread);\n return () => { obs.disconnect(); mq?.removeEventListener?.('change', reread); };\n }, [reread]);\n\n return [tokens, ref];\n}\n"],"mappings":"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","names":["useEffect","useRef","useState","useRef","useState","useEffect"]}
|