@clicoh/orion-library 1.2.0-beta.11 → 1.2.0-beta.14

package/expresivo/ExpJourneyTrack/ExpJourneyTrack.jsx

@@ -0,0 +1,156 @@
+'use client';
+import clsx from 'clsx';
+import { useEffect, useState, } from 'react';
+import { FiCheck } from 'react-icons/fi';
+import { Each, Show, Stepper } from '@clicoh/orion-library';
+import { ExpMascot } from '../ExpMascot';
+import { useExpScopeOptions } from '../ExpScope/ExpScope';
+const STEP_MS = 1100;
+const stateOf = (index, current) => {
+    if (index < current)
+        return 'done';
+    if (index === current)
+        return 'current';
+    return 'pending';
+};
+const dotMap = {
+    done: 'size-3.5 border-lavender bg-lavender dark:border-lavender-dark dark:bg-lavender-dark text-white',
+    current: 'size-[18px] border-lavender bg-white shadow-[0_0_0_5px_rgba(106,93,249,0.18)] dark:border-lavender-dark dark:bg-black',
+    pending: 'size-3.5 border-gray-4 bg-white dark:border-gray-1 dark:bg-black',
+};
+const labelMap = {
+    done: 'font-medium text-black dark:text-white',
+    current: 'font-semibold text-lavender dark:text-lavender-dark',
+    pending: 'font-medium text-gray-1 dark:text-gray-2',
+};
+const alignOf = (index, count) => {
+    if (index === 0)
+        return 'items-start text-left';
+    if (index === count - 1)
+        return 'items-end text-right';
+    return 'items-center text-center';
+};
+/**
+ * Progress line with a mascot that travels to the current stage and takes
+ * that stage's pose. Reached stages get a check and the travelled part of
+ * the line fills with the clicOH gradient. Like the core `Stepper`, it only
+ * displays progress: the consumer owns `current`.
+ *
+ * The line and the mascot are decorative; the stages are an ordered list
+ * whose current item carries `aria-current="step"`.
+ *
+ * Outside an `ExpScope` it falls back to the core `Stepper`. When the scope
+ * hides mascots, the line renders without its traveller.
+ *
+ * @component
+ * @example
+ * <ExpJourneyTrack
+ *   ariaLabel="Progress"
+ *   stateLabels={{ done: 'done', current: 'in progress', pending: 'pending' }}
+ *   current={1}
+ *   stages={[
+ *     { id: 'read', label: 'Read', mascot: 'oculus-04-analizando-documento' },
+ *     { id: 'search', label: 'Search', mascot: 'oculus-07-buscando-rapido' },
+ *     { id: 'answer', label: 'Answer', mascot: 'oculus-08-satisfecho' },
+ *   ]}
+ * />
+ *
+ * @param {Object} props - The properties of the ExpJourneyTrack component.
+ * @param {ExpJourneyStage[]} props.stages - Stages in order, each with `id`, `label`, `mascot`, and optional `meta` and `onSelect`.
+ * @param {number} props.current - Index of the current stage.
+ * @param {string} props.ariaLabel - Accessible name of the list.
+ * @param {ExpJourneyStateLabels} props.stateLabels - Words for `done`, `current` and `pending`.
+ * @param {number} [props.mascotSize=88] - Width and height of the mascot, in pixels.
+ * @param {boolean} [props.autoplay=false] - Walks from the first stage to `current` once when it mounts. Off with reduced motion.
+ *
+ * @returns {ReactNode} The journey track, a core `Stepper` outside an `ExpScope`, or `null` without stages.
+ */
+export function ExpJourneyTrack({ stages, current, ariaLabel, stateLabels, mascotSize = 88, autoplay = false, ...restProps }) {
+    const options = useExpScopeOptions();
+    const [step, setStep] = useState(autoplay ? 0 : current);
+    useEffect(() => {
+        const reduceMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
+        if (!autoplay || reduceMotion) {
+            setStep(current);
+            return;
+        }
+        setStep(0);
+        let index = 0;
+        const timer = setInterval(() => {
+            index += 1;
+            setStep(Math.min(index, current));
+            if (index >= current)
+                clearInterval(timer);
+        }, STEP_MS);
+        return () => clearInterval(timer);
+    }, [autoplay, current, stages.length]);
+    if (stages.length === 0)
+        return null;
+    if (!options) {
+        return (<Stepper ariaLabel={ariaLabel} stateLabels={{ ...stateLabels, skipped: stateLabels.pending }} steps={stages.map((stage, index) => ({
+                id: stage.id,
+                label: stage.label,
+                state: stateOf(index, current),
+            }))}/>);
+    }
+    const showMascot = options.mascots === 'shown';
+    const lastIndex = Math.max(1, stages.length - 1);
+    const percent = (Math.min(step, lastIndex) / lastIndex) * 100;
+    const labelColumns = stages.length > 2
+        ? `minmax(0, 1fr) repeat(${stages.length - 2}, minmax(0, 2fr)) minmax(0, 1fr)`
+        : `repeat(${stages.length}, minmax(0, 1fr))`;
+    return (<div {...restProps} className={clsx('relative', restProps.className)}>
+      <div aria-hidden="true" className="relative" style={{ paddingTop: showMascot ? mascotSize + 8 : 0 }}>
+        {showMascot && (<div className="exp-float absolute top-0 transition-[left] duration-900 ease-[cubic-bezier(.65,0,.35,1)] motion-reduce:transition-none" style={{
+                width: mascotSize,
+                height: mascotSize,
+                left: `clamp(0px, calc(${percent}% - ${mascotSize / 2}px), calc(100% - ${mascotSize}px))`,
+            }}>
+            <Each of={stages} render={(stage, index) => (<span key={stage.id} className={clsx('absolute inset-0 transition-[opacity,scale] delay-200 duration-300 motion-reduce:transition-none', index === step
+                    ? 'scale-100 opacity-100'
+                    : 'scale-85 opacity-0')}>
+                  <ExpMascot name={stage.mascot} size={mascotSize}/>
+                </span>)}/>
+          </div>)}
+        <div className="bg-gray-5 dark:bg-gray-dark-1 relative mx-1.5 h-1.5 rounded-full">
+          <span className="from-lavender to-violet absolute inset-y-0 left-0 rounded-full bg-linear-90 transition-[width] duration-900 ease-[cubic-bezier(.65,0,.35,1)] motion-reduce:transition-none" style={{ width: `${percent}%` }}/>
+          <Each of={stages} render={(stage, index) => {
+            const state = stateOf(index, step);
+            return (<span key={stage.id} className={clsx('absolute top-1/2 flex -translate-x-1/2 -translate-y-1/2 items-center justify-center rounded-full border-2 transition-all duration-300', dotMap[state])} style={{ left: `${(index / lastIndex) * 100}%` }}>
+                  {state === 'done' && (<FiCheck strokeWidth={4} className="size-2"/>)}
+                </span>);
+        }}/>
+        </div>
+      </div>
+      <ol aria-label={ariaLabel} className="mt-3.5 grid" style={{ gridTemplateColumns: labelColumns }}>
+        <Each of={stages} render={(stage, index) => {
+            const state = stateOf(index, current);
+            const isReached = index <= current;
+            const body = (<>
+                <span className={clsx('text-xs leading-4 transition-colors duration-300', labelMap[stateOf(index, step)])}>
+                  {stage.label}
+                  <span className="sr-only">, {stateLabels[state]}</span>
+                </span>
+                {!!stage.meta && (<span className={clsx('text-gray-1 dark:text-gray-2 text-[11px] leading-4 transition-opacity duration-300', index <= step ? 'opacity-100' : 'opacity-0')}>
+                    {stage.meta}
+                  </span>)}
+              </>);
+            return (<li key={stage.id} aria-current={state === 'current' ? 'step' : undefined} className="flex min-w-0">
+                <Show>
+                  <Show.When isTrue={Boolean(stage.onSelect) && isReached}>
+                    <button type="button" onClick={stage.onSelect} className={clsx('focus-visible:ring-lavender -mx-1.5 -my-1 flex w-full flex-col gap-0.5 rounded-lg px-1.5 py-1 focus-visible:ring-2 focus-visible:outline-none', alignOf(index, stages.length))}>
+                      {body}
+                    </button>
+                  </Show.When>
+                  <Show.Else>
+                    <span className={clsx('flex w-full flex-col gap-0.5', alignOf(index, stages.length))}>
+                      {body}
+                    </span>
+                  </Show.Else>
+                </Show>
+              </li>);
+        }}/>
+      </ol>
+    </div>);
+}
+//# sourceMappingURL=ExpJourneyTrack.jsx.map

