@henryx/onedot-ui 0.3.0 → 0.4.0

package/README.md

@@ -47,10 +47,14 @@ const rows = [{ id: 1, name: 'Ada' }]
 </template>
 ```
 
-Remote tables use frontend columns and one POST query endpoint
+Remote tables default to frontend columns and one POST query endpoint
 returning paginated data plus `meta.fields` for query capabilities and enum
 options. Use `query-url` or `load-data`, with the same `columns` and `row-key`
-props. Field slots such as `#cell-name` let the page render links or dialog
+props. When the server determines columns, use `schema-url + query-url` or
+`load-schema + load-data`; omit frontend columns and row-key. Both column modes
+are supported starting in 0.4.0 (0.3.0 uses frontend columns).
+Both modes share query metadata. Field slots such as `#cell-name` match existing
+columns by field and let the page render links or dialog
 buttons. See the [OdTable guide](./用户使用手册/OdTable.md) for complete examples,
 and the [capability list](./用户使用手册/能力清单.md) for implementation status.
 
@@ -115,7 +119,7 @@ The full Tabler Vue catalog and raw SVG assets are shipped inside this package,
 so moving the component library to another application does not require a
 second icon dependency or a network request.
 
-The current package version is `0.3.0`. Maintainers should run
+The current package version is `0.4.0`. Maintainers should run
 `corepack pnpm release:check` before publishing subsequent versions.
 
 ## License

package/dist/components/OdTable.types.d.ts

@@ -77,12 +77,26 @@ export type OdTablePaginationConfig = {
     defaultPageSize?: number;
     pageSizeOptions?: number[];
 };
-export type OdTableRequest = (url: string, options: {
-    method: 'POST';
+/** Structure only: query capabilities and enum options belong to Result.meta. */
+export type OdTableSchemaColumn = Omit<OdTableColumn, 'sortable' | 'searchable' | 'filterable' | 'options'>;
+export type OdTableSchema = {
+    rowKey: string;
+    columns: OdTableSchemaColumn[];
+};
+export type OdTableLoadSchema = (context: {
+    signal: AbortSignal;
+}) => Promise<OdTableSchema>;
+export type OdTableRequestOptions = {
     headers?: Record<string, string>;
-    body: OdTableQuery;
     signal: AbortSignal;
-}) => Promise<unknown>;
+} & ({
+    method: 'GET';
+    body?: never;
+} | {
+    method: 'POST';
+    body: OdTableQuery;
+});
+export type OdTableRequest = (url: string, options: OdTableRequestOptions) => Promise<unknown>;
 export type OdTableLoadData<T> = (query: OdTableQuery, context: {
     signal: AbortSignal;
 }) => Promise<OdTableResult<T>>;
