@12-apps/ui 6.11.0 → 6.12.0

package/dist/chunk-BZTFPSWT.js

@@ -0,0 +1,282 @@
+import {
+  RangePresets
+} from "./chunk-F4RR4666.js";
+import {
+  presetsFor
+} from "./chunk-CBOB5AV6.js";
+import {
+  NumberBoundInput
+} from "./chunk-FV36LFPX.js";
+import {
+  isRangeInverted,
+  isRangeSet,
+  numericRange,
+  rangeChipLabel
+} from "./chunk-GCZJH4XL.js";
+import {
+  useDataViewsCopy
+} from "./chunk-KHG57NAE.js";
+import {
+  TableFilter
+} from "./chunk-J3JGO6Y6.js";
+import {
+  DayBoundInput
+} from "./chunk-UCU5FCYE.js";
+
+// src/components/data-display/DataViews/data-views-range-pill.tsx
+import CloseIcon from "@mui/icons-material/Close";
+import ChevronDownIcon from "@mui/icons-material/KeyboardArrowDown";
+import Box from "@mui/material/Box/index.js";
+import Button from "@mui/material/Button/index.js";
+import Popover from "@mui/material/Popover/index.js";
+import Typography from "@mui/material/Typography/index.js";
+import { useState } from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+function BoundField({
+  field,
+  label,
+  value,
+  onChange,
+  testId
+}) {
+  const copy = useDataViewsCopy();
+  if (field.kind === "day") {
+    return /* @__PURE__ */ jsx(
+      DayBoundInput,
+      {
+        mask: copy.filters.dayMask,
+        label,
+        value: value == null ? void 0 : String(value),
+        onChange,
+        testId
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx(
+    NumberBoundInput,
+    {
+      label,
+      value,
+      unit: field.unit,
+      onChange,
+      testId
+    }
+  );
+}
+function RangeBounds({
+  field,
+  value,
+  onChange,
+  testId
+}) {
+  const copy = useDataViewsCopy();
+  const inverted = isRangeInverted(value);
+  return /* @__PURE__ */ jsxs(Box, { "data-testid": `${testId}-panel`, children: [
+    /* @__PURE__ */ jsx(Box, { sx: { "&:not(:empty)": { mb: 1.5 } }, children: /* @__PURE__ */ jsx(RangePresets, { presets: presetsFor(field, copy), value, onChange, testId }) }),
+    /* @__PURE__ */ jsxs(Box, { sx: { display: "flex", alignItems: "center", gap: 1.5 }, children: [
+      /* @__PURE__ */ jsx(
+        BoundField,
+        {
+          field,
+          label: copy.filters.rangeStart,
+          value: value.min,
+          onChange: (min) => onChange({ ...value, min }),
+          testId: `${testId}-min`
+        }
+      ),
+      /* @__PURE__ */ jsx(
+        BoundField,
+        {
+          field,
+          label: copy.filters.rangeEnd,
+          value: value.max,
+          onChange: (max) => onChange({ ...value, max }),
+          testId: `${testId}-max`
+        }
+      )
+    ] }),
+    inverted && /* @__PURE__ */ jsx(
+      Typography,
+      {
+        component: "p",
+        "data-testid": `${testId}-inverted`,
+        sx: { mt: 0.75, fontSize: "0.75rem", color: "error.main" },
+        children: copy.filters.rangeInvalid
+      }
+    ),
+    field.kind === "day" && !inverted && /* @__PURE__ */ jsx(
+      Typography,
+      {
+        component: "p",
+        "data-testid": `${testId}-inclusive`,
+        sx: { mt: 0.75, fontSize: "0.75rem", color: "text.disabled" },
+        children: copy.filters.rangeInclusiveNote
+      }
+    )
+  ] });
+}
+function ClearAffordance({
+  label,
+  onClear,
+  testId
+}) {
+  const copy = useDataViewsCopy();
+  const clear = (event) => {
+    event.stopPropagation();
+    onClear();
+  };
+  return /* @__PURE__ */ jsx(
+    Box,
+    {
+      component: "span",
+      role: "button",
+      tabIndex: 0,
+      "aria-label": copy.filters.clearRange(label),
+      "data-testid": testId,
+      onClick: clear,
+      onKeyDown: (event) => {
+        if (event.key !== "Enter" && event.key !== " ") return;
+        event.preventDefault();
+        clear(event);
+      },
+      sx: { display: "inline-flex", borderRadius: 999, p: 0.125, "&:hover": { bgcolor: "action.selected" } },
+      children: /* @__PURE__ */ jsx(CloseIcon, { sx: { fontSize: 14 } })
+    }
+  );
+}
+function RangeTrigger({
+  field,
+  value,
+  onChange,
+  onOpen,
+  open,
+  testId
+}) {
+  const active = isRangeSet(value);
+  const inverted = isRangeInverted(value);
+  const tone = inverted ? "error.main" : active ? "primary.main" : "divider";
+  return /* @__PURE__ */ jsx(
+    Button,
+    {
+      variant: "outlined",
+      color: "inherit",
+      size: "small",
+      "data-testid": testId,
+      "aria-haspopup": "dialog",
+      "aria-expanded": open,
+      onClick: (event) => onOpen(event.currentTarget),
+      startIcon: active ? /* @__PURE__ */ jsx(ClearAffordance, { label: field.label, onClear: () => onChange({}), testId: `${testId}-clear-inline` }) : void 0,
+      endIcon: /* @__PURE__ */ jsx(ChevronDownIcon, { sx: { fontSize: 16 } }),
+      sx: {
+        borderRadius: 999,
+        height: 34,
+        px: 1.5,
+        maxWidth: 280,
+        color: inverted ? "error.main" : "text.primary",
+        fontWeight: 600,
+        fontSize: "0.8125rem",
+        textTransform: "none",
+        whiteSpace: "nowrap",
+        borderColor: tone,
+        bgcolor: active ? "action.selected" : "background.paper",
+        "&:hover": {
+          borderColor: active ? tone : "text.primary",
+          bgcolor: active ? "action.selected" : "action.hover"
+        }
+      },
+      children: /* @__PURE__ */ jsx(Box, { component: "span", sx: { overflow: "hidden", textOverflow: "ellipsis" }, children: active ? rangeChipLabel(field, value) : field.label })
+    }
+  );
+}
+function RangePill({
+  field,
+  value,
+  onChange,
+  onOpenChange,
+  testIdPrefix
+}) {
+  const copy = useDataViewsCopy();
+  const [anchor, setAnchor] = useState(null);
+  const active = isRangeSet(value);
+  const testId = `${testIdPrefix}-range-${field.id}`;
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(
+      RangeTrigger,
+      {
+        field,
+        value,
+        onChange,
+        onOpen: (element) => {
+          setAnchor(element);
+          onOpenChange?.(true);
+        },
+        open: Boolean(anchor),
+        testId
+      }
+    ),
+    /* @__PURE__ */ jsxs(
+      Popover,
+      {
+        open: Boolean(anchor),
+        anchorEl: anchor,
+        onClose: () => {
+          setAnchor(null);
+          onOpenChange?.(false);
+        },
+        anchorOrigin: { vertical: "bottom", horizontal: "left" },
+        slotProps: { paper: { sx: { p: 2, mt: 0.5 } } },
+        children: [
+          /* @__PURE__ */ jsx(RangeBounds, { field, value, onChange, testId }),
+          active && /* @__PURE__ */ jsxs(Box, { sx: { display: "flex", alignItems: "center", justifyContent: "space-between", gap: 2, mt: 1.5 }, children: [
+            /* @__PURE__ */ jsx(Typography, { component: "span", sx: { fontSize: "0.75rem", color: "text.secondary" }, children: rangeChipLabel(field, value) }),
+            /* @__PURE__ */ jsx(
+              Button,
+              {
+                variant: "text",
+                size: "small",
+                onClick: () => onChange({}),
+                "data-testid": `${testId}-clear`,
+                sx: { textTransform: "none" },
+                children: copy.filters.clear
+              }
+            )
+          ] })
+        ]
+      }
+    )
+  ] });
+}
+function PanelRangeField({
+  field,
+  value,
+  onChange,
+  testId
+}) {
+  const copy = useDataViewsCopy();
+  if (field.kind === "day") {
+    return /* @__PURE__ */ jsxs(Box, { sx: { display: "flex", flexDirection: "column", gap: 1 }, children: [
+      /* @__PURE__ */ jsx(Typography, { component: "span", sx: { fontSize: "0.75rem", fontWeight: 500, color: "text.secondary" }, children: field.label }),
+      /* @__PURE__ */ jsx(RangeBounds, { field, value, onChange, testId })
+    ] });
+  }
+  return /* @__PURE__ */ jsxs(Box, { sx: { display: "flex", flexDirection: "column", gap: 1 }, children: [
+    /* @__PURE__ */ jsx(
+      TableFilter.RangeField,
+      {
+        label: field.label,
+        unit: field.unit,
+        value: numericRange(value),
+        onChange: (range) => onChange(range),
+        testId
+      }
+    ),
+    /* @__PURE__ */ jsx(RangePresets, { presets: presetsFor(field, copy), value, onChange, testId })
+  ] });
+}
+
+export {
+  RangeBounds,
+  RangePill,
+  PanelRangeField
+};
+//# sourceMappingURL=chunk-BZTFPSWT.js.map

