@sdcorejs/angular 19.3.0 → 19.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. package/README.md +2 -2
  2. package/components/file-explorer/index.d.ts +1 -0
  3. package/components/file-explorer/src/components/actions.component.d.ts +40 -0
  4. package/components/file-explorer/src/components/command-sheet.component.d.ts +49 -0
  5. package/components/file-explorer/src/components/folder-tree.component.d.ts +41 -11
  6. package/components/file-explorer/src/components/item-list.component.d.ts +68 -13
  7. package/components/file-explorer/src/components/menu-trigger.component.d.ts +27 -0
  8. package/components/file-explorer/src/components/preview-panel.component.d.ts +6 -4
  9. package/components/file-explorer/src/file-explorer-actions.d.ts +80 -0
  10. package/components/file-explorer/src/file-explorer-column.directive.d.ts +20 -0
  11. package/components/file-explorer/src/file-explorer-move.d.ts +12 -0
  12. package/components/file-explorer/src/file-explorer-normalize.d.ts +72 -0
  13. package/components/file-explorer/src/file-explorer.component.d.ts +106 -23
  14. package/components/file-explorer/src/file-explorer.model.d.ts +210 -29
  15. package/components/file-explorer/src/file-explorer.utils.d.ts +1 -1
  16. package/components/file-explorer/src/file-explorer.view-model.d.ts +75 -5
  17. package/components/form-generic/src/components/form-builder/form-builder.component.d.ts +5 -0
  18. package/components/form-generic/src/components/form-builder/inspector/inspector.component.d.ts +75 -67
  19. package/components/form-generic/src/components/form-builder/state/builder-commands.d.ts +3 -1
  20. package/components/form-generic/src/components/form-builder/state/builder-document.d.ts +6 -2
  21. package/components/form-generic/src/components/form-builder/state/builder-store.d.ts +18 -1
  22. package/components/form-generic/src/components/form-render/components/item/components/datetime/datetime.component.d.ts +7 -6
  23. package/components/form-generic/src/components/form-render/components/item/item.component.d.ts +3 -1
  24. package/components/form-generic/src/components/form-render/form-render.component.d.ts +31 -4
  25. package/components/form-generic/src/models/form-generic-schema.model.d.ts +2 -1
  26. package/components/index.d.ts +1 -0
  27. package/components/kanban/index.d.ts +3 -0
  28. package/components/kanban/src/kanban.component.d.ts +83 -0
  29. package/components/kanban/src/kanban.model.d.ts +65 -0
  30. package/components/kanban/src/kanban.templates.d.ts +30 -0
  31. package/components/kanban/src/kanban.utils.d.ts +5 -0
  32. package/components/section/src/section-item/section-item.component.d.ts +2 -1
  33. package/components/tab/src/tab-group.component.d.ts +3 -1
  34. package/fesm2022/sdcorejs-angular-components-button.mjs +2 -2
  35. package/fesm2022/sdcorejs-angular-components-button.mjs.map +1 -1
  36. package/fesm2022/sdcorejs-angular-components-file-explorer.mjs +2158 -86
  37. package/fesm2022/sdcorejs-angular-components-file-explorer.mjs.map +1 -1
  38. package/fesm2022/sdcorejs-angular-components-form-generic.mjs +637 -34
  39. package/fesm2022/sdcorejs-angular-components-form-generic.mjs.map +1 -1
  40. package/fesm2022/sdcorejs-angular-components-kanban.mjs +441 -0
  41. package/fesm2022/sdcorejs-angular-components-kanban.mjs.map +1 -0
  42. package/fesm2022/sdcorejs-angular-components-section.mjs +4 -3
  43. package/fesm2022/sdcorejs-angular-components-section.mjs.map +1 -1
  44. package/fesm2022/sdcorejs-angular-components-stepper.mjs +5 -1
  45. package/fesm2022/sdcorejs-angular-components-stepper.mjs.map +1 -1
  46. package/fesm2022/sdcorejs-angular-components-tab.mjs +11 -3
  47. package/fesm2022/sdcorejs-angular-components-tab.mjs.map +1 -1
  48. package/fesm2022/sdcorejs-angular-components.mjs +1 -0
  49. package/fesm2022/sdcorejs-angular-components.mjs.map +1 -1
  50. package/fesm2022/sdcorejs-angular-forms-segmented.mjs +244 -0
  51. package/fesm2022/sdcorejs-angular-forms-segmented.mjs.map +1 -0
  52. package/fesm2022/sdcorejs-angular-forms.mjs +8 -0
  53. package/fesm2022/sdcorejs-angular-forms.mjs.map +1 -1
  54. package/fesm2022/sdcorejs-angular-i18n.mjs +300 -0
  55. package/fesm2022/sdcorejs-angular-i18n.mjs.map +1 -1
  56. package/fesm2022/sdcorejs-angular-services-confirm.mjs +2 -2
  57. package/forms/index.d.ts +1 -0
  58. package/forms/segmented/index.d.ts +2 -0
  59. package/forms/segmented/src/segmented.component.d.ts +57 -0
  60. package/forms/segmented/src/segmented.model.d.ts +28 -0
  61. package/forms/src/forms.module.d.ts +7 -6
  62. package/i18n/src/en.d.ts +59 -0
  63. package/package.json +13 -5
@@ -1,14 +1,16 @@
1
+ import type { SdButtonColor } from '@sdcorejs/angular/components/button';
2
+ import type { SdIconSet } from '@sdcorejs/angular/modules/icon';
1
3
  import type { SdFileExplorerIconName } from './file-explorer-icons.generated';
