@svadmin/lite 0.13.0 → 0.14.0

package/dist/components/LiteKanbanBoard.svelte

@@ -1,4 +1,5 @@
 <script lang="ts">
+  import { useTranslation } from '@svadmin/core/i18n';
   export interface KanbanCard {
     id: string;
     title: string;
@@ -17,6 +18,10 @@
     columns: KanbanColumn[];
     cards?: KanbanCard[];
     formAction?: string;
+    loading?: boolean;
+    error?: string | undefined;
+    retryHref?: string;
+    ariaLabel?: string;
     class?: string;
   }
 
@@ -24,14 +29,54 @@
     columns = [],
     cards = [],
     formAction = '',
+    loading = false,
+    error,
+    retryHref,
+    ariaLabel,
     class: className = '',
   }: Props = $props();
+  const i18n = useTranslation();
+  function text(value: unknown): value is string {
+    return typeof value === 'string' && value.trim().length > 0 && value.length <= 1000;
+  }
+  const validationError = $derived.by(() => {
+    if (!Array.isArray(columns) || !Array.isArray(cards)) return 'kanban.invalidData';
+    if (columns.length > 200 || cards.length > 1000) return 'kanban.limit';
+    if (columns.some(column => !column || !text(column.id) || !text(column.title))) return 'kanban.invalidData';
+    const ids = new Set(columns.map(column => column.id));
+    if (ids.size !== columns.length) return 'kanban.invalidData';
+    const cardIds = new Set<string>();
+    for (const card of cards) {
+      if (!card || !text(card.id) || !text(card.title) || !ids.has(card.columnId) || cardIds.has(card.id)
+        || (card.description !== undefined && (typeof card.description !== 'string' || card.description.length > 10_000))
+        || (card.tags !== undefined && (!Array.isArray(card.tags) || card.tags.length > 100 || !card.tags.every(text)))
+        || (card.priority !== undefined && !['low', 'medium', 'high', 'urgent'].includes(card.priority))) return 'kanban.invalidData';
+      cardIds.add(card.id);
+    }
+    return '';
+  });
+  const displayError = $derived(error || (validationError ? i18n.t(validationError) : ''));
+  function localPath(value: string | undefined): string | undefined {
+    return value && (value.startsWith('/') || value.startsWith('?'))
+      && !/^\/[\\/]/.test(value) && !value.includes('\\')
+      && ![...value].some(char => char.charCodeAt(0) <= 32 || char.charCodeAt(0) === 127) ? value : undefined;
+  }
+  const safeAction = $derived(localPath(formAction));
+  const safeRetry = $derived(localPath(retryHref));
 </script>
 