package/expresivo/ExpJourneyTrack/ExpJourneyTrack.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpJourneyTrack.jsx","sourceRoot":"","sources":["../../src/expresivo/ExpJourneyTrack/ExpJourneyTrack.tsx"],"names":[],"mappings":"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"}

package/expresivo/ExpJourneyTrack/index.d.ts

@@ -0,0 +1,3 @@
+export { ExpJourneyTrack } from './ExpJourneyTrack';
+export type { ExpJourneyStage, ExpJourneyStateLabels, ExpJourneyTrackProps, } from './ExpJourneyTrack';
+//# sourceMappingURL=index.d.ts.map

package/expresivo/ExpJourneyTrack/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/expresivo/ExpJourneyTrack/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC"}

package/expresivo/ExpJourneyTrack/index.js

@@ -0,0 +1,2 @@
+export { ExpJourneyTrack } from './ExpJourneyTrack';
+//# sourceMappingURL=index.js.map

package/expresivo/ExpJourneyTrack/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/expresivo/ExpJourneyTrack/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/expresivo/ExpKeyButton/ExpKeyButton.d.ts

@@ -0,0 +1,49 @@
+import type { ButtonHTMLAttributes, ReactNode } from 'react';
+export type ExpKeyButtonTone = 'brand' | 'white' | 'black';
+export type ExpKeyButtonSize = 'lg' | 'sm';
+export type ExpKeyButtonIcon = 'lens' | 'sync' | 'none';
+export type ExpKeyButtonProps = {
+    tone?: ExpKeyButtonTone;
+    size?: ExpKeyButtonSize;
+    icon?: ExpKeyButtonIcon;
+    /** Shows an arrow after the label that steps forward on hover. */
+    arrow?: boolean;
+    /** Sinks the key and blocks it while the action runs. */
+    busy?: boolean;
+    /** Label shown while `busy`. Defaults to `children`. */
+    busyLabel?: string;
+    /** Takes the full width of its container. */
+    block?: boolean;
+} & ButtonHTMLAttributes<HTMLButtonElement>;
+/**
+ * Call to action shaped like a physical key: a gradient face over a darker
+ * edge that gives it depth. It lifts on hover, sinks when pressed and stays
+ * sunk while `busy`, with a shine crossing its face. Use one per screen, for
+ * the main action.
+ *
+ * Outside an `ExpScope` it falls back to the core `Button`: `white` maps to
+ * `second`, the other tones to `principal`, and `sm` to the `field` size.
+ *
+ * @component
+ * @example
+ * <ExpKeyButton onClick={start}>Start</ExpKeyButton>
+ *
+ * @example
+ * // Compact, in a row of form controls, without icon or arrow
+ * <ExpKeyButton size="sm" tone="white" icon="none" arrow={false}>Clear</ExpKeyButton>
+ *
+ * @param {Object} props - The properties of the ExpKeyButton component.
+ * @param {'brand' | 'white' | 'black'} [props.tone='brand'] - Color of the key face.
+ * @param {'lg' | 'sm'} [props.size='lg'] - `lg` is 52px tall; `sm` is 36px, the height of `Input`, `Select` and `DatePicker`.
+ * @param {'lens' | 'sync' | 'none'} [props.icon='lens'] - Glyph before the label.
+ * @param {boolean} [props.arrow=true] - Shows an arrow after the label.
+ * @param {boolean} [props.busy=false] - Sinks the key and blocks it while the action runs.
+ * @param {string} [props.busyLabel] - Label shown while `busy`.
+ * @param {boolean} [props.block=false] - Takes the full width of its container.
+ * @param {ReactNode} props.children - Label of the action.
+ * @param {ButtonHTMLAttributes<HTMLButtonElement>} restProps - Additional properties for the button element.
+ *
+ * @returns {ReactNode} The rendered key, or a core `Button` outside an `ExpScope`.
+ */
+export declare function ExpKeyButton({ tone, size, icon, arrow, busy, busyLabel, block, disabled, children, ...restProps }: ExpKeyButtonProps): ReactNode;
+//# sourceMappingURL=ExpKeyButton.d.ts.map

