@gcsa/console-core 0.1.0

package/dist/gcsaMenu.js

@@ -0,0 +1,20 @@
+export function navItemsToMenuItems(items) {
+    return items.map(item => ({
+        key: item.key,
+        label: item.label,
+        iconKey: item.iconKey,
+        href: item.href
+    }));
+}
+export function collectGcsaMenuBranchKeys(items) {
+    const keys = [];
+    for (const item of items) {
+        if (item.type === 'group' || item.type === 'divider')
+            continue;
+        if (item.children?.length) {
+            keys.push(item.key);
+            keys.push(...collectGcsaMenuBranchKeys(item.children));
+        }
+    }
+    return keys;
+}

package/dist/gcsaMessage.d.ts

@@ -0,0 +1,3 @@
+export type GcsaMessageType = 'success' | 'error' | 'info';
+export declare const GCSA_MESSAGE_DURATION_MS = 3200;
+//# sourceMappingURL=gcsaMessage.d.ts.map

package/dist/gcsaMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcsaMessage.d.ts","sourceRoot":"","sources":["../src/gcsaMessage.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3D,eAAO,MAAM,wBAAwB,OAAO,CAAC"}

package/dist/gcsaMessage.js

@@ -0,0 +1 @@
+export const GCSA_MESSAGE_DURATION_MS = 3200;

package/dist/gcsaPagination.d.ts

@@ -0,0 +1,13 @@
+export type GcsaPaginationItem = number | 'ellipsis-start' | 'ellipsis-end';
+export type GcsaPaginationAlign = 'left' | 'center' | 'right';
+export type GcsaPaginationLayoutPart = 'total' | 'sizes' | 'prev' | 'pager' | 'next' | 'jumper';
+export declare const GCSA_PAGINATION_LAYOUT_PARTS: readonly ["total", "sizes", "prev", "pager", "next", "jumper"];
+export declare function parseGcsaPaginationLayout(layout: string | readonly GcsaPaginationLayoutPart[]): GcsaPaginationLayoutPart[];
+export declare function resolveGcsaPaginationLayout(options: {
+    layout?: string | readonly GcsaPaginationLayoutPart[];
+    showPageSize?: boolean;
+    showJumper?: boolean;
+}): GcsaPaginationLayoutPart[];
+export declare function getGcsaPaginationAlignClass(align?: GcsaPaginationAlign): string;
+export declare function getGcsaPaginationItems(page: number, totalPages: number, maxVisible?: number): GcsaPaginationItem[];
+//# sourceMappingURL=gcsaPagination.d.ts.map

package/dist/gcsaPagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcsaPagination.d.ts","sourceRoot":"","sources":["../src/gcsaPagination.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,gBAAgB,GAAG,cAAc,CAAC;AAE5E,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE9D,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEhG,eAAO,MAAM,4BAA4B,gEAOe,CAAC;AAIzD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,GAAG,SAAS,wBAAwB,EAAE,GACnD,wBAAwB,EAAE,CAU5B;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE;IACnD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,wBAAwB,EAAE,CAAC;IACtD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,wBAAwB,EAAE,CAS7B;AAED,wBAAgB,2BAA2B,CAAC,KAAK,GAAE,mBAA6B,GAAG,MAAM,CAExF;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,SAAI,GAAG,kBAAkB,EAAE,CAiB7G"}

package/dist/gcsaPagination.js

