@wildo-ai/saas-frontend-lib 1.0.1

package/dist/esm/components/resources/skeleton/Section.d.ts

@@ -0,0 +1,165 @@
+import { type ReactNode } from 'react';
+import { SectionMode, DisplayDirection } from '@wildo-ai/zod-decorators';
+import type { ResponsiveChromeMode } from '@wildo-ai/zod-decorators';
+import type { GapSize } from '@wildo-ai/presets-components-models';
+import { GroupedSectionHostKind } from './Section.shared.js';
+/**
+ * Shared properties across all `SectionProps` variants.
+ */
+type SectionBaseProps = {
+    /**
+     * Structural ref — maps to i18n keys for title/description:
+     * - `resources.{type}.sections.{name}.title`
+     * - `resources.{type}.sections.{name}.description`
+     */
+    name: string;
+    /** Additional CSS classes for the section container. */
+    className?: string;
+    /**
+     * When `true`, renders a section-level save button (form context only).
+     */
+    saveable?: boolean;
+    /**
+     * Override chrome mode for all fields within this section.
+     * Cascade: field decorator → section chromeMode → form chromeMode → STACKED.
+     */
+    chromeMode?: ResponsiveChromeMode;
+    /** Whether this section is disabled. */
+    disabled?: boolean;
+    children: ReactNode;
+    /**
+     * Universal behavioral prop — initial focus state.
+     * - COLLAPSIBLE: whether the section starts expanded (default: true)
+     * - TABS/PILLS/VERTICAL_TABS: whether this section is the default active tab
+     * - ACCORDION: whether this section starts expanded
+     * - STEPPER: no effect (always sequential)
+     * @default true for COLLAPSIBLE, false for others
+     */
+    defaultFocus?: boolean;
+};
+type SectionProps_Default = SectionBaseProps & {
+    appearance?: SectionMode.DEFAULT;
+};
+type SectionProps_Card = SectionBaseProps & {
+    appearance: SectionMode.CARD;
+};
+type SectionProps_Ghost = SectionBaseProps & {
+    appearance: SectionMode.GHOST;
+};
+type SectionProps_Collapsible = SectionBaseProps & {
+    appearance: SectionMode.COLLAPSIBLE;
+};
+type SectionProps_Inline = SectionBaseProps & {
+    appearance: SectionMode.INLINE;
+    gap?: GapSize;
+};
+type SectionProps_Grid = SectionBaseProps & {
+    appearance: SectionMode.GRID;
+    columns?: number | 'auto';
+    gap?: GapSize;
+    minColumnWidth?: string;
+};
+type SectionProps_Columns = SectionBaseProps & {
+    appearance: SectionMode.COLUMNS;
+    columns?: number | 'auto';
+    gap?: GapSize;
+};
+type SectionProps_Tabs = SectionBaseProps & {
+    appearance: SectionMode.TABS;
+};
+type SectionProps_VerticalTabs = SectionBaseProps & {
+    appearance: SectionMode.VERTICAL_TABS;
+    navWidth?: string;
+};
+type SectionProps_Pills = SectionBaseProps & {
+    appearance: SectionMode.PILLS;
+};
+type SectionProps_Accordion = SectionBaseProps & {
+    appearance: SectionMode.ACCORDION;
+    allowMultiple?: boolean;
+};
+type SectionProps_Expandable = SectionBaseProps & {
+    appearance: SectionMode.EXPANDABLE;
+    initialVisibleCount?: number;
+};
+type SectionProps_Stepper = SectionBaseProps & {
+    appearance: SectionMode.STEPPER;
+    allowSkip?: boolean;
+    showProgress?: boolean;
+    orientation?: DisplayDirection;
+};
+type SectionProps_Timeline = SectionBaseProps & {
+    appearance: SectionMode.TIMELINE;
+};
+/**
+ * Discriminated union of all Section props.
+ * TypeScript narrows mode-specific parameters based on `appearance`.
+ *
+ * Solo modes (DEFAULT, CARD, GHOST, COLLAPSIBLE) render the section in place.
+ * Container modes (TABS, GRID, etc.) are grouped by the parent layout
+ * (`FormLayout`, `DisplayLayout`, or another section-aware host such as
+ * `CompositeLayout`) into a `ContentSectionContainer`.
+ */
+export type SectionProps = SectionProps_Default | SectionProps_Card | SectionProps_Ghost | SectionProps_Collapsible | SectionProps_Inline | SectionProps_Grid | SectionProps_Columns | SectionProps_Tabs | SectionProps_VerticalTabs | SectionProps_Pills | SectionProps_Accordion | SectionProps_Expandable | SectionProps_Stepper | SectionProps_Timeline;
+export interface GroupedSectionBodyProps {
+    hostKind: GroupedSectionHostKind;
+    sectionProps: Pick<SectionProps, 'name' | 'children' | 'chromeMode' | 'saveable' | 'className' | 'disabled'>;
+}
+/**
+ * Named section for form and display templates.
+ *
+ * The `appearance` prop determines rendering behavior:
+ *
+ * **Solo modes** (DEFAULT, CARD, GHOST, COLLAPSIBLE) render in place with
+ * appropriate chrome (fieldset, card, collapsible wrapper).
+ *
+ * **Container modes** (TABS, GRID, ACCORDION, etc.) are NOT rendered directly
+ * by this component — the parent layout (`FormLayout`, `DisplayLayout`, or
+ * another section-aware host) introspects its children, groups sections sharing
+ * the same container appearance, and renders them via
+ * `ContentSectionContainer`.
+ *
+ * Supports:
+ * - **Saveable sections** (form-only, section-level partial save)
+ * - **Section-level chromeMode override** (cascaded to child fields)
+ * - **defaultFocus** — initial active/expanded state
+ *
+ * @example Solo mode (renders in place):
+ * ```tsx
+ * <Section name="billing" appearance={SectionMode.CARD}>
+ *   <DisplayField name="plan" />
+ * </Section>
+ * ```
+ *
+ * @example Container mode (grouped by parent layout):
+ * ```tsx
+ * <FormLayout>
+ *   <Section name="general" appearance={SectionMode.TABS} defaultFocus>
+ *     <FormField name="name" />
+ *   </Section>
+ *   <Section name="advanced" appearance={SectionMode.TABS}>
+ *     <FormField name="config" />
+ *   </Section>
+ * </FormLayout>
+ * ```
+ */
+export declare function Section(props: SectionProps): ReactNode;
+export declare namespace Section {
+    var displayName: string;
+}
+export declare function GroupedSectionBody({ hostKind, sectionProps, }: GroupedSectionBodyProps): ReactNode;
+export interface SectionSaveButtonProps {
+    sectionName: string;
+    disabled?: boolean;
+}
+/**
+ * Section-level save button — only rendered inside form contexts.
+ * Extracted from Section to isolate the useFormContext() call, preventing
+ * crashes when Section is used inside display templates.
+ *
+ * Also used by `GroupedSectionContent` in `FormLayout.tsx` to render
+ * save buttons inside grouped (tabbed/accordion) container section panels.
+ */
+export declare function SectionSaveButton({ sectionName, disabled }: SectionSaveButtonProps): ReactNode;
+export {};
+//# sourceMappingURL=Section.d.ts.map

