@cwellt_software/cwellt-reactjs-lib 1.5.2 → 1.5.4

package/dist/src/storybook/inputStoryArgs.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Flat, self-explanatory story controls for the object props every input shares
+ * (alignProps, labelProps, feedback, buttonProps), and the translation back to the real props.
+ *
+ * Storybook's object editor shows keys but neither the valid values nor what they do, so the stories
+ * expose one control per meaningful field instead and hide the raw object props from the controls
+ * (they stay in the docs table with their real type). Reuse from any input story:
+ *
+ *   args: { ...inputStoryDefaults, placeholder: "..." },
+ *   argTypes: { ...inputStoryArgTypes, ...hiddenObjectPropControls },
+ *   render: (args) => <CwSomething {...toInputProps(args)} />
+ */
+import type { ArgTypes } from "@storybook/react-vite";
+import type { CwInputFeedback } from "../common/interfaces/CwFormTypes";
+import type { CwButtonProps } from "../components/control/action/button/CwButton";
+import type { CwLabelProps } from "../components/display/text/label/CwLabel";
+import type { CwAlignProps } from "../components/layout/align/CwAlign";
+export declare const LABEL_WIDTHS: readonly ["6rem", "7rem", "8rem", "9rem", "10rem", "12rem", "15rem"];
+declare const FEEDBACK_TYPES: readonly ["none", "danger", "warning", "success", "info", "neutral"];
+declare const ALIGN_ITEMS: readonly ["stretch", "center", "flex-start", "flex-end"];
+export interface InputStoryArgs {
+    direction: "row" | "column";
+    alignItems: (typeof ALIGN_ITEMS)[number];
+    labelText: string;
+    labelWidth: (typeof LABEL_WIDTHS)[number];
+    feedbackType: (typeof FEEDBACK_TYPES)[number];
+    feedbackMessage: string;
+    button: "none" | "text" | "icon";
+    buttonVariant: "solid" | "outline" | "ghost";
+    buttonColor: "primary" | "danger" | "neutral";
+}
+export declare const inputStoryDefaults: InputStoryArgs;
+export declare const inputStoryArgTypes: ArgTypes<InputStoryArgs>;
+/** The real object props keep their row in the docs table but get no control of their own. */
+export declare const hiddenObjectPropControls: {
+    alignProps: {
+        control: false;
+    };
+    labelProps: {
+        control: false;
+    };
+    feedback: {
+        control: false;
+    };
+    buttonProps: {
+        control: false;
+    };
+};
+export interface InputObjectProps {
+    alignProps: CwAlignProps | undefined;
+    labelProps: CwLabelProps | undefined;
+    feedback: CwInputFeedback | undefined;
+    buttonProps: CwButtonProps | undefined;
+}
+/** Docs "Show code" / Code panel: the real props, minus the component defaults (see storySource). */
+export declare function inputStorySource(componentName: string, componentDefaults?: Record<string, unknown>): {
+    docs: {
+        source: {
+            transform: (_code: string, storyContext: {
+                args: Record<string, unknown>;
+            }) => string;
+        };
+    };
+};
+/** Translates the flat story args into the component's object props and drops the flat keys. */
+export declare function toInputProps<T extends Partial<InputStoryArgs>>(args: T): Omit<T, keyof InputStoryArgs> & InputObjectProps;
+export {};
+//# sourceMappingURL=inputStoryArgs.d.ts.map

package/dist/src/storybook/inputStoryArgs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputStoryArgs.d.ts","sourceRoot":"","sources":["../../../src/storybook/inputStoryArgs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAGvE,eAAO,MAAM,YAAY,sEAAuE,CAAC;AACjG,QAAA,MAAM,cAAc,sEAAuE,CAAC;AAC5F,QAAA,MAAM,WAAW,0DAA2D,CAAC;AAE7E,MAAM,WAAW,cAAc;IAC9B,SAAS,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC5B,UAAU,EAAE,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;IAC1C,YAAY,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;IAC9C,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,aAAa,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;IAC7C,WAAW,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC9C;AAED,eAAO,MAAM,kBAAkB,EAAE,cAUhC,CAAC;AAOF,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,cAAc,CAUvD,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;CAKjB,CAAC;AAErB,MAAM,WAAW,gBAAgB;IAChC,UAAU,EAAE,YAAY,GAAG,SAAS,CAAC;IACrC,UAAU,EAAE,YAAY,GAAG,SAAS,CAAC;IACrC,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAC;IACtC,WAAW,EAAE,aAAa,GAAG,SAAS,CAAC;CACvC;AAED,qGAAqG;AACrG,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,iBAAiB,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;;;;;;;;EAEtG;AAED,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,CAAC,SAAS,OAAO,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,MAAM,cAAc,CAAC,GAAG,gBAAgB,CAwBzH"}

