@vtable-guild/vtable-guild 2.9.0-alpha.0 → 2.9.0-alpha.2

package/dist/table/src/types/controls.d.ts

@@ -0,0 +1,31 @@
+import { Component, VNodeChild } from 'vue';
+import { TableDictionaryOption } from './dictionary';
+/** Shared by schema query fields and editable cells; host libraries remain optional. */
+export interface TableControlContext {
+    value: unknown;
+    onChange: (value: unknown) => void;
+    onSearch?: (keyword: string) => void;
+    fieldProps: Record<string, unknown>;
+    options: readonly TableDictionaryOption[];
+    disabled: boolean;
+    readonly: boolean;
+    loading: boolean;
+    error?: string;
+    id?: string;
+    name?: string;
+    mode: 'query' | 'edit';
+}
+export type TableControlRenderer = (context: TableControlContext) => VNodeChild;
+export type TableControls = Readonly<Record<string, TableControlRenderer>>;
+/** Pass components already installed by the host application. No UI library is imported here. */
+export interface TableControlComponents {
+    Input: Component;
+    Select: Component;
+    InputNumber: Component;
+    DatePicker: Component;
+    RangePicker?: Component;
+    TimePicker?: Component;
+    /** Element Plus ElOption; unused by the Ant Design Vue adapter. */
+    Option?: Component;
+}
+//# sourceMappingURL=controls.d.ts.map

package/dist/table/src/types/controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controls.d.ts","sourceRoot":"","sources":["../../../../../table/src/types/controls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAEzD,wFAAwF;AACxF,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAClC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACpC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAA;IACzC,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,OAAO,GAAG,MAAM,CAAA;CACvB;AACD,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,mBAAmB,KAAK,UAAU,CAAA;AAC/E,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAA;AAE1E,iGAAiG;AACjG,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,SAAS,CAAA;IAChB,MAAM,EAAE,SAAS,CAAA;IACjB,WAAW,EAAE,SAAS,CAAA;IACtB,UAAU,EAAE,SAAS,CAAA;IACrB,WAAW,CAAC,EAAE,SAAS,CAAA;IACvB,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB,mEAAmE;IACnE,MAAM,CAAC,EAAE,SAAS,CAAA;CACnB"}

package/dist/table/src/types/dictionary.d.ts

@@ -0,0 +1,71 @@
+import { ComputedRef, MaybeRefOrGetter, Ref } from 'vue';
+import { ColumnFilterItem } from './column';
+import { ColumnValue, ColumnValueEnumItem, ColumnValueStatus } from './presentation';
+export interface TableDictionaryOption {
+    value: ColumnValue;
+    label: string;
+    status?: ColumnValueStatus;
+    disabled?: boolean;
+}
+export interface TableDictionaryResult {
+    options: readonly TableDictionaryOption[];
+    /** True only when this result contains the entire dictionary for these dependency params. */
+    complete: boolean;
+}
+export interface TableDictionaryContext {
+    signal: AbortSignal;
+    keyword: string;
+}
+export type TableDictionaryRequest<TParams extends object> = (params: Partial<TParams>, context: TableDictionaryContext) => Promise<TableDictionaryResult>;
+export interface CreateTableDictionaryOptions<TParams extends object> {
+    key: string;
+    request: TableDictionaryRequest<TParams>;
+    /** Successful result lifetime in milliseconds. Default 300000; 0 disables result caching. */
+    cacheTime?: number;
+    /** Maximum retained entries. Active subscribers are never evicted. Default 50. */
+    maxEntries?: number;
+}
+/** Explicitly share one instance within a table/page or an application-owned provider. */
+export interface TableDictionary<TParams extends object = Record<string, unknown>> {
+    readonly key: string;
+    /** Share pending work; force bypasses a completed cache entry. Each caller can cancel separately. */
+    load: (params: Partial<TParams>, context: TableDictionaryContext & {
+        force?: boolean;
+    }) => Promise<TableDictionaryResult>;
+    /** Forget cached entries. Existing subscribers can finish, but their result is not re-cached. */
+    invalidate: () => void;
+}
+export interface UseTableDictionaryOptions<TParams extends object> {
+    dictionary: TableDictionary<TParams>;
+    /** Dependency parameters. Changes clear the keyword/results, never a business selection. */
+    params?: MaybeRefOrGetter<Partial<TParams>>;
+    defaultKeyword?: string;
+    /** Supply selected labels, including records not present in the latest remote search page. */
+    selectedOptions?: MaybeRefOrGetter<readonly TableDictionaryOption[]>;
+    manualRequest?: boolean;
+    debounceTime?: number;
+    onError?: (error: Error) => void;
+}
+export interface UseTableDictionaryReturn {
+    options: ComputedRef<readonly TableDictionaryOption[]>;
+    /** Known labels for the current dependency params, plus explicitly supplied selected options. */
+    valueEnum: ComputedRef<ReadonlyMap<ColumnValue, ColumnValueEnumItem>>;
+    /** Empty for partial/search results. Bind explicitly instead of using filters: true. */
+    filters: ComputedRef<ColumnFilterItem[]>;
+    complete: Readonly<Ref<boolean>>;
+    loading: Readonly<Ref<boolean>>;
+    error: Readonly<Ref<Error | null>>;
+    keyword: Readonly<Ref<string>>;
+    search: (keyword: string) => Promise<boolean>;
+    reload: () => Promise<boolean>;
+    cancel: () => void;
+}
+/** Accept both composable refs and Vue's deeply unwrapped column/schema configurations. */
+export interface TableDictionaryBinding {
+    options: MaybeRefOrGetter<readonly TableDictionaryOption[]>;
+    valueEnum: MaybeRefOrGetter<ReadonlyMap<ColumnValue, ColumnValueEnumItem>>;
+    loading: MaybeRefOrGetter<boolean>;
+    error: MaybeRefOrGetter<Error | null>;
+    search: (keyword: string) => Promise<boolean>;
+}
+//# sourceMappingURL=dictionary.d.ts.map

