@simplysm/angular 14.0.8 → 14.0.10

package/src/index.ts

@@ -57,6 +57,8 @@ export { useFullPageCodeSignal } from "./core/utils/useFullPageCodeSignal";
 export { useViewTitleSignal } from "./core/utils/useViewTitleSignal";
 export { useViewTypeSignal, type TSdViewType } from "./core/utils/useViewTypeSignal";
 export { setupCanDeactivate } from "./core/utils/setups/setupCanDeactivate";
+export { setupCumulateSelectedKeys } from "./core/utils/setups/setupCumulateSelectedKeys";
+export { setupCloserWhenSingleSelectionChange } from "./core/utils/setups/setupCloserWhenSingleSelectionChange";
 export {
   useExpandingManager,
   type IExpandItemDef,
@@ -64,8 +66,36 @@ export {
 export { useSelectionManager } from "./core/utils/useSelectionManager";
 export { injectParent } from "./core/utils/injectParent";
 
+// features/address
+export {
+  SdAddressSearchModal,
+  type IAddress,
+} from "./features/address/sd-address-search.modal";
+
 // features
 export { SdBaseContainerControl } from "./features/base/sd-base-container.control";
+export {
+  SdDataSheetControl,
+  AbsSdDataSheet,
+  type ISdDataSheetItemPropInfo,
+  type ISdDataSheetItemInfo,
+  type ISdDataSheetSearchResult,
+} from "./features/data-view/sd-data-sheet.control";
+export { SdDataSheetColumnDirective } from "./features/data-view/sd-data-sheet-column.directive";
+export {
+  SdDataDetailControl,
+  AbsSdDataDetail,
+  type ISdDataDetailDataInfo,
+} from "./features/data-view/sd-data-detail.control";
+export {
+  SdDataSelectButtonControl,
+  AbsSdDataSelectButton,
+} from "./features/data-view/sd-data-select-button.control";
+
+// features/shared-data
+export { SdSharedDataSelectControl } from "./features/shared-data/sd-shared-data-select.control";
+export { SdSharedDataSelectButtonControl } from "./features/shared-data/sd-shared-data-select-button.control";
+export { SdSharedDataSelectListControl } from "./features/shared-data/sd-shared-data-select-list.control";
 
 // ui/layout
 export { SdDockContainerControl } from "./ui/layout/dock/sd-dock-container.control";
@@ -229,4 +259,8 @@ export {
 
 // core/utils
 export { useSortingManager, type ISortingDef } from "./core/utils/useSortingManager";
-export type { TDirectiveInputSignals, TUndefToOptional } from "./core/utils/TDirectiveInputSignals";
+export type {
+  TDirectiveInputSignals,
+  TUndefToOptional,
+  TWithOptional,
+} from "./core/utils/TDirectiveInputSignals";

package/src/scss.d.ts

@@ -1 +1,6 @@
 declare module "*.scss" {}
+
+declare module "*.scss?inline" {
+  const content: string;
+  export default content;
+}

package/src/ui/data/list/sd-list-item.control.ts

@@ -24,7 +24,7 @@ import { setupRipple } from "../../../core/utils/setups/setupRipple";
   standalone: true,
   imports: [SdCollapseControl, SdCollapseIconControl, NgTemplateOutlet, NgIcon],
   template: `
-    <div class="_content" tabindex="0" (click)="onContentClick()" (keydown.enter)="onContentClick()">
+    <div class="_content" [style]="contentStyle()" [class]="contentClass()" tabindex="0" (click)="onContentClick()" (keydown.enter)="onContentClick()">
       @if (layout() === "accordion" && hasChildren()) {
         <sd-collapse-icon [open]="open()" />
       }
@@ -119,6 +119,8 @@ export class SdListItemControl {
   selected = input(false, { transform: booleanAttribute });
   selectedIcon = input<string>();
   readonly = input(false, { transform: booleanAttribute });
+  contentStyle = input<string>();
+  contentClass = input<string>();
 
   toolTpl = contentChild<TemplateRef<void>>("toolTpl");
 

package/src/ui/data/sheet/sd-sheet-column.directive.ts

@@ -6,6 +6,14 @@ import {
   TemplateRef,
 } from "@angular/core";
 
+export interface SdSheetCellContext {
+  $implicit: unknown;
+  item: unknown;
+  index: number;
+  depth: number;
+  edit: boolean;
+}
+
 @Directive({
   selector: "sd-sheet-column",
   standalone: true,
@@ -21,6 +29,6 @@ export class SdSheetColumnDirective {
   disableResizing = input(false, { transform: booleanAttribute });
   ordering = input(0);
 
-  cellTplRef = contentChild<TemplateRef<void>>("cellTpl");
+  cellTplRef = contentChild<TemplateRef<SdSheetCellContext>>("cellTpl");
   summaryTplRef = contentChild<TemplateRef<void>>("summaryTpl");
 }

package/src/ui/data/sheet/sd-sheet.control.ts

@@ -135,7 +135,7 @@ import { SdSheetConfigModal } from "./sd-sheet-config.modal";
             >
               @if (expanding.hasExpandable()) {
                 <td class="_expand-col">
-                  @if (getItemDef(item)?.hasChildren) {
+                  @if (getItemDef(item).hasChildren) {
                     <sd-anchor (click)="onExpandClick($event, item)">
                       <ng-icon [svg]="isExpanded(item) ? icons.tablerChevronDown : icons.tablerChevronRight" />
                     </sd-anchor>
@@ -351,7 +351,7 @@ export class SdSheetControl<T> {
   inset = input(false, { transform: booleanAttribute });
   contentStyle = input<string>();
   getItemCellClassFn = input<(item: T, colKey: string) => string>();
-  getItemCellStyleFn = input<(item: T, colKey: string) => string>();
+  getItemCellStyleFn = input<(item: T, colKey: string) => string | undefined>();
   hideConfigBar = input(false, { transform: booleanAttribute });
 
   // Outputs
@@ -660,16 +660,16 @@ export class SdSheetControl<T> {
     return parts.length > 0 ? parts.join(" ") : null;
   }
 
-  async onKeydownCapture(event: KeyboardEvent): Promise<void> {
-    await this.cellAgent.handleKeydownCapture(event);
+  async onKeydownCapture(event: Event): Promise<void> {
+    await this.cellAgent.handleKeydownCapture(event as KeyboardEvent);
   }
 
   onDblClick(event: MouseEvent): void {
     this.cellAgent.handleCellDoubleClick(event);
   }
 
-  onBlurCapture(event: FocusEvent): void {
-    this.cellAgent.handleBlurCapture(event);
+  onBlurCapture(event: Event): void {
+    this.cellAgent.handleBlurCapture(event as FocusEvent);
   }
 
   onItemKeydown(event: KeyboardEvent, item: T): void {

package/src/ui/form/button/sd-modal-select-button.control.ts

@@ -15,7 +15,6 @@ import {
   type ISdModalInfo,
   type ISdModalOptions,
 } from "../../overlay/modal/sd-modal.provider";
-import type { TDirectiveInputSignals } from "../../../core/utils/TDirectiveInputSignals";
 import type { TSelectModeValue } from "../select/sd-select.control";
 import { SdAnchorControl } from "./sd-anchor.control";
 import { SdButtonControl } from "./sd-button.control";
@@ -28,30 +27,25 @@ import { tablerSearch, tablerEraser } from "@ng-icons/tabler-icons";
  * ISdModal을 확장하여 selectMode와 selectedItemKeys를 추가한다.
  */
 export interface ISdSelectModal<T> extends ISdModal<ISelectModalOutputResult<T>> {
-  selectMode: InputSignal<"single" | "multi">;
-  selectedItemKeys: InputSignal<T[]>;
+  selectMode: InputSignal<"single" | "multi" | undefined>;
+  selectedItemKeys: InputSignal<any[]>;
 }
 
 /**
  * 모달 선택 결과
  */
 export interface ISelectModalOutputResult<T> {
-  selectedItemKeys: T[];
-  selectedItems: Record<string, unknown>[];
+  selectedItemKeys: any[];
+  selectedItems: T[];
 }
 
 /**
  * 모달 선택 정보 (selectMode/selectedItemKeys를 제외한 inputs)
  */
-export type TSdSelectModalInfo<T extends ISdSelectModal<any>> = Omit<
-  ISdModalInfo<T>,
-  "inputs"
-> & {
-  inputs: Omit<
-    TDirectiveInputSignals<T>,
-    "initialized" | "close" | "actionTplRef" | "selectMode" | "selectedItemKeys"
-  >;
-};
+export type TSdSelectModalInfo<T extends ISdSelectModal<any>> = ISdModalInfo<
+  T,
+  "selectMode" | "selectedItemKeys"
+>;
 
 @Component({
   selector: "sd-modal-select-button",
@@ -71,7 +65,7 @@ export type TSdSelectModalInfo<T extends ISdSelectModal<any>> = Omit<
       }
       @if (!disabled()) {
         <sd-button [inset]="true" (click)="onSearchClick()">
-          <ng-icon [svg]="tablerSearch" />
+          <ng-icon [svg]="searchIcon()" />
         </sd-button>
       }
     </div>
@@ -156,20 +150,27 @@ export type TSdSelectModalInfo<T extends ISdSelectModal<any>> = Omit<
     "[attr.data-sd-disabled]": "disabled()",
   },
 })
-export class SdModalSelectButtonControl {
+export class SdModalSelectButtonControl<
+  T extends object,
+  K,
+  M extends keyof TSelectModeValue<K> = keyof TSelectModeValue<K>,
+> {
   private readonly _sdModal = inject(SdModalProvider);
 
-  selectMode = input<"single" | "multi">("single");
-  value = model<TSelectModeValue<any>>();
-  selectedItems = model<Record<string, unknown>[]>([]);
+  modal = input.required<TSdSelectModalInfo<ISdSelectModal<T>>>();
+
+  value = model<TSelectModeValue<K>[M]>();
+  selectedItems = model<T[]>([]);
+
   disabled = input(false, { transform: booleanAttribute });
   required = input(false, { transform: booleanAttribute });
-  modal = input<TSdSelectModalInfo<any>>();
-  modalOptions = input<ISdModalOptions>();
-  size = input<"sm" | "lg">();
   inset = input(false, { transform: booleanAttribute });
+  size = input<"sm" | "lg">();
+  selectMode = input<M>("single" as M);
+  modalOptions = input<ISdModalOptions>();
+
+  searchIcon = input(tablerSearch);
 
-  protected readonly tablerSearch = tablerSearch;
   protected readonly tablerEraser = tablerEraser;
 
   _hasValue = computed(() => {
@@ -190,48 +191,29 @@ export class SdModalSelectButtonControl {
   }
 
   onEraseClick(): void {
-    if (this.selectMode() === "multi") {
-      this.value.set([]);
-    } else {
-      this.value.set(undefined);
-    }
+    this.value.set((this.selectMode() === "multi" ? [] : undefined) as any);
     this.selectedItems.set([]);
   }
 
   async onSearchClick(): Promise<void> {
-    const modalInfo = this.modal();
-    if (modalInfo == null) return;
-
-    const currentValue = this.value();
-    const selectedItemKeys: any[] =
-      this.selectMode() === "multi"
-        ? (currentValue as any[] | undefined) ?? []
-        : currentValue != null
-          ? [currentValue]
-          : [];
-
-    const result = await this._sdModal.showAsync(
-      {
-        title: modalInfo.title,
-        type: modalInfo.type,
-        inputs: {
-          ...modalInfo.inputs,
-          selectMode: this.selectMode(),
-          selectedItemKeys,
-        } as any,
+    const modal = this.modal();
+    const result = await this._sdModal.showAsync({
+      ...modal,
+      inputs: {
+        selectMode: this.selectMode(),
+        selectedItemKeys: (this.selectMode() === "multi"
+          ? ((this.value() as any[] | undefined) ?? [])
+          : [this.value()]
+        ).filterExists(),
+        ...modal.inputs,
       },
-      this.modalOptions(),
-    );
-
-    if (result == null) return;
-
-    const typedResult = result as ISelectModalOutputResult<any>;
+    });
 
-    if (this.selectMode() === "multi") {
-      this.value.set(typedResult.selectedItemKeys);
-    } else {
-      this.value.set(typedResult.selectedItemKeys[0]);
+    if (result) {
+      const newValue =
+        this.selectMode() === "multi" ? result.selectedItemKeys : result.selectedItemKeys[0];
+      this.value.set(newValue);
+      this.selectedItems.set(result.selectedItems);
     }
-    this.selectedItems.set(typedResult.selectedItems);
   }
 }

package/src/ui/form/editor/sd-tiptap-editor.control.ts

@@ -24,6 +24,40 @@ import TextAlign from "@tiptap/extension-text-align";
 import Image from "@tiptap/extension-image";
 import Placeholder from "@tiptap/extension-placeholder";
 
+interface TiptapActiveStates {
+  h1: boolean;
+  h2: boolean;
+  bold: boolean;
+  italic: boolean;
+  underline: boolean;
+  strike: boolean;
+  bulletList: boolean;
+  orderedList: boolean;
+  blockquote: boolean;
+  codeBlock: boolean;
+  alignLeft: boolean;
+  alignCenter: boolean;
+  alignRight: boolean;
+  alignJustify: boolean;
+}
+
+const DEFAULT_ACTIVE_STATES: TiptapActiveStates = {
+  h1: false,
+  h2: false,
+  bold: false,
+  italic: false,
+  underline: false,
+  strike: false,
+  bulletList: false,
+  orderedList: false,
+  blockquote: false,
+  codeBlock: false,
+  alignLeft: false,
+  alignCenter: false,
+  alignRight: false,
+  alignJustify: false,
+};
+
 const DEFAULT_EXTENSIONS: AnyExtension[] = [
   StarterKit,
   TextStyle,
@@ -251,7 +285,7 @@ export class SdTiptapEditorControl {
     "#f9cb9c", "#ffe599", "#b6d7a8", "#a2c4c9", "#a4c2f4", "#9fc5e8", "#b4a7d6", "#d5a6bd",
   ];
 
-  activeStates: WritableSignal<Record<string, boolean>> = signal({});
+  activeStates: WritableSignal<TiptapActiveStates> = signal(DEFAULT_ACTIVE_STATES);
   activeColor = signal("");
   activeBgColor = signal("");
   colorPickerMode: "text" | "bg" | undefined;

package/src/ui/form/select/sd-select-item.control.ts

@@ -78,7 +78,7 @@ import { SdGapControl } from "../../layout/sd-gap.control";
   },
 })
 export class SdSelectItemControl<T> {
-  protected readonly _parentControl = inject<SdSelectControl<T>>(
+  protected readonly _parentControl = inject<SdSelectControl<any, T>>(
     forwardRef(() => SdSelectControl),
   );
   private readonly _elRef = inject(ElementRef<HTMLElement>);

package/src/ui/form/select/sd-select.control.ts

@@ -26,7 +26,10 @@ import { NgIcon } from "@ng-icons/core";
 import { tablerCaretDown } from "@ng-icons/tabler-icons";
 import { tabbable } from "tabbable";
 
-export type TSelectModeValue<T> = T | T[] | undefined;
+export type TSelectModeValue<T> = {
+  multi: T[];
+  single: T;
+};
 
 @Component({
   selector: "sd-select",
@@ -175,9 +178,9 @@ export type TSelectModeValue<T> = T | T[] | undefined;
     "[attr.data-sd-disabled]": "disabled()",
   },
 })
-export class SdSelectControl<T> {
-  selectMode = input<"single" | "multi">("single");
-  value = model<TSelectModeValue<T>>();
+export class SdSelectControl<M extends "single" | "multi", T> {
+  selectMode = input("single" as M);
+  value = model<TSelectModeValue<any>[M]>();
   placeholder = input<string>();
   disabled = input(false, { transform: booleanAttribute });
   inline = input(false, { transform: booleanAttribute });

package/src/ui/overlay/modal/sd-modal.provider.ts

@@ -14,7 +14,10 @@ import {
 } from "@angular/core";
 import { outputToObservable } from "@angular/core/rxjs-interop";
 import { Subscription } from "rxjs";
-import type { TDirectiveInputSignals } from "../../../core/utils/TDirectiveInputSignals";
+import type {
+  TDirectiveInputSignals,
+  TWithOptional,
+} from "../../../core/utils/TDirectiveInputSignals";
 import { SdModalControl } from "./sd-modal.control";
 import "@simplysm/core-browser";
 
@@ -25,15 +28,24 @@ export interface ISdModal<O> {
   initialized: Signal<boolean>;
   close: OutputEmitterRef<O | undefined>;
   actionTplRef?: TemplateRef<any>;
+  readonly _optionalModalInputs?: string;
 }
 
+type TSdModalExcludeKeys = "initialized" | "close" | "actionTplRef" | "_optionalModalInputs";
+type TSdModalOptionalKeys<T> = T extends { _optionalModalInputs?: infer K extends string }
+  ? K
+  : never;
+
 /**
  * 모달 생성 시 전달하는 정보
  */
-export interface ISdModalInfo<T extends ISdModal<any>> {
+export interface ISdModalInfo<T extends ISdModal<any>, X extends keyof any = ""> {
   title: string;
   type: Type<T>;
-  inputs: Omit<TDirectiveInputSignals<T>, "initialized" | "close" | "actionTplRef">;
+  inputs: TWithOptional<
+    Omit<TDirectiveInputSignals<T>, TSdModalExcludeKeys | X>,
+    TSdModalOptionalKeys<T> & keyof Omit<TDirectiveInputSignals<T>, TSdModalExcludeKeys | X>
+  >;
 }
 
 /**

package/docs/commons-and-configuration.md

@@ -1,34 +0,0 @@
-# Commons & Configuration
-
-## `provideSdAngular`
-
-Bootstrap function that registers all core providers, event plugins, the global error handler, and zoneless change detection. Call in `bootstrapApplication`.
-
-```typescript
-function provideSdAngular(opt: { clientName: string }): EnvironmentProviders
-```
-
-Registers:
-- `SdAngularConfigProvider` with the given `clientName`
-- `SdThemeProvider` with dark mode persistence via `SdLocalStorageProvider`
-- All event manager plugins (`SdSaveCommandEventPlugin`, `SdRefreshCommandEventPlugin`, `SdInsertCommandEventPlugin`, `SdResizeEventPlugin`, `SdIntersectionEventPlugin`, `SdOptionEventPlugin`)
-- `SdGlobalErrorHandlerPlugin` as `ErrorHandler`
-- `provideZonelessChangeDetection()`
-- Global unhandled rejection/error listeners
-- Service Worker update polling (5-minute interval)
-- Router navigation busy indicator
-
-## `TXT_CHANGE_IGNORE_CONFIRM`
-
-Confirmation message text displayed when the user attempts to navigate away with unsaved changes.
-
-```typescript
-const TXT_CHANGE_IGNORE_CONFIRM: string
-```
-
-Value (Korean):
-```
-변경사항이 있습니다. 모든 변경사항을 무시하시겠습니까?
-- 확인: 변경사항을 무시하고, 현재 요청한 작업을 수행
-- 취소: 현재 요청한 작업을 취소하고, 변경사항 재검토
-```

package/docs/data-display-components.md

@@ -1,146 +0,0 @@
-# Data Display Components
-
-## `SdListControl`
-
-List container component.
-
-Selector: `sd-list`
-
-| Input | Type | Description |
-|-------|------|-------------|
-| `inset` | `boolean` (booleanAttribute) | Transparent background (default: `false`) |
-
-## `SdListItemControl`
-
-List item with accordion or flat layout. Supports collapsible child lists, ripple effect, selected state, tool template, and selected icon.
-
-Selector: `sd-list-item`
-
-| Input/Model | Type | Description |
-|-------------|------|-------------|
-| `layout` | `"accordion" \| "flat"` | Layout mode (default: `"accordion"`) |
-| `open` (model) | `boolean` | Collapse open state (default: `false`) |
-| `selected` | `boolean` (booleanAttribute) | Selected state (default: `false`) |
-| `selectedIcon` | `string` | Optional icon SVG for selection indicator |
-| `readonly` | `boolean` (booleanAttribute) | Read-only mode (default: `false`) |
-
-Content children:
-- `#toolTpl` template: Additional tool area rendered on the right side
-- `<sd-list>` child: Nested list shown in collapse
-
-## `SdSheetControl`
-
-Full-featured data grid with sorting, selection, tree expanding, pagination, column resizing, and configuration persistence.
-
-Selector: `sd-sheet`
-
-### Inputs
-
-| Input | Type | Description |
-|-------|------|-------------|
-| `key` | `string` | Config key for column settings persistence |
-| `items` | `T[]` | Data items (default: `[]`) |
-| `trackByFn` | `(item: T, index: number) => unknown` | Track-by function for rows |
-| `selectMode` | `"single" \| "multi"` | Selection mode |
-| `autoSelect` | `"click" \| "focus"` | Auto-select trigger |
-| `getItemSelectableFn` | `(item: T) => boolean \| string` | Item selectable check (string = disabled reason) |
-| `getChildrenFn` | `(item: T, index: number) => T[] \| undefined` | Children accessor for tree mode |
-| `useAutoSort` | `boolean` (booleanAttribute) | Enable client-side sorting (default: `false`) |
-| `visiblePageCount` | `number` | Visible page buttons (default: `10`) |
-| `totalPageCount` | `number` | Total pages (server-side pagination, default: `0`) |
-| `itemsPerPage` | `number` | Items per page (client-side pagination, default: `0` = no pagination) |
-| `focusMode` | `"row" \| "cell"` | Focus navigation mode (default: `"cell"`) |
-| `inset` | `boolean` (booleanAttribute) | Borderless inset style (default: `false`) |
-| `contentStyle` | `string` | Inline style for the scroll container |
-| `getItemCellClassFn` | `(item: T, colKey: string) => string` | Cell CSS class function |
-| `getItemCellStyleFn` | `(item: T, colKey: string) => string` | Cell inline style function |
-| `hideConfigBar` | `boolean` (booleanAttribute) | Hide config/pagination bar (default: `false`) |
-
-### Models
-
-| Model | Type | Description |
-|-------|------|-------------|
-| `selectedItems` | `T[]` | Selected items (default: `[]`) |
-| `expandedItems` | `T[]` | Expanded tree items (default: `[]`) |
-| `sorts` | `ISortingDef[]` | Sort definitions (default: `[]`) |
-| `currentPage` | `number` | Current page index, 0-based (default: `0`) |
-
-### Outputs
-
-| Output | Type | Description |
-|--------|------|-------------|
-| `itemKeydown` | `ISdSheetItemKeydownEventParam<T>` | Row-level keydown event |
-| `cellKeydown` | `ISdSheetItemKeydownEventParam<T>` | Cell-level keydown event |
-
-## `SdSheetColumnDirective`
-
-Column definition for `SdSheetControl`. Defines header, width, and cell/summary templates.
-
-Selector: `sd-sheet-column`
-
-| Input | Type | Description |
-|-------|------|-------------|
-| `key` | `string` (required) | Unique column key |
-| `header` | `string \| string[]` | Header text (multi-level headers via array, default: `""`) |
-| `width` | `string` | Column width (CSS value) |
-| `fixed` | `boolean` (booleanAttribute) | Fixed column (default: `false`) |
-| `hidden` | `boolean` (booleanAttribute) | Hidden column (default: `false`) |
-| `collapse` | `boolean` (booleanAttribute) | Collapsed column (default: `false`) |
-| `disableSorting` | `boolean` (booleanAttribute) | Disable sorting for this column (default: `false`) |
-| `disableResizing` | `boolean` (booleanAttribute) | Disable resizing for this column (default: `false`) |
-| `ordering` | `number` | Column display order (default: `0`) |
-
-Content children:
-- `#cellTpl` template: Cell content template. Context: `{ $implicit: T, item: T, index: number, depth: number, edit: boolean }`
-- `#summaryTpl` template: Summary (footer) template
-
-## `SdSheetConfigModal`
-
-Modal for configuring sheet columns (visibility, order, width, fixed state). Implements `ISdModal<ISdSheetConfig>`.
-
-Selector: `sd-sheet-config-modal`
-
-| Input | Type | Description |
-|-------|------|-------------|
-| `columns` | `SdSheetColumnDirective[]` (required) | Column directives |
-| `config` | `ISdSheetConfig` (required) | Current configuration |
-
-## Types
-
-### `ISdSheetColumnDef`
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `key` | `string` | Unique column key |
-| `header` | `string \| string[]` | Header text |
-| `width` | `string \| undefined` | Column width |
-| `fixed` | `boolean` | Whether column is fixed |
-| `hidden` | `boolean` | Whether column is hidden |
-| `collapse` | `boolean` | Whether column is collapsed |
-| `disableSorting` | `boolean` | Whether sorting is disabled |
-| `disableResizing` | `boolean` | Whether resizing is disabled |
-| `ordering` | `number` | Display order |
-
-### `ISdSheetConfig`
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `columnRecord` | `Record<string, { width?: string; hidden?: boolean; fixed?: boolean; ordering?: number }>` | Per-column overrides |
-
-### `ISdSheetHeaderDef`
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `text` | `string` | Header cell text |
-| `colspan` | `number` | Column span |
-| `rowspan` | `number` | Row span |
-| `isLastRow` | `boolean` | Whether this is the last header row |
-| `colDef` | `ISdSheetColumnDef \| undefined` | Associated column definition |
-
-### `ISdSheetItemKeydownEventParam`
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `item` | `T` | The data item |
-| `key` | `string` | Optional column key (for cell keydown) |
-| `event` | `KeyboardEvent` | The keyboard event |