package/dist/src/storybook/layoutStoryArgs.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Flat story controls for the `layout` prop (CwLayoutProps) shared by CwNote, CwCard, CwRadioGroup,
+ * CwCheckboxGroup, CwKeyValueList..., and the translation back to the object. "default" means the
+ * field is not set, so the component keeps its own behaviour. Reuse from any story:
+ *
+ *   args: { ...layoutStoryDefaults, ... },
+ *   argTypes: { ...layoutStoryArgTypes, ...hiddenLayoutPropControls },
+ *   render: (args) => <CwSomething {...toLayoutProps(args)} />,
+ *   parameters: layoutStorySource("CwSomething"),
+ */
+import type { ArgTypes } from "@storybook/react-vite";
+import type { CwLayoutProps } from "../common/interfaces/CwLayoutProps";
+declare const DEFAULT = "default";
+declare const DIRECTIONS: readonly ["default", "row", "column"];
+declare const ALIGNS: readonly ["default", "start", "center", "end", "stretch"];
+declare const JUSTIFIES: readonly ["default", "start", "center", "end", "between", "around"];
+declare const GAPS: readonly ["default", "none", "small", "medium", "large"];
+export interface LayoutStoryArgs {
+    layoutDirection: (typeof DIRECTIONS)[number];
+    layoutAlign: (typeof ALIGNS)[number];
+    layoutJustify: (typeof JUSTIFIES)[number];
+    layoutGap: (typeof GAPS)[number];
+}
+export declare const layoutStoryDefaults: LayoutStoryArgs;
+/** The values a component actually styles, per layout field. A field left out gets no control (not supported yet). */
+export interface SupportedLayout {
+    direction?: readonly Exclude<(typeof DIRECTIONS)[number], typeof DEFAULT>[];
+    align?: readonly Exclude<(typeof ALIGNS)[number], typeof DEFAULT>[];
+    justify?: readonly Exclude<(typeof JUSTIFIES)[number], typeof DEFAULT>[];
+    gap?: readonly Exclude<(typeof GAPS)[number], typeof DEFAULT>[];
+}
+/**
+ * Controls for the layout fields the component styles. CwLayoutProps declares more than most
+ * components implement (CwNote has no `justify`, no `align: stretch`), and a radio that does
+ * nothing is worse than no radio: pass what the component's css handles.
+ */
+export declare function layoutStoryArgTypesFor(supported: SupportedLayout): ArgTypes<LayoutStoryArgs>;
+/** Every field with every value, for a component that implements CwLayoutProps in full. */
+export declare const layoutStoryArgTypes: ArgTypes<LayoutStoryArgs>;
+/** The real `layout` prop keeps its row in the docs table but gets no control of its own. */
+export declare const hiddenLayoutPropControls: {
+    layout: {
+        control: false;
+    };
+};
+/** Translates the flat story args into `layout` (undefined when every field is left at default) and drops the flat keys. */
+export declare function toLayoutProps<T extends Partial<LayoutStoryArgs>>(args: T): Omit<T, keyof LayoutStoryArgs> & {
+    layout: CwLayoutProps | undefined;
+};
+export declare function layoutStorySource(componentName: string, componentDefaults?: Record<string, unknown>): {
+    docs: {
+        source: {
+            transform: (_code: string, storyContext: {
+                args: Record<string, unknown>;
+            }) => string;
+        };
+    };
+};
+export {};
+//# sourceMappingURL=layoutStoryArgs.d.ts.map

