@svadmin/ui 0.72.0 → 0.73.0

package/dist/components/svar-grid-panes.js

@@ -0,0 +1,66 @@
+function own(event, key) {
+    return event && typeof event === 'object' ? Object.getOwnPropertyDescriptor(event, key)?.value : undefined;
+}
+function mirroredEvent(action, event) {
+    if (action === 'scroll-to') {
+        const top = own(event, 'top');
+        return typeof top === 'number' && Number.isFinite(top) && top >= 0 ? { top } : undefined;
+    }
+    if (action === 'open-row' || action === 'close-row') {
+        const id = own(event, 'id');
+        return typeof id === 'string' ? { id, nested: own(event, 'nested') === true } : undefined;
+    }
+    const key = own(event, 'key');
+    if (typeof key !== 'string')
+        return undefined;
+    if (action === 'sort-rows') {
+        // 上游首次排序可能省略 order，其公开语义为升序。
+        const order = own(event, 'order') ?? 'asc';
+        if (order !== 'asc' && order !== 'desc')
+            return undefined;
+        return { key, order, add: own(event, 'add') === true };
+    }
+    const value = own(event, 'value');
+    return typeof value === 'string' || value == null ? { key, value: value ?? '' } : undefined;
+}
+/** 两个公开 Grid 实例组成固定右侧面板，不读取或改写上游 Community 功能开关。 */
+export function createSvarPanePair(current) {
+    const panes = new Map();
+    let disposed = false;
+    let synchronizing = 0;
+    function attach(side, api) {
+        panes.set(side, api);
+        for (const action of ['scroll-to', 'sort-rows', 'filter-rows', 'open-row', 'close-row']) {
+            api.on(action, event => {
+                const peer = panes.get(side === 0 ? 1 : 0);
+                if (disposed || synchronizing || panes.get(side) !== api || !peer || !current())
+                    return;
+                const next = mirroredEvent(action, event);
+                if (!next)
+                    return;
+                if (action === 'scroll-to' && peer.getState().scrollTop === next['top'])
+                    return;
+                synchronizing++;
+                try {
+                    void Promise.resolve(peer.exec(action, next)).catch(() => { }).finally(() => { synchronizing--; });
+                }
+                catch {
+                    synchronizing--;
+                }
+            });
+        }
+        if (side === 1) {
+            const top = panes.get(0)?.getState().scrollTop;
+            if (typeof top === 'number' && top > 0)
+                void api.exec('scroll-to', { top }).catch(() => { });
+        }
+    }
+    function focus(side, row, column) {
+        if (disposed || !current())
+            return;
+        const api = panes.get(side);
+        if (api)
+            void api.exec('focus-cell', { row, column, eventSource: 'svadmin-pinned-navigation' }).catch(() => { });
+    }
+    return { attach, focus, get: (side) => panes.get(side), dispose() { disposed = true; panes.clear(); } };
+}

package/dist/components/svar-grid-resource-loading.d.ts

@@ -0,0 +1,18 @@
+import { type SvarRange, type SvarWindowPage } from './svar-grid-loading.js';
+export interface SvarLazyTree {
+    /** Resource field containing the parent record ID. */
+    readonly parentField: string;
+    readonly rootValue?: string | number | null;
+    readonly hasChildrenKey?: string;
+    /** A branch is rejected rather than silently truncated above this bound. Default: 10,000. */
+    readonly maxChildren?: number;
+}
+export type SvarResourcePageReader = (pagination: {
+    current: number;
+    pageSize: number;
+}) => Promise<SvarWindowPage>;
+/** Translate a zero-based exclusive grid window to the existing one-based Provider pagination. */
+export declare function loadSvarResourceWindow(range: SvarRange, pageSize: number, read: SvarResourcePageReader, signal: AbortSignal, primaryKey?: string): Promise<SvarWindowPage>;
+/** Load all children in bounded pages. Partial branches must never masquerade as complete trees. */
+export declare function loadSvarResourceChildren(pageSize: number, maxChildren: number, read: SvarResourcePageReader, signal: AbortSignal, primaryKey?: string, childrenKey?: string): Promise<readonly Record<string, unknown>[]>;
+export declare function appendSvarResourcePage(rows: readonly Record<string, unknown>[], page: SvarWindowPage, expectedTotal: number, primaryKey?: string): readonly Record<string, unknown>[];

package/dist/components/svar-grid-resource-loading.js

