@h-ai/ui 0.1.0-alpha5

package/dist/components/scenes/app/ThemeToggle.svelte.d.ts

@@ -0,0 +1,29 @@
+interface Props {
+    currentTheme?: string;
+    onchange?: (theme: string) => void;
+    lightTheme?: string;
+    darkTheme?: string;
+    labels?: {
+        switchToLight?: string;
+        switchToDark?: string;
+    };
+    class?: string;
+}
+/**
+ * ThemeToggle
+ * 主题切换按钮组件，支持明/暗主题快速切换。
+ *
+ * @prop {string} currentTheme - 当前主题
+ * @prop {function} onchange - 主题变更回调
+ * @prop {string} lightTheme - 亮色主题名称
+ * @prop {string} darkTheme - 暗色主题名称
+ *
+ * @example
+ * <ThemeToggle
+ *   currentTheme={$theme}
+ *   onchange={(theme) => themeStore.set(theme)}
+ * />
+ */
+declare const ThemeToggle: import("svelte").Component<Props, {}, "">;
+type ThemeToggle = ReturnType<typeof ThemeToggle>;
+export default ThemeToggle;

package/dist/components/scenes/app/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @h-ai/ui — 应用级场景组件 (App Scenes)
+ *
+ * 面向应用层的通用功能组件，包含设置、反馈、语言/主题切换等。 内置中英文翻译，自动响应全局 locale。
+ * @module index
+ */
+export { default as FeedbackModal } from './FeedbackModal.svelte';
+export { default as LanguageSwitch } from './LanguageSwitch.svelte';
+export { default as SettingsModal } from './SettingsModal.svelte';
+export { default as ThemeSelector } from './ThemeSelector.svelte';
+export { default as ThemeToggle } from './ThemeToggle.svelte';

package/dist/components/scenes/app/index.js

@@ -0,0 +1,11 @@
+/**
+ * @h-ai/ui — 应用级场景组件 (App Scenes)
+ *
+ * 面向应用层的通用功能组件，包含设置、反馈、语言/主题切换等。 内置中英文翻译，自动响应全局 locale。
+ * @module index
+ */
+export { default as FeedbackModal } from './FeedbackModal.svelte';
+export { default as LanguageSwitch } from './LanguageSwitch.svelte';
+export { default as SettingsModal } from './SettingsModal.svelte';
+export { default as ThemeSelector } from './ThemeSelector.svelte';
+export { default as ThemeToggle } from './ThemeToggle.svelte';

package/dist/components/scenes/crud/CrudDeleteConfirm.svelte

@@ -0,0 +1,39 @@
+<!--
+  @component CrudDeleteConfirm
+  CRUD 删除确认对话框
+
+  使用 Svelte 5 Runes ($props)
+  使用 compounds 组件：Confirm
+-->
+<script lang='ts'>
+  import { uiM } from '../../../messages.js'
+  import Confirm from '../../compounds/Confirm.svelte'
+
+  let {
+    open = $bindable(false),
+    loading = false,
+    title = '',
+    message = '',
+    onconfirm,
+    oncancel,
+  }: {
+    open?: boolean
+    loading?: boolean
+    title?: string
+    message?: string
+    onconfirm?: () => Promise<void> | void
+    oncancel?: () => void
+  } = $props()
+</script>
+
+<Confirm
+  bind:open
+  title={title || uiM('crud_delete_title')}
+  message={message || uiM('crud_delete_message')}
+  confirmText={uiM('crud_delete')}
+  cancelText={uiM('crud_cancel')}
+  variant='error'
+  {loading}
+  {onconfirm}
+  {oncancel}
+/>

package/dist/components/scenes/crud/CrudDeleteConfirm.svelte.d.ts

@@ -0,0 +1,18 @@
+type $$ComponentProps = {
+    open?: boolean;
+    loading?: boolean;
+    title?: string;
+    message?: string;
+    onconfirm?: () => Promise<void> | void;
+    oncancel?: () => void;
+};
+/**
+ * CrudDeleteConfirm
+ * CRUD 删除确认对话框
+ *
+ * 使用 Svelte 5 Runes ($props)
+ * 使用 compounds 组件：Confirm
+ */
+declare const CrudDeleteConfirm: import("svelte").Component<$$ComponentProps, {}, "open">;
+type CrudDeleteConfirm = ReturnType<typeof CrudDeleteConfirm>;
+export default CrudDeleteConfirm;

