@gcsa/console-core 0.1.0

package/dist/gcsaTableMigration.js

@@ -0,0 +1,65 @@
+export function normalizeGcsaTableColumns(columns, options = {}) {
+    let selectable = false;
+    let expandable = false;
+    let fixedSelection = false;
+    let selectionColumnWidth;
+    let expandColumnWidth;
+    const normalized = [];
+    const page = Math.max(1, options.page ?? 1);
+    const pageSize = Math.max(1, options.pageSize ?? 10);
+    const indexOffset = (page - 1) * pageSize;
+    columns.forEach((column, index) => {
+        const { formatter: legacyFormatter, children: legacyChildren, ...columnRest } = column;
+        const type = column.type;
+        const width = normalizeColumnWidth(column.width);
+        const minWidth = normalizeColumnWidth(column.minWidth ?? column['min-width']);
+        const showOverflowTooltip = column.showOverflowTooltip ?? column['show-overflow-tooltip'];
+        const sortMethod = column.sortMethod ?? column['sort-method'];
+        if (type === 'selection') {
+            selectable = column.selectable ?? true;
+            fixedSelection || (fixedSelection = Boolean(column.fixed));
+            selectionColumnWidth ?? (selectionColumnWidth = width ? Number.parseFloat(width) : undefined);
+            return;
+        }
+        if (type === 'expand') {
+            expandable = true;
+            expandColumnWidth ?? (expandColumnWidth = width ? Number.parseFloat(width) : undefined);
+            return;
+        }
+        const id = column.id ?? column.prop ?? (type === 'index' ? '__index' : `column-${index}`);
+        const header = column.header ?? column.label ?? (type === 'index' ? '#' : id);
+        const accessorKey = column.accessorKey ?? column.prop;
+        const children = legacyChildren?.length
+            ? normalizeGcsaTableColumns(legacyChildren, options).columns
+            : undefined;
+        normalized.push({
+            ...columnRest,
+            id,
+            header,
+            ...(accessorKey ? { accessorKey } : {}),
+            ...(children ? { columns: children } : {}),
+            sortable: column.sortable === 'custom' ? true : column.sortable,
+            ...(sortMethod ? { sortCompare: sortMethod } : {}),
+            ...(legacyFormatter ? { formatter: (value, row, rowIndex) => legacyFormatter(row, column, value, rowIndex) } : {}),
+            width,
+            minWidth,
+            showOverflowTooltip,
+            ...(type === 'index' ? {
+                formatter: (_value, _row, rowIndex) => {
+                    const absoluteIndex = indexOffset + rowIndex;
+                    if (typeof column.index === 'function')
+                        return column.index(absoluteIndex);
+                    if (typeof column.index === 'number')
+                        return column.index + absoluteIndex;
+                    return absoluteIndex + 1;
+                }
+            } : {})
+        });
+    });
+    return { columns: normalized, selectable, expandable, fixedSelection, selectionColumnWidth, expandColumnWidth };
+}
+function normalizeColumnWidth(value) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    return typeof value === 'number' ? `${value}px` : /^\d+(?:\.\d+)?$/.test(value) ? `${value}px` : value;
+}

package/dist/gcsaTablePreferences.d.ts

@@ -0,0 +1,16 @@
+export type GcsaTableSortingPreference = {
+    id: string;
+    desc: boolean;
+};
+export type GcsaTablePreferences = {
+    columnVisibility?: Record<string, boolean>;
+    columnWidths?: Record<string, number>;
+    sorting?: GcsaTableSortingPreference[];
+    pageSize?: number;
+};
+export type GcsaTablePreferenceStorage = Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>;
+export declare function normalizeGcsaTablePreferences(value: unknown): GcsaTablePreferences;
+export declare function readGcsaTablePreferences(storage: GcsaTablePreferenceStorage | undefined, key: string): GcsaTablePreferences;
+export declare function writeGcsaTablePreferences(storage: GcsaTablePreferenceStorage | undefined, key: string, value: GcsaTablePreferences): boolean;
+export declare function clearGcsaTablePreferences(storage: GcsaTablePreferenceStorage | undefined, key: string): boolean;
+//# sourceMappingURL=gcsaTablePreferences.d.ts.map