@@ -0,0 +1,52 @@
+export const GCSA_PAGINATION_LAYOUT_PARTS = [
+    'total',
+    'sizes',
+    'prev',
+    'pager',
+    'next',
+    'jumper'
+];
+const paginationLayoutPartSet = new Set(GCSA_PAGINATION_LAYOUT_PARTS);
+export function parseGcsaPaginationLayout(layout) {
+    const parts = typeof layout === 'string'
+        ? layout
+            .split(',')
+            .map(part => part.trim())
+            .filter(Boolean)
+        : [...layout];
+    return parts.filter((part) => paginationLayoutPartSet.has(part));
+}
+export function resolveGcsaPaginationLayout(options) {
+    if (options.layout) {
+        return parseGcsaPaginationLayout(options.layout);
+    }
+    const parts = ['prev', 'pager', 'next'];
+    if (options.showPageSize)
+        parts.push('sizes');
+    if (options.showJumper)
+        parts.push('jumper');
+    return parts;
+}
+export function getGcsaPaginationAlignClass(align = 'right') {
+    return `gcsa-pagination--align-${align}`;
+}
+export function getGcsaPaginationItems(page, totalPages, maxVisible = 7) {
+    const count = Math.max(1, Math.floor(totalPages));
+    const current = Math.min(Math.max(1, Math.floor(page)), count);
+    const visible = Math.max(5, Math.floor(maxVisible));
+    if (count <= visible)
+        return Array.from({ length: count }, (_, index) => index + 1);
+    const innerCount = visible - 2;
+    let start = Math.max(2, current - Math.floor(innerCount / 2));
+    let end = Math.min(count - 1, start + innerCount - 1);
+    start = Math.max(2, end - innerCount + 1);
+    const items = [1];
+    if (start > 2)
+        items.push('ellipsis-start');
+    for (let value = start; value <= end; value += 1)
+        items.push(value);
+    if (end < count - 1)
+        items.push('ellipsis-end');
+    items.push(count);
+    return items;
+}

package/dist/gcsaPopupCollision.d.ts

@@ -0,0 +1,22 @@
+import { type Middleware } from '@floating-ui/dom';
+import { createGcsaPopupPositioning, type GcsaPopupPositioningOptions } from './gcsaPopupPositioning';
+export type GcsaPopupRect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type GcsaViewportRect = {
+    width: number;
+    height: number;
+};
+/** 与 Zag popper get-placement 对齐的 middleware 组合 */
+export declare function buildGcsaPopupMiddleware(options: ReturnType<typeof createGcsaPopupPositioning>): Middleware[];
+export declare function computeGcsaPopupPosition(reference: Element, floating: HTMLElement, options?: GcsaPopupPositioningOptions): Promise<import("@floating-ui/dom").ComputePositionReturn>;
+export declare function getFloatingBox(position: {
+    x: number;
+    y: number;
+}, floating: Element): GcsaPopupRect;
+/** 断言浮层在视口内并保留 overflowPadding */
+export declare function assertFloatingWithinViewport(box: GcsaPopupRect, viewport: GcsaViewportRect, overflowPadding?: number): string[];
+//# sourceMappingURL=gcsaPopupCollision.d.ts.map

package/dist/gcsaPopupCollision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcsaPopupCollision.d.ts","sourceRoot":"","sources":["../src/gcsaPopupCollision.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,UAAU,EAEhB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,0BAA0B,EAC1B,KAAK,2BAA2B,EACjC,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,aAAa,GAAG;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,mDAAmD;AACnD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,UAAU,CAAC,OAAO,0BAA0B,CAAC,GACrD,UAAU,EAAE,CA4Bd;AAED,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,OAAO,EAClB,QAAQ,EAAE,WAAW,EACrB,OAAO,GAAE,2BAAgC,6DAQ1C;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAClC,QAAQ,EAAE,OAAO,GAChB,aAAa,CAQf;AAED,kCAAkC;AAClC,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,gBAAgB,EAC1B,eAAe,SAAI,YAoBpB"}

package/dist/gcsaPopupCollision.js

