codexly-ui 0.13.6 → 0.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codexly-ui",
-  "version": "0.13.6",
+  "version": "0.14.0",
   "description": "Standalone, signal-based Angular UI component library for Codexly, styled with Tailwind CSS.",
   "keywords": [
     "angular",

package/types/codexly-ui.d.ts

@@ -3338,6 +3338,61 @@ declare class ClxFabComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClxFabComponent, "clx-fab", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "shadow": { "alias": "shadow"; "required": false; "isSignal": true; }; "triggerLabel": { "alias": "triggerLabel"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; }, { "itemClick": "itemClick"; }, never, never, true, never>;
 }
 
+/** How the substituted body should be rendered:
+ *  - 'rich': the body is HTML (e.g. an email template) — rendered via innerHTML inside a card.
+ *  - 'plain-toast': the body is plain text meant for a push notification — rendered inside a
+ *    toast-shaped card (icon disc + title + message), matching ClxToastComponent's look.
+ *  - 'plain-inapp': the body is plain text meant for the in-app notification drawer — rendered
+ *    as a single drawer row (icon + title + detail), matching ClxNotificationComponent's look. */
+type ClxTemplatePreviewMode = 'rich' | 'plain-toast' | 'plain-inapp';
+
+/** Read-only live preview of a `{{variable}}` template — for a template EDITOR (notification
+ *  templates, shipping label templates, ...) to show what the body will actually look like once
+ *  substituted, instead of only exposing the raw markup/placeholders. "Dumb" like ClxNotification/
+ *  ClxToast: it never fetches sample data itself — pass real values via `vars`, or rely on the
+ *  built-in generic fallbacks (TEMPLATE_PREVIEW_SAMPLE_VARS) for any key you don't supply.
+ *
+ *  Substitution is the same naive {{key}} → value replace used by the real dispatchers (backend
+ *  NotificationDispatcher.render() in Java, and ShipmentLabelModalComponent client-side) — no
+ *  expression evaluation, so a Thymeleaf-flavored body (th:if/th:each, used only by the PROMOTION
+ *  notification type) will show its raw tags rather than truly rendering; that's a known, accepted
+ *  gap, not a bug — this component previews the plain {{var}} vocabulary every other template uses. */
+declare class ClxTemplatePreviewComponent {
+    private readonly _sanitizer;
+    /** Raw template body — plain text (toast/in-app) or HTML (rich, e.g. an email body). */
+    readonly body: _angular_core.InputSignal<string>;
+    /** Optional separate title/subject, substituted the same way as body. Shown above the message in
+     *  plain-toast/plain-inapp mode; ignored in rich mode (the body itself carries its own heading). */
+    readonly title: _angular_core.InputSignal<string | undefined>;
+    readonly mode: _angular_core.InputSignal<ClxTemplatePreviewMode>;
+    /** Material Symbols icon shown in plain-toast/plain-inapp mode — defaults to 'notifications'. */
+    readonly icon: _angular_core.InputSignal<string | undefined>;
+    /** Sample values for {{key}} substitution — merged OVER the built-in generic fallbacks
+     *  (TEMPLATE_PREVIEW_SAMPLE_VARS), so you only need to pass the keys you want to control
+     *  (e.g. a real shipment's data) and every other {{var}} still resolves to something readable. */
+    readonly vars: _angular_core.InputSignal<Record<string, string> | undefined>;
+    private readonly _mergedVars;
+    protected readonly _title: _angular_core.Signal<string>;
+    protected readonly _renderedText: _angular_core.Signal<string>;
+    protected readonly _renderedHtml: _angular_core.Signal<SafeHtml>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClxTemplatePreviewComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClxTemplatePreviewComponent, "clx-template-preview", never, { "body": { "alias": "body"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "vars": { "alias": "vars"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/** Generic sample values keyed by variable name — covers the real {{variable}} vocabulary already
+ *  used across Codexly's notification/label templates (see NotificationTypeCatalog on the backend
+ *  and LABEL_TEMPLATE_VARS on the frontend), so a preview looks realistic with zero configuration.
+ *  A consumer can still override/extend via the `vars` input; this is only the fallback for any
+ *  key it doesn't supply. */
+declare const TEMPLATE_PREVIEW_SAMPLE_VARS: Record<string, string>;
+/** Naive {{key}} → value string replacement — the exact primitive already used by
+ *  ShipmentLabelModalComponent (`html.split('{{key}}').join(v)`) and mirrored server-side by
+ *  NotificationDispatcher.render() (Java, plain .replace loop, no expressions). Kept here as the
+ *  single shared implementation so every consumer (this component, ShipmentLabelModalComponent)
+ *  renders previews identically instead of drifting. Unresolved {{key}} placeholders are left
+ *  as-is (visible literally), same as the real dispatchers when a var wasn't supplied. */
+declare function renderClxTemplate(body: string, vars: Record<string, string>): string;
+
 interface ClxTableColumn<T = any> {
     key: string;
     header?: string;
@@ -4532,5 +4587,5 @@ declare class ClxToastService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ClxToastService>;
 }
 
-export { CLX_ADDON_BORDER, CLX_ADDON_TEXT, CLX_ALERT_OPTIONS, CLX_ALERT_RESOLVE, CLX_BG_ADDON, CLX_BG_DISABLED, CLX_BG_ICON_WRAP, CLX_BG_SECTION, CLX_BG_SURFACE, CLX_BORDER_DEFAULT, CLX_BORDER_DISABLED, CLX_BORDER_MEDIUM, CLX_COLOR_HEX, CLX_COLOR_HEX_100, CLX_COLOR_MAP, CLX_FONT_CATALOG, CLX_MODAL_ANIM_CONFIG, CLX_MODAL_DATA, CLX_MODAL_REF, CLX_OPTION_DISABLED, CLX_PLACEHOLDER, CLX_RADIO_GROUP, CLX_RADIUS_MAP, CLX_TEXT_BODY, CLX_TEXT_DISABLED, CLX_TEXT_HEADING, CLX_TEXT_HINT, CLX_TEXT_IDLE, CLX_TEXT_INPUT, CLX_TEXT_LABEL, CLX_TEXT_OPTION, CLX_TEXT_SUBTITLE, CLX_TEXT_TITLE, CLX_THEME_CONFIG, CLX_THEME_DEFAULTS, CLX_TOAST_DEFAULTS, ClxAlertComponent, ClxAlertService, ClxAnimateDirective, ClxAnimateGroupDirective, ClxAnimateService, ClxAppLayoutComponent, ClxAvatarComponent, ClxBadgeComponent, ClxBrandComponent, ClxButtonComponent, ClxButtonGroupComponent, ClxCardBodyDirective, ClxCardComponent, ClxCardExpiryInputComponent, ClxCardFooterDirective, ClxCardHeaderActionsDirective, ClxCardHeaderDirective, ClxCardNumberInputComponent, ClxCardValidators, ClxCarouselComponent, ClxCarouselDirective, ClxCartComponent, ClxCartSummaryDrawer, ClxCellDirective, ClxCheckboxComponent, ClxCollapseComponent, ClxColorPickerComponent, ClxColumnDefDirective, ClxDateRangePickerComponent, ClxDatepickerComponent, ClxDrawerComponent, ClxDrawerService, ClxEditorComponent, ClxEditorImageModalComponent, ClxEditorLinkModalComponent, ClxFabComponent, ClxFilterPanelComponent, ClxHeaderCellDirective, ClxIconComponent, ClxInputComponent, ClxListComponent, ClxListItemComponent, ClxMenuComponent, ClxMenuItemComponent, ClxMenuItemTrailingDirective, ClxModalComponent, ClxModalService, ClxNativeOverlayService, ClxNavGroupComponent, ClxNotificationComponent, ClxNumberComponent, ClxOtpComponent, ClxPageEmptyComponent, ClxPageHeaderComponent, ClxPageHeaderTitleDirective, ClxPageNotFoundComponent, ClxPageServerErrorComponent, ClxPageUnauthorizedComponent, ClxPaginationComponent, ClxProductComponent, ClxProductDetailComponent, ClxProductQuickViewComponent, ClxProfileComponent, ClxProgressBarComponent, ClxRadioComponent, ClxRadioGroupComponent, ClxRatingComponent, ClxSearchComponent, ClxSelectComponent, ClxSkeletonComponent, ClxSliderComponent, ClxSocialIconComponent, ClxSpinnerComponent, ClxStatCardComponent, ClxStepComponent, ClxStepperComponent, ClxSwitchComponent, ClxTabDirective, ClxTableActionsComponent, ClxTableComponent, ClxTabsComponent, ClxTagComponent, ClxTextareaComponent, ClxThemeService, ClxTimelineComponent, ClxTimelineItemComponent, ClxTimepickerComponent, ClxToastComponent, ClxToastContainerComponent, ClxToastService, ClxTooltipComponent, ClxTooltipDirective, ClxTreeComponent, ClxUploadComponent, ClxWishlistComponent, ClxWizardComponent, TIMEPICKER_SIZE_MAP, detectClxCardBrand, isClxCardExpired, parseColorInput, provideCodexlyTheme, resolveColor, resolveContainerRadius, resolveRadius };
-export type { ClxAlertButtonOptions, ClxAlertOptions, ClxAlertResult, ClxAlertType, ClxAnimateAttentionSeeker, ClxAnimateBackEntrance, ClxAnimateBackExit, ClxAnimateBouncingEntrance, ClxAnimateBouncingExit, ClxAnimateConfig, ClxAnimateDefaults, ClxAnimateEvent, ClxAnimateFadingEntrance, ClxAnimateFadingExit, ClxAnimateFlipper, ClxAnimateLightspeed, ClxAnimateName, ClxAnimateRotatingEntrance, ClxAnimateRotatingExit, ClxAnimateSlidingEntrance, ClxAnimateSlidingExit, ClxAnimateSpecial, ClxAnimateTrigger, ClxAnimateZoomingEntrance, ClxAnimateZoomingExit, ClxAvatarContentType, ClxBadgeVariant, ClxBrandSize, ClxButtonColor, ClxButtonGroupShape, ClxButtonVariant, ClxCardBrand, ClxCardPadding, ClxCardShadow, ClxCardTitleZoneStyle, ClxCardVariant, ClxCarouselAspectRatio, ClxCarouselConfig, ClxCartItem, ClxCartSummaryData, ClxCellContext, ClxCheckboxVariant, ClxCollapseDivider, ClxCollapseSize, ClxColor, ClxColorInput, ClxColorPickerFormat, ClxColorPickerSize, ClxColorResolved, ClxColorTokens, ClxCouponResult, ClxDateRange, ClxDateRangePickerSize, ClxDateRangePickerStatus, ClxDatepickerSize, ClxDatepickerStatus, ClxDrawerButtonOptions, ClxDrawerConfig, ClxDrawerPosition, ClxDrawerRef, ClxDrawerSize, ClxEditorSize, ClxEditorTool, ClxEditorToolbarGroup, ClxExistingFile, ClxFabItem, ClxFabPosition, ClxFilterChangeEvent, ClxFilterField, ClxFilterFieldType, ClxFilterOption, ClxFilterValue, ClxFilterValues, ClxFontFamily, ClxFontOption, ClxFontWeight, ClxFormControlsTheme, ClxInputSize, ClxInputStatus, ClxInputType, ClxListItem, ClxListItemLabelZoneStyle, ClxListSize, ClxListVariant, ClxModalButtonOptions, ClxModalConfig, ClxModalRef, ClxModalSize, ClxNavZoneStyle, ClxNotificationItem, ClxNotificationSeverity, ClxNotificationSeverityColors, ClxNotificationSize, ClxNotificationTheme, ClxNumberSize, ClxNumberVariant, ClxOtpSize, ClxPageChangeEvent, ClxPageHeaderTextSize, ClxPageHeaderZoneStyle, ClxPageSizeChangeEvent, ClxPaginationSize, ClxPaginationTheme, ClxProduct, ClxProductDescription, ClxProductDetailData, ClxProductLayout, ClxProductQuickViewData, ClxProductQuickViewResult, ClxProductSize, ClxProductSpec, ClxProfileMenuItem, ClxProgressBarSize, ClxProgressBarVariant, ClxRadioVariant, ClxResolvedCardTitleZoneStyle, ClxResolvedListItemLabelZoneStyle, ClxResolvedNavZoneStyle, ClxResolvedNotificationStyle, ClxResolvedPageHeaderZoneStyle, ClxResolvedPaginationStyle, ClxResolvedTableStyle, ClxResolvedTabsStyle, ClxResolvedTimelineTitleZoneStyle, ClxResolvedWizardStyle, ClxReview, ClxRippleItem, ClxSelectOption, ClxSelectSize, ClxShade, ClxShape, ClxSize, ClxSkeletonVariant, ClxSliderSize, ClxSocialPlatform, ClxSpecOption, ClxSpecType, ClxSpinnerColor, ClxSpinnerVariant, ClxStatMetric, ClxStepperOrientation, ClxStepperSize, ClxStepperStatus, ClxStepperStep, ClxTabItem, ClxTableColumn, ClxTablePageEvent, ClxTableSelectionEvent, ClxTableShadow, ClxTableSort, ClxTableSortEvent, ClxTableTheme, ClxTabsTheme, ClxTagShape, ClxTagSize, ClxTagVariant, ClxTextareaResize, ClxTextareaSize, ClxTextareaStatus, ClxThemeConfig, ClxThemeMode, ClxTimelineLineStyle, ClxTimelineMode, ClxTimelineSize, ClxTimelineTitleZoneStyle, ClxTimepickerSize, ClxTimepickerStatus, ClxToastAction, ClxToastEntry, ClxToastOptions, ClxToastPosition, ClxToastType, ClxTooltipPosition, ClxTooltipSize, ClxTreeExpandEvent, ClxTreeNode, ClxTreeSelectEvent, ClxTreeSize, ClxTreeVariant, ClxTrendDirection, ClxUploadError, ClxUploadItemAction, ClxUploadItemActionResolver, ClxUploadPreviewItem, ClxUploadSize, ClxVariation, ClxWishlistItem, ClxWishlistPageChangeEvent, ClxWizardColor, ClxWizardOrientation, ClxWizardStepStatus, ClxWizardTheme, NativeOverlayRef, SparkPoint };
+export { CLX_ADDON_BORDER, CLX_ADDON_TEXT, CLX_ALERT_OPTIONS, CLX_ALERT_RESOLVE, CLX_BG_ADDON, CLX_BG_DISABLED, CLX_BG_ICON_WRAP, CLX_BG_SECTION, CLX_BG_SURFACE, CLX_BORDER_DEFAULT, CLX_BORDER_DISABLED, CLX_BORDER_MEDIUM, CLX_COLOR_HEX, CLX_COLOR_HEX_100, CLX_COLOR_MAP, CLX_FONT_CATALOG, CLX_MODAL_ANIM_CONFIG, CLX_MODAL_DATA, CLX_MODAL_REF, CLX_OPTION_DISABLED, CLX_PLACEHOLDER, CLX_RADIO_GROUP, CLX_RADIUS_MAP, CLX_TEXT_BODY, CLX_TEXT_DISABLED, CLX_TEXT_HEADING, CLX_TEXT_HINT, CLX_TEXT_IDLE, CLX_TEXT_INPUT, CLX_TEXT_LABEL, CLX_TEXT_OPTION, CLX_TEXT_SUBTITLE, CLX_TEXT_TITLE, CLX_THEME_CONFIG, CLX_THEME_DEFAULTS, CLX_TOAST_DEFAULTS, ClxAlertComponent, ClxAlertService, ClxAnimateDirective, ClxAnimateGroupDirective, ClxAnimateService, ClxAppLayoutComponent, ClxAvatarComponent, ClxBadgeComponent, ClxBrandComponent, ClxButtonComponent, ClxButtonGroupComponent, ClxCardBodyDirective, ClxCardComponent, ClxCardExpiryInputComponent, ClxCardFooterDirective, ClxCardHeaderActionsDirective, ClxCardHeaderDirective, ClxCardNumberInputComponent, ClxCardValidators, ClxCarouselComponent, ClxCarouselDirective, ClxCartComponent, ClxCartSummaryDrawer, ClxCellDirective, ClxCheckboxComponent, ClxCollapseComponent, ClxColorPickerComponent, ClxColumnDefDirective, ClxDateRangePickerComponent, ClxDatepickerComponent, ClxDrawerComponent, ClxDrawerService, ClxEditorComponent, ClxEditorImageModalComponent, ClxEditorLinkModalComponent, ClxFabComponent, ClxFilterPanelComponent, ClxHeaderCellDirective, ClxIconComponent, ClxInputComponent, ClxListComponent, ClxListItemComponent, ClxMenuComponent, ClxMenuItemComponent, ClxMenuItemTrailingDirective, ClxModalComponent, ClxModalService, ClxNativeOverlayService, ClxNavGroupComponent, ClxNotificationComponent, ClxNumberComponent, ClxOtpComponent, ClxPageEmptyComponent, ClxPageHeaderComponent, ClxPageHeaderTitleDirective, ClxPageNotFoundComponent, ClxPageServerErrorComponent, ClxPageUnauthorizedComponent, ClxPaginationComponent, ClxProductComponent, ClxProductDetailComponent, ClxProductQuickViewComponent, ClxProfileComponent, ClxProgressBarComponent, ClxRadioComponent, ClxRadioGroupComponent, ClxRatingComponent, ClxSearchComponent, ClxSelectComponent, ClxSkeletonComponent, ClxSliderComponent, ClxSocialIconComponent, ClxSpinnerComponent, ClxStatCardComponent, ClxStepComponent, ClxStepperComponent, ClxSwitchComponent, ClxTabDirective, ClxTableActionsComponent, ClxTableComponent, ClxTabsComponent, ClxTagComponent, ClxTemplatePreviewComponent, ClxTextareaComponent, ClxThemeService, ClxTimelineComponent, ClxTimelineItemComponent, ClxTimepickerComponent, ClxToastComponent, ClxToastContainerComponent, ClxToastService, ClxTooltipComponent, ClxTooltipDirective, ClxTreeComponent, ClxUploadComponent, ClxWishlistComponent, ClxWizardComponent, TEMPLATE_PREVIEW_SAMPLE_VARS, TIMEPICKER_SIZE_MAP, detectClxCardBrand, isClxCardExpired, parseColorInput, provideCodexlyTheme, renderClxTemplate, resolveColor, resolveContainerRadius, resolveRadius };
+export type { ClxAlertButtonOptions, ClxAlertOptions, ClxAlertResult, ClxAlertType, ClxAnimateAttentionSeeker, ClxAnimateBackEntrance, ClxAnimateBackExit, ClxAnimateBouncingEntrance, ClxAnimateBouncingExit, ClxAnimateConfig, ClxAnimateDefaults, ClxAnimateEvent, ClxAnimateFadingEntrance, ClxAnimateFadingExit, ClxAnimateFlipper, ClxAnimateLightspeed, ClxAnimateName, ClxAnimateRotatingEntrance, ClxAnimateRotatingExit, ClxAnimateSlidingEntrance, ClxAnimateSlidingExit, ClxAnimateSpecial, ClxAnimateTrigger, ClxAnimateZoomingEntrance, ClxAnimateZoomingExit, ClxAvatarContentType, ClxBadgeVariant, ClxBrandSize, ClxButtonColor, ClxButtonGroupShape, ClxButtonVariant, ClxCardBrand, ClxCardPadding, ClxCardShadow, ClxCardTitleZoneStyle, ClxCardVariant, ClxCarouselAspectRatio, ClxCarouselConfig, ClxCartItem, ClxCartSummaryData, ClxCellContext, ClxCheckboxVariant, ClxCollapseDivider, ClxCollapseSize, ClxColor, ClxColorInput, ClxColorPickerFormat, ClxColorPickerSize, ClxColorResolved, ClxColorTokens, ClxCouponResult, ClxDateRange, ClxDateRangePickerSize, ClxDateRangePickerStatus, ClxDatepickerSize, ClxDatepickerStatus, ClxDrawerButtonOptions, ClxDrawerConfig, ClxDrawerPosition, ClxDrawerRef, ClxDrawerSize, ClxEditorSize, ClxEditorTool, ClxEditorToolbarGroup, ClxExistingFile, ClxFabItem, ClxFabPosition, ClxFilterChangeEvent, ClxFilterField, ClxFilterFieldType, ClxFilterOption, ClxFilterValue, ClxFilterValues, ClxFontFamily, ClxFontOption, ClxFontWeight, ClxFormControlsTheme, ClxInputSize, ClxInputStatus, ClxInputType, ClxListItem, ClxListItemLabelZoneStyle, ClxListSize, ClxListVariant, ClxModalButtonOptions, ClxModalConfig, ClxModalRef, ClxModalSize, ClxNavZoneStyle, ClxNotificationItem, ClxNotificationSeverity, ClxNotificationSeverityColors, ClxNotificationSize, ClxNotificationTheme, ClxNumberSize, ClxNumberVariant, ClxOtpSize, ClxPageChangeEvent, ClxPageHeaderTextSize, ClxPageHeaderZoneStyle, ClxPageSizeChangeEvent, ClxPaginationSize, ClxPaginationTheme, ClxProduct, ClxProductDescription, ClxProductDetailData, ClxProductLayout, ClxProductQuickViewData, ClxProductQuickViewResult, ClxProductSize, ClxProductSpec, ClxProfileMenuItem, ClxProgressBarSize, ClxProgressBarVariant, ClxRadioVariant, ClxResolvedCardTitleZoneStyle, ClxResolvedListItemLabelZoneStyle, ClxResolvedNavZoneStyle, ClxResolvedNotificationStyle, ClxResolvedPageHeaderZoneStyle, ClxResolvedPaginationStyle, ClxResolvedTableStyle, ClxResolvedTabsStyle, ClxResolvedTimelineTitleZoneStyle, ClxResolvedWizardStyle, ClxReview, ClxRippleItem, ClxSelectOption, ClxSelectSize, ClxShade, ClxShape, ClxSize, ClxSkeletonVariant, ClxSliderSize, ClxSocialPlatform, ClxSpecOption, ClxSpecType, ClxSpinnerColor, ClxSpinnerVariant, ClxStatMetric, ClxStepperOrientation, ClxStepperSize, ClxStepperStatus, ClxStepperStep, ClxTabItem, ClxTableColumn, ClxTablePageEvent, ClxTableSelectionEvent, ClxTableShadow, ClxTableSort, ClxTableSortEvent, ClxTableTheme, ClxTabsTheme, ClxTagShape, ClxTagSize, ClxTagVariant, ClxTemplatePreviewMode, ClxTextareaResize, ClxTextareaSize, ClxTextareaStatus, ClxThemeConfig, ClxThemeMode, ClxTimelineLineStyle, ClxTimelineMode, ClxTimelineSize, ClxTimelineTitleZoneStyle, ClxTimepickerSize, ClxTimepickerStatus, ClxToastAction, ClxToastEntry, ClxToastOptions, ClxToastPosition, ClxToastType, ClxTooltipPosition, ClxTooltipSize, ClxTreeExpandEvent, ClxTreeNode, ClxTreeSelectEvent, ClxTreeSize, ClxTreeVariant, ClxTrendDirection, ClxUploadError, ClxUploadItemAction, ClxUploadItemActionResolver, ClxUploadPreviewItem, ClxUploadSize, ClxVariation, ClxWishlistItem, ClxWishlistPageChangeEvent, ClxWizardColor, ClxWizardOrientation, ClxWizardStepStatus, ClxWizardTheme, NativeOverlayRef, SparkPoint };