@caratlogic/design-system 0.1.33 → 0.1.35

package/dist/components/organisms/Filters/FilterSurface/FilterSurface.d.ts

@@ -1,9 +1,9 @@
-import type { ReactElement } from 'react';
+import { type ReactElement } from 'react';
 import type { FilterSurfaceGroupProps, FilterSurfaceMoreProps, FilterSurfaceProps } from './FilterSurface.types';
-export type { FilterSurfaceGroupProps, FilterSurfaceMoreProps, FilterSurfaceProps, } from './FilterSurface.types';
+export type { FilterSurfaceGroupProps, FilterSurfaceMoreProps, FilterSurfaceProps, FilterSurfaceStatus, } from './FilterSurface.types';
 /** Full-page filter screen (e.g. an advanced search): header, scrolling card grid, sticky apply footer. */
-export declare function FilterSurface({ title, headerActions, footerChips, footerActions, onClose, children, }: FilterSurfaceProps): ReactElement;
-export declare function FilterSurfaceGroup({ title, className, children, }: FilterSurfaceGroupProps): ReactElement;
+export declare function FilterSurface({ title, headerActions, footerChips, footerActions, onClose, status, errorMessage, onRetry, skeleton, children, }: FilterSurfaceProps): ReactElement;
+export declare function FilterSurfaceGroup({ title, masonry, className, children, }: FilterSurfaceGroupProps): ReactElement;
 /** Collapsed "More filters" divider that reveals extra cards. */
 export declare function FilterSurfaceMore({ label, defaultExpanded, children, }: FilterSurfaceMoreProps): ReactElement;
 //# sourceMappingURL=FilterSurface.d.ts.map

package/dist/components/organisms/Filters/FilterSurface/FilterSurface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FilterSurface.d.ts","sourceRoot":"","sources":["../../../../../src/components/organisms/Filters/FilterSurface/FilterSurface.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAM1C,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,2GAA2G;AAC3G,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,aAAa,EACb,WAAW,EACX,aAAa,EACb,OAAO,EACP,QAAQ,GACT,EAAE,kBAAkB,GAAG,YAAY,CAiDnC;AAED,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,SAAS,EACT,QAAQ,GACT,EAAE,uBAAuB,GAAG,YAAY,CAaxC;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,eAAe,EACf,QAAQ,GACT,EAAE,sBAAsB,GAAG,YAAY,CA0BvC"}
+{"version":3,"file":"FilterSurface.d.ts","sourceRoot":"","sources":["../../../../../src/components/organisms/Filters/FilterSurface/FilterSurface.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAgBpD,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,2GAA2G;AAC3G,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,aAAa,EACb,WAAW,EACX,aAAa,EACb,OAAO,EACP,MAAgB,EAChB,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,QAAQ,GACT,EAAE,kBAAkB,GAAG,YAAY,CA2DnC;AAED,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,OAAe,EACf,SAAS,EACT,QAAQ,GACT,EAAE,uBAAuB,GAAG,YAAY,CAwBxC;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,eAAe,EACf,QAAQ,GACT,EAAE,sBAAsB,GAAG,YAAY,CA0BvC"}

package/dist/components/organisms/Filters/FilterSurface/FilterSurface.hooks.d.ts

@@ -3,4 +3,9 @@ export declare function useFilterSurfaceMore(defaultExpanded?: boolean): {
     expanded: boolean;
     toggle: () => void;
 };
+/** Measures a masonry card and keeps its row span in step with its height (content opening, wrapping…). */
+export declare function useMasonrySpan(): {
+    ref: (node: HTMLDivElement | null) => void;
+    span: number;
+};
 //# sourceMappingURL=FilterSurface.hooks.d.ts.map

package/dist/components/organisms/Filters/FilterSurface/FilterSurface.hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FilterSurface.hooks.d.ts","sourceRoot":"","sources":["../../../../../src/components/organisms/Filters/FilterSurface/FilterSurface.hooks.tsx"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAe1D;AAED,wBAAgB,oBAAoB,CAAC,eAAe,UAAQ,GAAG;IAC7D,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAGA"}
+{"version":3,"file":"FilterSurface.hooks.d.ts","sourceRoot":"","sources":["../../../../../src/components/organisms/Filters/FilterSurface/FilterSurface.hooks.tsx"],"names":[],"mappings":"AAMA,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAe1D;AAED,wBAAgB,oBAAoB,CAAC,eAAe,UAAQ,GAAG;IAC7D,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAGA;AAED,2GAA2G;AAC3G,wBAAgB,cAAc,IAAI;IAChC,GAAG,EAAE,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,KAAK,IAAI,CAAC;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd,CAiBA"}

package/dist/components/organisms/Filters/FilterSurface/FilterSurface.parts.d.ts

@@ -0,0 +1,9 @@
+import type { ReactElement } from 'react';
+import type { FilterSurfaceErrorProps, MasonryItemProps, FilterSurfaceSkeletonProps } from './FilterSurface.types';
+/** Loading placeholder: the page's own skeleton, or generic list cards. */
+export declare function FilterSurfaceSkeleton({ children, }: FilterSurfaceSkeletonProps): ReactElement;
+/** Shown in place of the cards when the filters couldn't load. */
+export declare function FilterSurfaceError({ message, onRetry, }: FilterSurfaceErrorProps): ReactElement;
+/** One masonry cell: spans the rows its card needs; the bottom padding is the gap to the next card. */
+export declare function MasonryItem({ children }: MasonryItemProps): ReactElement;
+//# sourceMappingURL=FilterSurface.parts.d.ts.map

