origam 2.24.0 → 2.26.0

package/dist/src/enums/DataTable/data-table.enum.cjs

@@ -3,10 +3,16 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.DATATABLE_SELECT_STRATEGY = void 0;
+exports.DATATABLE_SKELETON_CELL = exports.DATATABLE_SELECT_STRATEGY = void 0;
 var DATATABLE_SELECT_STRATEGY = exports.DATATABLE_SELECT_STRATEGY = /* @__PURE__ */(DATATABLE_SELECT_STRATEGY2 => {
   DATATABLE_SELECT_STRATEGY2["SINGLE"] = "single";
   DATATABLE_SELECT_STRATEGY2["PAGE"] = "page";
   DATATABLE_SELECT_STRATEGY2["ALL"] = "all";
   return DATATABLE_SELECT_STRATEGY2;
-})(DATATABLE_SELECT_STRATEGY || {});
+})(DATATABLE_SELECT_STRATEGY || {});
+var DATATABLE_SKELETON_CELL = exports.DATATABLE_SKELETON_CELL = /* @__PURE__ */(DATATABLE_SKELETON_CELL2 => {
+  DATATABLE_SKELETON_CELL2["TEXT"] = "text";
+  DATATABLE_SKELETON_CELL2["END"] = "end";
+  DATATABLE_SKELETON_CELL2["CONTROL"] = "control";
+  return DATATABLE_SKELETON_CELL2;
+})(DATATABLE_SKELETON_CELL || {});

package/dist/src/enums/DataTable/data-table.enum.d.ts

@@ -3,3 +3,19 @@ export declare enum DATATABLE_SELECT_STRATEGY {
     PAGE = "page",
     ALL = "all"
 }
+/*********************************************************
+ * DATATABLE_SKELETON_CELL
+ *
+ * @description
+ * Silhouette a placeholder cell draws, derived from the COLUMN it belongs
+ * to (the table has no column "type"; its descriptor only carries `align`
+ * and the reserved `data-table-select` / `data-table-expand` keys).
+ * `text` is a bar from the start edge, `end` a shorter bar flush with the
+ * end edge (numbers, amounts), `control` a small square (checkbox,
+ * expand chevron).
+ ********************************************************/
+export declare enum DATATABLE_SKELETON_CELL {
+    TEXT = "text",
+    END = "end",
+    CONTROL = "control"
+}

package/dist/src/enums/DataTable/data-table.enum.js

@@ -4,3 +4,9 @@ export var DATATABLE_SELECT_STRATEGY = /* @__PURE__ */ ((DATATABLE_SELECT_STRATE
   DATATABLE_SELECT_STRATEGY2["ALL"] = "all";
   return DATATABLE_SELECT_STRATEGY2;
 })(DATATABLE_SELECT_STRATEGY || {});
+export var DATATABLE_SKELETON_CELL = /* @__PURE__ */ ((DATATABLE_SKELETON_CELL2) => {
+  DATATABLE_SKELETON_CELL2["TEXT"] = "text";
+  DATATABLE_SKELETON_CELL2["END"] = "end";
+  DATATABLE_SKELETON_CELL2["CONTROL"] = "control";
+  return DATATABLE_SKELETON_CELL2;
+})(DATATABLE_SKELETON_CELL || {});

package/dist/src/interfaces/Btn/btn.interface.d.ts

@@ -9,7 +9,7 @@ import type { IElevationProps } from '../Commons/elevation.interface';
 import type { IGroupEmits, IGroupItemProps } from '../Commons/group.interface';
 import type { IHoverProps } from '../Commons/hover.interface';
 import type { ILinkProps } from '../Commons/router.interface';
-import type { ILoaderProps } from '../Commons/loader.interface';
+import type { IControlLoaderProps } from '../Commons/loader.interface';
 import type { ILocationProps } from '../Commons/location.interface';
 import type { IMarginProps } from '../Commons/margin.interface';
 import type { IPaddingProps } from '../Commons/padding.interface';
@@ -25,7 +25,7 @@ import type { TStatus, TStatusPosition } from '../../types/Commons/status.type';
  *  `icon` prop accepts `boolean | TIcon` (boolean = icon-only mode) which is
  *  wider than `IIconProps.icon?: TIcon`.  Pulling the two status props in
  *  directly avoids the TS2430 incompatible-extends error. */