@@ -0,0 +1,68 @@
+import { snapshotSvarRecords, snapshotSvarWindow, SvarLoadCancelled } from './svar-grid-loading.js';
+function checkSignal(signal) {
+    if (signal.aborted)
+        throw new SvarLoadCancelled();
+}
+function checkPageSize(pageSize) {
+    if (!Number.isSafeInteger(pageSize) || pageSize < 1 || pageSize > 1000)
+        throw new Error('Invalid resource page size');
+}
+function checkPage(page, start, size, primaryKey) {
+    return snapshotSvarWindow(page, { start, end: start + size }, primaryKey);
+}
+/** Translate a zero-based exclusive grid window to the existing one-based Provider pagination. */
+export async function loadSvarResourceWindow(range, pageSize, read, signal, primaryKey = 'id') {
+    checkPageSize(pageSize);
+    checkSignal(signal);
+    if (!Number.isSafeInteger(range.start) || !Number.isSafeInteger(range.end) || range.start < 0
+        || range.end < range.start || range.end > 10_000_000 || range.end - range.start > 2048)
+        throw new Error('Invalid resource window');
+    const first = Math.floor(range.start / pageSize);
+    const last = Math.max(first, Math.ceil(range.end / pageSize) - 1);
+    let total;
+    const rows = [];
+    for (let pageIndex = first; pageIndex <= last; pageIndex++) {
+        checkSignal(signal);
+        const page = checkPage(await read({ current: pageIndex + 1, pageSize }), pageIndex * pageSize, pageSize, primaryKey);
+        checkSignal(signal);
+        if (total !== undefined && total !== page.total)
+            throw new Error('Resource changed during window loading; refresh');
+        total = page.total;
+        rows.push(...page.data);
+        if ((pageIndex + 1) * pageSize >= total)
+            break;
+    }
+    const data = rows.slice(range.start - first * pageSize, range.end - first * pageSize);
+    return snapshotSvarWindow({ data, total: total ?? 0 }, range, primaryKey);
+}
+/** Load all children in bounded pages. Partial branches must never masquerade as complete trees. */
+export async function loadSvarResourceChildren(pageSize, maxChildren, read, signal, primaryKey = 'id', childrenKey = 'children') {
+    checkPageSize(pageSize);
+    checkSignal(signal);
+    if (!Number.isSafeInteger(maxChildren) || maxChildren < 1 || maxChildren > 100_000)
+        throw new Error('Invalid child limit');
+    let total;
+    const rows = [];
+    for (let pageIndex = 0;; pageIndex++) {
+        checkSignal(signal);
+        const page = checkPage(await read({ current: pageIndex + 1, pageSize }), pageIndex * pageSize, pageSize, primaryKey);
+        checkSignal(signal);
+        if (page.total > maxChildren)
+            throw new Error('Branch exceeds the configured child limit');
+        if (total !== undefined && total !== page.total)
+            throw new Error('Branch changed during loading; retry');
+        total = page.total;
+        rows.push(...page.data);
+        if (rows.length >= total)
+            return snapshotSvarRecords(rows, primaryKey, childrenKey);
+    }
+}
+export function appendSvarResourcePage(rows, page, expectedTotal, primaryKey = 'id') {
+    if (!Number.isSafeInteger(expectedTotal) || expectedTotal < 0 || expectedTotal > 10_000_000)
+        throw new Error('Invalid expected total');
+    if (page.total !== expectedTotal)
+        throw new Error('Resource changed during infinite loading; refresh');
+    if (rows.length + page.data.length > expectedTotal || (!page.data.length && rows.length < expectedTotal))
+        throw new Error('Invalid next resource page');
+    return snapshotSvarRecords([...rows, ...page.data], primaryKey);
+}

package/dist/components/svar-grid-resource-session.svelte.d.ts

@@ -0,0 +1,29 @@
+import { SvelteMap } from 'svelte/reactivity';
+import type { Filter, Sort } from '@svadmin/core';
+import type { SvarResourceReadRequest } from './SvarResourceRead.svelte';
+import { type SvarWindowPage } from './svar-grid-loading.js';
+import type { SvarRecordId } from './svar-grid-operations.js';
+/** Query workers remain descendants of the host AdminContext and QueryClientProvider. */
+export declare function createSvarResourceReads<Scope extends object>(options: {
+    scope: () => Scope;
+    current: (scope: Scope) => boolean;
+    authorize: (scope: Scope, parentId?: SvarRecordId) => Promise<boolean>;
+    resourceName: () => string;
+    dataScopeKey: () => string | number;
+    primaryKey: () => string;
+    childrenKey: () => string | undefined;
+}): {
+    requests: SvelteMap<number, SvarResourceReadRequest>;
+    read: (input: {
+        scope: Scope;
+        signal: AbortSignal;
+        pagination: {
+            current: number;
+            pageSize: number;
+        };
+        filters: Filter[];
+        sorters: Sort[];
+        parentId?: SvarRecordId;
+    }) => Promise<SvarWindowPage>;
+    cancelAll: () => void;
+};

package/dist/components/svar-grid-resource-session.svelte.js