2
- import type { SdFileExplorerItem, SdFileExplorerTransfer } from './file-explorer.model';
4
+ import type { SdFileExplorerActionGroupDefinition, SdFileExplorerActionLeafDefinition, SdFileExplorerItem, SdFileExplorerTransfer } from './file-explorer.model';
3
5
  import type { SdFileExplorerFileType } from './file-explorer.utils';
4
6
  /** One visible row of the folder tree (the tree is rendered flat, depth carried by `level`). */
5
- export interface SdFileExplorerTreeNode {
7
+ export interface SdFileExplorerTreeNode<T = unknown> {
6
8
  /** Unique key: `root` for the root folder, `f:<id>` for folders. */
7
9
  readonly key: string;
8
10
  /** Folder id; `null` for the root. */
9
11
  readonly id: string | null;
10
12
  /** Folder item; `null` for the root. */
11
- readonly item: SdFileExplorerItem | null;
13
+ readonly item: SdFileExplorerItem<T> | null;
12
14
  readonly name: string;
13
15
  /** 1-based depth, rendered as `aria-level`. The root is level 1. */
14
16
  readonly level: number;
@@ -20,8 +22,11 @@ export interface SdFileExplorerTreeNode {
20
22
  readonly autoId?: string;
21
23
  }
22
24
  /** One item of the list / grid, with every display string already formatted. */
23
- export interface SdFileExplorerItemView {
24
- readonly item: SdFileExplorerItem;
25
+ export interface SdFileExplorerItemView<T = unknown> {
26
+ readonly downloadDisabled?: boolean;
27
+ readonly shareDisabled?: boolean;
28
+ readonly unavailableReason?: string;
29
+ readonly item: SdFileExplorerItem<T>;
25
30
  readonly type: SdFileExplorerFileType;
26
31
  /** Built-in glyph resolved from the extension / MIME type. */
27
32
  readonly icon: SdFileExplorerIconName;
@@ -31,6 +36,71 @@ export interface SdFileExplorerItemView {
31
36
  readonly modifiedTitle: string;
32
37
  readonly downloadLabel: string;
33
38
  readonly shareLabel: string;
39
+ /** Accessible name of the selection checkbox of a file. */
40
+ readonly selectLabel: string;
41
+ /** Accessible name of the compact trigger that opens the item's command drawer. */
42
+ readonly actionsLabel: string;
43
+ readonly autoId?: string;
44
+ }
45
+ /** Compact trigger of one item: shown when its command drawer would list something. */
46
+ export interface SdFileExplorerCommandMenu {
47
+ /** An entry, or an item of one of its groups, is loading. */
48
+ readonly busy: boolean;
49
+ }
50
+ /** Command of the compact command drawer, with its states evaluated for the drawer's item. */
51
+ export interface SdFileExplorerSheetCommand<T = unknown> {
52
+ readonly kind: 'leaf';
53
+ /** Declared index (`share` / `download` for the row shortcuts): tracks the entry and suffixes its autoId. */
54
+ readonly key: string;
55
+ /** The title, or the tooltip of a definition without title. */
56
+ readonly label: string;
57
+ readonly prefixIcon: string | undefined;
58
+ readonly suffixIcon: string | undefined;
59
+ readonly fontSet: SdIconSet | undefined;
60
+ /** Declared color. It paints the icons only; unset keeps them neutral, like Core menu items. */
61
+ readonly color: SdButtonColor | undefined;
62
+ /** Disabled, loading, or inside a disabled or loading group. */
63
+ readonly disabled: boolean;
64
+ readonly loading: boolean;
65
+ readonly definition: SdFileExplorerActionLeafDefinition<SdFileExplorerItem<T>>;
66
+ }
67
+ /**
68
+ * Group of the compact command drawer: a section listing its visible children under a text-only heading. The heading is
69
+ * not a control, so it carries no icon or color: the group's `prefixIcon` (often the icon of one of its children) and
70
+ * the desktop `more_vert` face stay on the desktop trigger.
71
+ */
72
+ export interface SdFileExplorerSheetGroup<T = unknown> {
73
+ readonly kind: 'group';
74
+ readonly key: string;
75
+ readonly label: string;
76
+ readonly disabled: boolean;
77
+ readonly loading: boolean;
78
+ readonly definition: SdFileExplorerActionGroupDefinition<SdFileExplorerItem<T>>;
79
+ /** Never empty. */
80
+ readonly children: readonly SdFileExplorerSheetCommand<T>[];
81
+ }
82
+ export type SdFileExplorerSheetEntry<T = unknown> = SdFileExplorerSheetCommand<T> | SdFileExplorerSheetGroup<T>;
83
+ /** Content of the compact command drawer for one item. */
84
+ export interface SdFileExplorerCommandSheetView<T = unknown> {
85
+ /** Full item name: the drawer title, wrapped rather than cut. */
86
+ readonly title: string;
87
+ /** Type and size of the item, under the title. */
88
+ readonly context: string;
89
+ readonly icon: SdFileExplorerIconName;
90
+ /** Never empty. */
91
+ readonly entries: readonly SdFileExplorerSheetEntry<T>[];
92
+ }
93
+ /** Selection handed to the item list while the selector is on and the current view holds files. */
94
+ export interface SdFileExplorerSelectionView {
95
+ readonly selectedIds: ReadonlySet<string>;
96
+ /** Files whose checkbox `selector.disabled` locks. */
97
+ readonly disabledIds: ReadonlySet<string>;
98
+ /** Select-all checkbox: none (unchecked), some (mixed) or all eligible files are selected. */
99
+ readonly state: 'none' | 'some' | 'all';
100
+ /** Visible files that can be selected. */
101
+ readonly eligibleCount: number;
102
+ /** Accessible name and tooltip of the select-all checkbox. */
103
+ readonly allLabel: string;
34
104
  readonly autoId?: string;
35
105
  }
36
106
  /** One card of the transfer panel. */
@@ -28,6 +28,9 @@ interface VariableDraft {
28
28
  export declare class SdFormBuilder {
29
29
  #private;
30
30
  readonly store: FormBuilderStore;
31
+ readonly pageIndex: import("@angular/core").Signal<number>;
32
+ /** Confirm destructive page removal with existing reference ownership warnings. */
33
+ removePage(): Promise<void>;
31
34
  /**
32
35
  * Schema của builder — `[(schema)]`. Mỗi tham chiếu MỚI có nội dung khác schema hiện tại = nạp form
33
36
  * khác: reset lịch sử undo và selection. Nhận lại đúng schema vừa phát, hoặc tham chiếu mới nhưng
@@ -64,6 +67,8 @@ export declare class SdFormBuilder {
64
67
  constructor();
65
68
  /** Snapshot schema hiện tại (bản clone độc lập, sửa thoải mái không ảnh hưởng builder). */
66
69
  getSchema: () => SdFormGenericSchema;
70
+ /** Keep native focus visible without moving the page or any surrounding scroll container. */
71
+ protected revealPageHeader(event: Event): void;
67
72
  setMode(mode: BuilderMode): void;
68
73
  setViewport(viewport: BuilderViewport): void;
69
74
  /** Phím của radiogroup (APG): ←/↑ lùi, →/↓ tiến (vòng), Home/End về đầu/cuối. */
@@ -1,9 +1,10 @@
1
+ import type { Signal } from '@angular/core';
1
2
  import type { Filter } from '@sdcorejs/utils/models';
2
3
  import type { SdFormGenericBreakpoint } from '../../../configurations/form-generic-breakpoints';
3
4
  import { type SdFormGenericSpanSource } from '../../../layout/form-generic-layout';
4
5
  import type { SdFormGenericHtmlDefinition, SdFormGenericTemplate } from '../../../models/form-generic-config.model';
5
- import type { SdFormGenericField, SdFormGenericFieldValidation, SdFormGenericFill, SdFormGenericOption, SdFormGenericOptions, SdFormGenericParam, SdFormGenericRules } from '../../../models/form-generic-field.model';
6
- import type { SdFormGenericGroup } from '../../../models/form-generic-schema.model';
6
+ import type { SdFormGenericField, SdFormGenericFieldValidation, SdFormGenericFill, SdFormGenericNumberSubtype, SdFormGenericOption, SdFormGenericOptions, SdFormGenericParam, SdFormGenericRules } from '../../../models/form-generic-field.model';
7
+ import type { SdFormGenericGroup, SdFormGenericNavigation, SdFormGenericPageElement } from '../../../models/form-generic-schema.model';
7
8
  import { FormBuilderStore, InspectorTab } from '../state/builder-store';
8
9
  import * as i0 from "@angular/core";
9
10
  type AnyField = SdFormGenericField & Record<string, any>;
@@ -36,99 +37,106 @@ export declare class InspectorComponent {
36
37
  readonly iconPresets: string[];
37
38
  readonly colorPresets: readonly ["primary", "secondary", "info", "success", "warning", "error"];
38
39
  readonly columnChoices: Choice<number>[];
39
- readonly location: import("@angular/core").Signal<import("../state/builder-document").ItemLocation | null>;
40
- readonly item: import("@angular/core").Signal<import("@sdcorejs/angular/components/form-generic").SdFormGenericPageElement | null>;
40
+ readonly location: Signal<import("../state/builder-document").ItemLocation | null>;
41
+ readonly item: Signal<SdFormGenericPageElement | null>;
41
42
  /** Field đang chọn (không phải group/phần tử chưa hỗ trợ) với truy cập thuộc tính linh hoạt. */
42
- readonly field: import("@angular/core").Signal<AnyField | null>;
43
- readonly group: import("@angular/core").Signal<SdFormGenericGroup | null>;
43
+ readonly field: Signal<AnyField | null>;
44
+ readonly group: Signal<SdFormGenericGroup | null>;
44
45
  /** Phần tử `type` mà phiên bản này chưa hỗ trợ: chỉ xem/xoá/di chuyển, nội dung giữ nguyên. */
45
- readonly unsupported: import("@angular/core").Signal<boolean>;
46
- readonly type: import("@angular/core").Signal<"number" | "textfield" | "textarea" | "select" | "radio" | "checkbox" | "datetime" | "chip-string" | "chip-calendar" | "upload" | "html" | "group" | null>;
47
- readonly presetId: import("@angular/core").Signal<string>;
48
- readonly icon: import("@angular/core").Signal<string>;
49
- readonly typeLabelKey: import("@angular/core").Signal<string>;
50
- readonly validation: import("@angular/core").Signal<SdFormGenericFieldValidation>;
51
- readonly rules: import("@angular/core").Signal<SdFormGenericRules>;
52
- readonly elements: import("@angular/core").Signal<readonly import("@sdcorejs/angular/components/form-generic").SdFormGenericPageElement[]>;
53
- readonly variables: import("@angular/core").Signal<readonly import("@sdcorejs/angular/components/form-generic").SdFormGenericVariable[]>;
46
+ readonly unsupported: Signal<boolean>;
47
+ readonly type: Signal<SdFormGenericPageElement['type'] | null>;
48
+ readonly presetId: Signal<string>;
49
+ readonly icon: Signal<string>;
50
+ readonly typeLabelKey: Signal<string>;
51
+ readonly validation: Signal<SdFormGenericFieldValidation>;
52
+ readonly rules: Signal<SdFormGenericRules>;
53
+ readonly elements: Signal<SdFormGenericPageElement[]>;
54
+ readonly navigationMode: Signal<SdFormGenericNavigation['type'] | 'single'>;
55
+ readonly linear: Signal<boolean>;
56
+ readonly navigationChoices: Signal<{
57
+ value: string;
58
+ display: string;
59
+ }[]>;
60
+ setNavigation(value: string | null | undefined): void;
61
+ readonly variables: Signal<readonly import("@sdcorejs/angular/components/form-generic").SdFormGenericVariable[]>;
54
62
  /** Tab khả dụng theo loại phần tử. */
55
- readonly tabs: import("@angular/core").Signal<InspectorTab[]>;
56
- readonly activeTab: import("@angular/core").Signal<InspectorTab>;
57
- readonly supportsPlaceholder: import("@angular/core").Signal<boolean>;
58
- readonly supportsHelper: import("@angular/core").Signal<boolean>;
63
+ readonly tabs: Signal<InspectorTab[]>;
64
+ readonly activeTab: Signal<InspectorTab>;
65
+ readonly supportsPlaceholder: Signal<boolean>;
66
+ readonly supportsHelper: Signal<boolean>;
59
67
  /** `sd-checkbox` không có `required` → không hứa điều renderer không làm. */
60
- readonly supportsRequired: import("@angular/core").Signal<boolean>;
61
- readonly supportsDisabled: import("@angular/core").Signal<boolean>;
62
- readonly supportsViewed: import("@angular/core").Signal<boolean>;
63
- readonly supportsLength: import("@angular/core").Signal<boolean>;
64
- readonly supportsDefault: import("@angular/core").Signal<boolean>;
68
+ readonly supportsRequired: Signal<boolean>;
69
+ readonly supportsDisabled: Signal<boolean>;
70
+ readonly supportsViewed: Signal<boolean>;
71
+ readonly supportsLength: Signal<boolean>;
72
+ readonly supportsDefault: Signal<boolean>;
65
73
  /** Hyperlink ở chế độ xem: renderer chỉ dùng cho select/radio. */
66
- readonly supportsHyperlink: import("@angular/core").Signal<boolean>;
67
- readonly textSubtype: import("@angular/core").Signal<NonNullable<import("@sdcorejs/angular/components/form-generic").SdFormGenericTextfieldSubtype | undefined> | null>;
68
- readonly numberSubtype: import("@angular/core").Signal<import("@sdcorejs/angular/components/form-generic").SdFormGenericNumberSubtype | "number" | null>;
69
- readonly numberPrecision: import("@angular/core").Signal<number | undefined>;
70
- readonly passwordHasDefault: import("@angular/core").Signal<boolean>;
74
+ readonly supportsHyperlink: Signal<boolean>;
75
+ readonly textSubtype: Signal<NonNullable<import("@sdcorejs/angular/components/form-generic").SdFormGenericTextfieldSubtype | undefined> | null>;
76
+ readonly numberSubtype: Signal<SdFormGenericNumberSubtype | 'number' | null>;
77
+ readonly numberPrecision: Signal<number | undefined>;
78
+ readonly passwordHasDefault: Signal<boolean>;
71
79
  /** Regex không biên dịch được — renderer sẽ bỏ qua nó, nên báo ngay ở ô nhập. */
72
- readonly patternError: import("@angular/core").Signal<string | undefined>;
73
- readonly textKinds: import("@angular/core").Signal<Choice<string>[]>;
74
- readonly numberKinds: import("@angular/core").Signal<Choice<string>[]>;
75
- readonly phoneCountries: import("@angular/core").Signal<Choice<string>[]>;
80
+ readonly patternError: Signal<string | undefined>;
81
+ readonly textKinds: Signal<Choice<string>[]>;
82
+ readonly numberKinds: Signal<Choice<string>[]>;
83
+ readonly phoneCountries: Signal<Choice<string>[]>;
76
84
  readonly NONE = "__none__";
77
85
  readonly datetimeFormats: Choice[];
78
- readonly directions: import("@angular/core").Signal<Choice<string>[]>;
79
- readonly uploadTypes: import("@angular/core").Signal<Choice<string>[]>;
80
- readonly uploadSources: import("@angular/core").Signal<Choice<string>[]>;
81
- readonly booleanDefaults: import("@angular/core").Signal<Choice<string>[]>;
86
+ readonly directions: Signal<Choice<string>[]>;
87
+ readonly uploadTypes: Signal<Choice<string>[]>;
88
+ readonly uploadSources: Signal<Choice<string>[]>;
89
+ readonly booleanDefaults: Signal<Choice<string>[]>;
82
90
  /** Vùng chứa của field: cấp trang (NONE) hoặc một group — group không lồng nhau nên chỉ có hai cấp. */
83
- readonly containerChoices: import("@angular/core").Signal<Choice<string>[]>;
84
- readonly dateLimits: import("@angular/core").Signal<Choice<string>[]>;
91
+ readonly containerChoices: Signal<Choice<string>[]>;
92
+ readonly dateLimits: Signal<Choice<string>[]>;
85
93
  /**
86
94
  * Lựa chọn min/max của datetime. why: schema có thể mang một ngày ISO (renderer vẫn áp) — hiện nó như
87
95
  * một lựa chọn để thấy và bỏ được, thay vì hiện "Không" mà vẫn có ràng buộc.
88
96
  */
89
- readonly minDateChoices: import("@angular/core").Signal<Choice<string>[]>;
90
- readonly maxDateChoices: import("@angular/core").Signal<Choice<string>[]>;
97
+ readonly minDateChoices: Signal<Choice<string>[]>;
98
+ readonly maxDateChoices: Signal<Choice<string>[]>;
91
99
  dateLimitValue: (value: unknown) => string;
92
- readonly viewport: import("@angular/core").Signal<SdFormGenericBreakpoint>;
100
+ readonly viewport: Signal<SdFormGenericBreakpoint>;
93
101
  /** Span hiệu lực ở mức đang xem. */
94
- readonly span: import("@angular/core").Signal<number>;
95
- readonly spanSource: import("@angular/core").Signal<SdFormGenericSpanSource>;
102
+ readonly span: Signal<number>;
103
+ readonly spanSource: Signal<SdFormGenericSpanSource>;
96
104
  /** "Theo Desktop" (tablet) / "Mặc định" khi mức đang xem chưa tự khai báo span. */
97
- readonly inheritedLabel: import("@angular/core").Signal<string>;
105
+ readonly inheritedLabel: Signal<string>;
98
106
  /** Span của cả 3 mức — tóm tắt dưới ô span. */
99
- readonly spanLevels: import("@angular/core").Signal<SpanLevel[]>;
107
+ readonly spanLevels: Signal<SpanLevel[]>;
100
108
  /** "Desktop 6 · Tablet 6 (Theo Desktop) · Mobile 12 (Mặc định)". */
101
- readonly spanSummary: import("@angular/core").Signal<string>;
102
- readonly newRow: import("@angular/core").Signal<boolean>;
103
- readonly options: import("@angular/core").Signal<SdFormGenericOptions | null>;
104
- readonly staticItems: import("@angular/core").Signal<SdFormGenericOption[]>;
105
- readonly catalogId: import("@angular/core").Signal<string | null>;
106
- readonly catalog: import("@angular/core").Signal<import("@sdcorejs/angular/components/form-generic").SdFormGenericCatalog | undefined>;
107
- readonly optionSource: import("@angular/core").Signal<string>;
108
- readonly sourceChoices: import("@angular/core").Signal<Choice<string>[]>;
109
- readonly catalogParams: import("@angular/core").Signal<SdFormGenericParam[] | undefined>;
110
- readonly catalogFill: import("@angular/core").Signal<SdFormGenericFill[] | undefined>;
111
- readonly optionChoices: import("@angular/core").Signal<Choice<string>[]>;
109
+ readonly spanSummary: Signal<string>;
110
+ readonly newRow: Signal<boolean>;
111
+ readonly options: Signal<SdFormGenericOptions | null>;
112
+ readonly staticItems: Signal<SdFormGenericOption[]>;
113
+ readonly catalogId: Signal<string | null>;
114
+ readonly catalog: Signal<import("@sdcorejs/angular/components/form-generic").SdFormGenericCatalog | undefined>;
115
+ readonly optionSource: Signal<string>;
116
+ readonly sourceChoices: Signal<Choice<string>[]>;
117
+ readonly catalogParams: Signal<SdFormGenericParam[] | undefined>;
118
+ readonly catalogFill: Signal<SdFormGenericFill[] | undefined>;
119
+ readonly optionChoices: Signal<Choice<string>[]>;
112
120
  readonly htmlDefinitions: import("@angular/core").WritableSignal<SdFormGenericHtmlDefinition[]>;
113
- readonly htmlDefinitionChoices: import("@angular/core").Signal<Choice<string>[]>;
114
- readonly htmlDefinition: import("@angular/core").Signal<SdFormGenericHtmlDefinition | undefined>;
121
+ readonly htmlDefinitionChoices: Signal<Choice<string>[]>;
122
+ readonly htmlDefinition: Signal<SdFormGenericHtmlDefinition | undefined>;
115
123
  /** Biến của html definition đang chọn: giá trị của field, không có thì mặc định của definition. */
116
- readonly htmlVariables: import("@angular/core").Signal<{
124
+ readonly htmlVariables: Signal<{
117
125
  key: string;
118
126
  label: string;
119
127
  value: string;
120
128
  }[]>;
121
- readonly templates: import("@angular/core").Signal<SdFormGenericTemplate[]>;
122
- readonly templateChoices: import("@angular/core").Signal<Choice<string>[]>;
129
+ readonly templates: Signal<SdFormGenericTemplate[]>;
130
+ readonly templateChoices: Signal<Choice<string>[]>;
123
131
  /** Mẫu đang áp (nhận ra theo key của mẫu) — schema không lưu id mẫu. */
124
- readonly currentTemplate: import("@angular/core").Signal<string | null>;
132
+ readonly currentTemplate: Signal<string | null>;
125
133
  readonly keyDraft: import("@angular/core").WritableSignal<string>;
126
134
  readonly keyMessage: import("@angular/core").WritableSignal<string>;
127
- readonly keyError: import("@angular/core").Signal<string>;
135
+ readonly keyError: Signal<string>;
128
136
  /** Tham chiếu tới key của field đang chọn từ phần tử KHÁC (và validation cấp form). */
129
- readonly keyReferences: import("@angular/core").Signal<import("../../../rules/form-generic-references").SdFormGenericKeyReference[]>;
130
- readonly structuredReferences: import("@angular/core").Signal<number>;
131
- readonly textReferences: import("@angular/core").Signal<number>;
137
+ readonly keyReferences: Signal<import("../../../rules/form-generic-references").SdFormGenericKeyReference[]>;
138
+ readonly structuredReferences: Signal<number>;
139
+ readonly textReferences: Signal<number>;
132
140
  constructor();
133
141
  label: (key: string, params?: Record<string, string | number>) => string;
134
142
  selectTab(tab: InspectorTab): void;
@@ -1,4 +1,4 @@
1
- import type { SdFormGenericGroup, SdFormGenericVariable } from '../../../models/form-generic-schema.model';
1
+ import type { SdFormGenericGroup, SdFormGenericPage, SdFormGenericVariable } from '../../../models/form-generic-schema.model';
2
2
  import { BuilderDocument, BuilderItem, ContainerId } from './builder-document';
3
3
  import { DropIntent, DropResult, LayoutMode } from './builder-layout';
4
4
  /**
@@ -8,6 +8,8 @@ import { DropIntent, DropResult, LayoutMode } from './builder-layout';
8
8
  */
9
9
  /** Ý định chèn "hàng mới ở cuối vùng chứa". */
10
10
  export declare const endOf: (parentId: ContainerId) => DropIntent;
11
+ /** Clone a whole supported page, rewriting structured references only inside its ownership boundary. */
12
+ export declare const clonePage: (doc: BuilderDocument, source: SdFormGenericPage) => SdFormGenericPage | null;
11
13
  /** Ý định chèn "hàng mới ngay sau hàng chứa `id`". */
12
14
  export declare const rowAfter: (doc: BuilderDocument, id: string, mode: LayoutMode) => DropIntent | null;
13
15
  /**
@@ -8,7 +8,9 @@ export type ContainerId = string | null;
8
8
  * Nguồn schema chuẩn DUY NHẤT của builder. Được thay thế bất biến bởi các command — không component
9
9
  * nào sửa object bên trong. Selection, viewport, kéo-thả… là editor state, không nằm ở đây.
10
10
  *
11
- * `elements` là phần tử của trang đang thiết kế (đợt 1: trang đầu). `base` giữ phần còn lại của
11
+ * `elements` belongs to the edited page. `base.pagePosition` preserves its serialized position;
12
+ * `base` keeps the remaining schema data and pages.
13
+ * `base` giữ phần còn lại của
12
14
  * schema (thông tin trang, các trang khác, navigation, khoá lạ) để phát lại nguyên vẹn.
13
15
  */
14
16
  export interface BuilderDocument {
@@ -17,6 +19,8 @@ export interface BuilderDocument {
17
19
  readonly validations: readonly SdFormGenericValidation[];
18
20
  readonly base: {
19
21
  readonly page: Omit<SdFormGenericPage, 'elements'>;
22
+ /** Position of the edited page in serialized pages; editor selection never changes schema order. */
23
+ readonly pagePosition?: number;
20
24
  readonly otherPages: readonly SdFormGenericPage[];
21
25
  readonly rest: Readonly<Record<string, unknown>>;
22
26
  };
@@ -45,7 +49,7 @@ export declare const createId: () => string;
45
49
  * Nạp schema từ consumer. Chuẩn hoá (clone, cấp `id` còn thiếu) — KHÔNG mutate input, không bỏ
46
50
  * thuộc tính nào, phần tử type lạ được giữ nguyên.
47
51
  */
48
- export declare const documentFromSchema: (schema: SdFormGenericSchema | null | undefined) => BuilderDocument;
52
+ export declare const documentFromSchema: (schema: SdFormGenericSchema | null | undefined, activePageId?: string) => BuilderDocument;
49
53
  /** Snapshot công khai: bản clone độc lập. Mảng rỗng của biến/validation không được ghi. */
50
54
  export declare const documentToSchema: (doc: BuilderDocument) => SdFormGenericSchema;
51
55
  /** Hai tài liệu có cùng nội dung schema không (không phụ thuộc thứ tự khoá). */
@@ -1,5 +1,6 @@
1
1
  import { Subject } from 'rxjs';
2
- import type { SdFormGenericValidation, SdFormGenericVariable } from '../../../models/form-generic-schema.model';
2
+ import type { SdFormGenericNavigation, SdFormGenericPage, SdFormGenericValidation, SdFormGenericVariable, SdFormGenericVisibilityRules } from '../../../models/form-generic-schema.model';
3
+ import type { Filter } from '@sdcorejs/utils/models';
3
4
  import { type SdFormGenericKeyReference } from '../../../rules/form-generic-references';
4
5
  import { VariableEdit } from './builder-commands';
5
6
  import { BuilderDocument, BuilderItem, ContainerId, ItemLocation } from './builder-document';
@@ -34,6 +35,11 @@ export interface CommitOptions {
34
35
  export declare class FormBuilderStore {
35
36
  #private;
36
37
  readonly doc: import("@angular/core").WritableSignal<BuilderDocument>;
38
+ readonly pages: import("@angular/core").Signal<SdFormGenericPage[]>;
39
+ readonly activePage: import("@angular/core").Signal<Omit<SdFormGenericPage, "elements">>;
40
+ readonly allElements: import("@angular/core").Signal<import("@sdcorejs/angular/components/form-generic").SdFormGenericPageElement[]>;
41
+ readonly navigation: import("@angular/core").Signal<SdFormGenericNavigation | undefined>;
42
+ readonly canDuplicatePage: import("@angular/core").Signal<boolean>;
37
43
  readonly selectedId: import("@angular/core").WritableSignal<string | null>;
38
44
  readonly mode: import("@angular/core").WritableSignal<BuilderMode>;
39
45
  readonly viewport: import("@angular/core").WritableSignal<import("@sdcorejs/angular/components/form-generic").SdFormGenericBreakpoint>;
@@ -76,6 +82,17 @@ export declare class FormBuilderStore {
76
82
  requestFocus(id: string | null): void;
77
83
  announce(message: string): void;
78
84
  select(id: string | null): void;
85
+ /** Editor page selection is transient: preserve schema order, values and undo history. */
86
+ selectPage(id: string): void;
87
+ addPage(): void;
88
+ duplicatePage(): string | null;
89
+ removePage(id: string): boolean;
90
+ movePage(id: string, delta: -1 | 1): boolean;
91
+ setPageMetadata(patch: Partial<Pick<SdFormGenericPage, 'label' | 'icon' | 'rules'>>, coalesceKey?: string): boolean;
92
+ setPageRule(key: keyof SdFormGenericVisibilityRules, filter: Filter | undefined): boolean;
93
+ setNavigation(mode: 'single' | 'tabs' | 'steps'): boolean;
94
+ setLinear(linear: boolean): boolean;
95
+ pageDependentsOf(id: string): SdFormGenericKeyReference[];
79
96
  setMode(mode: BuilderMode): void;
80
97
  toggleCollapsed(groupId: string, collapsed?: boolean): void;
81
98
  /** Mở group chứa phần tử (khi chọn từ tab Cấu trúc). */
@@ -1,3 +1,4 @@
1
+ import type { Signal } from '@angular/core';
1
2
  import { FormGroup } from '@angular/forms';
2
3
  import type { SdFormGenericDatetime } from '../../../../../../models/form-generic-field.model';
3
4
  import * as i0 from "@angular/core";
@@ -7,12 +8,12 @@ export declare class DatetimeComponent {
7
8
  readonly form: import("@angular/core").InputSignal<FormGroup<any>>;
8
9
  readonly disabled: import("@angular/core").InputSignal<boolean>;
9
10
  readonly required: import("@angular/core").InputSignal<boolean>;
10
- readonly labelPlacement: import("@angular/core").Signal<import("@sdcorejs/angular/forms").SdLabelPlacement>;
11
- readonly viewed: import("@angular/core").Signal<boolean>;
12
- readonly value: import("@angular/core").Signal<string | null | undefined>;
13
- readonly subtype: import("@angular/core").Signal<"datetime" | "date">;
14
- readonly min: import("@angular/core").Signal<string | undefined>;
15
- readonly max: import("@angular/core").Signal<string | undefined>;
11
+ readonly labelPlacement: Signal<import("@sdcorejs/angular/forms").SdLabelPlacement>;
12
+ readonly viewed: Signal<boolean>;
13
+ readonly value: Signal<string | null | undefined>;
14
+ readonly subtype: Signal<NonNullable<SdFormGenericDatetime['subtype']>>;
15
+ readonly min: Signal<string | undefined>;
16
+ readonly max: Signal<string | undefined>;
16
17
  setValue(value: unknown): void;
17
18
  static ɵfac: i0.ɵɵFactoryDeclaration<DatetimeComponent, never>;
18
19
  static ɵcmp: i0.ɵɵComponentDeclaration<DatetimeComponent, "lib-datetime", never, { "field": { "alias": "field"; "required": true; "isSignal": true; }; "form": { "alias": "form"; "required": true; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -1,4 +1,4 @@
1
- import { FormGroup } from '@angular/forms';
1
+ import { AbstractControl, FormGroup } from '@angular/forms';
2
2
  import type { SdFormGenericField } from '../../../../models/form-generic-field.model';
3
3
  import type { SdFormGenericElementState } from '../../../../rules/form-generic-filter';
4
4
  import * as i0 from "@angular/core";
@@ -8,6 +8,8 @@ export declare class LibItemComponent {
8
8
  readonly field: import("@angular/core").InputSignal<SdFormGenericField>;
9
9
  readonly state: import("@angular/core").InputSignal<SdFormGenericElementState>;
10
10
  readonly form: import("@angular/core").InputSignal<FormGroup<any>>;
11
+ readonly registrationForm: import("@angular/core").Signal<FormGroup<any>>;
12
+ registeredControl(): AbstractControl | null;
11
13
  /**
12
14
  * Bắt buộc có hiệu lực. why: field chỉ xem không được validate — người dùng không sửa được nó, và
13
15
  * control của nó (có hoặc không, tuỳ type) không được làm `validate()` lỗi mà không hiện gì.
@@ -3,7 +3,7 @@ import type { SdLabelPlacement } from '@sdcorejs/angular/forms/models';
3
3
  import type { SdFormGenericBreakpoint } from '../../configurations/form-generic-breakpoints';
4
4
  import { type SdFormGenericLayoutRow } from '../../layout/form-generic-layout';
5
5
  import type { SdFormGenericField, SdFormGenericLayout } from '../../models/form-generic-field.model';
6
- import type { SdFormGenericGroup, SdFormGenericSchema } from '../../models/form-generic-schema.model';
6
+ import type { SdFormGenericGroup, SdFormGenericPage, SdFormGenericSchema } from '../../models/form-generic-schema.model';
7
7
  import { type SdFormGenericElementState } from '../../rules/form-generic-filter';
8
8
  import { type SdFormGenericValidationResult } from '../../rules/form-generic-validation';
9
9
  import * as i0 from "@angular/core";
@@ -59,14 +59,31 @@ export declare class SdFormRender {
59
59
  readonly labelPlacement: import("@angular/core").InputSignal<SdLabelPlacement>;
60
60
  /** Chỉ render field có key trong danh sách; `null` = mọi field. */
61
61
  readonly keys: import("@angular/core").InputSignal<readonly string[] | null>;
62
+ /** Active visible page. Consumer forward writes use the same linear gate as Next/header clicks. */
63
+ readonly activePageId: import("@angular/core").ModelSignal<string | null>;
64
+ /** A forward transition is waiting for predecessor validators; backward navigation remains available. */
65
+ readonly navigationPending: import("@angular/core").WritableSignal<boolean>;
66
+ protected readonly navigationTip: import("@angular/core").WritableSignal<boolean>;
67
+ readonly effectivePageId: import("@angular/core").WritableSignal<string | null>;
68
+ readonly focusedPageId: import("@angular/core").WritableSignal<string | null>;
62
69
  private readonly grid;
63
70
  private readonly items;
64
- readonly formGroup: import("@angular/core").Signal<FormGroup<any> | FormGroup<{}>>;
71
+ private readonly pageTabs;
72
+ private readonly pageStepper;
73
+ readonly formGroup: import("@angular/core").Signal<FormGroup<any>>;
65
74
  readonly normalized: import("@angular/core").Signal<SdFormGenericSchema>;
66
75
  readonly scope: import("@angular/core").Signal<Readonly<Record<string, unknown>>>;
67
76
  /** Mức bố cục hiện hành. */
68
77
  readonly level: import("@angular/core").Signal<SdFormGenericBreakpoint>;
69
- /** Hàng của trang đang hiện (đợt 1: một trang). */
78
+ readonly navigation: import("@angular/core").Signal<import("@sdcorejs/angular/components/form-generic").SdFormGenericNavigation | undefined>;
79
+ readonly visiblePages: import("@angular/core").Signal<SdFormGenericPage[]>;
80
+ readonly activeIndex: import("@angular/core").Signal<number>;
81
+ /** Eager page regions retain visible controls even before a page is visited. */
82
+ readonly pageRegions: import("@angular/core").Signal<{
83
+ page: SdFormGenericPage;
84
+ cells: RenderCell[];
85
+ }[]>;
86
+ /** Legacy first-page layout; navigation regions each pack their own page. */
70
87
  readonly rows: import("@angular/core").Signal<SdFormGenericLayoutRow<RenderNode>[]>;
71
88
  /** Ô của lưới theo thứ tự tài liệu (DOM phẳng, vị trí từ `rows`). */
72
89
  readonly cells: import("@angular/core").Signal<RenderCell[]>;
@@ -76,9 +93,19 @@ export declare class SdFormRender {
76
93
  * Luôn trả `{ valid, messages: { error, warning } }`; chỉ lỗi làm `valid = false`.
77
94
  */
78
95
  validate(): Promise<SdFormGenericValidationResult>;
96
+ t: (key: string, params?: Record<string, string | number>) => string;
97
+ pageLabel(page: SdFormGenericPage): string;
98
+ pageDomId(pageId: string, part: 'tab' | 'panel'): string;
99
+ protected onCorePageChange(index: number): void;
100
+ protected onCorePageFocus(event: FocusEvent): void;
101
+ /** Shared navigation gate for consumer model writes, page headers and Next. */
102
+ requestPage(pageId: string): Promise<void>;
103
+ previous(): void;
104
+ next(): void;
105
+ onPageKeydown(event: KeyboardEvent, pageId: string): void;
79
106
  /** Tải lên các tệp đang chờ của mọi field upload; kết quả được ghi vào value. Gọi trước khi lưu. */
80
107
  upload(): Promise<void>;
81
108
  static ɵfac: i0.ɵɵFactoryDeclaration<SdFormRender, never>;
82
- static ɵcmp: i0.ɵɵComponentDeclaration<SdFormRender, "sd-form-render", never, { "schema": { "alias": "schema"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; "variables": { "alias": "variables"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "breakpoint": { "alias": "breakpoint"; "required": false; "isSignal": true; }; "labelPlacement": { "alias": "labelPlacement"; "required": false; "isSignal": true; }; "keys": { "alias": "keys"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
109
+ static ɵcmp: i0.ɵɵComponentDeclaration<SdFormRender, "sd-form-render", never, { "schema": { "alias": "schema"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; "variables": { "alias": "variables"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "breakpoint": { "alias": "breakpoint"; "required": false; "isSignal": true; }; "labelPlacement": { "alias": "labelPlacement"; "required": false; "isSignal": true; }; "keys": { "alias": "keys"; "required": false; "isSignal": true; }; "activePageId": { "alias": "activePageId"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "activePageId": "activePageIdChange"; }, never, never, true, never>;
83
110
  }
84
111
  export {};
@@ -8,13 +8,14 @@ import type { SdFormGenericField } from './form-generic-field.model';
8
8
  */
9
9
  export interface SdFormGenericSchema {
10
10
  pages: SdFormGenericPage[];
11
- /** Chừa cho tabs/steps (đợt 3). Vắng = một trang. */
11
+ /** Tabs or steps across visible pages. Absent preserves first-page rendering. */
12
12
  navigation?: SdFormGenericNavigation;
13
13
  /** Biến do consumer cấp qua `[variables]`; dùng chung không gian key với field. */
14
14
  variables?: SdFormGenericVariable[];
15
15
  /** Validation cấp form, chạy trong `validate()`. */
16
16
  validations?: SdFormGenericValidation[];
17
17
  }
18
+ /** Steps default to `linear: false`; linear forward navigation validates visible predecessor fields. */
18
19
  export type SdFormGenericNavigation = {
19
20
  type: 'tabs';
20
21
  } | {
@@ -36,5 +36,6 @@ export * from '@sdcorejs/angular/components/operator';
36
36
  export * from '@sdcorejs/angular/components/stepper';
37
37
  export * from '@sdcorejs/angular/components/tab';
38
38
  export * from '@sdcorejs/angular/components/file-explorer';
39
+ export * from '@sdcorejs/angular/components/kanban';
39
40
  export * from '@sdcorejs/angular/components/image-editor';
40
41
  export * from '@sdcorejs/angular/components/highlight';
@@ -0,0 +1,3 @@
1
+ export * from './src/kanban.component';
2
+ export * from './src/kanban.model';
3
+ export * from './src/kanban.templates';