@krizaka/ui 3.60.0 → 3.62.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.
@@ -43,6 +43,7 @@
43
43
  "Draw only what runs: `flow=\"both\"` where results really come back, `planned` (with a `status` word) where nothing is wired yet.",
44
44
  "Keep a text version (a list) in the page; give each node a one-line `description` and its `href`.",
45
45
  "Tune the stream, not the story: `density` (sparse · normal · dense), `speed`, `easing`, `stagger`, and `trigger` (`always`, `hover`, `active`) change how the photons travel, never what the figure claims; `breathe={false}` keeps the engine still.",
46
+ "In a small frame (a tile of a home page) use `calm`: sparse photons at a low rate and a slow breath, no hint and no detail line, nothing to tune; wrap the figure in an `inert` box if it should not take focus.",
46
47
  "Five to eight nodes: radial reads at a glance; on a phone the default `compactLayout` puts them in a row above the hub."
47
48
  ],
48
49
  "accessibility": {
@@ -60,6 +61,7 @@
60
61
  "The drawing (conduits, photons) is hidden from assistive technology; each node is a button named by its label, `aria-pressed` when chosen.",
61
62
  "The detail line is a polite live region: pointing at or focusing a node announces its line.",
62
63
  "Motion is CSS (motion.css): paused off screen (MotionObserver), held while the page settles, a still frame under reduced motion. No animation frame, no canvas.",
64
+ "`calm` plays only on screen and once the page has settled, and rests under reduced motion and Save-Data.",
63
65
  "The stage keeps its aspect ratio and the detail line its height: no layout shift."
64
66
  ]
65
67
  },
@@ -105,6 +107,13 @@
105
107
  "description": "The engine's mark swells slowly (a loop, still under reduced motion).",
106
108
  "required": false
107
109
  },
110
+ {
111
+ "name": "calm",
112
+ "type": "boolean",
113
+ "default": "false",
114
+ "description": "The calm level, for a small frame (a tile of a home page): sparse photons at a low rate, a slow breath, no hint and\nno detail line, nothing to tune. It plays only on screen and once the page has settled, and stays still under\nreduced motion and Save-Data. Overrides `speed`, `density`, `stagger` and `trigger`.",
115
+ "required": false
116
+ },
108
117
  {
109
118
  "name": "compactLayout",
110
119
  "type": "false | FlowLayout",
@@ -183,6 +192,11 @@
183
192
  "required": false
184
193
  }
185
194
  ]
195
+ },
196
+ {
197
+ "component": "FLOW_FAN",
198
+ "description": "How far a conduit lands from the hub's centre along the row, as a share of its node's offset: a small fan, kept inside the ring.",
199
+ "props": []
186
200
  }
187
201
  ],
188
202
  "examples": [
@@ -201,6 +215,14 @@
201
215
  "path": "examples/engine-flow/compact.tsx",
202
216
  "module": "@krizaka/ui/registry/examples/engine-flow/compact",
203
217
  "code": "import { ProductLogo } from \"@krizaka/ui\";\nimport { EngineFlow } from \"@krizaka/ui/engine-flow\";\n\nconst ids = [\"orochia\", \"yomizaka\", \"kachizaka\", \"akinaza\", \"yasakia\", \"yororis\"] as const;\n\n// On a phone: the products in a row above, flowing down into the engine; the detail line names the chosen one.\nexport default function EngineFlowCompact() {\n return (\n <div style={{ maxWidth: 360 }}>\n <EngineFlow\n className=\"brand-orazaka\"\n label=\"Orazaka and the products it powers\"\n layout=\"top-to-bottom\"\n compactLayout={false}\n hub={{ label: \"Orazaka\", mark: <ProductLogo id=\"orazaka\" size={44} animated={false} /> }}\n hint=\"Tap a product.\"\n defaultActive=\"yomizaka\"\n nodes={ids.map((id, i) => ({\n id,\n label: id[0]!.toUpperCase() + id.slice(1),\n className: `brand-${id}`,\n mark: <ProductLogo id={id} size={24} animated={false} />,\n flow: i < 3 ? \"both\" : \"in\",\n planned: i >= 3,\n description: i < 3 ? \"Requests in, results back.\" : \"Planned: not wired yet.\",\n }))}\n />\n </div>\n );\n}\n"
218
+ },
219
+ {
220
+ "name": "calm",
221
+ "title": "Calm, for a small frame",
222
+ "description": "Sparse photons at a low rate and a slow breath, no hint and no detail line; still under reduced motion and Save-Data.",
223
+ "path": "examples/engine-flow/calm.tsx",
224
+ "module": "@krizaka/ui/registry/examples/engine-flow/calm",
225
+ "code": "import { ProductLogo } from \"@krizaka/ui\";\nimport { EngineFlow } from \"@krizaka/ui/engine-flow\";\n\nconst ids = [\"orochia\", \"yomizaka\", \"kachizaka\", \"akinaza\"] as const;\n\n// The calm level, in a small tile: the photons and the breath run at a low rate, nothing to tune, nothing to read.\nexport default function EngineFlowCalm() {\n return (\n <div style={{ maxWidth: 420 }}>\n <EngineFlow\n calm\n className=\"brand-orazaka\"\n label=\"Orazaka and the products it powers\"\n hub={{ label: \"Orazaka\", mark: <ProductLogo id=\"orazaka\" size={44} animated={false} /> }}\n nodes={ids.map((id) => ({\n id,\n label: id[0]!.toUpperCase() + id.slice(1),\n flow: \"both\" as const,\n className: `brand-${id}`,\n mark: <ProductLogo id={id} size={26} animated={false} />,\n }))}\n />\n </div>\n );\n}\n"
204
226
  }
205
227
  ]
206
228
  },
