@gcsa/console-react 0.1.0

package/src/hooks/usePreventHiddenInputScroll.ts

@@ -0,0 +1,233 @@
+import { useCallback, useLayoutEffect, useRef, type RefObject } from 'react';
+
+function getDrawerPanel(root: HTMLElement): HTMLElement | null {
+  const panel = root.closest('.gcsa-drawer__panel');
+  return panel instanceof HTMLElement ? panel : null;
+}
+
+function resetDrawerPanelScroll(root: HTMLElement | null | undefined) {
+  const panel = root ? getDrawerPanel(root) : null;
+  if (panel && panel.scrollTop !== 0) {
+    panel.scrollTop = 0;
+  }
+}
+
+function collectScrollTops(start: HTMLElement | null): Map<Element, number> {
+  const saved = new Map<Element, number>();
+  let el = start;
+  while (el) {
+    const { overflowY } = getComputedStyle(el);
+    if (
+      (overflowY === 'auto' || overflowY === 'scroll' || overflowY === 'overlay')
+      && el.scrollHeight > el.clientHeight
+    ) {
+      saved.set(el, el.scrollTop);
+    }
+    el = el.parentElement;
+  }
+  return saved;
+}
+
+function restoreScrollTops(saved: Map<Element, number>, root?: HTMLElement | null) {
+  saved.forEach((top, el) => {
+    if (el instanceof HTMLElement) el.scrollTop = top;
+  });
+  resetDrawerPanelScroll(root);
+}
+
+function scheduleScrollRestore(saved: Map<Element, number>, root?: HTMLElement | null) {
+  const run = () => restoreScrollTops(saved, root);
+  run();
+  requestAnimationFrame(() => {
+    run();
+    requestAnimationFrame(run);
+  });
+  window.setTimeout(run, 0);
+}
+
+const patchedElements = new WeakSet<HTMLElement>();
+
+/** 拦截 focus() 的 scrollIntoView，用于 Drawer 内 Input / Select / Button 等。 */
+export function patchFocusPreventScroll(element: HTMLElement) {
+  if (patchedElements.has(element)) return;
+  if (!('focus' in element) || typeof element.focus !== 'function') return;
+  patchedElements.add(element);
+  const nativeFocus = element.focus.bind(element);
+  element.focus = (options?: FocusOptions) => nativeFocus({ ...options, preventScroll: true });
+}
+
+function isHiddenCheckbox(target: EventTarget | null, root: HTMLElement): target is HTMLInputElement {
+  return (
+    target instanceof HTMLInputElement
+    && target.type === 'checkbox'
+    && root.contains(target)
+  );
+}
+
+/**
+ * Ark/Zag Switch & Checkbox 使用 visually-hidden 的 native input。
+ * 点击时 focus 会把 Drawer/Modal 滚飞；在 Root 上保存/恢复 scroll，避免 scroll 监听卡死。
+ */
+function setupHiddenInputScrollLock(root: HTMLElement) {
+  let savedScroll = new Map<Element, number>();
+
+  const onPressStart = () => {
+    savedScroll = collectScrollTops(root);
+  };
+
+  const onFocusIn = (event: FocusEvent) => {
+    if (!isHiddenCheckbox(event.target, root)) return;
+    patchFocusPreventScroll(event.target);
+    scheduleScrollRestore(savedScroll, root);
+  };
+
+  root.addEventListener('pointerdown', onPressStart, true);
+  root.addEventListener('mousedown', onPressStart, true);
+  root.addEventListener('focusin', onFocusIn);
+
+  const input = root.querySelector('input[type="checkbox"]');
+  if (input instanceof HTMLInputElement) patchFocusPreventScroll(input);
+
+  return () => {
+    root.removeEventListener('pointerdown', onPressStart, true);
+    root.removeEventListener('mousedown', onPressStart, true);
+    root.removeEventListener('focusin', onFocusIn);
+  };
+}
+
+/**
+ * 在 Switch/Checkbox Root 上绑定，HiddenInput 不转发 ref。
+ */
+export function usePreventHiddenInputScroll(rootRef: RefObject<HTMLElement | null>) {
+  useLayoutEffect(() => {
+    const root = rootRef.current;
+    if (!root) return;
+    return setupHiddenInputScrollLock(root);
+  }, [rootRef]);
+}
+
+const POPUP_INTERACTION_SELECTOR =
+  '.gcsa-select-content, .gcsa-select-positioner, .gcsa-autocomplete__panel';
+
+export const GCSA_PRESERVE_SCROLL_EVENT = 'gcsa-preserve-scroll';
+
+function setupPreserveScrollOnFocus(root: HTMLElement) {
+  const panel = getDrawerPanel(root);
+  resetDrawerPanelScroll(root);
+
+  let savedScroll = collectScrollTops(root);
+  let lockedScroll: Map<Element, number> | null = null;
+  let lockUntil = 0;
+
+  const lockScroll = () => {
+    resetDrawerPanelScroll(root);
+    lockedScroll = collectScrollTops(root);
+    savedScroll = lockedScroll;
+    lockUntil = performance.now() + 480;
+  };
+
+  const saveScroll = () => {
+    if (lockedScroll && performance.now() < lockUntil) return;
+    savedScroll = collectScrollTops(root);
+  };
+
+  const restoreScroll = () => {
+    scheduleScrollRestore(lockedScroll ?? savedScroll, root);
+  };
+
+  const enforceLockedScroll = () => {
+    resetDrawerPanelScroll(root);
+    if (!lockedScroll || performance.now() >= lockUntil) return;
+    const lockedTop = lockedScroll.get(root);
+    if (lockedTop == null) return;
+    if (Math.abs(root.scrollTop - lockedTop) > 1) {
+      root.scrollTop = lockedTop;
+    }
+  };
+
+  const onPanelScroll = () => {
+    resetDrawerPanelScroll(root);
+  };
+
+  const patchFocusables = () => {
+    root.querySelectorAll('input, textarea, select, button').forEach(el => {
+      if (el instanceof HTMLElement) patchFocusPreventScroll(el);
+    });
+  };
+
+  const onScroll = () => {
+    if (lockedScroll && performance.now() < lockUntil) {
+      enforceLockedScroll();
+      return;
+    }
+    saveScroll();
+  };
+
+  const onPressStart = () => lockScroll();
+
+  const onFocusIn = (event: FocusEvent) => {
+    if (!(event.target instanceof Node) || !root.contains(event.target)) return;
+    restoreScroll();
+  };
+
+  const onDocPointerDown = (event: PointerEvent) => {
+    const target = event.target;
+    if (!(target instanceof Node)) return;
+    if (root.contains(target)) {
+      lockScroll();
+      return;
+    }
+    if (target instanceof Element && target.closest(POPUP_INTERACTION_SELECTOR)) {
+      lockScroll();
+    }
+  };
+
+  patchFocusables();
+  const observer = new MutationObserver(() => patchFocusables());
+
+  const onPreserveEvent = () => restoreScroll();
+
+  root.addEventListener('scroll', onScroll, { passive: true });
+  root.addEventListener('pointerdown', onPressStart, true);
+  root.addEventListener('mousedown', onPressStart, true);
+  root.addEventListener('focusin', onFocusIn);
+  root.addEventListener(GCSA_PRESERVE_SCROLL_EVENT, onPreserveEvent);
+  panel?.addEventListener('scroll', onPanelScroll, { passive: true });
+  document.addEventListener('pointerdown', onDocPointerDown, true);
+  observer.observe(root, { childList: true, subtree: true });
+
+  return () => {
+    root.removeEventListener('scroll', onScroll);
+    root.removeEventListener('pointerdown', onPressStart, true);
+    root.removeEventListener('mousedown', onPressStart, true);
+    root.removeEventListener('focusin', onFocusIn);
+    root.removeEventListener(GCSA_PRESERVE_SCROLL_EVENT, onPreserveEvent);
+    panel?.removeEventListener('scroll', onPanelScroll);
+    document.removeEventListener('pointerdown', onDocPointerDown, true);
+    observer.disconnect();
+  };
+}
+
+/**
+ * Drawer/Modal 内容区：pointer / focus 后恢复滚动，避免 Select 打开或 Input 聚焦把 body 滚飞。
+ * 返回 callback ref；须与 Drawer open 同步（lazyMount 下 DOM 晚于 effect 挂载）。
+ */
+export function usePreserveScrollOnFocus(active = true) {
+  const cleanupRef = useRef<(() => void) | undefined>(undefined);
+
+  useLayoutEffect(() => () => {
+    cleanupRef.current?.();
+    cleanupRef.current = undefined;
+  }, []);
+
+  return useCallback(
+    (node: HTMLElement | null) => {
+      cleanupRef.current?.();
+      cleanupRef.current = undefined;
+      if (active && node) {
+        cleanupRef.current = setupPreserveScrollOnFocus(node);
+      }
+    },
+    [active],
+  );
+}