package/dist/components/organisms/Filters/FilterSurface/FilterSurface.parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilterSurface.parts.d.ts","sourceRoot":"","sources":["../../../../../src/components/organisms/Filters/FilterSurface/FilterSurface.parts.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAU1C,OAAO,KAAK,EACV,uBAAuB,EACvB,gBAAgB,EAChB,0BAA0B,EAC3B,MAAM,uBAAuB,CAAC;AAW/B,2EAA2E;AAC3E,wBAAgB,qBAAqB,CAAC,EACpC,QAAQ,GACT,EAAE,0BAA0B,GAAG,YAAY,CAY3C;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,OAAO,GACR,EAAE,uBAAuB,GAAG,YAAY,CA2BxC;AAED,uGAAuG;AACvG,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,EAAE,gBAAgB,GAAG,YAAY,CASxE"}

package/dist/components/organisms/Filters/FilterSurface/FilterSurface.types.d.ts

@@ -9,14 +9,38 @@ export interface FilterSurfaceProps {
     footerActions?: ReactNode;
     /** Escape closes the surface without applying. */
     onClose: () => void;
+    /** `loading` shows skeleton cards and `error` an error panel in place of the cards; the footer shows only when `ready`. */
+    status?: FilterSurfaceStatus;
+    /** Error panel text. Default explains the filters couldn't load. */
+    errorMessage?: string;
+    /** Error panel "Try again" action. */
+    onRetry?: () => void;
+    /** Placeholder shown while `loading`, ideally the page's own card layout (see `FilterCardSkeleton`). */
+    skeleton?: ReactNode;
     children: ReactNode;
 }
+export type FilterSurfaceStatus = 'ready' | 'loading' | 'error';
+export interface FilterSurfaceSkeletonProps {
+    children?: ReactNode;
+}
+export interface FilterSurfaceErrorProps {
+    message: string;
+    onRetry?: () => void;
+}
 export interface FilterSurfaceGroupProps {
     /** Small uppercase heading over a group of cards, e.g. `General`. */
     title?: string;
+    /**
+     * Masonry packing: each card takes only its own height and the next card fills the first gap, so tall
+     * and short cards interlock with no empty space. Columns still come from `className` (e.g. `lg:grid-cols-3`).
+     */
+    masonry?: boolean;
     className?: string;
     children: ReactNode;
 }
+export interface MasonryItemProps {
+    children: ReactNode;
+}
 export interface FilterSurfaceMoreProps {
     /** Collapsed-state label, e.g. `More filters · size, notes, dates`. */
     label: string;

package/dist/components/organisms/Filters/FilterSurface/FilterSurface.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FilterSurface.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/organisms/Filters/FilterSurface/FilterSurface.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,qDAAqD;IACrD,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,oEAAoE;IACpE,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,kDAAkD;IAClD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,SAAS,CAAC;CACrB"}
+{"version":3,"file":"FilterSurface.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/organisms/Filters/FilterSurface/FilterSurface.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,qDAAqD;IACrD,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,oEAAoE;IACpE,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,kDAAkD;IAClD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,2HAA2H;IAC3H,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,wGAAwG;IACxG,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAEhE,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,SAAS,CAAC;CACrB"}

package/dist/components/organisms/Filters/FilterSurface/FilterSurface.utils.d.ts

@@ -0,0 +1,10 @@
+/** Placeholder cards while the filters load; roughly the first rows of a card grid. */
+export declare const SKELETON_CARD_COUNT = 8;
+export declare const SKELETON_GRID_CLASS_NAME = "grid grid-cols-1 gap-3 sm:grid-cols-2 lg:grid-cols-4";
+/** Masonry grid rows are this tall; a card spans as many as its height needs. */
+export declare const MASONRY_ROW_PX = 4;
+/** Rows a card of `height` px (including its bottom gap) spans; 0 until measured. */
+export declare const getMasonrySpan: (height: number) => number;
+/** Dense 4px rows; the vertical gap comes from each item's bottom padding. */
+export declare const MASONRY_GRID_CLASS_NAME = "grid-flow-row-dense auto-rows-[4px] gap-x-3";
+//# sourceMappingURL=FilterSurface.utils.d.ts.map

package/dist/components/organisms/Filters/FilterSurface/FilterSurface.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilterSurface.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/organisms/Filters/FilterSurface/FilterSurface.utils.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,eAAO,MAAM,wBAAwB,yDACmB,CAAC;AAEzD,iFAAiF;AACjF,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,qFAAqF;AACrF,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,MACK,CAAC;AAEtD,8EAA8E;AAC9E,eAAO,MAAM,uBAAuB,gDACW,CAAC"}

package/dist/components/organisms/Filters/FilterSurface/index.d.ts

@@ -1,3 +1,3 @@
 export { FilterSurface, FilterSurfaceGroup, FilterSurfaceMore, } from './FilterSurface';
-export type { FilterSurfaceGroupProps, FilterSurfaceMoreProps, FilterSurfaceProps, } from './FilterSurface';
+export type { FilterSurfaceGroupProps, FilterSurfaceMoreProps, FilterSurfaceProps, FilterSurfaceStatus, } from './FilterSurface';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/organisms/Filters/FilterSurface/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/organisms/Filters/FilterSurface/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/organisms/Filters/FilterSurface/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC"}

package/dist/hooks/useTruncatedText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTruncatedText.d.ts","sourceRoot":"","sources":["../../src/hooks/useTruncatedText.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAgBvC;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GACjC,MAAM,GAAG,IAAI,CAqCf"}
+{"version":3,"file":"useTruncatedText.d.ts","sourceRoot":"","sources":["../../src/hooks/useTruncatedText.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAoBvC;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GACjC,MAAM,GAAG,IAAI,CAqCf"}