package/dist/src/storybook/layoutStoryArgs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layoutStoryArgs.d.ts","sourceRoot":"","sources":["../../../src/storybook/layoutStoryArgs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAGxE,QAAA,MAAM,OAAO,YAAY,CAAC;AAC1B,QAAA,MAAM,UAAU,uCAAsC,CAAC;AACvD,QAAA,MAAM,MAAM,2DAA0D,CAAC;AACvE,QAAA,MAAM,SAAS,qEAAoE,CAAC;AACpF,QAAA,MAAM,IAAI,0DAAyD,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC/B,eAAe,EAAE,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;IAC7C,WAAW,EAAE,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;IACrC,aAAa,EAAE,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;IAC1C,SAAS,EAAE,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;CACjC;AAED,eAAO,MAAM,mBAAmB,EAAE,eAKjC,CAAC;AAIF,sHAAsH;AACtH,MAAM,WAAW,eAAe;IAC/B,SAAS,CAAC,EAAE,SAAS,OAAO,CAAC,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,OAAO,CAAC,EAAE,CAAC;IAC5E,KAAK,CAAC,EAAE,SAAS,OAAO,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,OAAO,CAAC,EAAE,CAAC;IACpE,OAAO,CAAC,EAAE,SAAS,OAAO,CAAC,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,OAAO,CAAC,EAAE,CAAC;IACzE,GAAG,CAAC,EAAE,SAAS,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,OAAO,CAAC,EAAE,CAAC;CAChE;AASD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC,CAW5F;AAED,2FAA2F;AAC3F,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,eAAe,CAAuC,CAAC;AAElG,6FAA6F;AAC7F,eAAO,MAAM,wBAAwB;;;;CAEjB,CAAC;AAErB,4HAA4H;AAC5H,wBAAgB,aAAa,CAAC,CAAC,SAAS,OAAO,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,MAAM,eAAe,CAAC,GAAG;IAAE,MAAM,EAAE,aAAa,GAAG,SAAS,CAAA;CAAE,CAYjJ;AAED,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,iBAAiB,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;;;;;;;;EAEvG"}

package/dist/src/storybook/storySource.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Docs "Show code" / Code panel for stories whose flat controls are translated into real props.
+ * The snippet is what a consumer would write: real props, strings quoted, objects in braces,
+ * nothing that is undefined, a function, a React element, or equal to the component's default.
+ */
+/** Serializes props as consumer JSX. */
+export declare function propsToJsx(componentName: string, props: Record<string, unknown>): string;
+/**
+ * Storybook `parameters` for a story: `mapArgs` turns the story args into the component props
+ * (the same function the story's `render` uses), `componentDefaults` lists prop values the
+ * component already assumes, so they are left out of the snippet.
+ */
+export declare function storySource(componentName: string, mapArgs: (args: Record<string, unknown>) => Record<string, unknown>, componentDefaults?: Record<string, unknown>): {
+    docs: {
+        source: {
+            transform: (_code: string, storyContext: {
+                args: Record<string, unknown>;
+            }) => string;
+        };
+    };
+};
+//# sourceMappingURL=storySource.d.ts.map

package/dist/src/storybook/storySource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storySource.d.ts","sourceRoot":"","sources":["../../../src/storybook/storySource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wCAAwC;AACxC,wBAAgB,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAUxF;AAMD;;;;GAIG;AACH,wBAAgB,WAAW,CAC1B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,iBAAiB,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;;;+BAKzB,MAAM,gBAAgB;gBAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;aAAE;;;EAW7E"}

package/dist/test/components/control/input/weekday/weekdayNames.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=weekdayNames.test.d.ts.map

package/dist/test/components/control/input/weekday/weekdayNames.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weekdayNames.test.d.ts","sourceRoot":"","sources":["../../../../../../test/components/control/input/weekday/weekdayNames.test.ts"],"names":[],"mappings":""}

package/dist/test/components/control/input/weekday/weekdays.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=weekdays.test.d.ts.map

package/dist/test/components/control/input/weekday/weekdays.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weekdays.test.d.ts","sourceRoot":"","sources":["../../../../../../test/components/control/input/weekday/weekdays.test.ts"],"names":[],"mappings":""}

package/dist/test/components/display/text/badge/badgeContent.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=badgeContent.test.d.ts.map

package/dist/test/components/display/text/badge/badgeContent.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"badgeContent.test.d.ts","sourceRoot":"","sources":["../../../../../../test/components/display/text/badge/badgeContent.test.ts"],"names":[],"mappings":""}

package/dist/test/storybook/inputStoryArgs.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inputStoryArgs.test.d.ts.map

package/dist/test/storybook/inputStoryArgs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputStoryArgs.test.d.ts","sourceRoot":"","sources":["../../../test/storybook/inputStoryArgs.test.ts"],"names":[],"mappings":""}

package/dist/test/storybook/layoutStoryArgs.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=layoutStoryArgs.test.d.ts.map

package/dist/test/storybook/layoutStoryArgs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layoutStoryArgs.test.d.ts","sourceRoot":"","sources":["../../../test/storybook/layoutStoryArgs.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cwellt_software/cwellt-reactjs-lib",
-	"version": "1.5.2",
+	"version": "1.5.4",
 	"type": "module",
 	"files": [
 		"dist"