package/dist/esm/components/resources/skeleton/Section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Section.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/Section.tsx"],"names":[],"mappings":"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"}

package/dist/esm/components/resources/skeleton/Section.js

@@ -0,0 +1,206 @@
+'use client';
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useMemo, useState } from 'react';
+import { useFormContext } from 'react-hook-form';
+import { ErrorCustomMessageReference } from '@wildo-ai/saas-models';
+import { SectionMode } from '@wildo-ai/zod-decorators';
+import { ButtonSize, FrontendComponentType } from '@wildo-ai/presets-components-models';
+import { useOptionalFormTemplateContext } from '../../form/automated/FormTemplateContext.js';
+import { useOptionalDisplayTemplateContext } from '../../data-display/DisplayTemplateContext.js';
+import { FormChromeProvider } from '../../form/chromes/FormChromeContext.js';
+import { DisplayChromeProvider } from '../../data-display/chromes/DisplayChromeContext.js';
+import { FieldSet, FieldLegend } from '../../form/chromes/field.js';
+import { Button, ButtonVariants_Variant } from '../../../components/actions/button.js';
+import { Collapsible, CollapsibleTrigger, CollapsibleContent } from '../../../components/sections/collapsible.js';
+import { useI18n } from '../../../core/i18n/useI18n.js';
+import { FrontendResourceUtils } from '../../../core/resources/frontend-resource.utils.js';
+import { cn } from '../../../core/ui/cn.js';
+import { GroupedSectionHostKind } from './Section.shared.js';
+import { toDisplayChromeMode, isSoloMode } from './section-consolidation.shared.js';
+import { SectionFieldsContext, useOptionalSectionFieldsContext, } from './SectionFieldsContext.js';
+import { useOptionalSectionPresentationContext } from './SectionPresentationContext.js';
+/**
+ * Named section for form and display templates.
+ *
+ * The `appearance` prop determines rendering behavior:
+ *
+ * **Solo modes** (DEFAULT, CARD, GHOST, COLLAPSIBLE) render in place with
+ * appropriate chrome (fieldset, card, collapsible wrapper).
+ *
+ * **Container modes** (TABS, GRID, ACCORDION, etc.) are NOT rendered directly
+ * by this component — the parent layout (`FormLayout`, `DisplayLayout`, or
+ * another section-aware host) introspects its children, groups sections sharing
+ * the same container appearance, and renders them via
+ * `ContentSectionContainer`.
+ *
+ * Supports:
+ * - **Saveable sections** (form-only, section-level partial save)
+ * - **Section-level chromeMode override** (cascaded to child fields)
+ * - **defaultFocus** — initial active/expanded state
+ *
+ * @example Solo mode (renders in place):
+ * ```tsx
+ * <Section name="billing" appearance={SectionMode.CARD}>
+ *   <DisplayField name="plan" />
+ * </Section>
+ * ```
+ *
+ * @example Container mode (grouped by parent layout):
+ * ```tsx
+ * <FormLayout>
+ *   <Section name="general" appearance={SectionMode.TABS} defaultFocus>
+ *     <FormField name="name" />
+ *   </Section>
+ *   <Section name="advanced" appearance={SectionMode.TABS}>
+ *     <FormField name="config" />
+ *   </Section>
+ * </FormLayout>
+ * ```
+ */
+export function Section(props) {
+    const { name, className, saveable, chromeMode, children, defaultFocus = true, } = props;
+    const appearance = props.appearance ?? SectionMode.DEFAULT;
+    const formCtx = useOptionalFormTemplateContext();
+    const displayCtx = useOptionalDisplayTemplateContext();
+    const sectionPresentation = useOptionalSectionPresentationContext();
+    const presentationEntry = sectionPresentation?.sectionEntries?.[name];
+    const presentationTitle = presentationEntry?.icon
+        ? (_jsxs(_Fragment, { children: [_jsx("span", { className: "me-element inline-flex items-center", children: presentationEntry.icon }), presentationEntry.title ?? name] }))
+        : presentationEntry?.title;
+    const legend = formCtx?.sectionLabels?.[name]
+        ?? displayCtx?.sectionLabels?.[name]
+        ?? presentationTitle;
+    const description = formCtx?.sectionDescriptions?.[name]
+        ?? displayCtx?.sectionDescriptions?.[name]
+        ?? presentationEntry?.description;
+    const disabled = props.disabled ?? formCtx?.disabled;
+    const onSectionSave = formCtx?.onSectionSave;
+    const isSaveable = !!(saveable && onSectionSave);
+    const sectionHostKind = formCtx
+        ? GroupedSectionHostKind.FORM
+        : displayCtx
+            ? GroupedSectionHostKind.DISPLAY
+            : sectionPresentation
+                ? GroupedSectionHostKind.COMPOSITE
+                : GroupedSectionHostKind.DISPLAY;
+    if (sectionHostKind === GroupedSectionHostKind.COMPOSITE && chromeMode) {
+        throw FrontendResourceUtils.buildConfigurationError(ErrorCustomMessageReference.CONFIGURATION, {
+            component: 'Section',
+            message: 'Section chromeMode is only supported inside form/display section hosts. Composite-hosted sections must not declare chromeMode until a dedicated composite chrome contract exists.',
+            sectionName: name,
+        });
+    }
+    const [registeredFieldNames, setRegisteredFieldNames] = useState([]);
+    const registerField = useCallback((fieldName) => {
+        setRegisteredFieldNames((previous) => (previous.includes(fieldName) ? previous : [...previous, fieldName]));
+    }, []);
+    const unregisterField = useCallback((fieldName) => {
+        setRegisteredFieldNames((previous) => previous.filter((currentFieldName) => currentFieldName !== fieldName));
+    }, []);
+    const sectionFieldsContextValue = useMemo(() => ({
+        registerField,
+        unregisterField,
+        getRegisteredFields: () => registeredFieldNames,
+    }), [registerField, registeredFieldNames, unregisterField]);
+    // Container modes: render children as-is. The parent layout handles grouping.
+    if (!isSoloMode(appearance)) {
+        return _jsx(_Fragment, { children: children });
+    }
+    const content = (_jsxs(SectionFieldsContext.Provider, { value: sectionFieldsContextValue, children: [_jsx(SectionContentWithHostChrome, { hostKind: sectionHostKind, chromeMode: chromeMode, children: children }), isSaveable && _jsx(SectionSaveButton, { sectionName: name, disabled: disabled })] }));
+    const legendElement = legend && _jsx(FieldLegend, { children: legend });
+    const descriptionElement = description && (_jsx("p", { className: "text-muted-foreground text-sm", children: description }));
+    // COLLAPSIBLE solo mode
+    if (appearance === SectionMode.COLLAPSIBLE) {
+        return (_jsx(Collapsible, { defaultOpen: defaultFocus, children: _jsxs("div", { className: cn('space-y-field', className), "data-guidance-section": name, "data-composite-section": sectionHostKind === GroupedSectionHostKind.COMPOSITE ? name : undefined, children: [legendElement && (_jsx(CollapsibleTrigger, { asChild: true, children: _jsxs("button", { type: "button", className: "flex w-full items-center justify-between text-left", children: [legendElement, _jsx(CollapsibleChevron, {})] }) })), descriptionElement, _jsx(CollapsibleContent, { children: content })] }) }));
+    }
+    // GHOST solo mode
+    if (appearance === SectionMode.GHOST) {
+        return (_jsxs("div", { className: cn('space-y-field', className), "data-guidance-section": name, "data-composite-section": sectionHostKind === GroupedSectionHostKind.COMPOSITE ? name : undefined, children: [legendElement, descriptionElement, content] }));
+    }
+    // DEFAULT and CARD solo modes — rendered via FieldSet
+    return (_jsxs(FieldSet, { disabled: disabled, appearance: appearance, className: cn('space-y-field', className), "data-guidance-section": name, "data-composite-section": sectionHostKind === GroupedSectionHostKind.COMPOSITE ? name : undefined, children: [legendElement, descriptionElement, content] }));
+}
+Section.displayName = 'Section';
+export function GroupedSectionBody({ hostKind, sectionProps, }) {
+    const { children, chromeMode, saveable, name, className, disabled } = sectionProps;
+    const [registeredFieldNames, setRegisteredFieldNames] = useState([]);
+    const registerField = useCallback((fieldName) => {
+        setRegisteredFieldNames((previous) => (previous.includes(fieldName) ? previous : [...previous, fieldName]));
+    }, []);
+    const unregisterField = useCallback((fieldName) => {
+        setRegisteredFieldNames((previous) => previous.filter((currentFieldName) => currentFieldName !== fieldName));
+    }, []);
+    const sectionFieldsContextValue = useMemo(() => ({
+        registerField,
+        unregisterField,
+        getRegisteredFields: () => registeredFieldNames,
+    }), [registerField, registeredFieldNames, unregisterField]);
+    let content = children;
+    if (hostKind === GroupedSectionHostKind.FORM) {
+        content = (_jsxs(SectionFieldsContext.Provider, { value: sectionFieldsContextValue, children: [_jsx(SectionContentWithHostChrome, { hostKind: hostKind, chromeMode: chromeMode, children: children }), saveable && _jsx(SectionSaveButton, { sectionName: name, disabled: disabled })] }));
+    }
+    else {
+        content = (_jsx(SectionContentWithHostChrome, { hostKind: hostKind, chromeMode: chromeMode, children: children }));
+    }
+    return (_jsx("div", { className: className ? `space-y-field ${className}` : 'space-y-field', "data-guidance-section": name, "data-composite-section": hostKind === GroupedSectionHostKind.COMPOSITE ? name : undefined, children: content }));
+}
+function SectionContentWithHostChrome({ hostKind, chromeMode, children, }) {
+    if (!chromeMode) {
+        return children;
+    }
+    if (hostKind === GroupedSectionHostKind.FORM) {
+        return _jsx(FormChromeProvider, { sectionChromeMode: chromeMode, children: children });
+    }
+    if (hostKind === GroupedSectionHostKind.DISPLAY) {
+        return _jsx(DisplayChromeProvider, { sectionChromeMode: toDisplayChromeMode(chromeMode), children: children });
+    }
+    return children;
+}
+// =============================================================================
+// CollapsibleChevron
+// =============================================================================
+function CollapsibleChevron() {
+    return (_jsx("svg", { className: "h-4 w-4 shrink-0 text-muted-foreground transition-transform duration-200 [[data-state=open]_&]:rotate-180", xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("path", { d: "m6 9 6 6 6-6" }) }));
+}
+/**
+ * Section-level save button — only rendered inside form contexts.
+ * Extracted from Section to isolate the useFormContext() call, preventing
+ * crashes when Section is used inside display templates.
+ *
+ * Also used by `GroupedSectionContent` in `FormLayout.tsx` to render
+ * save buttons inside grouped (tabbed/accordion) container section panels.
+ */
+export function SectionSaveButton({ sectionName, disabled }) {
+    const form = useFormContext();
+    const ctx = useOptionalFormTemplateContext();
+    const sectionFields = useOptionalSectionFieldsContext();
+    const [isSaving, setIsSaving] = useState(false);
+    const { tComponent } = useI18n({
+        component: FrontendComponentType.LOW_LEVEL_FORM_MESSAGE,
+    });
+    const onSectionSave = ctx?.onSectionSave;
+    if (!onSectionSave)
+        return null;
+    const fieldNames = Array.from(new Set(sectionFields?.getRegisteredFields() ?? []));
+    const handleSave = async () => {
+        if (fieldNames.length === 0) {
+            return;
+        }
+        const isValid = await form.trigger(fieldNames);
+        if (!isValid) {
+            return;
+        }
+        setIsSaving(true);
+        try {
+            const formValues = form.getValues();
+            await onSectionSave(sectionName, fieldNames, formValues);
+        }
+        finally {
+            setIsSaving(false);
+        }
+    };
+    const savingLabel = tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'sectionSaving');
+    const saveLabel = tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'sectionSave');
+    return (_jsx("div", { className: "flex justify-end pt-item", children: _jsx(Button, { type: "button", variant: ButtonVariants_Variant.SECONDARY, size: ButtonSize.SM, onClick: handleSave, disabled: disabled || isSaving || fieldNames.length === 0, children: isSaving ? savingLabel : saveLabel }) }));
+}
+//# sourceMappingURL=Section.js.map