package/dist/components/scenes/crud/CrudDetailDrawer.svelte

@@ -0,0 +1,155 @@
+<!--
+  @component CrudDetailDrawer
+  CRUD 详情抽屉组件（只读展示）
+
+  使用 Svelte 5 Runes ($props, $derived)
+  使用 compounds 组件：Drawer, Badge
+-->
+<script lang='ts'>
+  import type { Snippet } from 'svelte'
+  import type { Size } from '../../../types.js'
+  import { uiM } from '../../../messages.js'
+  import Drawer from '../../compounds/Drawer.svelte'
+  import Badge from '../../primitives/Badge.svelte'
+  import Button from '../../primitives/Button.svelte'
+
+  type FieldDef = {
+    id: string
+    label: string | (() => string)
+    type: string
+    inDetail?: boolean
+    options?: Array<{ label: string, value: string | number | boolean }> | (() => Array<{ label: string, value: string | number | boolean }>)
+    render?: (value: unknown, item: Record<string, unknown>) => string
+    order?: number
+  }
+
+  let {
+    open = $bindable(false),
+    item = null,
+    fields = [],
+    title = '',
+    size = '2xl' as Size,
+    canEdit = false,
+    onedit,
+    onclose,
+    detailExtra,
+  }: {
+    open?: boolean
+    item?: Record<string, unknown> | null
+    fields?: FieldDef[]
+    title?: string
+    size?: Size
+    canEdit?: boolean
+    onedit?: () => void
+    onclose?: () => void
+    detailExtra?: Snippet<[Record<string, unknown>]>
+  } = $props()
+
+  function resolveText(text: string | (() => string)): string {
+    return typeof text === 'function' ? text() : text
+  }
+
+  function resolveOptions(options?: FieldDef['options']): Array<{ label: string, value: string | number | boolean }> {
+    if (!options)
+      return []
+    return typeof options === 'function' ? options() : options
+  }
+
+  function formatValue(field: FieldDef, value: unknown): string {
+    if (value === null || value === undefined)
+      return uiM('crud_detail_empty')
+
+    if (field.render && item) {
+      return field.render(value, item)
+    }
+
+    // 选项类型：将 value 映射为 label
+    if (field.type === 'select' || field.type === 'radio') {
+      const opts = resolveOptions(field.options)
+      const found = opts.find(o => String(o.value) === String(value))
+      return found?.label ?? String(value)
+    }
+
+    // 多选类型
+    if (field.type === 'multi-select' && Array.isArray(value)) {
+      const opts = resolveOptions(field.options)
+      return value.map((v) => {
+        const found = opts.find(o => String(o.value) === String(v))
+        return found?.label ?? String(v)
+      }).join(', ')
+    }
+
+    // 布尔
+    if (field.type === 'boolean' || field.type === 'checkbox') {
+      return value ? '✓' : '✗'
+    }
+
+    // 日期/时间
+    if (field.type === 'date' && (typeof value === 'string' || typeof value === 'number' || value instanceof Date)) {
+      return new Date(value as string | number).toLocaleDateString()
+    }
+    if (field.type === 'datetime' && (typeof value === 'string' || typeof value === 'number' || value instanceof Date)) {
+      return new Date(value as string | number).toLocaleString()
+    }
+
+    return String(value)
+  }
+
+  const detailFields = $derived(
+    [...fields]
+      .filter(f => f.inDetail !== false)
+      .sort((a, b) => (a.order ?? 0) - (b.order ?? 0)),
+  )
+
+  function handleClose() {
+    open = false
+    onclose?.()
+  }
+</script>
+
+<Drawer bind:open {title} position='right' {size} onclose={handleClose}>
+  {#if item}
+    <div class='space-y-4 pb-20'>
+      {#each detailFields as field}
+        {@const value = item[field.id]}
+        <div>
+          <div class='text-xs font-medium text-base-content/50 mb-1'>
+            {resolveText(field.label)}
+          </div>
+          <div class='text-sm text-base-content'>
+            {#if field.type === 'multi-select' && Array.isArray(value) && value.length > 0}
+              <div class='flex flex-wrap gap-1'>
+                {#each value as v}
+                  {@const opts = resolveOptions(field.options)}
+                  {@const found = opts.find(o => String(o.value) === String(v))}
+                  <Badge variant='ghost' size='sm'>{found?.label ?? String(v)}</Badge>
+                {/each}
+              </div>
+            {:else}
+              {formatValue(field, value)}
+            {/if}
+          </div>
+        </div>
+      {/each}
+
+      {#if detailExtra && item}
+        <div class='border-t border-base-content/5 pt-4'>
+          {@render detailExtra(item)}
+        </div>
+      {/if}
+    </div>
+
+    <!-- 底部操作栏 -->
+    <div class='absolute bottom-0 left-0 right-0 p-4 bg-base-200 border-t border-base-content/10 flex justify-end gap-2'>
+      {#if canEdit}
+        <Button variant='primary' onclick={onedit}>
+          <span class='icon-[tabler--edit] size-4 mr-1'></span>
+          {uiM('crud_edit')}
+        </Button>
+      {/if}
+      <Button variant='ghost' onclick={handleClose}>
+        {uiM('crud_close')}
+      </Button>
+    </div>
+  {/if}
+</Drawer>

package/dist/components/scenes/crud/CrudDetailDrawer.svelte.d.ts

@@ -0,0 +1,38 @@
+import type { Snippet } from 'svelte';
+import type { Size } from '../../../types.js';
+type FieldDef = {
+    id: string;
+    label: string | (() => string);
+    type: string;
+    inDetail?: boolean;
+    options?: Array<{
+        label: string;
+        value: string | number | boolean;
+    }> | (() => Array<{
+        label: string;
+        value: string | number | boolean;
+    }>);
+    render?: (value: unknown, item: Record<string, unknown>) => string;
+    order?: number;
+};
+type $$ComponentProps = {
+    open?: boolean;
+    item?: Record<string, unknown> | null;
+    fields?: FieldDef[];
+    title?: string;
+    size?: Size;
+    canEdit?: boolean;
+    onedit?: () => void;
+    onclose?: () => void;
+    detailExtra?: Snippet<[Record<string, unknown>]>;
+};
+/**
+ * CrudDetailDrawer
+ * CRUD 详情抽屉组件（只读展示）
+ *
+ * 使用 Svelte 5 Runes ($props, $derived)
+ * 使用 compounds 组件：Drawer, Badge
+ */
+declare const CrudDetailDrawer: import("svelte").Component<$$ComponentProps, {}, "open">;
+type CrudDetailDrawer = ReturnType<typeof CrudDetailDrawer>;
+export default CrudDetailDrawer;

package/dist/components/scenes/crud/CrudEditDrawer.svelte

@@ -0,0 +1,222 @@
+<!--
+  @component CrudEditDrawer
+  CRUD 编辑/新建抽屉组件
+
+  使用 Svelte 5 Runes ($props, $state, $derived)
+  使用 compounds/primitives 组件：Drawer, FormField, Input, Select, Textarea, Checkbox, Button
+-->
+<script lang='ts'>
+  import type { Snippet } from 'svelte'
+  import type { Size } from '../../../types.js'
+  import { uiM } from '../../../messages.js'
+  import Drawer from '../../compounds/Drawer.svelte'
+  import FormField from '../../compounds/FormField.svelte'
+  import Button from '../../primitives/Button.svelte'
+  import Checkbox from '../../primitives/Checkbox.svelte'
+  import Input from '../../primitives/Input.svelte'
+  import Select from '../../primitives/Select.svelte'
+  import Textarea from '../../primitives/Textarea.svelte'
+
+  type FieldDef = {
+    id: string
+    label: string | (() => string)
+    type: string
+    readonly?: boolean
+    options?: Array<{ label: string, value: string | number | boolean }> | (() => Array<{ label: string, value: string | number | boolean }>)
+    validation?: { required?: boolean, min?: number, max?: number, pattern?: string, message?: string }
+    placeholder?: string | (() => string)
+    order?: number
+  }
+
+  let {
+    open = $bindable(false),
+    mode = 'create' as 'create' | 'edit',
+    fields = [],
+    formData = $bindable<Record<string, unknown>>({}),
+    title = '',
+    size = '2xl' as Size,
+    submitting = false,
+    error = '',
+    onsubmit,
+    onclose,
+    editFormExtra,
+    editingItem = null,
+  }: {
+    open?: boolean
+    mode?: 'create' | 'edit'
+    fields?: FieldDef[]
+    formData?: Record<string, unknown>
+    title?: string
+    size?: Size
+    submitting?: boolean
+    error?: string
+    onsubmit?: (data: Record<string, unknown>) => Promise<void>
+    onclose?: () => void
+    editFormExtra?: Snippet<[Record<string, unknown> | null, 'create' | 'edit']>
+    editingItem?: Record<string, unknown> | null
+  } = $props()
+
+  function resolveText(text: string | (() => string)): string {
+    return typeof text === 'function' ? text() : text
+  }
+
+  function resolveOptions(options?: FieldDef['options']): Array<{ label: string, value: string | number | boolean }> {
+    if (!options)
+      return []
+    return typeof options === 'function' ? options() : options
+  }
+
+  const sortedFields = $derived(
+    [...fields].sort((a, b) => (a.order ?? 0) - (b.order ?? 0)),
+  )
+
+  function handleClose() {
+    open = false
+    onclose?.()
+  }
+
+  async function handleSubmit(e: Event) {
+    e.preventDefault()
+    await onsubmit?.(formData)
+  }
+
+  function getInputType(fieldType: string): string {
+    switch (fieldType) {
+      case 'email': return 'email'
+      case 'url': return 'url'
+      case 'tel': return 'tel'
+      case 'password': return 'password'
+      case 'number': return 'number'
+      case 'date': return 'text'
+      case 'datetime': return 'text'
+      default: return 'text'
+    }
+  }
+
+  function updateField(fieldId: string, value: unknown) {
+    formData = { ...formData, [fieldId]: value }
+  }
+
+  function toggleMultiSelect(fieldId: string, optValue: string | number | boolean) {
+    const current = (formData[fieldId] as Array<string | number | boolean>) ?? []
+    const strVal = String(optValue)
+    if (current.map(String).includes(strVal)) {
+      formData = { ...formData, [fieldId]: current.filter(v => String(v) !== strVal) }
+    }
+    else {
+      formData = { ...formData, [fieldId]: [...current, optValue] }
+    }
+  }
+</script>
+
+<Drawer bind:open {title} position='right' {size} onclose={handleClose} closeOnBackdrop={false}>
+  <form onsubmit={handleSubmit} class='space-y-4 pb-20'>
+    {#if error}
+      <div class='p-3 bg-error/10 border border-error/20 rounded-lg text-sm text-error flex items-center gap-2'>
+        <span class='icon-[tabler--alert-circle] size-4 shrink-0'></span>
+        <span>{error}</span>
+      </div>
+    {/if}
+
+    {#each sortedFields as field}
+      {@const isReadonly = field.readonly && mode === 'edit'}
+      {@const isRequired = field.validation?.required}
+      {@const fieldValue = formData[field.id]}
+      {@const placeholder = field.placeholder ? resolveText(field.placeholder) : ''}
+
+      {#if field.type === 'textarea'}
+        <FormField label={resolveText(field.label)} required={isRequired}>
+          <Textarea
+            value={String(fieldValue ?? '')}
+            {placeholder}
+            disabled={submitting || isReadonly}
+            required={isRequired}
+            oninput={e => updateField(field.id, (e.target as HTMLTextAreaElement).value)}
+          />
+        </FormField>
+
+      {:else if field.type === 'select' || field.type === 'radio'}
+        {@const opts = resolveOptions(field.options)}
+        <FormField label={resolveText(field.label)} required={isRequired}>
+          <Select
+            value={String(fieldValue ?? '')}
+            disabled={submitting || isReadonly}
+            onchange={e => updateField(field.id, (e.target as HTMLSelectElement).value)}
+          >
+            <option value="">{placeholder || uiM('crud_filter_all')}</option>
+            {#each opts as opt}
+              <option value={String(opt.value)}>{opt.label}</option>
+            {/each}
+          </Select>
+        </FormField>
+
+      {:else if field.type === 'multi-select'}
+        {@const opts = resolveOptions(field.options)}
+        {@const selectedValues = ((fieldValue ?? []) as Array<string | number | boolean>).map(String)}
+        <FormField label={resolveText(field.label)} required={isRequired}>
+          <div class='flex flex-wrap gap-3 p-3 bg-base-200 rounded-lg max-h-48 overflow-y-auto'>
+            {#each opts as opt}
+              <label class='inline-flex items-center gap-2 cursor-pointer'>
+                <Checkbox
+                  size='sm'
+                  checked={selectedValues.includes(String(opt.value))}
+                  onchange={() => toggleMultiSelect(field.id, opt.value)}
+                  disabled={submitting || isReadonly}
+                />
+                <span class='text-sm text-base-content'>{opt.label}</span>
+              </label>
+            {/each}
+            {#if opts.length === 0}
+              <span class='text-sm text-base-content/60'>{uiM('crud_no_data')}</span>
+            {/if}
+          </div>
+        </FormField>
+
+      {:else if field.type === 'boolean' || field.type === 'checkbox'}
+        <FormField label={resolveText(field.label)}>
+          <Checkbox
+            checked={Boolean(fieldValue)}
+            onchange={checked => updateField(field.id, checked)}
+            disabled={submitting || isReadonly}
+          />
+        </FormField>
+
+      {:else}
+        <FormField label={resolveText(field.label)} required={isRequired}>
+          <Input
+            type={getInputType(field.type)}
+            value={String(fieldValue ?? '')}
+            {placeholder}
+            disabled={submitting || isReadonly}
+            required={isRequired}
+            pattern={field.validation?.pattern}
+            minlength={field.type !== 'number' ? field.validation?.min : undefined}
+            maxlength={field.type !== 'number' ? field.validation?.max : undefined}
+            min={field.type === 'number' ? field.validation?.min : undefined}
+            max={field.type === 'number' ? field.validation?.max : undefined}
+            oninput={e => updateField(field.id, field.type === 'number' ? Number((e.currentTarget as HTMLInputElement).value) : (e.currentTarget as HTMLInputElement).value)}
+          />
+        </FormField>
+      {/if}
+    {/each}
+
+    {#if editFormExtra}
+      <div class='border-t border-base-content/5 pt-4'>
+        {@render editFormExtra(editingItem, mode)}
+      </div>
+    {/if}
+  </form>
+
+  <!-- 底部操作栏 -->
+  <div class='absolute bottom-0 left-0 right-0 p-4 bg-base-200 border-t border-base-content/10 flex justify-end gap-2'>
+    <Button variant='ghost' onclick={handleClose} disabled={submitting}>
+      {uiM('crud_cancel')}
+    </Button>
+    <Button variant='primary' onclick={handleSubmit} disabled={submitting}>
+      {#if submitting}
+        <span class='loading loading-spinner loading-xs mr-2'></span>
+      {/if}
+      {mode === 'create' ? uiM('crud_create') : uiM('crud_save')}
+    </Button>
+  </div>
+</Drawer>

package/dist/components/scenes/crud/CrudEditDrawer.svelte.d.ts

@@ -0,0 +1,48 @@
+import type { Snippet } from 'svelte';
+import type { Size } from '../../../types.js';
+type FieldDef = {
+    id: string;
+    label: string | (() => string);
+    type: string;
+    readonly?: boolean;
+    options?: Array<{
+        label: string;
+        value: string | number | boolean;
+    }> | (() => Array<{
+        label: string;
+        value: string | number | boolean;
+    }>);
+    validation?: {
+        required?: boolean;
+        min?: number;
+        max?: number;
+        pattern?: string;
+        message?: string;
+    };
+    placeholder?: string | (() => string);
+    order?: number;
+};
+type $$ComponentProps = {
+    open?: boolean;
+    mode?: 'create' | 'edit';
+    fields?: FieldDef[];
+    formData?: Record<string, unknown>;
+    title?: string;
+    size?: Size;
+    submitting?: boolean;
+    error?: string;
+    onsubmit?: (data: Record<string, unknown>) => Promise<void>;
+    onclose?: () => void;
+    editFormExtra?: Snippet<[Record<string, unknown> | null, 'create' | 'edit']>;
+    editingItem?: Record<string, unknown> | null;
+};
+/**
+ * CrudEditDrawer
+ * CRUD 编辑/新建抽屉组件
+ *
+ * 使用 Svelte 5 Runes ($props, $state, $derived)
+ * 使用 compounds/primitives 组件：Drawer, FormField, Input, Select, Textarea, Checkbox, Button
+ */
+declare const CrudEditDrawer: import("svelte").Component<$$ComponentProps, {}, "open" | "formData">;
+type CrudEditDrawer = ReturnType<typeof CrudEditDrawer>;
+export default CrudEditDrawer;

package/dist/components/scenes/crud/CrudFilterBar.svelte

@@ -0,0 +1,96 @@
+<!--
+  @component CrudFilterBar
+  CRUD 搜索 + 过滤栏组件
+
+  使用 Svelte 5 Runes ($props, $state)
+-->
+<script lang='ts'>
+  import { uiM } from '../../../messages.js'
+  import Input from '../../primitives/Input.svelte'
+  import Select from '../../primitives/Select.svelte'
+
+  type FilterFieldDef = {
+    id: string
+    label: string | (() => string)
+    type: string
+    options?: Array<{ label: string, value: string | number | boolean }> | (() => Array<{ label: string, value: string | number | boolean }>)
+  }
+
+  let {
+    searchable = true,
+    searchPlaceholder = '',
+    searchValue = $bindable(''),
+    filterFields = [],
+    filterValues = $bindable<Record<string, unknown>>({}),
+    total = 0,
+    onsearch,
+    onfilterchange,
+  }: {
+    searchable?: boolean
+    searchPlaceholder?: string
+    searchValue?: string
+    filterFields?: FilterFieldDef[]
+    filterValues?: Record<string, unknown>
+    total?: number
+    onsearch?: (search: string) => void
+    onfilterchange?: (filters: Record<string, unknown>) => void
+  } = $props()
+
+  let searchTimer: ReturnType<typeof setTimeout> | undefined
+
+  function resolveOptions(options?: FilterFieldDef['options']): Array<{ label: string, value: string | number | boolean }> {
+    if (!options)
+      return []
+    return typeof options === 'function' ? options() : options
+  }
+
+  function handleSearchInput() {
+    clearTimeout(searchTimer)
+    searchTimer = setTimeout(() => {
+      onsearch?.(searchValue)
+    }, 400)
+  }
+
+  function handleFilterChange(fieldId: string, value: unknown) {
+    filterValues = { ...filterValues, [fieldId]: value }
+    onfilterchange?.(filterValues)
+  }
+</script>
+
+<div class='p-4'>
+  <div class='flex flex-col sm:flex-row gap-3'>
+    {#if searchable}
+      <div class='flex-1 relative'>
+        <span class='icon-[tabler--search] size-4.5 absolute left-3 top-1/2 -translate-y-1/2 text-base-content/35 z-10'></span>
+        <Input
+          type='text'
+          placeholder={searchPlaceholder || uiM('crud_search_placeholder')}
+          class='pl-10'
+          bind:value={searchValue}
+          oninput={handleSearchInput}
+          autocomplete='off'
+        />
+      </div>
+    {/if}
+
+    {#each filterFields as field}
+      {@const opts = resolveOptions(field.options)}
+      {#if opts.length > 0}
+        <Select
+          class='min-w-32'
+          value={String(filterValues[field.id] ?? '')}
+          onchange={e => handleFilterChange(field.id, (e.target as HTMLSelectElement).value)}
+        >
+          <option value="">{uiM('crud_filter_all')}</option>
+          {#each opts as opt}
+            <option value={String(opt.value)}>{opt.label}</option>
+          {/each}
+        </Select>
+      {/if}
+    {/each}
+
+    <div class='text-sm text-base-content/50 self-center whitespace-nowrap'>
+      {uiM('crud_total', { count: total })}
+    </div>
+  </div>
+</div>