@@ -0,0 +1,66 @@
+import { computePosition, flip, limitShift, offset, shift, size } from '@floating-ui/dom';
+import { createGcsaPopupPositioning } from './gcsaPopupPositioning';
+/** 与 Zag popper get-placement 对齐的 middleware 组合 */
+export function buildGcsaPopupMiddleware(options) {
+    const middleware = [
+        offset(options.gutter),
+        flip({ padding: options.overflowPadding }),
+        shift({
+            padding: options.overflowPadding,
+            mainAxis: options.slide,
+            crossAxis: options.overlap,
+            limiter: limitShift()
+        }),
+        size({
+            padding: options.overflowPadding,
+            apply({ elements, rects, availableWidth, availableHeight }) {
+                const floating = elements.floating;
+                floating.style.setProperty('--reference-width', `${Math.round(rects.reference.width)}px`);
+                floating.style.setProperty('--reference-height', `${Math.round(rects.reference.height)}px`);
+                floating.style.setProperty('--available-width', `${Math.floor(availableWidth)}px`);
+                floating.style.setProperty('--available-height', `${Math.floor(availableHeight)}px`);
+                if (options.sameWidth) {
+                    floating.style.width = `${Math.round(rects.reference.width)}px`;
+                }
+                if (options.fitViewport) {
+                    floating.style.maxWidth = `${Math.floor(availableWidth)}px`;
+                }
+            }
+        })
+    ];
+    return middleware;
+}
+export async function computeGcsaPopupPosition(reference, floating, options = {}) {
+    const config = createGcsaPopupPositioning(options);
+    return computePosition(reference, floating, {
+        placement: config.placement,
+        strategy: config.strategy,
+        middleware: buildGcsaPopupMiddleware(config)
+    });
+}
+export function getFloatingBox(position, floating) {
+    const rect = floating.getBoundingClientRect();
+    return {
+        x: position.x,
+        y: position.y,
+        width: rect.width,
+        height: rect.height
+    };
+}
+/** 断言浮层在视口内并保留 overflowPadding */
+export function assertFloatingWithinViewport(box, viewport, overflowPadding = 8) {
+    const errors = [];
+    if (box.x < overflowPadding) {
+        errors.push(`left overflow: x=${box.x} < padding=${overflowPadding}`);
+    }
+    if (box.y < overflowPadding) {
+        errors.push(`top overflow: y=${box.y} < padding=${overflowPadding}`);
+    }
+    if (box.x + box.width > viewport.width - overflowPadding) {
+        errors.push(`right overflow: x+w=${box.x + box.width} > viewport-padding=${viewport.width - overflowPadding}`);
+    }
+    if (box.y + box.height > viewport.height - overflowPadding) {
+        errors.push(`bottom overflow: y+h=${box.y + box.height} > viewport-padding=${viewport.height - overflowPadding}`);
+    }
+    return errors;
+}

package/dist/gcsaPopupPositioning.d.ts

@@ -0,0 +1,30 @@
+/** Ark UI / Zag Popper 通用方位（与 Floating UI placement 对齐） */
+export type GcsaPopupPlacement = 'top' | 'top-start' | 'top-end' | 'right' | 'right-start' | 'right-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end';
+export type GcsaPopupPositioningOptions = {
+    placement?: GcsaPopupPlacement;
+    gutter?: number;
+    strategy?: 'fixed' | 'absolute';
+    sameWidth?: boolean;
+    fitViewport?: boolean;
+    flip?: boolean;
+    slide?: boolean;
+    /** zag 用 overlap 开启横向 shift，避免贴边触发器时面板溢出视口 */
+    overlap?: boolean;
+    overflowPadding?: number;
+};
+/**
+ * 统一浮层定位：flip / slide / overlap 默认开启，减少贴边溢出。
+ * 供 Select、Menu、Popover、Tooltip、DatePicker 等复用。
+ */
+export declare function createGcsaPopupPositioning(options?: GcsaPopupPositioningOptions): {
+    fitViewport?: boolean | undefined;
+    sameWidth?: boolean | undefined;
+    placement: GcsaPopupPlacement;
+    gutter: number;
+    strategy: "fixed" | "absolute";
+    flip: boolean;
+    slide: boolean;
+    overlap: boolean;
+    overflowPadding: number;
+};
+//# sourceMappingURL=gcsaPopupPositioning.d.ts.map

package/dist/gcsaPopupPositioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcsaPopupPositioning.d.ts","sourceRoot":"","sources":["../src/gcsaPopupPositioning.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,MAAM,kBAAkB,GAC1B,KAAK,GACL,WAAW,GACX,SAAS,GACT,OAAO,GACP,aAAa,GACb,WAAW,GACX,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,UAAU,CAAC;AAEf,MAAM,MAAM,2BAA2B,GAAG;IACxC,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAChC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,2BAAgC;;;;;;;;;;EAwBnF"}