@@ -208,19 +230,19 @@
208
230
  "files": [
209
231
  {
210
232
  "path": "engine-flow/engine-flow.tsx",
211
- "content": "// Client (the node a visitor points at or focuses). An engine at the hub and the apps it serves around it: one conduit\n// per app, and photons that travel it — towards the hub (`in`: requests), back (`out`: results) or both — in the app's\n// brand colour going in and the hub's coming back. A planned app is drawn dim, its conduit dashed and still.\n//\n// Motion is the Krizaka signature's (motion.css): CSS animations of `stroke-dashoffset`, no animation frame, no canvas;\n// paused off screen (`data-motion-scope` → MotionObserver's `data-offscreen`), held while the page settles (`kz-loop`),\n// a still frame under reduced motion (the photons rest along their conduit). The stage keeps its aspect ratio and the\n// detail line its height: no layout shift.\n//\n// Accessible: the drawing is hidden from assistive technology; every node is a real button named by its label, and the\n// detail line (polite live region) says the chosen node's description with its link. Pair it with a text version (a\n// list) in the page: the figure is a picture of it.\nimport * as React from \"react\";\n\nimport { cn } from \"../cn\";\nimport { type FlowConduit, flowGeometry, type FlowLayout } from \"./geometry\";\n\nexport interface EngineFlowNode {\n /** A stable id (`orochia`). */\n id: string;\n /** Its name, the button's accessible name (\"Orochia\"). */\n label: string;\n /** Its mark (a `ProductLogo`), decorative. */\n mark?: React.ReactNode;\n /** One line: what it uses the engine for — shown when the node is pointed at or focused. */\n description?: React.ReactNode;\n /** Where it lives (its site). */\n href?: string;\n /** The link's words (\"Visit dev.orochia.com\"); defaults to the label. */\n linkLabel?: React.ReactNode;\n /** Opens the link in a new tab. */\n external?: boolean;\n /** What travels: `in` towards the hub, `out` back from it, `both`.\n * @default \"in\" */\n flow?: \"in\" | \"out\" | \"both\";\n /** Not wired yet: drawn dim, its conduit dashed and still, no photon. */\n planned?: boolean;\n /** A word beside the name in the detail line (\"planned\"), passed translated. */\n status?: React.ReactNode;\n /** Its brand scope (`brand-orochia`): its conduit, photons and ring take its `--kz-accent`. */\n className?: string;\n}\n\nexport interface EngineFlowHub {\n /** The engine's name (\"Orazaka\"). */\n label: string;\n /** Its mark, decorative. */\n mark?: React.ReactNode;\n /** A line under the name (\"the engine\"). */\n caption?: React.ReactNode;\n /** Its brand scope; the photons coming back take its accent. */\n className?: string;\n}\n\nexport type EngineFlowProps = Omit<React.ComponentProps<\"figure\">, \"children\"> & {\n /** What the figure shows (\"Orazaka and the products it powers\"), passed translated. */\n label: string;\n /** The engine, at the hub. */\n hub: EngineFlowHub;\n /** The apps around it. */\n nodes: readonly EngineFlowNode[];\n /** How the nodes sit around the hub.\n * @default \"radial\" */\n layout?: FlowLayout;\n /** The layout under a 560 px wide container (a phone); `false` keeps `layout` everywhere.\n * @default \"top-to-bottom\" */\n compactLayout?: FlowLayout | false;\n /** `photons` travel the conduits; `none` draws them still.\n * @default \"photons\" */\n particles?: \"photons\" | \"none\";\n /** The conduits' shape.\n * @default \"bezier\" */\n conduit?: FlowConduit;\n /** The detail line before a node is chosen (\"Point at a product\"). */\n hint?: React.ReactNode;\n /** The node shown in the detail line at first. */\n defaultActive?: string;\n /** Photon speed, in units per second (the stage is 100 units wide).\n * @default 16 */\n speed?: number;\n /** How many photons share a conduit: `sparse` one or two, `normal` two to four, `dense` four to eight.\n * @default \"normal\" */\n density?: FlowDensity;\n /** When the photons travel: `always`; `hover` only while the pointer or focus is on the figure (they rest along the\n * conduits otherwise); `active` only on the conduit of the chosen node (the others show nothing). Off screen they\n * are always paused, and still under reduced motion.\n * @default \"always\" */\n trigger?: FlowTrigger;\n /** The photons' timing function: `linear` (a steady stream), `ease-in-out` (a pulse that swells and settles), or any\n * CSS `<easing-function>` (`cubic-bezier(.2,0,0,1)`, `steps(6)`).\n * @default \"linear\" */\n easing?: FlowEasing;\n /** Milliseconds between one conduit's photons and the next's: 0 sends them all together.\n * @default 300 */\n stagger?: number;\n /** The engine's mark swells slowly (a loop, still under reduced motion).\n * @default true */\n breathe?: boolean;\n};\n\nexport type FlowDensity = \"sparse\" | \"normal\" | \"dense\";\nexport type FlowTrigger = \"always\" | \"hover\" | \"active\";\nexport type FlowEasing = \"linear\" | \"ease-in-out\" | (string & {});\n\n/** How many photons a conduit of this length carries (evenly spaced, so the gap is `length / count`). */\nexport function photonCount(length: number, density: FlowDensity = \"normal\"): number {\n const base = Math.round(length / 16);\n if (density === \"sparse\") return Math.min(2, Math.max(1, Math.round(base / 2)));\n if (density === \"dense\") return Math.min(8, Math.max(4, base * 2));\n return Math.min(4, Math.max(2, base));\n}\n\nfunction Stage({\n layout,\n variant,\n nodes,\n hub,\n conduit,\n particles,\n speed,\n density,\n easing,\n stagger,\n breathe,\n active,\n onActive,\n detailId,\n}: {\n layout: FlowLayout;\n variant: \"wide\" | \"compact\";\n nodes: readonly EngineFlowNode[];\n hub: EngineFlowHub;\n conduit: FlowConduit;\n particles: \"photons\" | \"none\";\n speed: number;\n density: FlowDensity;\n easing: FlowEasing;\n stagger: number;\n breathe: boolean;\n active: string | undefined;\n onActive: (id: string) => void;\n detailId: string;\n}) {\n const g = flowGeometry(layout, nodes.length, conduit);\n const pct = (v: number, of: number) => `${((v / of) * 100).toFixed(3)}%`;\n return (\n <div className=\"kz-flow-stage\" data-variant={variant} data-layout={layout} style={{ aspectRatio: `${g.width} / ${g.height}` }}>\n <svg viewBox={`0 0 ${g.width} ${g.height}`} aria-hidden=\"true\" focusable=\"false\">\n {nodes.map((node, i) => {\n const flow = node.flow ?? \"in\";\n const length = g.lengths[i] ?? 0;\n // Photons per conduit (`density`), evenly spaced; the same speed on every conduit.\n const gap = length / photonCount(length, density);\n const period = gap / speed;\n const timing = (dir: \"in\" | \"out\") =>\n ({\n \"--kz-flow-gap\": gap.toFixed(3),\n animationDuration: `${period.toFixed(2)}s`,\n // Each conduit starts `stagger` ms after the previous (a negative delay: already under way); the way back is half a period behind.\n animationDelay: `${(-(((i * stagger) / 1000 + (dir === \"out\" ? period / 2 : 0)) % period)).toFixed(2)}s`,\n ...(easing !== \"linear\" ? { animationTimingFunction: easing } : {}),\n }) as React.CSSProperties;\n const lanes = node.planned || particles === \"none\" ? [] : flow === \"both\" ? ([\"in\", \"out\"] as const) : [flow];\n return (\n <g\n key={node.id}\n className={cn(\"kz-flow-link\", node.className)}\n data-flow={flow}\n data-planned={node.planned ? \"\" : undefined}\n data-active={active === node.id ? \"\" : undefined}\n >\n <path className=\"kz-flow-wire\" d={g.paths[i]} />\n {lanes.map((dir) => (\n <React.Fragment key={dir}>\n <path className=\"kz-flow-photon kz-loop\" data-dir={dir} data-halo=\"\" d={g.paths[i]} style={timing(dir)} />\n <path className=\"kz-flow-photon kz-loop\" data-dir={dir} d={g.paths[i]} style={timing(dir)} />\n </React.Fragment>\n ))}\n </g>\n );\n })}\n </svg>\n <div className={cn(\"kz-flow-hub\", hub.className)} style={{ left: pct(g.hub.x, g.width), top: pct(g.hub.y, g.height) }}>\n {hub.mark ? <span className={cn(\"kz-flow-hub-mark\", breathe && \"kz-loop\")}>{hub.mark}</span> : null}\n <span className=\"kz-flow-hub-label\">{hub.label}</span>\n {hub.caption ? <span className=\"kz-flow-hub-caption\">{hub.caption}</span> : null}\n </div>\n <ul className=\"kz-flow-nodes\">\n {nodes.map((node, i) => {\n const p = g.nodes[i]!;\n const on = active === node.id;\n return (\n <li key={node.id} style={{ left: pct(p.x, g.width), top: pct(p.y, g.height) }}>\n <button\n type=\"button\"\n className={cn(\"kz-flow-node\", node.className)}\n data-active={on ? \"\" : undefined}\n data-planned={node.planned ? \"\" : undefined}\n aria-pressed={on}\n aria-controls={detailId}\n onPointerEnter={() => onActive(node.id)}\n onFocus={() => onActive(node.id)}\n onClick={() => onActive(node.id)}\n >\n {node.mark ? (\n <span className=\"kz-flow-node-mark\" aria-hidden=\"true\">\n {node.mark}\n </span>\n ) : null}\n <span className=\"kz-flow-node-label\">{node.label}</span>\n </button>\n </li>\n );\n })}\n </ul>\n </div>\n );\n}\n\n/** An engine at the hub and the apps it serves, with what travels between them. */\nexport function EngineFlow({\n label,\n hub,\n nodes,\n layout = \"radial\",\n compactLayout = \"top-to-bottom\",\n particles = \"photons\",\n conduit = \"bezier\",\n hint,\n defaultActive,\n speed = 16,\n density = \"normal\",\n trigger = \"always\",\n easing = \"linear\",\n stagger = 300,\n breathe = true,\n className,\n ...props\n}: EngineFlowProps) {\n const [active, setActive] = React.useState<string | undefined>(defaultActive);\n const detailId = `${React.useId()}-detail`;\n const chosen = nodes.find((n) => n.id === active);\n const compact = compactLayout && compactLayout !== layout ? compactLayout : undefined;\n const stage = { nodes, hub, conduit, particles, speed: Math.max(1, speed), density, easing, stagger: Math.max(0, stagger), breathe, active, onActive: setActive, detailId };\n return (\n <figure\n aria-label={label}\n className={cn(\"kz-flow\", className)}\n data-motion-scope=\"\"\n data-active={chosen ? \"\" : undefined}\n data-trigger={trigger === \"always\" ? undefined : trigger}\n data-density={density === \"normal\" ? undefined : density}\n data-compact={compact ? \"\" : undefined}\n {...props}\n >\n <Stage layout={layout} variant=\"wide\" {...stage} />\n {compact ? <Stage layout={compact} variant=\"compact\" {...stage} /> : null}\n <figcaption id={detailId} className={cn(\"kz-flow-detail\", chosen?.className)} aria-live=\"polite\">\n {chosen ? (\n <>\n <strong>{chosen.label}</strong>\n {chosen.status ? <span className=\"kz-flow-status\">{chosen.status}</span> : null}\n {chosen.description ? <span> {chosen.description}</span> : null}\n {chosen.href ? (\n <>\n {\" \"}\n <a href={chosen.href} {...(chosen.external ? { target: \"_blank\", rel: \"noopener\" } : {})}>\n {chosen.linkLabel ?? chosen.label}\n <span aria-hidden=\"true\"> →</span>\n </a>\n </>\n ) : null}\n </>\n ) : (\n hint\n )}\n </figcaption>\n </figure>\n );\n}\n"
233
+ "content": "// Client (the node a visitor points at or focuses). An engine at the hub and the apps it serves around it: one conduit\n// per app, and photons that travel it — towards the hub (`in`: requests), back (`out`: results) or both — in the app's\n// brand colour going in and the hub's coming back. A planned app is drawn dim, its conduit dashed and still.\n//\n// Motion is the Krizaka signature's (motion.css): CSS animations of `stroke-dashoffset`, no animation frame, no canvas;\n// paused off screen (`data-motion-scope` → MotionObserver's `data-offscreen`), held while the page settles (`kz-loop`),\n// a still frame under reduced motion and Save-Data (the photons rest along their conduit). The stage keeps its aspect ratio and the\n// detail line its height: no layout shift.\n//\n// Anchoring: a conduit runs between the centres of the node's circle and of the hub's ring (the label and the caption hang\n// below them, out of the box), and both circles are opaque and drawn over it — so every conduit meets the circle at the point\n// facing the other end, whatever the layout and the number of nodes.\n//\n// Accessible: the drawing is hidden from assistive technology; every node is a real button named by its label, and the\n// detail line (polite live region) says the chosen node's description with its link. Pair it with a text version (a\n// list) in the page: the figure is a picture of it.\nimport * as React from \"react\";\n\nimport { cn } from \"../cn\";\nimport { type FlowConduit, flowGeometry, type FlowLayout } from \"./geometry\";\n\nexport interface EngineFlowNode {\n /** A stable id (`orochia`). */\n id: string;\n /** Its name, the button's accessible name (\"Orochia\"). */\n label: string;\n /** Its mark (a `ProductLogo`), decorative. */\n mark?: React.ReactNode;\n /** One line: what it uses the engine for — shown when the node is pointed at or focused. */\n description?: React.ReactNode;\n /** Where it lives (its site). */\n href?: string;\n /** The link's words (\"Visit dev.orochia.com\"); defaults to the label. */\n linkLabel?: React.ReactNode;\n /** Opens the link in a new tab. */\n external?: boolean;\n /** What travels: `in` towards the hub, `out` back from it, `both`.\n * @default \"in\" */\n flow?: \"in\" | \"out\" | \"both\";\n /** Not wired yet: drawn dim, its conduit dashed and still, no photon. */\n planned?: boolean;\n /** A word beside the name in the detail line (\"planned\"), passed translated. */\n status?: React.ReactNode;\n /** Its brand scope (`brand-orochia`): its conduit, photons and ring take its `--kz-accent`. */\n className?: string;\n}\n\nexport interface EngineFlowHub {\n /** The engine's name (\"Orazaka\"). */\n label: string;\n /** Its mark, decorative. */\n mark?: React.ReactNode;\n /** A line under the name (\"the engine\"). */\n caption?: React.ReactNode;\n /** Its brand scope; the photons coming back take its accent. */\n className?: string;\n}\n\nexport type EngineFlowProps = Omit<React.ComponentProps<\"figure\">, \"children\"> & {\n /** What the figure shows (\"Orazaka and the products it powers\"), passed translated. */\n label: string;\n /** The engine, at the hub. */\n hub: EngineFlowHub;\n /** The apps around it. */\n nodes: readonly EngineFlowNode[];\n /** How the nodes sit around the hub.\n * @default \"radial\" */\n layout?: FlowLayout;\n /** The layout under a 560 px wide container (a phone); `false` keeps `layout` everywhere.\n * @default \"top-to-bottom\" */\n compactLayout?: FlowLayout | false;\n /** `photons` travel the conduits; `none` draws them still.\n * @default \"photons\" */\n particles?: \"photons\" | \"none\";\n /** The conduits' shape.\n * @default \"bezier\" */\n conduit?: FlowConduit;\n /** The detail line before a node is chosen (\"Point at a product\"). */\n hint?: React.ReactNode;\n /** The node shown in the detail line at first. */\n defaultActive?: string;\n /** Photon speed, in units per second (the stage is 100 units wide).\n * @default 16 */\n speed?: number;\n /** How many photons share a conduit: `sparse` one or two, `normal` two to four, `dense` four to eight.\n * @default \"normal\" */\n density?: FlowDensity;\n /** When the photons travel: `always`; `hover` only while the pointer or focus is on the figure (they rest along the\n * conduits otherwise); `active` only on the conduit of the chosen node (the others show nothing). Off screen they\n * are always paused, and still under reduced motion.\n * @default \"always\" */\n trigger?: FlowTrigger;\n /** The photons' timing function: `linear` (a steady stream), `ease-in-out` (a pulse that swells and settles), or any\n * CSS `<easing-function>` (`cubic-bezier(.2,0,0,1)`, `steps(6)`).\n * @default \"linear\" */\n easing?: FlowEasing;\n /** Milliseconds between one conduit's photons and the next's: 0 sends them all together.\n * @default 300 */\n stagger?: number;\n /** The engine's mark swells slowly (a loop, still under reduced motion).\n * @default true */\n breathe?: boolean;\n /** The calm level, for a small frame (a tile of a home page): sparse photons at a low rate, a slow breath, no hint and\n * no detail line, nothing to tune. It plays only on screen and once the page has settled, and stays still under\n * reduced motion and Save-Data. Overrides `speed`, `density`, `stagger` and `trigger`.\n * @default false */\n calm?: boolean;\n};\n\n/** The calm level's pace: units per second, photons per conduit, milliseconds between conduits. */\nexport const CALM_FLOW = { speed: 4, density: \"sparse\", stagger: 1200 } as const satisfies { speed: number; density: FlowDensity; stagger: number };\n\nconst subscribeSaveData = (onChange: () => void) => {\n const c = (navigator as Navigator & { connection?: EventTarget }).connection;\n c?.addEventListener?.(\"change\", onChange);\n return () => c?.removeEventListener?.(\"change\", onChange);\n};\nconst readSaveData = () => (navigator as Navigator & { connection?: { saveData?: boolean } }).connection?.saveData === true;\n\n\nexport type FlowDensity = \"sparse\" | \"normal\" | \"dense\";\nexport type FlowTrigger = \"always\" | \"hover\" | \"active\";\nexport type FlowEasing = \"linear\" | \"ease-in-out\" | (string & {});\n\n/** How many photons a conduit of this length carries (evenly spaced, so the gap is `length / count`). */\nexport function photonCount(length: number, density: FlowDensity = \"normal\"): number {\n const base = Math.round(length / 16);\n if (density === \"sparse\") return Math.min(2, Math.max(1, Math.round(base / 2)));\n if (density === \"dense\") return Math.min(8, Math.max(4, base * 2));\n return Math.min(4, Math.max(2, base));\n}\n\nfunction Stage({\n layout,\n variant,\n nodes,\n hub,\n conduit,\n particles,\n speed,\n density,\n easing,\n stagger,\n breathe,\n active,\n onActive,\n detailId,\n}: {\n layout: FlowLayout;\n variant: \"wide\" | \"compact\";\n nodes: readonly EngineFlowNode[];\n hub: EngineFlowHub;\n conduit: FlowConduit;\n particles: \"photons\" | \"none\";\n speed: number;\n density: FlowDensity;\n easing: FlowEasing;\n stagger: number;\n breathe: boolean;\n active: string | undefined;\n onActive: (id: string) => void;\n detailId: string | undefined;\n}) {\n const g = flowGeometry(layout, nodes.length, conduit);\n const pct = (v: number, of: number) => `${((v / of) * 100).toFixed(3)}%`;\n return (\n <div className=\"kz-flow-stage\" data-variant={variant} data-layout={layout} style={{ aspectRatio: `${g.width} / ${g.height}` }}>\n <svg viewBox={`0 0 ${g.width} ${g.height}`} aria-hidden=\"true\" focusable=\"false\">\n {nodes.map((node, i) => {\n const flow = node.flow ?? \"in\";\n const length = g.lengths[i] ?? 0;\n // Photons per conduit (`density`), evenly spaced; the same speed on every conduit.\n const gap = length / photonCount(length, density);\n const period = gap / speed;\n const timing = (dir: \"in\" | \"out\") =>\n ({\n \"--kz-flow-gap\": gap.toFixed(3),\n animationDuration: `${period.toFixed(2)}s`,\n // Each conduit starts `stagger` ms after the previous (a negative delay: already under way); the way back is half a period behind.\n animationDelay: `${(-(((i * stagger) / 1000 + (dir === \"out\" ? period / 2 : 0)) % period)).toFixed(2)}s`,\n ...(easing !== \"linear\" ? { animationTimingFunction: easing } : {}),\n }) as React.CSSProperties;\n const lanes = node.planned || particles === \"none\" ? [] : flow === \"both\" ? ([\"in\", \"out\"] as const) : [flow];\n return (\n <g\n key={node.id}\n className={cn(\"kz-flow-link\", node.className)}\n data-flow={flow}\n data-planned={node.planned ? \"\" : undefined}\n data-active={active === node.id ? \"\" : undefined}\n >\n <path className=\"kz-flow-wire\" d={g.paths[i]} />\n {lanes.map((dir) => (\n <React.Fragment key={dir}>\n <path className=\"kz-flow-photon kz-loop\" data-dir={dir} data-halo=\"\" d={g.paths[i]} style={timing(dir)} />\n <path className=\"kz-flow-photon kz-loop\" data-dir={dir} d={g.paths[i]} style={timing(dir)} />\n </React.Fragment>\n ))}\n </g>\n );\n })}\n </svg>\n <div className={cn(\"kz-flow-hub\", hub.className)} style={{ left: pct(g.hub.x, g.width), top: pct(g.hub.y, g.height) }}>\n {hub.mark ? <span className={cn(\"kz-flow-hub-mark\", breathe && \"kz-loop\")}>{hub.mark}</span> : null}\n <span className=\"kz-flow-hub-text\">\n <span className=\"kz-flow-hub-label\">{hub.label}</span>\n {hub.caption ? <span className=\"kz-flow-hub-caption\">{hub.caption}</span> : null}\n </span>\n </div>\n <ul className=\"kz-flow-nodes\">\n {nodes.map((node, i) => {\n const p = g.nodes[i]!;\n const on = active === node.id;\n return (\n <li key={node.id} style={{ left: pct(p.x, g.width), top: pct(p.y, g.height) }}>\n <button\n type=\"button\"\n className={cn(\"kz-flow-node\", node.className)}\n data-active={on ? \"\" : undefined}\n data-planned={node.planned ? \"\" : undefined}\n aria-pressed={on}\n aria-controls={detailId}\n onPointerEnter={() => onActive(node.id)}\n onFocus={() => onActive(node.id)}\n onClick={() => onActive(node.id)}\n >\n {node.mark ? (\n <span className=\"kz-flow-node-mark\" aria-hidden=\"true\">\n {node.mark}\n </span>\n ) : null}\n <span className=\"kz-flow-node-label\">{node.label}</span>\n </button>\n </li>\n );\n })}\n </ul>\n </div>\n );\n}\n\n/** An engine at the hub and the apps it serves, with what travels between them. */\nexport function EngineFlow({\n label,\n hub,\n nodes,\n layout = \"radial\",\n compactLayout = \"top-to-bottom\",\n particles = \"photons\",\n conduit = \"bezier\",\n hint,\n defaultActive,\n speed = 16,\n density = \"normal\",\n trigger = \"always\",\n easing = \"linear\",\n stagger = 300,\n breathe = true,\n calm = false,\n className,\n ...props\n}: EngineFlowProps) {\n const [active, setActive] = React.useState<string | undefined>(defaultActive);\n const detailId = `${React.useId()}-detail`;\n const chosen = nodes.find((n) => n.id === active);\n const compact = compactLayout && compactLayout !== layout ? compactLayout : undefined;\n // Save-Data: the calm and the full levels both rest (a still frame, like reduced motion).\n const saveData = React.useSyncExternalStore(subscribeSaveData, readSaveData, () => false);\n const pace = calm ? CALM_FLOW : { speed: Math.max(1, speed), density, stagger: Math.max(0, stagger) };\n const stage = { nodes, hub, conduit, particles, ...pace, easing, breathe, active, onActive: setActive, detailId: calm ? undefined : detailId };\n return (\n <figure\n aria-label={label}\n className={cn(\"kz-flow\", className)}\n data-motion-scope=\"\"\n data-active={chosen ? \"\" : undefined}\n data-calm={calm ? \"\" : undefined}\n data-still={saveData ? \"\" : undefined}\n data-trigger={calm || trigger === \"always\" ? undefined : trigger}\n data-density={calm ? \"sparse\" : density === \"normal\" ? undefined : density}\n data-compact={compact ? \"\" : undefined}\n {...props}\n >\n <Stage layout={layout} variant=\"wide\" {...stage} />\n {compact ? <Stage layout={compact} variant=\"compact\" {...stage} /> : null}\n {calm ? null : (\n <figcaption id={detailId} className={cn(\"kz-flow-detail\", chosen?.className)} aria-live=\"polite\">\n {chosen ? (\n <>\n <strong>{chosen.label}</strong>\n {chosen.status ? <span className=\"kz-flow-status\">{chosen.status}</span> : null}\n {chosen.description ? <span> {chosen.description}</span> : null}\n {chosen.href ? (\n <>\n {\" \"}\n <a href={chosen.href} {...(chosen.external ? { target: \"_blank\", rel: \"noopener\" } : {})}>\n {chosen.linkLabel ?? chosen.label}\n <span aria-hidden=\"true\"> →</span>\n </a>\n </>\n ) : null}\n </>\n ) : (\n hint\n )}\n </figcaption>\n )}\n </figure>\n );\n}\n"
212
234
  },
213
235
  {
214
236
  "path": "engine-flow/geometry.ts",
215
- "content": "// Server-safe, pure. The geometry of EngineFlow: where the hub and the nodes sit in a box 100 units wide, and the\n// conduit from each node to the hub (an SVG path drawn node → hub, and its length, so photons travel at one speed on\n// every conduit). No DOM: the same numbers on the server and in the browser.\n\n/** How the nodes are placed around the hub. */\nexport type FlowLayout = \"radial\" | \"top-to-bottom\" | \"left-to-right\";\n/** The shape of a conduit: an S-shaped cubic Bézier, or a straight line. */\nexport type FlowConduit = \"bezier\" | \"straight\";\n\nexport interface FlowPoint {\n x: number;\n y: number;\n}\n\nexport interface FlowGeometry {\n /** The box: 100 units wide, `height` units high (the stage keeps this aspect ratio, so nothing is distorted). */\n width: number;\n height: number;\n hub: FlowPoint;\n nodes: FlowPoint[];\n /** One path per node, from the node to the hub. */\n paths: string[];\n /** The length of each path, in units. */\n lengths: number[];\n}\n\n/** The box height per layout (the width is always 100). */\nexport const FLOW_HEIGHT: Record<FlowLayout, number> = { radial: 60, \"top-to-bottom\": 92, \"left-to-right\": 56 };\n\nconst r2 = (n: number) => Math.round(n * 100) / 100;\nconst pt = (p: FlowPoint) => `${r2(p.x)} ${r2(p.y)}`;\n\nfunction cubicLength(a: FlowPoint, b: FlowPoint, c: FlowPoint, d: FlowPoint): number {\n let length = 0;\n let prev = a;\n for (let i = 1; i <= 32; i++) {\n const t = i / 32;\n const u = 1 - t;\n const p = {\n x: u * u * u * a.x + 3 * u * u * t * b.x + 3 * u * t * t * c.x + t * t * t * d.x,\n y: u * u * u * a.y + 3 * u * u * t * b.y + 3 * u * t * t * c.y + t * t * t * d.y,\n };\n length += Math.hypot(p.x - prev.x, p.y - prev.y);\n prev = p;\n }\n return length;\n}\n\n/** The positions of `count` nodes around the hub. */\nexport function flowPositions(layout: FlowLayout, count: number): { hub: FlowPoint; nodes: FlowPoint[] } {\n const height = FLOW_HEIGHT[layout];\n const n = Math.max(0, count);\n if (layout === \"top-to-bottom\") {\n return { hub: { x: 50, y: 72 }, nodes: Array.from({ length: n }, (_, i) => ({ x: ((i + 0.5) * 100) / n, y: 13 })) };\n }\n if (layout === \"left-to-right\") {\n return { hub: { x: 80, y: height / 2 }, nodes: Array.from({ length: n }, (_, i) => ({ x: 12, y: ((i + 0.5) * height) / n })) };\n }\n // Radial: on an ellipse around the centre; an even count puts two nodes level with the hub (more room for labels).\n const hub = { x: 50, y: height / 2 };\n const start = n % 2 === 0 ? -90 + 180 / Math.max(n, 1) : -90;\n return {\n hub,\n nodes: Array.from({ length: n }, (_, i) => {\n const a = ((start + (360 / n) * i) * Math.PI) / 180;\n return { x: hub.x + 37 * Math.cos(a), y: hub.y + 20 * Math.sin(a) };\n }),\n };\n}\n\n/** The whole geometry of a flow: positions, conduits (node → hub) and their lengths. */\nexport function flowGeometry(layout: FlowLayout, count: number, conduit: FlowConduit = \"bezier\"): FlowGeometry {\n const { hub, nodes } = flowPositions(layout, count);\n const paths: string[] = [];\n const lengths: number[] = [];\n for (const p of nodes) {\n // Each conduit lands on its own point of the hub (a fan), so the lines stay apart where they meet.\n const end =\n layout === \"top-to-bottom\"\n ? { x: hub.x + (p.x - hub.x) * 0.18, y: hub.y }\n : layout === \"left-to-right\"\n ? { x: hub.x, y: hub.y + (p.y - hub.y) * 0.18 }\n : hub;\n if (conduit === \"straight\") {\n paths.push(`M${pt(p)} L${pt(end)}`);\n lengths.push(Math.hypot(end.x - p.x, end.y - p.y));\n continue;\n }\n let c1: FlowPoint;\n let c2: FlowPoint;\n if (layout === \"top-to-bottom\") {\n const mid = (p.y + end.y) / 2;\n c1 = { x: p.x, y: mid };\n c2 = { x: end.x, y: mid };\n } else if (layout === \"left-to-right\") {\n const mid = (p.x + end.x) / 2;\n c1 = { x: mid, y: p.y };\n c2 = { x: mid, y: end.y };\n } else {\n // An S: leave the node bending one way, reach the hub bending the other.\n const dx = end.x - p.x;\n const dy = end.y - p.y;\n const len = Math.hypot(dx, dy) || 1;\n const k = 0.14 * len;\n const nx = -dy / len;\n const ny = dx / len;\n c1 = { x: p.x + dx * 0.35 + nx * k, y: p.y + dy * 0.35 + ny * k };\n c2 = { x: p.x + dx * 0.65 - nx * k, y: p.y + dy * 0.65 - ny * k };\n }\n paths.push(`M${pt(p)} C${pt(c1)} ${pt(c2)} ${pt(end)}`);\n lengths.push(cubicLength(p, c1, c2, end));\n }\n return { width: 100, height: FLOW_HEIGHT[layout], hub, nodes, paths, lengths };\n}\n"
237
+ "content": "// Server-safe, pure. The geometry of EngineFlow: where the hub and the nodes sit in a box 100 units wide, and the\n// conduit from each node to the hub (an SVG path drawn node → hub, and its length, so photons travel at one speed on\n// every conduit). No DOM: the same numbers on the server and in the browser.\n\n/** How the nodes are placed around the hub. */\nexport type FlowLayout = \"radial\" | \"top-to-bottom\" | \"left-to-right\";\n/** The shape of a conduit: an S-shaped cubic Bézier, or a straight line. */\nexport type FlowConduit = \"bezier\" | \"straight\";\n\nexport interface FlowPoint {\n x: number;\n y: number;\n}\n\nexport interface FlowGeometry {\n /** The box: 100 units wide, `height` units high (the stage keeps this aspect ratio, so nothing is distorted). */\n width: number;\n height: number;\n hub: FlowPoint;\n nodes: FlowPoint[];\n /** One path per node, from the node to the hub. */\n paths: string[];\n /** The length of each path, in units. */\n lengths: number[];\n}\n\n/** The box height per layout (the width is always 100). */\nexport const FLOW_HEIGHT: Record<FlowLayout, number> = { radial: 60, \"top-to-bottom\": 92, \"left-to-right\": 56 };\n\n/** How far a conduit lands from the hub's centre along the row, as a share of its node's offset: a small fan, kept inside the ring. */\nexport const FLOW_FAN = 0.1;\n\nconst r2 = (n: number) => Math.round(n * 100) / 100;\nconst pt = (p: FlowPoint) => `${r2(p.x)} ${r2(p.y)}`;\n\nfunction cubicLength(a: FlowPoint, b: FlowPoint, c: FlowPoint, d: FlowPoint): number {\n let length = 0;\n let prev = a;\n for (let i = 1; i <= 32; i++) {\n const t = i / 32;\n const u = 1 - t;\n const p = {\n x: u * u * u * a.x + 3 * u * u * t * b.x + 3 * u * t * t * c.x + t * t * t * d.x,\n y: u * u * u * a.y + 3 * u * u * t * b.y + 3 * u * t * t * c.y + t * t * t * d.y,\n };\n length += Math.hypot(p.x - prev.x, p.y - prev.y);\n prev = p;\n }\n return length;\n}\n\n/** The positions of `count` nodes around the hub. */\nexport function flowPositions(layout: FlowLayout, count: number): { hub: FlowPoint; nodes: FlowPoint[] } {\n const height = FLOW_HEIGHT[layout];\n const n = Math.max(0, count);\n if (layout === \"top-to-bottom\") {\n return { hub: { x: 50, y: 72 }, nodes: Array.from({ length: n }, (_, i) => ({ x: ((i + 0.5) * 100) / n, y: 13 })) };\n }\n if (layout === \"left-to-right\") {\n return { hub: { x: 80, y: height / 2 }, nodes: Array.from({ length: n }, (_, i) => ({ x: 12, y: ((i + 0.5) * height) / n })) };\n }\n // Radial: on an ellipse around the centre; an even count puts two nodes level with the hub (more room for labels).\n const hub = { x: 50, y: height / 2 };\n const start = n % 2 === 0 ? -90 + 180 / Math.max(n, 1) : -90;\n return {\n hub,\n nodes: Array.from({ length: n }, (_, i) => {\n const a = ((start + (360 / n) * i) * Math.PI) / 180;\n return { x: hub.x + 37 * Math.cos(a), y: hub.y + 20 * Math.sin(a) };\n }),\n };\n}\n\n/** The whole geometry of a flow: positions, conduits (node → hub) and their lengths. */\nexport function flowGeometry(layout: FlowLayout, count: number, conduit: FlowConduit = \"bezier\"): FlowGeometry {\n const { hub, nodes } = flowPositions(layout, count);\n const paths: string[] = [];\n const lengths: number[] = [];\n for (const p of nodes) {\n // Each conduit lands on its own point of the hub (a fan), so the lines stay apart where they meet.\n const end =\n layout === \"top-to-bottom\"\n ? { x: hub.x + (p.x - hub.x) * FLOW_FAN, y: hub.y }\n : layout === \"left-to-right\"\n ? { x: hub.x, y: hub.y + (p.y - hub.y) * FLOW_FAN }\n : hub;\n if (conduit === \"straight\") {\n paths.push(`M${pt(p)} L${pt(end)}`);\n lengths.push(Math.hypot(end.x - p.x, end.y - p.y));\n continue;\n }\n let c1: FlowPoint;\n let c2: FlowPoint;\n if (layout === \"top-to-bottom\") {\n const mid = (p.y + end.y) / 2;\n c1 = { x: p.x, y: mid };\n c2 = { x: end.x, y: mid };\n } else if (layout === \"left-to-right\") {\n const mid = (p.x + end.x) / 2;\n c1 = { x: mid, y: p.y };\n c2 = { x: mid, y: end.y };\n } else {\n // An S: leave the node bending one way, reach the hub bending the other.\n const dx = end.x - p.x;\n const dy = end.y - p.y;\n const len = Math.hypot(dx, dy) || 1;\n const k = 0.14 * len;\n const nx = -dy / len;\n const ny = dx / len;\n c1 = { x: p.x + dx * 0.35 + nx * k, y: p.y + dy * 0.35 + ny * k };\n c2 = { x: p.x + dx * 0.65 - nx * k, y: p.y + dy * 0.65 - ny * k };\n }\n paths.push(`M${pt(p)} C${pt(c1)} ${pt(c2)} ${pt(end)}`);\n lengths.push(cubicLength(p, c1, c2, end));\n }\n return { width: 100, height: FLOW_HEIGHT[layout], hub, nodes, paths, lengths };\n}\n"
216
238
  },
217
239
  {
218
240
  "path": "engine-flow/index.ts",
219
- "content": "/** @krizaka/ui/engine-flow — `EngineFlow`: an engine at the hub, the apps it serves around it, what travels between them (SVG + CSS, no animation frame). Client. */\nexport {\n EngineFlow,\n type EngineFlowHub,\n type EngineFlowNode,\n type EngineFlowProps,\n type FlowDensity,\n type FlowEasing,\n type FlowTrigger,\n photonCount,\n} from \"./engine-flow\";\nexport { FLOW_HEIGHT, type FlowConduit, type FlowGeometry, flowGeometry, type FlowLayout, type FlowPoint,flowPositions } from \"./geometry\";\n"
241
+ "content": "/** @krizaka/ui/engine-flow — `EngineFlow`: an engine at the hub, the apps it serves around it, what travels between them (SVG + CSS, no animation frame). Client. */\nexport {\n CALM_FLOW,\n EngineFlow,\n type EngineFlowHub,\n type EngineFlowNode,\n type EngineFlowProps,\n type FlowDensity,\n type FlowEasing,\n type FlowTrigger,\n photonCount,\n} from \"./engine-flow\";\nexport { FLOW_FAN, FLOW_HEIGHT, type FlowConduit, type FlowGeometry, flowGeometry, type FlowLayout, type FlowPoint,flowPositions } from \"./geometry\";\n"
220
242
  },
221
243
  {
222
244
  "path": "engine-flow/meta.ts",
223
- "content": "import type { ComponentMeta } from \"../meta\";\n\nexport const meta = {\n title: \"Engine flow\",\n summary:\n \"An engine at the hub and the apps it serves around it, with what travels between them: photons going in (requests) and coming back (results) along each conduit — radial on a wide screen, top to bottom on a phone, planned apps dim and still.\",\n status: \"beta\",\n category: \"data-display\",\n platforms: \"web\",\n parity: {\n native: { status: \"n/a\", reason: \"A diagram of a public site's page; an app screen lists the same facts.\" , use: \"list\" },\n desktop: \"web\",\n },\n whenToUse: [\n \"Showing one platform and the products built on it, in one glance: « one engine, the products it powers ».\",\n \"Saying which way data goes per app — in, back, or both — only where it really runs; what is planned is drawn planned.\",\n ],\n whenNotToUse: [\n { when: \"A sequence of steps a reader follows in order.\", use: \"stepper\" },\n { when: \"Entry points to pages, where the cards are the content.\", use: \"card-grid\" },\n { when: \"A chart of figures over time.\" },\n ],\n bestPractices: [\n \"Give each node its brand scope (`className=\\\"brand-<id>\\\"`) and the figure the hub's: photons going in wear the app's colour, those coming back the engine's.\",\n \"Draw only what runs: `flow=\\\"both\\\"` where results really come back, `planned` (with a `status` word) where nothing is wired yet.\",\n \"Keep a text version (a list) in the page; give each node a one-line `description` and its `href`.\",\n \"Tune the stream, not the story: `density` (sparse · normal · dense), `speed`, `easing`, `stagger`, and `trigger` (`always`, `hover`, `active`) change how the photons travel, never what the figure claims; `breathe={false}` keeps the engine still.\",\n \"Five to eight nodes: radial reads at a glance; on a phone the default `compactLayout` puts them in a row above the hub.\",\n ],\n accessibility: {\n keyboard: [\n { keys: \"Tab\", action: \"Goes through the nodes, then the link of the detail line.\" },\n { keys: \"Enter / Space\", action: \"Chooses the node: the detail line says its description and its link.\" },\n ],\n notes: [\n \"The drawing (conduits, photons) is hidden from assistive technology; each node is a button named by its label, `aria-pressed` when chosen.\",\n \"The detail line is a polite live region: pointing at or focusing a node announces its line.\",\n \"Motion is CSS (motion.css): paused off screen (MotionObserver), held while the page settles, a still frame under reduced motion. No animation frame, no canvas.\",\n \"The stage keeps its aspect ratio and the detail line its height: no layout shift.\",\n ],\n },\n related: [\"card-grid\", \"glow-card\", \"iso\", \"number-ticker\"],\n web: {\n imports: [\"EngineFlow\"],\n examples: [\n { name: \"radial\", title: \"One engine, the products it powers\", description: \"Radial on a wide screen: both ways where results come back, planned products dim and still.\" },\n { name: \"compact\", title: \"On a phone\", description: \"Top to bottom: the products in a row above, flowing down into the engine; the detail line names the chosen one.\" },\n ],\n },\n} satisfies ComponentMeta;\n"
245
+ "content": "import type { ComponentMeta } from \"../meta\";\n\nexport const meta = {\n title: \"Engine flow\",\n summary:\n \"An engine at the hub and the apps it serves around it, with what travels between them: photons going in (requests) and coming back (results) along each conduit — radial on a wide screen, top to bottom on a phone, planned apps dim and still.\",\n status: \"beta\",\n category: \"data-display\",\n platforms: \"web\",\n parity: {\n native: { status: \"n/a\", reason: \"A diagram of a public site's page; an app screen lists the same facts.\" , use: \"list\" },\n desktop: \"web\",\n },\n whenToUse: [\n \"Showing one platform and the products built on it, in one glance: « one engine, the products it powers ».\",\n \"Saying which way data goes per app — in, back, or both — only where it really runs; what is planned is drawn planned.\",\n ],\n whenNotToUse: [\n { when: \"A sequence of steps a reader follows in order.\", use: \"stepper\" },\n { when: \"Entry points to pages, where the cards are the content.\", use: \"card-grid\" },\n { when: \"A chart of figures over time.\" },\n ],\n bestPractices: [\n \"Give each node its brand scope (`className=\\\"brand-<id>\\\"`) and the figure the hub's: photons going in wear the app's colour, those coming back the engine's.\",\n \"Draw only what runs: `flow=\\\"both\\\"` where results really come back, `planned` (with a `status` word) where nothing is wired yet.\",\n \"Keep a text version (a list) in the page; give each node a one-line `description` and its `href`.\",\n \"Tune the stream, not the story: `density` (sparse · normal · dense), `speed`, `easing`, `stagger`, and `trigger` (`always`, `hover`, `active`) change how the photons travel, never what the figure claims; `breathe={false}` keeps the engine still.\",\n \"In a small frame (a tile of a home page) use `calm`: sparse photons at a low rate and a slow breath, no hint and no detail line, nothing to tune; wrap the figure in an `inert` box if it should not take focus.\",\n \"Five to eight nodes: radial reads at a glance; on a phone the default `compactLayout` puts them in a row above the hub.\",\n ],\n accessibility: {\n keyboard: [\n { keys: \"Tab\", action: \"Goes through the nodes, then the link of the detail line.\" },\n { keys: \"Enter / Space\", action: \"Chooses the node: the detail line says its description and its link.\" },\n ],\n notes: [\n \"The drawing (conduits, photons) is hidden from assistive technology; each node is a button named by its label, `aria-pressed` when chosen.\",\n \"The detail line is a polite live region: pointing at or focusing a node announces its line.\",\n \"Motion is CSS (motion.css): paused off screen (MotionObserver), held while the page settles, a still frame under reduced motion. No animation frame, no canvas.\",\n \"`calm` plays only on screen and once the page has settled, and rests under reduced motion and Save-Data.\",\n \"The stage keeps its aspect ratio and the detail line its height: no layout shift.\",\n ],\n },\n related: [\"card-grid\", \"glow-card\", \"iso\", \"number-ticker\"],\n web: {\n imports: [\"EngineFlow\"],\n examples: [\n { name: \"radial\", title: \"One engine, the products it powers\", description: \"Radial on a wide screen: both ways where results come back, planned products dim and still.\" },\n { name: \"compact\", title: \"On a phone\", description: \"Top to bottom: the products in a row above, flowing down into the engine; the detail line names the chosen one.\" },\n { name: \"calm\", title: \"Calm, for a small frame\", description: \"Sparse photons at a low rate and a slow breath, no hint and no detail line; still under reduced motion and Save-Data.\" },\n ],\n },\n} satisfies ComponentMeta;\n"
224
246
  },
225
247
  {
226
248
  "path": "meta.ts",
@@ -268,6 +290,13 @@
268
290
  "description": "The engine's mark swells slowly (a loop, still under reduced motion).",
269
291
  "required": false
270
292
  },
293
+ {
294
+ "name": "calm",
295
+ "type": "boolean",
296
+ "default": "false",
297
+ "description": "The calm level, for a small frame (a tile of a home page): sparse photons at a low rate, a slow breath, no hint and\nno detail line, nothing to tune. It plays only on screen and once the page has settled, and stays still under\nreduced motion and Save-Data. Overrides `speed`, `density`, `stagger` and `trigger`.",
298
+ "required": false
299
+ },
271
300
  {
272
301
  "name": "compactLayout",
273
302
  "type": "false | FlowLayout",
@@ -346,6 +375,11 @@
346
375
  "required": false
347
376
  }
348
377
  ]