package/dist/table/src/types/dictionary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionary.d.ts","sourceRoot":"","sources":["../../../../../table/src/types/dictionary.ts"],"names":[],"mappings":"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"}

package/dist/table/src/types/dictionary.typecheck.d.ts

@@ -0,0 +1,6 @@
+import { UseTableDictionaryReturn } from './dictionary';
+export declare const dictionary: import('../../../vtable-guild/src/index.ts').TableDictionary<{
+    country: string;
+}>;
+export declare function dictionaryContract(result: UseTableDictionaryReturn): void;
+//# sourceMappingURL=dictionary.typecheck.d.ts.map

package/dist/table/src/types/dictionary.typecheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionary.typecheck.d.ts","sourceRoot":"","sources":["../../../../../table/src/types/dictionary.typecheck.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAyB,wBAAwB,EAAE,MAAM,cAAc,CAAA;AAEnF,eAAO,MAAM,UAAU;aAAoC,MAAM;EAS/D,CAAA;AACF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,wBAAwB,QAQlE"}

package/dist/table/src/types/editable.d.ts

@@ -0,0 +1,49 @@
+import { MaybeRefOrGetter, VNodeChild } from 'vue';
+import { ColumnType, ColumnsType, CustomRenderContext, Key } from './column';
+import { TableControls, TableControlContext } from './controls';
+import { TableDictionaryOption, TableDictionaryBinding } from './dictionary';
+import { UseTableEditOptions, UseTableEditReturn } from './editing';
+export interface TableEditableFieldContext<TRecord extends object> {
+    key: Key;
+    name: string;
+    column: ColumnType<TRecord>;
+    draft: TRecord;
+    original?: TRecord;
+    value: unknown;
+    isNew: boolean;
+}
+export interface TableColumnEditor<TRecord extends object> {
+    valueType?: string;
+    editable?: boolean | ((context: TableEditableFieldContext<TRecord>) => boolean);
+    readonly?: boolean | ((context: TableEditableFieldContext<TRecord>) => boolean);
+    disabled?: boolean | ((context: TableEditableFieldContext<TRecord>) => boolean);
+    fieldProps?: Record<string, unknown> | ((context: TableEditableFieldContext<TRecord>) => Record<string, unknown>);
+    options?: MaybeRefOrGetter<readonly TableDictionaryOption[]>;
+    dictionary?: TableDictionaryBinding;
+    /** Once when starting an editor, never on each render. */
+    convertValue?: (value: unknown, context: TableEditableFieldContext<TRecord>) => unknown;
+    /** Applied to a draft snapshot for saving/getValues, without rewriting the editor value. */
+    transform?: (value: unknown, context: TableEditableFieldContext<TRecord>) => unknown;
+    validate?: (value: unknown, context: TableEditableFieldContext<TRecord> & {
+        signal: AbortSignal;
+    }) => string | void | Promise<string | void>;
+    /** A linked-field patch after the current field changes. */
+    onValueChange?: (value: unknown, context: TableEditableFieldContext<TRecord>) => Partial<TRecord> | void;
+}
+export interface TableEditableCellContext<TRecord extends object> extends TableControlContext {
+    key: Key;
+    column: ColumnType<TRecord>;
+    draft: TRecord;
+    valueType: string;
+}
+export interface UseTableEditableOptions<TRecord extends object> extends Omit<UseTableEditOptions<TRecord>, 'toDraft' | 'toValue'> {
+    columns: MaybeRefOrGetter<ColumnsType<TRecord>>;
+    controls: MaybeRefOrGetter<TableControls>;
+    ui?: Partial<Record<'editCell' | 'editControl' | 'editError', string>>;
+}
+export interface UseTableEditableReturn<TRecord extends object> extends UseTableEditReturn<TRecord> {
+    getCell: (context: Pick<CustomRenderContext<TRecord>, 'record' | 'column'>) => TableEditableCellContext<TRecord> | undefined;
+    /** Return from bodyCell; undefined retains VTable's normal readonly rendering. */
+    renderEditor: (context: CustomRenderContext<TRecord>) => VNodeChild;
+}
+//# sourceMappingURL=editable.d.ts.map