@@ -0,0 +1,61 @@
+import { onDestroy, untrack } from 'svelte';
+import { SvelteMap } from 'svelte/reactivity';
+import { SvarLoadCancelled } from './svar-grid-loading.js';
+/** Query workers remain descendants of the host AdminContext and QueryClientProvider. */
+export function createSvarResourceReads(options) {
+    const requests = new SvelteMap();
+    const pending = new Map();
+    let sequence = 0;
+    let alive = true;
+    function cancelAll() { for (const entry of [...pending.values()])
+        entry.cancel(); }
+    onDestroy(() => { alive = false; cancelAll(); });
+    $effect.pre(() => {
+        const scope = options.scope();
+        const available = options.current(scope);
+        untrack(() => {
+            for (const entry of [...pending.values()])
+                if (!available || entry.scope !== scope)
+                    entry.cancel();
+        });
+    });
+    async function read(input) {
+        const { scope, signal } = input;
+        const current = () => alive && !signal.aborted && options.current(scope);
+        if (!current())
+            throw new SvarLoadCancelled();
+        if (!await options.authorize(scope, input.parentId))
+            throw new Error('Resource read access denied');
+        if (!current())
+            throw new SvarLoadCancelled();
+        return new Promise((resolve, reject) => {
+            const id = ++sequence;
+            let settled = false;
+            const finish = (callback) => {
+                if (settled)
+                    return;
+                settled = true;
+                signal.removeEventListener('abort', abort);
+                pending.delete(id);
+                requests.delete(id);
+                callback();
+            };
+            const abort = () => finish(() => reject(new SvarLoadCancelled()));
+            pending.set(id, { scope, cancel: abort });
+            signal.addEventListener('abort', abort, { once: true });
+            if (!current()) {
+                abort();
+                return;
+            }
+            const childrenKey = options.childrenKey();
+            requests.set(id, {
+                resourceName: options.resourceName(), dataScopeKey: options.dataScopeKey(), primaryKey: options.primaryKey(),
+                ...(childrenKey === undefined ? {} : { childrenKey }),
+                pagination: { ...input.pagination }, filters: input.filters, sorters: input.sorters,
+                resolve(page) { finish(() => current() ? resolve(page) : reject(new SvarLoadCancelled())); },
+                reject(error) { finish(() => reject(current() ? error : new SvarLoadCancelled())); },
+            });
+        });
+    }
+    return { requests, read, cancelAll };
+}

package/dist/components/ui/badge/badge-variants.js

@@ -1 +1,3 @@
-export const badgeVariants = ({ variant = "default", class: className = "", className: extraClassName = "", } = {}) => ["svadmin-badge", variant && `svadmin-badge--${variant}`, className, extraClassName].filter(Boolean).join(" ");
+import { uiBadge } from '../../../styled-system/recipes/index.js';
+export const badgeVariants = ({ variant = "default", class: className = "", className: extraClassName = "", } = {}) => ["svadmin-badge", variant && `svadmin-badge--${variant}`,
+    uiBadge(variant ? { variant } : {}), className, extraClassName].filter(Boolean).join(" ");

package/dist/components/ui/button/button-variants.js

@@ -1,2 +1,5 @@
-// Keep the public helper for composition, while styles are owned by app.css.
-export const buttonVariants = ({ variant = "default", size = "default", class: className = "", className: extraClassName = "", } = {}) => ["svadmin-button", variant && `svadmin-button--${variant}`, size && `svadmin-button-size--${size}`, className, extraClassName].filter(Boolean).join(" ");
+import { uiButton } from '../../../styled-system/recipes/index.js';
+// 保留公开 helper、语义标记和 null 行为；样式由预生成 Panda recipe 提供。
+export const buttonVariants = ({ variant = "default", size = "default", class: className = "", className: extraClassName = "", } = {}) => ["svadmin-button", variant && `svadmin-button--${variant}`, size && `svadmin-button-size--${size}`,
+    uiButton({ ...(variant ? { variant } : {}), ...(size ? { size } : {}) }),
+    className, extraClassName].filter(Boolean).join(" ");

package/dist/components/ui/input/input.svelte

@@ -63,10 +63,7 @@
 	<input
 		bind:this={ref}
 		data-slot={dataSlot}
-		class={cn(
-			"svadmin-input",
-			className
-		)}
+			class={cn("svadmin-input", className)}
 			{type}
 			lang={isDateInput ? i18n.locale : undefined}
 			bind:value

package/dist/components/ui/textarea/textarea.svelte

@@ -1,6 +1,7 @@
 <script lang="ts">
 	import type { HTMLTextareaAttributes } from "svelte/elements";
 	import { cn, type WithElementRef } from "../../../utils.js";
+	import { uiTextarea } from "../../../styled-system/recipes/index.js";
 
 	type Props = WithElementRef<HTMLTextareaAttributes, HTMLTextAreaElement>;
 
@@ -15,7 +16,7 @@
 <textarea
 	bind:this={ref}
 	data-slot="textarea"
-	class={cn("svadmin-textarea", className)}
+	class={cn("svadmin-textarea", uiTextarea(), className)}
 	bind:value
 	{...restProps}
 ></textarea>