package/src/icons/iconNames.ts

@@ -0,0 +1,27 @@
+/** 导航侧栏图标 — 与 @gcsa/console-core GcsaNavItem.iconKey 对齐 */
+export const GCSA_NAV_ICON_NAMES = [
+  'dashboard',
+  'alert',
+  'assets',
+  'settings',
+  'users',
+  'chat'
+] as const;
+
+/** 组件内部 UI 图标（文件名 kebab-case → 注册为 camelCase key） */
+export const GCSA_UI_ICON_NAMES = [
+  'chevronDown',
+  'chevronUp',
+  'chevronLeft',
+  'chevronRight',
+  'check',
+  'close',
+  'menu',
+  'plus',
+  'resultEmpty'
+] as const;
+
+export const GCSA_ICON_NAMES = [...GCSA_NAV_ICON_NAMES, ...GCSA_UI_ICON_NAMES] as const;
+
+export type GcsaNavIconName = (typeof GCSA_NAV_ICON_NAMES)[number];
+export type GcsaIconName = (typeof GCSA_ICON_NAMES)[number];

package/src/icons/index.ts

@@ -0,0 +1,8 @@
+export {
+  GCSA_ICON_NAMES,
+  GCSA_NAV_ICON_NAMES,
+  GCSA_UI_ICON_NAMES,
+  type GcsaIconName,
+  type GcsaNavIconName
+} from './iconNames';
+export { GcsaIcons, getGcsaIconSvg } from './registry';