package/dist/table/src/types/editable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editable.d.ts","sourceRoot":"","sources":["../../../../../table/src/types/editable.ts"],"names":[],"mappings":"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"}

package/dist/table/src/types/editable.typecheck.d.ts

@@ -0,0 +1,15 @@
+import { TableColumnEditor, UseTableEditableOptions } from './editable';
+import { TableControls } from './controls';
+interface Row {
+    id: number;
+    profile: {
+        name: string;
+    };
+    amount: number;
+}
+export declare const editorContract: TableColumnEditor<Row>;
+export declare const controlsContract: TableControls;
+export declare const editableOptionsContract: UseTableEditableOptions<Row>;
+export declare function editableContract(): void;
+export {};
+//# sourceMappingURL=editable.typecheck.d.ts.map

package/dist/table/src/types/editable.typecheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editable.typecheck.d.ts","sourceRoot":"","sources":["../../../../../table/src/types/editable.typecheck.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAC5E,OAAO,KAAK,EAAuB,aAAa,EAAE,MAAM,YAAY,CAAA;AAEpE,UAAU,GAAG;IACX,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACzB,MAAM,EAAE,MAAM,CAAA;CACf;AACD,eAAO,MAAM,cAAc,EAAE,iBAAiB,CAAC,GAAG,CAIjD,CAAA;AACD,eAAO,MAAM,gBAAgB,EAAE,aAE9B,CAAA;AACD,eAAO,MAAM,uBAAuB,EAAE,uBAAuB,CAAC,GAAG,CAKhE,CAAA;AACD,wBAAgB,gBAAgB,SAgB/B"}

package/dist/table/src/types/editing.d.ts

@@ -0,0 +1,90 @@
+import { ComputedRef, MaybeRefOrGetter } from 'vue';
+import { Key } from './column';
+export interface TableEditContext<TRecord extends object> {
+    key: Key;
+    /** Snapshot from start(); undefined for a cached addition until it is saved. */
+    original: TRecord | undefined;
+    isNew: boolean;
+    signal: AbortSignal;
+}
+export type TableEditDraftContext<TRecord extends object> = Omit<TableEditContext<TRecord>, 'signal'>;
+export interface TableEditAddConfig {
+    position?: 'top' | 'bottom';
+    /** Cache until saved (default), or immediately insert into the controlled source. */
+    mode?: 'cache' | 'source';
+}
+export interface TableEditValidationErrors {
+    message?: string;
+    /** Field names or business-defined nested field paths. */
+    fields?: Record<string, string>;
+}
+export interface TableEditError extends TableEditValidationErrors {
+    type: 'validation' | 'save' | 'cancel';
+    message: string;
+    cause?: unknown;
+}
+export interface TableEditValidationResult<TRecord extends object> {
+    valid: boolean;
+    /** Submitted snapshots from this validation; absent for failures or obsolete work. */
+    values?: TRecord[];
+    errors: ReadonlyMap<Key, TableEditError>;
+    obsolete?: boolean;
+}
+export interface UseTableEditOptions<TRecord extends object> {
+    /** A stable key is required; row indexes are intentionally unsupported. */
+    rowKey: keyof TRecord | ((record: TRecord) => Key);
+    /** Defaults to single. Starting another row in single mode returns false. */
+    mode?: 'single' | 'multiple';
+    /** Override when records contain mutable class instances. */
+    clone?: (record: TRecord) => TRecord;
+    /** Optional controlled source. Parent updates never replace an open local draft. */
+    dataSource?: MaybeRefOrGetter<readonly TRecord[]>;
+    /** Commit notifications only; draft keystrokes never write back into the source. */
+    onChange?: (records: TRecord[]) => void;
+    /** Convert a source record once when opening its editor. */
+    toDraft?: (record: TRecord, context: TableEditDraftContext<TRecord>) => TRecord;
+    /** Convert an editor snapshot when saving or obtaining submitted values. */
+    toValue?: (draft: TRecord, context: TableEditContext<TRecord>) => TRecord;
+    /** Used by add() when no explicit record is supplied. */
+    createRecord?: () => TRecord;
+    /** Maximum client-held rows, including cached additions. Finite limits round down to an integer. */
+    maxRows?: number;
+    /** Return errors to keep the draft open, or void to continue saving. */
+    validate?: (draft: TRecord, context: TableEditContext<TRecord>) => TableEditValidationErrors | void | Promise<TableEditValidationErrors | void>;
+    /** Return a canonical record, true/void to accept, or false to keep editing. Business updates dataSource. */
+    onSave?: (draft: TRecord, context: TableEditContext<TRecord>) => TRecord | void | boolean | Promise<TRecord | void | boolean>;
+    /** Returning false or rejecting keeps the draft open. Cancellation aborts a pending save first. */
+    onCancel?: (draft: TRecord, context: TableEditContext<TRecord>) => void | boolean | Promise<void | boolean>;
+    onError?: (error: TableEditError, key: Key) => void;
+}
+export interface UseTableEditReturn<TRecord extends object> {
+    /** Controlled source overlaid with local drafts and positioned cached additions. */
+    records: ComputedRef<TRecord[]>;
+    validating: ComputedRef<boolean>;
+    editableKeys: ComputedRef<readonly Key[]>;
+    savingKeys: ComputedRef<ReadonlySet<Key>>;
+    cancellingKeys: ComputedRef<ReadonlySet<Key>>;
+    errors: ComputedRef<ReadonlyMap<Key, TableEditError>>;
+    /** Unsaved cache-mode additions. Source-mode additions are committed through onChange. */
+    newRecords: ComputedRef<TRecord[]>;
+    isEditing: (key: Key) => boolean;
+    /** Returns an isolated copy. Use setDraft() to apply changes. */
+    getDraft: (key: Key) => TRecord | undefined;
+    /** Source snapshot captured when editing began; undefined for cached additions or missing sessions. */
+    getOriginal: (key: Key) => TRecord | undefined;
+    getDrafts: () => ReadonlyMap<Key, TRecord>;
+    /** Source records plus converted draft snapshots; never calls onSave or onChange. */
+    getValues: () => TRecord[];
+    /** Validate all client-held rows, including unmounted virtual rows, without saving. */
+    validateAll: () => Promise<TableEditValidationResult<TRecord>>;
+    /** Abort operations and discard drafts/errors, retaining the current controlled source. */
+    reset: () => void;
+    start: (record: TRecord) => boolean;
+    add: (record?: TRecord, config?: TableEditAddConfig) => boolean;
+    setDraft: (key: Key, patch: Partial<TRecord> | ((draft: TRecord) => TRecord)) => boolean;
+    /** Resolves undefined on validation/save failure, cancellation, or disposal. */
+    save: (key: Key) => Promise<TRecord | undefined>;
+    cancel: (key: Key) => Promise<boolean>;
+    cancelAll: () => Promise<boolean[]>;
+}
+//# sourceMappingURL=editing.d.ts.map

