@fairgarden/design 0.1.0-alpha.0 → 0.1.0-alpha.2

package/feedback/toast/Toast.js

@@ -0,0 +1,183 @@
+'use client';
+import * as React from 'react';
+import { Toast as BaseToast } from '@base-ui/react/toast';
+import { Button as BaseButton } from '@base-ui/react/button';
+import { cva } from 'class-variance-authority';
+import { Button } from '../../actions/button';
+import { StatusGlyph, statusLabels, statusScales } from '../../utils/StatusGlyph';
+import { cx } from '../../utils/className';
+import { OverlayScope, overlayActionClassName, overlayAttributes, overlayScales, } from '../../utils/overlay';
+import { primaryScaleVariants, secondaryScaleVariants, } from '../../utils/scales';
+import { useReleaseMark } from '../../utils/useReleaseMark';
+import styles from './toast.module.css';
+/*
+ * Toast (§10.17): a brief confirmation or a non-blocking notice, docked as
+ * a full-width bar, never a floating card [D25].
+ *
+ * Implementation (CSS Modules + CVA)
+ * - Module: toast.module.css; CVA function `toast` (one toast in the bar).
+ * - Axes: `status` → info | success | warning | danger (selects the glyph
+ *   and its scale; it carries no class; omitted for the neutral toast);
+ *   `primary`, `secondary` → scales module classes on the bar's scope
+ *   (ToastProvider).
+ * - Compound variants: none. Defaults: no `status`; color axes: none.
+ * - Color fallback: the glyph takes the status scale [D129]; the bar takes
+ *   the `white` preset's defaults.
+ * - States: Root data-starting-style / data-ending-style → the clip reveal
+ *   from the bottom edge, instant under --motionNotOK [D91]; data-limited →
+ *   hidden beyond the one visible toast (the queue count shows); Base UI's
+ *   data-type is not styled. Action :hover → label --role-link-hover, as
+ *   the §9.2 `text` Button (underlined where that is --primary12) [D181],
+ *   :focus-visible → ring inside the cell, :active → the inverse pair,
+ *   aria-busy → "Undoing…" at rest width; a `destructive` action's label
+ *   is --role-danger-text, underlined on hover [D192]. Close is an
+ *   icon-only Button.
+ * - Parts: viewport (the docked bar's host), base (a toast, the bar), glyph,
+ *   message, title, description, queue, actions, action, close.
+ * - Scope: the viewport renders in its Base UI Portal and declares a nested
+ *   `white` scope (`page` scheme, no data-theme); its rule is the
+ *   --border-size-2 --primary12 overlay frame on the content side only
+ *   [D23, D89, D139, D156].
+ * - Container: none; the bar is page frame and uses the viewport media.
+ *
+ * Timing: auto-dismissing toasts stay at least --fgd-duration-toast (6 s)
+ * and pause on hover, on focus and while the tab is hidden; warning,
+ * danger and action toasts persist until acted on or dismissed.
+ */
+export const toast = cva(styles.base);
+/** --fgd-duration-toast, restated in ms for Base UI's timers. */
+const TOAST_DURATION = 6000;
+function isStatus(type) {
+    return type === 'info' || type === 'success' || type === 'warning' || type === 'danger';
+}
+/** Base UI's promise toasts report `error`; the system calls it danger. */
+function toStatus(type) {
+    if (type === 'error')
+        return 'danger';
+    return isStatus(type) ? type : undefined;
+}
+/** At least --fgd-duration-toast; 0 persists; undefined keeps the provider's. */
+function clampTimeout(timeout) {
+    if (timeout === undefined)
+        return undefined;
+    return timeout <= 0 ? 0 : Math.max(timeout, TOAST_DURATION);
+}
+/** Applies the §10.17 rules: persistence, the minimum time and assertive danger. */
+function toBaseOptions(options, previous) {
+    const { status: statusOption, actions: actionsOption, timeout: timeoutOption, ...rest } = options;
+    const status = 'status' in options ? statusOption : toStatus(previous?.type);
+    const actions = 'actions' in options ? actionsOption : previous?.data?.actions;
+    const persists = status === 'warning' || status === 'danger' || (actions?.length ?? 0) > 0;
+    const timeout = persists
+        ? 0
+        : clampTimeout('timeout' in options ? timeoutOption : previous?.timeout);
+    return {
+        ...rest,
+        type: status,
+        timeout,
+        priority: status === 'danger' ? 'high' : 'low',
+        data: { ...previous?.data, actions },
+    };
+}
+/**
+ * Adds, updates and closes toasts from inside a ToastProvider, with the
+ * §10.17 rules applied: warning, danger and action toasts persist, the
+ * rest stay at least 6 s, and danger is announced assertively.
+ */
+export function useToastManager() {
+    const manager = BaseToast.useToastManager();
+    const { toasts, add, update, close } = manager;
+    return React.useMemo(() => ({
+        toasts,
+        add: ({ id, ...options }) => add({ id, ...toBaseOptions(options) }),
+        update: (id, options) => update(id, (previous) => toBaseOptions(options, previous)),
+        close,
+    }), [toasts, add, update, close]);
+}
+/**
+ * Provides toasts to its children and renders the docked bar: full width
+ * at the bottom viewport edge on --layer-5, a `white` scope with a
+ * --border-size-2 --primary12 top rule, content aligned to
+ * --fgd-container-content. One toast shows at a time; a queue count
+ * ("1 of 3") shows while more wait. The page reserves no space for it.
+ */
+export function ToastProvider(props) {
+    const { children, timeout, toastManager, primary, secondary, label, container } = props;
+    return (React.createElement(BaseToast.Provider, { timeout: clampTimeout(timeout) ?? TOAST_DURATION, limit: 1, toastManager: toastManager },
+        children,
+        React.createElement(ToastViewport, { primary: primary, secondary: secondary, label: label, container: container })));
+}
+function ToastViewport(props) {
+    const { primary, secondary, label, container } = props;
+    const { toasts } = BaseToast.useToastManager();
+    const scales = overlayScales(primary, secondary);
+    const hasToasts = toasts.length > 0;
+    // A hidden tab pauses the timers. Base UI pauses on window blur, which
+    // switching tabs fires, but a page loaded or updated in a background tab
+    // never received one; send it while hidden. This effect runs after the
+    // viewport's own, which attach the listeners once a toast exists.
+    React.useEffect(() => {
+        if (!hasToasts)
+            return undefined;
+        const pauseWhileHidden = () => {
+            if (document.visibilityState === 'hidden') {
+                window.dispatchEvent(new FocusEvent('blur'));
+            }
+        };
+        pauseWhileHidden();
+        document.addEventListener('visibilitychange', pauseWhileHidden);
+        return () => document.removeEventListener('visibilitychange', pauseWhileHidden);
+    }, [hasToasts]);
+    const queued = toasts.filter((item) => item.transitionStatus !== 'ending');
+    return (React.createElement(BaseToast.Portal, { container: container },
+        React.createElement(BaseToast.Viewport, { ...overlayAttributes, "aria-label": label ?? 'Notifications', className: cx(styles.viewport, primaryScaleVariants[scales.primary], secondaryScaleVariants[scales.secondary], overlayActionClassName) },
+            React.createElement(OverlayScope, null, toasts.map((item) => (React.createElement(ToastItem, { key: item.id, toast: item, position: queued.indexOf(item) + 1, total: queued.length })))))));
+}
+function ToastItem(props) {
+    const { toast: item, position, total } = props;
+    const status = toStatus(item.type);
+    const actions = item.data?.actions ?? [];
+    return (React.createElement(BaseToast.Root, { toast: item, className: toast() },
+        status ? (React.createElement(StatusGlyph, { ...overlayAttributes, status: status, label: statusLabels[status], className: cx(styles.glyph, secondaryScaleVariants[statusScales[status]]) })) : null,
+        React.createElement("div", { className: styles.message },
+            React.createElement(BaseToast.Title, { className: styles.title }),
+            React.createElement(BaseToast.Description, { className: styles.description })),
+        total > 1 && position > 0 ? (React.createElement("span", { className: styles.queue },
+            position,
+            " of ",
+            total)) : null,
+        actions.length > 0 ? (React.createElement("div", { className: styles.actions }, actions.map((action, index) => (React.createElement(ToastActionCell, { key: index, ...action }))))) : null,
+        React.createElement(BaseToast.Close, { className: styles.close, render: React.createElement(Button, { variant: "outline", iconOnly: true, icon: "close" }, "Close") })));
+}
+/** An action cell: holds its rest width while busy and ignores presses then [D84]. */
+function ToastActionCell(props) {
+    const { onClick, onPointerDown, onKeyUp, disabled, destructive, ...rest } = props;
+    const busy = rest['aria-busy'] === true || rest['aria-busy'] === 'true';
+    const element = React.useRef(null);
+    const restWidth = React.useRef(null);
+    React.useLayoutEffect(() => {
+        if (!busy && element.current) {
+            restWidth.current = element.current.getBoundingClientRect().width;
+        }
+    });
+    React.useLayoutEffect(() => {
+        const node = element.current;
+        if (!busy || !node || restWidth.current === null)
+            return undefined;
+        node.style.setProperty('--toast-action-rest-width', `${restWidth.current}px`);
+        return () => {
+            node.style.removeProperty('--toast-action-rest-width');
+        };
+    }, [busy]);
+    // The press swaps fill and ink as the inverse pair; the release mark lets
+    // the module step the release too, never fading the ink over the fill [D205].
+    const releaseMark = useReleaseMark(element);
+    return (React.createElement(BaseButton, { ...rest, ref: element, disabled: disabled, className: cx(styles.action, destructive ? styles.actionDestructive : undefined), onClick: busy ? undefined : onClick, onPointerDown: (event) => {
+            releaseMark.onPointerDown();
+            onPointerDown?.(event);
+        }, onKeyUp: (event) => {
+            releaseMark.onKeyUp(event);
+            onKeyUp?.(event);
+        } }));
+}
+//# sourceMappingURL=Toast.js.map

