@timeax/form-palette 0.0.2 → 0.0.4

package/dist/presets/shadcn-variants/custom.d.ts

@@ -0,0 +1,94 @@
+import * as React from "react";
+import type { VariantBaseProps, ChangeDetail } from "@/variants/shared";
+/**
+ * Props for the generic "custom" variant.
+ *
+ * - The only special props we define are:
+ *   - component: the React component to render
+ *   - valueProp / changeProp / disabledProp / readOnlyProp / errorProp
+ *   - idProp / nameProp / placeholderProp
+ *   - mapValue / mapDetail (optional hooks)
+ *
+ * - All other props are treated as "component props" and forwarded
+ *   directly to the underlying component.
+ *
+ * The underlying component is expected to:
+ *   - accept the mapped `valueProp`
+ *   - call the mapped `changeProp` with the next value (first argument)
+ *   - optionally use disabled/readOnly/error/id/name/placeholder via the mapped names
+ */
+export interface ShadcnCustomVariantProps<TValue = unknown> extends VariantBaseProps<TValue> {
+    /**
+     * The actual React component to render.
+     *
+     * Example:
+     *   component={MyToggle}
+     */
+    component: React.ComponentType<any>;
+    /**
+     * Prop name that carries the current value for the component.
+     * Default: "value".
+     */
+    valueProp?: string;
+    /**
+     * Prop name for the change handler that the component will call.
+     * Default: "onChange".
+     *
+     * The component is expected to call:
+     *   props[changeProp](nextValue, ...otherArgs?)
+     *
+     * The first argument is taken as the new value.
+     */
+    changeProp?: string;
+    /**
+     * Prop name for disabled state.
+     * Default: "disabled".
+     */
+    disabledProp?: string;
+    /**
+     * Prop name for read-only state.
+     * Default: "readOnly".
+     */
+    readOnlyProp?: string;
+    /**
+     * Prop name for passing error to the component (if it cares).
+     * If provided, we pass the `error` field as-is.
+     * Example values: "error", "isInvalid", "status".
+     */
+    errorProp?: string;
+    /**
+     * Prop name for the id attribute.
+     * Default: "id".
+     */
+    idProp?: string;
+    /**
+     * Prop name for the name attribute.
+     * Default: "name".
+     */
+    nameProp?: string;
+    /**
+     * Prop name for the placeholder attribute.
+     * Default: "placeholder".
+     */
+    placeholderProp?: string;
+    /**
+     * Optional transform for the raw next value before it hits the field.
+     *
+     * Receives the first argument that the component passes to the change
+     * handler, plus the full argument list for flexibility.
+     */
+    mapValue?: (raw: any, ...args: any[]) => TValue;
+    /**
+     * Optional builder for ChangeDetail, given the raw next value.
+     *
+     * If omitted, a default { source: "variant", raw } detail is used.
+     */
+    mapDetail?: (raw: any, ...args: any[]) => ChangeDetail;
+    /**
+     * Any other props are assumed to belong to the custom component.
+     */
+    [key: string]: unknown;
+}
+export declare const ShadcnCustomVariant: React.ForwardRefExoticComponent<Omit<ShadcnCustomVariantProps<any>, "ref"> & React.RefAttributes<any>>;
+export default ShadcnCustomVariant;
+//# sourceMappingURL=custom.d.ts.map

package/dist/presets/shadcn-variants/custom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.d.ts","sourceRoot":"","sources":["../../../src/presets/shadcn-variants/custom.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAExE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,wBAAwB,CAAC,MAAM,GAAG,OAAO,CACvD,SAAQ,gBAAgB,CAAC,MAAM,CAAC;IAChC;;;;;OAKG;IACH,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IAEpC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC;IAEhD;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,YAAY,CAAC;IAEvD;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAED,eAAO,MAAM,mBAAmB,wGAmH9B,CAAC;AAIH,eAAe,mBAAmB,CAAC"}

package/dist/presets/shadcn-variants/custom.js