package/dist/esm/components/resources/skeleton/Section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Section.js","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/Section.tsx"],"names":[],"mappings":"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"}

package/dist/esm/components/resources/skeleton/Section.shared.d.ts

@@ -0,0 +1,6 @@
+export declare enum GroupedSectionHostKind {
+    FORM = "form",
+    DISPLAY = "display",
+    COMPOSITE = "composite"
+}
+//# sourceMappingURL=Section.shared.d.ts.map

package/dist/esm/components/resources/skeleton/Section.shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Section.shared.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/Section.shared.ts"],"names":[],"mappings":"AAAA,oBAAY,sBAAsB;IAChC,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,SAAS,cAAc;CACxB"}

package/dist/esm/components/resources/skeleton/Section.shared.js

@@ -0,0 +1,7 @@
+export var GroupedSectionHostKind;
+(function (GroupedSectionHostKind) {
+    GroupedSectionHostKind["FORM"] = "form";
+    GroupedSectionHostKind["DISPLAY"] = "display";
+    GroupedSectionHostKind["COMPOSITE"] = "composite";
+})(GroupedSectionHostKind || (GroupedSectionHostKind = {}));
+//# sourceMappingURL=Section.shared.js.map

package/dist/esm/components/resources/skeleton/Section.shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Section.shared.js","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/Section.shared.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,sBAIX;AAJD,WAAY,sBAAsB;IAChC,uCAAa,CAAA;IACb,6CAAmB,CAAA;IACnB,iDAAuB,CAAA;AACzB,CAAC,EAJW,sBAAsB,KAAtB,sBAAsB,QAIjC"}