package/feedback/toast/Toast.js.map

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

package/feedback/toast/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/feedback/toast/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA"}

package/feedback/toast/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/feedback/toast/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA"}

package/feedback/toast/toast.module.css

@@ -0,0 +1,297 @@
+/*
+ * Toast (§10.17). CVA function `toast` in Toast.tsx.
+ * Parts: viewport (the docked bar's host: the `white` scope), base (a toast:
+ * the bar itself), glyph, message, title, description, queue, actions,
+ * action, close.
+ *
+ * A full-width bar docked to the bottom viewport edge on --layer-5, never a
+ * floating card [D25]: the `white` scope's --primary1 face and a
+ * --border-size-2 --primary12 rule on its content side only [D23, D89],
+ * content aligned to --fgd-container-content. Action cells are full-height
+ * `type-button` text cells divided by --border-size-1 --role-rule. One
+ * toast shows at a time. Motion is instant or a clip reveal from the bottom
+ * edge, never a fade [D91]. Colors are role variables only; local custom
+ * properties carry dimensions only.
+ */
+
+/* Composition sits in top-level rules, outside the layers: Lightning CSS
+ * (Next.js with Turbopack) rejects `composes` inside @layer or any nesting.
+ * The composed classes keep their own layers. */
+.base {
+  composes: typeBodyUi from '../../utils/type.module.css';
+}
+
+.title {
+  composes: typeBodyUi from '../../utils/type.module.css';
+}
+
+.description {
+  composes: typeBodyUi from '../../utils/type.module.css';
+}
+
+.queue {
+  composes: typeData from '../../utils/type.module.css';
+}
+
+.action {
+  composes: typeButton from '../../utils/type.module.css';
+}
+
+@layer base {
+  /* The host: docked, full width, no paint of its own (the toast is the bar). */
+  .viewport {
+    position: fixed;
+    inset-inline: 0;
+    inset-block-end: 0;
+    z-index: var(--layer-5);
+    margin: 0;
+    padding: 0;
+    color: var(--primary12);
+  }
+
+  /*
+   * The bar at base: glyph, message, queue count and close in one row; the
+   * action cells drop to a second row of equal cells under a rule.
+   */
+  .base {
+    --toast-clip-from: inset(100% 0 0 0);
+
+    position: relative;
+    display: grid;
+    grid-template-columns: auto minmax(0, 1fr) auto auto;
+    grid-template-areas:
+      'glyph message queue close'
+      'actions actions actions actions';
+    align-items: center;
+    column-gap: var(--size-px-2-5);
+    box-sizing: border-box;
+    min-block-size: var(--fgd-size-control-xl);
+    padding-inline: max(
+      var(--fgd-space-margin),
+      calc((100% - var(--fgd-container-content)) / 2)
+    );
+    border-block-start: var(--border-size-2) solid var(--primary12);
+    background-color: var(--primary1);
+    color: var(--primary12);
+    clip-path: inset(0);
+  }
+
+  .glyph {
+    grid-area: glyph;
+    display: block;
+    inline-size: var(--size-px-4);
+    block-size: var(--size-px-4);
+    overflow: visible;
+    color: var(--role-status);
+    fill: var(--role-status-fill);
+    stroke: var(--role-status-fill);
+    stroke-width: var(--border-size-1-5);
+    stroke-linecap: round;
+    stroke-linejoin: round;
+  }
+
+  .message {
+    grid-area: message;
+    min-inline-size: 0;
+    padding-block: var(--size-px-2-5);
+  }
+
+  .title,
+  .description {
+    color: var(--primary12);
+  }
+
+  .queue {
+    grid-area: queue;
+    color: var(--role-muted);
+    white-space: nowrap;
+  }
+
+  .actions {
+    grid-area: actions;
+    display: flex;
+    border-block-start: var(--border-size-1) solid var(--role-rule);
+  }
+
+  /* A full-height text cell; the rules between cells are its inline-start edges. */
+  .action {
+    flex: 1 1 0;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    min-block-size: var(--fgd-size-hit);
+    margin: 0;
+    padding-block: 0;
+    padding-inline: var(--size-px-5);
+    border: 0;
+    border-inline-start: var(--border-size-1) solid var(--role-rule);
+    background: none;
+    color: var(--primary12);
+    white-space: nowrap;
+    text-decoration-thickness: var(--border-size-1-5);
+    text-underline-offset: 0.15em;
+    appearance: none;
+  }
+
+  .action:first-child {
+    border-inline-start-width: 0;
+  }
+
+  .close {
+    grid-area: close;
+  }
+
+  /* One row from --md-n-above: the cells sit between the message and the close X, full height. */
+  @media (min-width: 768px) {
+    .base {
+      grid-template-columns: auto minmax(0, 1fr) auto auto auto;
+      grid-template-areas: 'glyph message queue actions close';
+    }
+
+    .actions {
+      align-self: stretch;
+      border-block-start-width: 0;
+    }
+
+    .action {
+      flex: none;
+    }
+
+    .action:first-child {
+      border-inline-start-width: var(--border-size-1);
+    }
+  }
+
+  @media (prefers-reduced-motion: no-preference) {
+    .base {
+      transition-property: clip-path;
+      transition-duration: var(--fgd-duration-disclosure);
+      transition-timing-function: var(--ease-out-3);
+    }
+
+    /* Hover transitions [D181]: --fgd-duration-quick, --ease-out-3, for the ink and underline. */
+    .action {
+      transition-property: color, text-decoration-color;
+      transition-duration: var(--fgd-duration-quick);
+      transition-timing-function: var(--ease-out-3);
+    }
+  }
+
+  @media (forced-colors: active) {
+    .glyph {
+      forced-color-adjust: none;
+      color: CanvasText;
+      fill: Canvas;
+      stroke: Canvas;
+    }
+  }
+}
+
+@layer variants {
+  /* The message's lead: `type-body-ui` at --font-weight-6. */
+  .title {
+    --type-weight: var(--font-weight-6);
+  }
+
+  /*
+   * A destructive action cell ("Discard Notes"): the label in
+   * --role-danger-text (--red11 on the white face: 5.11:1 light, 8.92:1
+   * dark) [D192].
+   */
+  .actionDestructive {
+    color: var(--role-danger-text);
+  }
+}
+
+@layer states {
+  /* Enter and exit: a clip reveal from the bottom edge [D91]. */
+  .base[data-starting-style],
+  .base[data-ending-style] {
+    clip-path: var(--toast-clip-from);
+  }
+
+  /* A closing toast lies over its successor, so the bar never grows while it wipes out. */
+  .base[data-ending-style] {
+    position: absolute;
+    inset-inline: 0;
+    inset-block-end: 0;
+  }
+
+  /* One visible at a time; the queue count reports the rest. */
+  .base[data-limited] {
+    display: none;
+  }
+
+  .base:focus-visible,
+  .viewport:focus-visible {
+    outline: var(--fgd-focus-width) solid var(--primary12);
+    outline-offset: calc(-2 * var(--fgd-focus-width));
+  }
+
+  /*
+   * Action cell hover (not disabled, not busy): the §9.2 `text` Button
+   * hover [D181]. The label takes --role-link-hover, underlined in
+   * --role-accent only where that ink is --primary12 (--fgd-link-hover-line);
+   * forced colors add the underline.
+   */
+  .action:not([data-disabled], [aria-busy='true']):hover {
+    color: var(--role-link-hover);
+    text-decoration-line: var(--fgd-link-hover-line);
+    text-decoration-color: var(--role-accent);
+  }
+
+  /* Destructive hover: the label keeps the danger ink and takes the underline in it [D192]. */
+  .actionDestructive:not([data-disabled], [aria-busy='true']):hover {
+    color: var(--role-danger-text);
+    text-decoration-line: underline;
+    text-decoration-color: currentColor;
+  }
+
+  @media (forced-colors: active) {
+    .action:not([data-disabled], [aria-busy='true']):hover {
+      text-decoration-line: underline;
+    }
+  }
+
+  /*
+   * Pressed: the inverse pair [D84]. Its fill rests at none, so fill and
+   * ink swap together at once, and so does the release (marked
+   * `data-released` for two frames, since a release and a hover-in both end
+   * on :hover): the ink never fades over a fill of its own tone. Only the
+   * underline keeps its fade; the hover's ink change still fades [D205].
+   */
+  .action:not([data-disabled], [aria-busy='true']):active,
+  .action[data-released] {
+    transition-property: text-decoration-color;
+  }
+
+  .action:not([data-disabled], [aria-busy='true']):active {
+    background-color: var(--primary12);
+    color: var(--role-inverse);
+  }
+
+  /* Focus: the ring inside the cell. */
+  .action:focus-visible {
+    outline: var(--fgd-focus-width) solid var(--primary12);
+    outline-offset: calc(-2 * var(--fgd-focus-width));
+  }
+
+  /* Busy: rest roles kept, width held, "Undoing…" [D84]. */
+  .action[aria-busy='true'] {
+    min-inline-size: var(--toast-action-rest-width, auto);
+    cursor: progress;
+  }
+
+  .action[data-disabled] {
+    color: var(--role-muted);
+  }
+}
+
+@layer print {
+  @media print {
+    /* Hidden: nothing only a toast says may be needed on paper. */
+    .viewport {
+      display: none;
+    }
+  }
+}