@@ -0,0 +1,80 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// src/presets/shadcn-variants/custom.tsx
+import * as React from "react";
+export const ShadcnCustomVariant = React.forwardRef(function ShadcnCustomVariant(props, ref) {
+    const { 
+    // Variant base props we care about:
+    value, onValue, error, disabled, readOnly, id, name, placeholder, 
+    // Mapping props:
+    component: Component, valueProp = "value", changeProp = "onChange", disabledProp = "disabled", readOnlyProp = "readOnly", errorProp, idProp = "id", nameProp = "name", placeholderProp = "placeholder", mapValue, mapDetail, 
+    // Everything else goes straight to the component:
+    ...rest } = props;
+    // If there is no component, bail out (dev-time safety).
+    if (!Component) {
+        if (process.env.NODE_ENV !== "production") {
+            // eslint-disable-next-line no-console
+            console.warn("[form-palette] ShadcnCustomVariant: `component` prop is required.");
+        }
+        return null;
+    }
+    const isDisabled = !!disabled;
+    const isReadOnly = !!readOnly;
+    /**
+     * Bridge from the component's change callback to the variant contract.
+     *
+     * We assume the custom component calls the mapped change prop
+     * with the **next value as its first argument**:
+     *
+     *   props[changeProp](nextValue, ...rest)
+     */
+    const handleChange = React.useCallback((...args) => {
+        if (!onValue)
+            return;
+        if (isDisabled || isReadOnly)
+            return;
+        const raw = args[0];
+        const next = mapValue
+            ? mapValue(raw, ...args)
+            : raw;
+        const detail = mapDetail?.(raw, ...args) ?? {
+            source: "variant",
+            raw,
+            nativeEvent: undefined,
+            meta: undefined,
+        };
+        onValue(next, detail);
+    }, [onValue, isDisabled, isReadOnly, mapValue, mapDetail]);
+    // Build the props for the custom component.
+    const innerProps = {
+        ...rest, // ← all non-special props from InputField go directly to the component
+    };
+    // Map value → component[valueProp]
+    innerProps[valueProp] = value;
+    // Map handler → component[changeProp]
+    innerProps[changeProp] = handleChange;
+    // Map disabled / readOnly
+    if (disabledProp) {
+        innerProps[disabledProp] = isDisabled;
+    }
+    if (readOnlyProp) {
+        innerProps[readOnlyProp] = isReadOnly;
+    }
+    // Map error if a mapping key is provided
+    if (errorProp && error !== undefined) {
+        innerProps[errorProp] = error;
+    }
+    // Map id/name/placeholder if present
+    if (id !== undefined && idProp) {
+        innerProps[idProp] = id;
+    }
+    if (name !== undefined && nameProp) {
+        innerProps[nameProp] = name;
+    }
+    if (placeholder !== undefined && placeholderProp) {
+        innerProps[placeholderProp] = placeholder;
+    }
+    return _jsx(Component, { ref: ref, ...innerProps });
+});
+ShadcnCustomVariant.displayName = "ShadcnCustomVariant";
+export default ShadcnCustomVariant;
+//# sourceMappingURL=custom.js.map

package/dist/presets/shadcn-variants/custom.js.map

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

package/dist/presets/shadcn-variants/date.d.ts

