mvc-kit 2.8.0 → 2.9.0

package/dist/Sorting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sorting.js","sources":["../src/Sorting.ts"],"sourcesContent":["/** Describes a single sort column with key and direction. */\nexport interface SortDescriptor {\n  key: string;\n  direction: 'asc' | 'desc';\n}\n\n/**\n * Multi-column sort state manager with a comparator pipeline.\n * Maintains an ordered list of sort descriptors and applies them to arrays.\n * Subscribable — auto-tracked when used as a ViewModel property.\n */\nexport class Sorting<T = any> {\n  private _sorts: readonly SortDescriptor[];\n  private _listeners = new Set<() => void>();\n\n  constructor(options?: { sorts?: SortDescriptor[] }) {\n    this._sorts = Object.freeze(options?.sorts?.map(s => ({ ...s })) ?? []);\n  }\n\n  // ── Readable state ──\n\n  /** Current list of active sort descriptors, in priority order. */\n  get sorts(): readonly SortDescriptor[] {\n    return this._sorts;\n  }\n\n  /** Primary sort key (first descriptor), or null when empty. */\n  get key(): string | null {\n    return this._sorts.length > 0 ? this._sorts[0].key : null;\n  }\n\n  /** Primary sort direction. Defaults to 'asc' when empty. */\n  get direction(): 'asc' | 'desc' {\n    return this._sorts.length > 0 ? this._sorts[0].direction : 'asc';\n  }\n\n  // ── Query ──\n\n  /** Whether the given key is currently sorted. */\n  isSorted(key: string): boolean {\n    return this._sorts.some(s => s.key === key);\n  }\n\n  /** Returns the sort direction for a key, or null if not sorted. */\n  directionOf(key: string): 'asc' | 'desc' | null {\n    const found = this._sorts.find(s => s.key === key);\n    return found ? found.direction : null;\n  }\n\n  /** Returns the priority index of a sorted key, or -1 if not sorted. */\n  indexOf(key: string): number {\n    return this._sorts.findIndex(s => s.key === key);\n  }\n\n  // ── Actions ──\n\n  /** 3-click cycle: not sorted → asc → desc → removed. */\n  toggle(key: string): void {\n    const idx = this.indexOf(key);\n    if (idx === -1) {\n      // Add as asc\n      this._sorts = Object.freeze([...this._sorts, { key, direction: 'asc' as const }]);\n    } else if (this._sorts[idx].direction === 'asc') {\n      // Flip to desc\n      const next = this._sorts.map((s, i) =>\n        i === idx ? { key: s.key, direction: 'desc' as const } : s\n      );\n      this._sorts = Object.freeze(next);\n    } else {\n      // Remove\n      this._sorts = Object.freeze(this._sorts.filter((_, i) => i !== idx));\n    }\n    this._notify();\n  }\n\n  /** Replace all with a single sort. */\n  setSort(key: string, direction: 'asc' | 'desc'): void {\n    this._sorts = Object.freeze([{ key, direction }]);\n    this._notify();\n  }\n\n  /** Replace all sorts. */\n  setSorts(sorts: SortDescriptor[]): void {\n    this._sorts = Object.freeze(sorts.map(s => ({ ...s })));\n    this._notify();\n  }\n\n  /** Clear all sort descriptors. */\n  reset(): void {\n    this._sorts = Object.freeze([]);\n    this._notify();\n  }\n\n  // ── Pipeline ──\n\n  /** Sort an array using the current descriptors. Returns a new sorted array. */\n  apply(\n    items: T[],\n    compareFn?: (a: T, b: T, key: string, dir: 'asc' | 'desc') => number,\n  ): T[] {\n    if (this._sorts.length === 0) return items;\n    const sorted = items.slice();\n    const sorts = this._sorts;\n    sorted.sort((a, b) => {\n      for (const { key, direction } of sorts) {\n        let cmp: number;\n        if (compareFn) {\n          cmp = compareFn(a, b, key, direction);\n        } else {\n          cmp = defaultCompare(a, b, key);\n        }\n        if (direction === 'desc') cmp = -cmp;\n        if (cmp !== 0) return cmp;\n      }\n      return 0;\n    });\n    return sorted;\n  }\n\n  // ── Subscribable interface ──\n\n  /** Subscribe to sort state changes. Returns an unsubscribe function. */\n  subscribe(cb: () => void): () => void {\n    this._listeners.add(cb);\n    return () => { this._listeners.delete(cb); };\n  }\n\n  private _notify(): void {\n    for (const cb of this._listeners) cb();\n  }\n}\n\nfunction defaultCompare(a: any, b: any, key: string): number {\n  const aVal = a[key];\n  const bVal = b[key];\n  if (aVal == null && bVal == null) return 0;\n  if (aVal == null) return -1;\n  if (bVal == null) return 1;\n  if (typeof aVal === 'string' && typeof bVal === 'string') {\n    return aVal.localeCompare(bVal);\n  }\n  if (aVal < bVal) return -1;\n  if (aVal > bVal) return 1;\n  return 0;\n}\n"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -11,6 +11,12 @@ export { Service } from './Service';
 export { EventBus } from './EventBus';
 export { Channel } from './Channel';
 export type { ChannelStatus } from './Channel';
+export { Sorting } from './Sorting';
+export type { SortDescriptor } from './Sorting';
+export { Pagination } from './Pagination';
+export { Selection } from './Selection';
+export { Feed } from './Feed';
+export type { FeedPage } from './Feed';
 export type { AppError } from './errors';
 export { HttpError, isAbortError, classifyError } from './errors';
 export { singleton, hasSingleton, teardown, teardownAll } from './singleton';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,WAAW,EACX,YAAY,GACb,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG/C,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGlE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,WAAW,EACX,YAAY,GACb,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,YAAY,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAGvC,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGlE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/mvc-kit.cjs

@@ -9,6 +9,10 @@ const Controller = require("./Controller.cjs");
 const Service = require("./Service.cjs");
 const EventBus = require("./EventBus.cjs");
 const Channel = require("./Channel.cjs");
+const Sorting = require("./Sorting.cjs");
+const Pagination = require("./Pagination.cjs");
+const Selection = require("./Selection.cjs");
+const Feed = require("./Feed.cjs");
 const errors = require("./errors.cjs");
 const singleton = require("./singleton.cjs");
 exports.ViewModel = ViewModel.ViewModel;
@@ -20,6 +24,10 @@ exports.Controller = Controller.Controller;
 exports.Service = Service.Service;
 exports.EventBus = EventBus.EventBus;
 exports.Channel = Channel.Channel;
+exports.Sorting = Sorting.Sorting;
+exports.Pagination = Pagination.Pagination;
+exports.Selection = Selection.Selection;
+exports.Feed = Feed.Feed;
 exports.HttpError = errors.HttpError;
 exports.classifyError = errors.classifyError;
 exports.isAbortError = errors.isAbortError;

package/dist/mvc-kit.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"mvc-kit.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"mvc-kit.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/mvc-kit.js

@@ -7,6 +7,10 @@ import { Controller } from "./Controller.js";
 import { Service } from "./Service.js";
 import { EventBus } from "./EventBus.js";
 import { Channel } from "./Channel.js";
+import { Sorting } from "./Sorting.js";
+import { Pagination } from "./Pagination.js";
+import { Selection } from "./Selection.js";
+import { Feed } from "./Feed.js";
 import { HttpError, classifyError, isAbortError } from "./errors.js";
 import { hasSingleton, singleton, teardown, teardownAll } from "./singleton.js";
 export {
@@ -14,11 +18,15 @@ export {
   Collection,
   Controller,
   EventBus,
+  Feed,
   HttpError,
   Model,
+  Pagination,
   PersistentCollection,
   Resource,
+  Selection,
   Service,
+  Sorting,
   ViewModel,
   classifyError,
   hasSingleton,

package/dist/mvc-kit.js.map

@@ -1 +1 @@
-{"version":3,"file":"mvc-kit.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;"}
+{"version":3,"file":"mvc-kit.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;"}

package/dist/react/components/CardList.cjs

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const defaultKeyOf = (item) => item.id;
+function CardList({
+  items,
+  renderItem,
+  keyOf = defaultKeyOf,
+  layout = "list",
+  columns = 3,
+  gap = "1rem",
+  loading,
+  error,
+  renderEmpty,
+  renderLoading,
+  renderError,
+  className,
+  "aria-label": ariaLabel
+}) {
+  if (loading && renderLoading) return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: renderLoading() });
+  if (error && renderError) return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: renderError(error) });
+  if (items.length === 0 && renderEmpty) return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: renderEmpty() });
+  const style = layout === "grid" ? {
+    display: "grid",
+    gridTemplateColumns: `repeat(var(--card-list-columns, ${columns}), 1fr)`,
+    gap: `var(--card-list-gap, ${gap})`
+  } : void 0;
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "ul",
+    {
+      role: "list",
+      "data-component": "card-list",
+      "data-layout": layout,
+      className,
+      "aria-label": ariaLabel,
+      style,
+      children: items.map((item, index) => /* @__PURE__ */ jsxRuntime.jsx("li", { "data-index": index, children: renderItem(item, index) }, keyOf(item)))
+    }
+  );
+}
+exports.CardList = CardList;
+//# sourceMappingURL=CardList.cjs.map