package/dist/table/src/types/editing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editing.d.ts","sourceRoot":"","sources":["../../../../../table/src/types/editing.ts"],"names":[],"mappings":"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"}

package/dist/table/src/types/editing.typecheck.d.ts

@@ -0,0 +1,11 @@
+import { UseTableEditOptions, UseTableEditReturn } from './editing';
+interface EditableRow {
+    id: number;
+    name: string;
+}
+export declare const editOptions: UseTableEditOptions<EditableRow>;
+export declare function editingContract(edit: UseTableEditReturn<EditableRow>): void;
+export declare const inferredEditing: UseTableEditReturn<EditableRow>;
+export declare const invalidEditing: UseTableEditOptions<EditableRow>;
+export {};
+//# sourceMappingURL=editing.typecheck.d.ts.map

package/dist/table/src/types/editing.typecheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editing.typecheck.d.ts","sourceRoot":"","sources":["../../../../../table/src/types/editing.typecheck.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA6B,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAEnG,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;CACb;AAED,eAAO,MAAM,WAAW,EAAE,mBAAmB,CAAC,WAAW,CAsCxD,CAAA;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,kBAAkB,CAAC,WAAW,CAAC,QAqCpE;AAED,eAAO,MAAM,eAAe,iCAA4B,CAAA;AAExD,eAAO,MAAM,cAAc,EAAE,mBAAmB,CAAC,WAAW,CAG3D,CAAA"}

package/dist/table/src/types/index.d.ts