package/dist/chunk-BZTFPSWT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/data-display/DataViews/data-views-range-pill.tsx"],"sourcesContent":["'use client';\n\n/**\n * A range filter as a PILL in the inline filter bar — the same affordance the\n * multi-select facets use, so \"Data\" and \"Valor\" sit in the filter row beside\n * \"Pagamento\"/\"Situação\"/\"Método\" instead of floating above the grid.\n *\n * Before this the inline bar rendered pills only, and `rangeFields` had a\n * surface on the slide-in panel alone — which `inlineFilters` REPLACES on a wide\n * screen. So a range filter was invisible on exactly the screens that use it,\n * and a page wanting one had to hang its own inputs outside the grid, outside\n * `DataViewState`, and outside the grid's \"Limpar filtros\" (FUT-668).\n */\nimport CloseIcon from '@mui/icons-material/Close';\nimport ChevronDownIcon from '@mui/icons-material/KeyboardArrowDown';\nimport Box from '@mui/material/Box/index.js';\nimport Button from '@mui/material/Button/index.js';\nimport Popover from '@mui/material/Popover/index.js';\nimport Typography from '@mui/material/Typography/index.js';\nimport React, { useState } from 'react';\n\nimport { useDataViewsCopy } from \"./data-views-copy-context\";\nimport { TableFilter } from '../../layout/TableFilter';\nimport { DayBoundInput } from './data-views-day-input';\nimport { NumberBoundInput } from './data-views-number-input';\nimport { RangePresets } from './data-views-preset-chips';\nimport { presetsFor } from './data-views-range-presets';\nimport {\n  isRangeInverted,\n  isRangeSet,\n  numericRange,\n  rangeChipLabel,\n} from './data-views-range-values';\nimport type { RangeFieldConfig, RangeValue } from './data-views-types';\n\n\n\n/**\n * One end of the range. A day keeps its `AAAA-MM-DD` string verbatim (the form\n * both the field and the backend speak) and is typed through the masked\n * `dd/mm/aaaa` field rather than a native date input — see\n * {@link DayBoundInput} for why. A number parses, and an unparseable/blank\n * entry CLEARS the bound rather than writing `NaN`.\n */\nfunction BoundField<T extends Record<string, unknown>>({\n  field,\n  label,\n  value,\n  onChange,\n  testId,\n}: {\n  field: RangeFieldConfig<T>;\n  label: string;\n  value: number | string | undefined;\n  onChange: (bound: number | string | undefined) => void;\n  testId: string;\n}): React.JSX.Element {\n  const copy = useDataViewsCopy();\n  if (field.kind === 'day') {\n    return (\n      <DayBoundInput\n        mask={copy.filters.dayMask}\n        label={label}\n        value={value == null ? undefined : String(value)}\n        onChange={onChange}\n        testId={testId}\n      />\n    );\n  }\n  return (\n    <NumberBoundInput\n      label={label}\n      value={value}\n      unit={field.unit}\n      onChange={onChange}\n      testId={testId}\n    />\n  );\n}\n\n\n/**\n * The `De`/`Até` pair for a range — shared by the pill's popover and the\n * slide-in panel's day fields, so the two surfaces cannot drift on what a bound\n * accepts or how it clears.\n */\nexport function RangeBounds<T extends Record<string, unknown>>({\n  field,\n  value,\n  onChange,\n  testId,\n}: {\n  field: RangeFieldConfig<T>;\n  value: RangeValue;\n  onChange: (range: RangeValue) => void;\n  testId: string;\n}): React.JSX.Element {\n  const copy = useDataViewsCopy();\n  const inverted = isRangeInverted(value);\n  return (\n    <Box data-testid={`${testId}-panel`}>\n      {/* Above the inputs, not below: the presets are the answer for most\n          merchants, and the two date pickers are the escape hatch. */}\n      <Box sx={{ '&:not(:empty)': { mb: 1.5 } }}>\n        <RangePresets presets={presetsFor(field, copy)} value={value} onChange={onChange} testId={testId} />\n      </Box>\n      <Box sx={{ display: 'flex', alignItems: 'center', gap: 1.5 }}>\n        <BoundField\n          field={field}\n          label={copy.filters.rangeStart}\n          value={value.min}\n          onChange={(min) => onChange({ ...value, min })}\n          testId={`${testId}-min`}\n        />\n        <BoundField\n          field={field}\n          label={copy.filters.rangeEnd}\n          value={value.max}\n          onChange={(max) => onChange({ ...value, max })}\n          testId={`${testId}-max`}\n        />\n      </Box>\n      {inverted && (\n        <Typography\n          component=\"p\"\n          data-testid={`${testId}-inverted`}\n          sx={{ mt: 0.75, fontSize: '0.75rem', color: 'error.main' }}\n        >\n          {copy.filters.rangeInvalid}\n        </Typography>\n      )}\n      {/* BOTH days are in the result. Saying so is FUT-668's other half: the\n          bounds compare as ISO strings precisely so `até` keeps its whole day,\n          and nothing on screen would otherwise tell the merchant that. */}\n      {field.kind === 'day' && !inverted && (\n        <Typography\n          component=\"p\"\n          data-testid={`${testId}-inclusive`}\n          sx={{ mt: 0.75, fontSize: '0.75rem', color: 'text.disabled' }}\n        >\n          {copy.filters.rangeInclusiveNote}\n        </Typography>\n      )}\n    </Box>\n  );\n}\n\n/**\n * The pill + its popover. Bounds commit on change (the list is server-driven, so\n * each edit is a query) and the popover stays open, which is what lets a\n * merchant set \"de\" and then \"até\" without re-opening it.\n */\n/** An applied range clears from the pill itself — re-opening to empty two fields is three gestures for one intent. */\nfunction ClearAffordance({\n  label,\n  onClear,\n  testId,\n}: {\n  label: string;\n  onClear: () => void;\n  testId: string;\n}): React.JSX.Element {\n  const copy = useDataViewsCopy();\n  const clear = (event: React.SyntheticEvent): void => {\n    event.stopPropagation();\n    onClear();\n  };\n  return (\n    <Box\n      component=\"span\"\n      role=\"button\"\n      tabIndex={0}\n      aria-label={copy.filters.clearRange(label)}\n      data-testid={testId}\n      onClick={clear}\n      onKeyDown={(event: React.KeyboardEvent) => {\n        if (event.key !== 'Enter' && event.key !== ' ') return;\n        event.preventDefault();\n        clear(event);\n      }}\n      sx={{ display: 'inline-flex', borderRadius: 999, p: 0.125, '&:hover': { bgcolor: 'action.selected' } }}\n    >\n      <CloseIcon sx={{ fontSize: 14 }} />\n    </Box>\n  );\n}\n\n/** The pill button: its label carries the applied window, and its tone the state. */\nfunction RangeTrigger<T extends Record<string, unknown>>({\n  field,\n  value,\n  onChange,\n  onOpen,\n  open,\n  testId,\n}: {\n  field: RangeFieldConfig<T>;\n  value: RangeValue;\n  onChange: (range: RangeValue) => void;\n  onOpen: (anchor: HTMLElement) => void;\n  open: boolean;\n  testId: string;\n}): React.JSX.Element {\n  const active = isRangeSet(value);\n  const inverted = isRangeInverted(value);\n  // An INVERTED window gets its own tone rather than the ordinary \"applied\"\n  // one: it is applied, and it matches nothing, and those are different states.\n  const tone = inverted ? 'error.main' : active ? 'primary.main' : 'divider';\n  return (\n    <Button\n      variant=\"outlined\"\n      color=\"inherit\"\n      size=\"small\"\n      data-testid={testId}\n      aria-haspopup=\"dialog\"\n      aria-expanded={open}\n      onClick={(event) => onOpen(event.currentTarget)}\n      // ✕ FIRST, chevron LAST — the same shape as every other pill. It used to\n      // replace the chevron at the end, so a range pill and a multi-select pill\n      // put the clear in different places, and an applied range lost the\n      // affordance that says it opens.\n      startIcon={\n        active ? (\n          <ClearAffordance label={field.label} onClear={() => onChange({})} testId={`${testId}-clear-inline`} />\n        ) : undefined\n      }\n      endIcon={<ChevronDownIcon sx={{ fontSize: 16 }} />}\n      sx={{\n        borderRadius: 999,\n        height: 34,\n        px: 1.5,\n        maxWidth: 280,\n        color: inverted ? 'error.main' : 'text.primary',\n        fontWeight: 600,\n        fontSize: '0.8125rem',\n        textTransform: 'none',\n        whiteSpace: 'nowrap',\n        borderColor: tone,\n        bgcolor: active ? 'action.selected' : 'background.paper',\n        '&:hover': {\n          borderColor: active ? tone : 'text.primary',\n          bgcolor: active ? 'action.selected' : 'action.hover',\n        },\n      }}\n    >\n      {/* The applied bounds, in the label — a pill reading only \"Valor\" hides\n          the very thing that is narrowing the list. */}\n      <Box component=\"span\" sx={{ overflow: 'hidden', textOverflow: 'ellipsis' }}>\n        {active ? rangeChipLabel(field, value) : field.label}\n      </Box>\n    </Button>\n  );\n}\n\nexport function RangePill<T extends Record<string, unknown>>({\n  field,\n  value,\n  onChange,\n  onOpenChange,\n  testIdPrefix,\n}: {\n  field: RangeFieldConfig<T>;\n  value: RangeValue;\n  onChange: (range: RangeValue) => void;\n  /** So a measured toolbar can hold still while this is open. */\n  onOpenChange?: (open: boolean) => void;\n  testIdPrefix: string;\n}): React.JSX.Element {\n  const copy = useDataViewsCopy();\n  const [anchor, setAnchor] = useState<HTMLElement | null>(null);\n  const active = isRangeSet(value);\n  const testId = `${testIdPrefix}-range-${field.id}`;\n  return (\n    <>\n      <RangeTrigger\n        field={field}\n        value={value}\n        onChange={onChange}\n        onOpen={(element) => {\n          setAnchor(element);\n          onOpenChange?.(true);\n        }}\n        open={Boolean(anchor)}\n        testId={testId}\n      />\n      <Popover\n        open={Boolean(anchor)}\n        anchorEl={anchor}\n        onClose={() => {\n          setAnchor(null);\n          onOpenChange?.(false);\n        }}\n        anchorOrigin={{ vertical: 'bottom', horizontal: 'left' }}\n        slotProps={{ paper: { sx: { p: 2, mt: 0.5 } } }}\n      >\n        <RangeBounds field={field} value={value} onChange={onChange} testId={testId} />\n        {/* An inverted window is not an error the merchant must fix before the\n            list responds — it simply matches nothing, and saying so beats an\n            empty grid with no explanation (FUT-668). */}\n        {active && (\n          <Box sx={{ display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: 2, mt: 1.5 }}>\n            <Typography component=\"span\" sx={{ fontSize: '0.75rem', color: 'text.secondary' }}>\n              {rangeChipLabel(field, value)}\n            </Typography>\n            <Button\n              variant=\"text\"\n              size=\"small\"\n              onClick={() => onChange({})}\n              data-testid={`${testId}-clear`}\n              sx={{ textTransform: 'none' }}\n            >\n              {copy.filters.clear}\n            </Button>\n          </Box>\n        )}\n      </Popover>\n    </>\n  );\n}\n\n\n/**\n * One range on the SLIDE-IN panel (and the narrow-screen modal): the numeric\n * control the panel already had, or — for a day range, which that control cannot\n * express — the same `De`/`Até` pair the pill's popover uses.\n */\nexport function PanelRangeField<T extends Record<string, unknown>>({\n  field,\n  value,\n  onChange,\n  testId,\n}: {\n  field: RangeFieldConfig<T>;\n  value: RangeValue;\n  onChange: (range: RangeValue) => void;\n  testId: string;\n}): React.JSX.Element {\n  const copy = useDataViewsCopy();\n  if (field.kind === \"day\") {\n    return (\n      <Box sx={{ display: \"flex\", flexDirection: \"column\", gap: 1 }}>\n        <Typography component=\"span\" sx={{ fontSize: \"0.75rem\", fontWeight: 500, color: \"text.secondary\" }}>\n          {field.label}\n        </Typography>\n        <RangeBounds field={field} value={value} onChange={onChange} testId={testId} />\n      </Box>\n    );\n  }\n  return (\n    <Box sx={{ display: \"flex\", flexDirection: \"column\", gap: 1 }}>\n      <TableFilter.RangeField\n        label={field.label}\n        unit={field.unit}\n        value={numericRange(value)}\n        onChange={(range) => onChange(range)}\n        testId={testId}\n      />\n      {/* Below the numeric control here, unlike the pill's popover: this one\n          renders its own label, and chips above it would separate the label\n          from the field it names. */}\n      <RangePresets presets={presetsFor(field, copy)} value={value} onChange={onChange} testId={testId} />\n    </Box>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-C3UKR3NT.js

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-C3UKR3NT.js.map