package/dist/react/components/CardList.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CardList.cjs","sources":["../../../src/react/components/CardList.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type { AsyncStateProps } from './types';\n\n/** Props for the CardList headless component. */\nexport interface CardListProps<T> extends AsyncStateProps {\n  items: T[];\n  renderItem: (item: T, index: number) => ReactNode;\n  keyOf?: (item: T) => string | number;\n  layout?: 'list' | 'grid';\n  columns?: number;\n  gap?: string;\n  renderEmpty?: () => ReactNode;\n  renderLoading?: () => ReactNode;\n  renderError?: (error: string) => ReactNode;\n  className?: string;\n  'aria-label'?: string;\n}\n\nconst defaultKeyOf = (item: any) => item.id;\n\n/**\n * Headless list/grid component with render-prop items.\n * Renders a semantic `<ul>` with optional CSS grid layout.\n */\nexport function CardList<T>({\n  items,\n  renderItem,\n  keyOf = defaultKeyOf,\n  layout = 'list',\n  columns = 3,\n  gap = '1rem',\n  loading,\n  error,\n  renderEmpty,\n  renderLoading,\n  renderError,\n  className,\n  'aria-label': ariaLabel,\n}: CardListProps<T>) {\n  if (loading && renderLoading) return <>{renderLoading()}</>;\n  if (error && renderError) return <>{renderError(error)}</>;\n  if (items.length === 0 && renderEmpty) return <>{renderEmpty()}</>;\n\n  const style = layout === 'grid'\n    ? {\n        display: 'grid',\n        gridTemplateColumns: `repeat(var(--card-list-columns, ${columns}), 1fr)`,\n        gap: `var(--card-list-gap, ${gap})`,\n      } as const\n    : undefined;\n\n  return (\n    <ul\n      role=\"list\"\n      data-component=\"card-list\"\n      data-layout={layout}\n      className={className}\n      aria-label={ariaLabel}\n      style={style}\n    >\n      {items.map((item, index) => (\n        <li key={keyOf(item)} data-index={index}>\n          {renderItem(item, index)}\n        </li>\n      ))}\n    </ul>\n  );\n}\n"],"names":["jsx","Fragment"],"mappings":";;;AAkBA,MAAM,eAAe,CAAC,SAAc,KAAK;AAMlC,SAAS,SAAY;AAAA,EAC1B;AAAA,EACA;AAAA,EACA,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,UAAU;AAAA,EACV,MAAM;AAAA,EACN;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,cAAc;AAChB,GAAqB;AACnB,MAAI,WAAW,cAAe,QAAOA,2BAAAA,IAAAC,WAAAA,UAAA,EAAG,2BAAgB;AACxD,MAAI,SAAS,YAAa,QAAOD,+BAAAC,WAAAA,UAAA,EAAG,UAAA,YAAY,KAAK,GAAE;AACvD,MAAI,MAAM,WAAW,KAAK,YAAa,QAAOD,+BAAAC,WAAAA,UAAA,EAAG,yBAAc;AAE/D,QAAM,QAAQ,WAAW,SACrB;AAAA,IACE,SAAS;AAAA,IACT,qBAAqB,mCAAmC,OAAO;AAAA,IAC/D,KAAK,wBAAwB,GAAG;AAAA,EAAA,IAElC;AAEJ,SACED,2BAAAA;AAAAA,IAAC;AAAA,IAAA;AAAA,MACC,MAAK;AAAA,MACL,kBAAe;AAAA,MACf,eAAa;AAAA,MACb;AAAA,MACA,cAAY;AAAA,MACZ;AAAA,MAEC,gBAAM,IAAI,CAAC,MAAM,yCACf,MAAA,EAAqB,cAAY,OAC/B,UAAA,WAAW,MAAM,KAAK,KADhB,MAAM,IAAI,CAEnB,CACD;AAAA,IAAA;AAAA,EAAA;AAGP;;"}

