@timeax/form-palette 0.0.5 → 0.0.6

package/dist/index.d.mts

@@ -979,6 +979,90 @@ interface LayoutResolveContext<T = unknown> {
  */
 type LayoutResolver<T = unknown> = (ctx: LayoutResolveContext<T>) => FieldLayoutConfig;
 
+type MaskMode$1 = "raw" | "masked";
+/**
+ * Mask-related props for the Shadcn text variant.
+ *
+ * These are forwarded to the underlying <Input>, which in turn wires
+ * them into the InputMask implementation.
+ */
+interface ShadcnTextMaskProps {
+    /**
+     * Mask pattern – Primereact style.
+     * Example: "99/99/9999", "(999) 999-9999"
+     */
+    mask?: string;
+    /**
+     * Per-symbol definitions for slots.
+     * Kept for future custom engine; not used by the current
+     * react-input-mask implementation.
+     */
+    maskDefinitions?: Record<string, RegExp>;
+    /**
+     * Character used to visually represent an empty slot.
+     * Default: "_".
+     */
+    slotChar?: string;
+    /**
+     * If true, when the value is effectively "empty" (no unmasked chars),
+     * we emit an empty string "" instead of a fully-masked placeholder.
+     *
+     * NOTE: This behaviour is implemented in the variant, not Input,
+     * so we preserve your existing semantics.
+     */
+    autoClear?: boolean;
+    /**
+     * Whether the *model* value is raw or masked.
+     *
+     * - "raw" or true   → onValue receives unmasked value
+     * - "masked" or false/undefined → onValue receives full masked string
+     *
+     * NOTE: detail.raw is **always** the masked string.
+     */
+    unmask?: MaskMode$1 | boolean;
+    /**
+     * Placeholder for future caret-mode logic when we go back
+     * to a custom engine. Currently unused, kept for API compatibility.
+     */
+    maskInsertMode?: "stream" | "caret";
+}
+/**
+ * Extra UI props for the Shadcn text input (pure HTML-level).
+ *
+ * These are forwarded straight to the underlying <Input />.
+ */
+type ShadcnTextUiProps = Omit<React.InputHTMLAttributes<HTMLInputElement>, "value" | "defaultValue" | "onChange" | "size"> & {
+    /**
+     * Extra classes applied only to the *inner* input element
+     * (the actual <input>, not the wrapper box).
+     */
+    inputClassName?: string;
+    /**
+     * Fixed prefix rendered as part of the input value, NOT as an icon.
+     * E.g. "₦", "ID: ".
+     *
+     * The underlying <Input> will:
+     *  - take the model value (without prefix),
+     *  - render prefix + value,
+     *  - expose the full visible string in event.target.value.
+     */
+    prefix?: string;
+    /**
+     * Fixed suffix rendered as part of the input value, NOT as an icon.
+     * E.g. "%", "kg".
+     */
+    suffix?: string;
+    /**
+     * If true (default), we strip the prefix from the value
+     * before emitting it via `onValue`.
+     */
+    stripPrefix?: boolean;
+    /**
+     * If true (default), we strip the suffix from the value
+     * before emitting it via `onValue`.
+     */
+    stripSuffix?: boolean;
+} & ShadcnTextMaskProps;
 /**
  * Props for the Shadcn-based text variant.
  *
@@ -1000,7 +1084,7 @@ type ShadcnTextVariantProps = ExtraFieldProps<VariantBaseProps<string | undefine
      * (true) or controls are visually separate (false).
      */
     extendBoxToControls?: boolean;
-};
+} & ShadcnTextUiProps;
 
 type InputRef = HTMLInputElement;
 interface InputNumberValueChangeEvent {

package/dist/index.d.ts

@@ -979,6 +979,90 @@ interface LayoutResolveContext<T = unknown> {
  */
 type LayoutResolver<T = unknown> = (ctx: LayoutResolveContext<T>) => FieldLayoutConfig;
 
+type MaskMode$1 = "raw" | "masked";
+/**
+ * Mask-related props for the Shadcn text variant.
+ *
+ * These are forwarded to the underlying <Input>, which in turn wires
+ * them into the InputMask implementation.
+ */
+interface ShadcnTextMaskProps {
+    /**
+     * Mask pattern – Primereact style.
+     * Example: "99/99/9999", "(999) 999-9999"
+     */
+    mask?: string;
+    /**
+     * Per-symbol definitions for slots.
+     * Kept for future custom engine; not used by the current
+     * react-input-mask implementation.
+     */
+    maskDefinitions?: Record<string, RegExp>;
+    /**
+     * Character used to visually represent an empty slot.
+     * Default: "_".
+     */
+    slotChar?: string;
+    /**
+     * If true, when the value is effectively "empty" (no unmasked chars),
+     * we emit an empty string "" instead of a fully-masked placeholder.
+     *
+     * NOTE: This behaviour is implemented in the variant, not Input,
+     * so we preserve your existing semantics.
+     */
+    autoClear?: boolean;
+    /**
+     * Whether the *model* value is raw or masked.
+     *
+     * - "raw" or true   → onValue receives unmasked value
+     * - "masked" or false/undefined → onValue receives full masked string
+     *
+     * NOTE: detail.raw is **always** the masked string.
+     */
+    unmask?: MaskMode$1 | boolean;
+    /**
+     * Placeholder for future caret-mode logic when we go back
+     * to a custom engine. Currently unused, kept for API compatibility.
+     */
+    maskInsertMode?: "stream" | "caret";
+}
+/**
+ * Extra UI props for the Shadcn text input (pure HTML-level).
+ *
+ * These are forwarded straight to the underlying <Input />.
+ */
+type ShadcnTextUiProps = Omit<React.InputHTMLAttributes<HTMLInputElement>, "value" | "defaultValue" | "onChange" | "size"> & {
+    /**
+     * Extra classes applied only to the *inner* input element
+     * (the actual <input>, not the wrapper box).
+     */
+    inputClassName?: string;
+    /**
+     * Fixed prefix rendered as part of the input value, NOT as an icon.
+     * E.g. "₦", "ID: ".
+     *
+     * The underlying <Input> will:
+     *  - take the model value (without prefix),
+     *  - render prefix + value,
+     *  - expose the full visible string in event.target.value.
+     */
+    prefix?: string;
+    /**
+     * Fixed suffix rendered as part of the input value, NOT as an icon.
+     * E.g. "%", "kg".
+     */
+    suffix?: string;
+    /**
+     * If true (default), we strip the prefix from the value
+     * before emitting it via `onValue`.
+     */
+    stripPrefix?: boolean;
+    /**
+     * If true (default), we strip the suffix from the value
+     * before emitting it via `onValue`.
+     */
+    stripSuffix?: boolean;
+} & ShadcnTextMaskProps;
 /**
  * Props for the Shadcn-based text variant.
  *
@@ -1000,7 +1084,7 @@ type ShadcnTextVariantProps = ExtraFieldProps<VariantBaseProps<string | undefine
      * (true) or controls are visually separate (false).
      */
     extendBoxToControls?: boolean;
-};
+} & ShadcnTextUiProps;
 
 type InputRef = HTMLInputElement;
 interface InputNumberValueChangeEvent {