package/dist/esm/components/resources/skeleton/SectionFieldsContext.d.ts

@@ -0,0 +1,13 @@
+export interface SectionFieldsContextValue {
+    registerField: (name: string) => void;
+    unregisterField: (name: string) => void;
+    getRegisteredFields: () => string[];
+}
+export declare const SectionFieldsContext: import("react").Context<SectionFieldsContextValue>;
+/**
+ * Hook for `FormField` to register with the enclosing saveable section so the
+ * section save action can validate and submit only the fields it actually owns.
+ */
+export declare function useSectionFieldRegistration(fieldName: string): void;
+export declare function useOptionalSectionFieldsContext(): SectionFieldsContextValue | null;
+//# sourceMappingURL=SectionFieldsContext.d.ts.map

package/dist/esm/components/resources/skeleton/SectionFieldsContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SectionFieldsContext.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SectionFieldsContext.tsx"],"names":[],"mappings":"AAEA,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,mBAAmB,EAAE,MAAM,MAAM,EAAE,CAAC;CACrC;AAED,eAAO,MAAM,oBAAoB,oDAAwD,CAAC;AAE1F;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAQnE;AAED,wBAAgB,+BAA+B,IAAI,yBAAyB,GAAG,IAAI,CAElF"}

package/dist/esm/components/resources/skeleton/SectionFieldsContext.js