package/expresivo/ExpKeyButton/ExpKeyButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpKeyButton.d.ts","sourceRoot":"","sources":["../../src/expresivo/ExpKeyButton/ExpKeyButton.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAM7D,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAE3D,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3C,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAExD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yDAAyD;IACzD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;AAY5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,CAAC,EAC3B,IAAc,EACd,IAAW,EACX,IAAa,EACb,KAAY,EACZ,IAAY,EACZ,SAAS,EACT,KAAa,EACb,QAAgB,EAChB,QAAQ,EACR,GAAG,SAAS,EACb,EAAE,iBAAiB,GAAG,SAAS,CAmD/B"}

package/expresivo/ExpKeyButton/ExpKeyButton.jsx

@@ -0,0 +1,60 @@
+'use client';
+import clsx from 'clsx';
+import { FiArrowRight, FiRefreshCw, FiSearch } from 'react-icons/fi';
+import { Button } from '@clicoh/orion-library';
+import { useExpScope } from '../ExpScope/ExpScope';
+import { ArrowGlyph, LensGlyph, SyncBadgeGlyph } from '../shared/glyphs';
+const fallbackIconMap = {
+    lens: <FiSearch />,
+    sync: <FiRefreshCw />,
+    none: undefined,
+};
+const glyphSizeMap = { lg: 32, sm: 24 };
+const arrowSizeMap = { lg: 20, sm: 16 };
+/**
+ * Call to action shaped like a physical key: a gradient face over a darker
+ * edge that gives it depth. It lifts on hover, sinks when pressed and stays
+ * sunk while `busy`, with a shine crossing its face. Use one per screen, for
+ * the main action.
+ *
+ * Outside an `ExpScope` it falls back to the core `Button`: `white` maps to
+ * `second`, the other tones to `principal`, and `sm` to the `field` size.
+ *
+ * @component
+ * @example
+ * <ExpKeyButton onClick={start}>Start</ExpKeyButton>
+ *
+ * @example
+ * // Compact, in a row of form controls, without icon or arrow
+ * <ExpKeyButton size="sm" tone="white" icon="none" arrow={false}>Clear</ExpKeyButton>
+ *
+ * @param {Object} props - The properties of the ExpKeyButton component.
+ * @param {'brand' | 'white' | 'black'} [props.tone='brand'] - Color of the key face.
+ * @param {'lg' | 'sm'} [props.size='lg'] - `lg` is 52px tall; `sm` is 36px, the height of `Input`, `Select` and `DatePicker`.
+ * @param {'lens' | 'sync' | 'none'} [props.icon='lens'] - Glyph before the label.
+ * @param {boolean} [props.arrow=true] - Shows an arrow after the label.
+ * @param {boolean} [props.busy=false] - Sinks the key and blocks it while the action runs.
+ * @param {string} [props.busyLabel] - Label shown while `busy`.
+ * @param {boolean} [props.block=false] - Takes the full width of its container.
+ * @param {ReactNode} props.children - Label of the action.
+ * @param {ButtonHTMLAttributes<HTMLButtonElement>} restProps - Additional properties for the button element.
+ *
+ * @returns {ReactNode} The rendered key, or a core `Button` outside an `ExpScope`.
+ */
+export function ExpKeyButton({ tone = 'brand', size = 'lg', icon = 'lens', arrow = true, busy = false, busyLabel, block = false, disabled = false, children, ...restProps }) {
+    const inScope = useExpScope();
+    const label = busy && busyLabel ? busyLabel : children;
+    if (!inScope) {
+        return (<Button {...restProps} modifier={tone === 'white' ? 'second' : 'principal'} size={size === 'lg' ? 'md' : 'field'} iconL={fallbackIconMap[icon]} iconR={arrow ? <FiArrowRight /> : undefined} disabled={disabled || busy} aria-busy={busy || undefined} className={clsx(block && 'w-full', restProps.className)}>
+        {label}
+      </Button>);
+    }
+    return (<button {...restProps} disabled={disabled || busy} aria-busy={busy || undefined} data-tone={tone} data-size={size} data-icon={icon} data-state={disabled ? 'disabled' : busy ? 'busy' : 'idle'} className={clsx('exp-key', block && 'exp-key--block', restProps.className)}>
+      {busy && <span aria-hidden="true" className="exp-key-shine"/>}
+      {icon === 'lens' && (<LensGlyph size={glyphSizeMap[size]} busy={busy} disabled={disabled}/>)}
+      {icon === 'sync' && (<SyncBadgeGlyph size={glyphSizeMap[size]} busy={busy} disabled={disabled}/>)}
+      <span className="exp-key-label">{label}</span>
+      {arrow && <ArrowGlyph size={arrowSizeMap[size]}/>}
+    </button>);
+}
+//# sourceMappingURL=ExpKeyButton.jsx.map

