@simplysm/angular 14.0.7 → 14.0.9

package/docs/navigation-components.md

@@ -1,200 +0,0 @@
-# Navigation Components
-
-## `SdCollapseControl`
-
-Animated collapsible content using negative margin-top transition.
-
-Selector: `sd-collapse`
-
-| Input | Type | Description |
-|-------|------|-------------|
-| `open` | `boolean` (booleanAttribute) | Whether content is visible (default: `false`) |
-
-## `SdCollapseIconControl`
-
-Rotating chevron icon that indicates collapse/expand state.
-
-Selector: `sd-collapse-icon`
-
-| Input | Type | Description |
-|-------|------|-------------|
-| `open` | `boolean` (booleanAttribute) | Whether in open state (default: `false`) |
-| `openRotate` | `number` (numberAttribute) | Rotation angle in degrees when open (default: `90`) |
-
-## `SdTabControl`
-
-Tab header container. Manages the active tab value.
-
-Selector: `sd-tab`
-
-| Input/Model | Type | Description |
-|-------------|------|-------------|
-| `value` (model) | `any` | Currently active tab value |
-
-## `SdTabItemControl`
-
-Individual tab header item inside `SdTabControl`.
-
-Selector: `sd-tab-item`
-
-| Input | Type | Description |
-|-------|------|-------------|
-| `value` | `any` | Tab value (matched against parent's value) |
-
-## `SdTabviewControl`
-
-Combined tab header and content view. Automatically renders tab headers from `SdTabviewItemControl` children.
-
-Selector: `sd-tabview`
-
-| Input/Model | Type | Description |
-|-------------|------|-------------|
-| `value` (model) | `T` | Currently active tabview value |
-
-## `SdTabviewItemControl`
-
-Tab content panel inside `SdTabviewControl`. Shown when its value matches the parent's value.
-
-Selector: `sd-tabview-item`
-
-| Input | Type | Description |
-|-------|------|-------------|
-| `value` | `T` (required) | Panel value |
-| `header` | `string` | Tab header text (falls back to value if not set) |
-
-## `SdPaginationControl`
-
-Page navigation with first/prev-group/next-group/last buttons.
-
-Selector: `sd-pagination`
-
-| Input/Model | Type | Description |
-|-------------|------|-------------|
-| `currentPage` (model) | `number` | Current page index, 0-based (default: `0`) |
-| `totalPageCount` | `number` (numberAttribute) | Total number of pages (default: `0`) |
-| `visiblePageCount` | `number` (numberAttribute) | Pages shown per group (default: `10`) |
-
-Public methods:
-
-```typescript
-goToPage(page: number): void;
-goToNextGroup(): void;
-goToPrevGroup(): void;
-goToFirst(): void;
-goToLast(): void;
-```
-
-## `SdSidebarContainerControl`
-
-Layout container with sidebar toggle support. Handles backdrop click and auto-close on navigation.
-
-Selector: `sd-sidebar-container`
-
-Public properties:
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `toggle` | `WritableSignal<boolean>` | Sidebar toggle state |
-
-## `SdSidebarControl`
-
-Sidebar panel that slides in/out. Positioned absolutely on the left side. Responsive: slides from left on mobile.
-
-Selector: `sd-sidebar`
-
-No inputs. Toggle state is derived from parent `SdSidebarContainerControl`.
-
-## `SdSidebarMenuControl`
-
-Menu renderer for sidebar. Displays hierarchical menus with router links. Supports accordion and flat layouts.
-
-Selector: `sd-sidebar-menu`
-
-| Input | Type | Description |
-|-------|------|-------------|
-| `menus` | `ISdSidebarMenu[]` | Menu items (default: `[]`) |
-| `layout` | `"accordion" \| "flat"` | Root layout mode (auto-selected based on menu count) |
-| `getMenuIsSelectedFn` | `(menu: ISdSidebarMenu) => boolean` | Custom selection check function |
-
-### `ISdSidebarMenu`
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `title` | `string` | Display title |
-| `codeChain` | `string[]` | Code path chain for route generation |
-| `url` | `string` | Optional external URL (opens in new tab) |
-| `icon` | `string` | Optional icon SVG |
-| `children` | `ISdSidebarMenu[]` | Optional child menus |
-
-## `SdSidebarUserControl`
-
-User info section in the sidebar with expandable user menu.
-
-Selector: `sd-sidebar-user`
-
-| Input | Type | Description |
-|-------|------|-------------|
-| `userMenu` | `ISidebarUserMenu` | User menu configuration |
-
-### `ISidebarUserMenu`
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `title` | `string` | Menu header title |
-| `menus` | `{ title: string; onClick: () => void }[]` | Menu items |
-
-## `SdTopbarContainerControl`
-
-Layout container for the top navigation bar. Renders as a flex column filling height.
-
-Selector: `sd-topbar-container`
-
-No inputs.
-
-## `SdTopbarControl`
-
-Top navigation bar. Includes optional sidebar toggle button.
-
-Selector: `sd-topbar`
-
-| Input | Type | Description |
-|-------|------|-------------|
-| `sidebarContainer` | `SdSidebarContainerControl` | Optional explicit sidebar container reference |
-
-## `SdTopbarMenuControl`
-
-Menu renderer for topbar using dropdown menus. Displays hierarchical menus with router links.
-
-Selector: `sd-topbar-menu`
-
-| Input | Type | Description |
-|-------|------|-------------|
-| `menus` | `ISdTopbarMenu[]` | Menu items (default: `[]`) |
-| `getMenuIsSelectedFn` | `(menu: ISdTopbarMenu) => boolean` | Custom selection check function |
-
-### `ISdTopbarMenu`
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `title` | `string` | Display title |
-| `codeChain` | `string[]` | Code path chain for route generation |
-| `url` | `string` | Optional external URL (opens in new tab) |
-| `icon` | `string` | Optional icon SVG |
-| `children` | `ISdTopbarMenu[]` | Optional child menus |
-
-## `SdTopbarUserControl`
-
-User dropdown in topbar. Displays user content as trigger and menu items in dropdown.
-
-Selector: `sd-topbar-user`
-
-| Input | Type | Description |
-|-------|------|-------------|
-| `menus` | `ISdTopbarUserMenu[]` (required) | User menu items |
-
-### `ISdTopbarUserMenu`
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `title` | `string` | Menu item title |
-| `onClick` | `() => void` | Click handler |

package/docs/overlay-components.md

@@ -1,193 +0,0 @@
-# Overlay Components
-
-## `SdDropdownControl`
-
-Dropdown trigger container. Opens a popup on click/Enter. Handles positioning and backdrop on mobile.
-
-Selector: `sd-dropdown`
-
-| Input/Model | Type | Description |
-|-------------|------|-------------|
-| `open` (model) | `boolean` | Dropdown open state (default: `false`) |
-| `disabled` | `boolean` (booleanAttribute) | Disabled state (default: `false`) |
-
-## `SdDropdownPopupControl`
-
-Dropdown popup content panel. Positioned fixed relative to the trigger. Handles resize and keyboard navigation.
-
-Selector: `sd-dropdown-popup`
-
-No public inputs. Used as a content child of `SdDropdownControl`.
-
-## `SdModalControl`
-
-Modal dialog component with header, close button, backdrop, resize handles, and drag-to-move support. Created programmatically by `SdModalProvider`.
-
-Selector: `sd-modal`
-
-| Input/Model | Type | Description |
-|-------------|------|-------------|
-| `open` (model) | `boolean` | Open state (default: `false`) |
-| `key` | `string` | Config key for position/size persistence |
-| `title` | `string` | Modal title (default: `""`) |
-| `hideHeader` | `boolean` | Hide header bar (default: `false`) |
-| `hideCloseButton` | `boolean` | Hide close button (default: `false`) |
-| `useCloseByBackdrop` | `boolean` | Close on backdrop click (default: `true`) |
-| `useCloseByEscapeKey` | `boolean` | Close on Escape key (default: `true`) |
-| `float` | `boolean` | Float mode (default: `false`) |
-| `fill` | `boolean` | Fill mode (default: `false`) |
-| `resizable` | `boolean` | Enable resize handles (default: `false`) |
-| `movable` | `boolean` | Enable header drag-to-move (default: `false`) |
-| `position` | `"bottom-right" \| "top-right"` | Position preset |
-| `minHeightPx` | `number` | Minimum height in pixels |
-| `minWidthPx` | `number` | Minimum width in pixels |
-| `heightPx` | `number` | Initial height in pixels |
-| `widthPx` | `number` | Initial width in pixels |
-| `headerStyle` | `string` | Custom header inline style |
-| `noFirstControlFocusing` | `boolean` | Skip auto-focusing first control (default: `false`) |
-| `actionTplRef` | `TemplateRef<any>` | Optional action template for header |
-
-| Output | Type | Description |
-|--------|------|-------------|
-| `closeRequest` | `void` | Emitted when backdrop click, Escape, or close button triggers close |
-
-## `SdPromptModalControl`
-
-Built-in prompt modal. Displays a message and text input. Implements `ISdModal<string>`.
-
-Selector: `sd-prompt-modal`
-
-| Input | Type | Description |
-|-------|------|-------------|
-| `message` | `string` (required) | Prompt message text |
-
-| Output | Type | Description |
-|--------|------|-------------|
-| `close` | `string \| undefined` | Emits input value on confirm, undefined on cancel |
-
-## `SdConfirmModalControl`
-
-Built-in confirm modal. Displays a message with confirm/cancel buttons. Implements `ISdModal<boolean>`.
-
-Selector: `sd-confirm-modal`
-
-| Input | Type | Description |
-|-------|------|-------------|
-| `message` | `string` (required) | Confirmation message text |
-
-| Output | Type | Description |
-|--------|------|-------------|
-| `close` | `boolean \| undefined` | Emits `true` on confirm, `undefined` on cancel |
-
-## `SdToastControl`
-
-Individual toast notification component. Supports themes, progress bar, and ARIA roles.
-
-Selector: `sd-toast`
-
-| Input/Model | Type | Description |
-|-------------|------|-------------|
-| `open` (model) | `boolean` | Open state with transition (default: `false`) |
-| `useProgress` | `boolean` (booleanAttribute) | Show progress bar (default: `false`) |
-| `theme` | `TSdToastTheme` | Toast theme (default: `"info"`) |
-| `progress` (model) | `number` | Progress percentage 0-100 (default: `0`) |
-| `message` (model) | `string \| undefined` | Toast message text |
-
-## `SdToastContainerControl`
-
-Fixed-position container for toast notifications.
-
-Selector: `sd-toast-container`
-
-| Input | Type | Description |
-|-------|------|-------------|
-| `overlap` | `boolean` (booleanAttribute) | Overlap mode (single toast, bottom-left positioned, default: `false`) |
-
-## `SdBusyContainerControl`
-
-Busy/loading overlay container. Shows a loading indicator over its content.
-
-Selector: `sd-busy-container`
-
-| Input | Type | Description |
-|-------|------|-------------|
-| `busy` | `boolean` (booleanAttribute) | Whether to show busy overlay (default: `false`) |
-| `message` | `string \| undefined` | Loading message text |
-| `type` | `TSdBusyType \| undefined` | Indicator type (falls back to `SdBusyProvider.type()`) |
-| `progressPercent` | `number \| undefined` | Optional progress percentage |
-
-### `TSdBusyType`
-
-```typescript
-type TSdBusyType = "spinner" | "bar" | "cube";
-```
-
-## Toast Types
-
-### `TSdToastSeverity`
-
-```typescript
-type TSdToastSeverity = "info" | "success" | "warning" | "danger";
-```
-
-### `TSdToastTheme`
-
-```typescript
-type TSdToastTheme = "primary" | "secondary" | TSdToastSeverity | "gray" | "blue-gray";
-```
-
-### `ISdToast`
-
-Interface for custom toast content components.
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `close` | `OutputEmitterRef<O \| undefined>` | Output to emit close result |
-
-### `ISdToastInput`
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `type` | `Type<T>` | Component type |
-| `inputs` | `Omit<TDirectiveInputSignals<T>, "close">` | Component inputs |
-
-## Modal Types
-
-### `ISdModal`
-
-Interface for modal content components.
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `initialized` | `Signal<boolean>` | Whether content is initialized |
-| `close` | `OutputEmitterRef<O \| undefined>` | Output to emit close result |
-| `actionTplRef` | `TemplateRef<any>` | Optional action template for modal header |
-
-### `ISdModalInfo`
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `title` | `string` | Modal title |
-| `type` | `Type<T>` | Component type |
-| `inputs` | `Omit<TDirectiveInputSignals<T>, "initialized" \| "close" \| "actionTplRef">` | Component inputs |
-
-### `ISdModalOptions`
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `key` | `string` | Config persistence key |
-| `hideHeader` | `boolean` | Hide header |
-| `hideCloseButton` | `boolean` | Hide close button |
-| `useCloseByBackdrop` | `boolean` | Close on backdrop click |
-| `useCloseByEscapeKey` | `boolean` | Close on Escape |
-| `float` | `boolean` | Float mode |
-| `fill` | `boolean` | Fill mode |
-| `resizable` | `boolean` | Enable resizing |
-| `movable` | `boolean` | Enable moving |
-| `position` | `"bottom-right" \| "top-right"` | Position preset |
-| `minHeightPx` | `number` | Minimum height |
-| `minWidthPx` | `number` | Minimum width |
-| `heightPx` | `number` | Initial height |
-| `widthPx` | `number` | Initial width |
-| `headerStyle` | `string` | Header inline style |
-| `noFirstControlFocusing` | `boolean` | Skip auto-focus |

package/docs/pipes.md

@@ -1,25 +0,0 @@
-# Pipes
-
-## `FormatPipe`
-
-Formats `DateTime`, `DateOnly`, or string values using a format pattern.
-
-Pipe name: `format`
-
-```typescript
-@Pipe({ standalone: true, name: "format" })
-class FormatPipe implements PipeTransform {
-  transform(value: string | DateTime | DateOnly | undefined, format: string): string;
-}
-```
-
-Behavior:
-- `null`/`undefined` returns `""`
-- `DateTime`/`DateOnly` instances call `value.toFormatString(format)`
-- Strings: the format pattern uses `X` as placeholders for characters. Multiple patterns can be separated by `|` and the one matching the value's length is used.
-
-Usage:
-```html
-{{ dateValue | format: "yyyy-MM-dd" }}
-{{ phoneNumber | format: "XXX-XXXX-XXXX|XX-XXX-XXXX" }}
-```