@prolibu-suite/cobalt-form-vue 0.1.3 → 2.0.0

package/dist/utils/fieldPath.d.ts

@@ -0,0 +1,29 @@
+import type { FieldDescriptor } from '@prolibu-suite/cobalt-form-core';
+import type { UseFormReturn } from '../composables/useForm';
+/**
+ * Stable state key for a field: its dot-path from the form root. Top-level
+ * descriptors have `path === name` (or no `path` at all), so this is fully
+ * backward-compatible with the old `name`-keyed state maps.
+ */
+export declare function fieldKey(f: FieldDescriptor): string;
+/**
+ * Depth-first walk over fields **and their nested object children** (the
+ * nested descriptors live in `FieldDescriptor.children`).
+ */
+export declare function walkFields(fields: FieldDescriptor[], visit: (f: FieldDescriptor) => void): void;
+/** Read a value by dot-path from the form's values snapshot. */
+export declare function getValueAtPath(values: Record<string, any>, path: string): any;
+/**
+ * Write a value by dot-path through the form controller. The controller only
+ * accepts top-level names, so nested paths write via their top-level parent
+ * (`setValue(root, { ...root, child: v })`) — the same flow FieldObject uses
+ * when a child emits its full object up to the parent.
+ *
+ * Returns the `{ name, value }` pair actually written (the root field), so
+ * callers can emit `change` with the host-visible payload.
+ */
+export declare function setValueAtPath(form: UseFormReturn, path: string, value: any): {
+    name: string;
+    value: any;
+};
+//# sourceMappingURL=fieldPath.d.ts.map

package/dist/utils/fieldPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldPath.d.ts","sourceRoot":"","sources":["../../src/utils/fieldPath.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,eAAe,EAAE,EACzB,KAAK,EAAE,CAAC,CAAC,EAAE,eAAe,KAAK,IAAI,GAClC,IAAI,CAKN;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,CAI7E;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,GAAG,GACT;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,CAU9B"}

package/dist/utils/formContext.d.ts

@@ -0,0 +1,84 @@
+import type { InjectionKey, Ref } from 'vue';
+import type { UploadedFileRef } from '@prolibu-suite/cobalt-form-core';
+import type { FileItem } from '../components/fields/FieldFile.vue';
+import type { RefState } from '../components/fields/FieldRef.vue';
+/**
+ * Nesting depth of an object fieldset within the form tree. Top-level fields
+ * inject the default `0`; each `FieldObject` provides `depth + 1` to its
+ * descendants so nested objects can render a progressive left indentation.
+ */
+export declare const FORM_DEPTH: InjectionKey<number>;
+/**
+ * When true, every object fieldset starts expanded regardless of
+ * `computeInitialOpen`. Provided once by `CoFormRenderer` (via its `expandAll`
+ * prop) and read by every nested `FieldObject`. Defaults to a `false` ref when
+ * no provider is present.
+ */
+export declare const FORM_EXPAND_ALL: InjectionKey<Ref<boolean>>;
+/**
+ * Effective grid column count inherited from the enclosing form/fieldset. The
+ * top-level `CoFormRenderer` provides its own column count; each `FieldObject`
+ * uses it as the default for its children grid (unless the schema overrides it
+ * via `originalAttrs.columns`) and re-provides its resolved value so deeper
+ * objects inherit too. Lets a single-column form (e.g. preferences) cascade to
+ * every nested object. Defaults to a `ref(2)` when no provider is present.
+ */
+export declare const FORM_COLUMNS: InjectionKey<Ref<number>>;
+/**
+ * Validation errors keyed by full field dot-path (e.g.
+ * `stageRules.restrictProposalViewToStages`). Provided once by `CoFormRenderer`
+ * so nested `FieldObject` children can look up their own error by `path`.
+ */
+export declare const FORM_ERRORS: InjectionKey<Ref<Record<string, string[]>>>;
+/**
+ * Touched map keyed by full field dot-path. A field shows its error only once
+ * its path is touched. Provided by `CoFormRenderer`.
+ */
+export declare const FORM_TOUCHED: InjectionKey<Ref<Record<string, boolean>>>;
+/**
+ * Marks a field path as touched (on blur). Provided by `CoFormRenderer` so
+ * nested children can flag themselves touched by their `path`.
+ */
+export declare const FORM_TOUCH: InjectionKey<(path: string) => void>;
+/** Event handlers for a single ref field, resolved by path. */
+export interface RefFieldHandlers {
+    search: (query: string) => void;
+    loadMore: () => void;
+    open: () => void;
+}
+/**
+ * Ref-field machine (options/selected-display/paging), keyed by full field
+ * dot-path. Provided once by `CoFormRenderer` so nested `FieldObject` children
+ * of kind `ref` can read their state and forward their events — the resolvers
+ * live at the form root, not per fieldset.
+ */
+export interface RefFieldsContext {
+    stateFor: (path: string) => RefState | undefined;
+    handlersFor: (path: string) => RefFieldHandlers;
+}
+export declare const FORM_REF_FIELDS: InjectionKey<RefFieldsContext>;
+/** Event handlers for a single file field, resolved by path. */
+export interface FileFieldHandlers {
+    upload: (payload: {
+        files: File[];
+        tempIds: string[];
+    }) => void;
+    removeFile: (idOrTempId: string) => void;
+    reorder: (keys: string[]) => void;
+    addFiles: (refs: UploadedFileRef[]) => void;
+    copyUrl: (payload: {
+        id: string;
+        url: string;
+    }) => void;
+}
+/**
+ * File-field machine (upload/remove/reorder UI state), keyed by full field
+ * dot-path. Provided once by `CoFormRenderer` for nested `file` children —
+ * same rationale as {@link FORM_REF_FIELDS}.
+ */
+export interface FileFieldsContext {
+    stateFor: (path: string) => FileItem[] | undefined;
+    handlersFor: (path: string) => FileFieldHandlers;
+}
+export declare const FORM_FILE_FIELDS: InjectionKey<FileFieldsContext>;
+//# sourceMappingURL=formContext.d.ts.map