package/src/icons/registry.ts

@@ -0,0 +1,38 @@
+import { GCSA_ICON_NAMES, type GcsaIconName } from './iconNames';
+import chevronLeftSvg from './svg/chevron-left.svg?raw';
+import menuSvg from './svg/menu.svg?raw';
+
+const svgModules = import.meta.glob('./svg/*.svg', {
+  query: '?raw',
+  import: 'default',
+  eager: true
+}) as Record<string, string>;
+
+function fileStem(path: string): string {
+  const file = path.slice(path.lastIndexOf('/') + 1);
+  return file.replace(/\.svg$/, '');
+}
+
+function toIconKey(stem: string): string {
+  return stem.replace(/-([a-z])/g, (_, letter: string) => letter.toUpperCase());
+}
+
+const registry = {
+  ...Object.fromEntries(
+    Object.entries(svgModules).map(([path, svg]) => [toIconKey(fileStem(path)), svg])
+  ),
+  menu: menuSvg,
+  chevronLeft: chevronLeftSvg
+} as Record<GcsaIconName, string>;
+
+for (const name of GCSA_ICON_NAMES) {
+  if (!registry[name]) {
+    throw new Error(`[gcsa-icons] missing svg file for icon "${name}"`);
+  }
+}
+
+export const GcsaIcons = registry;
+
+export function getGcsaIconSvg(name: GcsaIconName): string {
+  return GcsaIcons[name];
+}

package/src/icons/svg/alert.svg

@@ -0,0 +1,4 @@
+<svg viewBox="0 0 17.1429 17.1429" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
+  <path d="M8.57108 2.06954C8.8166 2.06954 9.05831 2.13268 9.27225 2.25313C9.48607 2.37358 9.66548 2.54721 9.79276 2.75704L15.8426 12.8566C15.9673 13.0727 16.0333 13.3181 16.034 13.5676C16.0346 13.8169 15.9699 14.0619 15.8465 14.2785C15.7229 14.4952 15.5449 14.6764 15.3299 14.8029C15.1149 14.9294 14.8703 14.9975 14.6209 15.0002H2.52127C2.27191 14.9975 2.02724 14.9294 1.81229 14.8029C1.5973 14.6764 1.41921 14.4952 1.29569 14.2785C1.17227 14.0619 1.10753 13.8169 1.10819 13.5676C1.10888 13.3181 1.17486 13.0727 1.29959 12.8566L7.3494 2.75704C7.47668 2.54721 7.65608 2.37358 7.86991 2.25313C8.08385 2.13268 8.32555 2.06954 8.57108 2.06954ZM7.75076 11.094V12.5227H9.17948V11.094H7.75076ZM7.75076 6.09395V9.66524H9.17948V6.09395H7.75076Z" fill="currentColor" />
+  <path d="M8.57129 12.1428H8.57772" stroke="currentColor" stroke-width="1.42857" />
+</svg>

package/src/icons/svg/assets.svg