@@ -0,0 +1,19 @@
+import { createContext, useContext, useEffect } from 'react';
+export const SectionFieldsContext = createContext(null);
+/**
+ * Hook for `FormField` to register with the enclosing saveable section so the
+ * section save action can validate and submit only the fields it actually owns.
+ */
+export function useSectionFieldRegistration(fieldName) {
+    const ctx = useContext(SectionFieldsContext);
+    useEffect(() => {
+        ctx?.registerField(fieldName);
+        return () => {
+            ctx?.unregisterField(fieldName);
+        };
+    }, [ctx, fieldName]);
+}
+export function useOptionalSectionFieldsContext() {
+    return useContext(SectionFieldsContext);
+}
+//# sourceMappingURL=SectionFieldsContext.js.map

package/dist/esm/components/resources/skeleton/SectionFieldsContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SectionFieldsContext.js","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SectionFieldsContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAQ7D,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAAmC,IAAI,CAAC,CAAC;AAE1F;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,SAAiB;IAC3D,MAAM,GAAG,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAC7C,SAAS,CAAC,GAAG,EAAE;QACb,GAAG,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;QAC9B,OAAO,GAAG,EAAE;YACV,GAAG,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,+BAA+B;IAC7C,OAAO,UAAU,CAAC,oBAAoB,CAAC,CAAC;AAC1C,CAAC"}