@@ -123,10 +137,12 @@ export type OdTableLocale = Partial<{
 /** Built-in Chinese copy. Consumers override entries through the `locale` prop. */
 export declare const OD_TABLE_DEFAULT_LOCALE: Required<OdTableLocale>;
 export type OdTableProps<T extends object> = {
-    columns: OdTableColumn[];
+    columns?: OdTableColumn[];
     rows?: T[];
-    rowKey: string;
+    rowKey?: string;
     pagination?: OdTablePaginationConfig;
+    loadSchema?: OdTableLoadSchema;
+    schemaUrl?: string;
     loadData?: OdTableLoadData<T>;
     queryUrl?: string;
     request?: OdTableRequest;
@@ -142,6 +158,7 @@ export type OdTableProps<T extends object> = {
 };
 export type OdTableExpose = {
     refresh: () => Promise<void>;
+    refreshSchema: () => Promise<void>;
 };
 export type OdTableEvents<T> = {
     'selection-change': (keys: OdTableRowKey[], rows: T[]) => void;
@@ -156,12 +173,13 @@ export type OdTableEvents<T> = {
         error: unknown;
         query: OdTableQuery;
     }) => void;
+    'schema-error': (error: unknown) => void;
     retry: (payload: {
-        stage: 'data';
+        stage: 'schema' | 'data';
     }) => void;
     'config-error': (error: OdTableConfigError) => void;
 };
-export type OdTableConfigErrorCode = 'MODE_MISSING' | 'MODE_PARTIAL' | 'MODE_CONFLICT' | 'REQUEST_WITHOUT_URL_MODE' | 'INVALID_COLUMNS' | 'DUPLICATE_COLUMN_FIELD' | 'INVALID_COLUMN_FIELD' | 'INVALID_COLUMN_WIDTH' | 'INVALID_NUMBER_FORMAT' | 'SEARCHABLE_NON_TEXT' | 'FILTERABLE_NON_ENUM' | 'ENUM_OPTIONS_REQUIRED' | 'DUPLICATE_ENUM_OPTION' | 'INVALID_PAGINATION' | 'MISSING_ROW_KEY' | 'DUPLICATE_ROW_KEY' | 'INVALID_INITIAL_QUERY' | 'INVALID_ROWS' | 'INVALID_RESULT' | 'RESULT_TOTAL_INVALID' | 'RESULT_PAGE_INVALID' | 'RESULT_PAGE_SIZE_INVALID' | 'RESULT_ITEMS_OVERFLOW' | 'RESULT_EMPTY_CONFLICT' | 'INVALID_META' | 'META_QUERY_CONFLICT';
+export type OdTableConfigErrorCode = 'MODE_MISSING' | 'MODE_PARTIAL' | 'MODE_CONFLICT' | 'REQUEST_WITHOUT_URL_MODE' | 'INVALID_COLUMNS' | 'INVALID_SCHEMA' | 'INVALID_ROW_KEY_FIELD' | 'DUPLICATE_COLUMN_FIELD' | 'INVALID_COLUMN_FIELD' | 'INVALID_COLUMN_WIDTH' | 'INVALID_NUMBER_FORMAT' | 'SEARCHABLE_NON_TEXT' | 'FILTERABLE_NON_ENUM' | 'ENUM_OPTIONS_REQUIRED' | 'DUPLICATE_ENUM_OPTION' | 'INVALID_PAGINATION' | 'MISSING_ROW_KEY' | 'DUPLICATE_ROW_KEY' | 'INVALID_INITIAL_QUERY' | 'INVALID_ROWS' | 'INVALID_RESULT' | 'RESULT_TOTAL_INVALID' | 'RESULT_PAGE_INVALID' | 'RESULT_PAGE_SIZE_INVALID' | 'RESULT_ITEMS_OVERFLOW' | 'RESULT_EMPTY_CONFLICT' | 'INVALID_META' | 'META_QUERY_CONFLICT';
 export declare class OdTableConfigError extends Error {
     readonly name = "OdTableConfigError";
     readonly code: OdTableConfigErrorCode;
@@ -169,7 +187,7 @@ export declare class OdTableConfigError extends Error {
     constructor(code: OdTableConfigErrorCode, message: string, details?: unknown);
 }
 export type OdTableSourceMode = 'local' | 'function' | 'url';
-type OdTableSourceInput<T extends object> = Partial<Pick<OdTableProps<T>, 'columns' | 'rows' | 'rowKey' | 'pagination' | 'loadData' | 'queryUrl' | 'request'>>;
+type OdTableSourceInput<T extends object> = Partial<Pick<OdTableProps<T>, 'columns' | 'rows' | 'rowKey' | 'pagination' | 'loadSchema' | 'schemaUrl' | 'loadData' | 'queryUrl' | 'request'>>;
 export declare function validateOdTableColumns(columns: unknown, remote?: boolean): OdTableColumn[];
 export declare function validateOdTablePagination(pagination: unknown): OdTablePaginationConfig;
 export declare function validateOdTableInitialQuery(query: unknown): OdTableInitialQuery | undefined;
@@ -187,6 +205,8 @@ export declare function validateOdTableSourceMode<T extends object>(input: OdTab
  * so callers can route them to `data-error` without string matching.
  */
 export declare function validateOdTableResult<T>(payload: unknown): OdTableResult<T>;
+/** Restored from the 0.2 Schema contract, restricted to the current structural role. */
+export declare function validateOdTableSchema(payload: unknown): OdTableSchema;
 /** Copy only supported metadata so extra response properties cannot define UI. */
 export declare function validateOdTableMeta(payload: unknown): OdTableMeta;
 /** A null snapshot means the first response has not arrived: all query UI is closed. */

package/dist/components/OdTable.vue.d.ts

@@ -2,7 +2,7 @@ import { OdTableConfigError, OdTableProps, OdTableQuery, OdTableRowKey, OdTableS
 declare const _default: <T extends object>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
     props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{
         readonly onRetry?: ((payload: {
-            stage: "data";
+            stage: "schema" | "data";
         }) => any) | undefined;
         readonly "onSelection-change"?: ((keys: OdTableRowKey[], rows: T[]) => any) | undefined;
         readonly "onUpdate:selected-row-keys"?: ((keys: OdTableRowKey[]) => any) | undefined;
@@ -16,22 +16,24 @@ declare const _default: <T extends object>(__VLS_props: NonNullable<Awaited<type
             error: unknown;
             query: OdTableQuery;
         }) => any) | undefined;
+        readonly "onSchema-error"?: ((error: unknown) => any) | undefined;
         readonly "onConfig-error"?: ((error: OdTableConfigError) => any) | undefined;
-    } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>, "onRetry" | "onSelection-change" | "onUpdate:selected-row-keys" | "onQuery-change" | "onColumn-visibility-change" | "onColumn-width-change" | "onData-error" | "onConfig-error"> & OdTableProps<T> & Partial<{}>> & import('vue').PublicProps;
+    } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>, "onRetry" | "onSelection-change" | "onUpdate:selected-row-keys" | "onQuery-change" | "onColumn-visibility-change" | "onColumn-width-change" | "onData-error" | "onSchema-error" | "onConfig-error"> & OdTableProps<T> & Partial<{}>> & import('vue').PublicProps;
     expose(exposed: import('vue').ShallowUnwrapRef<{
         refresh: () => Promise<void>;
+        refreshSchema: () => Promise<void>;
     }>): void;
     attrs: any;
     slots: Readonly<OdTableSlots<T>> & OdTableSlots<T>;
     emit: ((evt: "retry", payload: {
-        stage: "data";
+        stage: "schema" | "data";
     }) => void) & ((evt: "selection-change", keys: OdTableRowKey[], rows: T[]) => void) & ((evt: "update:selected-row-keys", keys: OdTableRowKey[]) => void) & ((evt: "query-change", query: OdTableQuery) => void) & ((evt: "column-visibility-change", visibility: Record<string, boolean>) => void) & ((evt: "column-width-change", payload: {
         field: string;
         width: number;
     }) => void) & ((evt: "data-error", payload: {
         error: unknown;
         query: OdTableQuery;
-    }) => void) & ((evt: "config-error", error: OdTableConfigError) => void);
+    }) => void) & ((evt: "schema-error", error: unknown) => void) & ((evt: "config-error", error: OdTableConfigError) => void);
 }>) => import('vue').VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;
 };