package/expresivo/ExpKeyButton/ExpKeyButton.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpKeyButton.jsx","sourceRoot":"","sources":["../../src/expresivo/ExpKeyButton/ExpKeyButton.tsx"],"names":[],"mappings":"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"}

package/expresivo/ExpKeyButton/index.d.ts

@@ -0,0 +1,3 @@
+export { ExpKeyButton } from './ExpKeyButton';
+export type { ExpKeyButtonIcon, ExpKeyButtonProps, ExpKeyButtonSize, ExpKeyButtonTone, } from './ExpKeyButton';
+//# sourceMappingURL=index.d.ts.map

package/expresivo/ExpKeyButton/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/expresivo/ExpKeyButton/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC"}

package/expresivo/ExpKeyButton/index.js

@@ -0,0 +1,2 @@
+export { ExpKeyButton } from './ExpKeyButton';
+//# sourceMappingURL=index.js.map

package/expresivo/ExpKeyButton/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/expresivo/ExpKeyButton/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/expresivo/ExpLensIcon/ExpLensIcon.d.ts

@@ -0,0 +1,29 @@
+import type { ReactNode } from 'react';
+export type ExpLensIconProps = {
+    /** Width and height in pixels. */
+    size?: number;
+    /** Scans from side to side while the action runs. */
+    busy?: boolean;
+    /** Grays out, to match a disabled button. */
+    disabled?: boolean;
+};
+/**
+ * Magnifier with an eye inside, for the `iconL` of a core `Button` that
+ * searches or investigates. It blinks at rest, looks towards the label while
+ * the button is hovered, and scans while `busy`. It is decorative.
+ *
+ * Outside an `ExpScope` it falls back to the plain search icon.
+ *
+ * @component
+ * @example
+ * <Button iconL={<ExpLensIcon busy={isSearching} />}>Search</Button>
+ *
+ * @param {Object} props - The properties of the ExpLensIcon component.
+ * @param {number} [props.size=20] - Width and height in pixels.
+ * @param {boolean} [props.busy=false] - Scans from side to side while the action runs.
+ * @param {boolean} [props.disabled=false] - Grays out, to match a disabled button.
+ *
+ * @returns {ReactNode} The lens, or `FiSearch` outside an `ExpScope`.
+ */
+export declare function ExpLensIcon({ size, busy, disabled, }: ExpLensIconProps): ReactNode;
+//# sourceMappingURL=ExpLensIcon.d.ts.map