package/dist/gcsaPopupPositioning.js

@@ -0,0 +1,18 @@
+/**
+ * 统一浮层定位：flip / slide / overlap 默认开启，减少贴边溢出。
+ * 供 Select、Menu、Popover、Tooltip、DatePicker 等复用。
+ */
+export function createGcsaPopupPositioning(options = {}) {
+    const { placement = 'bottom-start', gutter = 8, strategy = 'fixed', sameWidth, fitViewport, flip = true, slide = true, overlap = true, overflowPadding = 8 } = options;
+    return {
+        placement,
+        gutter,
+        strategy,
+        flip,
+        slide,
+        overlap,
+        overflowPadding,
+        ...(sameWidth === undefined ? {} : { sameWidth }),
+        ...(fitViewport === undefined ? {} : { fitViewport })
+    };
+}

package/dist/gcsaPopupStyles.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 浮层样式契约：与 packages/styles/src/console-ui.css 保持同步。
+ * 测试会校验 CSS 中是否仍包含这些规则，防止 padding / 碰撞变量被改坏。
+ */
+export declare const GCSA_POPUP_OVERFLOW_PADDING = 8;
+export declare const GCSA_POPUP_VIEWPORT_CSS_INSET = 16;
+export declare const GCSA_POPUP_STYLE_CONTRACT: {
+    readonly selectContent: {
+        readonly selector: ".gcsa-select-content";
+        readonly maxWidth: "var(--available-width, 100vw)";
+        readonly minWidth: "min(160px, var(--reference-width, 160px))";
+    };
+    readonly selectList: {
+        readonly selector: ".gcsa-select-list";
+        readonly padding: "4px";
+    };
+    readonly selectItem: {
+        readonly selector: ".gcsa-select-item";
+        readonly padding: "8px 10px";
+    };
+    readonly tooltip: {
+        readonly selector: ".gcsa-tooltip";
+        readonly padding: "6px 12px";
+        readonly maxWidth: "min(240px, var(--available-width, calc(100vw - 16px)))";
+    };
+    readonly popover: {
+        readonly selector: ".gcsa-popover";
+        readonly padding: "12px 14px";
+        readonly maxWidth: "min(320px, var(--available-width, calc(100vw - 16px)))";
+    };
+    readonly dropdown: {
+        readonly selector: ".gcsa-dropdown";
+        readonly maxWidth: "var(--available-width, calc(100vw - 16px))";
+    };
+    readonly dateTimePicker: {
+        readonly selector: ".gcsa-date-picker__content.gcsa-datetime-picker__content";
+        readonly maxWidth: "var(--available-width, calc(100vw - 16px))";
+    };
+};
+export type GcsaPopupStyleRule = {
+    selector: string;
+    padding?: string;
+    minWidth?: string;
+    maxWidth?: string;
+};
+export declare function stripCssComments(css: string): string;
+export declare function extractCssRuleBlocks(css: string, selector: string): string[];
+export declare function extractCssRuleBlock(css: string, selector: string): string | null;
+export declare function cssBlockIncludes(block: string, declaration: string): boolean;
+export declare function validatePopupStyleContract(css: string, contract: Record<string, GcsaPopupStyleRule>): string[];
+//# sourceMappingURL=gcsaPopupStyles.d.ts.map

package/dist/gcsaPopupStyles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcsaPopupStyles.d.ts","sourceRoot":"","sources":["../src/gcsaPopupStyles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgC5B,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAsD5E;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGhF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAE5E;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,YAmBnG"}

package/dist/gcsaPopupStyles.js