package/dist/react/components/CardList.d.ts

@@ -0,0 +1,22 @@
+import type { ReactNode } from 'react';
+import type { AsyncStateProps } from './types';
+/** Props for the CardList headless component. */
+export interface CardListProps<T> extends AsyncStateProps {
+    items: T[];
+    renderItem: (item: T, index: number) => ReactNode;
+    keyOf?: (item: T) => string | number;
+    layout?: 'list' | 'grid';
+    columns?: number;
+    gap?: string;
+    renderEmpty?: () => ReactNode;
+    renderLoading?: () => ReactNode;
+    renderError?: (error: string) => ReactNode;
+    className?: string;
+    'aria-label'?: string;
+}
+/**
+ * Headless list/grid component with render-prop items.
+ * Renders a semantic `<ul>` with optional CSS grid layout.
+ */
+export declare function CardList<T>({ items, renderItem, keyOf, layout, columns, gap, loading, error, renderEmpty, renderLoading, renderError, className, 'aria-label': ariaLabel, }: CardListProps<T>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=CardList.d.ts.map

package/dist/react/components/CardList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CardList.d.ts","sourceRoot":"","sources":["../../../src/react/components/CardList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,iDAAiD;AACjD,MAAM,WAAW,aAAa,CAAC,CAAC,CAAE,SAAQ,eAAe;IACvD,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAClD,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,SAAS,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,SAAS,CAAC;IAChC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,EAC1B,KAAK,EACL,UAAU,EACV,KAAoB,EACpB,MAAe,EACf,OAAW,EACX,GAAY,EACZ,OAAO,EACP,KAAK,EACL,WAAW,EACX,aAAa,EACb,WAAW,EACX,SAAS,EACT,YAAY,EAAE,SAAS,GACxB,EAAE,aAAa,CAAC,CAAC,CAAC,2CA6BlB"}

package/dist/react/components/CardList.js

@@ -0,0 +1,42 @@
+import { jsx, Fragment } from "react/jsx-runtime";
+const defaultKeyOf = (item) => item.id;
+function CardList({
+  items,
+  renderItem,
+  keyOf = defaultKeyOf,
+  layout = "list",
+  columns = 3,
+  gap = "1rem",
+  loading,
+  error,
+  renderEmpty,
+  renderLoading,
+  renderError,
+  className,
+  "aria-label": ariaLabel
+}) {
+  if (loading && renderLoading) return /* @__PURE__ */ jsx(Fragment, { children: renderLoading() });
+  if (error && renderError) return /* @__PURE__ */ jsx(Fragment, { children: renderError(error) });
+  if (items.length === 0 && renderEmpty) return /* @__PURE__ */ jsx(Fragment, { children: renderEmpty() });
+  const style = layout === "grid" ? {
+    display: "grid",
+    gridTemplateColumns: `repeat(var(--card-list-columns, ${columns}), 1fr)`,
+    gap: `var(--card-list-gap, ${gap})`
+  } : void 0;
+  return /* @__PURE__ */ jsx(
+    "ul",
+    {
+      role: "list",
+      "data-component": "card-list",
+      "data-layout": layout,
+      className,
+      "aria-label": ariaLabel,
+      style,
+      children: items.map((item, index) => /* @__PURE__ */ jsx("li", { "data-index": index, children: renderItem(item, index) }, keyOf(item)))
+    }
+  );
+}
+export {
+  CardList
+};
+//# sourceMappingURL=CardList.js.map

package/dist/react/components/CardList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CardList.js","sources":["../../../src/react/components/CardList.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type { AsyncStateProps } from './types';\n\n/** Props for the CardList headless component. */\nexport interface CardListProps<T> extends AsyncStateProps {\n  items: T[];\n  renderItem: (item: T, index: number) => ReactNode;\n  keyOf?: (item: T) => string | number;\n  layout?: 'list' | 'grid';\n  columns?: number;\n  gap?: string;\n  renderEmpty?: () => ReactNode;\n  renderLoading?: () => ReactNode;\n  renderError?: (error: string) => ReactNode;\n  className?: string;\n  'aria-label'?: string;\n}\n\nconst defaultKeyOf = (item: any) => item.id;\n\n/**\n * Headless list/grid component with render-prop items.\n * Renders a semantic `<ul>` with optional CSS grid layout.\n */\nexport function CardList<T>({\n  items,\n  renderItem,\n  keyOf = defaultKeyOf,\n  layout = 'list',\n  columns = 3,\n  gap = '1rem',\n  loading,\n  error,\n  renderEmpty,\n  renderLoading,\n  renderError,\n  className,\n  'aria-label': ariaLabel,\n}: CardListProps<T>) {\n  if (loading && renderLoading) return <>{renderLoading()}</>;\n  if (error && renderError) return <>{renderError(error)}</>;\n  if (items.length === 0 && renderEmpty) return <>{renderEmpty()}</>;\n\n  const style = layout === 'grid'\n    ? {\n        display: 'grid',\n        gridTemplateColumns: `repeat(var(--card-list-columns, ${columns}), 1fr)`,\n        gap: `var(--card-list-gap, ${gap})`,\n      } as const\n    : undefined;\n\n  return (\n    <ul\n      role=\"list\"\n      data-component=\"card-list\"\n      data-layout={layout}\n      className={className}\n      aria-label={ariaLabel}\n      style={style}\n    >\n      {items.map((item, index) => (\n        <li key={keyOf(item)} data-index={index}>\n          {renderItem(item, index)}\n        </li>\n      ))}\n    </ul>\n  );\n}\n"],"names":[],"mappings":";AAkBA,MAAM,eAAe,CAAC,SAAc,KAAK;AAMlC,SAAS,SAAY;AAAA,EAC1B;AAAA,EACA;AAAA,EACA,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,UAAU;AAAA,EACV,MAAM;AAAA,EACN;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,cAAc;AAChB,GAAqB;AACnB,MAAI,WAAW,cAAe,QAAO,oBAAA,UAAA,EAAG,2BAAgB;AACxD,MAAI,SAAS,YAAa,QAAO,oBAAA,UAAA,EAAG,UAAA,YAAY,KAAK,GAAE;AACvD,MAAI,MAAM,WAAW,KAAK,YAAa,QAAO,oBAAA,UAAA,EAAG,yBAAc;AAE/D,QAAM,QAAQ,WAAW,SACrB;AAAA,IACE,SAAS;AAAA,IACT,qBAAqB,mCAAmC,OAAO;AAAA,IAC/D,KAAK,wBAAwB,GAAG;AAAA,EAAA,IAElC;AAEJ,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,MAAK;AAAA,MACL,kBAAe;AAAA,MACf,eAAa;AAAA,MACb;AAAA,MACA,cAAY;AAAA,MACZ;AAAA,MAEC,gBAAM,IAAI,CAAC,MAAM,8BACf,MAAA,EAAqB,cAAY,OAC/B,UAAA,WAAW,MAAM,KAAK,KADhB,MAAM,IAAI,CAEnB,CACD;AAAA,IAAA;AAAA,EAAA;AAGP;"}

package/dist/react/components/DataTable.cjs

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const types = require("./types.cjs");
+function resolveSelectionProp(selection) {
+  if (types.isSelectionHelper(selection)) {
+    return {
+      selected: selection.selected,
+      onToggle: (key) => selection.toggle(key),
+      onToggleAll: (allKeys) => selection.toggleAll(allKeys)
+    };
+  }
+  return {
+    selected: selection.selected,
+    onToggle: selection.onToggle,
+    onToggleAll: (allKeys) => selection.onToggleAll(allKeys)
+  };
+}
+function resolveSortProp(sort, onSort) {
+  if (types.isSortingHelper(sort)) {
+    return { sorts: sort.sorts, onSort: (key) => sort.toggle(key) };
+  }
+  return { sorts: sort, onSort };
+}
+function resolvePaginationProp(pagination, pageSize, paginationTotal) {
+  if (types.isPaginationHelper(pagination)) {
+    const total2 = paginationTotal ?? 0;
+    const ps2 = pagination.pageSize;
+    const pageCount2 = Math.max(1, Math.ceil(total2 / ps2));
+    const page2 = pagination.page;
+    return {
+      page: page2,
+      pageCount: pageCount2,
+      total: total2,
+      pageSize: ps2,
+      hasPrev: page2 > 1,
+      hasNext: page2 < pageCount2,
+      goToPage: (p) => pagination.setPage(p),
+      goPrev: () => pagination.setPage(page2 - 1),
+      goNext: () => pagination.setPage(page2 + 1)
+    };
+  }
+  const total = pagination.total;
+  const ps = pageSize ?? 10;
+  const pageCount = Math.max(1, Math.ceil(total / ps));
+  const page = pagination.page;
+  return {
+    page,
+    pageCount,
+    total,
+    pageSize: ps,
+    hasPrev: page > 1,
+    hasNext: page < pageCount,
+    goToPage: pagination.onPageChange,
+    goPrev: () => pagination.onPageChange(page - 1),
+    goNext: () => pagination.onPageChange(page + 1)
+  };
+}
+const defaultKeyOf = (item) => item.id;
+function getAriaSortValue(key, sorts) {
+  if (!sorts) return "none";
+  const desc = sorts.find((s) => s.key === key);
+  if (!desc) return "none";
+  return desc.direction === "asc" ? "ascending" : "descending";
+}
+function DataTable({
+  items,
+  columns,
+  keyOf = defaultKeyOf,
+  pageSize,
+  sort,
+  onSort,
+  selection,
+  loading,
+  error,
+  pagination,
+  paginationTotal,
+  renderEmpty,
+  renderLoading,
+  renderError,
+  renderSortIndicator,
+  renderRow,
+  renderPagination,
+  className,
+  "aria-label": ariaLabel
+}) {
+  if (loading && renderLoading) return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: renderLoading() });
+  if (error && renderError) return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: renderError(error) });
+  if (items.length === 0 && renderEmpty) return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: renderEmpty() });
+  const resolvedSelection = selection ? resolveSelectionProp(selection) : void 0;
+  let resolvedSorts;
+  let resolvedOnSort;
+  if (sort) {
+    const resolved = resolveSortProp(sort, onSort);
+    resolvedSorts = resolved.sorts;
+    resolvedOnSort = resolved.onSort;
+  }
+  let displayItems = items;
+  let paginationInfo;
+  if (pagination) {
+    paginationInfo = resolvePaginationProp(pagination, pageSize, paginationTotal);
+  } else if (pageSize && !pagination) {
+    displayItems = items.slice(0, pageSize);
+  }
+  const allKeys = resolvedSelection ? displayItems.map((item) => keyOf(item)) : [];
+  const allSelected = resolvedSelection && allKeys.length > 0 && allKeys.every((k) => resolvedSelection.selected.has(k));
+  const someSelected = resolvedSelection && allKeys.some((k) => resolvedSelection.selected.has(k));
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { "data-component": "data-table", className, children: [
+    /* @__PURE__ */ jsxRuntime.jsxs("table", { role: "grid", "aria-label": ariaLabel, children: [
+      /* @__PURE__ */ jsxRuntime.jsx("thead", { children: /* @__PURE__ */ jsxRuntime.jsxs("tr", { children: [
+        resolvedSelection && /* @__PURE__ */ jsxRuntime.jsx("th", { "data-column": "select", children: /* @__PURE__ */ jsxRuntime.jsx(
+          "input",
+          {
+            type: "checkbox",
+            checked: !!allSelected,
+            ref: (el) => {
+              if (el) el.indeterminate = !!someSelected && !allSelected;
+            },
+            onChange: () => resolvedSelection.onToggleAll(allKeys),
+            "aria-label": "Select all"
+          }
+        ) }),
+        columns.map((col) => {
+          const isSortable = col.sortable && resolvedOnSort;
+          const sortDesc = resolvedSorts?.find((s) => s.key === col.key);
+          const isActive = !!sortDesc;
+          const sortIndex = resolvedSorts ? resolvedSorts.findIndex((s) => s.key === col.key) : -1;
+          return /* @__PURE__ */ jsxRuntime.jsx(
+            "th",
+            {
+              "data-sortable": isSortable ? "" : void 0,
+              "data-sorted": isActive ? "" : void 0,
+              "data-align": col.align,
+              style: col.width ? { width: col.width } : void 0,
+              "aria-sort": isSortable ? getAriaSortValue(col.key, resolvedSorts) : void 0,
+              children: isSortable ? /* @__PURE__ */ jsxRuntime.jsxs("button", { type: "button", onClick: () => resolvedOnSort(col.key), children: [
+                col.header,
+                renderSortIndicator?.({
+                  active: isActive,
+                  direction: sortDesc?.direction ?? "asc",
+                  index: sortIndex,
+                  onToggle: () => resolvedOnSort(col.key)
+                })
+              ] }) : col.header
+            },
+            col.key
+          );
+        })
+      ] }) }),
+      /* @__PURE__ */ jsxRuntime.jsx("tbody", { children: displayItems.map((item, index) => {
+        const key = keyOf(item);
+        const isSelected = resolvedSelection?.selected.has(key);
+        const cells = /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+          resolvedSelection && /* @__PURE__ */ jsxRuntime.jsx("td", { "data-column": "select", children: /* @__PURE__ */ jsxRuntime.jsx(
+            "input",
+            {
+              type: "checkbox",
+              checked: !!isSelected,
+              onChange: () => resolvedSelection.onToggle(key),
+              "aria-label": `Select row ${key}`
+            }
+          ) }),
+          columns.map((col) => /* @__PURE__ */ jsxRuntime.jsx(
+            "td",
+            {
+              "data-align": col.align,
+              children: col.render(item, index)
+            },
+            col.key
+          ))
+        ] });
+        return /* @__PURE__ */ jsxRuntime.jsx("tr", { "data-selected": isSelected ? "" : void 0, children: renderRow ? renderRow(item, index, cells) : cells }, key);
+      }) })
+    ] }),
+    paginationInfo && renderPagination?.(paginationInfo)
+  ] });
+}
+exports.DataTable = DataTable;
+//# sourceMappingURL=DataTable.cjs.map