package/forms/autocomplete/Autocomplete.d.ts

@@ -0,0 +1,78 @@
+import * as React from 'react';
+import { Autocomplete as BaseAutocomplete } from '@base-ui/react/autocomplete';
+import { type VariantProps } from 'class-variance-authority';
+import { type IconName } from '../../foundations/icon';
+export declare const autocomplete: (props?: ({
+    plate?: boolean | null | undefined;
+    primary?: "ruby" | "brown" | "crimson" | "gold" | "gray" | "indigo" | "olive" | "pink" | "plum" | "purple" | "red" | "tomato" | "violet" | "bronze" | "iris" | "mauve" | "sage" | "sand" | "slate" | null | undefined;
+    secondary?: "ruby" | "blue" | "brown" | "crimson" | "cyan" | "gold" | "gray" | "green" | "indigo" | "lime" | "olive" | "orange" | "pink" | "plum" | "purple" | "red" | "teal" | "tomato" | "violet" | "yellow" | "amber" | "bronze" | "grass" | "iris" | "jade" | "mauve" | "mint" | "sage" | "sand" | "sky" | "slate" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+type AutocompleteVariants = VariantProps<typeof autocomplete>;
+/** One suggestion: the text it puts in the input, and optional display words. */
+export type AutocompleteOption = {
+    /** The text the suggestion fills in. */
+    value: string;
+    /** The words shown in the list. Default: `value`. */
+    label?: string;
+    disabled?: boolean;
+};
+/** A titled group of suggestions. */
+export type AutocompleteOptionGroup = {
+    /** The group label, in `type-label` caps. */
+    label: string;
+    items: readonly AutocompleteOption[];
+};
+type AutocompleteItems = readonly AutocompleteOption[] | readonly AutocompleteOptionGroup[];
+type RootProps = Omit<BaseAutocomplete.Root.Props<AutocompleteOption>, 'items' | 'children' | 'itemToStringValue'>;
+/** Props for Autocomplete: Base UI Autocomplete.Root props plus the suggestions, rows and color axes. */
+export type AutocompleteProps = RootProps & {
+    /** The suggestions, or titled groups. Pass `filter={null}` when the server filters them. */
+    items?: AutocompleteItems;
+    /** The input's placeholder, ending in "…"; never the label. */
+    placeholder?: string;
+    /** A leading icon in the box, such as `search` (inline tier). */
+    icon?: IconName;
+    /** Shows the chevron that opens the full list. Default `false`. */
+    showTrigger?: boolean;
+    /** The empty row. Default "No matches for '[query]'". Keep what the user typed. */
+    emptyText?: (query: string) => React.ReactNode;
+    /** Shows the loading row ("Searching…") while suggestions load. */
+    loading?: boolean;
+    /** The loading row's words. Default "Searching…". */
+    loadingText?: React.ReactNode;
+    /** A fetch failure, shown with the danger glyph instead of silently closing. */
+    error?: React.ReactNode;
+    /** The clear ×'s accessible name. Default "Clear". */
+    clearLabel?: string;
+    /** The chevron's accessible name. Default "Show suggestions". */
+    triggerLabel?: string;
+    /** Names the input when no visible label exists. Prefer a `FieldLabel`. */
+    'aria-label'?: string;
+    /** Class names for the box, added after the module's own. */
+    className?: string;
+    /** The box face becomes a nested `white` scope; patterned grounds only (§10.1). */
+    plate?: boolean;
+    /** Primary Radix scale: edge, value, icons and focus ring. Never defaulted [D133]. */
+    primary?: AutocompleteVariants['primary'];
+    /** Secondary Radix scale. Unused at rest; the danger scale while invalid. */
+    secondary?: AutocompleteVariants['secondary'];
+    /**
+     * The outline morph: the box's focus ring grows into the popup's frame as
+     * it opens and shrinks back onto the ring as it closes. Opens you ask for
+     * (the chevron with `showTrigger`, the arrow keys) and the first open
+     * after focus arrives morph; later opens and closes caused by typing are
+     * instant.
+     * Instant under reduced motion; off in forced colors and print, and
+     * wherever `--fgd-outline-morph: none` applies. Default `true`; `false`
+     * opens and closes the popup at once.
+     */
+    morph?: boolean;
+};
+/**
+ * A Base UI Autocomplete inside a `Field`. The input keeps any text: a
+ * suggestion only fills it, and Enter submits the typed text. No row is
+ * highlighted until the arrow keys move.
+ */
+export declare function Autocomplete(props: AutocompleteProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=Autocomplete.d.ts.map

package/forms/autocomplete/Autocomplete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Autocomplete.d.ts","sourceRoot":"","sources":["../../src/forms/autocomplete/Autocomplete.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAC9E,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAIjE,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AA6CtE,eAAO,MAAM,YAAY;;;;8EAYvB,CAAA;AAEF,KAAK,oBAAoB,GAAG,YAAY,CAAC,OAAO,YAAY,CAAC,CAAA;AAE7D,iFAAiF;AACjF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAA;IACb,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,qCAAqC;AACrC,MAAM,MAAM,uBAAuB,GAAG;IACpC,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAA;CACrC,CAAA;AAED,KAAK,iBAAiB,GAAG,SAAS,kBAAkB,EAAE,GAAG,SAAS,uBAAuB,EAAE,CAAA;AAM3F,KAAK,SAAS,GAAG,IAAI,CACnB,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAC/C,OAAO,GAAG,UAAU,GAAG,mBAAmB,CAC3C,CAAA;AAED,yGAAyG;AACzG,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG;IAC1C,4FAA4F;IAC5F,KAAK,CAAC,EAAE,iBAAiB,CAAA;IACzB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iEAAiE;IACjE,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,mEAAmE;IACnE,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,mFAAmF;IACnF,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAA;IAC9C,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,qDAAqD;IACrD,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC7B,gFAAgF;IAChF,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mFAAmF;IACnF,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,sFAAsF;IACtF,OAAO,CAAC,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAA;IACzC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,oBAAoB,CAAC,WAAW,CAAC,CAAA;IAC7C;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,qBA+KpD"}