package/dist/utils/formContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formContext.d.ts","sourceRoot":"","sources":["../../src/utils/formContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,YAAY,CAAC,MAAM,CAA2B,CAAC;AAExE;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAgC,CAAC;AAExF;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,EAAE,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAA6B,CAAC;AAEjF;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAA4B,CAAC;AAEjG;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAA6B,CAAC;AAElG;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAA2B,CAAC;AAExF,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,GAAG,SAAS,CAAC;IACjD,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,gBAAgB,CAAC;CACjD;AACD,eAAO,MAAM,eAAe,EAAE,YAAY,CAAC,gBAAgB,CAAgC,CAAC;AAE5F,gEAAgE;AAChE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,IAAI,CAAC;IAChE,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAClC,QAAQ,EAAE,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,IAAI,CAAC;IAC5C,OAAO,EAAE,CAAC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACzD;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,EAAE,GAAG,SAAS,CAAC;IACnD,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,iBAAiB,CAAC;CAClD;AACD,eAAO,MAAM,gBAAgB,EAAE,YAAY,CAAC,iBAAiB,CAAiC,CAAC"}

package/dist/utils/gridCell.d.ts

@@ -0,0 +1,28 @@
+import type { FieldDescriptor } from '@prolibu-suite/cobalt-form-core';
+export type FormGap = 'sm' | 'md' | 'lg';
+/** uiComs that traditionally render full-width in Prolibu schemas. Single source
+ *  of truth (used by both CoFormRenderer and FieldObject). */
+export declare const FULL_WIDTH_UICOMS: Set<string>;
+export declare function isFullWidthField(field: FieldDescriptor): boolean;
+/**
+ * Inline grid style for a form/section root. Applied inline (not via a
+ * stylesheet) on purpose: suite-v2 consumes form-vue's JS but NOT its CSS
+ * bundle, so any layout that lives in a `.css` file never renders there. Inline
+ * styles always apply.
+ *
+ * - `columns <= 1` → a single stacked column.
+ * - `columns >= 2` → responsive auto-fit: as many `MIN_COL_TRACK`-wide columns
+ *   as fit, collapsing to 1 when narrow (no media query needed).
+ */
+export declare function gridRootStyle(columns: number, gap: FormGap): Record<string, string>;
+/** Effective span for one cell, clamped to the grid's column count. */
+export declare function cellSpan(field: FieldDescriptor, columns: number): number;
+/**
+ * Inline per-cell bindings. Full-width cells span every track; multi-span cells
+ * span N tracks (browser clamps to the rendered track count). A plain
+ * single-column cell needs no style. Spread on the cell via `v-bind`.
+ */
+export declare function cellBindings(field: FieldDescriptor, columns: number, isFull: boolean): {
+    style?: Record<string, string>;
+};
+//# sourceMappingURL=gridCell.d.ts.map

package/dist/utils/gridCell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gridCell.d.ts","sourceRoot":"","sources":["../../src/utils/gridCell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,MAAM,MAAM,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAWzC;8DAC8D;AAC9D,eAAO,MAAM,iBAAiB,aAQ5B,CAAC;AAEH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAIhE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQnF;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGxE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,GACd;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAKpC"}

package/dist/utils/gridCell.test.d.ts

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

package/dist/utils/gridCell.test.d.ts.map

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

package/dist/utils/normalizeMaskConfig.d.ts

@@ -0,0 +1,23 @@
+import type { MaskNormalizeMode, MaskRawMode } from '@prolibu-suite/cobalt-form-core';
+export declare const DEFAULT_MASK_CONFIG: {
+    readonly lazy: true;
+    readonly placeholderChar: "_";
+    readonly rawMode: "unmasked";
+    readonly normalize: "none";
+};
+export interface NormalizedMaskConfig {
+    pattern: string;
+    lazy: boolean;
+    placeholderChar: string;
+    rawMode: MaskRawMode;
+    normalize: MaskNormalizeMode;
+    countryCode: string | null;
+    imaskOptions: {
+        mask: string;
+        lazy: boolean;
+        placeholderChar: string;
+    };
+    cacheKey: string;
+}
+export declare function normalizeMaskConfig(mask: unknown): NormalizedMaskConfig | null;
+//# sourceMappingURL=normalizeMaskConfig.d.ts.map