package/dist/chunk-C3UKR3NT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-C53C7C2X.js

@@ -0,0 +1,74 @@
+import {
+  getOverflowStyle,
+  getVariantStyles
+} from "./chunk-ZADOIITM.js";
+
+// src/components/layout/ScrollArea/ScrollViewport.tsx
+import Box from "@mui/material/Box/index.js";
+import { useTheme } from "@mui/material/styles/index.js";
+import { jsx } from "react/jsx-runtime";
+var ScrollViewport = ({
+  regionLabel,
+  children,
+  height,
+  maxHeight,
+  orientation,
+  scrollbarSize,
+  scrollbarColor,
+  scrollbarTrackColor,
+  contentPadding,
+  variant,
+  disabled,
+  loading,
+  smoothScroll,
+  shouldShowScrollbar,
+  setScrollRef,
+  onScroll
+}) => {
+  const theme = useTheme();
+  return /* @__PURE__ */ jsx(
+    Box,
+    {
+      ref: setScrollRef,
+      onScroll,
+      role: "region",
+      "aria-label": regionLabel,
+      "aria-busy": loading,
+      tabIndex: disabled ? -1 : 0,
+      sx: {
+        width: "100%",
+        height: "100%",
+        // Use an explicit maxHeight when height is 'auto', else inherit.
+        maxHeight: height === "auto" && maxHeight ? maxHeight : "100%",
+        padding: contentPadding,
+        opacity: loading ? 0.5 : 1,
+        pointerEvents: disabled || loading ? "none" : "auto",
+        transition: "opacity 0.3s ease",
+        "&:focus": {
+          outline: "none",
+          "&:focus-visible": {
+            outline: `2px solid ${theme.palette.primary.main}`,
+            outlineOffset: -2
+          }
+        },
+        ...getOverflowStyle({ disabled, orientation }),
+        ...getVariantStyles({
+          theme,
+          variant,
+          orientation,
+          scrollbarSize,
+          scrollbarColor,
+          scrollbarTrackColor,
+          shouldShowScrollbar
+        })
+      },
+      style: { scrollBehavior: smoothScroll ? "smooth" : "auto" },
+      children
+    }
+  );
+};
+
+export {
+  ScrollViewport
+};
+//# sourceMappingURL=chunk-C53C7C2X.js.map

