@sdcorejs/angular 19.3.2 → 19.3.3
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.
- package/assets/THEME.md +58 -6
- package/assets/scss/core/form.scss +291 -3
- package/assets/scss/themes/_component-tokens.scss +35 -6
- package/components/badge/index.d.ts +1 -0
- package/components/badge/src/badge.model.d.ts +19 -0
- package/components/section/index.d.ts +1 -0
- package/components/section/src/section-registry.d.ts +11 -0
- package/components/splitter/index.d.ts +1 -1
- package/components/tab-router/src/actions/tab-router.action.d.ts +1 -1
- package/components/tab-router/src/components/tab-router-item/tab-router-item.component.d.ts +4 -2
- package/components/tab-router/src/components/tab-router-nav/tab-router-nav.component.d.ts +31 -3
- package/components/tab-router/src/components/tab-router-outlet/tab-router-outlet.component.d.ts +6 -1
- package/components/tab-router/src/models/tab-router.model.d.ts +5 -0
- package/components/tab-router/src/pipes/tab-info.pipe.d.ts +7 -0
- package/components/tab-router/src/services/tab-router.service.d.ts +5 -0
- package/components/table/index.d.ts +2 -0
- package/components/table/src/components/filter/external-filter/external-filter.component.d.ts +5 -1
- package/components/table/src/components/mobile-cards/mobile-cards.component.d.ts +4 -0
- package/components/table/src/configurations/index.d.ts +1 -0
- package/components/table/src/configurations/table-layout.d.ts +16 -0
- package/components/table/src/configurations/table.configuration.d.ts +3 -1
- package/components/table/src/models/index.d.ts +1 -0
- package/components/table/src/models/table-column.model.d.ts +3 -10
- package/components/table/src/models/table-item.model.d.ts +4 -1
- package/components/table/src/models/table-option-loading.model.d.ts +42 -0
- package/components/table/src/models/table-option.model.d.ts +6 -0
- package/components/table/src/services/table-filter/table-filter.model.d.ts +5 -0
- package/components/table/src/services/table-loading/table-loading.util.d.ts +91 -0
- package/components/table/src/services/tree/tree.util.d.ts +2 -0
- package/components/table/src/table.component.d.ts +23 -0
- package/components/upload-file/src/components/file-type-icon/file-type-icon.component.d.ts +15 -0
- package/components/upload-file/src/components/preview/preview.component.d.ts +88 -10
- package/components/upload-file/src/configurations/upload-file.configuration.d.ts +1 -1
- package/components/upload-file/src/helpers/file-type.d.ts +25 -0
- package/components/upload-file/src/pipes/file-meta.pipe.d.ts +9 -0
- package/components/upload-file/src/pipes/file-reason.pipe.d.ts +11 -0
- package/components/upload-file/src/pipes/index.d.ts +2 -0
- package/components/upload-file/src/upload-file.component.d.ts +89 -8
- package/fesm2022/sdcorejs-angular-components-badge.mjs +2 -2
- package/fesm2022/sdcorejs-angular-components-badge.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-form-generic.mjs +3 -3
- package/fesm2022/sdcorejs-angular-components-form-generic.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-section.mjs +15 -3
- package/fesm2022/sdcorejs-angular-components-section.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-side-drawer.mjs +2 -2
- package/fesm2022/sdcorejs-angular-components-side-drawer.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-splitter.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-tab-router.mjs +390 -75
- package/fesm2022/sdcorejs-angular-components-tab-router.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-table.mjs +443 -15
- package/fesm2022/sdcorejs-angular-components-table.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-upload-file.mjs +886 -173
- package/fesm2022/sdcorejs-angular-components-upload-file.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs +7 -2
- package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs +5 -2
- package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-chip.mjs +421 -121
- package/fesm2022/sdcorejs-angular-forms-chip.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-date-range.mjs +4 -0
- package/fesm2022/sdcorejs-angular-forms-date-range.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-date.mjs +4 -0
- package/fesm2022/sdcorejs-angular-forms-date.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-datetime.mjs +4 -0
- package/fesm2022/sdcorejs-angular-forms-datetime.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-input-number.mjs +17 -2
- package/fesm2022/sdcorejs-angular-forms-input-number.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-input.mjs +4 -0
- package/fesm2022/sdcorejs-angular-forms-input.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-select.mjs +26 -20
- package/fesm2022/sdcorejs-angular-forms-select.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-textarea.mjs +14 -1
- package/fesm2022/sdcorejs-angular-forms-textarea.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-i18n.mjs +210 -0
- package/fesm2022/sdcorejs-angular-i18n.mjs.map +1 -1
- package/fesm2022/{sdcorejs-angular-modules-generic-generic-configuration.page-BFxO3eHX.mjs → sdcorejs-angular-modules-generic-generic-configuration.page-Bk3PrEf3.mjs} +3 -3
- package/fesm2022/{sdcorejs-angular-modules-generic-generic-configuration.page-BFxO3eHX.mjs.map → sdcorejs-angular-modules-generic-generic-configuration.page-Bk3PrEf3.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-generic-generic-form-host.page-Csy2fShj.mjs → sdcorejs-angular-modules-generic-generic-form-host.page-CwUegGgG.mjs} +3 -3
- package/fesm2022/{sdcorejs-angular-modules-generic-generic-form-host.page-Csy2fShj.mjs.map → sdcorejs-angular-modules-generic-generic-form-host.page-CwUegGgG.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-generic-generic-list.page-BIIxNR6k.mjs → sdcorejs-angular-modules-generic-generic-list.page-lF2trhfp.mjs} +3 -3
- package/fesm2022/{sdcorejs-angular-modules-generic-generic-list.page-BIIxNR6k.mjs.map → sdcorejs-angular-modules-generic-generic-list.page-lF2trhfp.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-DjDsau9C.mjs → sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-BbmeOduc.mjs} +4 -4
- package/fesm2022/{sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-DjDsau9C.mjs.map → sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-BbmeOduc.mjs.map} +1 -1
- package/fesm2022/sdcorejs-angular-modules-generic.mjs +1 -1
- package/fesm2022/sdcorejs-angular-modules-layout.mjs +265 -10
- package/fesm2022/sdcorejs-angular-modules-layout.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-api-error-BBWwQ6h2.mjs +23 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-api-error-BBWwQ6h2.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-approval-inbox-BMwD6_FC.mjs +16 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-approval-inbox-BMwD6_FC.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-base-api.service-CVEKaR8U.mjs +51 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-base-api.service-CVEKaR8U.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-BqHybMk0.mjs +130 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-BqHybMk0.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-CND3d2zl.mjs +131 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-CND3d2zl.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-create.component-BbDoQccI.mjs +99 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-create.component-BbDoQccI.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-create.component-CB_wJIP8.mjs +460 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-create.component-CB_wJIP8.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-create.component-DlP4BrhU.mjs +118 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-create.component-DlP4BrhU.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-customer.model-C3fr4yNw.mjs +18 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-customer.model-C3fr4yNw.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-customer.service-VAMePx_q.mjs +66 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-customer.service-VAMePx_q.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-detail-side-drawer.component-BD79VR0c.mjs +148 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-detail-side-drawer.component-BD79VR0c.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-B1rFhbOc.mjs +172 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-B1rFhbOc.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-BhCjw6ZL.mjs +467 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-BhCjw6ZL.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-CnL2FzCx.mjs +90 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-CnL2FzCx.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-flow.component-BeH-NYvE.mjs +514 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-flow.component-BeH-NYvE.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-form-api-errors-DpnYSG2j.mjs +61 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-form-api-errors-DpnYSG2j.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-1bi0JZdf.mjs +170 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-1bi0JZdf.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-D6eKR2cq.mjs +87 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-D6eKR2cq.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-FcJS3Nbd.mjs +232 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-FcJS3Nbd.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-general-information-view.component-BA-3FR1J.mjs +70 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-general-information-view.component-BA-3FR1J.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-index.component-BAZLCVci.mjs +100 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-index.component-BAZLCVci.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-lines-form.component-ikk0cK1M.mjs +522 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-lines-form.component-ikk0cK1M.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-Cex41xzy.mjs +164 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-Cex41xzy.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-D643jEmo.mjs +629 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-D643jEmo.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-DTWHhNNl.mjs +71 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-DTWHhNNl.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-YJUJsrIZ.mjs +115 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-YJUJsrIZ.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-qH-YO6wP.mjs +118 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-qH-YO6wP.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-mock-backend.factory-S0Vuy6Oc.mjs +1069 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-mock-backend.factory-S0Vuy6Oc.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-BpLQaYP5.mjs +186 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-BpLQaYP5.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-BrejHvB2.mjs +97 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-BrejHvB2.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-product.model-BoHLJ8vf.mjs +12 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-product.model-BoHLJ8vf.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-product.service-Ba73HPGG.mjs +48 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-product.service-Ba73HPGG.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-profile.component-CBlN7eEn.mjs +295 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-profile.component-CBlN7eEn.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-BvzFafUW.mjs +74 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-BvzFafUW.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-C3uWi8JZ.mjs +165 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-C3uWi8JZ.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-C5ELCTEw.mjs +74 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-C5ELCTEw.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-ClQwnO4h.mjs +50 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-ClQwnO4h.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-DTUxYZ6g.mjs +66 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-DTUxYZ6g.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-DpCuYBlL.mjs +99 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-DpCuYBlL.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-DwZWxmJf.mjs +45 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-DwZWxmJf.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-ydOZduls.mjs +43 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-ydOZduls.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-D3B5I9hg.mjs +406 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-D3B5I9hg.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-shell.component-BW-i6BHg.mjs +317 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-shell.component-BW-i6BHg.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-By1mYFa_.mjs +132 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-By1mYFa_.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-DwcyKb4j.mjs +143 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-DwcyKb4j.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-update.component-BBR8360C.mjs +100 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-update.component-BBR8360C.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-update.component-CAtqPgIH.mjs +357 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-update.component-CAtqPgIH.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-update.component-DjMChf6s.mjs +128 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-update.component-DjMChf6s.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern.mjs +2 -0
- package/fesm2022/sdcorejs-angular-modules-pattern.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-services-unsaved-changes.mjs +104 -4
- package/fesm2022/sdcorejs-angular-services-unsaved-changes.mjs.map +1 -1
- package/forms/chip/src/chip.component.d.ts +135 -19
- package/forms/chip/src/index.d.ts +0 -1
- package/i18n/src/en.d.ts +42 -0
- package/modules/layout/components/index.d.ts +2 -0
- package/modules/layout/components/page/page-form-leave.guard.d.ts +9 -0
- package/modules/layout/components/page/page.component.d.ts +38 -2
- package/modules/layout/components/page-list/page-list.component.d.ts +42 -0
- package/modules/layout/components/shared/context-switcher/context-switcher.component.d.ts +1 -1
- package/modules/pattern/README.md +76 -0
- package/modules/pattern/configurations/pattern.configuration.d.ts +30 -0
- package/modules/pattern/configurations/provide-sd-patterns.d.ts +19 -0
- package/modules/pattern/core/mock-api/mock-api.interceptor.d.ts +8 -0
- package/modules/pattern/core/mock-api/mock-api.model.d.ts +62 -0
- package/modules/pattern/core/mock-api/mock-api.state.d.ts +36 -0
- package/modules/pattern/core/mock-api/mock-backend.d.ts +18 -0
- package/modules/pattern/core/mock-api/mock-backend.factory.d.ts +3 -0
- package/modules/pattern/core/mock-api/prng.d.ts +4 -0
- package/modules/pattern/core/mock-api/resources/approval.resource.d.ts +14 -0
- package/modules/pattern/core/mock-api/resources/category.resource.d.ts +9 -0
- package/modules/pattern/core/mock-api/resources/customer.resource.d.ts +22 -0
- package/modules/pattern/core/mock-api/resources/index.d.ts +3 -0
- package/modules/pattern/core/mock-api/resources/names.d.ts +5 -0
- package/modules/pattern/core/mock-api/resources/order.resource.d.ts +44 -0
- package/modules/pattern/core/mock-api/resources/partner.resource.d.ts +16 -0
- package/modules/pattern/core/mock-api/resources/product.resource.d.ts +13 -0
- package/modules/pattern/core/mock-api/resources/settings.resource.d.ts +18 -0
- package/modules/pattern/core/pattern-shell/catalog/pattern-catalog.d.ts +22 -0
- package/modules/pattern/core/pattern-shell/index/index.component.d.ts +9 -0
- package/modules/pattern/core/pattern-shell/settings/pattern-settings.store.d.ts +57 -0
- package/modules/pattern/core/pattern-shell/settings/settings-button.component.d.ts +44 -0
- package/modules/pattern/core/pattern-shell/shell/pattern-source-viewer.d.ts +8 -0
- package/modules/pattern/core/pattern-shell/shell/shell.component.d.ts +13 -0
- package/modules/pattern/core/pattern-shell/source/pattern-source.generated.d.ts +1 -0
- package/modules/pattern/core/pattern-shell/source/source-drawer.component.d.ts +27 -0
- package/modules/pattern/core/pattern-shell/toolbar/toolbar.component.d.ts +24 -0
- package/modules/pattern/core/permission/pattern-permission.d.ts +15 -0
- package/modules/pattern/core/permission/pattern-role.store.d.ts +13 -0
- package/modules/pattern/core/session-state.d.ts +4 -0
- package/modules/pattern/docs/detail.md +237 -0
- package/modules/pattern/docs/drawer.md +484 -0
- package/modules/pattern/docs/flow.md +631 -0
- package/modules/pattern/docs/form.md +518 -0
- package/modules/pattern/docs/header-actions.md +342 -0
- package/modules/pattern/docs/list.md +247 -0
- package/modules/pattern/docs/relation.md +180 -0
- package/modules/pattern/docs/select.md +206 -0
- package/modules/pattern/docs/split.md +350 -0
- package/modules/pattern/docs/states.md +168 -0
- package/modules/pattern/features/approval/entity.resolver.d.ts +4 -0
- package/modules/pattern/features/approval/entity.resolver.ts +21 -0
- package/modules/pattern/features/approval/pages/detail/detail.component.d.ts +13 -0
- package/modules/pattern/features/approval/pages/detail/detail.component.ts +139 -0
- package/modules/pattern/features/approval/pages/list/approval-inbox.d.ts +7 -0
- package/modules/pattern/features/approval/pages/list/approval-inbox.ts +7 -0
- package/modules/pattern/features/approval/pages/list/list.component.d.ts +26 -0
- package/modules/pattern/features/approval/pages/list/list.component.html +20 -0
- package/modules/pattern/features/approval/pages/list/list.component.ts +149 -0
- package/modules/pattern/features/approval/routes.d.ts +3 -0
- package/modules/pattern/features/approval/routes.ts +30 -0
- package/modules/pattern/features/approval/services/approval.model.d.ts +37 -0
- package/modules/pattern/features/approval/services/approval.model.ts +38 -0
- package/modules/pattern/features/approval/services/approval.service.d.ts +12 -0
- package/modules/pattern/features/approval/services/approval.service.ts +23 -0
- package/modules/pattern/features/category/components/create-side-drawer/create-side-drawer.component.d.ts +23 -0
- package/modules/pattern/features/category/components/create-side-drawer/create-side-drawer.component.ts +123 -0
- package/modules/pattern/features/category/components/general-information-form/general-information-form.component.d.ts +20 -0
- package/modules/pattern/features/category/components/general-information-form/general-information-form.component.ts +61 -0
- package/modules/pattern/features/category/components/update-side-drawer/update-side-drawer.component.d.ts +23 -0
- package/modules/pattern/features/category/components/update-side-drawer/update-side-drawer.component.ts +134 -0
- package/modules/pattern/features/category/entity.resolver.d.ts +6 -0
- package/modules/pattern/features/category/entity.resolver.ts +27 -0
- package/modules/pattern/features/category/pages/list/list.component.d.ts +17 -0
- package/modules/pattern/features/category/pages/list/list.component.html +20 -0
- package/modules/pattern/features/category/pages/list/list.component.ts +105 -0
- package/modules/pattern/features/category/routes.d.ts +3 -0
- package/modules/pattern/features/category/routes.ts +42 -0
- package/modules/pattern/features/category/services/category.model.d.ts +34 -0
- package/modules/pattern/features/category/services/category.model.ts +39 -0
- package/modules/pattern/features/category/services/category.service.d.ts +17 -0
- package/modules/pattern/features/category/services/category.service.ts +36 -0
- package/modules/pattern/features/customer/components/create-side-drawer/create-side-drawer.component.d.ts +24 -0
- package/modules/pattern/features/customer/components/create-side-drawer/create-side-drawer.component.ts +131 -0
- package/modules/pattern/features/customer/components/customer-select/customer-select.component.d.ts +20 -0
- package/modules/pattern/features/customer/components/customer-select/customer-select.component.ts +72 -0
- package/modules/pattern/features/customer/components/customer-type-select/customer-type-select.component.d.ts +20 -0
- package/modules/pattern/features/customer/components/customer-type-select/customer-type-select.component.ts +30 -0
- package/modules/pattern/features/customer/components/debts-view/debts-view.component.d.ts +11 -0
- package/modules/pattern/features/customer/components/debts-view/debts-view.component.ts +28 -0
- package/modules/pattern/features/customer/components/detail-side-drawer/detail-side-drawer.component.d.ts +20 -0
- package/modules/pattern/features/customer/components/detail-side-drawer/detail-side-drawer.component.ts +106 -0
- package/modules/pattern/features/customer/components/documents-view/documents-view.component.d.ts +14 -0
- package/modules/pattern/features/customer/components/documents-view/documents-view.component.ts +50 -0
- package/modules/pattern/features/customer/components/general-information-form/general-information-form.component.d.ts +33 -0
- package/modules/pattern/features/customer/components/general-information-form/general-information-form.component.ts +140 -0
- package/modules/pattern/features/customer/components/general-information-view/general-information-view.component.d.ts +9 -0
- package/modules/pattern/features/customer/components/general-information-view/general-information-view.component.ts +39 -0
- package/modules/pattern/features/customer/components/orders-view/orders-view.component.d.ts +11 -0
- package/modules/pattern/features/customer/components/orders-view/orders-view.component.ts +35 -0
- package/modules/pattern/features/customer/components/summary-cards/summary-cards.component.d.ts +22 -0
- package/modules/pattern/features/customer/components/summary-cards/summary-cards.component.ts +101 -0
- package/modules/pattern/features/customer/components/update-side-drawer/update-side-drawer.component.d.ts +24 -0
- package/modules/pattern/features/customer/components/update-side-drawer/update-side-drawer.component.ts +127 -0
- package/modules/pattern/features/customer/entity.resolver.d.ts +4 -0
- package/modules/pattern/features/customer/entity.resolver.ts +21 -0
- package/modules/pattern/features/customer/pages/list/list.component.d.ts +19 -0
- package/modules/pattern/features/customer/pages/list/list.component.html +22 -0
- package/modules/pattern/features/customer/pages/list/list.component.ts +113 -0
- package/modules/pattern/features/customer/pages/profile/profile.component.d.ts +31 -0
- package/modules/pattern/features/customer/pages/profile/profile.component.ts +120 -0
- package/modules/pattern/features/customer/pipes/customer-detail.pipe.d.ts +14 -0
- package/modules/pattern/features/customer/pipes/customer-detail.pipe.ts +18 -0
- package/modules/pattern/features/customer/routes.d.ts +6 -0
- package/modules/pattern/features/customer/routes.ts +59 -0
- package/modules/pattern/features/customer/services/customer.model.d.ts +77 -0
- package/modules/pattern/features/customer/services/customer.model.ts +87 -0
- package/modules/pattern/features/customer/services/customer.service.d.ts +24 -0
- package/modules/pattern/features/customer/services/customer.service.ts +79 -0
- package/modules/pattern/features/import/components/mapping-form/mapping-form.component.d.ts +21 -0
- package/modules/pattern/features/import/components/mapping-form/mapping-form.component.ts +41 -0
- package/modules/pattern/features/import/components/preview-view/preview-view.component.d.ts +10 -0
- package/modules/pattern/features/import/components/preview-view/preview-view.component.ts +44 -0
- package/modules/pattern/features/import/pages/flow/flow.component.d.ts +43 -0
- package/modules/pattern/features/import/pages/flow/flow.component.ts +269 -0
- package/modules/pattern/features/import/routes.d.ts +2 -0
- package/modules/pattern/features/import/routes.ts +19 -0
- package/modules/pattern/features/import/services/import.model.d.ts +38 -0
- package/modules/pattern/features/import/services/import.model.ts +82 -0
- package/modules/pattern/features/import/services/import.service.d.ts +15 -0
- package/modules/pattern/features/import/services/import.service.ts +18 -0
- package/modules/pattern/features/order/components/approval-steps/approval-steps.component.d.ts +9 -0
- package/modules/pattern/features/order/components/approval-steps/approval-steps.component.ts +74 -0
- package/modules/pattern/features/order/components/bulk-result/bulk-result.component.d.ts +22 -0
- package/modules/pattern/features/order/components/bulk-result/bulk-result.component.ts +46 -0
- package/modules/pattern/features/order/components/general-information-form/general-information-form.component.d.ts +30 -0
- package/modules/pattern/features/order/components/general-information-form/general-information-form.component.ts +96 -0
- package/modules/pattern/features/order/components/lines-form/lines-form.component.d.ts +33 -0
- package/modules/pattern/features/order/components/lines-form/lines-form.component.ts +205 -0
- package/modules/pattern/features/order/components/lines-view/lines-view.component.d.ts +12 -0
- package/modules/pattern/features/order/components/lines-view/lines-view.component.ts +42 -0
- package/modules/pattern/features/order/components/summary-cards/summary-cards.component.d.ts +25 -0
- package/modules/pattern/features/order/components/summary-cards/summary-cards.component.ts +128 -0
- package/modules/pattern/features/order/entity.resolver.d.ts +9 -0
- package/modules/pattern/features/order/entity.resolver.ts +37 -0
- package/modules/pattern/features/order/pages/create/create.component.d.ts +16 -0
- package/modules/pattern/features/order/pages/create/create.component.ts +99 -0
- package/modules/pattern/features/order/pages/detail/detail.component.d.ts +26 -0
- package/modules/pattern/features/order/pages/detail/detail.component.ts +222 -0
- package/modules/pattern/features/order/pages/list/list.component.d.ts +29 -0
- package/modules/pattern/features/order/pages/list/list.component.html +38 -0
- package/modules/pattern/features/order/pages/list/list.component.ts +291 -0
- package/modules/pattern/features/order/pages/update/update.component.d.ts +20 -0
- package/modules/pattern/features/order/pages/update/update.component.ts +119 -0
- package/modules/pattern/features/order/routes.d.ts +7 -0
- package/modules/pattern/features/order/routes.ts +54 -0
- package/modules/pattern/features/order/services/order.model.d.ts +106 -0
- package/modules/pattern/features/order/services/order.model.ts +109 -0
- package/modules/pattern/features/order/services/order.service.d.ts +25 -0
- package/modules/pattern/features/order/services/order.service.ts +63 -0
- package/modules/pattern/features/partner/pages/create/create.component.d.ts +41 -0
- package/modules/pattern/features/partner/pages/create/create.component.ts +324 -0
- package/modules/pattern/features/partner/routes.d.ts +2 -0
- package/modules/pattern/features/partner/routes.ts +20 -0
- package/modules/pattern/features/partner/services/partner.model.d.ts +30 -0
- package/modules/pattern/features/partner/services/partner.model.ts +30 -0
- package/modules/pattern/features/partner/services/partner.service.d.ts +13 -0
- package/modules/pattern/features/partner/services/partner.service.ts +17 -0
- package/modules/pattern/features/product/components/general-information-form/general-information-form.component.d.ts +23 -0
- package/modules/pattern/features/product/components/general-information-form/general-information-form.component.ts +88 -0
- package/modules/pattern/features/product/components/product-select/product-select.component.d.ts +20 -0
- package/modules/pattern/features/product/components/product-select/product-select.component.ts +65 -0
- package/modules/pattern/features/product/components/product-status-select/product-status-select.component.d.ts +22 -0
- package/modules/pattern/features/product/components/product-status-select/product-status-select.component.ts +30 -0
- package/modules/pattern/features/product/entity.resolver.d.ts +4 -0
- package/modules/pattern/features/product/entity.resolver.ts +21 -0
- package/modules/pattern/features/product/pages/create/create.component.d.ts +15 -0
- package/modules/pattern/features/product/pages/create/create.component.ts +85 -0
- package/modules/pattern/features/product/pages/detail/detail.component.d.ts +10 -0
- package/modules/pattern/features/product/pages/detail/detail.component.ts +53 -0
- package/modules/pattern/features/product/pages/list/list.component.d.ts +15 -0
- package/modules/pattern/features/product/pages/list/list.component.html +30 -0
- package/modules/pattern/features/product/pages/list/list.component.ts +71 -0
- package/modules/pattern/features/product/pages/update/update.component.d.ts +16 -0
- package/modules/pattern/features/product/pages/update/update.component.ts +86 -0
- package/modules/pattern/features/product/pipes/product-detail.pipe.d.ts +14 -0
- package/modules/pattern/features/product/pipes/product-detail.pipe.ts +18 -0
- package/modules/pattern/features/product/routes.d.ts +3 -0
- package/modules/pattern/features/product/routes.ts +48 -0
- package/modules/pattern/features/product/services/product.model.d.ts +34 -0
- package/modules/pattern/features/product/services/product.model.ts +38 -0
- package/modules/pattern/features/product/services/product.service.d.ts +17 -0
- package/modules/pattern/features/product/services/product.service.ts +48 -0
- package/modules/pattern/features/settings/pages/update/update.component.d.ts +26 -0
- package/modules/pattern/features/settings/pages/update/update.component.ts +227 -0
- package/modules/pattern/features/settings/routes.d.ts +3 -0
- package/modules/pattern/features/settings/routes.ts +24 -0
- package/modules/pattern/features/settings/services/settings.model.d.ts +17 -0
- package/modules/pattern/features/settings/services/settings.model.ts +18 -0
- package/modules/pattern/features/settings/services/settings.service.d.ts +10 -0
- package/modules/pattern/features/settings/services/settings.service.ts +15 -0
- package/modules/pattern/features/settings/settings.resolver.d.ts +4 -0
- package/modules/pattern/features/settings/settings.resolver.ts +8 -0
- package/modules/pattern/index.d.ts +3 -0
- package/modules/pattern/routes.d.ts +6 -0
- package/modules/pattern/services/base-api.service.d.ts +16 -0
- package/modules/pattern/utils/api-error.d.ts +4 -0
- package/modules/pattern/utils/focus-first-invalid.d.ts +5 -0
- package/modules/pattern/utils/form-api-errors.d.ts +16 -0
- package/modules/pattern/utils/resource-url.d.ts +2 -0
- package/package.json +13 -9
- package/services/unsaved-changes/src/unsaved-changes.adapters.d.ts +9 -0
- package/services/unsaved-changes/src/unsaved-changes.model.d.ts +2 -0
- package/forms/chip/src/pipes/index.d.ts +0 -1
- package/forms/chip/src/pipes/removable-chip.pipe.d.ts +0 -8
|
@@ -0,0 +1,518 @@
|
|
|
1
|
+
# Form
|
|
2
|
+
|
|
3
|
+
Tạo hoặc cập nhật một bản ghi trong một bước: `sd-page-form`. Route mẫu: `/pattern/product/create` và `/pattern/product/:id/update` (một section), `/pattern/order/create` và `/pattern/order/:id/update` (dòng hàng nhập trực tiếp, mục lục), `/pattern/settings` (một bản ghi, nhiều nhóm, trạng thái lưu ở footer).
|
|
4
|
+
|
|
5
|
+
## Khi nào dùng / khi nào không
|
|
6
|
+
|
|
7
|
+
- Dùng khi form cần cả trang: nhiều nhóm, bảng dòng chi tiết, hoặc người dùng cần tập trung.
|
|
8
|
+
- Form ngắn sửa ngay trên danh sách: dùng drawer ([drawer](drawer.md)).
|
|
9
|
+
- Nhiều bước có điều kiện chuyển bước: dùng [flow](flow.md).
|
|
10
|
+
|
|
11
|
+
## Code mẫu
|
|
12
|
+
|
|
13
|
+
Nhóm field nằm trong component `-form` dùng chung cho tạo và cập nhật; field Core tự đăng ký control qua `[form]` + `name`:
|
|
14
|
+
|
|
15
|
+
<!-- @source features/product/components/general-information-form/general-information-form.component.ts -->
|
|
16
|
+
```ts
|
|
17
|
+
import { ChangeDetectionStrategy, Component, input } from '@angular/core';
|
|
18
|
+
import type { FormControl, FormGroup } from '@angular/forms';
|
|
19
|
+
import { SdSection } from '@sdcorejs/angular/components/section';
|
|
20
|
+
import { SdInput } from '@sdcorejs/angular/forms/input';
|
|
21
|
+
import { SdInputNumber } from '@sdcorejs/angular/forms/input-number';
|
|
22
|
+
import type { ProductSaveReq, ProductStatus } from '../../services/product.model';
|
|
23
|
+
import { ProductStatusSelectComponent } from '../product-status-select/product-status-select.component';
|
|
24
|
+
|
|
25
|
+
/** Các field Core tự đăng ký control qua `[form]` + `name`; page không khai báo trước control trùng tên. */
|
|
26
|
+
export type ProductForm = FormGroup<{
|
|
27
|
+
code?: FormControl<string>;
|
|
28
|
+
name?: FormControl<string>;
|
|
29
|
+
unit?: FormControl<string>;
|
|
30
|
+
price?: FormControl<number>;
|
|
31
|
+
status?: FormControl<ProductStatus>;
|
|
32
|
+
}>;
|
|
33
|
+
|
|
34
|
+
/** Giá trị form → request lưu. `code` truyền vào khi cập nhật (mã bị khoá). */
|
|
35
|
+
export function productSaveReq(form: ProductForm, code?: string): ProductSaveReq {
|
|
36
|
+
const value = form.getRawValue();
|
|
37
|
+
return {
|
|
38
|
+
code: code ?? value.code ?? '',
|
|
39
|
+
name: value.name ?? '',
|
|
40
|
+
unit: value.unit ?? '',
|
|
41
|
+
price: value.price ?? 0,
|
|
42
|
+
status: value.status ?? 'active',
|
|
43
|
+
};
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
/** Nhóm "Thông tin chung" của form sản phẩm, dùng chung cho tạo mới và cập nhật. */
|
|
47
|
+
@Component({
|
|
48
|
+
selector: 'general-information-form',
|
|
49
|
+
standalone: true,
|
|
50
|
+
imports: [SdInput, SdInputNumber, SdSection, ProductStatusSelectComponent],
|
|
51
|
+
changeDetection: ChangeDetectionStrategy.OnPush,
|
|
52
|
+
template: `<sd-section title="Thông tin chung">
|
|
53
|
+
<div class="row p-8">
|
|
54
|
+
<div class="col-12 col-md-6">
|
|
55
|
+
<sd-input
|
|
56
|
+
label="Mã sản phẩm"
|
|
57
|
+
name="code"
|
|
58
|
+
autoId="product-code"
|
|
59
|
+
[form]="form()"
|
|
60
|
+
[model]="seed().code"
|
|
61
|
+
[disabled]="editing()"
|
|
62
|
+
[inlineError]="errors()['code']"
|
|
63
|
+
maxlength="20"
|
|
64
|
+
required />
|
|
65
|
+
</div>
|
|
66
|
+
<div class="col-12 col-md-6">
|
|
67
|
+
<sd-input
|
|
68
|
+
label="Tên sản phẩm"
|
|
69
|
+
name="name"
|
|
70
|
+
autoId="product-name"
|
|
71
|
+
[form]="form()"
|
|
72
|
+
[model]="seed().name"
|
|
73
|
+
[inlineError]="errors()['name']"
|
|
74
|
+
maxlength="100"
|
|
75
|
+
required />
|
|
76
|
+
</div>
|
|
77
|
+
<div class="col-12 col-md-6">
|
|
78
|
+
<sd-input label="Đơn vị tính" name="unit" autoId="product-unit" [form]="form()" [model]="seed().unit" maxlength="20" />
|
|
79
|
+
</div>
|
|
80
|
+
<div class="col-12 col-md-6">
|
|
81
|
+
<sd-input-number
|
|
82
|
+
label="Giá bán (₫)"
|
|
83
|
+
name="price"
|
|
84
|
+
autoId="product-price"
|
|
85
|
+
type="positive"
|
|
86
|
+
[precision]="0"
|
|
87
|
+
[form]="form()"
|
|
88
|
+
[model]="seed().price"
|
|
89
|
+
[inlineError]="errors()['price']"
|
|
90
|
+
required />
|
|
91
|
+
</div>
|
|
92
|
+
<div class="col-12 col-md-6">
|
|
93
|
+
<product-status-select [form]="form()" [model]="seed().status" />
|
|
94
|
+
</div>
|
|
95
|
+
</div>
|
|
96
|
+
</sd-section>`,
|
|
97
|
+
})
|
|
98
|
+
export class GeneralInformationFormComponent {
|
|
99
|
+
readonly form = input.required<FormGroup>();
|
|
100
|
+
readonly seed = input.required<ProductSaveReq>();
|
|
101
|
+
readonly editing = input(false);
|
|
102
|
+
/** Lỗi theo field do API trả về. */
|
|
103
|
+
readonly errors = input<Readonly<Record<string, string>>>({});
|
|
104
|
+
}
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
Trang tạo: Huỷ · Lưu ở `headerRight`, lưu lỗi thì focus field lỗi đầu tiên và gắn lỗi của API vào field, lưu xong sang chi tiết bằng `replaceUrl`:
|
|
108
|
+
|
|
109
|
+
<!-- @source features/product/pages/create/create.component.ts -->
|
|
110
|
+
```ts
|
|
111
|
+
import { afterNextRender, ChangeDetectionStrategy, Component, DestroyRef, ElementRef, inject, Injector, signal } from '@angular/core';
|
|
112
|
+
import { FormGroup } from '@angular/forms';
|
|
113
|
+
import { ActivatedRoute, Router } from '@angular/router';
|
|
114
|
+
import { firstValueFrom } from 'rxjs';
|
|
115
|
+
import { SdButton } from '@sdcorejs/angular/components/button';
|
|
116
|
+
import { SdPageComponent } from '@sdcorejs/angular/modules/layout';
|
|
117
|
+
import { SdNotifyService } from '@sdcorejs/angular/services/notify';
|
|
118
|
+
import { registerSdUnsavedChangesForm, SdUnsavedChangesService } from '@sdcorejs/angular/services/unsaved-changes';
|
|
119
|
+
import { apiErrorMessage } from '../../../../utils/api-error';
|
|
120
|
+
import { focusFirstInvalid } from '../../../../utils/focus-first-invalid';
|
|
121
|
+
import { formApiErrors } from '../../../../utils/form-api-errors';
|
|
122
|
+
import {
|
|
123
|
+
GeneralInformationFormComponent,
|
|
124
|
+
productSaveReq,
|
|
125
|
+
type ProductForm,
|
|
126
|
+
} from '../../components/general-information-form/general-information-form.component';
|
|
127
|
+
import { ProductService } from '../../services/product.service';
|
|
128
|
+
import type { ProductSaveReq } from '../../services/product.model';
|
|
129
|
+
|
|
130
|
+
@Component({
|
|
131
|
+
selector: 'create',
|
|
132
|
+
standalone: true,
|
|
133
|
+
changeDetection: ChangeDetectionStrategy.OnPush,
|
|
134
|
+
imports: [SdPageComponent, SdButton, GeneralInformationFormComponent],
|
|
135
|
+
template: `
|
|
136
|
+
<sd-page-form title="Tạo mới sản phẩm" [backLink]="['..']">
|
|
137
|
+
<div headerRight class="d-flex align-items-center gap-8">
|
|
138
|
+
<sd-button title="Huỷ" type="outline" autoId="product-cancel" (click)="cancel()" />
|
|
139
|
+
<sd-button title="Lưu" type="fill" color="primary" autoId="product-save" [loading]="saving()" (click)="save()" />
|
|
140
|
+
</div>
|
|
141
|
+
<div class="py-16">
|
|
142
|
+
<general-information-form [form]="form" [seed]="seed" [errors]="apiErrors.errors()" />
|
|
143
|
+
</div>
|
|
144
|
+
</sd-page-form>
|
|
145
|
+
`,
|
|
146
|
+
})
|
|
147
|
+
export class CreateComponent {
|
|
148
|
+
readonly #productService = inject(ProductService);
|
|
149
|
+
readonly #notify = inject(SdNotifyService);
|
|
150
|
+
readonly #router = inject(Router);
|
|
151
|
+
readonly #route = inject(ActivatedRoute);
|
|
152
|
+
readonly #host: HTMLElement = inject(ElementRef).nativeElement;
|
|
153
|
+
readonly #injector = inject(Injector);
|
|
154
|
+
protected readonly seed: ProductSaveReq = { code: '', name: '', unit: 'Cái', price: 0, status: 'active' };
|
|
155
|
+
protected readonly form: ProductForm = new FormGroup({});
|
|
156
|
+
protected readonly saving = signal(false);
|
|
157
|
+
protected readonly apiErrors = formApiErrors(this.form);
|
|
158
|
+
// Dirty theo giá trị: gõ rồi xoá về như cũ thì rời trang không bị hỏi.
|
|
159
|
+
readonly #unsaved = registerSdUnsavedChangesForm(inject(SdUnsavedChangesService), this.form, { id: 'product-create', dirty: 'value' });
|
|
160
|
+
|
|
161
|
+
constructor() {
|
|
162
|
+
inject(DestroyRef).onDestroy(() => this.#unsaved.destroy());
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
protected cancel(): void {
|
|
166
|
+
void this.#router.navigate(['..'], { relativeTo: this.#route });
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
protected async save(): Promise<void> {
|
|
170
|
+
if (this.saving()) return;
|
|
171
|
+
this.form.markAllAsTouched();
|
|
172
|
+
if (this.form.invalid) {
|
|
173
|
+
this.#focusFirstInvalid();
|
|
174
|
+
return;
|
|
175
|
+
}
|
|
176
|
+
this.saving.set(true);
|
|
177
|
+
try {
|
|
178
|
+
const product = await firstValueFrom(this.#productService.create(productSaveReq(this.form)));
|
|
179
|
+
this.#unsaved.markPristine();
|
|
180
|
+
this.#notify.success(`Đã tạo sản phẩm ${product.code}.`);
|
|
181
|
+
// replaceUrl: Back ở trang chi tiết về danh sách, không quay lại form tạo mới.
|
|
182
|
+
await this.#router.navigate(['..', product.id, 'detail'], { relativeTo: this.#route, replaceUrl: true });
|
|
183
|
+
} catch (error) {
|
|
184
|
+
// Lưu lỗi: giữ nguyên dữ liệu đã nhập; lỗi theo field hiện ngay trên field.
|
|
185
|
+
if (this.apiErrors.set(error)) this.#focusFirstInvalid();
|
|
186
|
+
else this.#notify.error(apiErrorMessage(error, 'Không thể lưu. Dữ liệu đã nhập vẫn được giữ.'));
|
|
187
|
+
} finally {
|
|
188
|
+
this.saving.set(false);
|
|
189
|
+
}
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
#focusFirstInvalid(): void {
|
|
193
|
+
afterNextRender(() => focusFirstInvalid(this.#host), { injector: this.#injector });
|
|
194
|
+
}
|
|
195
|
+
}
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
Trang cập nhật: mã bị khoá, dirty tính theo giá trị:
|
|
199
|
+
|
|
200
|
+
<!-- @source features/product/pages/update/update.component.ts -->
|
|
201
|
+
```ts
|
|
202
|
+
import { afterNextRender, ChangeDetectionStrategy, Component, DestroyRef, ElementRef, inject, Injector, signal } from '@angular/core';
|
|
203
|
+
import { toSignal } from '@angular/core/rxjs-interop';
|
|
204
|
+
import { FormGroup } from '@angular/forms';
|
|
205
|
+
import { ActivatedRoute, Router } from '@angular/router';
|
|
206
|
+
import { firstValueFrom, map } from 'rxjs';
|
|
207
|
+
import { SdButton } from '@sdcorejs/angular/components/button';
|
|
208
|
+
import { SdPageComponent } from '@sdcorejs/angular/modules/layout';
|
|
209
|
+
import { SdNotifyService } from '@sdcorejs/angular/services/notify';
|
|
210
|
+
import { registerSdUnsavedChangesForm, SdUnsavedChangesService } from '@sdcorejs/angular/services/unsaved-changes';
|
|
211
|
+
import { apiErrorMessage } from '../../../../utils/api-error';
|
|
212
|
+
import { focusFirstInvalid } from '../../../../utils/focus-first-invalid';
|
|
213
|
+
import { formApiErrors } from '../../../../utils/form-api-errors';
|
|
214
|
+
import {
|
|
215
|
+
GeneralInformationFormComponent,
|
|
216
|
+
productSaveReq,
|
|
217
|
+
type ProductForm,
|
|
218
|
+
} from '../../components/general-information-form/general-information-form.component';
|
|
219
|
+
import { ProductService } from '../../services/product.service';
|
|
220
|
+
import type { ProductDto } from '../../services/product.model';
|
|
221
|
+
|
|
222
|
+
@Component({
|
|
223
|
+
selector: 'update',
|
|
224
|
+
standalone: true,
|
|
225
|
+
changeDetection: ChangeDetectionStrategy.OnPush,
|
|
226
|
+
imports: [SdPageComponent, SdButton, GeneralInformationFormComponent],
|
|
227
|
+
template: `
|
|
228
|
+
<sd-page-form [title]="'Cập nhật sản phẩm #' + entity().code" [backLink]="['../detail']">
|
|
229
|
+
<div headerRight class="d-flex align-items-center gap-8">
|
|
230
|
+
<sd-button title="Huỷ" type="outline" autoId="product-cancel" (click)="cancel()" />
|
|
231
|
+
<sd-button title="Lưu" type="fill" color="primary" autoId="product-save" [loading]="saving()" (click)="save()" />
|
|
232
|
+
</div>
|
|
233
|
+
<div class="py-16">
|
|
234
|
+
<general-information-form [form]="form" [seed]="entity()" [editing]="true" [errors]="apiErrors.errors()" />
|
|
235
|
+
</div>
|
|
236
|
+
</sd-page-form>
|
|
237
|
+
`,
|
|
238
|
+
})
|
|
239
|
+
export class UpdateComponent {
|
|
240
|
+
readonly #productService = inject(ProductService);
|
|
241
|
+
readonly #notify = inject(SdNotifyService);
|
|
242
|
+
readonly #router = inject(Router);
|
|
243
|
+
readonly #route = inject(ActivatedRoute);
|
|
244
|
+
readonly #host: HTMLElement = inject(ElementRef).nativeElement;
|
|
245
|
+
readonly #injector = inject(Injector);
|
|
246
|
+
/** Sản phẩm do resolver tải; draft khởi tạo từ đây, sửa draft không đổi bản ghi trước khi lưu thành công. */
|
|
247
|
+
protected readonly entity = toSignal(this.#route.data.pipe(map(data => data['entity'] as ProductDto)), { requireSync: true });
|
|
248
|
+
protected readonly form: ProductForm = new FormGroup({});
|
|
249
|
+
protected readonly saving = signal(false);
|
|
250
|
+
protected readonly apiErrors = formApiErrors(this.form);
|
|
251
|
+
readonly #unsaved = registerSdUnsavedChangesForm(inject(SdUnsavedChangesService), this.form, { id: 'product-update', dirty: 'value' });
|
|
252
|
+
|
|
253
|
+
constructor() {
|
|
254
|
+
inject(DestroyRef).onDestroy(() => this.#unsaved.destroy());
|
|
255
|
+
}
|
|
256
|
+
|
|
257
|
+
protected cancel(): void {
|
|
258
|
+
void this.#router.navigate(['../detail'], { relativeTo: this.#route });
|
|
259
|
+
}
|
|
260
|
+
|
|
261
|
+
protected async save(): Promise<void> {
|
|
262
|
+
if (this.saving()) return;
|
|
263
|
+
this.form.markAllAsTouched();
|
|
264
|
+
if (this.form.invalid) {
|
|
265
|
+
this.#focusFirstInvalid();
|
|
266
|
+
return;
|
|
267
|
+
}
|
|
268
|
+
this.saving.set(true);
|
|
269
|
+
try {
|
|
270
|
+
// Mã bị khoá sau khi tạo: gửi mã của bản ghi, không lấy từ form.
|
|
271
|
+
await firstValueFrom(this.#productService.update(this.entity().id, productSaveReq(this.form, this.entity().code)));
|
|
272
|
+
this.#unsaved.markPristine();
|
|
273
|
+
this.#notify.success('Đã cập nhật sản phẩm.');
|
|
274
|
+
await this.#router.navigate(['../detail'], { relativeTo: this.#route, replaceUrl: true });
|
|
275
|
+
} catch (error) {
|
|
276
|
+
// Lưu lỗi: giữ nguyên draft để sửa và thử lại.
|
|
277
|
+
if (this.apiErrors.set(error)) this.#focusFirstInvalid();
|
|
278
|
+
else this.#notify.error(apiErrorMessage(error, 'Không thể lưu. Dữ liệu đã nhập vẫn được giữ.'));
|
|
279
|
+
} finally {
|
|
280
|
+
this.saving.set(false);
|
|
281
|
+
}
|
|
282
|
+
}
|
|
283
|
+
|
|
284
|
+
#focusFirstInvalid(): void {
|
|
285
|
+
afterNextRender(() => focusFirstInvalid(this.#host), { injector: this.#injector });
|
|
286
|
+
}
|
|
287
|
+
}
|
|
288
|
+
```
|
|
289
|
+
|
|
290
|
+
Dòng hàng nhập trực tiếp, tổng tự tính, lỗi của API hiện trên đúng dòng:
|
|
291
|
+
|
|
292
|
+
<!-- @source features/order/components/lines-form/lines-form.component.ts -->
|
|
293
|
+
```ts
|
|
294
|
+
import { ChangeDetectionStrategy, Component, computed, DestroyRef, effect, inject, input, signal, untracked } from '@angular/core';
|
|
295
|
+
import { FormArray, FormGroup } from '@angular/forms';
|
|
296
|
+
import { firstValueFrom } from 'rxjs';
|
|
297
|
+
import { SdButton } from '@sdcorejs/angular/components/button';
|
|
298
|
+
import { SdSection } from '@sdcorejs/angular/components/section';
|
|
299
|
+
import { SdInputNumber } from '@sdcorejs/angular/forms/input-number';
|
|
300
|
+
import { SdFormatNumberPipe } from '@sdcorejs/angular/pipes';
|
|
301
|
+
import { ProductSelectComponent } from '../../../product/components/product-select/product-select.component';
|
|
302
|
+
import { ProductService } from '../../../product/services/product.service';
|
|
303
|
+
import type { OrderLineDto } from '../../services/order.model';
|
|
304
|
+
import type { OrderForm } from '../general-information-form/general-information-form.component';
|
|
305
|
+
|
|
306
|
+
interface LineRow {
|
|
307
|
+
readonly key: number;
|
|
308
|
+
readonly group: FormGroup;
|
|
309
|
+
readonly seed: OrderLineDto;
|
|
310
|
+
}
|
|
311
|
+
|
|
312
|
+
/**
|
|
313
|
+
* Bảng dòng hàng nhập trực tiếp: mỗi dòng là một FormGroup trong `form.lines` (FormArray), các field Core tự đăng
|
|
314
|
+
* ký vào dòng. Chọn sản phẩm điền đơn giá; thành tiền và tổng tự tính. Lỗi API theo dòng (`lines.<i>.<field>`) hiện
|
|
315
|
+
* ngay trên ô của dòng đó.
|
|
316
|
+
*/
|
|
317
|
+
@Component({
|
|
318
|
+
selector: 'lines-form',
|
|
319
|
+
standalone: true,
|
|
320
|
+
imports: [SdSection, SdButton, SdInputNumber, SdFormatNumberPipe, ProductSelectComponent],
|
|
321
|
+
changeDetection: ChangeDetectionStrategy.OnPush,
|
|
322
|
+
template: `
|
|
323
|
+
<sd-section title="Dòng hàng">
|
|
324
|
+
<div sdHeaderRight>
|
|
325
|
+
<sd-button title="Thêm dòng" prefixIcon="add" type="text" autoId="order-line-add" (click)="add()" />
|
|
326
|
+
</div>
|
|
327
|
+
<table class="lines">
|
|
328
|
+
<thead>
|
|
329
|
+
<tr>
|
|
330
|
+
<th scope="col">Sản phẩm</th>
|
|
331
|
+
<th scope="col" class="lines__number">Số lượng</th>
|
|
332
|
+
<th scope="col" class="lines__number">Đơn giá (₫)</th>
|
|
333
|
+
<th scope="col" class="lines__number">Thành tiền (₫)</th>
|
|
334
|
+
<th scope="col"><span class="sd-visually-hidden">Xoá dòng</span></th>
|
|
335
|
+
</tr>
|
|
336
|
+
</thead>
|
|
337
|
+
<tbody>
|
|
338
|
+
@for (row of rows(); track row.key; let index = $index) {
|
|
339
|
+
<tr [attr.data-line]="index">
|
|
340
|
+
<td>
|
|
341
|
+
<product-select
|
|
342
|
+
[label]="undefined"
|
|
343
|
+
[form]="row.group"
|
|
344
|
+
[model]="row.seed.productId || null"
|
|
345
|
+
[autoId]="'order-line-' + index + '-product'"
|
|
346
|
+
(modelChange)="pick(row, $event)"
|
|
347
|
+
required />
|
|
348
|
+
@if (errors()['lines.' + index + '.productId']; as error) {
|
|
349
|
+
<span class="lines__error" role="alert">{{ error }}</span>
|
|
350
|
+
}
|
|
351
|
+
</td>
|
|
352
|
+
<td class="lines__number">
|
|
353
|
+
<sd-input-number
|
|
354
|
+
name="quantity"
|
|
355
|
+
type="positive"
|
|
356
|
+
[precision]="0"
|
|
357
|
+
[form]="row.group"
|
|
358
|
+
[model]="row.seed.quantity"
|
|
359
|
+
[inlineError]="errors()['lines.' + index + '.quantity']"
|
|
360
|
+
[autoId]="'order-line-' + index + '-quantity'"
|
|
361
|
+
required />
|
|
362
|
+
</td>
|
|
363
|
+
<td class="lines__number">
|
|
364
|
+
<sd-input-number
|
|
365
|
+
name="unitPrice"
|
|
366
|
+
type="positive"
|
|
367
|
+
[precision]="0"
|
|
368
|
+
[form]="row.group"
|
|
369
|
+
[model]="row.seed.unitPrice"
|
|
370
|
+
required />
|
|
371
|
+
</td>
|
|
372
|
+
<td class="lines__number">{{ amounts()[index] | sdFormatNumber: 0 }}</td>
|
|
373
|
+
<td>
|
|
374
|
+
<sd-button
|
|
375
|
+
prefixIcon="delete"
|
|
376
|
+
type="text"
|
|
377
|
+
color="error"
|
|
378
|
+
tooltip="Xoá dòng"
|
|
379
|
+
[autoId]="'order-line-' + index + '-remove'"
|
|
380
|
+
[disabled]="rows().length === 1"
|
|
381
|
+
(click)="remove(row)" />
|
|
382
|
+
</td>
|
|
383
|
+
</tr>
|
|
384
|
+
}
|
|
385
|
+
</tbody>
|
|
386
|
+
<tfoot>
|
|
387
|
+
<tr>
|
|
388
|
+
<th scope="row" colspan="3" class="lines__number">Tổng tiền (₫)</th>
|
|
389
|
+
<td class="lines__number lines__total" data-autoid="order-total">{{ total() | sdFormatNumber: 0 }}</td>
|
|
390
|
+
<td></td>
|
|
391
|
+
</tr>
|
|
392
|
+
</tfoot>
|
|
393
|
+
</table>
|
|
394
|
+
</sd-section>
|
|
395
|
+
`,
|
|
396
|
+
styles: `
|
|
397
|
+
.lines {
|
|
398
|
+
width: 100%;
|
|
399
|
+
border-collapse: collapse;
|
|
400
|
+
}
|
|
401
|
+
.lines th,
|
|
402
|
+
.lines td {
|
|
403
|
+
padding: 4px 8px;
|
|
404
|
+
text-align: left;
|
|
405
|
+
vertical-align: top;
|
|
406
|
+
}
|
|
407
|
+
.lines thead th {
|
|
408
|
+
color: var(--sd-text-secondary);
|
|
409
|
+
font-size: 12px;
|
|
410
|
+
font-weight: 500;
|
|
411
|
+
border-bottom: 1px solid var(--sd-border);
|
|
412
|
+
}
|
|
413
|
+
.lines td:first-child {
|
|
414
|
+
min-width: 240px;
|
|
415
|
+
}
|
|
416
|
+
.lines__number {
|
|
417
|
+
width: 150px;
|
|
418
|
+
text-align: right !important;
|
|
419
|
+
}
|
|
420
|
+
.lines td.lines__number {
|
|
421
|
+
padding-top: 14px;
|
|
422
|
+
}
|
|
423
|
+
.lines tfoot th,
|
|
424
|
+
.lines tfoot td {
|
|
425
|
+
padding-top: 12px;
|
|
426
|
+
border-top: 1px solid var(--sd-border);
|
|
427
|
+
}
|
|
428
|
+
.lines__total {
|
|
429
|
+
font-weight: 500;
|
|
430
|
+
}
|
|
431
|
+
.lines__error {
|
|
432
|
+
color: var(--sd-error, currentColor);
|
|
433
|
+
font-size: 12px;
|
|
434
|
+
}
|
|
435
|
+
`,
|
|
436
|
+
})
|
|
437
|
+
export class LinesFormComponent {
|
|
438
|
+
readonly #productService = inject(ProductService);
|
|
439
|
+
readonly form = input.required<OrderForm>();
|
|
440
|
+
/** Dòng ban đầu (cập nhật) hoặc một dòng trống (tạo mới). */
|
|
441
|
+
readonly seed = input.required<readonly OrderLineDto[]>();
|
|
442
|
+
/** Lỗi theo field do API trả về, khoá dạng `lines.<index>.<field>`. */
|
|
443
|
+
readonly errors = input<Readonly<Record<string, string>>>({});
|
|
444
|
+
readonly #array = new FormArray<FormGroup>([]);
|
|
445
|
+
readonly #version = signal(0);
|
|
446
|
+
#nextKey = 0;
|
|
447
|
+
protected readonly rows = signal<readonly LineRow[]>([]);
|
|
448
|
+
protected readonly amounts = computed(() => {
|
|
449
|
+
this.#version();
|
|
450
|
+
return this.rows().map(
|
|
451
|
+
row => Number(row.group.get('quantity')?.value ?? row.seed.quantity) * Number(row.group.get('unitPrice')?.value ?? row.seed.unitPrice)
|
|
452
|
+
);
|
|
453
|
+
});
|
|
454
|
+
protected readonly total = computed(() => this.amounts().reduce((sum, amount) => sum + amount, 0));
|
|
455
|
+
|
|
456
|
+
constructor() {
|
|
457
|
+
const subscription = this.#array.valueChanges.subscribe(() => this.#version.update(version => version + 1));
|
|
458
|
+
inject(DestroyRef).onDestroy(() => subscription.unsubscribe());
|
|
459
|
+
// why: trang cập nhật được dùng lại khi chỉ đổi `:id`; dòng hàng phải theo đơn mới, không giữ dòng của đơn trước.
|
|
460
|
+
effect(() => {
|
|
461
|
+
const seed = this.seed();
|
|
462
|
+
untracked(() => this.#load(seed));
|
|
463
|
+
});
|
|
464
|
+
}
|
|
465
|
+
|
|
466
|
+
protected add(): void {
|
|
467
|
+
this.#push({ productId: '', quantity: 1, unitPrice: 0 });
|
|
468
|
+
}
|
|
469
|
+
|
|
470
|
+
protected remove(row: LineRow): void {
|
|
471
|
+
const index = this.rows().indexOf(row);
|
|
472
|
+
if (index < 0) return;
|
|
473
|
+
// why: đánh dấu đã sửa TRƯỚC khi gỡ, để dirty theo giá trị so với danh sách dòng lúc trước.
|
|
474
|
+
this.#array.markAsDirty();
|
|
475
|
+
this.#array.removeAt(index);
|
|
476
|
+
this.rows.update(rows => rows.filter(item => item !== row));
|
|
477
|
+
}
|
|
478
|
+
|
|
479
|
+
/** Chọn sản phẩm thì điền đơn giá hiện hành của sản phẩm. */
|
|
480
|
+
protected async pick(row: LineRow, productId: string | null | undefined): Promise<void> {
|
|
481
|
+
if (!productId) return;
|
|
482
|
+
const product = await firstValueFrom(this.#productService.cachedDetail(productId));
|
|
483
|
+
row.group.get('unitPrice')?.setValue(product.price);
|
|
484
|
+
}
|
|
485
|
+
|
|
486
|
+
#load(seed: readonly OrderLineDto[]): void {
|
|
487
|
+
this.#array.clear();
|
|
488
|
+
this.rows.set([]);
|
|
489
|
+
(seed.length ? seed : [{ productId: '', quantity: 1, unitPrice: 0 }]).forEach(line => this.#push(line));
|
|
490
|
+
if (this.form().get('lines') !== this.#array) this.form().setControl('lines', this.#array);
|
|
491
|
+
}
|
|
492
|
+
|
|
493
|
+
#push(seed: OrderLineDto): void {
|
|
494
|
+
const group = new FormGroup({});
|
|
495
|
+
this.#array.push(group);
|
|
496
|
+
this.rows.update(rows => [...rows, { key: this.#nextKey++, group, seed }]);
|
|
497
|
+
}
|
|
498
|
+
}
|
|
499
|
+
```
|
|
500
|
+
|
|
501
|
+
## Quy tắc
|
|
502
|
+
|
|
503
|
+
- MUST đặt Huỷ (outline) và Lưu (fill, primary) ở `headerRight` của `sd-page-form` (E3); không lặp nút lưu ở cuối thân.
|
|
504
|
+
- MUST đặt title "Tạo mới <entity>" hoặc "Cập nhật <entity> #<mã>" (E5).
|
|
505
|
+
- MUST bảo vệ thay đổi chưa lưu: `canDeactivate: [sdPageFormLeaveGuard]` trên route và `registerSdUnsavedChangesForm(..., { dirty: 'value' })` trong trang. Gõ rồi sửa về như cũ không bị hỏi; đóng tab trình duyệt khi còn thay đổi có hộp thoại của trình duyệt.
|
|
506
|
+
- MUST kiểm tra khi rời field và khi bấm Lưu (`markAllAsTouched`); lưu lỗi thì focus field lỗi đầu tiên (E13).
|
|
507
|
+
- MUST gắn lỗi theo field của API vào đúng field (`[inlineError]`), giữ nguyên dữ liệu đã nhập; field đổi giá trị thì bỏ lỗi cũ của nó.
|
|
508
|
+
- MUST lưu xong thì `markPristine()` trước khi điều hướng, sang chi tiết với `replaceUrl: true` để Back không quay lại form tạo mới.
|
|
509
|
+
- MUST không khai báo trước FormControl trùng tên với field Core tự đăng ký.
|
|
510
|
+
- SHOULD dùng `toc` khi form có từ ba nhóm trở lên; mục lục lấy các `sd-section` có title, cả section nằm trong component `-form` con.
|
|
511
|
+
- SHOULD giữ bản ghi một dòng (cài đặt) ở lại trang sau khi lưu: `form.markAsPristine()` làm giá trị vừa lưu thành mốc so sánh mới, footer báo trạng thái lưu.
|
|
512
|
+
|
|
513
|
+
## Lỗi hay gặp
|
|
514
|
+
|
|
515
|
+
- Chụp giá trị ban đầu lúc khởi tạo form khi field Core chưa đăng ký: form vừa mở đã bị coi là có thay đổi. Dùng `dirty: 'value'` của `registerSdUnsavedChangesForm`.
|
|
516
|
+
- Bắt mọi lỗi lưu rồi báo chung "Không thể lưu": lỗi theo field của API mất chỗ hiện.
|
|
517
|
+
- Điều hướng sau khi lưu mà chưa `markPristine()`: guard hỏi "Rời trang khi chưa lưu?" ngay sau khi lưu xong.
|
|
518
|
+
- Bấm Lưu liên tiếp tạo hai request: chặn bằng cờ `saving` và trạng thái `loading` của nút.
|