package/dist/index.d.ts

@@ -5,7 +5,7 @@ import { default as OdTable } from './components/OdTable.vue';
 export { OdButton, OdIcon, OdTable };
 export { OdTableConfigError } from './components/OdTable.types';
 export type { OdButtonVariant, OdSize } from './components/OdButton.vue';
-export type { OdTableCellContext, OdTableColumn, OdTableConfigErrorCode, OdTableDataType, OdTableEvents, OdTableExpose, OdTableFilter, OdTableFieldMeta, OdTableInitialQuery, OdTableLocale, OdTableMeta, OdTableOption, OdTablePaginationConfig, OdTableProps, OdTableQuery, OdTableRequest, OdTableResult, OdTableRowKey, OdTableSearch, OdTableSorting, OdTableSlots, OdTableLoadData, } from './components/OdTable.types';
+export type { OdTableCellContext, OdTableColumn, OdTableConfigErrorCode, OdTableDataType, OdTableEvents, OdTableExpose, OdTableFilter, OdTableFieldMeta, OdTableInitialQuery, OdTableLocale, OdTableMeta, OdTableOption, OdTablePaginationConfig, OdTableProps, OdTableQuery, OdTableRequest, OdTableResult, OdTableRowKey, OdTableSearch, OdTableSorting, OdTableSlots, OdTableLoadData, OdTableSchemaColumn, OdTableSchema, OdTableLoadSchema, OdTableRequestOptions, } from './components/OdTable.types';
 export declare const OnedotUI: {
     install(app: App): void;
 };