@hjmds/react 1.19.0 → 1.21.0

package/dist/toggle-feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle-feedback.js","sourceRoot":"","sources":["../src/toggle-feedback.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\nimport { useEffect, useRef, type ReactNode } from \"react\";\nimport { resolveToggleFeedbackProposal, resolveToggleFeedbackFrame, toggleFeedbackPaths, toggleFeedbackRecipe, type ToggleFeedbackEffect, type ToggleFeedbackState } from \"@hjmds/design-contracts/toggle-feedback\";\nimport { Button } from \"./actions.js\";\nimport { AnimatedStatistic } from \"./statistic-motion.js\";\nimport { Stack, Text } from \"./layout.js\";\nimport { useHjmTheme } from \"./provider.js\";\nimport { useCompositionAction } from \"./internal/use-composition-action.js\";\nfunction FeedbackGlyph({ effect, selected, active, icon }: Readonly<{ effect: ToggleFeedbackEffect; selected: boolean; active: boolean; icon?: ReactNode }>) {\n  const glyph = useRef<HTMLSpanElement>(null), circle = useRef<SVGCircleElement>(null), rays = useRef<SVGPathElement>(null), previous = useRef(selected);\n  const reduced = useHjmTheme().environment.reducedMotion;\n  useEffect(() => {\n    const entering = selected && !previous.current; previous.current = selected;\n    let frame = 0, start: number | undefined;\n    const draw = (p: number) => { const f = resolveToggleFeedbackFrame(effect, p); glyph.current?.style.setProperty(\"transform\", `translateY(${f.translateY}px) scale(${f.scale})`); circle.current?.setAttribute(\"r\", String(f.radius)); circle.current?.setAttribute(\"opacity\", effect === \"ripple\" ? String(f.opacity) : \"0\"); rays.current?.setAttribute(\"d\", f.rays); rays.current?.setAttribute(\"opacity\", effect === \"burst\" ? String(f.opacity) : \"0\"); };\n    const settle = () => { cancelAnimationFrame(frame); draw(1); };\n    const animate = (now: number) => { start ??= now; const p = Math.min(1, (now - start) / toggleFeedbackRecipe.duration); draw(p); if (p < 1) frame = requestAnimationFrame(animate); };\n    // The old selected state consumes the event; environment changes never replay it.\n    if (!entering || reduced || !active || document.hidden) settle(); else { draw(0); frame = requestAnimationFrame(animate); }\n    const visibility = () => { if (document.hidden) settle(); }; document.addEventListener(\"visibilitychange\", visibility);\n    return () => { cancelAnimationFrame(frame); document.removeEventListener(\"visibilitychange\", visibility); };\n  }, [selected, effect, active, reduced]);\n  const f = resolveToggleFeedbackFrame(effect, 1);\n  return <span aria-hidden=\"true\" style={{ position: \"relative\", display: \"inline-flex\", width: toggleFeedbackRecipe.glyphSize, height: toggleFeedbackRecipe.glyphSize }}>\n    <span ref={glyph} style={{ display: \"inline-flex\" }}>{icon ?? <svg width={24} height={24} viewBox=\"0 0 24 24\" focusable=\"false\"><path d={toggleFeedbackPaths[effect]} fill={selected ? \"currentColor\" : \"none\"} stroke=\"currentColor\" strokeWidth={1.7} strokeLinejoin=\"round\" /></svg>}</span>\n    <svg data-toggle-effect={effect} width={40} height={40} viewBox=\"0 0 40 40\" focusable=\"false\" style={{ position: \"absolute\", left: -8, top: -8, pointerEvents: \"none\" }} fill=\"none\" stroke=\"currentColor\" strokeWidth={1.7}><circle ref={circle} cx={20} cy={20} r={f.radius} opacity={0} /><path ref={rays} d={f.rays} opacity={0} strokeLinecap=\"round\" /></svg>\n  </span>;\n}\nexport type ToggleFeedbackButtonProps = Readonly<{\n  entityId: string; state: ToggleFeedbackState; effect: ToggleFeedbackEffect; locale: string; icon?: ReactNode;\n  renderIcon?: (state: Readonly<{ selected: boolean; pending: boolean }>) => ReactNode;\n  labels: Readonly<{ select: string; selected: string; pending: string; count: string; error: string }>;\n  /** Update confirmed state from the real API snapshot before resolving. */\n  onSelectedChange: (selected: boolean) => void | Promise<void>; disabled?: boolean; active?: boolean;\n}>;\nexport function ToggleFeedbackButton(props: ToggleFeedbackButtonProps) {\n  if (!props.entityId.trim()) throw new TypeError(\"Toggle feedback requires a stable entity id\");\n  return <ToggleFeedbackBody key={props.entityId} {...props} />;\n}\nfunction ToggleFeedbackBody(props: ToggleFeedbackButtonProps) {\n  resolveToggleFeedbackProposal(props.state, props.state.selected);\n  const active = props.active !== false, action = useCompositionAction<ToggleFeedbackState>(props.disabled === true || !active), state = action.active ?? props.state;\n  const icon = props.renderIcon ? props.renderIcon({ selected: state.selected, pending: action.pending }) : props.icon;\n  return <Stack gap=\"sm\"><Stack axis=\"inline\" gap=\"md\" align=\"center\" wrap>\n    <Button tone=\"secondary\" selected={state.selected} loading={action.pending} disabled={props.disabled === true || !active} aria-label={action.pending ? props.labels.pending : undefined}\n      leading={<FeedbackGlyph effect={props.effect} selected={state.selected} active={active} {...(icon === undefined ? {} : { icon })} />}\n      onClick={() => { const proposal = resolveToggleFeedbackProposal(props.state, !props.state.selected); void action.run(proposal, () => props.onSelectedChange(proposal.selected)); }}>{state.selected ? props.labels.selected : props.labels.select}</Button>\n    <AnimatedStatistic density=\"compact\" descriptor={{ id: \"selection-count\", label: props.labels.count }} value={state.count} locale={props.locale} animated={active} />\n  </Stack>{action.failed ? <Text role=\"alert\" tone=\"danger\" style={{ textAlign: \"center\" }}>{props.labels.error}</Text> : null}</Stack>;\n}\n"]}