package/dist/chunk-C53C7C2X.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/layout/ScrollArea/ScrollViewport.tsx"],"sourcesContent":["import Box from '@mui/material/Box/index.js';\nimport { useTheme } from '@mui/material/styles/index.js';\nimport type { FC, ReactNode, UIEvent } from 'react';\nimport React from 'react';\n\nimport { getOverflowStyle, getVariantStyles } from './ScrollArea.styles';\nimport type { ResolvedScrollAreaProps } from './ScrollArea.helpers';\n\nexport interface ScrollViewportProps\n  extends Pick<\n    ResolvedScrollAreaProps,\n    | 'height'\n    | 'maxHeight'\n    | 'orientation'\n    | 'scrollbarSize'\n    | 'scrollbarColor'\n    | 'scrollbarTrackColor'\n    | 'contentPadding'\n    | 'variant'\n    | 'disabled'\n    | 'loading'\n    | 'smoothScroll'\n  > {\n  /** The scroll region's accessible name. REQUIRED. */\n  regionLabel: string;\n  children: ReactNode;\n  shouldShowScrollbar: boolean;\n  setScrollRef: (node: HTMLDivElement | null) => void;\n  onScroll: (event: UIEvent<HTMLDivElement>) => void;\n}\n\n// The element that actually scrolls: its own overflow and scrollbar styling,\n// plus the disabled and loading treatments.\nexport const ScrollViewport: FC<ScrollViewportProps> = ({\n  regionLabel,\n  children,\n  height,\n  maxHeight,\n  orientation,\n  scrollbarSize,\n  scrollbarColor,\n  scrollbarTrackColor,\n  contentPadding,\n  variant,\n  disabled,\n  loading,\n  smoothScroll,\n  shouldShowScrollbar,\n  setScrollRef,\n  onScroll,\n}) => {\n  const theme = useTheme();\n\n  return (\n    <Box\n      ref={setScrollRef}\n      onScroll={onScroll}\n      role=\"region\"\n      aria-label={regionLabel}\n      aria-busy={loading}\n      tabIndex={disabled ? -1 : 0}\n      sx={{\n        width: '100%',\n        height: '100%',\n        // Use an explicit maxHeight when height is 'auto', else inherit.\n        maxHeight: height === 'auto' && maxHeight ? maxHeight : '100%',\n        padding: contentPadding,\n        opacity: loading ? 0.5 : 1,\n        pointerEvents: disabled || loading ? 'none' : 'auto',\n        transition: 'opacity 0.3s ease',\n        '&:focus': {\n          outline: 'none',\n          '&:focus-visible': {\n            outline: `2px solid ${theme.palette.primary.main}`,\n            outlineOffset: -2,\n          },\n        },\n        ...getOverflowStyle({ disabled, orientation }),\n        ...getVariantStyles({\n          theme,\n          variant,\n          orientation,\n          scrollbarSize,\n          scrollbarColor,\n          scrollbarTrackColor,\n          shouldShowScrollbar,\n        }),\n      }}\n      style={{ scrollBehavior: smoothScroll ? 'smooth' : 'auto' }}\n    >\n      {children}\n    </Box>\n  );\n};\n"],"mappings":";;;;;;AAAA,OAAO,SAAS;AAChB,SAAS,gBAAgB;AAqDrB;AArBG,IAAM,iBAA0C,CAAC;AAAA,EACtD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAAM;AACJ,QAAM,QAAQ,SAAS;AAEvB,SACE;AAAA,IAAC;AAAA;AAAA,MACC,KAAK;AAAA,MACL;AAAA,MACA,MAAK;AAAA,MACL,cAAY;AAAA,MACZ,aAAW;AAAA,MACX,UAAU,WAAW,KAAK;AAAA,MAC1B,IAAI;AAAA,QACF,OAAO;AAAA,QACP,QAAQ;AAAA;AAAA,QAER,WAAW,WAAW,UAAU,YAAY,YAAY;AAAA,QACxD,SAAS;AAAA,QACT,SAAS,UAAU,MAAM;AAAA,QACzB,eAAe,YAAY,UAAU,SAAS;AAAA,QAC9C,YAAY;AAAA,QACZ,WAAW;AAAA,UACT,SAAS;AAAA,UACT,mBAAmB;AAAA,YACjB,SAAS,aAAa,MAAM,QAAQ,QAAQ,IAAI;AAAA,YAChD,eAAe;AAAA,UACjB;AAAA,QACF;AAAA,QACA,GAAG,iBAAiB,EAAE,UAAU,YAAY,CAAC;AAAA,QAC7C,GAAG,iBAAiB;AAAA,UAClB;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF,CAAC;AAAA,MACH;AAAA,MACA,OAAO,EAAE,gBAAgB,eAAe,WAAW,OAAO;AAAA,MAEzD;AAAA;AAAA,EACH;AAEJ;","names":[]}