package/dist/react/components/DataTable.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataTable.cjs","sources":["../../../src/react/components/DataTable.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type {\n  Column,\n  SortHeaderProps,\n  SelectionState,\n  SelectionHelper,\n  PaginationState,\n  PaginationHelper,\n  PaginationInfo,\n  SortingHelper,\n  AsyncStateProps,\n} from './types';\nimport { isSelectionHelper, isPaginationHelper, isSortingHelper } from './types';\nimport type { SortDescriptor } from '../../Sorting';\n\n// ── Prop resolution helpers ──\n\ninterface ResolvedSelection {\n  selected: ReadonlySet<any>;\n  onToggle: (key: any) => void;\n  onToggleAll: (allKeys: any[]) => void;\n}\n\nfunction resolveSelectionProp(selection: SelectionState | SelectionHelper): ResolvedSelection {\n  if (isSelectionHelper(selection)) {\n    return {\n      selected: selection.selected,\n      onToggle: (key) => selection.toggle(key),\n      onToggleAll: (allKeys) => selection.toggleAll(allKeys),\n    };\n  }\n  return {\n    selected: selection.selected,\n    onToggle: selection.onToggle,\n    onToggleAll: (allKeys) => selection.onToggleAll(allKeys),\n  };\n}\n\nfunction resolveSortProp(\n  sort: readonly SortDescriptor[] | SortingHelper,\n  onSort?: (key: string) => void,\n): { sorts: readonly SortDescriptor[]; onSort: ((key: string) => void) | undefined } {\n  if (isSortingHelper(sort)) {\n    return { sorts: sort.sorts, onSort: (key) => sort.toggle(key) };\n  }\n  return { sorts: sort, onSort };\n}\n\nfunction resolvePaginationProp(\n  pagination: PaginationState | PaginationHelper,\n  pageSize?: number,\n  paginationTotal?: number,\n): PaginationInfo {\n  if (isPaginationHelper(pagination)) {\n    const total = paginationTotal ?? 0;\n    const ps = pagination.pageSize;\n    const pageCount = Math.max(1, Math.ceil(total / ps));\n    const page = pagination.page;\n    return {\n      page,\n      pageCount,\n      total,\n      pageSize: ps,\n      hasPrev: page > 1,\n      hasNext: page < pageCount,\n      goToPage: (p) => pagination.setPage(p),\n      goPrev: () => pagination.setPage(page - 1),\n      goNext: () => pagination.setPage(page + 1),\n    };\n  }\n  const total = pagination.total;\n  const ps = pageSize ?? 10;\n  const pageCount = Math.max(1, Math.ceil(total / ps));\n  const page = pagination.page;\n  return {\n    page,\n    pageCount,\n    total,\n    pageSize: ps,\n    hasPrev: page > 1,\n    hasNext: page < pageCount,\n    goToPage: pagination.onPageChange,\n    goPrev: () => pagination.onPageChange(page - 1),\n    goNext: () => pagination.onPageChange(page + 1),\n  };\n}\n\n/** Props for the DataTable headless component. */\nexport interface DataTableProps<T> extends AsyncStateProps {\n  items: T[];\n  columns: Column<T>[];\n  keyOf?: (item: T) => string | number;\n  pageSize?: number;\n\n  // Controlled state — accepts object-literal OR helper instance\n  sort?: readonly SortDescriptor[] | SortingHelper;\n  onSort?: (key: string) => void;\n  selection?: SelectionState | SelectionHelper;\n  pagination?: PaginationState | PaginationHelper;\n  paginationTotal?: number;\n\n  // Render slots\n  renderEmpty?: () => ReactNode;\n  renderLoading?: () => ReactNode;\n  renderError?: (error: string) => ReactNode;\n  renderSortIndicator?: (props: SortHeaderProps) => ReactNode;\n  renderRow?: (item: T, index: number, defaultCells: ReactNode) => ReactNode;\n  renderPagination?: (info: PaginationInfo) => ReactNode;\n\n  className?: string;\n  'aria-label'?: string;\n}\n\nconst defaultKeyOf = (item: any) => item.id;\n\nfunction getAriaSortValue(key: string, sorts: readonly SortDescriptor[] | undefined): 'ascending' | 'descending' | 'none' {\n  if (!sorts) return 'none';\n  const desc = sorts.find(s => s.key === key);\n  if (!desc) return 'none';\n  return desc.direction === 'asc' ? 'ascending' : 'descending';\n}\n\n/**\n * Headless data table with sort headers, selection checkboxes, and pagination slots.\n * Renders semantic HTML (`<table>`) with data attributes for styling.\n * Accepts Sorting/Selection/Pagination helpers directly via duck-typing.\n */\nexport function DataTable<T>({\n  items,\n  columns,\n  keyOf = defaultKeyOf,\n  pageSize,\n  sort,\n  onSort,\n  selection,\n  loading,\n  error,\n  pagination,\n  paginationTotal,\n  renderEmpty,\n  renderLoading,\n  renderError,\n  renderSortIndicator,\n  renderRow,\n  renderPagination,\n  className,\n  'aria-label': ariaLabel,\n}: DataTableProps<T>) {\n  if (loading && renderLoading) return <>{renderLoading()}</>;\n  if (error && renderError) return <>{renderError(error)}</>;\n  if (items.length === 0 && renderEmpty) return <>{renderEmpty()}</>;\n\n  // ── Resolve props ──\n  const resolvedSelection = selection ? resolveSelectionProp(selection) : undefined;\n\n  let resolvedSorts: readonly SortDescriptor[] | undefined;\n  let resolvedOnSort: ((key: string) => void) | undefined;\n  if (sort) {\n    const resolved = resolveSortProp(sort, onSort);\n    resolvedSorts = resolved.sorts;\n    resolvedOnSort = resolved.onSort;\n  }\n\n  let displayItems = items;\n  let paginationInfo: PaginationInfo | undefined;\n  if (pagination) {\n    paginationInfo = resolvePaginationProp(pagination, pageSize, paginationTotal);\n  } else if (pageSize && !pagination) {\n    displayItems = items.slice(0, pageSize);\n  }\n\n  // Selection: check indeterminate state\n  const allKeys = resolvedSelection ? displayItems.map(item => keyOf(item)) : [];\n  const allSelected = resolvedSelection && allKeys.length > 0 && allKeys.every(k => resolvedSelection!.selected.has(k));\n  const someSelected = resolvedSelection && allKeys.some(k => resolvedSelection!.selected.has(k));\n\n  return (\n    <div data-component=\"data-table\" className={className}>\n      <table role=\"grid\" aria-label={ariaLabel}>\n        <thead>\n          <tr>\n            {resolvedSelection && (\n              <th data-column=\"select\">\n                <input\n                  type=\"checkbox\"\n                  checked={!!allSelected}\n                  ref={(el) => {\n                    if (el) el.indeterminate = !!someSelected && !allSelected;\n                  }}\n                  onChange={() => resolvedSelection!.onToggleAll(allKeys)}\n                  aria-label=\"Select all\"\n                />\n              </th>\n            )}\n            {columns.map((col) => {\n              const isSortable = col.sortable && resolvedOnSort;\n              const sortDesc = resolvedSorts?.find(s => s.key === col.key);\n              const isActive = !!sortDesc;\n              const sortIndex = resolvedSorts ? resolvedSorts.findIndex(s => s.key === col.key) : -1;\n\n              return (\n                <th\n                  key={col.key}\n                  data-sortable={isSortable ? '' : undefined}\n                  data-sorted={isActive ? '' : undefined}\n                  data-align={col.align}\n                  style={col.width ? { width: col.width } : undefined}\n                  aria-sort={isSortable ? getAriaSortValue(col.key, resolvedSorts) : undefined}\n                >\n                  {isSortable ? (\n                    <button type=\"button\" onClick={() => resolvedOnSort!(col.key)}>\n                      {col.header}\n                      {renderSortIndicator?.({\n                        active: isActive,\n                        direction: sortDesc?.direction ?? 'asc',\n                        index: sortIndex,\n                        onToggle: () => resolvedOnSort!(col.key),\n                      })}\n                    </button>\n                  ) : (\n                    col.header\n                  )}\n                </th>\n              );\n            })}\n          </tr>\n        </thead>\n        <tbody>\n          {displayItems.map((item, index) => {\n            const key = keyOf(item);\n            const isSelected = resolvedSelection?.selected.has(key);\n\n            const cells = (\n              <>\n                {resolvedSelection && (\n                  <td data-column=\"select\">\n                    <input\n                      type=\"checkbox\"\n                      checked={!!isSelected}\n                      onChange={() => resolvedSelection!.onToggle(key)}\n                      aria-label={`Select row ${key}`}\n                    />\n                  </td>\n                )}\n                {columns.map((col) => (\n                  <td\n                    key={col.key}\n                    data-align={col.align}\n                  >\n                    {col.render(item, index)}\n                  </td>\n                ))}\n              </>\n            );\n\n            return (\n              <tr key={key} data-selected={isSelected ? '' : undefined}>\n                {renderRow ? renderRow(item, index, cells) : cells}\n              </tr>\n            );\n          })}\n        </tbody>\n      </table>\n      {paginationInfo && renderPagination?.(paginationInfo)}\n    </div>\n  );\n}\n"],"names":["isSelectionHelper","isSortingHelper","isPaginationHelper","total","ps","pageCount","page","jsx","Fragment","jsxs"],"mappings":"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"}

