@fuf-stack/megapixels 0.11.24 → 0.11.26

package/dist/index-Dpm2SIC2.d.cts

@@ -1,354 +0,0 @@
-import { vInfer } from "@fuf-stack/veto";
-import { ReactNode } from "react";
-import { TVClassName } from "@fuf-stack/pixel-utils";
-
-//#region src/Filter/filters/checkboxes/schema.d.ts
-/** configuration of the filter */
-declare const config$1: import("@fuf-stack/veto").VObjectSchema<{
-  /**
-   * Human‑readable label used in the UI (e.g. label and modal header).
-   * Example: "Snacks", "Mood"
-   */
-  text: import("@fuf-stack/veto").ZodString;
-  /**
-   * Options rendered as multiple checkboxes. Each option needs a `label`
-   * (what the user sees) and a `value` (what is written into the form state).
-   * Label can be a string, React node, or a function that receives mode
-   * ('form' or 'display') and returns a React node.
-   */
-  options: import("@fuf-stack/veto").VArraySchema<import("@fuf-stack/veto").VObjectSchema<{
-    label: import("@fuf-stack/veto").ZodAny;
-    value: import("@fuf-stack/veto").ZodString;
-  }>>;
-}>;
-/** Type-safe Config that overrides label to support ReactNode or function */
-type Config = Omit<vInfer<typeof config$1>, 'options'> & {
-  options: {
-    label: ReactNode | ((mode: 'form' | 'display') => ReactNode);
-    value: string;
-  }[];
-};
-//#endregion
-//#region src/Filter/filters/types.d.ts
-/**
- * FilterDefinition
- *
- * Declarative description of a filter. A FilterDefinition is not used
- * directly by the UI. Instead, it is passed to `createFilter` to produce a
- * concrete, runtime `FilterInstance` for a specific usage (with name/icon and
- * optional config overrides).
- *
- * @typeParam Config - The configuration object shape for this filter
- * @typeParam Value  - The runtime value type produced/consumed by this filter
- */
-interface FilterDefinition<Config, Value> {
-  components: {
-    /**
-     * Display component rendered inside the filter chip. Receives the current
-     * filter `value` and the merged `config`.
-     */
-    Display: (props: {
-      value: Value;
-      config: Config;
-    }) => ReactNode;
-    /**
-     * Form component rendered inside the modal. Receives the fully-qualified
-     * field name and the merged, validated `config`.
-     */
-    Form: (props: {
-      fieldName: string;
-      config: Config;
-    }) => ReactNode;
-  };
-  defaults: {
-    /** Baseline configuration for the filter; can be overridden per usage */config: Config; /** Initial form value seeded when a filter is added */
-    value: Value;
-  };
-  /**
-   * Validation factory returning an ex-validator schema for the value shape.
-   * Receives the (merged) `config` so the schema can depend on configuration.
-   */
-  validation: (config?: Config) => unknown;
-}
-/**
- * FilterFactory
- *
- * A filter exports a factory that, given name/icon and optional config
- * overrides, returns a concrete FilterInstance with merged config and a
- * computed defaultValue.
- *
- * @typeParam Config - Configuration object shape for the filter
- * @typeParam Value  - Runtime value type for the filter
- */
-type FilterFactory<Config, Value> = (args: {
-  /** Per-usage configuration overrides merged with `defaults.config` */config?: Partial<Config>; /** Optional icon element shown in menus/labels */
-  icon?: ReactNode; /** Logical field name under `filter.{name}` */
-  name: string;
-}) => FilterInstance<Config, Value>;
-/**
- * FilterInstance
- *
- * Runtime instance created by merging a filter's defaults with usage
- * overrides and attaching name/icon for UI.
- *
- * This is the only shape used by the rendering layer and context.
- *
- * @typeParam Config - Effective configuration object shape
- * @typeParam Value  - Effective value type for the filter
- */
-interface FilterInstance<Config, Value> {
-  /** UI components (Form/Display) provided by the filter */
-  components: FilterDefinition<Config, Value>['components'];
-  /** Merged configuration (`defaults.config` overlaid with per-usage overrides) */
-  config: Config;
-  /** Initial form value to seed when adding this filter */
-  defaultValue: Value;
-  /** Optional icon element used in menus/labels */
-  icon?: ReactNode;
-  /** Logical field name under `filter.{name}` */
-  name: string;
-  /** ex-validator schema factory for the value; typically closure over config */
-  validation: (config?: Config) => unknown;
-}
-/**
- * FiltersConfiguration
- *
- * Top-level collection of instantiated filters used by the Filter component
- * and FiltersContext. Each entry is a concrete FilterInstance (already created
- * via a filter factory), carrying its merged config, default value, UI
- * components, and validate function.
- */
-type FiltersConfiguration = FilterInstance<any, any>[];
-/**
- * FilterDisplayProps
- *
- * Props provided to a filter's Display component. Derived from an active
- * FilterInstance at runtime.
- *
- * @typeParam Config - Effective configuration type for the instance
- * @typeParam Value  - Effective value type for the instance
- */
-interface FilterDisplayProps<Config, Value> {
-  /** Merged configuration for the filter instance */
-  config: Config;
-  /** Current (possibly partial) value for the filter instance */
-  value: Value;
-}
-/**
- * FilterFormProps
- *
- * Props provided to a filter's Form component. The `fieldName` is the
- * fully-qualified path in the host form, and the `config` is the instance's
- * merged configuration.
- *
- * @typeParam Config - Effective configuration type for the instance
- */
-interface FilterFormProps<Config> {
-  /** Merged configuration for the filter instance */
-  config: Config;
-  /** Fully-qualified form field path (e.g., `filter.status`) */
-  fieldName: string;
-}
-//#endregion
-//#region src/Filter/Subcomponents/SearchInput.d.ts
-type SearchConfiguration = boolean | {
-  /** Placeholder shown in the search input */placeholder?: string;
-};
-//#endregion
-//#region src/Filter/Filter.d.ts
-declare const filterVariants: import("tailwind-variants").TVReturnType<{
-  [key: string]: {
-    [key: string]: import("tailwind-merge").ClassNameValue | {
-      base?: import("tailwind-merge").ClassNameValue;
-      addFilterMenuButton?: import("tailwind-merge").ClassNameValue;
-      addFilterMenuItem?: import("tailwind-merge").ClassNameValue;
-      activeFilterLabel?: import("tailwind-merge").ClassNameValue;
-      filterModalBody?: import("tailwind-merge").ClassNameValue;
-      filterModalHeader?: import("tailwind-merge").ClassNameValue;
-      filterModalFooter?: import("tailwind-merge").ClassNameValue;
-      form?: import("tailwind-merge").ClassNameValue;
-      searchInput?: import("tailwind-merge").ClassNameValue;
-      searchInputWrapper?: import("tailwind-merge").ClassNameValue;
-      searchMotionDiv?: import("tailwind-merge").ClassNameValue;
-      searchShowButton?: import("tailwind-merge").ClassNameValue;
-      searchSubmitButton?: import("tailwind-merge").ClassNameValue;
-      searchWrapper?: import("tailwind-merge").ClassNameValue;
-    };
-  };
-} | {
-  [x: string]: {
-    [x: string]: import("tailwind-merge").ClassNameValue | {
-      base?: import("tailwind-merge").ClassNameValue;
-      addFilterMenuButton?: import("tailwind-merge").ClassNameValue;
-      addFilterMenuItem?: import("tailwind-merge").ClassNameValue;
-      activeFilterLabel?: import("tailwind-merge").ClassNameValue;
-      filterModalBody?: import("tailwind-merge").ClassNameValue;
-      filterModalHeader?: import("tailwind-merge").ClassNameValue;
-      filterModalFooter?: import("tailwind-merge").ClassNameValue;
-      form?: import("tailwind-merge").ClassNameValue;
-      searchInput?: import("tailwind-merge").ClassNameValue;
-      searchInputWrapper?: import("tailwind-merge").ClassNameValue;
-      searchMotionDiv?: import("tailwind-merge").ClassNameValue;
-      searchShowButton?: import("tailwind-merge").ClassNameValue;
-      searchSubmitButton?: import("tailwind-merge").ClassNameValue;
-      searchWrapper?: import("tailwind-merge").ClassNameValue;
-    };
-  };
-} | {}, {
-  base: string;
-  addFilterMenuButton: string;
-  addFilterMenuItem: string;
-  activeFilterLabel: string;
-  filterModalBody: string;
-  filterModalHeader: string;
-  filterModalFooter: string;
-  form: string;
-  searchInput: string;
-  searchInputWrapper: string;
-  searchMotionDiv: string;
-  searchShowButton: string;
-  searchSubmitButton: string;
-  searchWrapper: string;
-}, undefined, {
-  [key: string]: {
-    [key: string]: import("tailwind-merge").ClassNameValue | {
-      base?: import("tailwind-merge").ClassNameValue;
-      addFilterMenuButton?: import("tailwind-merge").ClassNameValue;
-      addFilterMenuItem?: import("tailwind-merge").ClassNameValue;
-      activeFilterLabel?: import("tailwind-merge").ClassNameValue;
-      filterModalBody?: import("tailwind-merge").ClassNameValue;
-      filterModalHeader?: import("tailwind-merge").ClassNameValue;
-      filterModalFooter?: import("tailwind-merge").ClassNameValue;
-      form?: import("tailwind-merge").ClassNameValue;
-      searchInput?: import("tailwind-merge").ClassNameValue;
-      searchInputWrapper?: import("tailwind-merge").ClassNameValue;
-      searchMotionDiv?: import("tailwind-merge").ClassNameValue;
-      searchShowButton?: import("tailwind-merge").ClassNameValue;
-      searchSubmitButton?: import("tailwind-merge").ClassNameValue;
-      searchWrapper?: import("tailwind-merge").ClassNameValue;
-    };
-  };
-} | {}, {
-  base: string;
-  addFilterMenuButton: string;
-  addFilterMenuItem: string;
-  activeFilterLabel: string;
-  filterModalBody: string;
-  filterModalHeader: string;
-  filterModalFooter: string;
-  form: string;
-  searchInput: string;
-  searchInputWrapper: string;
-  searchMotionDiv: string;
-  searchShowButton: string;
-  searchSubmitButton: string;
-  searchWrapper: string;
-}, import("tailwind-variants").TVReturnType<unknown, {
-  base: string;
-  addFilterMenuButton: string;
-  addFilterMenuItem: string;
-  activeFilterLabel: string;
-  filterModalBody: string;
-  filterModalHeader: string;
-  filterModalFooter: string;
-  form: string;
-  searchInput: string;
-  searchInputWrapper: string;
-  searchMotionDiv: string;
-  searchShowButton: string;
-  searchSubmitButton: string;
-  searchWrapper: string;
-}, undefined, unknown, unknown, undefined>>;
-type ClassName = TVClassName<typeof filterVariants>;
-interface FilterValues {
-  search?: string;
-  filter?: string | Record<string, unknown> | null;
-}
-type FilterChildRenderFn = (values: {
-  search?: string;
-  filter?: Record<string, unknown>;
-}) => ReactNode;
-/**
- * Filter
- *
- * Controlled, form-driven filter UI.
- *
- * Responsibilities
- * - Derives initial form values from the controlled `values` prop
- * - Builds a composite validation schema from the filter registry (and optional search)
- * - Exposes ergonomic UI: active filters list, add/remove actions, and per-filter modal
- * - Commits changes by invoking the controlled `onChange` callback on submit
- *
- * Structure
- * - Owns an ex-forms `Form` that wraps the entire filter experience
- * - Optionally renders a search input bound to the `search` field
- * - Renders ActiveFilters, AddFilterMenu, and FilterModal inside a shared context
- * - Optionally renders children as a render-prop with the resolved `values`
- */
-interface FilterProps {
-  /** Optional render-prop that receives the resolved, controlled values */
-  children?: FilterChildRenderFn;
-  /** CSS class name */
-  className?: ClassName;
-  /** Configuration of the filter */
-  config: {
-    /**
-     * Declarative filter configuration. Each entry ties a logical name to a
-     * registry filter type and (optionally) per-usage config overrides.
-     */
-    filters: FiltersConfiguration; /** Optional configuration for search field */
-    search?: SearchConfiguration;
-  };
-  /** ex-forms form instance name. Defaults to "filterComponentForm". */
-  formName?: string;
-  /** Controlled setter invoked on submit with the next canonical values */
-  onChange: (nextValues: FilterValues) => void;
-  /** Controlled committed state: the canonical `search` and `filter` values */
-  values: FilterValues;
-}
-/**
- * Renders the filter UI bound to a single ex-forms `Form`.
- * The form is the source of truth during user interaction; the committed
- * state is controlled by the parent via `values`/`onChange`.
- */
-declare const Filter: ({
-  children,
-  className,
-  config,
-  formName,
-  onChange,
-  values
-}: FilterProps) => import("react/jsx-runtime").JSX.Element;
-//#endregion
-//#region src/Filter/filters/createFilter.d.ts
-/**
- * createFilter
- *
- * Builds a filter factory from a static FilterDefinition. The returned factory
- * accepts a usage descriptor (name/icon and optional partial config) and
- * produces a concrete FilterInstance with:
- * - merged config (shallow: definition.defaults.config overlaid by overrides)
- * - Form/Display components
- * - validate function (forwarded from the definition)
- * - defaultValue (forwarded from the definition)
- * - name and icon for UI integration
- *
- * @typeParam Config - Configuration object shape for the filter
- * @typeParam Value  - Runtime value type for the filter
- * @param definition - Static description of the filter (components, defaults, validate)
- * @returns FilterFactory that creates FilterInstance<Config, Value>
- */
-declare const createFilter: <Config, Value>(definition: FilterDefinition<Config, Value>) => FilterFactory<Config, Value>;
-//#endregion
-//#region src/Filter/index.d.ts
-declare const filters: {
-  boolean: FilterFactory<{
-    text: string;
-    textPrefix?: string | undefined;
-    textNoWord?: string | undefined;
-  }, boolean | undefined>;
-  checkboxes: FilterFactory<Config, string[] | undefined>;
-};
-//#endregion
-export { FilterProps as a, FilterDefinition as c, FilterFormProps as d, FilterInstance as f, FilterChildRenderFn as i, FilterDisplayProps as l, createFilter as n, FilterValues as o, FiltersConfiguration as p, Filter as r, filterVariants as s, filters as t, FilterFactory as u };
-//# sourceMappingURL=index-Dpm2SIC2.d.cts.map