@@ -0,0 +1,4 @@
+<svg viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
+  <path d="M5 6.42853L13.1357 3.31417C13.1812 3.30135 13.2289 3.29788 13.2757 3.30397C13.3226 3.31007 13.3678 3.3256 13.4085 3.34963C13.4492 3.37366 13.4847 3.40569 13.5127 3.44379C13.5407 3.4819 13.5607 3.52527 13.5714 3.57131L14.6429 6.07139" stroke="currentColor" stroke-width="1.42857" stroke-linecap="square" stroke-linejoin="round" />
+  <path d="M15.3102 5.71431C15.6065 5.71443 15.8907 5.83136 16.1003 6.03951C16.3099 6.24788 16.4274 6.53096 16.4274 6.82564V8.57174H12.1423C11.7481 8.57198 11.4286 8.89148 11.4284 9.2856V12.143C11.4285 12.4881 11.6733 12.7766 11.9987 12.8432L12.1423 12.8579H16.4274V14.603C16.4274 14.8977 16.3099 15.1807 16.1003 15.3891C15.8907 15.5973 15.6065 15.7142 15.3102 15.7143H4.68913C4.39265 15.7143 4.10777 15.5974 3.89811 15.3891C3.68844 15.1807 3.57096 14.8977 3.57096 14.603V6.82564C3.57096 6.53096 3.68844 6.24788 3.89811 6.03951C4.10776 5.83124 4.39269 5.71431 4.68913 5.71431H15.3102ZM16.4274 11.4292H12.8571V10.0004H16.4274V11.4292Z" fill="currentColor" />
+</svg>

package/src/icons/svg/chat.svg

@@ -0,0 +1,3 @@
+<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true">
+  <path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z" />
+</svg>

package/src/icons/svg/check.svg

@@ -0,0 +1,3 @@
+<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+  <path d="M20 6 9 17l-5-5" />
+</svg>

package/src/icons/svg/chevron-down.svg

@@ -0,0 +1,3 @@
+<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+  <path d="m6 9 6 6 6-6" />
+</svg>

package/src/icons/svg/chevron-left.svg

@@ -0,0 +1,3 @@
+<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+  <path d="m15 18-6-6 6-6" />
+</svg>

package/src/icons/svg/chevron-right.svg

@@ -0,0 +1,3 @@
+<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+  <path d="m9 18 6-6-6-6" />
+</svg>

package/src/icons/svg/chevron-up.svg

@@ -0,0 +1,3 @@
+<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+  <path d="m18 15-6-6-6 6" />
+</svg>

package/src/icons/svg/close.svg

@@ -0,0 +1 @@
+<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><path d="M6 6l12 12M18 6L6 18" /></svg>

package/src/icons/svg/dashboard.svg

@@ -0,0 +1,3 @@
+<svg viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
+  <path d="M9.99984 2.85712C13.9448 2.85712 17.1427 6.05498 17.1427 9.99998C17.1427 13.945 13.9448 17.1428 9.99984 17.1428C6.05484 17.1428 2.85699 13.945 2.85699 9.99998C2.85699 6.05498 6.05484 2.85712 9.99984 2.85712ZM9.99984 4.99998C9.02451 4.9999 8.07045 5.28508 7.25516 5.8204C6.43986 6.35571 5.79893 7.11779 5.4113 8.01278C5.02367 8.90778 4.90625 9.8966 5.07352 10.8575C5.24079 11.8184 5.68544 12.7093 6.3527 13.4207L6.46413 13.535L7.47413 12.525C6.91785 11.9691 6.5606 11.2452 6.45781 10.4655C6.35502 9.68585 6.51243 8.89406 6.90563 8.213C7.29883 7.53195 7.90582 6.99971 8.63242 6.69889C9.35902 6.39806 10.1646 6.34547 10.9241 6.54927L12.0413 5.43498C11.3991 5.14749 10.7034 4.99923 9.99984 4.99998ZM14.5656 7.95927L13.4506 9.07498C13.6122 9.68067 13.6118 10.3182 13.4495 10.9237C13.2871 11.5292 12.9685 12.0814 12.5256 12.525L13.5356 13.5357C14.0005 13.0719 14.3693 12.5207 14.6206 11.914C14.8719 11.3072 15.0008 10.6567 14.9998 9.99998C15.0007 9.29671 14.8527 8.60123 14.5656 7.95927ZM13.0298 5.95927L10.3691 8.61998C10.1575 8.5638 9.93584 8.55693 9.72116 8.5999C9.50647 8.64288 9.30452 8.73455 9.13084 8.86786C8.95716 9.00117 8.8164 9.17256 8.71939 9.36884C8.62237 9.56512 8.5717 9.78104 8.57127 9.99998C8.57126 10.2033 8.61466 10.4043 8.69857 10.5895C8.78247 10.7747 8.90495 10.9399 9.05781 11.074C9.21067 11.2081 9.3904 11.308 9.58497 11.367C9.77954 11.4261 9.98448 11.4429 10.1861 11.4164C10.3877 11.3899 10.5813 11.3207 10.754 11.2133C10.9267 11.106 11.0745 10.963 11.1875 10.794C11.3005 10.6249 11.3761 10.4337 11.4093 10.2331C11.4424 10.0325 11.4324 9.82712 11.3798 9.63069L14.0406 6.96927L13.0306 5.95927H13.0298Z" fill="currentColor" />
+</svg>