378
+ },
379
+ {
380
+ "component": "FLOW_FAN",
381
+ "description": "How far a conduit lands from the hub's centre along the row, as a share of its node's offset: a small fan, kept inside the ring.",
382
+ "props": []
349
383
  }
350
384
  ]
351
385
  }
@@ -0,0 +1,4 @@
1
+ import type { ComponentType } from "react";
2
+ /** A named example of the @krizaka/ui registry; `defaultOpen` opens what it opens (a dialog, a menu, toasts) at load. */
3
+ declare const Example: ComponentType<{ defaultOpen?: boolean }>;
4
+ export default Example;
@@ -0,0 +1,28 @@
1
+ "use client";
2
+
3
+ // registry/examples/engine-flow/calm.tsx
4
+ import { ProductLogo } from "@krizaka/ui";
5
+ import { EngineFlow } from "@krizaka/ui/engine-flow";
6
+ import { jsx } from "react/jsx-runtime";
7
+ var ids = ["orochia", "yomizaka", "kachizaka", "akinaza"];
8
+ function EngineFlowCalm() {
9
+ return /* @__PURE__ */ jsx("div", { style: { maxWidth: 420 }, children: /* @__PURE__ */ jsx(
10
+ EngineFlow,
11
+ {
12
+ calm: true,
13
+ className: "brand-orazaka",
14
+ label: "Orazaka and the products it powers",
15
+ hub: { label: "Orazaka", mark: /* @__PURE__ */ jsx(ProductLogo, { id: "orazaka", size: 44, animated: false }) },
16
+ nodes: ids.map((id) => ({
17
+ id,
18
+ label: id[0].toUpperCase() + id.slice(1),
19
+ flow: "both",
20
+ className: `brand-${id}`,
21
+ mark: /* @__PURE__ */ jsx(ProductLogo, { id, size: 26, animated: false })
22
+ }))
23
+ }
24
+ ) });
25
+ }
26
+ export {
27
+ EngineFlowCalm as default
28
+ };
@@ -0,0 +1,25 @@
1
+ import { ProductLogo } from "@krizaka/ui";
2
+ import { EngineFlow } from "@krizaka/ui/engine-flow";
3
+
4
+ const ids = ["orochia", "yomizaka", "kachizaka", "akinaza"] as const;
5
+
6
+ // The calm level, in a small tile: the photons and the breath run at a low rate, nothing to tune, nothing to read.
7
+ export default function EngineFlowCalm() {
8
+ return (
9
+ <div style={{ maxWidth: 420 }}>
10
+ <EngineFlow
11
+ calm
12
+ className="brand-orazaka"
13
+ label="Orazaka and the products it powers"
14
+ hub={{ label: "Orazaka", mark: <ProductLogo id="orazaka" size={44} animated={false} /> }}
15
+ nodes={ids.map((id) => ({
16
+ id,
17
+ label: id[0]!.toUpperCase() + id.slice(1),
18
+ flow: "both" as const,
19
+ className: `brand-${id}`,
20
+ mark: <ProductLogo id={id} size={26} animated={false} />,
21
+ }))}
22
+ />
23
+ </div>
24
+ );
25
+ }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@krizaka/ui",
3
- "version": "3.60.0",
3
+ "version": "3.62.0",
4
4
  "templatePurposes": {
5
5
  "convince": {
6
6
  "title": "Convince",
@@ -2436,7 +2436,7 @@
2436
2436
  "native": 0
2437
2437
  },
2438
2438
  "dependencies": [
2439
- "@krizaka/tokens@^3.60.0"
2439
+ "@krizaka/tokens@^3.62.0"
2440
2440
  ],
2441
2441
  "registryDependencies": []
2442
2442
  },