@@ -0,0 +1,114 @@
+import * as React from "react";
+import type { VariantBaseProps } from "@/variants/shared";
+import type { ShadcnTextVariantProps } from "@/presets/shadcn-variants/text";
+import { Calendar } from "@/presets/ui/calendar";
+type DateMode = "single" | "range";
+export interface DateRange {
+    from?: Date;
+    to?: Date;
+}
+type DateValue = Date | DateRange | undefined;
+type BaseProps = VariantBaseProps<DateValue>;
+type DisabledDays = React.ComponentProps<typeof Calendar>["disabled"];
+/**
+ * Logical temporal "kind" for the field.
+ *
+ * This controls the default mask + formatting/parsing.
+ *
+ * - "date"      → yyyy-MM-dd (default)
+ * - "datetime"  → yyyy-MM-dd HH:mm
+ * - "time"      → HH:mm
+ * - "hour"      → HH
+ * - "monthYear" → MM/yyyy
+ * - "year"      → yyyy
+ */
+export type DateKind = "date" | "datetime" | "time" | "hour" | "monthYear" | "year" | (string & {});
+/**
+ * Public props for the date variant (legacy + mask extensions).
+ */
+export interface DateVariantProps {
+    mode?: DateMode;
+    placeholder?: React.ReactNode;
+    clearable?: boolean;
+    minDate?: Date;
+    maxDate?: Date;
+    disabledDays?: DisabledDays;
+    /**
+     * Pattern for single dates.
+     *
+     * Tokens:
+     * - yyyy → full year
+     * - MM   → month (01–12)
+     * - dd   → day (01–31)
+     * - HH   → hours (00–23)
+     * - mm   → minutes (00–59)
+     *
+     * Default depends on `kind`:
+     * - date      → "yyyy-MM-dd"
+     * - datetime  → "yyyy-MM-dd HH:mm"
+     * - time      → "HH:mm"
+     * - hour      → "HH"
+     * - monthYear → "MM/yyyy"
+     * - year      → "yyyy"
+     */
+    formatSingle?: string;
+    /**
+     * String pattern or custom formatter for ranges.
+     *
+     * - string → same token rules as formatSingle, applied to both ends
+     * - function → full control over display text
+     */
+    formatRange?: string | ((range: DateRange | undefined) => string);
+    /**
+     * Separator when formatRange is a string pattern.
+     * Default: " – "
+     */
+    rangeSeparator?: string;
+    /**
+     * When true, keep the calendar open after a selection.
+     *
+     * For range mode, the picker also stays open until both
+     * `from` and `to` are chosen.
+     */
+    stayOpenOnSelect?: boolean;
+    /**
+     * Controlled open state for the popover.
+     */
+    open?: boolean;
+    onOpenChange?(o: boolean): void;
+    /**
+     * Temporal kind (controls default mask + formatting/parsing).
+     *
+     * Default: "date".
+     */
+    kind?: DateKind;
+    /**
+     * Optional explicit input mask pattern for the text input.
+     *
+     * If omitted, a sensible default based on `kind` is used.
+     *
+     * Mask tokens follow the same rules as the underlying Input mask:
+     *   9 = digit, a = letter, * = alphanumeric.
+     */
+    inputMask?: string;
+    /**
+     * Whether to render the calendar popover.
+     *
+     * Defaults:
+     * - true  for `kind` = "date" | "datetime"
+     * - false for time-only kinds ("time", "hour", "monthYear", "year")
+     */
+    showCalendar?: boolean;
+}
+/**
+ * We still reuse the Shadcn text UI props (size, density, icons, etc.),
+ * but we take over type/value/onValue and the controls.
+ */
+type TextUiProps = Omit<ShadcnTextVariantProps, "type" | "inputMode" | "leadingControl" | "trailingControl" | "value" | "onValue">;
+/**
+ * Full props for the Shadcn-based date variant.
+ */
+export type ShadcnDateVariantProps = TextUiProps & DateVariantProps & Pick<BaseProps, "value" | "onValue" | "error">;
+export declare const ShadcnDateVariant: React.ForwardRefExoticComponent<TextUiProps & DateVariantProps & Pick<BaseProps, "value" | "onValue" | "error"> & React.RefAttributes<HTMLInputElement>>;
+export default ShadcnDateVariant;
+//# sourceMappingURL=date.d.ts.map

package/dist/presets/shadcn-variants/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../../src/presets/shadcn-variants/date.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,gBAAgB,EAAgB,MAAM,mBAAmB,CAAC;AACxE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAG7E,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,KAAK,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEnC,MAAM,WAAW,SAAS;IACvB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,EAAE,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,KAAK,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,CAAC;AAE9C,KAAK,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;AAG7C,KAAK,YAAY,GAAG,KAAK,CAAC,cAAc,CAAC,OAAO,QAAQ,CAAC,CAAC,UAAU,CAAC,CAAC;AAEtE;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,QAAQ,GACf,MAAM,GACN,UAAU,GACV,MAAM,GACN,MAAM,GACN,WAAW,GACX,MAAM,GACN,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC9B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAE9B,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,WAAW,CAAC,EACV,MAAM,GACN,CAAC,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,KAAK,MAAM,CAAC,CAAC;IAE7C;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAEhC;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAEhB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,KAAK,WAAW,GAAG,IAAI,CACpB,sBAAsB,EACpB,MAAM,GACN,WAAW,GACX,gBAAgB,GAChB,iBAAiB,GACjB,OAAO,GACP,SAAS,CACb,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAC7C,gBAAgB,GAChB,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC;AA4OlD,eAAO,MAAM,iBAAiB,0JAiZ5B,CAAC;AAIH,eAAe,iBAAiB,CAAC"}