package/dist/transfer-task.d.ts

@@ -0,0 +1,18 @@
+import { type TransferObservation, type TransferContext } from "@hjmds/design-contracts/transfer-task";
+export type TransferTaskProps = Readonly<{
+    onTransfer: (context: TransferContext) => Promise<void>;
+    labels: Readonly<{
+        start: string;
+        queued: string;
+        transferring: string;
+        cancel: string;
+        cancelling: string;
+        cancelled: string;
+        success: string;
+        error: string;
+    }>;
+    formatProgress: (observation: TransferObservation) => string;
+    disabled?: boolean;
+}>;
+export declare function TransferTask(props: TransferTaskProps): import("react").JSX.Element;
+//# sourceMappingURL=transfer-task.d.ts.map

package/dist/transfer-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer-task.d.ts","sourceRoot":"","sources":["../src/transfer-task.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAwD,KAAK,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAK7J,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC,UAAU,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,EAAE,QAAQ,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjK,cAAc,EAAE,CAAC,WAAW,EAAE,mBAAmB,KAAK,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAClF,CAAC,CAAC;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,+BAmCpD"}

package/dist/transfer-task.js

@@ -0,0 +1,56 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+import { isConfirmedTransferAbort, resolveTransferObservation } from "@hjmds/design-contracts/transfer-task";
+import { Button } from "./actions.js";
+import { Progress } from "./feedback.js";
+import { Stack, Text } from "./layout.js";
+import { useCompositionAction } from "./internal/use-composition-action.js";
+export function TransferTask(props) {
+    const action = useCompositionAction(props.disabled), mounted = useRef(true), disabled = useRef(props.disabled);
+    disabled.current = props.disabled;
+    const request = useRef(null), latest = useRef(null);
+    const [observation, setObservation] = useState(null), [cancelRequested, setCancelRequested] = useState(false), [cancelled, setCancelled] = useState(false);
+    useEffect(() => { mounted.current = true; return () => { mounted.current = false; request.current?.abort(); request.current = null; }; }, []);
+    const start = () => {
+        if (!mounted.current || disabled.current || request.current)
+            return;
+        const controller = new AbortController();
+        let accepting = true;
+        request.current = controller;
+        latest.current = null;
+        setObservation(null);
+        setCancelled(false);
+        setCancelRequested(false);
+        void action.run("transfer", async () => {
+            try {
+                await props.onTransfer({ signal: controller.signal, report: next => {
+                        if (!accepting || !mounted.current || request.current !== controller || controller.signal.aborted)
+                            return;
+                        const value = resolveTransferObservation(next, latest.current);
+                        latest.current = value;
+                        setObservation(value);
+                    } });
+            }
+            catch (error) {
+                if (mounted.current && request.current === controller && isConfirmedTransferAbort(error, controller.signal))
+                    setCancelled(true);
+                throw error;
+            }
+            finally {
+                accepting = false;
+            }
+        }).then(() => { if (request.current === controller)
+            request.current = null; });
+    };
+    const cancel = () => { if (mounted.current && !disabled.current && request.current && !request.current.signal.aborted) {
+        setCancelRequested(true);
+        request.current.abort();
+    } };
+    const phase = action.session.getSnapshot().status;
+    const status = action.pending ? cancelRequested ? props.labels.cancelling : observation ? props.labels.transferring : props.labels.queued
+        : cancelled ? props.labels.cancelled : phase === "success" ? props.labels.success : action.failed ? props.labels.error : null;
+    const known = observation !== null && observation.total !== null;
+    return _jsxs(Stack, { gap: "md", children: [_jsxs(Stack, { axis: "inline", gap: "sm", wrap: true, children: [_jsx(Button, { loading: action.pending, disabled: props.disabled === true, onClick: start, children: props.labels.start }), action.pending ? _jsx(Button, { tone: "secondary", disabled: props.disabled === true || cancelRequested, onClick: cancel, children: props.labels.cancel }) : null] }), action.pending || known ? _jsx(Progress, { label: status ?? props.labels.transferring, ...(known ? { value: observation.completed, max: observation.total } : {}), ...(observation ? { valueText: props.formatProgress(observation) } : {}) }) : null, observation && !action.pending && !known ? _jsx(Text, { variant: "caption", children: props.formatProgress(observation) }) : null, status && !action.pending ? _jsx(Text, { role: action.failed && !cancelled ? "alert" : "status", style: { textAlign: "center" }, tone: action.failed && !cancelled ? "danger" : "primary", children: status }) : null] });
+}
+//# sourceMappingURL=transfer-task.js.map