-<div class="sv-lite-kanban-board {className}">
+<div class="sv-lite-kanban-board {className}" role="region" aria-label={ariaLabel ?? i18n.t('kanban.label')} aria-busy={loading}>
+  {#if loading}
+    <div role="status">{i18n.t('common.loading')}</div>
+  {:else if displayError}
+    <div role="alert">{displayError}</div>
+    {#if error && safeRetry}<a href={safeRetry}>{i18n.t('common.retry')}</a>{/if}
+  {:else if columns.length === 0}
+    <div role="status">{i18n.t('common.noData')}</div>
+  {:else}
   {#each columns as col (col.id)}
     {@const colCards = cards.filter((c) => c.columnId === col.id)}
-    <div class="sv-lite-kanban-column">
+    <div class="sv-lite-kanban-column" role="region" aria-label={col.title}>
       <div class="sv-lite-column-header">
         <span class="sv-lite-column-title">{col.title}</span>
         <span class="sv-lite-column-count">({colCards.length})</span>
@@ -39,7 +84,7 @@
 
       <div class="sv-lite-column-cards">
         {#each colCards as card (card.id)}
-          <div class="sv-lite-kanban-card">
+          <div class="sv-lite-kanban-card" role="group" aria-label={card.title}>
             <div class="sv-lite-card-title">{card.title}</div>
             {#if card.description}
               <div class="sv-lite-card-desc">{card.description}</div>
@@ -48,23 +93,26 @@
               {#if card.priority}
                 <span class="sv-lite-priority-badge sv-lite-{card.priority}">{card.priority}</span>
               {/if}
-              {#each card.tags ?? [] as tag (tag)}
+              {#each card.tags ?? [] as tag, index (index)}
                 <span class="sv-lite-tag-badge">#{tag}</span>
               {/each}
             </div>
           </div>
+        {:else}
+          <div role="status">{i18n.t('common.noData')}</div>
         {/each}
       </div>
 
-      {#if formAction}
-        <form method="POST" action={formAction} class="sv-lite-card-form">
+      {#if safeAction && cards.length < 1000}
+        <form method="POST" action={safeAction} class="sv-lite-card-form" aria-label={i18n.t('kanban.addTo', { column: col.title })}>
           <input type="hidden" name="columnId" value={col.id} />
-          <input type="text" name="title" placeholder="+ Add card..." class="sv-lite-card-input" />
-          <button type="submit" class="sv-lite-card-btn">Add</button>
+          <input type="text" name="title" aria-label={i18n.t('kanban.cardTitle')} placeholder={i18n.t('kanban.cardTitle')} required maxlength={1000} class="sv-lite-card-input" />
+          <button type="submit" class="sv-lite-card-btn">{i18n.t('common.add')}</button>
         </form>
       {/if}
     </div>
   {/each}
+  {/if}
 </div>
 
 <style>

package/dist/components/LiteKanbanBoard.svelte.d.ts

@@ -14,6 +14,10 @@ interface Props {
     columns: KanbanColumn[];
     cards?: KanbanCard[];
     formAction?: string;
+    loading?: boolean;
+    error?: string | undefined;
+    retryHref?: string;
+    ariaLabel?: string;
     class?: string;
 }
 declare const LiteKanbanBoard: import("svelte").Component<Props, {}, "">;

package/dist/components/LitePivotTable.svelte

@@ -1,8 +1,11 @@
 <script lang="ts">
-  export type AggregationFn = 'sum' | 'count' | 'avg' | 'min' | 'max';
+  import { useTranslation } from '@svadmin/core/i18n';
+  import { buildPivot, buildPivotDrilldown, decodePivotResult, formatPivotValue } from '@svadmin/core/pivot';
+  export type AggregationFn = import('@svadmin/core/pivot').PivotAggregation;
 
   interface Props {
     data?: Record<string, unknown>[];
+    aggregateData?: unknown;
     rowField: string;
     rowLabel?: string;
     columnField: string;
@@ -10,11 +13,23 @@
     valueField: string;
     valueLabel?: string;
     aggregator?: AggregationFn;
+    formatValue?: (value: number) => string;
+    loading?: boolean;
+    error?: string | undefined;
+    retryHref?: string;
+    exportHref?: string;
+    drilldownHref?: (input: import('@svadmin/core/pivot').PivotDrilldown) => string | undefined;
+    resource?: string;
+    scopeKey?: string;
+    filters?: import('@svadmin/core').Filter[];
+    meta?: Record<string, unknown>;
+    ariaLabel?: string;
     class?: string;
   }
 
   let {
     data = [],
+    aggregateData,
     rowField,
     rowLabel = rowField,
     columnField,
@@ -22,91 +37,106 @@
     valueField,
     valueLabel = valueField,
     aggregator = 'sum',
+    formatValue,
+    loading = false,
+    error,
+    retryHref,
+    exportHref,
+    drilldownHref,
+    resource,
+    scopeKey,
+    filters,
+    meta,
+    ariaLabel,
     class: className = '',
   }: Props = $props();
 
-  const distinctRowValues = $derived(
-    Array.from(new Set(data.map((d) => String(d[rowField] ?? '—')))).sort()
-  );
-
-  const distinctColValues = $derived(
-    Array.from(new Set(data.map((d) => String(d[columnField] ?? '—')))).sort()
-  );
-
-  function computeAgg(vals: number[]): number {
-    if (vals.length === 0) return 0;
-    if (aggregator === 'count') return vals.length;
-    if (aggregator === 'sum') return vals.reduce((a, b) => a + b, 0);
-    if (aggregator === 'avg') return vals.reduce((a, b) => a + b, 0) / vals.length;
-    if (aggregator === 'min') return Math.min(...vals);
-    if (aggregator === 'max') return Math.max(...vals);
-    return 0;
+  const i18n = useTranslation();
+  const pivot = $derived(aggregateData !== undefined ? decodePivotResult(aggregateData)
+    : buildPivot(loading || error ? [] : data, { rowField, columnField, valueField, aggregator }));
+  const displayError = $derived(error || (pivot.error ? i18n.t(`pivot.${pivot.error}`) : ''));
+  // 重试仅接受站内绝对路径，避免在服务端页面输出可执行协议。
+  const safeRetryHref = $derived(safeHref(retryHref));
+  const safeExportHref = $derived(safeHref(exportHref));
+  function safeHref(value: string | undefined): string | undefined {
+    return value?.startsWith('/') && !/^\/[\\/]/.test(value)
+      && !value.includes('\\')
+      && ![...value].some(char => char.charCodeAt(0) <= 32 || char.charCodeAt(0) === 127) ? value : undefined;
   }
-
-  function getCellValue(r: string, c: string): number {
-    const vals = data
-      .filter((d) => String(d[rowField] ?? '—') === r && String(d[columnField] ?? '—') === c)
-      .map((d) => Number(d[valueField]) || 0);
-    return computeAgg(vals);
+  function cellHref(rowKey: string, columnKey: string): string | undefined {
+    if (!drilldownHref || !pivot.cells.get(rowKey)?.has(columnKey)) return;
+    const row = pivot.rows.find(item => item.key === rowKey);
+    const column = pivot.columns.find(item => item.key === columnKey);
+    const query = { resource, rowField, columnField, valueField, aggregator,
+      ...(filters === undefined ? {} : { filters }), ...(meta === undefined ? {} : { meta }) };
+    const input = buildPivotDrilldown(query, scopeKey, row, column);
+    try {
+      return safeHref(input ? drilldownHref(input) : undefined);
+    } catch {
+      return;
+    }
   }
-
-  function getRowTotal(r: string): number {
-    const vals = data
-      .filter((d) => String(d[rowField] ?? '—') === r)
-      .map((d) => Number(d[valueField]) || 0);
-    return computeAgg(vals);
+  function display(value: number | null | undefined): string {
+    return formatPivotValue(value, formatValue ?? (v => v.toLocaleString(i18n.locale, { maximumFractionDigits: 2 })));
   }
-
-  function getColTotal(c: string): number {
-    const vals = data
-      .filter((d) => String(d[columnField] ?? '—') === c)
-      .map((d) => Number(d[valueField]) || 0);
-    return computeAgg(vals);
-  }
-
-  const grandTotal = $derived(
-    computeAgg(data.map((d) => Number(d[valueField]) || 0))
-  );
 </script>
 
-<div class="sv-lite-pivot-container {className}">
+<div class="sv-lite-pivot-container {className}" aria-busy={loading}>
   <div class="sv-lite-pivot-header">
-    <strong>Pivot Analysis</strong> ({rowLabel} × {columnLabel})
-    <span class="sv-lite-pivot-sub">Aggregator: {aggregator.toUpperCase()} ({valueLabel})</span>
+    <strong>{i18n.t('pivot.title')}</strong> ({rowLabel} × {columnLabel})
+    <span class="sv-lite-pivot-sub">{i18n.t(`pivot.${aggregator}`)} ({valueLabel})</span>
+    {#if safeExportHref}<a href={safeExportHref}>{i18n.t('common.export')}</a>{/if}
   </div>
 
-  <table class="sv-lite-pivot-table">
+  {#if loading}
+    <div role="status">{i18n.t('common.loading')}</div>
+  {:else if displayError}
+    <div role="alert">{displayError}</div>
+    {#if error && safeRetryHref}<a href={safeRetryHref}>{i18n.t('common.retry')}</a>{/if}
+  {:else if pivot.rows.length === 0}
+    <div role="status">{i18n.t('common.noData')}</div>
+  {:else}
+  <table class="sv-lite-pivot-table" aria-label={ariaLabel ?? `${i18n.t('pivot.title')}: ${rowLabel} / ${columnLabel} / ${valueLabel}`}>
     <thead>
       <tr>
-        <th class="sv-lite-th-dim">{rowLabel} \ {columnLabel}</th>
-        {#each distinctColValues as col (col)}
-          <th>{col}</th>
+        <th scope="col" class="sv-lite-th-dim">{rowLabel} \ {columnLabel}</th>
+        {#each pivot.columns as col (col.key)}
+          <th scope="col">{col.label}</th>
         {/each}
-        <th class="sv-lite-th-total">Total</th>
+        <th scope="col" class="sv-lite-th-total">{i18n.t('pivot.total')}</th>
       </tr>
     </thead>
     <tbody>
-      {#each distinctRowValues as row (row)}
+      {#each pivot.rows as row (row.key)}
         <tr>
-          <td class="sv-lite-td-dim">{row}</td>
-          {#each distinctColValues as col (col)}
-            {@const val = getCellValue(row, col)}
-            <td class="sv-lite-td-val">{val.toLocaleString(undefined, { maximumFractionDigits: 2 })}</td>
+          <th scope="row" class="sv-lite-td-dim">{row.label}</th>
+          {#each pivot.columns as col (col.key)}
+            {@const href = cellHref(row.key, col.key)}
+            <td class="sv-lite-td-val">
+              {#if href}
+                <a href={href} aria-label={`${i18n.t('pivot.drilldown')}: ${row.label} / ${col.label}`}>
+                  {display(pivot.cells.get(row.key)?.get(col.key))}
+                </a>
+              {:else}
+                {display(pivot.cells.get(row.key)?.get(col.key))}
+              {/if}
+            </td>
           {/each}
-          <td class="sv-lite-td-rowtotal">{getRowTotal(row).toLocaleString(undefined, { maximumFractionDigits: 2 })}</td>
+          <td class="sv-lite-td-rowtotal">{display(pivot.rowTotals.get(row.key))}</td>
         </tr>
       {/each}
     </tbody>
     <tfoot>
       <tr>
-        <td class="sv-lite-td-dim">Grand Total</td>
-        {#each distinctColValues as col (col)}
-          <td class="sv-lite-td-val">{getColTotal(col).toLocaleString(undefined, { maximumFractionDigits: 2 })}</td>
+        <th scope="row" class="sv-lite-td-dim">{i18n.t('pivot.grandTotal')}</th>
+        {#each pivot.columns as col (col.key)}
+          <td class="sv-lite-td-val">{display(pivot.columnTotals.get(col.key))}</td>
         {/each}
-        <td class="sv-lite-td-grandtotal">{grandTotal.toLocaleString(undefined, { maximumFractionDigits: 2 })}</td>
+        <td class="sv-lite-td-grandtotal">{display(pivot.grandTotal)}</td>
       </tr>
     </tfoot>
   </table>
+  {/if}
 </div>
 
 <style>

package/dist/components/LitePivotTable.svelte.d.ts

@@ -1,6 +1,7 @@
-export type AggregationFn = 'sum' | 'count' | 'avg' | 'min' | 'max';
+export type AggregationFn = import('@svadmin/core/pivot').PivotAggregation;
 interface Props {
     data?: Record<string, unknown>[];
+    aggregateData?: unknown;
     rowField: string;
     rowLabel?: string;
     columnField: string;
@@ -8,6 +9,17 @@ interface Props {
     valueField: string;
     valueLabel?: string;
     aggregator?: AggregationFn;
+    formatValue?: (value: number) => string;
+    loading?: boolean;
+    error?: string | undefined;
+    retryHref?: string;
+    exportHref?: string;
+    drilldownHref?: (input: import('@svadmin/core/pivot').PivotDrilldown) => string | undefined;
+    resource?: string;
+    scopeKey?: string;
+    filters?: import('@svadmin/core').Filter[];
+    meta?: Record<string, unknown>;
+    ariaLabel?: string;
     class?: string;
 }
 declare const LitePivotTable: import("svelte").Component<Props, {}, "">;

package/dist/components/LiteSpreadsheetView.svelte

@@ -1,4 +1,7 @@
 <script lang="ts">
+  import { useTranslation } from '@svadmin/core/i18n';
+  const i18n = useTranslation();
+
   export interface SheetData {
     id: string;
     name: string;
@@ -11,6 +14,8 @@
     sheets?: SheetData[];
     activeSheetId?: string;
     formAction?: string;
+    readonly?: boolean;
+    limits?: Partial<{ maxRows: number; maxCols: number; maxCells: number; maxSheets: number; maxCellLength: number }>;
     class?: string;
   }
 
@@ -26,25 +31,63 @@
     ],
     activeSheetId = 'sheet1',
     formAction = '',
+    readonly = false,
+    limits: limitOverrides = {},
     class: className = '',
   }: Props = $props();
 
-  const currentSheet = $derived(
-    sheets.find((s) => s.id === activeSheetId) ?? sheets[0]
-  );
+  const limits = $derived.by(() => {
+    const bounded = (value: number | undefined, ceiling: number) =>
+      typeof value === 'number' && Number.isSafeInteger(value) && value > 0 ? Math.min(value, ceiling) : ceiling;
+    return {
+      maxRows: bounded(limitOverrides.maxRows, 1000),
+      maxCols: bounded(limitOverrides.maxCols, 100),
+      maxCells: bounded(limitOverrides.maxCells, 10_000),
+      maxSheets: bounded(limitOverrides.maxSheets, 32),
+      maxCellLength: bounded(limitOverrides.maxCellLength, 10_000),
+    };
+  });
+  const validWorkbook = $derived(sheets.length <= limits.maxSheets && new Set(sheets.map(sheet => sheet.id)).size === sheets.length);
+  const currentSheet = $derived(validWorkbook ? (sheets.find(s => s.id === activeSheetId) ?? sheets[0]) : undefined);
+  const canRender = $derived.by(() => {
+    if (!currentSheet || !currentSheet.cells || typeof currentSheet.cells !== 'object'
+      || !Number.isSafeInteger(currentSheet.rows) || currentSheet.rows < 1 || currentSheet.rows > limits.maxRows
+      || !Number.isSafeInteger(currentSheet.cols) || currentSheet.cols < 1 || currentSheet.cols > limits.maxCols
+      || currentSheet.rows * currentSheet.cols > limits.maxCells) return false;
+    let textLength = 0;
+    for (let row = 1; row <= currentSheet.rows; row++) {
+      for (let col = 0; col < currentSheet.cols; col++) {
+        const key = `${getColName(col)}${row}`;
+        const raw = Object.hasOwn(currentSheet.cells, key) ? currentSheet.cells[key] : '';
+        if (typeof raw !== 'string' || raw.length > limits.maxCellLength) return false;
+        textLength += raw.length;
+        if (textLength > 1_000_000) return false;
+      }
+    }
+    return true;
+  });
 
   function getColName(index: number): string {
-    return String.fromCharCode(index + 65);
+    let result = '';
+    for (let i = index; i >= 0; i = Math.floor(i / 26) - 1) {
+      result = String.fromCharCode(i % 26 + 65) + result;
+    }
+    return result;
   }
 </script>
 
 <div class="sv-lite-sheet-container {className}">
   <div class="sv-lite-sheet-header">
-    <strong>Spreadsheet: {currentSheet?.name ?? 'Sheet'}</strong>
+    <strong>{i18n.t('spreadsheet.title')}: {currentSheet?.name ?? ''}</strong>
   </div>
 
-  {#if currentSheet}
+  {#if !validWorkbook || (currentSheet && !canRender)}
+    <p role="alert">{i18n.t('spreadsheet.invalid')}</p>
+  {:else if !currentSheet}
+    <p role="status">{i18n.t('spreadsheet.empty')}</p>
+  {:else}
     <form method="POST" action={formAction}>
+      <input type="hidden" name="sheetId" value={currentSheet.id} />
       <table class="sv-lite-sheet-table">
         <thead>
           <tr>
@@ -64,8 +107,11 @@
                 <td class="sv-lite-sheet-td">
                   <input
                     type="text"
+                    {readonly}
+                    aria-label={key}
+                    maxlength={limits.maxCellLength}
                     name={`cell_${key}`}
-                    value={currentSheet.cells[key] ?? ''}
+                    value={Object.hasOwn(currentSheet.cells, key) ? currentSheet.cells[key] ?? '' : ''}
                     class="sv-lite-cell-input"
                   />
                 </td>
@@ -75,9 +121,9 @@
         </tbody>
       </table>
 
-      {#if formAction}
+      {#if formAction && !readonly}
         <div class="sv-lite-sheet-footer">
-          <button type="submit" class="sv-lite-sheet-save">Save Spreadsheet</button>
+          <button type="submit" class="sv-lite-sheet-save">{i18n.t('common.save')}</button>
         </div>
       {/if}
     </form>

package/dist/components/LiteSpreadsheetView.svelte.d.ts

@@ -9,6 +9,14 @@ interface Props {
     sheets?: SheetData[];
     activeSheetId?: string;
     formAction?: string;
+    readonly?: boolean;
+    limits?: Partial<{
+        maxRows: number;
+        maxCols: number;
+        maxCells: number;
+        maxSheets: number;
+        maxCellLength: number;
+    }>;
     class?: string;
 }
 declare const LiteSpreadsheetView: import("svelte").Component<Props, {}, "">;

package/dist/index.d.ts

@@ -14,6 +14,8 @@ export { default as LiteLogin } from './components/LiteLogin.svelte';
 export { default as LiteShow } from './components/LiteShow.svelte';
 export { default as LiteSearch } from './components/LiteSearch.svelte';
 export { default as LiteAlert } from './components/LiteAlert.svelte';
+export { default as LiteErrorSummary } from './components/LiteErrorSummary.svelte';
+export type { LiteFormErrorEntry } from './components/LiteErrorSummary.svelte';
 export { default as LitePermissionMatrix } from './components/LitePermissionMatrix.svelte';
 export { default as LiteAuditLog } from './components/LiteAuditLog.svelte';
 export { default as LiteArrayField } from './components/LiteArrayField.svelte';
@@ -57,6 +59,8 @@ export { default as LiteActivityFeed } from './components/LiteActivityFeed.svelt
 export { default as LitePresenceAvatarGroup } from './components/LitePresenceAvatarGroup.svelte';
 export { default as LitePrintableBill } from './components/LitePrintableBill.svelte';
 export { default as LiteJsonSchemaForm } from './components/LiteJsonSchemaForm.svelte';
+export { decodeSchemaFormArrayAction, decodeSchemaFormData, decodeSchemaFormSubmission, encodeSchemaFormArrayAction, schemaFormActionName, schemaFormFieldName, } from './schema-form-data';
+export type { SchemaFormArrayAction, SchemaFormSchema } from './schema-form-data';
 export { default as LiteMentionsInput } from './components/LiteMentionsInput.svelte';
 export { default as LiteKanbanBoard } from './components/LiteKanbanBoard.svelte';
 export { default as LitePivotTable } from './components/LitePivotTable.svelte';

package/dist/index.js

@@ -18,6 +18,7 @@ export { default as LiteLogin } from './components/LiteLogin.svelte';
 export { default as LiteShow } from './components/LiteShow.svelte';
 export { default as LiteSearch } from './components/LiteSearch.svelte';
 export { default as LiteAlert } from './components/LiteAlert.svelte';
+export { default as LiteErrorSummary } from './components/LiteErrorSummary.svelte';
 export { default as LitePermissionMatrix } from './components/LitePermissionMatrix.svelte';
 export { default as LiteAuditLog } from './components/LiteAuditLog.svelte';
 export { default as LiteArrayField } from './components/LiteArrayField.svelte';
@@ -57,6 +58,7 @@ export { default as LiteActivityFeed } from './components/LiteActivityFeed.svelt
 export { default as LitePresenceAvatarGroup } from './components/LitePresenceAvatarGroup.svelte';
 export { default as LitePrintableBill } from './components/LitePrintableBill.svelte';
 export { default as LiteJsonSchemaForm } from './components/LiteJsonSchemaForm.svelte';
+export { decodeSchemaFormArrayAction, decodeSchemaFormData, decodeSchemaFormSubmission, encodeSchemaFormArrayAction, schemaFormActionName, schemaFormFieldName, } from './schema-form-data';
 export { default as LiteMentionsInput } from './components/LiteMentionsInput.svelte';
 export { default as LiteKanbanBoard } from './components/LiteKanbanBoard.svelte';
 export { default as LitePivotTable } from './components/LitePivotTable.svelte';

package/dist/schema-form-data.d.ts

@@ -0,0 +1,18 @@
+import type { SchemaFormSchema } from '@svadmin/core/schema-form';
+export type { SchemaFormSchema } from '@svadmin/core/schema-form';
+export declare function schemaFormFieldName(path: readonly string[]): string;
+export declare const schemaFormActionName = "schemaFormAction";
+export type SchemaFormArrayAction = {
+    type: 'add' | 'remove';
+    path: string[];
+    index?: number;
+};
+export declare function encodeSchemaFormArrayAction(action: SchemaFormArrayAction): string;
+export declare function decodeSchemaFormArrayAction(form: FormData): SchemaFormArrayAction | undefined;
+/** 按可信 Schema 解码并验证支持的约束；不替代资源授权和业务命令校验。 */
+export declare function decodeSchemaFormData(schema: SchemaFormSchema, form: FormData): Record<string, unknown>;
+/** 数组动作只生成下一份草稿；只有 submit 分支才可进入业务写入。 */
+export declare function decodeSchemaFormSubmission(schema: SchemaFormSchema, form: FormData): {
+    kind: 'draft' | 'submit';
+    data: Record<string, unknown>;
+};