package/src/icons/svg/menu.svg

@@ -0,0 +1,3 @@
+<svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
+  <path d="M2.66667 4H13.3333M2.66667 8H13.3333M2.66667 12H13.3333" stroke="currentColor" stroke-width="1.33333" stroke-linecap="round" />
+</svg>

package/src/icons/svg/plus.svg

@@ -0,0 +1 @@
+<svg viewBox="0 0 23 23" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true"><path d="M0 11.5C0 10.6716 0.671573 10 1.5 10H21.5C22.3284 10 23 10.6716 23 11.5C23 12.3284 22.3284 13 21.5 13H1.5C0.671573 13 0 12.3284 0 11.5Z" fill="currentColor"/><path d="M11.5 0C12.3284 0 13 0.671574 13 1.5V21.5C13 22.3284 12.3284 23 11.5 23C10.6716 23 10 22.3284 10 21.5V1.5C10 0.671573 10.6716 0 11.5 0Z" fill="currentColor"/></svg>

package/src/icons/svg/result-empty.svg

@@ -0,0 +1 @@
+<svg viewBox="0 0 29 36" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true"><path opacity="0.3" d="M2 0C0.895432 0 0 0.895431 0 2V34C0 35.1046 0.895431 36 2 36H27C28.1046 36 29 35.1046 29 34V11H17.9511V0H2Z" fill="currentColor"/><path d="M14.1667 23.5V21.8333H15C16.4167 21.8333 17.5 20.75 17.5 19.3333V18.5C17.5 17.0833 16.4167 16 15 16C13.5833 16 12.5 17.0833 12.5 18.5V19.3333H10.8333V18.5C10.8333 16.1667 12.6667 14.3333 15 14.3333C17.3333 14.3333 19.1667 16.1667 19.1667 18.5V19.3333C19.1667 21.3333 17.75 23 15.8333 23.4167V25.1667H14.1667V23.5ZM14.1667 26H15.8333V27.6667H14.1667V26Z" fill="currentColor"/><path opacity="0.3" d="M20.0234 0V9H29L20.0234 0Z" fill="currentColor"/></svg>

package/src/icons/svg/settings.svg

@@ -0,0 +1,3 @@
+<svg viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
+  <path d="M9.63281 2.71987C9.8588 2.5845 10.1412 2.5845 10.3672 2.71987L15.9033 6.04214C16.1184 6.17124 16.25 6.40361 16.25 6.65444V13.3449C16.25 13.5958 16.1185 13.8291 15.9033 13.9582L10.3672 17.2794C10.1411 17.4149 9.85887 17.4149 9.63281 17.2794L4.09668 13.9582C3.88154 13.8291 3.75 13.5958 3.75 13.3449V6.65444C3.75 6.40361 3.88163 6.17124 4.09668 6.04214L9.63281 2.71987ZM10 7.50015C8.61929 7.50015 7.5 8.61943 7.5 10.0001C7.5001 11.3808 8.61935 12.5001 10 12.5001C11.3807 12.5001 12.4999 11.3808 12.5 10.0001C12.5 8.61943 11.3807 7.50015 10 7.50015Z" fill="currentColor" />
+</svg>

package/src/icons/svg/users.svg

@@ -0,0 +1,6 @@
+<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true">
+  <path d="M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2" />
+  <circle cx="9" cy="7" r="4" />
+  <path d="M22 21v-2a4 4 0 0 0-3-3.87" />
+  <path d="M16 3.13a4 4 0 0 1 0 7.75" />
+</svg>

package/src/index.ts

