@svadmin/lite 0.12.0 → 0.13.0

package/README.md

@@ -13,7 +13,7 @@ The main `@svadmin/ui` package delivers a premium SPA experience using Svelte 5,
 **What Lite is:**
 - A **Zero-JS SSR-first admin component suite** designed with an IE11-safe CSS baseline.
 - 100% interoperable with `@svadmin/core` — sharing the same `DataProvider`, `AuthProvider`, `Resource`, and `FieldDefinition` contracts.
-- An architectural companion to `@svadmin/ui` achieving **100% component parity (103/103 components)** through 1:1 server-rendered matches, deliberate semantic fallbacks, or explicit SPA-only classification.
+- An architectural companion to `@svadmin/ui` with tracked server-rendered mappings, semantic fallbacks, and explicit SPA-only classifications in `PARITY.md`. Coverage measures the listed mappings, not a complete public-export inventory or verified behavioral equivalence.
 - **Not** a generic Tailwind-to-IE11 compiler or a full client-side port of shadcn-svelte (which depends on modern browser JS runtimes and CSS custom properties).
 
 `@svadmin/lite` provides a server-rendered fallback that **shares the same DataProvider, AuthProvider, and Resource definitions** — only the rendering layer is different.

package/dist/components/LiteFileUpload.svelte