package/expresivo/ExpLensIcon/ExpLensIcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpLensIcon.d.ts","sourceRoot":"","sources":["../../src/expresivo/ExpLensIcon/ExpLensIcon.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,EAC1B,IAAS,EACT,IAAY,EACZ,QAAgB,GACjB,EAAE,gBAAgB,GAAG,SAAS,CAM9B"}

package/expresivo/ExpLensIcon/ExpLensIcon.jsx

@@ -0,0 +1,29 @@
+'use client';
+import { FiSearch } from 'react-icons/fi';
+import { useExpScope } from '../ExpScope/ExpScope';
+import { LensGlyph } from '../shared/glyphs';
+/**
+ * Magnifier with an eye inside, for the `iconL` of a core `Button` that
+ * searches or investigates. It blinks at rest, looks towards the label while
+ * the button is hovered, and scans while `busy`. It is decorative.
+ *
+ * Outside an `ExpScope` it falls back to the plain search icon.
+ *
+ * @component
+ * @example
+ * <Button iconL={<ExpLensIcon busy={isSearching} />}>Search</Button>
+ *
+ * @param {Object} props - The properties of the ExpLensIcon component.
+ * @param {number} [props.size=20] - Width and height in pixels.
+ * @param {boolean} [props.busy=false] - Scans from side to side while the action runs.
+ * @param {boolean} [props.disabled=false] - Grays out, to match a disabled button.
+ *
+ * @returns {ReactNode} The lens, or `FiSearch` outside an `ExpScope`.
+ */
+export function ExpLensIcon({ size = 20, busy = false, disabled = false, }) {
+    const inScope = useExpScope();
+    if (!inScope)
+        return <FiSearch aria-hidden="true"/>;
+    return <LensGlyph size={size} busy={busy} disabled={disabled}/>;
+}
+//# sourceMappingURL=ExpLensIcon.jsx.map

package/expresivo/ExpLensIcon/ExpLensIcon.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpLensIcon.jsx","sourceRoot":"","sources":["../../src/expresivo/ExpLensIcon/ExpLensIcon.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAW7C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,WAAW,CAAC,EAC1B,IAAI,GAAG,EAAE,EACT,IAAI,GAAG,KAAK,EACZ,QAAQ,GAAG,KAAK,GACC;IACjB,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAE9B,IAAI,CAAC,OAAO;QAAE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAG,CAAC;IAErD,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,EAAG,CAAC;AACnE,CAAC"}

package/expresivo/ExpLensIcon/index.d.ts

@@ -0,0 +1,3 @@
+export { ExpLensIcon } from './ExpLensIcon';
+export type { ExpLensIconProps } from './ExpLensIcon';
+//# sourceMappingURL=index.d.ts.map

package/expresivo/ExpLensIcon/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/expresivo/ExpLensIcon/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/expresivo/ExpLensIcon/index.js

@@ -0,0 +1,2 @@
+export { ExpLensIcon } from './ExpLensIcon';
+//# sourceMappingURL=index.js.map

package/expresivo/ExpLensIcon/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/expresivo/ExpLensIcon/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/expresivo/ExpMascot/ExpMascot.d.ts

@@ -0,0 +1,41 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+import { type ExpMascotName } from './catalog';
+export type ExpMascotMotion = 'still' | 'float' | 'hang';
+export type ExpMascotProps = {
+    name: ExpMascotName;
+    /** Width and height on screen, in pixels. */
+    size?: number;
+    motion?: ExpMascotMotion;
+} & Omit<HTMLAttributes<HTMLSpanElement>, 'children'>;
+/**
+ * One of the official clicOH mascots, drawn from its file as is: never
+ * redrawn, recolored or cropped.
+ *
+ * Mascots are decorative and hidden from screen readers, so the text next to
+ * them must carry the message. Use one per state (empty, loading, error, no
+ * permission, success), above the title and the copy, and never on screens
+ * full of data. Suggested sizes: 96–128px for desktop empty states, 80px on
+ * small screens, 48–64px inside a message or a toast.
+ *
+ * In dark mode Bugi sits on a light disc so it reads on the dark background;
+ * Oculus and Fixi need none.
+ *
+ * Renders nothing outside an `ExpScope`, or when the scope hides mascots.
+ *
+ * @component
+ * @example
+ * <ExpMascot name="oculus-01-feliz" size={112} />
+ *
+ * @example
+ * // Hanging from a thread, swinging gently
+ * <ExpMascot name="fixi-06-celebrando" size={56} motion="hang" />
+ *
+ * @param {Object} props - The properties of the ExpMascot component.
+ * @param {ExpMascotName} props.name - Mascot and pose, as in `oculus-01-feliz`.
+ * @param {number} [props.size=112] - Width and height on screen, in pixels.
+ * @param {'still' | 'float' | 'hang'} [props.motion='still'] - `float` bobs up and down; `hang` hangs it from a thread and swings it. Both stop with reduced motion.
+ *
+ * @returns {ReactNode} The mascot, or `null` outside an `ExpScope`.
+ */
+export declare function ExpMascot({ name, size, motion, ...restProps }: ExpMascotProps): ReactNode;
+//# sourceMappingURL=ExpMascot.d.ts.map