package/dist/react/components/DataTable.d.ts

@@ -0,0 +1,30 @@
+import type { ReactNode } from 'react';
+import type { Column, SortHeaderProps, SelectionState, SelectionHelper, PaginationState, PaginationHelper, PaginationInfo, SortingHelper, AsyncStateProps } from './types';
+import type { SortDescriptor } from '../../Sorting';
+/** Props for the DataTable headless component. */
+export interface DataTableProps<T> extends AsyncStateProps {
+    items: T[];
+    columns: Column<T>[];
+    keyOf?: (item: T) => string | number;
+    pageSize?: number;
+    sort?: readonly SortDescriptor[] | SortingHelper;
+    onSort?: (key: string) => void;
+    selection?: SelectionState | SelectionHelper;
+    pagination?: PaginationState | PaginationHelper;
+    paginationTotal?: number;
+    renderEmpty?: () => ReactNode;
+    renderLoading?: () => ReactNode;
+    renderError?: (error: string) => ReactNode;
+    renderSortIndicator?: (props: SortHeaderProps) => ReactNode;
+    renderRow?: (item: T, index: number, defaultCells: ReactNode) => ReactNode;
+    renderPagination?: (info: PaginationInfo) => ReactNode;
+    className?: string;
+    'aria-label'?: string;
+}
+/**
+ * Headless data table with sort headers, selection checkboxes, and pagination slots.
+ * Renders semantic HTML (`<table>`) with data attributes for styling.
+ * Accepts Sorting/Selection/Pagination helpers directly via duck-typing.
+ */
+export declare function DataTable<T>({ items, columns, keyOf, pageSize, sort, onSort, selection, loading, error, pagination, paginationTotal, renderEmpty, renderLoading, renderError, renderSortIndicator, renderRow, renderPagination, className, 'aria-label': ariaLabel, }: DataTableProps<T>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=DataTable.d.ts.map

package/dist/react/components/DataTable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataTable.d.ts","sourceRoot":"","sources":["../../../src/react/components/DataTable.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EACV,MAAM,EACN,eAAe,EACf,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AA0EpD,kDAAkD;AAClD,MAAM,WAAW,cAAc,CAAC,CAAC,CAAE,SAAQ,eAAe;IACxD,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,IAAI,CAAC,EAAE,SAAS,cAAc,EAAE,GAAG,aAAa,CAAC;IACjD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,SAAS,CAAC,EAAE,cAAc,GAAG,eAAe,CAAC;IAC7C,UAAU,CAAC,EAAE,eAAe,GAAG,gBAAgB,CAAC;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;IAGzB,WAAW,CAAC,EAAE,MAAM,SAAS,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,SAAS,CAAC;IAChC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAC3C,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,SAAS,CAAC;IAC5D,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,KAAK,SAAS,CAAC;IAC3E,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,SAAS,CAAC;IAEvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAWD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,EAC3B,KAAK,EACL,OAAO,EACP,KAAoB,EACpB,QAAQ,EACR,IAAI,EACJ,MAAM,EACN,SAAS,EACT,OAAO,EACP,KAAK,EACL,UAAU,EACV,eAAe,EACf,WAAW,EACX,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,SAAS,EACT,gBAAgB,EAChB,SAAS,EACT,YAAY,EAAE,SAAS,GACxB,EAAE,cAAc,CAAC,CAAC,CAAC,2CAuHnB"}