package/dist/esm/components/resources/skeleton/SectionPresentationContext.d.ts

@@ -0,0 +1,15 @@
+import React, { type ReactNode } from 'react';
+export interface SectionPresentationEntry {
+    title?: ReactNode;
+    description?: ReactNode;
+    icon?: ReactNode;
+}
+export interface SectionPresentationContextValue {
+    sectionEntries?: Record<string, SectionPresentationEntry>;
+}
+export declare function SectionPresentationProvider({ value, children, }: {
+    value: SectionPresentationContextValue;
+    children: ReactNode;
+}): React.JSX.Element;
+export declare function useOptionalSectionPresentationContext(): SectionPresentationContextValue | null;
+//# sourceMappingURL=SectionPresentationContext.d.ts.map

package/dist/esm/components/resources/skeleton/SectionPresentationContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SectionPresentationContext.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SectionPresentationContext.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAElF,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,+BAA+B;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;CAC3D;AAID,wBAAgB,2BAA2B,CAAC,EAC1C,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,+BAA+B,CAAC;IACvC,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAQpB;AAED,wBAAgB,qCAAqC,IAAI,+BAA+B,GAAG,IAAI,CAE9F"}

package/dist/esm/components/resources/skeleton/SectionPresentationContext.js

@@ -0,0 +1,12 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo } from 'react';
+const SectionPresentationContext = createContext(null);
+export function SectionPresentationProvider({ value, children, }) {
+    const contextValue = useMemo(() => value, [value]);
+    return (_jsx(SectionPresentationContext.Provider, { value: contextValue, children: children }));
+}
+export function useOptionalSectionPresentationContext() {
+    return useContext(SectionPresentationContext);
+}
+//# sourceMappingURL=SectionPresentationContext.js.map