package/expresivo/ExpMascot/ExpMascot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpMascot.d.ts","sourceRoot":"","sources":["../../src/expresivo/ExpMascot/ExpMascot.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvD,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,WAAW,CAAC;AAE9D,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzD,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,aAAa,CAAC;IACpB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B,GAAG,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,IAAU,EACV,MAAgB,EAChB,GAAG,SAAS,EACb,EAAE,cAAc,GAAG,SAAS,CAiC5B"}

package/expresivo/ExpMascot/ExpMascot.jsx

@@ -0,0 +1,45 @@
+'use client';
+import clsx from 'clsx';
+import { useExpScopeOptions } from '../ExpScope/ExpScope';
+import { mascotCatalog } from './catalog';
+/**
+ * One of the official clicOH mascots, drawn from its file as is: never
+ * redrawn, recolored or cropped.
+ *
+ * Mascots are decorative and hidden from screen readers, so the text next to
+ * them must carry the message. Use one per state (empty, loading, error, no
+ * permission, success), above the title and the copy, and never on screens
+ * full of data. Suggested sizes: 96–128px for desktop empty states, 80px on
+ * small screens, 48–64px inside a message or a toast.
+ *
+ * In dark mode Bugi sits on a light disc so it reads on the dark background;
+ * Oculus and Fixi need none.
+ *
+ * Renders nothing outside an `ExpScope`, or when the scope hides mascots.
+ *
+ * @component
+ * @example
+ * <ExpMascot name="oculus-01-feliz" size={112} />
+ *
+ * @example
+ * // Hanging from a thread, swinging gently
+ * <ExpMascot name="fixi-06-celebrando" size={56} motion="hang" />
+ *
+ * @param {Object} props - The properties of the ExpMascot component.
+ * @param {ExpMascotName} props.name - Mascot and pose, as in `oculus-01-feliz`.
+ * @param {number} [props.size=112] - Width and height on screen, in pixels.
+ * @param {'still' | 'float' | 'hang'} [props.motion='still'] - `float` bobs up and down; `hang` hangs it from a thread and swings it. Both stop with reduced motion.
+ *
+ * @returns {ReactNode} The mascot, or `null` outside an `ExpScope`.
+ */
+export function ExpMascot({ name, size = 112, motion = 'still', ...restProps }) {
+    const options = useExpScopeOptions();
+    if (!options || options.mascots === 'hidden')
+        return null;
+    return (<span {...restProps} aria-hidden="true" className={clsx('inline-flex shrink-0 flex-col items-center', motion === 'float' && 'exp-float', motion === 'hang' && 'exp-hang', restProps.className)}>
+      {motion === 'hang' && (<span className="bg-lavender-1 dark:bg-lavender-dark-1 h-3.5 w-[1.5px]"/>)}
+      <img src={mascotCatalog[name].src} alt="" width={size} height={size} draggable={false} className={clsx('block object-contain', name.startsWith('bugi-') &&
+            'dark:bg-gray-6 dark:rounded-full dark:p-[8%]')}/>
+    </span>);
+}
+//# sourceMappingURL=ExpMascot.jsx.map

package/expresivo/ExpMascot/ExpMascot.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpMascot.jsx","sourceRoot":"","sources":["../../src/expresivo/ExpMascot/ExpMascot.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAsB,aAAa,EAAE,MAAM,WAAW,CAAC;AAW9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,SAAS,CAAC,EACxB,IAAI,EACJ,IAAI,GAAG,GAAG,EACV,MAAM,GAAG,OAAO,EAChB,GAAG,SAAS,EACG;IACf,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IAErC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE1D,OAAO,CACL,CAAC,IAAI,CACH,IAAI,SAAS,CAAC,CACd,WAAW,CAAC,MAAM,CAClB,SAAS,CAAC,CAAC,IAAI,CACb,4CAA4C,EAC5C,MAAM,KAAK,OAAO,IAAI,WAAW,EACjC,MAAM,KAAK,MAAM,IAAI,UAAU,EAC/B,SAAS,CAAC,SAAS,CACpB,CAAC,CAEF;MAAA,CAAC,MAAM,KAAK,MAAM,IAAI,CACpB,CAAC,IAAI,CAAC,SAAS,CAAC,uDAAuD,EAAG,CAC3E,CACD;MAAA,CAAC,GAAG,CACF,GAAG,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAC7B,GAAG,CAAC,EAAE,CACN,KAAK,CAAC,CAAC,IAAI,CAAC,CACZ,MAAM,CAAC,CAAC,IAAI,CAAC,CACb,SAAS,CAAC,CAAC,KAAK,CAAC,CACjB,SAAS,CAAC,CAAC,IAAI,CACb,sBAAsB,EACtB,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;YACtB,8CAA8C,CACjD,CAAC,EAEN;IAAA,EAAE,IAAI,CAAC,CACR,CAAC;AACJ,CAAC"}

package/expresivo/ExpMascot/catalog.d.ts