@@ -0,0 +1,166 @@
+export { GcsaConfigProvider } from './GcsaConfigProvider';
+export { ConsoleShell } from './ConsoleShell';
+export { ConsoleSidebar } from './ConsoleSidebar';
+export { ConsoleHeader } from './ConsoleHeader';
+export { ConsolePage } from './ConsolePage';
+export { GcsaBrandMark } from './GcsaBrandMark';
+
+export { GcsaButton } from './GcsaButton';
+export { GcsaBadge } from './GcsaBadge';
+export { GcsaCard } from './GcsaCard';
+export { GcsaField } from './GcsaField';
+export { GcsaInput } from './GcsaInput';
+export { GcsaInputGroup } from './GcsaInputGroup';
+export { GcsaTextarea } from './GcsaTextarea';
+export { GcsaSelect } from './GcsaSelect';
+export { GcsaMultiSelect } from './GcsaMultiSelect';
+export { GcsaAutoComplete } from './GcsaAutoComplete';
+export { GcsaCheckbox } from './GcsaCheckbox';
+export { GcsaRadioGroup } from './GcsaRadioGroup';
+export { GcsaSwitch } from './GcsaSwitch';
+export { GcsaInputNumber } from './GcsaInputNumber';
+export { GcsaDatePicker } from './GcsaDatePicker';
+export { GcsaCalendar } from './GcsaCalendar';
+export { GcsaDateRangePicker } from './GcsaDateRangePicker';
+export { GcsaDateTimePicker } from './GcsaDateTimePicker';
+export { GcsaTimePicker } from './GcsaTimePicker';
+export { GcsaUpload } from './GcsaUpload';
+export { GcsaCollapse } from './GcsaCollapse';
+export { GcsaTree } from './GcsaTree';
+export { GcsaCascader } from './GcsaCascader';
+export { GcsaTransfer } from './GcsaTransfer';
+export { GcsaImagePreview } from './GcsaImagePreview';
+export { GcsaSteps } from './GcsaSteps';
+export { GcsaTimeline } from './GcsaTimeline';
+export type { GcsaCollapseProps } from './GcsaCollapse';
+export type { GcsaCollapseItem } from './GcsaCollapse';
+export type { GcsaTreeProps, GcsaTreeNode } from './GcsaTree';
+export type { GcsaCascaderProps } from './GcsaCascader';
+export type { GcsaTransferProps } from './GcsaTransfer';
+export type { GcsaImagePreviewProps } from './GcsaImagePreview';
+export type { GcsaStepsProps } from './GcsaSteps';
+export type { GcsaTimelineProps } from './GcsaTimeline';
+
+export { GcsaDataTable } from './GcsaDataTable';
+export { GcsaForm } from './GcsaForm';
+export { GcsaFormField } from './GcsaFormField';
+export { GcsaPagination } from './GcsaPagination';
+
+export { GcsaAlert } from './GcsaAlert';
+export { GcsaSpin } from './GcsaSpin';
+export { GcsaLoadingMask } from './GcsaLoadingMask';
+export { GcsaLoading } from './GcsaLoading';
+export type { GcsaLoadingInstance, GcsaLoadingOptions } from './GcsaLoading';
+export type { GcsaLoadingMaskProps } from './GcsaLoadingMask';
+export { GcsaSkeleton } from './GcsaSkeleton';
+export { GcsaModal } from './GcsaModal';
+export { GcsaDrawer } from './GcsaDrawer';
+export { GcsaProgress } from './GcsaProgress';
+export { GcsaResult } from './GcsaResult';
+
+export { GcsaTabs } from './GcsaTabs';
+export { GcsaBreadcrumb } from './GcsaBreadcrumb';
+export { GcsaTag } from './GcsaTag';
+export { GcsaStatistic } from './GcsaStatistic';
+export { GcsaDescriptions } from './GcsaDescriptions';
+export { GcsaAvatar } from './GcsaAvatar';
+export { GcsaEmpty } from './GcsaEmpty';
+export { GcsaChatPanel } from './GcsaChatPanel';
+export { GcsaMarkdownRenderer } from './GcsaMarkdownRenderer';
+
+export { GcsaDivider } from './GcsaDivider';
+export { GcsaSpace } from './GcsaSpace';
+export { GcsaTypography } from './GcsaTypography';
+export { GcsaRow } from './GcsaRow';
+export { GcsaIcon } from './GcsaIcon';
+export { GcsaTooltip } from './GcsaTooltip';
+export { GcsaPopover } from './GcsaPopover';
+export { GcsaPopoverClose } from './GcsaPopoverClose';
+export { GcsaDropdown } from './GcsaDropdown';
+export { GcsaMenu } from './GcsaMenu';
+export { GcsaPopconfirm } from './GcsaPopconfirm';
+
+export { useGcsaMessage, useGcsaTheme } from './hooks/useGcsaTheme';
+export { useGcsaComponentSize, useGcsaComponentSizeConfig, useGcsaButtonSize } from './hooks/useGcsaComponentSize';
+export { useGcsaLocale, useGcsaLocaleMessages } from './hooks/useGcsaLocale';
+export { useGcsaZIndex } from './hooks/useGcsaZIndex';
+export { GCSA_RESTORE_DOCUMENT_THEME_KEY } from './hooks/useDocumentThemeSync';
+export {
+  gcsaBooleanFieldBindings,
+  gcsaFieldError,
+  gcsaFieldInvalid,
+  gcsaNumberFieldBindings,
+  gcsaRadioFieldBindings,
+  gcsaTextFieldBindings
+} from './hooks/useGcsaFormField';
+export type { GcsaFormApi, GcsaFormValues } from './hooks/gcsaFormTypes';
+export type { GcsaAnyFieldApi } from './hooks/useGcsaFormField';
+export type { GcsaDropdownItem, GcsaDropdownPlacement, GcsaDropdownProps } from './GcsaDropdown';
+export type { GcsaMenuProps, GcsaMenuItem, GcsaMenuMode } from './GcsaMenu';
+export type { GcsaTooltipPlacement } from './GcsaTooltip';
+export type { GcsaPopoverPlacement } from './GcsaPopover';
+export type { GcsaPopconfirmPlacement } from './GcsaPopconfirm';
+export type { GcsaIconName, GcsaNavIconName } from './icons';
+export { GCSA_ICON_NAMES, GCSA_NAV_ICON_NAMES, GCSA_UI_ICON_NAMES } from './icons';
+export type { GcsaTableCellSlotProps, GcsaTableHeaderSlotProps } from './utils/gcsaTableColumns';
+export { gcsaTableColumnsToDefs, resolveGcsaTableColumns } from './utils/gcsaTableColumns';
+
+export { gcsaLoginSchema, gcsaNotifySchema } from '@gcsa/console-core';
+export type * from '@gcsa/console-core';
+
+export type { GcsaBrandMarkProps } from './GcsaBrandMark';
+export type { ConsoleSidebarProps } from './ConsoleSidebar';
+export type { ConsoleHeaderProps } from './ConsoleHeader';
+export type { ConsolePageProps } from './ConsolePage';
+export type { GcsaButtonProps } from './GcsaButton';
+export type { GcsaDataTableApi, GcsaDataTableProps } from './GcsaDataTable';
+export type { GcsaChatPanelProps } from './GcsaChatPanel';
+export type { GcsaMarkdownRendererProps } from './GcsaMarkdownRenderer';
+export type { GcsaConfigProviderProps } from './GcsaConfigProvider';
+export type { GcsaBadgeProps } from './GcsaBadge';
+export type { GcsaCardProps } from './GcsaCard';
+export type { GcsaTagProps } from './GcsaTag';
+export type { GcsaDividerProps } from './GcsaDivider';
+export type { GcsaSpaceProps } from './GcsaSpace';
+export type { GcsaTypographyProps } from './GcsaTypography';
+export type { GcsaRowProps } from './GcsaRow';
+export type { GcsaAlertProps } from './GcsaAlert';
+export type { GcsaEmptyProps } from './GcsaEmpty';
+export type { GcsaSpinProps } from './GcsaSpin';
+export type { GcsaSkeletonProps } from './GcsaSkeleton';
+export type { GcsaAvatarProps } from './GcsaAvatar';
+export type { GcsaStatisticProps } from './GcsaStatistic';
+export type { GcsaProgressProps } from './GcsaProgress';
+export type { GcsaResultProps } from './GcsaResult';
+export type { GcsaTooltipProps } from './GcsaTooltip';
+export type { GcsaPopoverProps, GcsaPopoverSize } from './GcsaPopover';
+export type { GcsaPopconfirmProps } from './GcsaPopconfirm';
+export type { GcsaModalProps } from './GcsaModal';
+export type { GcsaDrawerProps, GcsaDrawerSize } from './GcsaDrawer';
+export type { GcsaSelectProps, GcsaSelectPlacement } from './GcsaSelect';
+export type { GcsaMultiSelectProps, GcsaMultiSelectPlacement } from './GcsaMultiSelect';
+export type { GcsaAutoCompleteProps, GcsaAutoCompleteOption } from './GcsaAutoComplete';
+export type { GcsaCheckboxProps } from './GcsaCheckbox';
+export type { GcsaRadioGroupProps } from './GcsaRadioGroup';
+export type { GcsaSwitchProps } from './GcsaSwitch';
+export type { GcsaInputNumberProps } from './GcsaInputNumber';
+export type { GcsaDatePickerProps } from './GcsaDatePicker';
+export type { GcsaCalendarProps } from './GcsaCalendar';
+export type { GcsaDateRangePickerProps } from './GcsaDateRangePicker';
+export type { GcsaDateTimePickerProps } from './GcsaDateTimePicker';
+export type { GcsaUploadProps } from './GcsaUpload';
+export type { GcsaInputProps } from './GcsaInput';
+export type { GcsaInputGroupProps } from './GcsaInputGroup';
+export type { GcsaTextareaProps } from './GcsaTextarea';
+export type { GcsaFieldProps } from './GcsaField';
+export type { GcsaTabsProps, GcsaTabItem } from './GcsaTabs';
+export type { GcsaPaginationProps } from './GcsaPagination';
+export type { GcsaBreadcrumbProps, GcsaBreadcrumbItem } from './GcsaBreadcrumb';
+export type { GcsaDescriptionsProps, GcsaDescriptionsItem } from './GcsaDescriptions';
+export type { GcsaIconProps } from './GcsaIcon';
+export type { GcsaFormProps } from './GcsaForm';
+export type { GcsaFormFieldProps } from './GcsaFormField';
+export type { GcsaTimePickerProps } from './GcsaTimePicker';
+export type { GcsaPopoverCloseProps } from './GcsaPopoverClose';
+export type { GcsaToastItem, GcsaToastStackProps } from './GcsaToastStack';
+export type { ConsoleShellProps } from './ConsoleShell';