package/dist/gcsaTablePreferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcsaTablePreferences.d.ts","sourceRoot":"","sources":["../src/gcsaTablePreferences.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,0BAA0B,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEvE,MAAM,MAAM,oBAAoB,GAAG;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,0BAA0B,EAAE,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC,CAAC;AAY7F,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CASlF;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,0BAA0B,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAQ3H;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAQ5I;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAQ/G"}

package/dist/gcsaTablePreferences.js

@@ -0,0 +1,53 @@
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function normalizeRecord(value, predicate) {
+    if (!isRecord(value))
+        return undefined;
+    const entries = Object.entries(value).filter(([, entry]) => predicate(entry));
+    return entries.length ? Object.fromEntries(entries) : undefined;
+}
+export function normalizeGcsaTablePreferences(value) {
+    if (!isRecord(value))
+        return {};
+    const columnVisibility = normalizeRecord(value.columnVisibility, (entry) => typeof entry === 'boolean');
+    const columnWidths = normalizeRecord(value.columnWidths, (entry) => typeof entry === 'number' && Number.isFinite(entry) && entry > 0);
+    const sorting = Array.isArray(value.sorting)
+        ? value.sorting.filter(isRecord).filter(entry => typeof entry.id === 'string' && typeof entry.desc === 'boolean').map(entry => ({ id: entry.id, desc: entry.desc }))
+        : undefined;
+    const pageSize = typeof value.pageSize === 'number' && Number.isInteger(value.pageSize) && value.pageSize > 0 ? value.pageSize : undefined;
+    return { columnVisibility, columnWidths, sorting: sorting?.length ? sorting : undefined, pageSize };
+}
+export function readGcsaTablePreferences(storage, key) {
+    if (!storage || !key)
+        return {};
+    try {
+        const raw = storage.getItem(key);
+        return raw ? normalizeGcsaTablePreferences(JSON.parse(raw)) : {};
+    }
+    catch {
+        return {};
+    }
+}
+export function writeGcsaTablePreferences(storage, key, value) {
+    if (!storage || !key)
+        return false;
+    try {
+        storage.setItem(key, JSON.stringify(normalizeGcsaTablePreferences(value)));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function clearGcsaTablePreferences(storage, key) {
+    if (!storage || !key)
+        return false;
+    try {
+        storage.removeItem(key);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/gcsaTableRows.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Resolves the row id used by TanStack Table and the legacy table API.
+ * TanStack's default fallback is relative to the parent row; keeping that
+ * behavior here prevents parent and child rows from sharing an id in trees.
+ */
+export declare function getGcsaTableRowId<T extends Record<string, unknown>>(row: T, index: number, rowKey?: (keyof T & string) | ((row: T, index: number) => string), parentId?: string): string;
+export declare function getGcsaTableDefaultExpandedKeys<T extends Record<string, unknown>>(rows: T[], treeData: boolean, childrenKey: keyof T & string, rowKey?: (keyof T & string) | ((row: T, index: number) => string)): string[];
+//# sourceMappingURL=gcsaTableRows.d.ts.map

package/dist/gcsaTableRows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcsaTableRows.d.ts","sourceRoot":"","sources":["../src/gcsaTableRows.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,CAAA,MAAM,CAAC,GAAG,MAAM,IAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,EAC/D,QAAQ,CAAC,EAAE,MAAM,UAKlB;AAED,wBAAgB,+BAA+B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/E,IAAI,EAAE,CAAC,EAAE,EACT,QAAQ,EAAE,OAAO,EACjB,WAAW,EAAE,MAAM,CAAC,GAAG,MAAM,EAC7B,MAAM,CAAC,EAAE,CAAA,MAAM,CAAC,GAAG,MAAM,IAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,YAehE"}

package/dist/gcsaTableRows.js

@@ -0,0 +1,29 @@
+/**
+ * Resolves the row id used by TanStack Table and the legacy table API.
+ * TanStack's default fallback is relative to the parent row; keeping that
+ * behavior here prevents parent and child rows from sharing an id in trees.
+ */
+export function getGcsaTableRowId(row, index, rowKey, parentId) {
+    if (typeof rowKey === 'function')
+        return rowKey(row, index);
+    if (rowKey)
+        return String(row[rowKey]);
+    return parentId ? `${parentId}.${index}` : String(index);
+}
+export function getGcsaTableDefaultExpandedKeys(rows, treeData, childrenKey, rowKey) {
+    if (!treeData)
+        return rows.map((row, index) => getGcsaTableRowId(row, index, rowKey));
+    const keys = [];
+    const visit = (items, parentPath = '') => {
+        items.forEach((row, index) => {
+            const children = row[childrenKey];
+            if (!Array.isArray(children) || !children.length)
+                return;
+            const path = parentPath ? `${parentPath}.${index}` : String(index);
+            keys.push(rowKey ? getGcsaTableRowId(row, index, rowKey) : path);
+            visit(children, path);
+        });
+    };
+    visit(rows);
+    return keys;
+}

package/dist/gcsaTime.d.ts

@@ -0,0 +1,23 @@
+/** 24 小时制时间字符串 HH:mm */
+export type GcsaTimeString = string;
+export type GcsaTimePickerOptions = {
+    min?: GcsaTimeString;
+    max?: GcsaTimeString;
+    /** 步长，单位秒，默认 60 */
+    step?: number;
+};
+export declare const GCSA_TIME_STRING_PATTERN: RegExp;
+export declare const GCSA_TIME_PICKER_CELL_HEIGHT = 32;
+export declare function isGcsaTimeString(value: string): value is GcsaTimeString;
+export declare function gcsaTimeToMinutes(value?: string): number | undefined;
+export declare function gcsaMinutesToTime(totalMinutes: number): GcsaTimeString;
+export declare function gcsaNormalizeTimeStep(step?: number): number;
+export declare function gcsaBuildTimeOptions({ min, max, step }?: GcsaTimePickerOptions): GcsaTimeString[];
+export declare function gcsaTimePickerHours(options: GcsaTimeString[]): string[];
+export declare function gcsaTimePickerMinutes(options: GcsaTimeString[], hour: string): string[];
+export declare function gcsaResolveTimeDraft(value: string | undefined, options: GcsaTimeString[]): GcsaTimeString;
+export declare function gcsaNearestTimeOption(options: GcsaTimeString[], targetMinutes: number): GcsaTimeString;
+export declare function gcsaCurrentTimeOption(options: GcsaTimeString[]): GcsaTimeString;
+export declare function gcsaTimePickerScrollTop(index: number): number;
+export declare function gcsaTimePickerScrollIndex(scrollTop: number, itemCount: number): number;
+//# sourceMappingURL=gcsaTime.d.ts.map

package/dist/gcsaTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcsaTime.d.ts","sourceRoot":"","sources":["../src/gcsaTime.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,MAAM,MAAM,qBAAqB,GAAG;IAClC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,wBAAwB,QAAkB,CAAC;AACxD,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIpE;AAED,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,CAKtE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED,wBAAgB,oBAAoB,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAE,qBAA0B,GAAG,cAAc,EAAE,CAWrG;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,EAAE,CAEvE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,cAAc,CAGzG;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG,cAAc,CAMtG;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,cAAc,CAG/E;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGtF"}

package/dist/gcsaTime.js

@@ -0,0 +1,63 @@
+export const GCSA_TIME_STRING_PATTERN = /^\d{2}:\d{2}$/;
+export const GCSA_TIME_PICKER_CELL_HEIGHT = 32;
+export function isGcsaTimeString(value) {
+    return GCSA_TIME_STRING_PATTERN.test(value);
+}
+export function gcsaTimeToMinutes(value) {
+    if (!value || !GCSA_TIME_STRING_PATTERN.test(value))
+        return undefined;
+    const [hours, minutes] = value.split(':').map(Number);
+    return hours * 60 + minutes;
+}
+export function gcsaMinutesToTime(totalMinutes) {
+    const normalized = Math.max(0, Math.min(1439, totalMinutes));
+    const hours = Math.floor(normalized / 60);
+    const minutes = normalized % 60;
+    return `${String(hours).padStart(2, '0')}:${String(minutes).padStart(2, '0')}`;
+}
+export function gcsaNormalizeTimeStep(step) {
+    const seconds = Number(step);
+    if (!Number.isFinite(seconds) || seconds <= 0)
+        return 60;
+    return Math.max(60, Math.round(seconds / 60) * 60);
+}
+export function gcsaBuildTimeOptions({ min, max, step } = {}) {
+    const incrementMinutes = gcsaNormalizeTimeStep(step) / 60;
+    const start = Math.max(0, gcsaTimeToMinutes(min) ?? 0);
+    const end = Math.min(1439, gcsaTimeToMinutes(max) ?? 1439);
+    const result = [];
+    for (let value = start; value <= end; value += incrementMinutes) {
+        result.push(gcsaMinutesToTime(value));
+    }
+    return result.length ? result : [gcsaMinutesToTime(start)];
+}
+export function gcsaTimePickerHours(options) {
+    return [...new Set(options.map(option => option.slice(0, 2)))];
+}
+export function gcsaTimePickerMinutes(options, hour) {
+    return options.filter(option => option.startsWith(`${hour}:`)).map(option => option.slice(3));
+}
+export function gcsaResolveTimeDraft(value, options) {
+    if (value && options.includes(value))
+        return value;
+    return options[0] ?? '00:00';
+}
+export function gcsaNearestTimeOption(options, targetMinutes) {
+    return options.reduce((best, option) => {
+        const optionMinutes = gcsaTimeToMinutes(option) ?? 0;
+        const bestMinutes = gcsaTimeToMinutes(best) ?? 0;
+        return Math.abs(optionMinutes - targetMinutes) < Math.abs(bestMinutes - targetMinutes) ? option : best;
+    }, options[0] ?? '00:00');
+}
+export function gcsaCurrentTimeOption(options) {
+    const now = new Date();
+    return gcsaNearestTimeOption(options, now.getHours() * 60 + now.getMinutes());
+}
+export function gcsaTimePickerScrollTop(index) {
+    return Math.max(0, index) * GCSA_TIME_PICKER_CELL_HEIGHT;
+}
+export function gcsaTimePickerScrollIndex(scrollTop, itemCount) {
+    if (!itemCount)
+        return 0;
+    return Math.max(0, Math.min(itemCount - 1, Math.round(scrollTop / GCSA_TIME_PICKER_CELL_HEIGHT)));
+}

package/dist/index.d.ts

@@ -0,0 +1,163 @@
+import { z } from 'zod';
+export type GcsaNavItem = {
+    key: string;
+    label: string;
+    href?: string;
+    /** @deprecated use iconKey */
+    icon?: string;
+    iconKey?: 'dashboard' | 'alert' | 'assets' | 'settings' | 'users' | 'chat';
+};
+export type GcsaTableColumnAlign = 'left' | 'center' | 'right';
+/** 固定列方向；`true` 兼容 Element Plus，等价于左固定。 */
+export type GcsaTableColumnFixed = 'left' | 'right' | true;
+export type GcsaTableColumnFilter = {
+    type: 'text' | 'select';
+    placeholder?: string;
+    options?: GcsaSelectOption[];
+};
+export type GcsaTableColumn<T> = {
+    /** 列唯一键，对应插槽 `cell-{id}` / `header-{id}` */
+    id: string;
+    header: string;
+    accessorKey?: keyof T & string;
+    /** 是否可排序 */
+    sortable?: boolean;
+    /** 自定义客户端排序比较函数，返回值语义与 Array.sort 一致 */
+    sortCompare?: (a: T, b: T) => number;
+    width?: string;
+    /** 列最小宽度，避免窄容器下文字被挤成竖排 */
+    minWidth?: string;
+    /** 是否允许用户拖拽调整列宽 */
+    resizable?: boolean;
+    /** 内容过长时显示省略号，并通过 title 保留完整内容 */
+    showOverflowTooltip?: boolean;
+    align?: GcsaTableColumnAlign;
+    fixed?: GcsaTableColumnFixed;
+    hidden?: boolean;
+    filter?: GcsaTableColumnFilter;
+    /** 插槽后缀，默认与 id 相同 */
+    slot?: string;
+    /** 无插槽时的简易单元格渲染 */
+    cell?: (row: T) => unknown;
+    /** 默认单元格格式化；不改变排序和原始值，只改变展示内容 */
+    formatter?: (value: unknown, row: T, index: number) => unknown;
+    /** Grouped child columns; compatible with nested el-table-column definitions. */
+    columns?: GcsaTableColumn<T>[];
+};
+export { normalizeGcsaTableColumns } from './gcsaTableMigration';
+export type { GcsaLegacyTableColumn, GcsaTableMigration, GcsaTableMigrationOptions } from './gcsaTableMigration';
+export type GcsaChatMessageRole = 'user' | 'assistant' | 'system';
+export type GcsaChatMessage = {
+    id: string;
+    role: GcsaChatMessageRole;
+    content: string;
+    status?: 'streaming' | 'done' | 'error';
+    /** 消息时间，用于底部 meta 展示 */
+    createdAt?: string | number | Date;
+    /** 强制纯文本，不渲染 Markdown */
+    plainText?: boolean;
+    /** 系统就绪 / 提示类消息样式 */
+    systemReady?: boolean;
+    /** 错误消息样式 */
+    error?: boolean;
+};
+export { formatGcsaChatTime, gcsaChatAvatarLabel, shouldRenderGcsaChatMarkdown } from './gcsaChat';
+export type { GcsaChatMarkdownMode } from './gcsaChat';
+export { renderGcsaMarkdown } from './gcsaMarkdown';
+export type { GcsaMessageType } from './gcsaMessage';
+export { GCSA_MESSAGE_DURATION_MS } from './gcsaMessage';
+export { copyGcsaText } from './gcsaClipboard';
+export { collectGcsaMenuBranchKeys, navItemsToMenuItems } from './gcsaMenu';
+export type { GcsaMenuIconKey, GcsaMenuItem, GcsaMenuMode } from './gcsaMenu';
+export declare const gcsaLoginSchema: z.ZodObject<{
+    email: z.ZodString;
+    password: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    email: string;
+    password: string;
+}, {
+    email: string;
+    password: string;
+}>;
+export { formatGcsaDateParts, formatGcsaMonthParts, isGcsaDateString, isGcsaMonthString } from './gcsaDate';
+export { GCSA_TIME_PICKER_CELL_HEIGHT, GCSA_TIME_STRING_PATTERN, gcsaBuildTimeOptions, gcsaCurrentTimeOption, gcsaMinutesToTime, gcsaNearestTimeOption, gcsaNormalizeTimeStep, gcsaResolveTimeDraft, gcsaTimePickerHours, gcsaTimePickerMinutes, gcsaTimePickerScrollIndex, gcsaTimePickerScrollTop, gcsaTimeToMinutes, isGcsaTimeString } from './gcsaTime';
+export type { GcsaTimePickerOptions, GcsaTimeString } from './gcsaTime';
+export type { GcsaDatePickerMode, GcsaDateRangeValue, GcsaDateString, GcsaMonthRangeValue, GcsaMonthString } from './gcsaDate';
+export { GCSA_DEFAULT_LOCALE, formatGcsaLocaleMessage, getGcsaDatePickerMessages, getGcsaLocaleMessages, getGcsaStartOfWeek, normalizeGcsaLocale } from './gcsaLocale';
+export type { GcsaConsoleLocale, GcsaConsoleLocaleMessages, GcsaDatePickerLocaleStrings } from './gcsaLocale';
+export { clearGcsaTablePreferences, normalizeGcsaTablePreferences, readGcsaTablePreferences, writeGcsaTablePreferences } from './gcsaTablePreferences';
+export type { GcsaTablePreferenceStorage, GcsaTablePreferences, GcsaTableSortingPreference } from './gcsaTablePreferences';
+export { GCSA_TABLE_DEFAULT_COLUMN_MIN_WIDTH, GCSA_TABLE_EXPAND_COLUMN_WIDTH, GCSA_TABLE_MIN_WIDTH_FLOOR, GCSA_TABLE_SELECTION_COLUMN_WIDTH, getGcsaTableFixedOffset, getGcsaTableMinWidth } from './gcsaTableLayout';
+export type { GcsaTableFixedOffsetOptions, GcsaTableLayoutColumn } from './gcsaTableLayout';
+export { getGcsaTableSortChange, getGcsaTableSorting } from './gcsaTableEvents';
+export type { GcsaTableColumnInfo, GcsaTableHeaderEvent, GcsaTableSortChange, GcsaTableSortOrder, GcsaTableSortingEntry } from './gcsaTableEvents';
+export { getGcsaTableDefaultExpandedKeys, getGcsaTableRowId } from './gcsaTableRows';
+export { getGcsaPaginationItems, parseGcsaPaginationLayout, resolveGcsaPaginationLayout, getGcsaPaginationAlignClass, GCSA_PAGINATION_LAYOUT_PARTS } from './gcsaPagination';
+export type { GcsaPaginationItem, GcsaPaginationAlign, GcsaPaginationLayoutPart } from './gcsaPagination';
+export declare const gcsaNotifySchema: z.ZodObject<{
+    title: z.ZodString;
+    channel: z.ZodEnum<["email", "webhook", "sms"]>;
+    enabled: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    channel: "email" | "webhook" | "sms";
+    enabled: boolean;
+}, {
+    title: string;
+    channel: "email" | "webhook" | "sms";
+    enabled: boolean;
+}>;
+export type GcsaNotifyValues = z.infer<typeof gcsaNotifySchema>;
+export type GcsaButtonVariant = 'primary' | 'secondary' | 'ghost' | 'danger' | 'link';
+export type GcsaButtonSize = 'sm' | 'md' | 'lg';
+export type { GcsaComponentSize } from './gcsaSize';
+import type { GcsaComponentSize } from './gcsaSize';
+export type GcsaSelectSize = GcsaComponentSize;
+export type GcsaInputNumberControls = 'both' | 'right' | 'none';
+export type GcsaConsoleTheme = 'dark' | 'light';
+export type GcsaDrawerPlacement = 'left' | 'right' | 'top' | 'bottom';
+export type GcsaSelectOption = {
+    label: string;
+    value: string;
+    /** 分组标题；同组选项使用相同 group */
+    group?: string;
+    disabled?: boolean;
+};
+export type GcsaCascaderOption = {
+    label: string;
+    value: string;
+    disabled?: boolean;
+    children?: GcsaCascaderOption[];
+};
+export type GcsaTransferOption = {
+    label: string;
+    value: string;
+    disabled?: boolean;
+};
+export type GcsaStepStatus = 'wait' | 'process' | 'finish' | 'error';
+export type GcsaStepItem = {
+    key: string;
+    title: string;
+    description?: string;
+    status?: GcsaStepStatus;
+    disabled?: boolean;
+};
+export type GcsaTimelineItem = {
+    key: string;
+    label?: string;
+    content: string;
+    time?: string;
+    tone?: 'primary' | 'success' | 'warning' | 'danger';
+};
+export type GcsaRadioOption = {
+    label: string;
+    value: string;
+    disabled?: boolean;
+};
+export { GCSA_DEFAULT_COMPONENT_SIZE, gcsaControlSizeClass, resolveGcsaButtonSize, resolveGcsaComponentSize } from './gcsaSize';
+export { createGcsaPopupPositioning, type GcsaPopupPlacement, type GcsaPopupPositioningOptions } from './gcsaPopupPositioning';
+export { assertFloatingWithinViewport, buildGcsaPopupMiddleware, computeGcsaPopupPosition, getFloatingBox, type GcsaPopupRect, type GcsaViewportRect } from './gcsaPopupCollision';
+export { GCSA_POPUP_OVERFLOW_PADDING, GCSA_POPUP_STYLE_CONTRACT, GCSA_POPUP_VIEWPORT_CSS_INSET, cssBlockIncludes, extractCssRuleBlock, validatePopupStyleContract, type GcsaPopupStyleRule } from './gcsaPopupStyles';
+export { toCssLength } from './gcsaCssLength';
+export { gcsaJoinDateTime, gcsaSplitDateTime, type GcsaDateTimeString } from './gcsaDateTimeValue';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+export { normalizeGcsaTableColumns } from './gcsaTableMigration';
+export { formatGcsaChatTime, gcsaChatAvatarLabel, shouldRenderGcsaChatMarkdown } from './gcsaChat';
+export { renderGcsaMarkdown } from './gcsaMarkdown';
+export { GCSA_MESSAGE_DURATION_MS } from './gcsaMessage';
+export { copyGcsaText } from './gcsaClipboard';
+export { collectGcsaMenuBranchKeys, navItemsToMenuItems } from './gcsaMenu';
+export const gcsaLoginSchema = z.object({
+    email: z.string().email('请输入有效邮箱'),
+    password: z.string().min(6, '至少 6 位密码')
+});
+export { formatGcsaDateParts, formatGcsaMonthParts, isGcsaDateString, isGcsaMonthString } from './gcsaDate';
+export { GCSA_TIME_PICKER_CELL_HEIGHT, GCSA_TIME_STRING_PATTERN, gcsaBuildTimeOptions, gcsaCurrentTimeOption, gcsaMinutesToTime, gcsaNearestTimeOption, gcsaNormalizeTimeStep, gcsaResolveTimeDraft, gcsaTimePickerHours, gcsaTimePickerMinutes, gcsaTimePickerScrollIndex, gcsaTimePickerScrollTop, gcsaTimeToMinutes, isGcsaTimeString } from './gcsaTime';
+export { GCSA_DEFAULT_LOCALE, formatGcsaLocaleMessage, getGcsaDatePickerMessages, getGcsaLocaleMessages, getGcsaStartOfWeek, normalizeGcsaLocale } from './gcsaLocale';
+export { clearGcsaTablePreferences, normalizeGcsaTablePreferences, readGcsaTablePreferences, writeGcsaTablePreferences } from './gcsaTablePreferences';
+export { GCSA_TABLE_DEFAULT_COLUMN_MIN_WIDTH, GCSA_TABLE_EXPAND_COLUMN_WIDTH, GCSA_TABLE_MIN_WIDTH_FLOOR, GCSA_TABLE_SELECTION_COLUMN_WIDTH, getGcsaTableFixedOffset, getGcsaTableMinWidth } from './gcsaTableLayout';
+export { getGcsaTableSortChange, getGcsaTableSorting } from './gcsaTableEvents';
+export { getGcsaTableDefaultExpandedKeys, getGcsaTableRowId } from './gcsaTableRows';
+export { getGcsaPaginationItems, parseGcsaPaginationLayout, resolveGcsaPaginationLayout, getGcsaPaginationAlignClass, GCSA_PAGINATION_LAYOUT_PARTS } from './gcsaPagination';
+export const gcsaNotifySchema = z.object({
+    title: z.string().min(1, '标题不能为空'),
+    channel: z.enum(['email', 'webhook', 'sms']),
+    enabled: z.boolean()
+});
+export { GCSA_DEFAULT_COMPONENT_SIZE, gcsaControlSizeClass, resolveGcsaButtonSize, resolveGcsaComponentSize } from './gcsaSize';
+export { createGcsaPopupPositioning } from './gcsaPopupPositioning';
+export { assertFloatingWithinViewport, buildGcsaPopupMiddleware, computeGcsaPopupPosition, getFloatingBox } from './gcsaPopupCollision';
+export { GCSA_POPUP_OVERFLOW_PADDING, GCSA_POPUP_STYLE_CONTRACT, GCSA_POPUP_VIEWPORT_CSS_INSET, cssBlockIncludes, extractCssRuleBlock, validatePopupStyleContract } from './gcsaPopupStyles';
+export { toCssLength } from './gcsaCssLength';
+export { gcsaJoinDateTime, gcsaSplitDateTime } from './gcsaDateTimeValue';

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@gcsa/console-core",
+  "version": "0.1.0",
+  "description": "Shared types and schemas for GCSA console UI",
+  "type": "module",
+  "license": "UNLICENSED",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "dompurify": "^3.4.11",
+    "marked": "^18.0.5",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@floating-ui/dom": "^1.8.0",
+    "happy-dom": "^17.4.7",
+    "typescript": "^5.8.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "node --test tests/*.test.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}

package/src/gcsaChat.ts

@@ -0,0 +1,35 @@
+import type { GcsaChatMessage, GcsaChatMessageRole } from './index';
+
+export type GcsaChatMarkdownMode = false | true | 'assistant';
+
+export function shouldRenderGcsaChatMarkdown(
+  message: GcsaChatMessage,
+  mode: GcsaChatMarkdownMode = 'assistant'
+): boolean {
+  if (message.plainText) return false;
+  if (mode === false) return false;
+  if (mode === true) return true;
+  return message.role === 'assistant' && !message.systemReady;
+}
+
+export function gcsaChatAvatarLabel(
+  message: GcsaChatMessage,
+  labels?: Partial<Record<GcsaChatMessageRole, string>>
+): string {
+  if (labels?.[message.role]) return labels[message.role]!;
+  if (message.role === 'user') return 'U';
+  if (message.role === 'system') return 'S';
+  return 'A';
+}
+
+export function formatGcsaChatTime(value?: string | number | Date): string {
+  if (value == null || value === '') return '';
+  const date = value instanceof Date ? value : new Date(value);
+  if (Number.isNaN(date.getTime())) return '';
+  return date.toLocaleString(undefined, {
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit'
+  });
+}

package/src/gcsaClipboard.ts

@@ -0,0 +1,28 @@
+export async function copyGcsaText(text: string): Promise<boolean> {
+  if (!text) return false;
+
+  try {
+    if (typeof navigator !== 'undefined' && navigator.clipboard?.writeText) {
+      await navigator.clipboard.writeText(text);
+      return true;
+    }
+  } catch {
+    // fall through to legacy copy
+  }
+
+  try {
+    if (typeof document === 'undefined') return false;
+    const textarea = document.createElement('textarea');
+    textarea.value = text;
+    textarea.setAttribute('readonly', '');
+    textarea.style.position = 'fixed';
+    textarea.style.left = '-9999px';
+    document.body.appendChild(textarea);
+    textarea.select();
+    const ok = document.execCommand('copy');
+    document.body.removeChild(textarea);
+    return ok;
+  } catch {
+    return false;
+  }
+}

package/src/gcsaCssLength.ts

@@ -0,0 +1,5 @@
+/** 将组件 width/minWidth/maxWidth 等 prop 规范为 CSS 长度字符串 */
+export function toCssLength(value?: string | number): string | undefined {
+  if (value === undefined || value === null || value === '') return undefined;
+  return typeof value === 'number' ? `${value}px` : value;
+}

package/src/gcsaDate.ts

@@ -0,0 +1,30 @@
+/** ISO 日期字符串 YYYY-MM-DD */
+export type GcsaDateString = string;
+
+/** ISO 年月字符串 YYYY-MM */
+export type GcsaMonthString = string;
+
+/** 日期范围 [开始, 结束]，均为 YYYY-MM-DD；未选时对应项为空字符串 */
+export type GcsaDateRangeValue = [GcsaDateString, GcsaDateString];
+
+/** 年月范围 [开始, 结束]，均为 YYYY-MM；未选时对应项为空字符串 */
+export type GcsaMonthRangeValue = [GcsaMonthString, GcsaMonthString];
+
+/** DatePicker / DateRangePicker 选择粒度 */
+export type GcsaDatePickerMode = 'date' | 'month';
+
+export function isGcsaDateString(value: string): boolean {
+  return /^\d{4}-\d{2}-\d{2}$/.test(value);
+}
+
+export function isGcsaMonthString(value: string): boolean {
+  return /^\d{4}-\d{2}$/.test(value);
+}
+
+export function formatGcsaDateParts(year: number, month: number, day: number): GcsaDateString {
+  return `${year}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}`;
+}
+
+export function formatGcsaMonthParts(year: number, month: number): GcsaMonthString {
+  return `${year}-${String(month).padStart(2, '0')}`;
+}

package/src/gcsaDateTimeValue.ts

@@ -0,0 +1,18 @@
+/** ISO 日期时间字符串 YYYY-MM-DD HH:mm:ss */
+export type GcsaDateTimeString = string;
+
+export function gcsaSplitDateTime(value?: string | null): { date: string; time: string } {
+  if (!value?.trim()) return { date: '', time: '00:00:00' };
+  const [date = '', time = '00:00:00'] = value.trim().split(/\s+/);
+  const [hour = '00', minute = '00', second = '00'] = time.split(':');
+  return {
+    date,
+    time: `${hour.padStart(2, '0')}:${minute.padStart(2, '0')}:${second.padStart(2, '0').slice(0, 2)}`
+  };
+}
+
+export function gcsaJoinDateTime(date: string, time: string): GcsaDateTimeString {
+  if (!date) return '';
+  const [hour = '00', minute = '00', second = '00'] = (time || '00:00:00').split(':');
+  return `${date} ${hour.padStart(2, '0')}:${minute.padStart(2, '0')}:${second.padStart(2, '0').slice(0, 2)}`;
+}