package/dist/chunk-C6ATAHBX.js

@@ -0,0 +1,56 @@
+// src/components/data-display/DataViews/data-views-types.ts
+var CARD_ASPECT_RATIOS = {
+  "1:1": 1,
+  "4:3": 4 / 3,
+  "16:9": 16 / 9,
+  "9:16": 9 / 16,
+  "3:4": 3 / 4,
+  /**
+   * The BANNER tile: too short for media, sized for two lines of text.
+   *
+   * Every other ratio here is picture-shaped, because they were added for cards
+   * built around a thumbnail. A card whose subject is a NAME and a NUMBER — a
+   * cart, an order, anything triaged rather than browsed — spends most of a 4:3
+   * tile on an icon that repeats down the whole grid and says nothing.
+   */
+  "3:1": 3
+};
+function emptyViewState(visibleColumns) {
+  return { search: "", pills: {}, ranges: {}, sortBy: [], visibleColumns };
+}
+function coerceViewState(raw, allColumnIds) {
+  const value = raw ?? {};
+  return {
+    search: typeof value.search === "string" ? value.search : "",
+    pills: asRecord(value.pills),
+    ranges: asRecord(value.ranges),
+    sortBy: Array.isArray(value.sortBy) ? value.sortBy : [],
+    visibleColumns: Array.isArray(value.visibleColumns) ? value.visibleColumns : allColumnIds,
+    order: Array.isArray(value.order) ? value.order : void 0,
+    // Carried through UNVALIDATED against the declared scopes on purpose: a view
+    // written before scopes existed has none (⇒ undefined ⇒ the first declared
+    // scope at render), and one naming a since-removed scope keeps its stored id
+    // here and falls back at READ time. Resolving here would rewrite the view.
+    scope: typeof value.scope === "string" ? value.scope : void 0,
+    layout: isLayout(value.layout) ? value.layout : void 0
+  };
+}
+var DATA_VIEWS_LAYOUTS = ["cards", "list", "board", "table"];
+function isLayout(value) {
+  return DATA_VIEWS_LAYOUTS.includes(value);
+}
+function asRecord(value) {
+  return value !== null && typeof value === "object" ? value : {};
+}
+function toSavedViewSummary(record) {
+  return { ...record, state: record.state ?? {} };
+}
+
+export {
+  CARD_ASPECT_RATIOS,
+  emptyViewState,
+  coerceViewState,
+  DATA_VIEWS_LAYOUTS,
+  toSavedViewSummary
+};
+//# sourceMappingURL=chunk-C6ATAHBX.js.map