@@ -0,0 +1,53 @@
+<script lang="ts">
+  interface Props {
+    name: string;
+    label: string;
+    id?: string;
+    form?: string;
+    accept?: string;
+    multiple?: boolean;
+    required?: boolean;
+    disabled?: boolean;
+    /** Explicit undefined clears a previously displayed server error. */
+    error?: string | undefined;
+    class?: string;
+  }
+
+  let {
+    name,
+    label,
+    id,
+    form,
+    accept,
+    multiple = false,
+    required = false,
+    disabled = false,
+    error,
+    class: className = '',
+  }: Props = $props();
+
+  const generatedId = $props.id();
+  const controlId = $derived(id ?? generatedId);
+</script>
+
+<div class={`lite-form-group ${className}`}>
+  <label for={controlId}>{label}</label>
+  <!-- 保留可见原生控件，无客户端脚本时仍可显示浏览器选择状态。 -->
+  <input
+    type="file"
+    id={controlId}
+    {name}
+    {form}
+    {accept}
+    {multiple}
+    {required}
+    {disabled}
+    class:lite-input-error={!!error}
+    class="lite-input"
+    aria-invalid={error ? 'true' : undefined}
+    aria-describedby={error ? `${controlId}-error` : undefined}
+  />
+  {#if error}
+    <p id={`${controlId}-error`} class="lite-error-text" role="alert">{error}</p>
+  {/if}
+</div>

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

@@ -0,0 +1,16 @@
+interface Props {
+    name: string;
+    label: string;
+    id?: string;
+    form?: string;
+    accept?: string;
+    multiple?: boolean;
+    required?: boolean;
+    disabled?: boolean;
+    /** Explicit undefined clears a previously displayed server error. */
+    error?: string | undefined;
+    class?: string;
+}
+declare const LiteFileUpload: import("svelte").Component<Props, {}, "">;
+type LiteFileUpload = ReturnType<typeof LiteFileUpload>;
+export default LiteFileUpload;

package/dist/components/LiteFilterBuilder.svelte

@@ -1,5 +1,6 @@
 <script lang="ts">
   import type { CrudOperator, FieldDefinition, Filter } from '@svadmin/core';
+  import { readFilterForm } from '../filter-form.js';
   import { t } from '@svadmin/core/i18n';
 
   export interface FilterRuleItem {
@@ -9,10 +10,13 @@
     value: unknown;
   }
 
+  type FilterNode =
+    | { kind: 'group'; id: string; operator: 'and' | 'or'; children: FilterNode[] }
+    | { kind: 'rule'; id: string; field: string; operator: CrudOperator; value: unknown };
+
   interface Props {
     fields?: FieldDefinition[];
     filters?: Filter[];
-    logicalOperator?: 'and' | 'or';
     action?: string;
     method?: 'GET' | 'POST';
     disabled?: boolean;
@@ -22,11 +26,28 @@
   let {
     fields = [],
     filters = [],
-    logicalOperator = 'and',
     action = '',
+    method = 'GET',
     disabled = false,
+    onApply,
   }: Props = $props();
 
+  const formId = $props.id();
+  let formError = $state('');
+
+  function handleSubmit(event: SubmitEvent): void {
+    if (disabled) { event.preventDefault(); return; }
+    // 无回调时保留原生 GET/POST；添加/删除规则仍交给原生服务端 action。
+    if (!onApply || (event.submitter instanceof HTMLButtonElement && event.submitter.name === '_action')) return;
+    event.preventDefault();
+    if (!(event.currentTarget instanceof HTMLFormElement)) return;
+    let next: Filter[];
+    try { next = readFilterForm(filters, availableFields, new FormData(event.currentTarget)); }
+    catch { formError = '筛选条件无效，请检查字段、运算符和值。'; return; }
+    formError = '';
+    onApply(next);
+  }
+
   const operatorOptions: { value: CrudOperator; label: string }[] = [
     { value: 'eq', label: '= 等于' },
     { value: 'ne', label: '!= 不等于' },
@@ -36,170 +57,103 @@
     { value: 'gte', label: '>= 大于等于' },
     { value: 'lt', label: '< 小于' },
     { value: 'lte', label: '<= 小于等于' },
-    { value: 'null', label: '为空 (null)' },
+    { value: 'null', label: '为空' },
     { value: 'nnull', label: '不为空' },
   ];
 
-  // Flatten initial filters or fallback to 1 empty rule
-  const initialRules = $derived.by(() => {
-    if (filters.length > 0) {
-      return filters.map((f, i) => ({
-        id: `rule_${i}`,
-        field: 'field' in f ? String(f.field) : (fields[0]?.key ?? ''),
-        operator: ('operator' in f ? f.operator : 'eq') as CrudOperator,
-        value: 'value' in f ? f.value : '',
-      }));
+  const availableFields = $derived(fields.filter(field => field.filterable !== false));
+
+  function nodeFromFilter(filter: Filter, path: string): FilterNode {
+    if ('field' in filter) {
+      return { kind: 'rule', id: `rule-${path}`, field: filter.field, operator: filter.operator, value: filter.value };
     }
-    return [
-      {
-        id: 'rule_0',
-        field: fields[0]?.key ?? '',
-        operator: 'eq' as CrudOperator,
-        value: '',
-      },
-    ];
-  });
+    return {
+      kind: 'group',
+      id: `group-${path}`,
+      operator: filter.operator,
+      children: filter.value.map((child, index) => nodeFromFilter(child, `${path}-${index}`)),
+    };
+  }
+
+  const nodes = $derived(filters.map((filter, index) => nodeFromFilter(filter, String(index))));
+
+  function readValue(node: FilterNode): unknown {
+    return node.kind === 'rule' ? node.value : undefined;
+  }
+
 </script>
 
 <div class="lite-filter-builder lite-form-group">
   <div class="lite-filter-header">
-    <div class="lite-filter-title">
-      <strong>{t('common.filters') || '高级多条件筛选'}</strong>
-      <select
-        name="logical_op"
-        class="lite-select lite-select-sm"
-        style="width: 120px; display: inline-block; margin-left: 8px;"
-        value={logicalOperator}
-        {disabled}
-      >
-        <option value="and">符合全部 (AND)</option>
-        <option value="or">符合任一 (OR)</option>
-      </select>
-    </div>
-    <div>
-      <button type="submit" name="_action" value="add_filter_rule" class="lite-btn lite-btn-sm" {disabled}>
-        + 添加条件
-      </button>
-    </div>
+    <strong>{t('common.filters') || '高级多条件筛选'}</strong>
+    <button type="submit" form={formId} class="lite-btn lite-btn-primary lite-btn-sm" disabled={disabled}>
+      应用筛选
+    </button>
   </div>
 
-  <div class="lite-filter-rules">
-    {#each initialRules as rule, idx (rule.id)}
-      <div class="lite-filter-row">
-        <!-- Field select -->
-        <select
-          name="filter_field_{idx}"
-          class="lite-select lite-filter-field"
-          value={rule.field}
-          {disabled}
-        >
-          {#each fields as fld (fld.key)}
-            <option value={fld.key}>{fld.label || fld.key}</option>
-          {/each}
-        </select>
-
-        <!-- Operator select -->
-        <select
-          name="filter_op_{idx}"
-          class="lite-select lite-filter-op"
-          value={rule.operator}
-          {disabled}
-        >
-          {#each operatorOptions as op (op.value)}
-            <option value={op.value}>{op.label}</option>
+  {#if formError}<p role="alert">{formError}</p>{/if}
+  <form id={formId} {action} {method} onsubmit={handleSubmit} class="lite-filter-form">
+    {#snippet renderNode(node: FilterNode, path: string, isRoot = false)}
+      {#if node.kind === 'group'}
+        <fieldset class="lite-filter-group" data-testid={isRoot ? 'lite-filter-root' : 'lite-filter-group'}>
+          <legend>
+            <label>
+              逻辑组
+              <select name={`filters[${path}][operator]`} value={node.operator} {disabled}>
+                <option value="and">AND (且)</option>
+                <option value="or">OR (或)</option>
+              </select>
+            </label>
+          </legend>
+          {#each node.children as child, index (child.id)}
+            {@render renderNode(child, `${path}.value.${index}`)}
+          {:else}
+            <p class="lite-hint">暂无筛选条件</p>
           {/each}
-        </select>
-
-        <!-- Value input -->
-        {#if rule.operator !== 'null' && rule.operator !== 'nnull'}
-          <input
-            type="text"
-            name="filter_val_{idx}"
-            class="lite-input lite-filter-val"
-            value={String(rule.value ?? '')}
-            placeholder="输入筛选值..."
-            {disabled}
-          />
-        {/if}
-
-        <!-- Remove row button -->
-        <button
-          type="submit"
-          name="_action"
-          value="remove_filter_rule_{idx}"
-          class="lite-btn lite-btn-sm lite-btn-danger"
-          {disabled}
-          title="删除此行条件"
-        >
-          ✕
-        </button>
-      </div>
-    {/each}
-  </div>
+          <button type="submit" name="_action" value={`add_filter_rule:${path}`} class="lite-btn lite-btn-sm" {disabled}>添加条件</button>
+          <button type="submit" name="_action" value={`add_filter_group:${path}`} class="lite-btn lite-btn-sm" {disabled}>添加条件组</button>
+        </fieldset>
+      {:else}
+        <div class="lite-filter-row" data-testid="lite-filter-rule">
+          <select name={`filters[${path}][field]`} value={node.field} {disabled}>
+            {#each availableFields as field (field.key)}<option value={field.key}>{field.label || field.key}</option>{/each}
+          </select>
+          <select name={`filters[${path}][operator]`} value={node.operator} {disabled}>
+            {#each operatorOptions as operator (operator.value)}<option value={operator.value}>{operator.label}</option>{/each}
+          </select>
+          {#if node.operator !== 'null' && node.operator !== 'nnull'}
+            {#if availableFields.find(field => field.key === node.field)?.type === 'boolean'}
+              <select name={`filters[${path}][value]`} value={String(readValue(node) ?? '')} {disabled}>
+                <option value="">请选择</option><option value="true">是</option><option value="false">否</option>
+              </select>
+            {:else}
+              <input name={`filters[${path}][value]`} type={availableFields.find(field => field.key === node.field)?.type === 'number' ? 'number' : 'text'} value={String(readValue(node) ?? '')} {disabled} />
+            {/if}
+          {/if}
+          <button type="submit" name="_action" value={`remove_filter_rule:${path}`} class="lite-btn lite-btn-sm lite-btn-danger" {disabled} title="删除此行条件">删除</button>
+        </div>
+      {/if}
+    {/snippet}
 
-  <div class="lite-filter-footer">
-    <button type="submit" class="lite-btn lite-btn-primary">
-      应用筛选
-    </button>
-    <a href={action || '?'} class="lite-btn" style="margin-left: 8px;">
-      重置
-    </a>
-  </div>
+    {#if nodes.length === 0}
+      <p class="lite-hint">暂无筛选条件，请先添加规则。</p>
+      <button type="submit" name="_action" value="add_filter_rule:root" class="lite-btn lite-btn-sm" {disabled}>添加条件</button>
+    {:else}
+      {#each nodes as node, index (node.id)}
+        {@render renderNode(node, String(index), node.kind === 'group' && nodes.length === 1)}
+      {/each}
+    {/if}
+  </form>
 </div>
 
 <style>
-  .lite-filter-builder {
-    border: 1px solid #cbd5e1;
-    border-radius: 6px;
-    padding: 14px;
-    background: #f8fafc;
-    margin-bottom: 16px;
-  }
-  .lite-filter-header {
-    display: flex;
-    justify-content: space-between;
-    align-items: center;
-    margin-bottom: 12px;
-  }
-  .lite-filter-rules {
-    display: flex;
-    flex-direction: column;
-    margin-bottom: 12px;
-  }
-  .lite-filter-row {
-    display: flex;
-    align-items: center;
-    background: #ffffff;
-    padding: 8px;
-    border: 1px solid #e2e8f0;
-    border-radius: 4px;
-    margin-bottom: 8px;
-  }
-  .lite-filter-row:last-child {
-    margin-bottom: 0;
-  }
-  .lite-filter-row > * {
-    margin-right: 8px;
-  }
-  .lite-filter-row > *:last-child {
-    margin-right: 0;
-  }
-  .lite-filter-field {
-    flex: 2;
-    min-width: 130px;
-  }
-  .lite-filter-op {
-    flex: 2;
-    min-width: 120px;
-  }
-  .lite-filter-val {
-    flex: 3;
-    min-width: 140px;
-  }
-  .lite-filter-footer {
-    display: flex;
-    align-items: center;
-    border-top: 1px solid #e2e8f0;
-    padding-top: 10px;
-  }
+  .lite-filter-builder { border: 1px solid #cbd5e1; border-radius: 6px; padding: 14px; background: #f8fafc; margin-bottom: 16px; }
+  .lite-filter-header { display: flex; justify-content: space-between; align-items: center; margin-bottom: 12px; }
+  .lite-filter-group { border: 1px solid #e2e8f0; border-radius: 4px; padding: 10px; margin-bottom: 8px; background: #fff; }
+  .lite-filter-row { display: flex; align-items: center; padding: 8px; border: 1px solid #e2e8f0; border-radius: 4px; margin-bottom: 8px; background: #fff; }
+  .lite-filter-row > * { min-width: 120px; flex: 1; }
+  .lite-filter-row > * + * { margin-left: 8px; }
+  .lite-filter-row .lite-btn { flex: 0 0 auto; }
+  .lite-hint { color: #64748b; font-size: 12px; }
+  .lite-btn { margin-right: 6px; }
 </style>

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

@@ -8,7 +8,6 @@ export interface FilterRuleItem {
 interface Props {
     fields?: FieldDefinition[];
     filters?: Filter[];
-    logicalOperator?: 'and' | 'or';
     action?: string;
     method?: 'GET' | 'POST';
     disabled?: boolean;

package/dist/components/LiteJsonSchemaForm.svelte

@@ -1,8 +1,17 @@
 <script lang="ts">
-  import { definedOptions } from '@svadmin/core/options';
+  interface JsonSchema {
+    type?: string;
+    title?: string;
+    description?: string;
+    properties?: Record<string, JsonSchema>;
+    items?: JsonSchema;
+    enum?: Array<string | number | boolean | null>;
+    default?: unknown;
+    required?: string[];
+  }
 
   interface Props {
-    schema: Record<string, unknown>;
+    schema: JsonSchema;
     value?: Record<string, unknown>;
     action?: string;
     method?: 'get' | 'post' | 'dialog' | 'GET' | 'POST' | 'DIALOG' | null;
@@ -11,94 +20,149 @@
 
   let {
     schema,
-    value = {},
+    value = $bindable({}),
     action = '',
     method = 'POST',
     submitText = 'Submit Form',
   }: Props = $props();
 
-  interface FieldMeta {
-    key: string;
-    title: string;
-    type: string;
-    enum?: Array<string | number>;
-    required?: boolean;
+  function cloneDefault(node: JsonSchema): unknown {
+    if (node.default !== undefined) return structuredClone(node.default);
+    if (node.type === 'object' || node.properties) {
+      return Object.fromEntries(
+        Object.entries(node.properties ?? {})
+          .map(([key, child]) => [key, cloneDefault(child)])
+          .filter(([, child]) => child !== undefined),
+      );
+    }
+    if (node.type === 'array') return [];
+    return undefined;
   }
 
-  const properties = $derived.by<FieldMeta[]>(() => {
-    const propsObj = (schema['properties'] ?? {}) as Record<string, Record<string, unknown>>;
-    const requiredKeys = Array.isArray(schema['required']) ? (schema['required'] as string[]) : [];
+  function mergeDefaults(node: JsonSchema, current: unknown): unknown {
+    if (node.type === 'array') {
+      if (!Array.isArray(current)) return cloneDefault(node);
+      return current.map(item => node.items ? mergeDefaults(node.items, item) : item);
+    }
+    if (node.type !== 'object' && !node.properties) return current ?? cloneDefault(node);
+    const source = current && typeof current === 'object' && !Array.isArray(current)
+      ? current as Record<string, unknown>
+      : {};
+    const result: Record<string, unknown> = { ...source };
+    for (const [key, child] of Object.entries(node.properties ?? {})) {
+      const next = mergeDefaults(child, result[key]);
+      if (next !== undefined) result[key] = next;
+    }
+    return result;
+  }
 
-    return Object.entries(propsObj).map(([key, propDef]) => (definedOptions({
-      key,
-      title: String(propDef['title'] ?? key),
-      type: String(propDef['type'] ?? 'string'),
-      enum: Array.isArray(propDef['enum']) ? (propDef['enum'] as Array<string | number>) : undefined,
-      required: requiredKeys.includes(key),
-    })));
+  $effect(() => {
+    const next = mergeDefaults(schema, value);
+    if (JSON.stringify(next) !== JSON.stringify(value)) value = next as Record<string, unknown>;
   });
+
+  function readPath(path: string[]): unknown {
+    return path.reduce<unknown>((current, key) => (
+      current && typeof current === 'object' ? (current as Record<string, unknown>)[key] : undefined
+    ), value);
+  }
+
+  function writePath(path: string[], nextValue: unknown): void {
+    const next = structuredClone(value);
+    let target: Record<string, unknown> = next;
+    for (const key of path.slice(0, -1)) {
+      const child = target[key];
+      target[key] = child && typeof child === 'object' ? child : {};
+      target = target[key] as Record<string, unknown>;
+    }
+    const lastKey = path[path.length - 1];
+    if (lastKey !== undefined) target[lastKey] = nextValue;
+    value = next;
+  }
+
+  function enumValue(raw: string, options: JsonSchema['enum']): unknown {
+    return options?.find(option => String(option) === raw) ?? raw;
+  }
+
+  function addArrayItem(path: string[], itemSchema: JsonSchema): void {
+    const current = readPath(path);
+    const items = Array.isArray(current) ? current : [];
+    writePath(path, [...items, cloneDefault(itemSchema) ?? (itemSchema.type === 'object' ? {} : '')]);
+  }
+
+  function removeArrayItem(path: string[], index: number): void {
+    const current = readPath(path);
+    if (Array.isArray(current)) writePath(path, current.filter((_, itemIndex) => itemIndex !== index));
+  }
 </script>
 
 <div class="lite-schema-form-card">
-  {#if schema['title']}
-    <div class="lite-schema-form-header">
-      <strong>{schema['title']}</strong>
-    </div>
-  {/if}
+  {#if schema.title}<div class="lite-schema-form-header"><strong>{schema.title}</strong></div>{/if}
+  {#if schema.description}<p class="lite-schema-description">{schema.description}</p>{/if}
 
   <form {action} {method} class="lite-schema-form">
-    {#each properties as field (field.key)}
-      <div class="lite-schema-field">
-        <label for="lite_json_{field.key}" class="lite-label">
-          {field.title} {#if field.required}<span style="color: #ef4444;">*</span>{/if}
-        </label>
-        {#if field.enum}
-          <select id="lite_json_{field.key}" name={field.key} class="lite-select" required={field.required}>
-            {#each field.enum as option (option)}
-              <option value={String(option)} selected={String(value[field.key]) === String(option)}>
-                {option}
-              </option>
-            {/each}
-          </select>
-        {:else if field.type === 'boolean'}
-          <input id="lite_json_{field.key}" type="checkbox" name={field.key} checked={Boolean(value[field.key])} />
-        {:else if field.type === 'number' || field.type === 'integer'}
-          <input id="lite_json_{field.key}" type="number" name={field.key} value={Number(value[field.key] ?? 0)} class="lite-input" required={field.required} />
-        {:else}
-          <input id="lite_json_{field.key}" type="text" name={field.key} value={String(value[field.key] ?? '')} class="lite-input" required={field.required} />
-        {/if}
-      </div>
-    {/each}
+    {#snippet renderField(node: JsonSchema, path: string[], title: string, required = false)}
+      {@const current = readPath(path)}
+      {@const id = `lite_json_${path.join('_')}`}
+      {#if node.type === 'object' || node.properties}
+        <fieldset class="lite-schema-fieldset">
+          <legend>{title}</legend>
+          {#if node.description}<p class="lite-schema-description">{node.description}</p>{/if}
+          {#each Object.entries(node.properties ?? {}) as [key, child] (key)}
+            {@render renderField(child, [...path, key], child.title ?? key, node.required?.includes(key) ?? false)}
+          {/each}
+        </fieldset>
+      {:else if node.type === 'array'}
+        {@const items = Array.isArray(current) ? current : []}
+        <fieldset class="lite-schema-fieldset">
+          <legend>{title}</legend>
+          {#if node.description}<p class="lite-schema-description">{node.description}</p>{/if}
+          {#each items as _, index (index)}
+            {@render renderField(node.items ?? { type: 'string' }, [...path, String(index)], `${title} ${index + 1}`)}
+            <button type="button" class="lite-btn lite-btn-sm" onclick={() => removeArrayItem(path, index)}>Remove</button>
+          {:else}
+            <span class="lite-hint">No items</span>
+          {/each}
+          <button type="button" class="lite-btn lite-btn-sm" onclick={() => addArrayItem(path, node.items ?? { type: 'string' })}>Add item</button>
+        </fieldset>
+      {:else}
+        <div class="lite-schema-field">
+          <label for={id} class="lite-label">{title}{#if required}<span aria-hidden="true">*</span>{/if}</label>
+          {#if node.description}<p class="lite-schema-description">{node.description}</p>{/if}
+          {#if node.enum}
+            <select id={id} required={required} value={String(current ?? '')} onchange={(event) => writePath(path, enumValue(event.currentTarget.value, node.enum))} class="lite-select">
+              <option value="">Select an option</option>
+              {#each node.enum as option (String(option))}<option value={String(option)}>{String(option)}</option>{/each}
+            </select>
+          {:else if node.type === 'boolean'}
+            <input id={id} type="checkbox" checked={Boolean(current)} onchange={(event) => writePath(path, event.currentTarget.checked)} />
+          {:else if node.type === 'number' || node.type === 'integer'}
+            <input id={id} type="number" required={required} value={current === undefined ? '' : String(current)} oninput={(event) => writePath(path, event.currentTarget.value === '' ? undefined : Number(event.currentTarget.value))} class="lite-input" />
+          {:else}
+            <input id={id} type="text" required={required} value={String(current ?? '')} oninput={(event) => writePath(path, event.currentTarget.value)} class="lite-input" />
+          {/if}
+        </div>
+      {/if}
+    {/snippet}
 
+    {#each Object.entries(schema.properties ?? {}) as [key, node] (key)}
+      {@render renderField(node, [key], node.title ?? key, schema.required?.includes(key) ?? false)}
+    {/each}
     <div class="lite-schema-footer">
-      <button type="submit" class="lite-btn lite-btn-primary lite-btn-sm">
-        {submitText}
-      </button>
+      <button type="submit" class="lite-btn lite-btn-primary lite-btn-sm">{submitText}</button>
     </div>
   </form>
 </div>
 
 <style>
-  .lite-schema-form-card {
-    background: #ffffff;
-    border: 1px solid #cbd5e1;
-    border-radius: 6px;
-    padding: 16px;
-    margin-bottom: 16px;
-  }
-  .lite-schema-form-header {
-    padding-bottom: 8px;
-    border-bottom: 1px solid #e2e8f0;
-    margin-bottom: 12px;
-    font-size: 14px;
-  }
-  .lite-schema-field {
-    margin-bottom: 12px;
-  }
-  .lite-schema-footer {
-    display: flex;
-    justify-content: flex-end;
-    padding-top: 12px;
-    border-top: 1px solid #e2e8f0;
-  }
+  .lite-schema-form-card { background: #fff; border: 1px solid #cbd5e1; border-radius: 6px; padding: 16px; margin-bottom: 16px; }
+  .lite-schema-form-header { padding-bottom: 8px; border-bottom: 1px solid #e2e8f0; margin-bottom: 12px; font-size: 14px; }
+  .lite-schema-fieldset { border: 1px solid #e2e8f0; border-radius: 4px; padding: 12px; margin: 0 0 12px; }
+  .lite-schema-field { margin-bottom: 12px; }
+  .lite-schema-fieldset > .lite-schema-field:last-child { margin-bottom: 0; }
+  .lite-schema-footer { display: flex; justify-content: flex-end; padding-top: 12px; border-top: 1px solid #e2e8f0; }
+  .lite-label { display: block; font-size: 12px; color: #475569; margin-bottom: 4px; }
+  .lite-schema-description, .lite-hint { font-size: 12px; color: #64748b; }
+  .lite-input, .lite-select { width: 100%; }
+  .lite-btn { margin-right: 6px; }
 </style>

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

@@ -1,10 +1,20 @@
+interface JsonSchema {
+    type?: string;
+    title?: string;
+    description?: string;
+    properties?: Record<string, JsonSchema>;
+    items?: JsonSchema;
+    enum?: Array<string | number | boolean | null>;
+    default?: unknown;
+    required?: string[];
+}
 interface Props {
-    schema: Record<string, unknown>;
+    schema: JsonSchema;
     value?: Record<string, unknown>;
     action?: string;
     method?: 'get' | 'post' | 'dialog' | 'GET' | 'POST' | 'DIALOG' | null;
     submitText?: string;
 }
-declare const LiteJsonSchemaForm: import("svelte").Component<Props, {}, "">;
+declare const LiteJsonSchemaForm: import("svelte").Component<Props, {}, "value">;
 type LiteJsonSchemaForm = ReturnType<typeof LiteJsonSchemaForm>;
 export default LiteJsonSchemaForm;

package/dist/filter-form.d.ts

@@ -0,0 +1,3 @@
+import type { FieldDefinition, Filter } from '@svadmin/core';
+/** 使用已有拓扑读取当前表单值，不把用户字段名解释成对象路径。服务端仍须独立授权。 */
+export declare function readFilterForm(filters: readonly Filter[], fields: readonly FieldDefinition[], data: FormData): Filter[];

package/dist/filter-form.js

@@ -0,0 +1,34 @@
+/** 使用已有拓扑读取当前表单值，不把用户字段名解释成对象路径。服务端仍须独立授权。 */
+export function readFilterForm(filters, fields, data) {
+    const operators = new Set(['eq', 'ne', 'contains', 'ncontains', 'gt', 'gte', 'lt', 'lte', 'null', 'nnull']);
+    function read(filter, path) {
+        const get = (key) => data.get(`filters[${path}][${key}]`);
+        if (!('field' in filter)) {
+            const operator = get('operator');
+            if (operator !== 'and' && operator !== 'or')
+                throw new TypeError('Invalid filter group');
+            return { operator, value: filter.value.map((child, index) => read(child, `${path}.value.${index}`)) };
+        }
+        const field = fields.find(candidate => candidate.key === get('field') && candidate.filterable !== false);
+        const operator = get('operator');
+        if (!field || typeof operator !== 'string' || !operators.has(operator))
+            throw new TypeError('Invalid filter rule');
+        let value = get('value');
+        if (operator === 'null' || operator === 'nnull')
+            value = null;
+        else if (typeof value !== 'string')
+            throw new TypeError('Invalid filter value');
+        else if (['number', 'currency', 'percent'].includes(field.type)) {
+            if (!value.trim() || !Number.isFinite(Number(value)))
+                throw new TypeError('Invalid numeric filter');
+            value = Number(value);
+        }
+        else if (field.type === 'boolean') {
+            if (value !== 'true' && value !== 'false')
+                throw new TypeError('Invalid boolean filter');
+            value = value === 'true';
+        }
+        return { field: field.key, operator: operator, value };
+    }
+    return filters.map((filter, index) => read(filter, String(index)));
+}

package/dist/index.d.ts

@@ -9,6 +9,7 @@ export { default as LiteTable } from './components/LiteTable.svelte';
 export { default as LitePagination } from './components/LitePagination.svelte';
 export { default as LiteForm } from './components/LiteForm.svelte';
 export { default as LiteFileInput } from './components/LiteFileInput.svelte';
+export { default as LiteFileUpload } from './components/LiteFileUpload.svelte';
 export { default as LiteLogin } from './components/LiteLogin.svelte';
 export { default as LiteShow } from './components/LiteShow.svelte';
 export { default as LiteSearch } from './components/LiteSearch.svelte';

package/dist/index.js

@@ -13,6 +13,7 @@ export { default as LiteTable } from './components/LiteTable.svelte';
 export { default as LitePagination } from './components/LitePagination.svelte';
 export { default as LiteForm } from './components/LiteForm.svelte';
 export { default as LiteFileInput } from './components/LiteFileInput.svelte';
+export { default as LiteFileUpload } from './components/LiteFileUpload.svelte';
 export { default as LiteLogin } from './components/LiteLogin.svelte';
 export { default as LiteShow } from './components/LiteShow.svelte';
 export { default as LiteSearch } from './components/LiteSearch.svelte';

package/dist/server-adapter.js

@@ -58,7 +58,60 @@ function listRequestFilters(resource, url) {
             });
         }
     }
-    return filters;
+    const structured = parseStructuredFilters(resource, url);
+    return structured.length > 0 ? structured : filters;
+}
+function parseStructuredFilters(resource, url) {
+    const entries = [...url.searchParams.entries()]
+        .map(([key, value]) => {
+        const match = /^filters\[([0-9]+(?:\.value\.[0-9]+)*)\]\[(field|operator|value)\]$/.exec(key);
+        return match ? { path: match[1], property: match[2], value } : undefined;
+    })
+        .filter((entry) => entry !== undefined);
+    if (entries.length === 0)
+        return [];
+    const roots = [];
+    for (const entry of entries) {
+        const segments = [...entry.path.matchAll(/\d+/g)].map(match => Number(match[0]));
+        const rootIndex = segments.shift();
+        if (rootIndex === undefined || !Number.isSafeInteger(rootIndex) || rootIndex < 0)
+            continue;
+        let node = roots[rootIndex];
+        if (!node) {
+            node = {};
+            roots[rootIndex] = node;
+        }
+        for (const childIndex of segments) {
+            if (!Number.isSafeInteger(childIndex) || childIndex < 0)
+                break;
+            node.children ??= [];
+            node = node.children[childIndex] ??= {};
+        }
+        node[entry.property] = entry.value;
+    }
+    function compile(node) {
+        const operator = node.operator;
+        if (node.field && operator && operator !== 'and' && operator !== 'or') {
+            const field = resource.fields.find(candidate => candidate.key === node.field);
+            if (!field)
+                return undefined;
+            if (operator === 'null' || operator === 'nnull') {
+                return { field: node.field, operator: operator, value: null };
+            }
+            if (node.value === undefined || node.value === '')
+                return undefined;
+            const value = field.type === 'number' || field.type === 'currency' || field.type === 'percent'
+                ? Number(node.value)
+                : field.type === 'boolean' ? node.value === 'true' : node.value;
+            return { field: node.field, operator: operator, value };
+        }
+        if ((operator === 'and' || operator === 'or') && node.children) {
+            const children = node.children.map(compile).filter((child) => child !== undefined);
+            return children.length > 0 ? { operator, value: children } : undefined;
+        }
+        return undefined;
+    }
+    return roots.map(compile).filter((filter) => filter !== undefined);
 }
 /**
  * Creates a SvelteKit `load` function that fetches a resource list

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svadmin/lite",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "SSR-first lightweight admin UI for @svadmin with optional progressive enhancement",
   "type": "module",
   "sideEffects": [
@@ -49,7 +49,7 @@
   },
   "peerDependencies": {
     "svelte": "^5.56.10",
-    "@svadmin/core": ">=0.34.2 <0.53.0",
+    "@svadmin/core": ">=0.34.2 <0.54.0",
     "@sveltejs/kit": "^2.70.3"
   },
   "dependencies": {