package/dist/utils/normalizeMaskConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeMaskConfig.d.ts","sourceRoot":"","sources":["../../src/utils/normalizeMaskConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,iBAAiB,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAElG,eAAO,MAAM,mBAAmB;;;;;CAKtB,CAAC;AAEX,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,OAAO,CAAC;QACd,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAoED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI,CAO9E"}

package/dist/utils/normalizeMaskConfig.test.d.ts

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

package/dist/utils/normalizeMaskConfig.test.d.ts.map

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

package/dist/utils/sectionPreview.d.ts

@@ -0,0 +1,26 @@
+import type { FieldDescriptor } from '@prolibu-suite/cobalt-form-core';
+/** A value is "empty" when it carries no user information. */
+export declare function isEmptyValue(v: any): boolean;
+/** True if any value among the children is non-empty. */
+export declare function hasAnyValue(children: FieldDescriptor[], objectValue: Record<string, any>): boolean;
+/** True if a required child is empty (forces the section open). */
+export declare function hasEmptyRequiredChild(children: FieldDescriptor[], objectValue: Record<string, any>): boolean;
+export interface InitialOpenArgs {
+    children: FieldDescriptor[];
+    objectValue: Record<string, any>;
+    errors: string[];
+    originalAttrs?: Record<string, any>;
+}
+/**
+ * Initial open/collapsed state for a fieldset accordion.
+ * Schema override wins: `expanded === true` → open; `collapsed === true` →
+ * collapsed (unless errors force open). Otherwise: open when there are errors,
+ * an empty required child, or no value at all; collapsed when filled & complete.
+ */
+export declare function computeInitialOpen({ children, objectValue, errors, originalAttrs, }: InitialOpenArgs): boolean;
+/**
+ * Short, "·"-joined summary of the section's non-empty children. Caps at
+ * PREVIEW_CAP entries then "+N". Returns '' when there is nothing to show.
+ */
+export declare function formatSectionPreview(children: FieldDescriptor[], objectValue: Record<string, any>, _locale?: string): string;
+//# sourceMappingURL=sectionPreview.d.ts.map

package/dist/utils/sectionPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sectionPreview.d.ts","sourceRoot":"","sources":["../../src/utils/sectionPreview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAIvE,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,CAAC,EAAE,GAAG,GAAG,OAAO,CAK5C;AAMD,yDAAyD;AACzD,wBAAgB,WAAW,CACzB,QAAQ,EAAE,eAAe,EAAE,EAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC/B,OAAO,CAET;AAED,mEAAmE;AACnE,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,eAAe,EAAE,EAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC/B,OAAO,CAET;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,WAAW,EACX,MAAM,EACN,aAAa,GACd,EAAE,eAAe,GAAG,OAAO,CAO3B;AA4CD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,eAAe,EAAE,EAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChC,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAUR"}

package/dist/utils/sectionPreview.test.d.ts

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

package/dist/utils/sectionPreview.test.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prolibu-suite/cobalt-form-vue",
-  "version": "0.1.3",
+  "version": "2.0.0",
   "description": "Cobalt Form — Vue 3 adapter. useForm() composable + CoFormRenderer component.",
   "type": "module",
   "main": "dist/index.js",
@@ -8,8 +8,9 @@
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "default": "./dist/index.js"
     },
     "./style.css": "./dist/style.css"
   },
@@ -27,16 +28,20 @@
   "license": "MIT",
   "peerDependencies": {
     "vue": "^3.0.0",
-    "@prolibu-suite/cobalt-core": "0.1.2",
-    "@prolibu-suite/cobalt-vue": "0.1.2"
+    "@prolibu-suite/cobalt-core": "0.3.0",
+    "@prolibu-suite/cobalt-vue": "0.3.0"
   },
   "dependencies": {
-    "@prolibu-suite/cobalt-form-core": "0.2.0"
+    "imask": "^7.6.1",
+    "@prolibu-suite/cobalt-form-core": "0.3.0"
   },
   "devDependencies": {
+    "@vue/test-utils": "^2.4.6",
     "@vitejs/plugin-vue": "^5.2.1",
+    "jsdom": "^29.0.2",
     "typescript": "^6.0.3",
     "vite": "^6.0.0",
+    "vitest": "^4.1.4",
     "vue": "^3.5.22",
     "vue-tsc": "^2.2.0"
   },
@@ -46,6 +51,8 @@
   "scripts": {
     "build": "vite build && vue-tsc --emitDeclarationOnly -p tsconfig.json",
     "dev": "vite build --watch",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
 }