package/dist/chunk-C6ATAHBX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/data-display/DataViews/data-views-types.ts"],"sourcesContent":["import type { GridColumn, GridSort } from \"../DataGrid\";\nimport type { DropdownMenuItem } from \"../../navigation/DropdownMenu\";\n// A re-export does not bring the name into local scope, and the state/query\n// types below are written in terms of it.\nimport type { RangeValue } from \"./data-views-range-types\";\n\n/**\n * Shared types for the reusable admin \"DataViews\" table (FUT-88): a filter bar\n * (search-across-all + typed multi-select pills + column visibility) whose full\n * state — filters + sort + visible columns — a saved view (FUT-89) can capture\n * and restore. Each table declares its own columns + filter fields.\n */\n\n/**\n * A single, reusable row action. ONE definition drives BOTH the per-row \"⋮\"\n * kebab menu and the bulk-actions menu (tabwoah model): `onSelect` receives the\n * affected rows — `[row]` from a kebab, the whole selection from the bulk menu.\n * Single-item-only actions (e.g. \"Editar\") set `bulk: false` so they never\n * appear in the bulk menu.\n */\nexport interface RowAction<T extends Record<string, unknown>> {\n  /** Stable id (also the `data-testid` suffix). */\n  id: string;\n  /** Menu label. In the kebab, `rowLabel` overrides it per row when provided. */\n  label: string;\n  /** Menu-item colour (e.g. `\"error\"` for destructive). */\n  color?: DropdownMenuItem[\"color\"];\n  /**\n   * Runs on the affected rows: `[row]` from the kebab, all selected from bulk.\n   * May be async — the bulk menu awaits it and only clears the selection once it\n   * settles (keeping the selection on failure so the user can retry).\n   */\n  onSelect: (rows: T[]) => void | Promise<void>;\n  /** Include in the bulk menu (2+ selected). Defaults to `true`. */\n  bulk?: boolean;\n  /** Include in the per-row kebab. Defaults to `true`. */\n  row?: boolean;\n  /** Per-row kebab label (e.g. `row.active ? \"Inativar\" : \"Ativar\"`). */\n  rowLabel?: (row: T) => string;\n  /**\n   * Per-row applicability (e.g. state-machine guards). `false` hides the\n   * kebab item for that row; in bulk the action runs only on the passing\n   * rows and is dropped when none pass. Defaults to applicable.\n   */\n  isVisible?: (row: T) => boolean;\n}\n\n/** Selection state handed to a card renderer so it can drive its own checkbox. */\nexport interface DataViewCardSelection {\n  selected: boolean;\n  onToggleSelect: () => void;\n  /**\n   * Card SIZE multiplier from the toolbar zoom slider. The grid sizes the card's\n   * width to `base × scale`; a card passes this to {@link BaseCard} `scale` so its\n   * padding + typography grow by the same factor — the whole card scales together\n   * (scale 2 → ~2× size). The proportion (aspect ratio) stays constant.\n   */\n  scale: number;\n}\n\n/**\n * The fixed proportions a {@link BaseCard} tile can take. The tile keeps this\n * ratio and grows in BOTH width and height as the zoom slider widens its grid\n * track, so a grid of cards stays visually uniform.\n */\nexport type CardAspectRatio = \"1:1\" | \"4:3\" | \"16:9\" | \"9:16\" | \"3:4\" | \"3:1\";\n\n/** Numeric width/height factor for each {@link CardAspectRatio} (CSS `aspect-ratio`). */\nexport const CARD_ASPECT_RATIOS: Record<CardAspectRatio, number> = {\n  \"1:1\": 1,\n  \"4:3\": 4 / 3,\n  \"16:9\": 16 / 9,\n  \"9:16\": 9 / 16,\n  \"3:4\": 3 / 4,\n  /**\n   * The BANNER tile: too short for media, sized for two lines of text.\n   *\n   * Every other ratio here is picture-shaped, because they were added for cards\n   * built around a thumbnail. A card whose subject is a NAME and a NUMBER — a\n   * cart, an order, anything triaged rather than browsed — spends most of a 4:3\n   * tile on an icon that repeats down the whole grid and says nothing.\n   */\n  \"3:1\": 3,\n};\n\n/** One selectable value inside a filter pill. */\nexport interface FilterOption {\n  value: string;\n  label: string;\n  /**\n   * Parent option's `value`, for a hierarchical field (`control: \"category\"`).\n   * Ignored by the flat controls, so one option list serves both.\n   */\n  parentId?: string | null;\n}\n\n/** A typed, multi-select filter pill's configuration for a table. */\nexport interface FilterFieldConfig<T extends Record<string, unknown>> {\n  /** Stable id; also the default row key when no `accessor` is given. */\n  id: string;\n  label: string;\n  options: FilterOption[];\n  /**\n   * How the field renders in the filter panel. `checkboxes` (default) is best for\n   * a few fixed options; `multiselect` is a compact dropdown for long option\n   * lists; `category` is the hierarchical picker, for an option set that nests\n   * via {@link FilterOption.parentId} — it renders parents as headings and\n   * their children as the selectable rows, rather than flattening the tree into\n   * one indistinguishable list.\n   */\n  control?: \"checkboxes\" | \"multiselect\" | \"category\";\n  /**\n   * Forces this filter to render as a searchable multi-select dropdown with the\n   * search box always shown, regardless of how many options are currently\n   * loaded. Use it when the option set can grow unbounded (e.g. a filter backed\n   * by a relation such as Roles or Categories). Omit it for a closed value set\n   * (an enum), which keeps the plain checkbox / \"search only when long\"\n   * behavior.\n   */\n  searchEnabled?: boolean;\n  /**\n   * Reads the row's value(s) for this field. A row matches the pill when any of\n   * its values is selected. Defaults to `String(row[id])`.\n   */\n  accessor?: (row: T) => string | string[];\n}\n\n/**\n * The range types live in `data-views-range-types` (this file outgrew the\n * size gate); they are re-exported here so `data-views-types` stays the one\n * name every consumer imports the model from.\n */\nexport type {\n  DayRangeFieldConfig,\n  NumberRangeFieldConfig,\n  RangeFieldConfig,\n  RangeFieldKind,\n  RangePreset,\n  RangeValue,\n} from \"./data-views-range-types\";\n\n/** A grid column that can join the search scan and the column-visibility menu. */\nexport interface DataViewColumn<T extends Record<string, unknown>> extends GridColumn<T> {\n  /** Included in \"search across all columns\" (needs a resolvable value). */\n  searchable?: boolean;\n  /** Toggleable in the column-visibility menu. Defaults to true; set false for\n   *  structural columns (image thumbnail, actions kebab) that must always show. */\n  hideable?: boolean;\n}\n\n/**\n * The DataViews layout (view type): the dense \"Tabela\" grid, the \"Grade\" of\n * cards, the \"Lista\" of full-width rows, or the \"Quadro\" board of state columns.\n * Lives with the state types rather than with the toggle because a saved view\n * CAPTURES it — see {@link DataViewState.layout}.\n */\nexport type DataViewsLayout = \"cards\" | \"list\" | \"board\" | \"table\";\n\n/** The full, serializable state a view captures. */\nexport interface DataViewState {\n  /** Free text matched across every `searchable` column. */\n  search: string;\n  /** fieldId → selected option values (empty/absent = no constraint). */\n  pills: Record<string, string[]>;\n  /** fieldId → selected numeric range (min/max). Absent/empty = no constraint. */\n  ranges?: Record<string, RangeValue>;\n  sortBy: GridSort[];\n  /** Column ids kept visible; a hideable column not listed here is hidden. */\n  visibleColumns: string[];\n  /**\n   * Column ids in READING ORDER. Absent ⇒ the order the table declared them in.\n   *\n   * Order is view state for the same reason visibility is: reordering columns is\n   * an operator deciding what to read FIRST, and a saved view that restored the\n   * columns but not their order would restore half a decision. Ids the table no\n   * longer declares are ignored at render, and ids missing from a stale list\n   * fall in after it — so a column added since the view was saved appears rather\n   * than disappearing.\n   */\n  order?: string[];\n  /**\n   * The active SCOPE id — the page-level partition the scope tabs select (see\n   * `ScopeConfig`). Optional, so a table that declares no scopes is untouched\n   * and no view persisted before scopes existed breaks.\n   *\n   * Stored raw and RESOLVED at read time: the declared scopes change underneath\n   * a saved view, and a view naming a scope that has since been removed must\n   * fall back at render rather than break.\n   */\n  scope?: string;\n  /**\n   * The layout the view was saved in. Optional — absent means \"whatever the user\n   * is currently using\", which is the pre-existing behaviour.\n   *\n   * A LAYOUT FALLBACK IS NOT A LAYOUT CHANGE: a table rendered as stacked rows\n   * on a phone still has `\"table\"` stored here, so the view round-trips the\n   * stored layout regardless of the device that opened it.\n   */\n  layout?: DataViewsLayout;\n}\n\n/** A pristine view state showing every given column and no filters/sort. */\nexport function emptyViewState(visibleColumns: string[]): DataViewState {\n  return { search: \"\", pills: {}, ranges: {}, sortBy: [], visibleColumns };\n}\n\n/**\n * The URL-driven slice of {@link DataViewState} — the controls a server-mode host\n * mirrors from the address bar (search / pills / ranges / sort), WITHOUT\n * `visibleColumns`. Supplying it re-applies those controls when its reference\n * changes (e.g. browser back/forward or a deep-link on the same route), merging\n * over the current state so a user's show/hide column choices are preserved —\n * unlike `appliedState`, which fully replaces the state to apply a saved view.\n */\nexport type DataViewSyncState = Pick<\n  DataViewState,\n  \"search\" | \"pills\" | \"ranges\" | \"sortBy\" | \"scope\"\n>;\n\n/**\n * The query a SERVER-mode table emits whenever its filter/sort/page changes\n * (FUT-180). The host translates this into a backend request (see\n * `@12-apps/shared-helpers/search`) — in server mode the grid never filters,\n * sorts, or paginates in the browser; it renders exactly the page the server\n * returned. `page` is 1-based to match the backend contract.\n */\nexport interface DataViewQuery {\n  search: string;\n  pills: Record<string, string[]>;\n  ranges: Record<string, RangeValue>;\n  sortBy: GridSort[];\n  /**\n   * The RESOLVED active scope (see `resolveScope`), when the table declares\n   * scopes. The KEY IS ABSENT for a table that declares none — not present-and-\n   * undefined — so a host that never opted in sees a byte-identical query.\n   *\n   * It carries the resolved id, never the stored one: a deep link or a saved\n   * view naming a scope the table no longer declares must not put that id on the\n   * wire, where the backend would reject it and replace the page with an error.\n   */\n  scope?: string;\n  page: number;\n  pageSize: number;\n}\n\n/**\n * Server-mode wiring for a DataViews table. Its PRESENCE flips the table from\n * in-browser filtering/sorting/pagination to backend-driven: the rows handed in\n * are already the current page, `totalCount` is the unpaginated total, and\n * `onQueryChange` fires (search debounced by the host) whenever the user changes\n * a filter, the sort, or the page. This is the ONLY way an admin list should run\n * (see the app-side `DataViewsTable` wrapper, which requires it).\n */\nexport interface DataViewServer {\n  /** Total matched rows across all pages (drives the counter + page count). */\n  totalCount: number;\n  /** Current 1-based page. */\n  page: number;\n  /** Rows per page. */\n  pageSize: number;\n  /** Fired when the effective query changes; the host re-fetches the page. */\n  onQueryChange: (query: DataViewQuery) => void;\n  /**\n   * Per-scope totals for the scope tabs: `scopeId → count`. THE ONLY PIECE OF\n   * THIS CONTRACT THAT CANNOT BE DONE CLIENT-SIDE — a count computed from the\n   * loaded page is wrong the moment there is a second page, which is the\n   * concrete bug scopes exist to fix.\n   *\n   * Compute it over search + pills + ranges while IGNORING the active scope.\n   * Computed WITH the scope applied, every inactive tab reads zero, which is\n   * worse than no counts at all.\n   *\n   * Omit it and the tabs render with no numbers. Nothing is ever invented from\n   * the loaded rows to fill the gap.\n   */\n  scopeCounts?: Record<string, number>;\n}\n\n/**\n * Coerce an opaque persisted state (a saved view's JSON) into a valid\n * DataViewState, filling any missing part with a sane default. Guards against\n * legacy/older shapes so applying a saved view never renders an empty grid.\n */\nexport function coerceViewState(raw: unknown, allColumnIds: string[]): DataViewState {\n  const value = (raw ?? {}) as Partial<DataViewState>;\n  return {\n    search: typeof value.search === \"string\" ? value.search : \"\",\n    pills: asRecord<string[]>(value.pills),\n    ranges: asRecord<RangeValue>(value.ranges),\n    sortBy: Array.isArray(value.sortBy) ? value.sortBy : [],\n    visibleColumns: Array.isArray(value.visibleColumns) ? value.visibleColumns : allColumnIds,\n    order: Array.isArray(value.order) ? value.order : undefined,\n    // Carried through UNVALIDATED against the declared scopes on purpose: a view\n    // written before scopes existed has none (⇒ undefined ⇒ the first declared\n    // scope at render), and one naming a since-removed scope keeps its stored id\n    // here and falls back at READ time. Resolving here would rewrite the view.\n    scope: typeof value.scope === \"string\" ? value.scope : undefined,\n    layout: isLayout(value.layout) ? value.layout : undefined,\n  };\n}\n\n/** Every layout this build knows how to render — the guard's single source. */\nexport const DATA_VIEWS_LAYOUTS: readonly DataViewsLayout[] = [\"cards\", \"list\", \"board\", \"table\"];\n\n/** Is this a layout this build knows how to render? Guards persisted JSON. */\nfunction isLayout(value: unknown): value is DataViewsLayout {\n  return DATA_VIEWS_LAYOUTS.includes(value as DataViewsLayout);\n}\n\n/** A persisted map, or an empty one — persisted JSON can hold anything. */\nfunction asRecord<V>(value: unknown): Record<string, V> {\n  return value !== null && typeof value === \"object\" ? (value as Record<string, V>) : {};\n}\n\n/** A saved view as consumed by the DataViews UI (FUT-89), with ownership flag. */\nexport interface SavedViewSummary {\n  id: string;\n  name: string;\n  description: string | null;\n  state: DataViewState;\n  shared: boolean;\n  pinned: boolean;\n  isDefault: boolean;\n  /** True when the current user owns the view (may edit/delete/pin/share it). */\n  isOwner: boolean;\n}\n\n/** A saved-view repository record (opaque `state`), as returned to server pages. */\ninterface SavedViewRecordLike {\n  id: string;\n  name: string;\n  description: string | null;\n  state: unknown;\n  shared: boolean;\n  pinned: boolean;\n  isDefault: boolean;\n  isOwner: boolean;\n}\n\n/** Map a repository record to the client summary (opaque state → DataViewState). */\nexport function toSavedViewSummary(record: SavedViewRecordLike): SavedViewSummary {\n  return { ...record, state: (record.state ?? {}) as DataViewState };\n}\n\n/**\n * Dependency-injection contracts for the framework-agnostic DataViewsTableBase:\n * the host app supplies saved-view persistence + router side-effects so the ui\n * component imports neither a backend (server actions) nor a framework router.\n */\n\n/** A saved view's editable fields, as the host persists them. */\nexport interface DataViewSaveInput {\n  name: string;\n  description: string;\n  state: DataViewState;\n  shared: boolean;\n  pinned: boolean;\n  isDefault: boolean;\n}\n\n/** Result of a persistence call — mirrors the app's `Result` without importing it. */\nexport type DataViewMutationResult = { ok: true } | { ok: false; error: string };\n\n/** Injected saved-view persistence (create/update/delete), wired by the host. */\nexport interface DataViewPersistence {\n  create: (input: DataViewSaveInput) => Promise<DataViewMutationResult>;\n  update: (id: string, input: DataViewSaveInput) => Promise<DataViewMutationResult>;\n  remove: (id: string) => Promise<DataViewMutationResult>;\n}\n\n/** Injected router side-effects: sync the `?view=` param and re-fetch on change. */\nexport interface DataViewRouter {\n  syncViewParam: (viewId: string | null) => void;\n  refresh: () => void;\n}\n"],"mappings":";AAoEO,IAAM,qBAAsD;AAAA,EACjE,OAAO;AAAA,EACP,OAAO,IAAI;AAAA,EACX,QAAQ,KAAK;AAAA,EACb,QAAQ,IAAI;AAAA,EACZ,OAAO,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASX,OAAO;AACT;AAuHO,SAAS,eAAe,gBAAyC;AACtE,SAAO,EAAE,QAAQ,IAAI,OAAO,CAAC,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC,GAAG,eAAe;AACzE;AA+EO,SAAS,gBAAgB,KAAc,cAAuC;AACnF,QAAM,QAAS,OAAO,CAAC;AACvB,SAAO;AAAA,IACL,QAAQ,OAAO,MAAM,WAAW,WAAW,MAAM,SAAS;AAAA,IAC1D,OAAO,SAAmB,MAAM,KAAK;AAAA,IACrC,QAAQ,SAAqB,MAAM,MAAM;AAAA,IACzC,QAAQ,MAAM,QAAQ,MAAM,MAAM,IAAI,MAAM,SAAS,CAAC;AAAA,IACtD,gBAAgB,MAAM,QAAQ,MAAM,cAAc,IAAI,MAAM,iBAAiB;AAAA,IAC7E,OAAO,MAAM,QAAQ,MAAM,KAAK,IAAI,MAAM,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA,IAKlD,OAAO,OAAO,MAAM,UAAU,WAAW,MAAM,QAAQ;AAAA,IACvD,QAAQ,SAAS,MAAM,MAAM,IAAI,MAAM,SAAS;AAAA,EAClD;AACF;AAGO,IAAM,qBAAiD,CAAC,SAAS,QAAQ,SAAS,OAAO;AAGhG,SAAS,SAAS,OAA0C;AAC1D,SAAO,mBAAmB,SAAS,KAAwB;AAC7D;AAGA,SAAS,SAAY,OAAmC;AACtD,SAAO,UAAU,QAAQ,OAAO,UAAU,WAAY,QAA8B,CAAC;AACvF;AA4BO,SAAS,mBAAmB,QAA+C;AAChF,SAAO,EAAE,GAAG,QAAQ,OAAQ,OAAO,SAAS,CAAC,EAAoB;AACnE;","names":[]}