@@ -2,6 +2,15 @@ export type { Key, AlignType, Breakpoint, DataIndex, CellAdditionalProps, Custom
 export type { ColumnType as TableColumnType } from './column';
 export type * from './presentation';
 export type * from './request';
+export type * from './dictionary';
+export type * from './query';
+export type * from './query-form';
+export type * from './editing';
+export type * from './editable';
+export type * from './controls';
+export type * from './renderers';
+export type * from './instance';
+export type * from './tree';
 export type { TablePaginationConfig, TablePaginationState, TablePaginationPosition, TablePaginationBuiltinLayoutItem, TablePaginationLayoutItem, TablePaginationLayout, TablePaginationSlotProps, PaginationItemType, } from './pagination';
 export type { ColumnGroupType as TableColumnGroupType } from './column';
 export type { ColumnsType as TableColumnsType } from './column';

package/dist/table/src/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../table/src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,GAAG,EACH,SAAS,EACT,UAAU,EACV,SAAS,EACT,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,eAAe,EACf,WAAW,EACX,SAAS,EACT,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,iBAAiB,GAClB,MAAM,UAAU,CAAA;AAEjB,YAAY,EAAE,UAAU,IAAI,eAAe,EAAE,MAAM,UAAU,CAAA;AAC7D,mBAAmB,gBAAgB,CAAA;AACnC,mBAAmB,WAAW,CAAA;AAC9B,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,gCAAgC,EAChC,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,eAAe,IAAI,oBAAoB,EAAE,MAAM,UAAU,CAAA;AACvE,YAAY,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAE/D,YAAY,EACV,UAAU,EACV,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,6BAA6B,EAC7B,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,UAAU,GACX,MAAM,SAAS,CAAA;AAChB,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../table/src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,GAAG,EACH,SAAS,EACT,UAAU,EACV,SAAS,EACT,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,eAAe,EACf,WAAW,EACX,SAAS,EACT,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,iBAAiB,GAClB,MAAM,UAAU,CAAA;AAEjB,YAAY,EAAE,UAAU,IAAI,eAAe,EAAE,MAAM,UAAU,CAAA;AAC7D,mBAAmB,gBAAgB,CAAA;AACnC,mBAAmB,WAAW,CAAA;AAC9B,mBAAmB,cAAc,CAAA;AACjC,mBAAmB,SAAS,CAAA;AAC5B,mBAAmB,cAAc,CAAA;AACjC,mBAAmB,WAAW,CAAA;AAC9B,mBAAmB,YAAY,CAAA;AAC/B,mBAAmB,YAAY,CAAA;AAC/B,mBAAmB,aAAa,CAAA;AAChC,mBAAmB,YAAY,CAAA;AAC/B,mBAAmB,QAAQ,CAAA;AAC3B,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,gCAAgC,EAChC,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,eAAe,IAAI,oBAAoB,EAAE,MAAM,UAAU,CAAA;AACvE,YAAY,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAE/D,YAAY,EACV,UAAU,EACV,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,6BAA6B,EAC7B,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,UAAU,GACX,MAAM,SAAS,CAAA;AAChB,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,cAAc,CAAA"}

package/dist/table/src/types/instance.d.ts

@@ -0,0 +1,18 @@
+import { Key } from './column';
+/** key takes precedence over index, which addresses visible rows on the current page. */
+export interface TableScrollToOptions {
+    key?: Key;
+    index?: number;
+    top?: number;
+    left?: number;
+    align?: 'top' | 'bottom' | 'auto';
+    offset?: number;
+}
+export interface TableInstance {
+    /** False for invalid input, an unmounted table, or a row outside the visible loaded page. */
+    scrollTo: (options: TableScrollToOptions) => Promise<boolean>;
+    /** Retry without toggling expansion. False when unavailable or unsuccessful. */
+    retryTreeLoad: (key: Key) => Promise<boolean>;
+    getTreeLoadError: (key: Key) => Error | undefined;
+}
+//# sourceMappingURL=instance.d.ts.map

package/dist/table/src/types/instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../../../../table/src/types/instance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAEnC,yFAAyF;AACzF,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,GAAG,CAAA;IACT,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,6FAA6F;IAC7F,QAAQ,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7D,gFAAgF;IAChF,aAAa,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7C,gBAAgB,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,KAAK,GAAG,SAAS,CAAA;CAClD"}

package/dist/table/src/types/instance.typecheck.d.ts

@@ -0,0 +1,3 @@
+import { TableInstance } from './instance';
+export declare function tableInstanceContract(table: TableInstance): void;
+//# sourceMappingURL=instance.typecheck.d.ts.map

package/dist/table/src/types/instance.typecheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.typecheck.d.ts","sourceRoot":"","sources":["../../../../../table/src/types/instance.typecheck.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAwB,MAAM,YAAY,CAAA;AAErE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,QAUzD"}

package/dist/table/src/types/query-form.d.ts

@@ -0,0 +1,90 @@
+import { MaybeRefOrGetter, VNodeChild } from 'vue';
+import { QuerySlots } from '../../../theme/src/index.ts';
+import { ColumnGroupType, ColumnType } from './column';
+import { ColumnSentinel } from '../constants';
+import { TableDictionaryOption, TableDictionaryBinding } from './dictionary';
+import { TableControls, TableControlContext } from './controls';
+import { UseTableQueryReturn } from './query';
+export interface TableQueryFieldContext<TValues extends object> {
+    values: Readonly<TValues>;
+    field: TableQueryField<TValues>;
+}
+/** Query metadata is independent from table visibility, ordering and readonly field formatting. */
+export interface TableQueryField<TValues extends object = Record<string, unknown>> {
+    name: keyof TValues & string;
+    label?: VNodeChild;
+    valueType?: string;
+    order?: number;
+    hidden?: boolean | ((context: TableQueryFieldContext<TValues>) => boolean);
+    disabled?: boolean | ((context: TableQueryFieldContext<TValues>) => boolean);
+    readonly?: boolean | ((context: TableQueryFieldContext<TValues>) => boolean);
+    fieldProps?: Record<string, unknown> | ((context: TableQueryFieldContext<TValues>) => Record<string, unknown>);
+    options?: MaybeRefOrGetter<readonly TableDictionaryOption[]>;
+    dictionary?: TableDictionaryBinding;
+}
+export type TableQueryColumn<TRecord extends object, TValues extends object = TRecord> = (ColumnType<TRecord> & {
+    query?: false | (Omit<TableQueryField<TValues>, 'name'> & {
+        name?: keyof TValues & string;
+    });
+}) | (Omit<ColumnGroupType<TRecord>, 'children'> & {
+    children: TableQueryColumn<TRecord, TValues>[];
+    query?: false;
+}) | ColumnSentinel;
+export interface TableQueryLocale {
+    label: string;
+    submit: string;
+    reset: string;
+    expand: string;
+    collapse: string;
+    validationFailed: string;
+}
+export interface TableQueryValidationContext<TValues extends object> {
+    fields: readonly TableQueryField<TValues>[];
+    action: 'submit' | 'reset';
+    signal: AbortSignal;
+}
+export interface TableQueryProps<TValues extends object = Record<string, unknown>, TParams extends object = TValues> {
+    query: UseTableQueryReturn<TValues, TParams>;
+    /** Use div when an existing host Form wraps this query area, avoiding nested forms. */
+    rootTag?: 'form' | 'div';
+    fields: readonly TableQueryField<TValues>[];
+    controls: TableControls;
+    layout?: 'form' | 'light';
+    /** Explicit opt-in for light layout only. Form layout always waits for submit. */
+    autoSubmit?: boolean;
+    debounceTime?: number;
+    /** Only schema-hidden fields are omitted; collapsing the layout never changes parameters. */
+    hiddenPolicy?: 'preserve' | 'omit';
+    collapsedCount?: number;
+    collapsible?: boolean;
+    disabled?: boolean;
+    /** Connect a host form's validate here. false or an exception prevents query submission. */
+    validate?: (values: Readonly<TValues>, context: TableQueryValidationContext<TValues>) => boolean | void | Promise<boolean | void>;
+    errors?: Readonly<Partial<Record<keyof TValues & string, string>>>;
+    locale?: Partial<TableQueryLocale>;
+    ui?: Partial<Record<QuerySlots, string>>;
+    class?: string;
+}
+export interface TableQueryFieldSlotProps<TValues extends object = Record<string, unknown>> {
+    field: TableQueryField<TValues>;
+    values: Readonly<TValues>;
+    control: TableControlContext;
+}
+export interface TableQueryActionSlotProps {
+    submit: () => Promise<boolean>;
+    reset: () => Promise<boolean>;
+    submitting: boolean;
+    collapsed: boolean;
+    toggleCollapsed: () => void;
+}
+export interface TableQuerySlots<TValues extends object = Record<string, unknown>> {
+    field?: (props: TableQueryFieldSlotProps<TValues>) => VNodeChild;
+    actions?: (props: TableQueryActionSlotProps) => VNodeChild;
+}
+export interface TableQueryInstance {
+    submit: () => Promise<boolean>;
+    reset: () => Promise<boolean>;
+    /** Cancel a pending auto-submit or host validation, retaining form values. */
+    cancel: () => void;
+}
+//# sourceMappingURL=query-form.d.ts.map

package/dist/table/src/types/query-form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-form.d.ts","sourceRoot":"","sources":["../../../../../table/src/types/query-form.ts"],"names":[],"mappings":"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"}

package/dist/table/src/types/query-form.typecheck.d.ts

@@ -0,0 +1,10 @@
+import { TableQueryProps, TableQueryField, TableQueryInstance } from './query-form';
+interface Values {
+    name: string;
+    range?: [string, string];
+}
+export declare const queryProps: TableQueryProps<Values>;
+export declare const derivedFields: TableQueryField<Values>[];
+export declare function instanceContract(instance: TableQueryInstance): void;
+export {};
+//# sourceMappingURL=query-form.typecheck.d.ts.map

package/dist/table/src/types/query-form.typecheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-form.typecheck.d.ts","sourceRoot":"","sources":["../../../../../table/src/types/query-form.typecheck.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAEf,kBAAkB,EACnB,MAAM,cAAc,CAAA;AAKrB,UAAU,MAAM;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACzB;AAYD,eAAO,MAAM,UAAU,EAAE,eAAe,CAAC,MAAM,CAAoD,CAAA;AACnG,eAAO,MAAM,aAAa,2BAAkC,CAAA;AAC5D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,QAM5D"}

package/dist/table/src/types/query.d.ts

@@ -0,0 +1,40 @@
+import { ComputedRef, Ref, ShallowRef } from 'vue';
+/** A transformed field replaces its original key and may expand into several request fields. */
+export type TableQueryFieldTransforms<TValues extends object, TParams extends object> = {
+    [K in keyof TValues]?: (value: TValues[K], values: Readonly<TValues>) => Partial<TParams> | undefined;
+};
+/** Omit hidden fields from request parameters without changing the form draft or submitted values. */
+export interface TableQuerySubmitOptions<TValues extends object> {
+    omitFields?: readonly (keyof TValues)[];
+}
+export interface UseTableQueryOptions<TValues extends object, TParams extends object = TValues> {
+    /** A snapshot is taken once. Use ordinary objects, arrays and Date values for form state. */
+    defaultValues: TValues;
+    fieldTransforms?: TableQueryFieldTransforms<TValues, TParams>;
+    /** Runs after field transforms, once per submit/reset, never on draft edits. */
+    transform?: (params: Partial<TParams>, values: Readonly<TValues>) => Partial<TParams>;
+    onSubmit?: (params: Partial<TParams>, values: Readonly<TValues>) => void | Promise<void>;
+    /** Defaults to onSubmit. Connect this to request.reset(params) to also clear table state. */
+    onReset?: (params: Partial<TParams>, values: Readonly<TValues>) => void | Promise<void>;
+    /** Optional shared ref for a controlled collapse state. */
+    collapsed?: Ref<boolean>;
+    defaultCollapsed?: boolean;
+    onCollapse?: (collapsed: boolean) => void;
+}
+export interface UseTableQueryReturn<TValues extends object, TParams extends object = TValues> {
+    draft: Ref<TValues>;
+    /** Last successfully transformed values, published before the callback and retained if it fails. */
+    submitted: ComputedRef<Readonly<TValues> | undefined>;
+    params: ComputedRef<Readonly<Partial<TParams>> | undefined>;
+    collapsed: Ref<boolean>;
+    submitting: ComputedRef<boolean>;
+    error: ShallowRef<Error | null>;
+    /** Returns false for a transform/callback failure or an obsolete submission. */
+    submit: (options?: TableQuerySubmitOptions<TValues>) => Promise<boolean>;
+    /** Restore draft defaults and submit them through onReset (or onSubmit), once. */
+    reset: (options?: TableQuerySubmitOptions<TValues>) => Promise<boolean>;
+    /** Restore draft defaults without changing submitted state or requesting data. */
+    resetFields: () => void;
+    toggleCollapsed: () => void;
+}
+//# sourceMappingURL=query.d.ts.map

package/dist/table/src/types/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../../../table/src/types/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AAEvD,gGAAgG;AAChG,MAAM,MAAM,yBAAyB,CAAC,OAAO,SAAS,MAAM,EAAE,OAAO,SAAS,MAAM,IAAI;KACrF,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,EAAE,CACrB,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EACjB,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,KACtB,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS;CAClC,CAAA;AAED,sGAAsG;AACtG,MAAM,WAAW,uBAAuB,CAAC,OAAO,SAAS,MAAM;IAC7D,UAAU,CAAC,EAAE,SAAS,CAAC,MAAM,OAAO,CAAC,EAAE,CAAA;CACxC;AAED,MAAM,WAAW,oBAAoB,CAAC,OAAO,SAAS,MAAM,EAAE,OAAO,SAAS,MAAM,GAAG,OAAO;IAC5F,6FAA6F;IAC7F,aAAa,EAAE,OAAO,CAAA;IACtB,eAAe,CAAC,EAAE,yBAAyB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAC7D,gFAAgF;IAChF,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACrF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxF,6FAA6F;IAC7F,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvF,2DAA2D;IAC3D,SAAS,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAA;CAC1C;AAED,MAAM,WAAW,mBAAmB,CAAC,OAAO,SAAS,MAAM,EAAE,OAAO,SAAS,MAAM,GAAG,OAAO;IAC3F,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IACnB,oGAAoG;IACpG,SAAS,EAAE,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,CAAA;IACrD,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;IAC3D,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IACvB,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IAChC,KAAK,EAAE,UAAU,CAAC,KAAK,GAAG,IAAI,CAAC,CAAA;IAC/B,gFAAgF;IAChF,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,uBAAuB,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACxE,kFAAkF;IAClF,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,uBAAuB,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACvE,kFAAkF;IAClF,WAAW,EAAE,MAAM,IAAI,CAAA;IACvB,eAAe,EAAE,MAAM,IAAI,CAAA;CAC5B"}

package/dist/table/src/types/query.typecheck.d.ts

@@ -0,0 +1,14 @@
+import { TableQueryFieldTransforms } from './query';
+interface QueryValues {
+    keyword: string;
+    range: [Date, Date] | undefined;
+}
+interface QueryParams {
+    keyword: string;
+    start: string;
+    end: string;
+}
+export declare const queryFieldTransforms: TableQueryFieldTransforms<QueryValues, QueryParams>;
+export declare function queryContract(): void;
+export {};
+//# sourceMappingURL=query.typecheck.d.ts.map

package/dist/table/src/types/query.typecheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.typecheck.d.ts","sourceRoot":"","sources":["../../../../../table/src/types/query.typecheck.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAA;AAExD,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,SAAS,CAAA;CAChC;AACD,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,eAAO,MAAM,oBAAoB,EAAE,yBAAyB,CAAC,WAAW,EAAE,WAAW,CAEpF,CAAA;AAED,wBAAgB,aAAa,SAgB5B"}

package/dist/table/src/types/renderers.d.ts

@@ -0,0 +1,49 @@
+import { VNodeChild } from 'vue';
+import { CustomRenderContext } from './column';
+import { ColumnValueStatus } from './presentation';
+/** Options shared by the built-in formatters; custom renderers may add their own fields. */
+export interface TableFieldProps {
+    locale?: string | string[];
+    numberFormat?: Intl.NumberFormatOptions;
+    /** Default date output is YYYY-MM-DD; an explicit options object enables Intl formatting. */
+    dateFormat?: Intl.DateTimeFormatOptions;
+    /** Currency used by money; defaults to CNY. */
+    currency?: string;
+    /** percent/progress input scale. Default 'percent' (25 means 25%); 'ratio' uses 0..1. */
+    percentScale?: 'percent' | 'ratio';
+    /** Range display separator and missing-endpoint placeholder. Defaults to ' ~ ' and '—'. */
+    rangeSeparator?: string;
+    rangeEmptyText?: string;
+    /** Show the progress percentage next to its track. Default true. */
+    showValue?: boolean;
+    /** tag and progress reuse the same status tokens as valueEnum. */
+    status?: ColumnValueStatus;
+    [key: string]: unknown;
+}
+export interface TableFieldRenderContext<TRecord extends object = Record<string, unknown>> extends CustomRenderContext<TRecord> {
+    /** The enum label, or the transformed scalar value when no enum matches. */
+    displayValue: VNodeChild;
+    /** Resolved from valueEnum, preserving Map key identity. */
+    status?: ColumnValueStatus;
+    fieldProps: TableFieldProps;
+    /** Current table locale; a field's locale option takes precedence. */
+    locale?: string;
+}
+export interface TableFieldRenderResult {
+    children: VNodeChild;
+    /** Explicit plain text for ellipsis tooltips; VNodes are never stringified. */
+    tooltipText?: string;
+    /** Uses the existing theme status slot. */
+    status?: ColumnValueStatus;
+    /** Render with the theme's tag or progress appearance instead of a status dot. */
+    presentation?: 'tag' | 'progress';
+    /** A finite percentage in 0..100; rendered through the table's progress theme slots. */
+    progress?: {
+        percent: number;
+        showValue: boolean;
+    };
+}
+export type TableFieldRenderer<TRecord extends object = Record<string, unknown>> = (context: TableFieldRenderContext<TRecord>) => VNodeChild | TableFieldRenderResult;
+/** A registry is local to a table or application; no process-wide mutable registry is used. */
+export type TableFieldRenderers<TRecord extends object = Record<string, unknown>> = Readonly<Record<string, TableFieldRenderer<TRecord>>>;
+//# sourceMappingURL=renderers.d.ts.map

package/dist/table/src/types/renderers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderers.d.ts","sourceRoot":"","sources":["../../../../../table/src/types/renderers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AACrC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAEvD,4FAA4F;AAC5F,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC1B,YAAY,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAA;IACvC,6FAA6F;IAC7F,UAAU,CAAC,EAAE,IAAI,CAAC,qBAAqB,CAAA;IACvC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yFAAyF;IACzF,YAAY,CAAC,EAAE,SAAS,GAAG,OAAO,CAAA;IAClC,2FAA2F;IAC3F,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,oEAAoE;IACpE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,kEAAkE;IAClE,MAAM,CAAC,EAAE,iBAAiB,CAAA;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,uBAAuB,CACtC,OAAO,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAChD,SAAQ,mBAAmB,CAAC,OAAO,CAAC;IACpC,4EAA4E;IAC5E,YAAY,EAAE,UAAU,CAAA;IACxB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,iBAAiB,CAAA;IAC1B,UAAU,EAAE,eAAe,CAAA;IAC3B,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,UAAU,CAAA;IACpB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,iBAAiB,CAAA;IAC1B,kFAAkF;IAClF,YAAY,CAAC,EAAE,KAAK,GAAG,UAAU,CAAA;IACjC,wFAAwF;IACxF,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAA;CACnD;AAED,MAAM,MAAM,kBAAkB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CACjF,OAAO,EAAE,uBAAuB,CAAC,OAAO,CAAC,KACtC,UAAU,GAAG,sBAAsB,CAAA;AAExC,+FAA+F;AAC/F,MAAM,MAAM,mBAAmB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,QAAQ,CAC1F,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAC5C,CAAA"}