package/dist/transfer-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer-task.js","sourceRoot":"","sources":["../src/transfer-task.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\nimport { useEffect, useRef, useState } from \"react\";\nimport { isConfirmedTransferAbort, resolveTransferObservation, type TransferObservation, type TransferContext } from \"@hjmds/design-contracts/transfer-task\";\nimport { Button } from \"./actions.js\";\nimport { Progress } from \"./feedback.js\";\nimport { Stack, Text } from \"./layout.js\";\nimport { useCompositionAction } from \"./internal/use-composition-action.js\";\nexport type TransferTaskProps = Readonly<{\n  onTransfer: (context: TransferContext) => Promise<void>;\n  labels: Readonly<{ start: string; queued: string; transferring: string; cancel: string; cancelling: string; cancelled: string; success: string; error: string }>;\n  formatProgress: (observation: TransferObservation) => string; disabled?: boolean;\n}>;\nexport function TransferTask(props: TransferTaskProps) {\n  const action = useCompositionAction(props.disabled), mounted = useRef(true), disabled = useRef(props.disabled);\n  disabled.current = props.disabled;\n  const request = useRef<AbortController | null>(null), latest = useRef<TransferObservation | null>(null);\n  const [observation, setObservation] = useState<TransferObservation | null>(null), [cancelRequested, setCancelRequested] = useState(false), [cancelled, setCancelled] = useState(false);\n  useEffect(() => { mounted.current = true; return () => { mounted.current = false; request.current?.abort(); request.current = null; }; }, []);\n  const start = () => {\n    if (!mounted.current || disabled.current || request.current) return;\n    const controller = new AbortController(); let accepting = true; request.current = controller; latest.current = null;\n    setObservation(null); setCancelled(false); setCancelRequested(false);\n    void action.run(\"transfer\", async () => {\n      try {\n        await props.onTransfer({ signal: controller.signal, report: next => {\n          if (!accepting || !mounted.current || request.current !== controller || controller.signal.aborted) return;\n          const value = resolveTransferObservation(next, latest.current); latest.current = value; setObservation(value);\n        } });\n      } catch (error) {\n        if (mounted.current && request.current === controller && isConfirmedTransferAbort(error, controller.signal)) setCancelled(true);\n        throw error;\n      } finally { accepting = false; }\n    }).then(() => { if (request.current === controller) request.current = null; });\n  };\n  const cancel = () => { if (mounted.current && !disabled.current && request.current && !request.current.signal.aborted) { setCancelRequested(true); request.current.abort(); } };\n  const phase = action.session.getSnapshot().status;\n  const status = action.pending ? cancelRequested ? props.labels.cancelling : observation ? props.labels.transferring : props.labels.queued\n    : cancelled ? props.labels.cancelled : phase === \"success\" ? props.labels.success : action.failed ? props.labels.error : null;\n  const known = observation !== null && observation.total !== null;\n  return <Stack gap=\"md\"><Stack axis=\"inline\" gap=\"sm\" wrap>\n    <Button loading={action.pending} disabled={props.disabled === true} onClick={start}>{props.labels.start}</Button>\n    {action.pending ? <Button tone=\"secondary\" disabled={props.disabled === true || cancelRequested} onClick={cancel}>{props.labels.cancel}</Button> : null}</Stack>\n    {action.pending || known ? <Progress label={status ?? props.labels.transferring} {...(known ? { value: observation.completed, max: observation.total! } : {})}\n      {...(observation ? { valueText: props.formatProgress(observation) } : {})} /> : null}\n    {observation && !action.pending && !known ? <Text variant=\"caption\">{props.formatProgress(observation)}</Text> : null}\n    {status && !action.pending ? <Text role={action.failed && !cancelled ? \"alert\" : \"status\"} style={{ textAlign: \"center\" }} tone={action.failed && !cancelled ? \"danger\" : \"primary\"}>{status}</Text> : null}\n  </Stack>;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hjmds/react",
-  "version": "1.19.0",
+  "version": "1.21.0",
   "description": "Accessible React 19 renderers for HJM design contracts.",
   "license": "MIT",
   "publishConfig": {
@@ -522,6 +522,61 @@
       "types": "./dist/activity-chip.d.ts",
       "import": "./dist/activity-chip.js",
       "default": "./dist/activity-chip.js"
+    },
+    "./chart": {
+      "types": "./dist/chart.d.ts",
+      "import": "./dist/chart.js",
+      "default": "./dist/chart.js"
+    },
+    "./collection-editing": {
+      "types": "./dist/collection-editing.d.ts",
+      "import": "./dist/collection-editing.js",
+      "default": "./dist/collection-editing.js"
+    },
+    "./data-workflows": {
+      "types": "./dist/data-workflows.d.ts",
+      "import": "./dist/data-workflows.js",
+      "default": "./dist/data-workflows.js"
+    },
+    "./task-controls": {
+      "types": "./dist/task-controls.d.ts",
+      "import": "./dist/task-controls.js",
+      "default": "./dist/task-controls.js"
+    },
+    "./media-transport": {
+      "types": "./dist/media-transport.d.ts",
+      "import": "./dist/media-transport.js",
+      "default": "./dist/media-transport.js"
+    },
+    "./transfer-task": {
+      "types": "./dist/transfer-task.d.ts",
+      "import": "./dist/transfer-task.js",
+      "default": "./dist/transfer-task.js"
+    },
+    "./authoring-tools": {
+      "types": "./dist/authoring-tools.d.ts",
+      "import": "./dist/authoring-tools.js",
+      "default": "./dist/authoring-tools.js"
+    },
+    "./social-compositions": {
+      "types": "./dist/social-compositions.d.ts",
+      "import": "./dist/social-compositions.js",
+      "default": "./dist/social-compositions.js"
+    },
+    "./communication": {
+      "types": "./dist/communication.d.ts",
+      "import": "./dist/communication.js",
+      "default": "./dist/communication.js"
+    },
+    "./toggle-feedback": {
+      "types": "./dist/toggle-feedback.d.ts",
+      "import": "./dist/toggle-feedback.js",
+      "default": "./dist/toggle-feedback.js"
+    },
+    "./streaming-answer": {
+      "types": "./dist/streaming-answer.d.ts",
+      "import": "./dist/streaming-answer.js",
+      "default": "./dist/streaming-answer.js"
     }
   },
   "files": [
@@ -531,7 +586,7 @@
     "THIRD_PARTY_NOTICES.md"
   ],
   "peerDependencies": {
-    "@hjmds/design-contracts": ">=1.19.0 <1.20.0",
+    "@hjmds/design-contracts": ">=1.21.0 <1.22.0",
     "react": ">=19.0.0",
     "react-dom": ">=19.0.0",
     "@number-flow/react": "0.6.2",
@@ -568,7 +623,7 @@
     "blobatar": "2.7.0",
     "@blobatar/react": "2.7.0",
     "lucide-react": "1.49.0",
-    "@hjmds/design-contracts": "1.19.0"
+    "@hjmds/design-contracts": "1.21.0"
   },
   "peerDependenciesMeta": {
     "@number-flow/react": {