@@ -0,0 +1,115 @@
+/**
+ * 浮层样式契约：与 packages/styles/src/console-ui.css 保持同步。
+ * 测试会校验 CSS 中是否仍包含这些规则，防止 padding / 碰撞变量被改坏。
+ */
+export const GCSA_POPUP_OVERFLOW_PADDING = 8;
+export const GCSA_POPUP_VIEWPORT_CSS_INSET = 16;
+export const GCSA_POPUP_STYLE_CONTRACT = {
+    selectContent: {
+        selector: '.gcsa-select-content',
+        maxWidth: 'var(--available-width, 100vw)',
+        minWidth: 'min(160px, var(--reference-width, 160px))'
+    },
+    selectList: {
+        selector: '.gcsa-select-list',
+        padding: '4px'
+    },
+    selectItem: {
+        selector: '.gcsa-select-item',
+        padding: '8px 10px'
+    },
+    tooltip: {
+        selector: '.gcsa-tooltip',
+        padding: '6px 12px',
+        maxWidth: 'min(240px, var(--available-width, calc(100vw - 16px)))'
+    },
+    popover: {
+        selector: '.gcsa-popover',
+        padding: '12px 14px',
+        maxWidth: 'min(320px, var(--available-width, calc(100vw - 16px)))'
+    },
+    dropdown: {
+        selector: '.gcsa-dropdown',
+        maxWidth: 'var(--available-width, calc(100vw - 16px))'
+    },
+    dateTimePicker: {
+        selector: '.gcsa-date-picker__content.gcsa-datetime-picker__content',
+        maxWidth: 'var(--available-width, calc(100vw - 16px))'
+    }
+};
+export function stripCssComments(css) {
+    return css.replace(/\/\*[\s\S]*?\*\//g, '');
+}
+export function extractCssRuleBlocks(css, selector) {
+    const normalized = stripCssComments(css);
+    const blocks = [];
+    let depth = 0;
+    let index = 0;
+    while (index < normalized.length) {
+        const char = normalized[index];
+        if (char === '{') {
+            depth += 1;
+            index += 1;
+            continue;
+        }
+        if (char === '}') {
+            depth = Math.max(0, depth - 1);
+            index += 1;
+            continue;
+        }
+        if (depth !== 0 || char === '@') {
+            index += 1;
+            continue;
+        }
+        const braceStart = normalized.indexOf('{', index);
+        if (braceStart === -1) {
+            break;
+        }
+        const selectorPart = normalized.slice(index, braceStart).trim();
+        let ruleDepth = 1;
+        let cursor = braceStart + 1;
+        while (cursor < normalized.length && ruleDepth > 0) {
+            if (normalized[cursor] === '{') {
+                ruleDepth += 1;
+            }
+            if (normalized[cursor] === '}') {
+                ruleDepth -= 1;
+            }
+            cursor += 1;
+        }
+        const block = normalized.slice(braceStart + 1, cursor - 1);
+        const selectors = selectorPart.split(',').map((part) => part.trim());
+        if (selectors.includes(selector)) {
+            blocks.push(block);
+        }
+        index = cursor;
+    }
+    return blocks;
+}
+export function extractCssRuleBlock(css, selector) {
+    const blocks = extractCssRuleBlocks(css, selector);
+    return blocks.length ? blocks.join('\n') : null;
+}
+export function cssBlockIncludes(block, declaration) {
+    return block.replace(/\s+/g, ' ').includes(declaration.replace(/\s+/g, ' '));
+}
+export function validatePopupStyleContract(css, contract) {
+    const failures = [];
+    for (const [name, rule] of Object.entries(contract)) {
+        const block = extractCssRuleBlock(css, rule.selector);
+        if (!block) {
+            failures.push(`${name}: missing selector ${rule.selector}`);
+            continue;
+        }
+        if (rule.padding && !cssBlockIncludes(block, `padding: ${rule.padding}`)) {
+            failures.push(`${name}: expected padding ${rule.padding}`);
+        }
+        if (rule.minWidth && !cssBlockIncludes(block, `min-width: ${rule.minWidth}`)) {
+            failures.push(`${name}: expected min-width ${rule.minWidth}`);
+        }
+        if (rule.maxWidth && !cssBlockIncludes(block, `max-width: ${rule.maxWidth}`)) {
+            failures.push(`${name}: expected max-width ${rule.maxWidth}`);
+        }
+    }
+    return failures;
+}

package/dist/gcsaSize.d.ts

@@ -0,0 +1,9 @@
+import type { GcsaButtonSize } from './index';
+/** 表单/控件密度，对齐 Ant Design：small / middle / large */
+export type GcsaComponentSize = 'sm' | 'md' | 'lg';
+export declare const GCSA_DEFAULT_COMPONENT_SIZE: GcsaComponentSize;
+export declare function resolveGcsaComponentSize(propSize: GcsaComponentSize | undefined, configSize?: GcsaComponentSize): GcsaComponentSize;
+export declare function resolveGcsaButtonSize(propSize: GcsaButtonSize | undefined, configSize?: GcsaComponentSize): GcsaButtonSize;
+/** e.g. gcsaControlSizeClass('gcsa-text-control', 'md') → 'gcsa-text-control--md' */
+export declare function gcsaControlSizeClass(prefix: string, size?: GcsaComponentSize): string;
+//# sourceMappingURL=gcsaSize.d.ts.map

package/dist/gcsaSize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcsaSize.d.ts","sourceRoot":"","sources":["../src/gcsaSize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,mDAAmD;AACnD,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEnD,eAAO,MAAM,2BAA2B,EAAE,iBAAwB,CAAC;AAEnE,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,EACvC,UAAU,GAAE,iBAA+C,GAC1D,iBAAiB,CAEnB;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,cAAc,GAAG,SAAS,EACpC,UAAU,GAAE,iBAA+C,GAC1D,cAAc,CAGhB;AAED,qFAAqF;AACrF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,iBAA+C,GACpD,MAAM,CAER"}

package/dist/gcsaSize.js

@@ -0,0 +1,13 @@
+export const GCSA_DEFAULT_COMPONENT_SIZE = 'md';
+export function resolveGcsaComponentSize(propSize, configSize = GCSA_DEFAULT_COMPONENT_SIZE) {
+    return propSize ?? configSize;
+}
+export function resolveGcsaButtonSize(propSize, configSize = GCSA_DEFAULT_COMPONENT_SIZE) {
+    if (propSize)
+        return propSize;
+    return configSize;
+}
+/** e.g. gcsaControlSizeClass('gcsa-text-control', 'md') → 'gcsa-text-control--md' */
+export function gcsaControlSizeClass(prefix, size = GCSA_DEFAULT_COMPONENT_SIZE) {
+    return `${prefix}--${size}`;
+}

package/dist/gcsaTableEvents.d.ts

@@ -0,0 +1,27 @@
+export type GcsaTableSortingEntry = {
+    id: string;
+    desc: boolean;
+};
+export type GcsaTableSortOrder = 'ascending' | 'descending' | null;
+export type GcsaTableSortChange = {
+    prop: string | null;
+    order: GcsaTableSortOrder;
+};
+/** Stable column metadata exposed by legacy-compatible row/cell events. */
+export type GcsaTableColumnInfo = {
+    id: string;
+    prop: string;
+    label: string;
+    width?: string;
+    minWidth?: string;
+    fixed?: 'left' | 'right' | true;
+};
+export type GcsaTableHeaderEvent = {
+    column: GcsaTableColumnInfo;
+    event: MouseEvent;
+};
+/** Maps the first TanStack sort entry to the payload used by Element tables. */
+export declare function getGcsaTableSortChange(sorting: GcsaTableSortingEntry[]): GcsaTableSortChange;
+/** Maps Element-style imperative sorting arguments to TanStack state. */
+export declare function getGcsaTableSorting(prop: string, order: GcsaTableSortOrder): GcsaTableSortingEntry[];
+//# sourceMappingURL=gcsaTableEvents.d.ts.map

package/dist/gcsaTableEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcsaTableEvents.d.ts","sourceRoot":"","sources":["../src/gcsaTableEvents.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAElE,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,YAAY,GAAG,IAAI,CAAC;AAEnE,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,kBAAkB,CAAC;CAC3B,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,mBAAmB,CAI5F;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,qBAAqB,EAAE,CAGpG"}

package/dist/gcsaTableEvents.js

@@ -0,0 +1,13 @@
+/** Maps the first TanStack sort entry to the payload used by Element tables. */
+export function getGcsaTableSortChange(sorting) {
+    const primary = sorting[0];
+    if (!primary)
+        return { prop: null, order: null };
+    return { prop: primary.id, order: primary.desc ? 'descending' : 'ascending' };
+}
+/** Maps Element-style imperative sorting arguments to TanStack state. */
+export function getGcsaTableSorting(prop, order) {
+    if (!prop || !order)
+        return [];
+    return [{ id: prop, desc: order === 'descending' }];
+}

package/dist/gcsaTableLayout.d.ts

@@ -0,0 +1,23 @@
+export declare const GCSA_TABLE_EXPAND_COLUMN_WIDTH = 44;
+export declare const GCSA_TABLE_SELECTION_COLUMN_WIDTH = 48;
+export declare const GCSA_TABLE_DEFAULT_COLUMN_MIN_WIDTH = 120;
+export declare const GCSA_TABLE_MIN_WIDTH_FLOOR = 640;
+export type GcsaTableLayoutColumn = {
+    id: string;
+    fixed?: 'left' | 'right' | true;
+    width?: string;
+    minWidth?: string;
+};
+export type GcsaTableFixedOffsetOptions = {
+    expandable?: boolean;
+    selectable?: boolean;
+    fixedSelection?: boolean;
+    expandColumnWidth?: number;
+    selectionColumnWidth?: number;
+    columnWidths?: Record<string, number>;
+};
+export declare function getGcsaTableMinWidth(columns: GcsaTableLayoutColumn[], options?: GcsaTableFixedOffsetOptions & {
+    defaultColumnMinWidth?: number;
+}): number;
+export declare function getGcsaTableFixedOffset(columns: GcsaTableLayoutColumn[], id: string, direction: 'left' | 'right', options?: GcsaTableFixedOffsetOptions): number;
+//# sourceMappingURL=gcsaTableLayout.d.ts.map

package/dist/gcsaTableLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcsaTableLayout.d.ts","sourceRoot":"","sources":["../src/gcsaTableLayout.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,8BAA8B,KAAK,CAAC;AACjD,eAAO,MAAM,iCAAiC,KAAK,CAAC;AACpD,eAAO,MAAM,mCAAmC,MAAM,CAAC;AACvD,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC,CAAC;AAaF,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,qBAAqB,EAAE,EAChC,OAAO,GAAE,2BAA2B,GAAG;IAAE,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7E,MAAM,CAWR;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,qBAAqB,EAAE,EAChC,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,GAAG,OAAO,EAC3B,OAAO,GAAE,2BAAgC,UAgB1C"}

package/dist/gcsaTableLayout.js

@@ -0,0 +1,36 @@
+export const GCSA_TABLE_EXPAND_COLUMN_WIDTH = 44;
+export const GCSA_TABLE_SELECTION_COLUMN_WIDTH = 48;
+export const GCSA_TABLE_DEFAULT_COLUMN_MIN_WIDTH = 120;
+export const GCSA_TABLE_MIN_WIDTH_FLOOR = 640;
+function controlWidth(value, fallback) {
+    return Number.isFinite(value) && value > 0 ? value : fallback;
+}
+function columnWidth(column, widths) {
+    const override = widths[column.id];
+    if (Number.isFinite(override) && override > 0)
+        return override;
+    const parsed = Number.parseFloat(column.width ?? column.minWidth ?? '');
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : 0;
+}
+export function getGcsaTableMinWidth(columns, options = {}) {
+    const defaultColumnMinWidth = options.defaultColumnMinWidth ?? GCSA_TABLE_DEFAULT_COLUMN_MIN_WIDTH;
+    const dataWidth = columns.reduce((sum, column) => sum + (columnWidth(column, options.columnWidths ?? {}) || defaultColumnMinWidth), 0);
+    const leadingControls = (options.expandable ? controlWidth(options.expandColumnWidth, GCSA_TABLE_EXPAND_COLUMN_WIDTH) : 0) +
+        (options.selectable ? controlWidth(options.selectionColumnWidth, GCSA_TABLE_SELECTION_COLUMN_WIDTH) : 0);
+    return Math.max(GCSA_TABLE_MIN_WIDTH_FLOOR, dataWidth + leadingControls);
+}
+export function getGcsaTableFixedOffset(columns, id, direction, options = {}) {
+    const targetIndex = columns.findIndex(column => column.id === id);
+    if (targetIndex < 0)
+        return 0;
+    const leadingControlWidth = direction === 'left' && options.selectable && options.fixedSelection
+        ? controlWidth(options.selectionColumnWidth, GCSA_TABLE_SELECTION_COLUMN_WIDTH) +
+            (options.expandable ? controlWidth(options.expandColumnWidth, GCSA_TABLE_EXPAND_COLUMN_WIDTH) : 0)
+        : 0;
+    const candidates = direction === 'left'
+        ? columns.slice(0, targetIndex)
+        : columns.slice(targetIndex + 1);
+    return candidates
+        .filter(column => (column.fixed === true ? 'left' : column.fixed) === direction)
+        .reduce((offset, column) => offset + columnWidth(column, options.columnWidths ?? {}), leadingControlWidth);
+}

package/dist/gcsaTableMigration.d.ts

@@ -0,0 +1,34 @@
+import type { GcsaTableColumn, GcsaTableColumnFixed } from './index';
+export type GcsaLegacyTableColumn<T> = Omit<Partial<GcsaTableColumn<T>>, 'sortable' | 'width' | 'minWidth' | 'id' | 'formatter' | 'columns'> & {
+    id?: string;
+    prop?: keyof T & string;
+    label?: string;
+    type?: 'selection' | 'index' | 'expand';
+    index?: number | ((index: number) => number | string);
+    selectable?: (row: T, index: number) => boolean;
+    sortable?: boolean | 'custom';
+    width?: string | number;
+    minWidth?: string | number;
+    'min-width'?: string | number;
+    showOverflowTooltip?: boolean;
+    'show-overflow-tooltip'?: boolean;
+    sortMethod?: (a: T, b: T) => number;
+    'sort-method'?: (a: T, b: T) => number;
+    formatter?: (row: T, column: GcsaLegacyTableColumn<T>, value: unknown, index: number) => unknown;
+    children?: GcsaLegacyTableColumn<T>[];
+    fixed?: GcsaTableColumnFixed;
+};
+export type GcsaTableMigration<T> = {
+    columns: GcsaTableColumn<T>[];
+    selectable: boolean | ((row: T, index: number) => boolean);
+    expandable: boolean;
+    fixedSelection: boolean;
+    selectionColumnWidth?: number;
+    expandColumnWidth?: number;
+};
+export type GcsaTableMigrationOptions = {
+    page?: number;
+    pageSize?: number;
+};
+export declare function normalizeGcsaTableColumns<T extends Record<string, unknown>>(columns: GcsaLegacyTableColumn<T>[], options?: GcsaTableMigrationOptions): GcsaTableMigration<T>;
+//# sourceMappingURL=gcsaTableMigration.d.ts.map

package/dist/gcsaTableMigration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcsaTableMigration.d.ts","sourceRoot":"","sources":["../src/gcsaTableMigration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAErE,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,IAAI,GAAG,WAAW,GAAG,SAAS,CAAC,GAAG;IAC7I,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAAC,CAAC;IACtD,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAChD,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC;IACpC,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC;IACvC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IACjG,QAAQ,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAAC;IACtC,KAAK,CAAC,EAAE,oBAAoB,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI;IAClC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9B,UAAU,EAAE,OAAO,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;IAC3D,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAAE,EACnC,OAAO,GAAE,yBAA8B,GACtC,kBAAkB,CAAC,CAAC,CAAC,CA2DvB"}