package/src/utils/gcsaDateValue.ts

@@ -0,0 +1,99 @@
+import {
+  formatGcsaDateParts,
+  formatGcsaMonthParts,
+  type GcsaDatePickerMode,
+  type GcsaDateRangeValue,
+  type GcsaMonthRangeValue
+} from '@gcsa/console-core';
+import type { GcsaSelectOption } from '@gcsa/console-core';
+import { parseDate, type DateValue } from '@ark-ui/react/date-picker';
+
+export type GcsaDatePickerSelectCell = {
+  label: string;
+  value: number;
+  disabled?: boolean;
+};
+
+export function gcsaDatePickerCellsToOptions(cells: GcsaDatePickerSelectCell[]): GcsaSelectOption[] {
+  return cells.map(cell => ({
+    label: cell.label,
+    value: String(cell.value),
+    disabled: cell.disabled
+  }));
+}
+
+export function gcsaNormalizeDateBoundary(value: string | undefined, mode: GcsaDatePickerMode): string | undefined {
+  if (!value) return undefined;
+  if (mode === 'month' && /^\d{4}-\d{2}$/.test(value)) return `${value}-01`;
+  return value;
+}
+
+export function gcsaDateValueToOutputString(
+  value: DateValue | undefined | null,
+  mode: GcsaDatePickerMode
+): string {
+  if (!value || !('month' in value)) return '';
+  if (mode === 'month') return formatGcsaMonthParts(value.year, value.month);
+  if ('day' in value) return formatGcsaDateParts(value.year, value.month, value.day);
+  return '';
+}
+
+export function gcsaDateValueToString(value: DateValue | undefined | null): string {
+  return gcsaDateValueToOutputString(value, 'date');
+}
+
+export function gcsaStringToDateValues(
+  value: string | undefined | null,
+  mode: GcsaDatePickerMode = 'date'
+): DateValue[] | undefined {
+  if (!value) return undefined;
+  const normalized = gcsaNormalizeDateBoundary(value, mode);
+  if (!normalized) return undefined;
+  try {
+    return [parseDate(normalized)];
+  } catch {
+    return undefined;
+  }
+}
+
+export function gcsaDateRangeToDateValues(
+  range: GcsaDateRangeValue | GcsaMonthRangeValue | undefined | null,
+  mode: GcsaDatePickerMode = 'date'
+): DateValue[] | undefined {
+  if (!range) return undefined;
+  const values: DateValue[] = [];
+  for (const part of range) {
+    if (!part) continue;
+    const parsed = gcsaStringToDateValues(part, mode);
+    if (parsed?.[0]) values.push(parsed[0]);
+  }
+  return values.length ? values : undefined;
+}
+
+export function gcsaDateValuesToRange(
+  values: DateValue[] | undefined | null,
+  mode: GcsaDatePickerMode = 'date'
+): GcsaDateRangeValue | GcsaMonthRangeValue {
+  return [gcsaDateValueToOutputString(values?.[0], mode), gcsaDateValueToOutputString(values?.[1], mode)];
+}
+
+export function gcsaDatePickerFormat(
+  date: DateValue,
+  _details: { locale: string; timeZone: string },
+  mode: GcsaDatePickerMode
+): string {
+  return gcsaDateValueToOutputString(date, mode);
+}
+
+export function gcsaDatePickerParse(
+  value: string,
+  _details: { locale: string; timeZone: string },
+  mode: GcsaDatePickerMode
+): DateValue | undefined {
+  const parsed = gcsaStringToDateValues(value, mode);
+  return parsed?.[0];
+}
+
+/** ISO 日期时间字符串 YYYY-MM-DD HH:mm:ss */
+export type { GcsaDateTimeString } from '@gcsa/console-core';
+export { gcsaJoinDateTime, gcsaSplitDateTime } from '@gcsa/console-core';