-export interface IBtnProps extends ICommonsComponentProps, IColorProps, IBgColorProps, IBorderProps, IDensityProps, IDimensionProps, IElevationProps, IRoundedProps, ITagProps, ISizeProps, ILinkProps, IRippleProps, ILoaderProps, IPositionProps, ILocationProps, IGroupItemProps, IPaddingProps, IMarginProps, IAdjacentProps, IHoverProps, IActiveProps, IActionVariantProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight' | 'lineHeight' | 'letterSpacing'> {
+export interface IBtnProps extends ICommonsComponentProps, IColorProps, IBgColorProps, IBorderProps, IDensityProps, IDimensionProps, IElevationProps, IRoundedProps, ITagProps, ISizeProps, ILinkProps, IRippleProps, IControlLoaderProps, IPositionProps, ILocationProps, IGroupItemProps, IPaddingProps, IMarginProps, IAdjacentProps, IHoverProps, IActiveProps, IActionVariantProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight' | 'lineHeight' | 'letterSpacing'> {
     /** @deprecated Use `variant="flat"` instead. Kept for backward compat. */
     flat?: boolean;
     /** Pass `true` to activate icon-only mode; pass a `TIcon` value to set the icon. */
@@ -62,7 +62,7 @@ export interface IBtnEmits extends IGroupEmits {
 export interface IBtnSlots extends IAdjacentSlots {
     /** Overrides the whole loader/prepend/content/append layout. */
     wrapper?: () => any;
-    /** Overrides the active loader (line/circular/skeleton), receives the
+    /** Overrides the active loader (line/circular), receives the
      *  forwarded `<OrigamProgress>` props. */
     loader?: (data: Record<string, unknown>) => any;
     default?: () => any;

package/dist/src/interfaces/Commons/loader.interface.d.ts

@@ -1,6 +1,6 @@
 import type { IColorProps } from './color.interface';
 import type { ICommonsComponentProps, ITagProps } from './commons.interface';
-import type { TLoaderConfig, TLoaderKind, TLoadingValue } from '../../types/Commons/loader.type';
+import type { TControlLoadingValue, TLoaderConfig, TLoaderKind, TLoadingValue } from '../../types/Commons/loader.type';
 /*********************************************************
  * ILoaderProps / IResolvedLoader
  *
@@ -20,6 +20,18 @@ export interface ILoaderProps extends ICommonsComponentProps, ITagProps, IColorP
     loading?: TLoadingValue;
     loadingText?: string;
 }
+/*********************************************************
+ * IControlLoaderProps
+ *
+ * @description
+ * `ILoaderProps` for a CONTROL (`OrigamBtn`, `OrigamSwitch`, `OrigamField`
+ * and its derivatives): same surface, but `loading` refuses
+ * `{ type: 'skeleton' }` - an action in flight never replaces the control
+ * (see `TControlLoaderConfig`).
+ ********************************************************/
+export interface IControlLoaderProps extends Omit<ILoaderProps, 'loading'> {
+    loading?: TControlLoadingValue;
+}
 /**
  * Resolved loader state — what each consumer component reads to decide
  * which renderer to mount and with which props.

package/dist/src/interfaces/Field/field.interface.d.ts

@@ -7,7 +7,7 @@ import type { IDensityProps } from '../Commons/density.interface';
 import type { IElevationProps } from '../Commons/elevation.interface';
 import type { IFocusEmits, IFocusProps } from '../Commons/focus.interface';
 import type { ILabelProps } from '../Label/label.interface';
-import type { ILoaderProps } from '../Commons/loader.interface';
+import type { IControlLoaderProps } from '../Commons/loader.interface';
 import type { IRoundedProps } from '../Commons/rounded.interface';
 import type { ISizeProps } from '../Commons/size.interface';
 import type { ITypographyProps } from '../Commons/typography.interface';
@@ -31,7 +31,7 @@ import type { IInputVariantProps } from '../Commons/variant.interface';
  * `--origam-field---border-*` token channel the three outline legs already
  * read, so the notch keeps opening under `--active` / `--focused`.
  ********************************************************/
-export interface IFieldProps extends ICommonsComponentProps, ILoaderProps, IColorProps, IBgColorProps, IAdjacentInnerProps, IBorderProps, IFocusProps, IDensityProps, ILabelProps, IActiveProps, IInputVariantProps, IRoundedProps, IElevationProps, ISizeProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight' | 'lineHeight' | 'letterSpacing'> {
+export interface IFieldProps extends ICommonsComponentProps, IControlLoaderProps, IColorProps, IBgColorProps, IAdjacentInnerProps, IBorderProps, IFocusProps, IDensityProps, ILabelProps, IActiveProps, IInputVariantProps, IRoundedProps, IElevationProps, ISizeProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight' | 'lineHeight' | 'letterSpacing'> {
     centerAffix?: boolean;
     dirty?: boolean;
     disabled?: boolean;

package/dist/src/interfaces/Skeleton/skeleton.interface.d.ts

@@ -4,6 +4,7 @@ import type { IDimensionProps } from '../Commons/dimension.interface';
 import type { IRoundedProps } from '../Commons/rounded.interface';
 import type { ISizeProps } from '../Commons/size.interface';
 import type { TSkeletonAnimation, TSkeletonVariant } from '../../types/Skeleton/skeleton.type';
+import type { ISkeletonGroupProps } from './skeleton-group.interface';
 export interface ISkeletonProps extends ICommonsComponentProps, IColorProps, IBgColorProps, ISizeProps, IRoundedProps, IDimensionProps {
     variant?: TSkeletonVariant;
     loading?: boolean;
@@ -52,3 +53,15 @@ export interface ISkeletonProps extends ICommonsComponentProps, IColorProps, IBg
  ********************************************************/
 export interface ISkeletonEmits {
 }
+/*********************************************************
+ * ISkeletonOverrides
+ *
+ * @description
+ * Result of `splitSkeletonOverrides()`: the `loading="{ type: 'skeleton' }"`
+ * bag split between the `<OrigamSkeletonGroup>` (per zone) and each
+ * primitive it contains (per block).
+ ********************************************************/
+export interface ISkeletonOverrides {
+    group: ISkeletonGroupProps;
+    block: Pick<ISkeletonProps, 'color' | 'bgColor' | 'rounded'>;
+}

package/dist/src/interfaces/Switch/switch.interface.d.ts

@@ -7,13 +7,13 @@ import type { IElevationProps } from '../Commons/elevation.interface';
 import type { IFocusEmits } from '../Commons/focus.interface';
 import type { IHoverProps } from '../Commons/hover.interface';
 import type { IInputProps } from '../Input/input.interface';
-import type { ILoaderProps } from '../Commons/loader.interface';
+import type { IControlLoaderProps } from '../Commons/loader.interface';
 import type { IMarginProps } from '../Commons/margin.interface';
 import type { IPaddingProps } from '../Commons/padding.interface';
 import type { IRoundedProps } from '../Commons/rounded.interface';
 import type { ISelectionControlProps } from '../SelectionControl/selection-control.interface';
 import type { ISwitchTrackSlotsProps } from './switch-track.interface';
-export interface ISwitchProps extends ICommonsComponentProps, ITagProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IInputProps, ISelectionControlProps, ILoaderProps, IColorProps, IDensityProps, IElevationProps, IActiveProps, IHoverProps {
+export interface ISwitchProps extends ICommonsComponentProps, ITagProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IInputProps, ISelectionControlProps, IControlLoaderProps, IColorProps, IDensityProps, IElevationProps, IActiveProps, IHoverProps {
     indeterminate?: boolean;
     inset?: boolean;
 }

package/dist/src/types/Commons/loader.type.d.ts

@@ -35,3 +35,27 @@ export type TLoaderConfig = ({
  * | `{ type: 'line' \| 'circular' \| 'skeleton', … }` | Loading with explicit kind override and per-instance prop overrides. |
  */
 export type TLoadingValue = boolean | number | TLoaderConfig;
+/*********************************************************
+ * TControlLoaderConfig / TControlLoadingValue
+ *
+ * @description
+ * Per-kind override config of a CONTROL (`OrigamBtn`, `OrigamSwitch`,
+ * `OrigamField` and its derivatives). A control that is mid-action keeps its
+ * label, its value and its input rendered: an action in flight is signalled
+ * by an indicator (spinner / strip), never by a placeholder that stands in
+ * for the control.
+ *
+ * @description
+ * So the `skeleton` member of `TLoaderConfig` is REFUSED at compile time
+ * here: `{ type: 'skeleton' }` is a type error on these components.
+ * Skeleton placeholders stay available on the containers whose content
+ * genuinely does not exist yet (Card, ExpansionPanel, DataTable).
+ *
+ * @description
+ * `TControlLoadingValue` is the `loading` prop value a control accepts:
+ * `TLoadingValue` minus the skeleton placeholder.
+ ********************************************************/
+export type TControlLoaderConfig = Exclude<TLoaderConfig, {
+    type: `${LOADER_KIND.SKELETON}`;
+}>;
+export type TControlLoadingValue = boolean | number | TControlLoaderConfig;