package/dist/esm/components/resources/skeleton/SectionPresentationContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SectionPresentationContext.js","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SectionPresentationContext.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAkB,MAAM,OAAO,CAAC;AAYlF,MAAM,0BAA0B,GAAG,aAAa,CAAyC,IAAI,CAAC,CAAC;AAE/F,MAAM,UAAU,2BAA2B,CAAC,EAC1C,KAAK,EACL,QAAQ,GAIT;IACC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEnD,OAAO,CACL,KAAC,0BAA0B,CAAC,QAAQ,IAAC,KAAK,EAAE,YAAY,YACrD,QAAQ,GAC2B,CACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qCAAqC;IACnD,OAAO,UAAU,CAAC,0BAA0B,CAAC,CAAC;AAChD,CAAC"}

package/dist/esm/components/resources/skeleton/ShowWhen.d.ts

@@ -0,0 +1,47 @@
+import type { ReactNode } from 'react';
+import type { ShowWhenOperator } from '@wildo-ai/zod-decorators';
+export interface ShowWhenProps {
+    /**
+     * Field name to watch for changes (resolved relative to current scope).
+     */
+    field: string;
+    /**
+     * Value to compare against. Used with `EQUALS` (default) and `NOT_EQUALS` operators.
+     * Ignored for `EXISTS` / `NOT_EXISTS`.
+     */
+    equals?: unknown;
+    /**
+     * Comparison operator.
+     * @default ShowWhenOperator.EQUALS
+     */
+    operator?: ShowWhenOperator;
+    /**
+     * How to combine multiple `<ShowWhen>` wrappers (when nested).
+     * @default 'and'
+     */
+    combineWith?: 'and' | 'or';
+    children: ReactNode;
+}
+/**
+ * Conditional visibility: watches a field and shows/hides children.
+ *
+ * When the condition is **false**, children are unmounted (not just hidden)
+ * and their form fields are **unregistered** from React Hook Form so they
+ * don't contribute to validation or submit data (F-9).
+ *
+ * @example
+ * ```tsx
+ * <ShowWhen field="hasAddress" equals={true}>
+ *   <ObjectScope name="address">
+ *     <FormField name="street" />
+ *     <FormField name="city" />
+ *   </ObjectScope>
+ * </ShowWhen>
+ *
+ * <ShowWhen field="role" operator={ShowWhenOperator.IN} equals={['admin', 'manager']}>
+ *   <FormField name="permissions" />
+ * </ShowWhen>
+ * ```
+ */
+export declare function ShowWhen({ children }: ShowWhenProps): ReactNode;
+//# sourceMappingURL=ShowWhen.d.ts.map