@@ -0,0 +1,12 @@
+import type { StaticImageData } from 'next/image';
+/**
+ * Official clicOH mascots, named `<mascot>-<NN>-<pose>` like their files.
+ * `oculus` is the agent, `bugi` the problem and `fixi` the fix.
+ */
+export type ExpMascotName = 'oculus-01-feliz' | 'oculus-02-investigando' | 'oculus-03-dudando' | 'oculus-04-analizando-documento' | 'oculus-06-celebrando' | 'oculus-07-buscando-rapido' | 'oculus-08-satisfecho' | 'bugi-01-alerta' | 'bugi-02-investigando' | 'bugi-05-sorprendido' | 'fixi-01-feliz' | 'fixi-02-investigando' | 'fixi-03-dudando' | 'fixi-04-reparando' | 'fixi-05-sorprendido' | 'fixi-06-celebrando' | 'fixi-07-corriendo';
+/**
+ * Oculus and Bugi are vectors. Fixi is a 256px WebP, sharp up to 128px on
+ * high-density screens.
+ */
+export declare const mascotCatalog: Record<ExpMascotName, StaticImageData>;
+//# sourceMappingURL=catalog.d.ts.map

package/expresivo/ExpMascot/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/expresivo/ExpMascot/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAmBlD;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB,iBAAiB,GACjB,wBAAwB,GACxB,mBAAmB,GACnB,gCAAgC,GAChC,sBAAsB,GACtB,2BAA2B,GAC3B,sBAAsB,GACtB,gBAAgB,GAChB,sBAAsB,GACtB,qBAAqB,GACrB,eAAe,GACf,sBAAsB,GACtB,iBAAiB,GACjB,mBAAmB,GACnB,qBAAqB,GACrB,oBAAoB,GACpB,mBAAmB,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,eAAe,CAkBhE,CAAC"}

package/expresivo/ExpMascot/catalog.js

@@ -0,0 +1,41 @@
+import bugi01 from '@clicoh/orion-library/assets/mascotas/svg/bugi-mascota-01-alerta.svg';
+import bugi02 from '@clicoh/orion-library/assets/mascotas/svg/bugi-mascota-02-investigando.svg';
+import bugi05 from '@clicoh/orion-library/assets/mascotas/svg/bugi-mascota-05-sorprendido.svg';
+import oculus01 from '@clicoh/orion-library/assets/mascotas/svg/oculus-mascota-01-feliz.svg';
+import oculus02 from '@clicoh/orion-library/assets/mascotas/svg/oculus-mascota-02-investigando.svg';
+import oculus03 from '@clicoh/orion-library/assets/mascotas/svg/oculus-mascota-03-dudando.svg';
+import oculus04 from '@clicoh/orion-library/assets/mascotas/svg/oculus-mascota-04-analizando-documento.svg';
+import oculus06 from '@clicoh/orion-library/assets/mascotas/svg/oculus-mascota-06-celebrando.svg';
+import oculus07 from '@clicoh/orion-library/assets/mascotas/svg/oculus-mascota-07-buscando-rapido.svg';
+import oculus08 from '@clicoh/orion-library/assets/mascotas/svg/oculus-mascota-08-satisfecho.svg';
+import fixi01 from '@clicoh/orion-library/assets/mascotas/webp/fixi-mascota-01-feliz-sm.webp';
+import fixi02 from '@clicoh/orion-library/assets/mascotas/webp/fixi-mascota-02-investigando-sm.webp';
+import fixi03 from '@clicoh/orion-library/assets/mascotas/webp/fixi-mascota-03-dudando-sm.webp';
+import fixi04 from '@clicoh/orion-library/assets/mascotas/webp/fixi-mascota-04-reparando-sm.webp';
+import fixi05 from '@clicoh/orion-library/assets/mascotas/webp/fixi-mascota-05-sorprendido-sm.webp';
+import fixi06 from '@clicoh/orion-library/assets/mascotas/webp/fixi-mascota-06-celebrando-sm.webp';
+import fixi07 from '@clicoh/orion-library/assets/mascotas/webp/fixi-mascota-07-corriendo-sm.webp';
+/**
+ * Oculus and Bugi are vectors. Fixi is a 256px WebP, sharp up to 128px on
+ * high-density screens.
+ */
+export const mascotCatalog = {
+    'oculus-01-feliz': oculus01,
+    'oculus-02-investigando': oculus02,
+    'oculus-03-dudando': oculus03,
+    'oculus-04-analizando-documento': oculus04,
+    'oculus-06-celebrando': oculus06,
+    'oculus-07-buscando-rapido': oculus07,
+    'oculus-08-satisfecho': oculus08,
+    'bugi-01-alerta': bugi01,
+    'bugi-02-investigando': bugi02,
+    'bugi-05-sorprendido': bugi05,
+    'fixi-01-feliz': fixi01,
+    'fixi-02-investigando': fixi02,
+    'fixi-03-dudando': fixi03,
+    'fixi-04-reparando': fixi04,
+    'fixi-05-sorprendido': fixi05,
+    'fixi-06-celebrando': fixi06,
+    'fixi-07-corriendo': fixi07,
+};
+//# sourceMappingURL=catalog.js.map