package/dist/index-Dpm2SIC2.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-Dpm2SIC2.d.cts","names":[],"sources":["../src/Filter/filters/checkboxes/schema.ts","../src/Filter/filters/types.ts","../src/Filter/Subcomponents/SearchInput.tsx","../src/Filter/Filter.tsx","../src/Filter/filters/createFilter.ts","../src/Filter/index.ts"],"mappings":";;;;;;cAMa,QAAA,4BAAM,aAAA;;AAAnB;;;;EAAmB;;;;;;;;;;;;KAgBP,MAAA,GAAS,IAAA,CAAK,MAAA,QAAc,QAAA;EACtC,OAAA;IACE,KAAA,EAAO,SAAA,KAAc,IAAA,yBAA6B,SAAA;IAClD,KAAA;EAAA;AAAA;;;;;;;AAnBJ;;;;;;;UCOiB,gBAAA;EACf,UAAA;;;;;IAKE,OAAA,GAAU,KAAA;MAAS,KAAA,EAAO,KAAA;MAAO,MAAA,EAAQ,MAAA;IAAA,MAAa,SAAA;IDGxC;;;;ICEd,IAAA,GAAO,KAAA;MAAS,SAAA;MAAmB,MAAA,EAAQ,MAAA;IAAA,MAAa,SAAA;EAAA;EAE1D,QAAA;IDJwB,yECMtB,MAAA,EAAQ,MAAA,EDLV;ICOE,KAAA,EAAO,KAAA;EAAA;EDNc;;;;ECYvB,UAAA,GAAa,MAAA,GAAS,MAAA;AAAA;;;AAvBxB;;;;;;;;KAoCY,aAAA,mBAAgC,IAAA;EAnBjC,sEAqBT,MAAA,GAAS,OAAA,CAAQ,MAAA,GAfW;EAiB5B,IAAA,GAAO,SAAA,EAxCyB;EA0ChC,IAAA;AAAA,MACI,cAAA,CAAe,MAAA,EAAQ,KAAA;;;;;;;;;;;;UAaZ,cAAA;EA7C2C;EA+C1D,UAAA,EAAY,gBAAA,CAAiB,MAAA,EAAQ,KAAA;EA3CnC;EA6CF,MAAA,EAAQ,MAAA;EA3CN;EA6CF,YAAA,EAAc,KAAA;EAvCd;EAyCA,IAAA,GAAO,SAAA;EAzCM;EA2Cb,IAAA;EA3C4B;EA6C5B,UAAA,GAAa,MAAA,GAAS,MAAA;AAAA;;;;;;;;;KAWZ,oBAAA,GAAuB,cAAc;;;;;;;;;;UAWhC,kBAAA;EA/CI;EAiDnB,MAAA,EAAQ,MAAA;EAjDwB;EAmDhC,KAAA,EAAO,KAAK;AAAA;;;;;;;;;;UAYG,eAAA;EAtCa;EAwC5B,MAAA,EAAQ,MAAM;EApDwB;EAsDtC,SAAA;AAAA;;;KClHU,mBAAA;8CAIN,WAAW;AAAA;;;cCQJ,cAAA,8BAAc,YAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAiCtB,SAAA,GAAY,WAAW,QAAQ,cAAA;AAAA,UAEnB,YAAA;EACf,MAAA;EACA,MAAA,YAAkB,MAAM;AAAA;AAAA,KAGd,mBAAA,IAAuB,MAAA;EACjC,MAAA;EACA,MAAA,GAAS,MAAA;AAAA,MACL,SAAS;;;;;;;;;;;;;;;;;;UAmBE,WAAA;EFFf;EEIA,QAAA,GAAW,mBAAA;EFJE;EEMb,SAAA,GAAY,SAAA;EFNgB;EEQ5B,MAAA;IFG8B;;;AAAiB;IEE7C,OAAA,EAAS,oBAAA,EFSsB;IEP/B,MAAA,GAAS,mBAAA;EAAA;EFOuB;EEJlC,QAAA;EFMA;EEJA,QAAA,GAAW,UAAA,EAAY,YAAA;EFMvB;EEJA,MAAA,EAAQ,YAAA;AAAA;AFII;AAYd;;;;AAZc,cEIR,MAAA;EAAU,QAAA;EAAA,SAAA;EAAA,MAAA;EAAA,QAAA;EAAA,QAAA;EAAA;AAAA,GAOb,WAAA,iCAAW,GAAA,CAAA,OAAA;;;;;;;AHhHd;;;;;;;;;;;;;cIaM,YAAA,kBACJ,UAAA,EAAY,gBAAA,CAAiB,MAAA,EAAQ,KAAA,MACpC,aAAA,CAAc,MAAA,EAAQ,KAAA;;;cCVZ,OAAA;WAGZ,aAAA"}