@@ -2492,7 +2492,7 @@
2492
2492
  }
2493
2493
  },
2494
2494
  "examples": {
2495
- "web": 2,
2495
+ "web": 3,
2496
2496
  "native": 0
2497
2497
  },
2498
2498
  "dependencies": [],
@@ -3624,7 +3624,7 @@
3624
3624
  "native": 2
3625
3625
  },
3626
3626
  "dependencies": [
3627
- "@krizaka/tokens@^3.60.0",
3627
+ "@krizaka/tokens@^3.62.0",
3628
3628
  "@protomaps/basemaps@5.7.2",
3629
3629
  "tailwind-variants@^3.3.1"
3630
3630
  ],
@@ -4064,7 +4064,7 @@
4064
4064
  "native": 0
4065
4065
  },
4066
4066
  "dependencies": [
4067
- "@krizaka/tokens@^3.60.0",
4067
+ "@krizaka/tokens@^3.62.0",
4068
4068
  "radix-ui@^1.8.1",
4069
4069
  "tailwind-variants@^3.3.1"
4070
4070
  ],
@@ -4827,7 +4827,7 @@
4827
4827
  "native": 0
4828
4828
  },
4829
4829
  "dependencies": [
4830
- "@krizaka/tokens@^3.60.0",
4830
+ "@krizaka/tokens@^3.62.0",
4831
4831
  "radix-ui@^1.8.1",
4832
4832
  "tailwind-variants@^3.3.1"
4833
4833
  ],
@@ -5299,7 +5299,7 @@
5299
5299
  "native": 0
5300
5300
  },
5301
5301
  "dependencies": [
5302
- "@krizaka/tokens@^3.60.0",
5302
+ "@krizaka/tokens@^3.62.0",
5303
5303
  "radix-ui@^1.8.1",
5304
5304
  "tailwind-variants@^3.3.1"
5305
5305
  ],
package/registry/map.json CHANGED
@@ -1075,7 +1075,7 @@
1075
1075
  }
1076
1076
  ],
1077
1077
  "dependencies": [
1078
- "@krizaka/tokens@^3.60.0",
1078
+ "@krizaka/tokens@^3.62.0",
1079
1079
  "@protomaps/basemaps@5.7.2",
1080
1080
  "tailwind-variants@^3.3.1"
1081
1081
  ],