bank20baht-ui 0.0.10 → 0.0.11

package/README.md

@@ -108,6 +108,25 @@ block), nothing in the payload. Missing keys count as off, so new features stay
 the file turns them on. Server side: `validateSubmission(applyFlags(schema, flags), data)`
 with the same JSON — `bank20baht-validator` re-exports `applyFlags`.
 
+### File upload
+
+```js
+// schema:
+{ order: 6, type: 'file', key: 'doc', uploader: 'default', accept: '.pdf,image/*', maxSize: 10_485_760 }
+
+// registry — File in, serializable ref out:
+el.registry = {
+  uploaders: { default: async (file) => {
+    const fd = new FormData(); fd.append('file', file);
+    return (await fetch('/api/uploads', { method: 'POST', body: fd })).json();
+  } },
+};
+```
+
+Picking a file uploads immediately; the value becomes `{ name, size, type, url }` — plain
+JSON, chips with remove buttons in the UI, `maxSize`/`accept` validated on both client and
+server. Omit `uploader` for the old capture-only mode.
+
 ### Drafts / autosave (host pattern)
 
 The library is controlled — autosave is three lines in your app:

package/dist/components/baht-workflow.d.ts

@@ -23,6 +23,8 @@ export declare class BahtWorkflow extends BahtElement {
     showBack: boolean;
     /** Feature-flag values (spec 01 §12): flag-off steps/fields/rules vanish. */
     flags: FeatureFlags;
+    /** Render a <baht-steps> progress indicator above the current form. */
+    showSteps: boolean;
     private data;
     private derived;
     private current;
@@ -37,6 +39,8 @@ export declare class BahtWorkflow extends BahtElement {
     /** Forms in ascending order whose derived visibility is true. */
     private get visibleForms();
     private get currentForm();
+    /** Where next() would go from here: a formName or 'end' (spec 03 §6). */
+    private get navTarget();
     private get isLast();
     private fieldStatesFor;
     private get formEl();
@@ -48,7 +52,7 @@ export declare class BahtWorkflow extends BahtElement {
      */
     setValue(formName: string, patch: Record<string, unknown>): void;
     next(): void;
-    /** Advance past the current form: submit+complete on the last one, else step forward. */
+    /** Advance past the current form: submit+complete at 'end', else step to navTarget. */
     private advance;
     /** Approve the current approval step (same as pressing its Approve button). */
     approve(): void;

package/dist/components/primitives/baht-file.d.ts

@@ -1,9 +1,22 @@
 import { TemplateResult } from 'lit';
 import { BahtFieldBase } from '../base.js';
+import { UploadedFile } from '../../core/types.js';
 /**
- * Capture only (spec 01 §2): value = File handle(s); the lib never uploads.
+ * File field (spec 01 §2 + §13). Two modes:
+ * - capture (default): value = File handle(s); the lib never uploads.
+ * - upload (`field.uploader` + host `uploader` fn from the registry):
+ *   picking uploads immediately, value becomes serializable UploadedFile
+ *   ref(s), and the control shows chips with remove buttons.
  * maxSize (bytes) is enforced here as a soft filter — oversize files rejected.
  */
 export declare class BahtFile extends BahtFieldBase {
+    /** Resolved registry uploader — <baht-form> injects it when `field.uploader` is set. */
+    uploader?: (file: File) => Promise<UploadedFile>;
+    private uploadingCount;
+    private uploadError;
+    private get refs();
+    private emitRefs;
+    private uploadAll;
+    private onPick;
     protected renderControl(): TemplateResult;
 }

package/dist/components/primitives/baht-steps.d.ts

@@ -0,0 +1,20 @@
+import { TemplateResult } from 'lit';
+import { BahtElement } from '../base.js';
+/**
+ * <baht-steps> — wizard progress indicator (spec 03). Standalone display
+ * primitive: numbered markers + labels, the current one highlighted, done
+ * ones checked. <baht-workflow show-steps> renders it automatically from its
+ * visible forms.
+ */
+export declare class BahtSteps extends BahtElement {
+    /** Step labels in order. */
+    steps: string[];
+    /** 0-based index of the current step. */
+    current: number;
+    protected render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'baht-steps': BahtSteps;
+    }
+}

package/dist/components/primitives/index.d.ts

@@ -42,4 +42,5 @@ export { BahtErrorState } from './baht-error-state.js';
 export { BahtKeyvalueEditor } from './baht-keyvalue-editor.js';
 export { BahtReferencePicker, type ReferenceOption } from './baht-reference-picker.js';
 export { BahtRepeater } from './baht-repeater.js';
+export { BahtSteps } from './baht-steps.js';
 export { TAG_FOR_TYPE } from './tag-map.js';

package/dist/core/engine/graph.d.ts

@@ -0,0 +1,13 @@
+import { NestedData, WorkflowDefinition } from '../types.js';
+/**
+ * The step after `current` given the data: a formName or 'end'. Rules run
+ * (via evaluate) to decide visibility; hidden targets pass through, cycles
+ * of invisible forms end the walk.
+ */
+export declare function resolveNext(workflow: WorkflowDefinition, current: string, data: NestedData): string | 'end';
+/**
+ * The full path a submission takes from the start form to 'end' under this
+ * data — what the server validates against (off-path forms are as good as
+ * skipped). Back-edges that revisit a form stop the walk instead of looping.
+ */
+export declare function walkPath(workflow: WorkflowDefinition, data: NestedData): string[];

package/dist/core/i18n.d.ts

@@ -12,6 +12,11 @@ export interface MessageCatalog {
     compareGte: string;
     compareLt: string;
     compareLte: string;
+    fileTooLarge: string;
+    fileTypeNotAllowed: string;
+    uploading: string;
+    uploadFailed: string;
+    removeFile: string;
     addRow: string;
     removeRow: string;
     minRows: string;

package/dist/core/index.d.ts

@@ -7,5 +7,6 @@ export { applyFlags, flagEnabled } from './flags.js';
 export { setLocale, t } from './i18n.js';
 export type { Locale, MessageCatalog, MessageKey } from './i18n.js';
 export { evaluate } from './engine/evaluate.js';
+export { resolveNext, walkPath } from './engine/graph.js';
 export { evalCondition, readRef } from './engine/conditions.js';
 export { evalValueExpr } from './engine/expressions.js';

package/dist/core/types.d.ts

@@ -52,6 +52,12 @@ export interface FieldDescriptor {
     accept?: string;
     multiple?: boolean;
     maxSize?: number;
+    /**
+     * Registry uploader name (spec 01 §13). With it, picking a file uploads
+     * immediately and the VALUE becomes a serializable UploadedFile ref
+     * (arrays when `multiple`) — without it, capture-only File handles (v1).
+     */
+    uploader?: string;
     text?: string;
     variant?: string;
     /**
@@ -173,11 +179,33 @@ export interface Rule {
 }
 /** Flag values — typically fetched from one static JSON file (spec 01 §12). */
 export type FeatureFlags = Record<string, boolean>;
+/**
+ * A conditional edge between steps (spec 03 §6). With `transitions` present
+ * the wizard routes as a graph: from a form, the first edge whose `when`
+ * matches wins; `to: 'end'` submits. Forms with no outgoing edges (and
+ * non-matching edge sets) fall back to the next visible form in `order`, so
+ * linear authoring keeps working and branches are added only where needed.
+ */
+export interface Transition {
+    from: string;
+    to: string | 'end';
+    when?: Condition;
+    flag?: string;
+}
 /** A Workflow definition — consumed by <baht-workflow> (spec 00 §4.2). */
 export interface WorkflowDefinition {
     workflowId: string;
     forms: WorkflowForm[];
     rules: Rule[];
+    /** Optional graph routing (spec 03 §6); absent = linear by `order`. */
+    transitions?: Transition[];
+}
+/** Serializable result of a registry uploader (spec 01 §13). */
+export interface UploadedFile {
+    name: string;
+    size: number;
+    type?: string;
+    url: string;
 }
 export interface Registry {
     formatters?: Record<string, (value: unknown) => unknown>;
@@ -185,6 +213,8 @@ export interface Registry {
     validators?: Record<string, (value: unknown) => string | null>;
     /** Option fetchers for `optionsFrom` — receive the form's current flat data. */
     options?: Record<string, (data: Record<string, unknown>) => FieldOption[] | Promise<FieldOption[]>>;
+    /** File uploaders for `uploader` — take the picked File, return its ref. */
+    uploaders?: Record<string, (file: File) => Promise<UploadedFile>>;
 }
 export interface DerivedFieldState {
     visible: boolean;

package/dist/custom-elements.json

@@ -438,6 +438,16 @@
               "default": "{}",
               "description": "Feature-flag values (spec 01 §12): flag-off steps/fields/rules vanish."
             },
+            {
+              "kind": "field",
+              "name": "showSteps",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Render a <baht-steps> progress indicator above the current form.",
+              "attribute": "show-steps"
+            },
             {
               "kind": "field",
               "name": "data",
@@ -539,6 +549,16 @@
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "navTarget",
+              "type": {
+                "text": "string | 'end'"
+              },
+              "privacy": "private",
+              "description": "Where next() would go from here: a formName or 'end' (spec 03 §6).",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "isLast",
@@ -635,7 +655,7 @@
                   }
                 }
               ],
-              "description": "Advance past the current form: submit+complete on the last one, else step forward."
+              "description": "Advance past the current form: submit+complete at 'end', else step to navTarget."
             },
             {
               "kind": "method",
@@ -887,6 +907,15 @@
               },
               "default": "true",
               "fieldName": "showBack"
+            },
+            {
+              "name": "show-steps",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Render a <baht-steps> progress indicator above the current form.",
+              "fieldName": "showSteps"
             }
           ],
           "superclass": {
@@ -3078,9 +3107,98 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Capture only (spec 01 §2): value = File handle(s); the lib never uploads.\nmaxSize (bytes) is enforced here as a soft filter — oversize files rejected.",
+          "description": "File field (spec 01 §2 + §13). Two modes:\n- capture (default): value = File handle(s); the lib never uploads.\n- upload (`field.uploader` + host `uploader` fn from the registry):\n  picking uploads immediately, value becomes serializable UploadedFile\n  ref(s), and the control shows chips with remove buttons.\nmaxSize (bytes) is enforced here as a soft filter — oversize files rejected.",
           "name": "BahtFile",
           "members": [
+            {
+              "kind": "field",
+              "name": "uploader",
+              "type": {
+                "text": "(file: File) => Promise<UploadedFile> | undefined"
+              },
+              "description": "Resolved registry uploader — <baht-form> injects it when `field.uploader` is set."
+            },
+            {
+              "kind": "field",
+              "name": "uploadingCount",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0"
+            },
+            {
+              "kind": "field",
+              "name": "uploadError",
+              "type": {
+                "text": "string | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "refs",
+              "type": {
+                "text": "UploadedFile[]"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "emitRefs",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "refs",
+                  "type": {
+                    "text": "UploadedFile[]"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "uploadAll",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "files",
+                  "type": {
+                    "text": "File[]"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "onPick",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "renderControl",
@@ -7762,6 +7880,73 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/primitives/baht-steps.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "<baht-steps> — wizard progress indicator (spec 03). Standalone display\nprimitive: numbered markers + labels, the current one highlighted, done\nones checked. <baht-workflow show-steps> renders it automatically from its\nvisible forms.",
+          "name": "BahtSteps",
+          "members": [
+            {
+              "kind": "field",
+              "name": "steps",
+              "type": {
+                "text": "string[]"
+              },
+              "default": "[]",
+              "description": "Step labels in order."
+            },
+            {
+              "kind": "field",
+              "name": "current",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "0-based index of the current step.",
+              "attribute": "current"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "current",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "0-based index of the current step.",
+              "fieldName": "current"
+            }
+          ],
+          "superclass": {
+            "name": "BahtElement",
+            "module": "/src/components/base.js"
+          },
+          "tagName": "baht-steps",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BahtSteps",
+          "declaration": {
+            "name": "BahtSteps",
+            "module": "src/components/primitives/baht-steps.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "baht-steps",
+          "declaration": {
+            "name": "BahtSteps",
+            "module": "src/components/primitives/baht-steps.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/primitives/baht-table.ts",
@@ -9587,6 +9772,14 @@
             "module": "./baht-repeater.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "BahtSteps",
+          "declaration": {
+            "name": "BahtSteps",
+            "module": "./baht-steps.js"
+          }
+        },
         {
           "kind": "js",
           "name": "TAG_FOR_TYPE",