package/expresivo/ExpMascot/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/expresivo/ExpMascot/catalog.ts"],"names":[],"mappings":"AACA,OAAO,MAAM,MAAM,sEAAsE,CAAC;AAC1F,OAAO,MAAM,MAAM,4EAA4E,CAAC;AAChG,OAAO,MAAM,MAAM,2EAA2E,CAAC;AAC/F,OAAO,QAAQ,MAAM,uEAAuE,CAAC;AAC7F,OAAO,QAAQ,MAAM,8EAA8E,CAAC;AACpG,OAAO,QAAQ,MAAM,yEAAyE,CAAC;AAC/F,OAAO,QAAQ,MAAM,sFAAsF,CAAC;AAC5G,OAAO,QAAQ,MAAM,4EAA4E,CAAC;AAClG,OAAO,QAAQ,MAAM,iFAAiF,CAAC;AACvG,OAAO,QAAQ,MAAM,4EAA4E,CAAC;AAClG,OAAO,MAAM,MAAM,0EAA0E,CAAC;AAC9F,OAAO,MAAM,MAAM,iFAAiF,CAAC;AACrG,OAAO,MAAM,MAAM,4EAA4E,CAAC;AAChG,OAAO,MAAM,MAAM,8EAA8E,CAAC;AAClG,OAAO,MAAM,MAAM,gFAAgF,CAAC;AACpG,OAAO,MAAM,MAAM,+EAA+E,CAAC;AACnG,OAAO,MAAM,MAAM,8EAA8E,CAAC;AAyBlG;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAA2C;IACnE,iBAAiB,EAAE,QAAQ;IAC3B,wBAAwB,EAAE,QAAQ;IAClC,mBAAmB,EAAE,QAAQ;IAC7B,gCAAgC,EAAE,QAAQ;IAC1C,sBAAsB,EAAE,QAAQ;IAChC,2BAA2B,EAAE,QAAQ;IACrC,sBAAsB,EAAE,QAAQ;IAChC,gBAAgB,EAAE,MAAM;IACxB,sBAAsB,EAAE,MAAM;IAC9B,qBAAqB,EAAE,MAAM;IAC7B,eAAe,EAAE,MAAM;IACvB,sBAAsB,EAAE,MAAM;IAC9B,iBAAiB,EAAE,MAAM;IACzB,mBAAmB,EAAE,MAAM;IAC3B,qBAAqB,EAAE,MAAM;IAC7B,oBAAoB,EAAE,MAAM;IAC5B,mBAAmB,EAAE,MAAM;CAC5B,CAAC"}

package/expresivo/ExpMascot/index.d.ts

@@ -0,0 +1,4 @@
+export { ExpMascot } from './ExpMascot';
+export type { ExpMascotMotion, ExpMascotProps } from './ExpMascot';
+export type { ExpMascotName } from './catalog';
+//# sourceMappingURL=index.d.ts.map

package/expresivo/ExpMascot/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/expresivo/ExpMascot/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/expresivo/ExpMascot/index.js

@@ -0,0 +1,2 @@
+export { ExpMascot } from './ExpMascot';
+//# sourceMappingURL=index.js.map

package/expresivo/ExpMascot/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/expresivo/ExpMascot/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/expresivo/ExpMedalBadge/ExpMedalBadge.d.ts

@@ -0,0 +1,29 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+export type ExpMedalBadgeModifier = 'success' | 'warning' | 'error' | 'info' | 'progress' | 'disabled';
+export type ExpMedalBadgeProps = {
+    modifier: ExpMedalBadgeModifier;
+    /** One character or a tiny icon inside the medal. */
+    glyph?: ReactNode;
+    children: ReactNode;
+} & Omit<HTMLAttributes<HTMLSpanElement>, 'children'>;
+/**
+ * Status badge drawn as an octagonal medal with a ribbon, pinned to a tinted
+ * pill. Same status modifiers as the core `Badge`; the label carries the
+ * message and the medal only decorates it.
+ *
+ * Outside an `ExpScope` it falls back to the core `Badge` with the same
+ * `modifier`.
+ *
+ * @component
+ * @example
+ * <ExpMedalBadge modifier="success" glyph="✓">Passed</ExpMedalBadge>
+ *
+ * @param {Object} props - The properties of the ExpMedalBadge component.
+ * @param {'success' | 'warning' | 'error' | 'info' | 'progress' | 'disabled'} props.modifier - Status color.
+ * @param {ReactNode} [props.glyph='•'] - One character or a tiny icon inside the medal.
+ * @param {ReactNode} props.children - Label of the status.
+ *
+ * @returns {ReactNode} The medal badge, or a core `Badge` outside an `ExpScope`.
+ */
+export declare function ExpMedalBadge({ modifier, glyph, children, ...restProps }: ExpMedalBadgeProps): ReactNode;
+//# sourceMappingURL=ExpMedalBadge.d.ts.map