package/dist/esm/components/resources/skeleton/ShowWhen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShowWhen.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/ShowWhen.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B;;;OAGG;IACH,WAAW,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,CAAC,EAAE,QAAQ,EAAE,EAAE,aAAa,GAAG,SAAS,CAE/D"}

package/dist/esm/components/resources/skeleton/ShowWhen.js

@@ -0,0 +1,27 @@
+'use client';
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Conditional visibility: watches a field and shows/hides children.
+ *
+ * When the condition is **false**, children are unmounted (not just hidden)
+ * and their form fields are **unregistered** from React Hook Form so they
+ * don't contribute to validation or submit data (F-9).
+ *
+ * @example
+ * ```tsx
+ * <ShowWhen field="hasAddress" equals={true}>
+ *   <ObjectScope name="address">
+ *     <FormField name="street" />
+ *     <FormField name="city" />
+ *   </ObjectScope>
+ * </ShowWhen>
+ *
+ * <ShowWhen field="role" operator={ShowWhenOperator.IN} equals={['admin', 'manager']}>
+ *   <FormField name="permissions" />
+ * </ShowWhen>
+ * ```
+ */
+export function ShowWhen({ children }) {
+    return _jsx(_Fragment, { children: children });
+}
+//# sourceMappingURL=ShowWhen.js.map

package/dist/esm/components/resources/skeleton/ShowWhen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShowWhen.js","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/ShowWhen.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AA4Bb;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAE,QAAQ,EAAiB;IAClD,OAAO,4BAAG,QAAQ,GAAI,CAAC;AACzB,CAAC"}

package/dist/esm/components/resources/skeleton/SubmitButton.d.ts

@@ -0,0 +1,38 @@
+import type { ReactNode } from 'react';
+export interface SubmitButtonProps {
+    /** Label for the submit button. Falls back to i18n default ("Save"). */
+    label?: string;
+    /** Label shown while the form is submitting. Falls back to `label` (no visual change). */
+    submittingLabel?: string;
+    /** Additional CSS classes for the button container. */
+    className?: string;
+    /** When true, the button stretches to full container width. */
+    fullWidth?: boolean;
+}
+/**
+ * Form submit action slot — placed by the template author where desired.
+ *
+ * Labels are resolved from explicit props, falling back to i18n ("Save").
+ * Templates pass labels directly — no context dependency for label text.
+ *
+ * Disabled when `formState.isSubmitting` or `FormTemplateContext.disabled` is true.
+ * (FormTemplateContext is used only for the disabled flag — a skeleton-layer concern.)
+ *
+ * In wizard mode, the wizard layout manages its own submit/next buttons,
+ * so this component is only used in non-wizard templates.
+ *
+ * @example
+ * ```tsx
+ * <FormLayout>
+ *   <Section name="general">
+ *     <FormField name="title" />
+ *   </Section>
+ *   <SubmitButton label="Create" submittingLabel="Creating..." fullWidth />
+ * </FormLayout>
+ * ```
+ */
+export declare function SubmitButton({ className, label, submittingLabel, fullWidth }: SubmitButtonProps): ReactNode;
+export declare namespace SubmitButton {
+    var displayName: string;
+}
+//# sourceMappingURL=SubmitButton.d.ts.map

package/dist/esm/components/resources/skeleton/SubmitButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubmitButton.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/SubmitButton.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAQvC,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,EAAE,iBAAiB,GAAG,SAAS,CAyB3G;yBAzBe,YAAY"}