@praxisui/cron-builder 8.0.0-beta.6 → 8.0.0-beta.61

package/README.md

@@ -132,6 +132,28 @@ The AI adapter exposes both the legacy `value` and the structured scheduler stat
 
 AI patches should prefer `schedule.kind` plus `schedule.recurrence` for business scheduling intent, and reserve `schedule.expression.cron` for explicit custom CRON requests.
 
+## Agentic Authoring
+
+The executable authoring contract is exported as `PRAXIS_CRON_BUILDER_AUTHORING_MANIFEST`.
+It models typed operations over the same schedule runtime used by the component:
+
+- `cron.expression.set`
+- `cron.frequency.set`
+- `cron.timezone.set`
+- `cron.preset.apply`
+- `cron.validate`
+- `cron.preview.generate`
+
+Expression, frequency, timezone and preset operations may patch canonical
+`schedule` or compatibility `value` paths only after validation succeeds.
+`cron.validate` and `cron.preview.generate` are read-only operations: invalid
+schedules return structured `diagnostics` and do not mutate the current schedule.
+
+Each operation declares `target.resolver`, `preconditions`, `validators`,
+`affectedPaths`, `effects` and typed `submissionImpact`. Expression, frequency,
+timezone and preset changes affect the submitted schedule value; validation and
+preview generation are diagnostics-only operations with no submission mutation.
+
 ## Build Notes
 
 The builder resolves validation, humanized descriptions and occurrence preview inside the library runtime.

package/fesm2022/praxisui-cron-builder.mjs

@@ -1181,16 +1181,16 @@ class PdxCronBuilderComponent {
         this.destroy$.next();
         this.destroy$.complete();
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: PdxCronBuilderComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "20.3.17", type: PdxCronBuilderComponent, isStandalone: true, selector: "pdx-cron-builder", inputs: { metadata: "metadata" }, providers: [
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: PdxCronBuilderComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: PdxCronBuilderComponent, isStandalone: true, selector: "pdx-cron-builder", inputs: { metadata: "metadata" }, providers: [
             {
                 provide: NG_VALUE_ACCESSOR,
                 useExisting: forwardRef(() => PdxCronBuilderComponent),
                 multi: true,
             },
-        ], ngImport: i0, template: "<div class=\"cron-builder-container\" (focusout)=\"onTouched()\">\n  @if (metadata.mode === 'both') {\n    <mat-tab-group\n      [selectedIndex]=\"selectedTabIndex\"\n      (selectedTabChange)=\"onTabChange($event)\"\n    >\n      <mat-tab label=\"Simple\"></mat-tab>\n      <mat-tab label=\"Advanced\"></mat-tab>\n    </mat-tab-group>\n  }\n\n  @if (value) {\n    <div class=\"cron-expression\">\n    <mat-form-field appearance=\"outline\" class=\"cron-expression-field\">\n      <mat-label>CRON Expression</mat-label>\n      <input matInput [value]=\"value\" readonly />\n      <button\n        mat-icon-button\n        matSuffix\n        (click)=\"copyCron()\"\n        [matTooltip]=\"'Copy to clipboard'\"\n        aria-label=\"Copy CRON expression\"\n      >\n        <mat-icon [praxisIcon]=\"'content_copy'\"></mat-icon>\n      </button>\n    </mat-form-field>\n    <button mat-button (click)=\"importCron()\">Import CRON</button>\n    </div>\n  }\n\n  @switch (activeTab) {\n    @case ('simple') {\n      <div [formGroup]=\"simpleForm\" class=\"simple-mode\">\n      <mat-form-field appearance=\"outline\" class=\"preset-select\">\n        <mat-label>Preset</mat-label>\n        <mat-select formControlName=\"type\">\n          <mat-option value=\"everyNMinutes\">A cada X min</mat-option>\n          <mat-option value=\"dailyAt\">Diariamente \u00E0s</mat-option>\n          <mat-option value=\"weekly\">Semanal (dias marcados) \u00E0s</mat-option>\n          <mat-option value=\"monthlyDay\">Mensal (dia N) \u00E0s</mat-option>\n          <mat-option value=\"monthlyNthWeekday\">\n            Mensal (N-\u00E9sima 2\u00AA-feira) \u00E0s\n          </mat-option>\n        </mat-select>\n      </mat-form-field>\n\n        @switch (simpleControls.type.value) {\n          @case ('everyNMinutes') {\n            <div class=\"preset-body\">\n          <mat-slider\n            min=\"1\"\n            max=\"60\"\n            step=\"1\"\n            thumbLabel\n          >\n            <input matSliderThumb formControlName=\"everyN\" />\n          </mat-slider>\n          <div class=\"cron-hint\">\n                A cada {{ simpleControls.everyN.value }} minutos\n          </div>\n            </div>\n          }\n\n          @case ('dailyAt') {\n            <div class=\"preset-body\">\n          <mat-form-field appearance=\"outline\">\n            <mat-label>Hora</mat-label>\n            <input matInput type=\"time\" formControlName=\"dailyTime\" />\n          </mat-form-field>\n          <div class=\"cron-hint\">\n                Diariamente \u00E0s {{ simpleControls.dailyTime.value }}\n          </div>\n            </div>\n          }\n\n          @case ('weekly') {\n            <div class=\"preset-body\">\n          <mat-chip-listbox formControlName=\"weeklyDays\" multiple>\n              @for (day of weeklyDayOptions; track day) {\n                <mat-chip-option [value]=\"day\">\n                  {{ weekdayLabels[day] }}\n                </mat-chip-option>\n              }\n          </mat-chip-listbox>\n          <mat-form-field appearance=\"outline\">\n            <mat-label>Hora</mat-label>\n            <input matInput type=\"time\" formControlName=\"weeklyTime\" />\n          </mat-form-field>\n          <div class=\"cron-hint\">\n                Semanalmente \u00E0s {{ simpleControls.weeklyTime.value }}\n          </div>\n            </div>\n          }\n\n          @case ('monthlyDay') {\n            <div class=\"preset-body\">\n          <mat-form-field appearance=\"outline\">\n            <mat-label>Dia</mat-label>\n            <input\n              matInput\n              type=\"number\"\n              formControlName=\"monthlyDay\"\n              min=\"1\"\n              max=\"31\"\n            />\n          </mat-form-field>\n          <mat-form-field appearance=\"outline\">\n            <mat-label>Hora</mat-label>\n            <input matInput type=\"time\" formControlName=\"monthlyTime\" />\n          </mat-form-field>\n          <div class=\"cron-hint\">\n                Dia {{ simpleControls.monthlyDay.value }} \u00E0s\n                {{ simpleControls.monthlyTime.value }}\n          </div>\n            </div>\n          }\n\n          @case ('monthlyNthWeekday') {\n            <div class=\"preset-body\">\n          <mat-form-field appearance=\"outline\">\n            <mat-label>N-\u00E9sima</mat-label>\n            <mat-select formControlName=\"nth\">\n                @for (nth of nthOrderOptions; track nth) {\n                  <mat-option [value]=\"nth\">{{ nth }}\u00AA</mat-option>\n                }\n            </mat-select>\n          </mat-form-field>\n          <mat-chip-listbox formControlName=\"nthDay\">\n              @for (day of nthDayOptions; track day) {\n                <mat-chip-option [value]=\"day\">\n                  {{ weekdayLabels[day] }}\n                </mat-chip-option>\n              }\n          </mat-chip-listbox>\n          <mat-form-field appearance=\"outline\">\n            <mat-label>Hora</mat-label>\n            <input matInput type=\"time\" formControlName=\"nthTime\" />\n          </mat-form-field>\n          <div class=\"cron-hint\">\n                {{ simpleControls.nth.value }}\u00AA\n                {{ weekdayLabels[simpleControls.nthDay.value] }}\n                \u00E0s\n                {{ simpleControls.nthTime.value }}\n          </div>\n            </div>\n          }\n        }\n      </div>\n    }\n\n    @case ('advanced') {\n      <div [formGroup]=\"form\">\n        <div class=\"cron-fields\">\n          @if (metadata.fields?.minutes) {\n            <mat-form-field>\n              <mat-label>Minutes</mat-label>\n              <input matInput formControlName=\"minutes\" />\n            </mat-form-field>\n          }\n          @if (metadata.fields?.hours) {\n            <mat-form-field>\n              <mat-label>Hours</mat-label>\n              <input matInput formControlName=\"hours\" />\n            </mat-form-field>\n          }\n          @if (metadata.fields?.dom) {\n            <mat-form-field>\n              <mat-label>Day of Month</mat-label>\n              <input matInput formControlName=\"dayOfMonth\" />\n            </mat-form-field>\n          }\n          @if (metadata.fields?.month) {\n            <mat-form-field>\n              <mat-label>Month</mat-label>\n              <input matInput formControlName=\"month\" />\n            </mat-form-field>\n          }\n          @if (metadata.fields?.dow) {\n            <mat-form-field>\n              <mat-label>Day of Week</mat-label>\n              <input matInput formControlName=\"dayOfWeek\" />\n            </mat-form-field>\n          }\n          @if (metadata.fields?.seconds) {\n            <mat-form-field>\n              <mat-label>Seconds</mat-label>\n              <input matInput formControlName=\"seconds\" />\n            </mat-form-field>\n          }\n        </div>\n      </div>\n    }\n  }\n\n  <div class=\"cron-feedback\">\n    <mat-form-field appearance=\"outline\" class=\"timezone-field\">\n      <mat-label>Timezone</mat-label>\n      <mat-select [formControl]=\"timezoneControl\">\n        @for (tz of timezoneOptions; track tz) {\n          <mat-option [value]=\"tz\">\n            {{ tz }}\n          </mat-option>\n        }\n      </mat-select>\n    </mat-form-field>\n\n    @if (humanized) {\n      <div class=\"humanized-description\" aria-live=\"polite\">\n        {{ humanized }}\n      <button\n        mat-icon-button\n        class=\"copy-humanized\"\n        (click)=\"copyHumanized()\"\n        [matTooltip]=\"'Copy description'\"\n        aria-label=\"Copy description\"\n      >\n        <mat-icon [praxisIcon]=\"'content_copy'\"></mat-icon>\n        </button>\n      </div>\n    }\n\n    @if (error) {\n      <div class=\"cron-error\">{{ error }}</div>\n    }\n\n    @if (preview.length > 0) {\n      <div class=\"preview-section\">\n        <h4>Next Occurrences:</h4>\n        <mat-list>\n          @for (date of preview; track $index) {\n            <mat-list-item>\n              {{\n                date\n                  | date\n                    : \"full\"\n                    : timezoneControl.value\n                    : metadata.locale || \"pt-BR\"\n              }}\n            </mat-list-item>\n          }\n        </mat-list>\n      </div>\n    }\n  </div>\n\n  @if (metadata.hint) {\n    <div class=\"cron-hint\">{{ metadata.hint }}</div>\n  }\n</div>\n", styles: [":host{display:block}.cron-expression-field{width:100%}.cron-expression{margin-bottom:1rem}.simple-mode{display:flex;flex-direction:column;gap:1rem}.preset-body{display:flex;flex-direction:column;gap:.5rem}.cron-feedback{margin-top:1rem;display:flex;flex-direction:column;gap:.5rem}.humanized-description{display:flex;align-items:center;gap:.5rem}.timezone-field{width:250px}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "ngmodule", type: ReactiveFormsModule }, { kind: "directive", type: i1.DefaultValueAccessor, selector: "input:not([type=checkbox])[formControlName],textarea[formControlName],input:not([type=checkbox])[formControl],textarea[formControl],input:not([type=checkbox])[ngModel],textarea[ngModel],[ngDefaultControl]" }, { kind: "directive", type: i1.NumberValueAccessor, selector: "input[type=number][formControlName],input[type=number][formControl],input[type=number][ngModel]" }, { kind: "directive", type: i1.NgControlStatus, selector: "[formControlName],[ngModel],[formControl]" }, { kind: "directive", type: i1.NgControlStatusGroup, selector: "[formGroupName],[formArrayName],[ngModelGroup],[formGroup],form:not([ngNoForm]),[ngForm]" }, { kind: "directive", type: i1.MinValidator, selector: "input[type=number][min][formControlName],input[type=number][min][formControl],input[type=number][min][ngModel]", inputs: ["min"] }, { kind: "directive", type: i1.MaxValidator, selector: "input[type=number][max][formControlName],input[type=number][max][formControl],input[type=number][max][ngModel]", inputs: ["max"] }, { kind: "directive", type: i1.FormControlDirective, selector: "[formControl]", inputs: ["formControl", "disabled", "ngModel"], outputs: ["ngModelChange"], exportAs: ["ngForm"] }, { kind: "directive", type: i1.FormGroupDirective, selector: "[formGroup]", inputs: ["formGroup"], outputs: ["ngSubmit"], exportAs: ["ngForm"] }, { kind: "directive", type: i1.FormControlName, selector: "[formControlName]", inputs: ["formControlName", "disabled", "ngModel"], outputs: ["ngModelChange"] }, { kind: "ngmodule", type: MatTabsModule }, { kind: "component", type: i2.MatTab, selector: "mat-tab", inputs: ["disabled", "label", "aria-label", "aria-labelledby", "labelClass", "bodyClass", "id"], exportAs: ["matTab"] }, { kind: "component", type: i2.MatTabGroup, selector: "mat-tab-group", inputs: ["color", "fitInkBarToContent", "mat-stretch-tabs", "mat-align-tabs", "dynamicHeight", "selectedIndex", "headerPosition", "animationDuration", "contentTabIndex", "disablePagination", "disableRipple", "preserveContent", "backgroundColor", "aria-label", "aria-labelledby"], outputs: ["selectedIndexChange", "focusChange", "animationDone", "selectedTabChange"], exportAs: ["matTabGroup"] }, { kind: "ngmodule", type: MatRadioModule }, { kind: "ngmodule", type: MatSelectModule }, { kind: "component", type: i3.MatFormField, selector: "mat-form-field", inputs: ["hideRequiredMarker", "color", "floatLabel", "appearance", "subscriptSizing", "hintLabel"], exportAs: ["matFormField"] }, { kind: "directive", type: i3.MatLabel, selector: "mat-label" }, { kind: "directive", type: i3.MatSuffix, selector: "[matSuffix], [matIconSuffix], [matTextSuffix]", inputs: ["matTextSuffix"] }, { kind: "component", type: i3.MatSelect, selector: "mat-select", inputs: ["aria-describedby", "panelClass", "disabled", "disableRipple", "tabIndex", "hideSingleSelectionIndicator", "placeholder", "required", "multiple", "disableOptionCentering", "compareWith", "value", "aria-label", "aria-labelledby", "errorStateMatcher", "typeaheadDebounceInterval", "sortComparator", "id", "panelWidth", "canSelectNullableOptions"], outputs: ["openedChange", "opened", "closed", "selectionChange", "valueChange"], exportAs: ["matSelect"] }, { kind: "component", type: i3.MatOption, selector: "mat-option", inputs: ["value", "id", "disabled"], outputs: ["onSelectionChange"], exportAs: ["matOption"] }, { kind: "ngmodule", type: MatInputModule }, { kind: "directive", type: i4.MatInput, selector: "input[matInput], textarea[matInput], select[matNativeControl],      input[matNativeControl], textarea[matNativeControl]", inputs: ["disabled", "id", "placeholder", "name", "required", "type", "errorStateMatcher", "aria-describedby", "value", "readonly", "disabledInteractive"], exportAs: ["matInput"] }, { kind: "ngmodule", type: MatFormFieldModule }, { kind: "ngmodule", type: MatListModule }, { kind: "component", type: i5.MatList, selector: "mat-list", exportAs: ["matList"] }, { kind: "component", type: i5.MatListItem, selector: "mat-list-item, a[mat-list-item], button[mat-list-item]", inputs: ["activated"], exportAs: ["matListItem"] }, { kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i6.MatButton, selector: "    button[matButton], a[matButton], button[mat-button], button[mat-raised-button],    button[mat-flat-button], button[mat-stroked-button], a[mat-button], a[mat-raised-button],    a[mat-flat-button], a[mat-stroked-button]  ", inputs: ["matButton"], exportAs: ["matButton", "matAnchor"] }, { kind: "component", type: i6.MatIconButton, selector: "button[mat-icon-button], a[mat-icon-button], button[matIconButton], a[matIconButton]", exportAs: ["matButton", "matAnchor"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i7.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "ngmodule", type: MatTooltipModule }, { kind: "directive", type: i8.MatTooltip, selector: "[matTooltip]", inputs: ["matTooltipPosition", "matTooltipPositionAtOrigin", "matTooltipDisabled", "matTooltipShowDelay", "matTooltipHideDelay", "matTooltipTouchGestures", "matTooltip", "matTooltipClass"], exportAs: ["matTooltip"] }, { kind: "ngmodule", type: MatSliderModule }, { kind: "component", type: i9.MatSlider, selector: "mat-slider", inputs: ["disabled", "discrete", "showTickMarks", "min", "color", "disableRipple", "max", "step", "displayWith"], exportAs: ["matSlider"] }, { kind: "directive", type: i9.MatSliderThumb, selector: "input[matSliderThumb]", inputs: ["value"], outputs: ["valueChange", "dragStart", "dragEnd"], exportAs: ["matSliderThumb"] }, { kind: "ngmodule", type: MatChipsModule }, { kind: "component", type: i10.MatChipListbox, selector: "mat-chip-listbox", inputs: ["multiple", "aria-orientation", "selectable", "compareWith", "required", "hideSingleSelectionIndicator", "value"], outputs: ["change"] }, { kind: "component", type: i10.MatChipOption, selector: "mat-basic-chip-option, [mat-basic-chip-option], mat-chip-option, [mat-chip-option]", inputs: ["selectable", "selected"], outputs: ["selectionChange"] }, { kind: "ngmodule", type: MatSnackBarModule }, { kind: "directive", type: PraxisIconDirective, selector: "mat-icon[praxisIcon]", inputs: ["praxisIcon"] }, { kind: "pipe", type: i11.DatePipe, name: "date" }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+        ], ngImport: i0, template: "<div class=\"cron-builder-container\" (focusout)=\"onTouched()\">\n  @if (metadata.mode === 'both') {\n    <mat-tab-group\n      [selectedIndex]=\"selectedTabIndex\"\n      (selectedTabChange)=\"onTabChange($event)\"\n    >\n      <mat-tab label=\"Simple\"></mat-tab>\n      <mat-tab label=\"Advanced\"></mat-tab>\n    </mat-tab-group>\n  }\n\n  @if (value) {\n    <div class=\"cron-expression\">\n    <mat-form-field appearance=\"outline\" class=\"cron-expression-field\">\n      <mat-label>CRON Expression</mat-label>\n      <input matInput [value]=\"value\" readonly />\n      <button\n        mat-icon-button\n        matSuffix\n        (click)=\"copyCron()\"\n        [matTooltip]=\"'Copy to clipboard'\"\n        aria-label=\"Copy CRON expression\"\n      >\n        <mat-icon [praxisIcon]=\"'content_copy'\"></mat-icon>\n      </button>\n    </mat-form-field>\n    <button mat-button (click)=\"importCron()\">Import CRON</button>\n    </div>\n  }\n\n  @switch (activeTab) {\n    @case ('simple') {\n      <div [formGroup]=\"simpleForm\" class=\"simple-mode\">\n      <mat-form-field appearance=\"outline\" class=\"preset-select\">\n        <mat-label>Preset</mat-label>\n        <mat-select formControlName=\"type\">\n          <mat-option value=\"everyNMinutes\">A cada X min</mat-option>\n          <mat-option value=\"dailyAt\">Diariamente \u00E0s</mat-option>\n          <mat-option value=\"weekly\">Semanal (dias marcados) \u00E0s</mat-option>\n          <mat-option value=\"monthlyDay\">Mensal (dia N) \u00E0s</mat-option>\n          <mat-option value=\"monthlyNthWeekday\">\n            Mensal (N-\u00E9sima 2\u00AA-feira) \u00E0s\n          </mat-option>\n        </mat-select>\n      </mat-form-field>\n\n        @switch (simpleControls.type.value) {\n          @case ('everyNMinutes') {\n            <div class=\"preset-body\">\n          <mat-slider\n            min=\"1\"\n            max=\"60\"\n            step=\"1\"\n            thumbLabel\n          >\n            <input matSliderThumb formControlName=\"everyN\" />\n          </mat-slider>\n          <div class=\"cron-hint\">\n                A cada {{ simpleControls.everyN.value }} minutos\n          </div>\n            </div>\n          }\n\n          @case ('dailyAt') {\n            <div class=\"preset-body\">\n          <mat-form-field appearance=\"outline\">\n            <mat-label>Hora</mat-label>\n            <input matInput type=\"time\" formControlName=\"dailyTime\" />\n          </mat-form-field>\n          <div class=\"cron-hint\">\n                Diariamente \u00E0s {{ simpleControls.dailyTime.value }}\n          </div>\n            </div>\n          }\n\n          @case ('weekly') {\n            <div class=\"preset-body\">\n          <mat-chip-listbox formControlName=\"weeklyDays\" multiple>\n              @for (day of weeklyDayOptions; track day) {\n                <mat-chip-option [value]=\"day\">\n                  {{ weekdayLabels[day] }}\n                </mat-chip-option>\n              }\n          </mat-chip-listbox>\n          <mat-form-field appearance=\"outline\">\n            <mat-label>Hora</mat-label>\n            <input matInput type=\"time\" formControlName=\"weeklyTime\" />\n          </mat-form-field>\n          <div class=\"cron-hint\">\n                Semanalmente \u00E0s {{ simpleControls.weeklyTime.value }}\n          </div>\n            </div>\n          }\n\n          @case ('monthlyDay') {\n            <div class=\"preset-body\">\n          <mat-form-field appearance=\"outline\">\n            <mat-label>Dia</mat-label>\n            <input\n              matInput\n              type=\"number\"\n              formControlName=\"monthlyDay\"\n              min=\"1\"\n              max=\"31\"\n            />\n          </mat-form-field>\n          <mat-form-field appearance=\"outline\">\n            <mat-label>Hora</mat-label>\n            <input matInput type=\"time\" formControlName=\"monthlyTime\" />\n          </mat-form-field>\n          <div class=\"cron-hint\">\n                Dia {{ simpleControls.monthlyDay.value }} \u00E0s\n                {{ simpleControls.monthlyTime.value }}\n          </div>\n            </div>\n          }\n\n          @case ('monthlyNthWeekday') {\n            <div class=\"preset-body\">\n          <mat-form-field appearance=\"outline\">\n            <mat-label>N-\u00E9sima</mat-label>\n            <mat-select formControlName=\"nth\">\n                @for (nth of nthOrderOptions; track nth) {\n                  <mat-option [value]=\"nth\">{{ nth }}\u00AA</mat-option>\n                }\n            </mat-select>\n          </mat-form-field>\n          <mat-chip-listbox formControlName=\"nthDay\">\n              @for (day of nthDayOptions; track day) {\n                <mat-chip-option [value]=\"day\">\n                  {{ weekdayLabels[day] }}\n                </mat-chip-option>\n              }\n          </mat-chip-listbox>\n          <mat-form-field appearance=\"outline\">\n            <mat-label>Hora</mat-label>\n            <input matInput type=\"time\" formControlName=\"nthTime\" />\n          </mat-form-field>\n          <div class=\"cron-hint\">\n                {{ simpleControls.nth.value }}\u00AA\n                {{ weekdayLabels[simpleControls.nthDay.value] }}\n                \u00E0s\n                {{ simpleControls.nthTime.value }}\n          </div>\n            </div>\n          }\n        }\n      </div>\n    }\n\n    @case ('advanced') {\n      <div [formGroup]=\"form\">\n        <div class=\"cron-fields\">\n          @if (metadata.fields?.minutes) {\n            <mat-form-field>\n              <mat-label>Minutes</mat-label>\n              <input matInput formControlName=\"minutes\" />\n            </mat-form-field>\n          }\n          @if (metadata.fields?.hours) {\n            <mat-form-field>\n              <mat-label>Hours</mat-label>\n              <input matInput formControlName=\"hours\" />\n            </mat-form-field>\n          }\n          @if (metadata.fields?.dom) {\n            <mat-form-field>\n              <mat-label>Day of Month</mat-label>\n              <input matInput formControlName=\"dayOfMonth\" />\n            </mat-form-field>\n          }\n          @if (metadata.fields?.month) {\n            <mat-form-field>\n              <mat-label>Month</mat-label>\n              <input matInput formControlName=\"month\" />\n            </mat-form-field>\n          }\n          @if (metadata.fields?.dow) {\n            <mat-form-field>\n              <mat-label>Day of Week</mat-label>\n              <input matInput formControlName=\"dayOfWeek\" />\n            </mat-form-field>\n          }\n          @if (metadata.fields?.seconds) {\n            <mat-form-field>\n              <mat-label>Seconds</mat-label>\n              <input matInput formControlName=\"seconds\" />\n            </mat-form-field>\n          }\n        </div>\n      </div>\n    }\n  }\n\n  <div class=\"cron-feedback\">\n    <mat-form-field appearance=\"outline\" class=\"timezone-field\">\n      <mat-label>Timezone</mat-label>\n      <mat-select [formControl]=\"timezoneControl\">\n        @for (tz of timezoneOptions; track tz) {\n          <mat-option [value]=\"tz\">\n            {{ tz }}\n          </mat-option>\n        }\n      </mat-select>\n    </mat-form-field>\n\n    @if (humanized) {\n      <div class=\"humanized-description\" aria-live=\"polite\">\n        {{ humanized }}\n      <button\n        mat-icon-button\n        class=\"copy-humanized\"\n        (click)=\"copyHumanized()\"\n        [matTooltip]=\"'Copy description'\"\n        aria-label=\"Copy description\"\n      >\n        <mat-icon [praxisIcon]=\"'content_copy'\"></mat-icon>\n        </button>\n      </div>\n    }\n\n    @if (error) {\n      <div class=\"cron-error\">{{ error }}</div>\n    }\n\n    @if (preview.length > 0) {\n      <div class=\"preview-section\">\n        <h4>Next Occurrences:</h4>\n        <mat-list>\n          @for (date of preview; track $index) {\n            <mat-list-item>\n              {{\n                date\n                  | date\n                    : \"full\"\n                    : timezoneControl.value\n                    : metadata.locale || \"pt-BR\"\n              }}\n            </mat-list-item>\n          }\n        </mat-list>\n      </div>\n    }\n  </div>\n\n  @if (metadata.hint) {\n    <div class=\"cron-hint\">{{ metadata.hint }}</div>\n  }\n</div>\n", styles: [":host{display:block}.cron-expression-field{width:100%}.cron-expression{margin-bottom:1rem}.simple-mode{display:flex;flex-direction:column;gap:1rem}.preset-body{display:flex;flex-direction:column;gap:.5rem}.cron-feedback{margin-top:1rem;display:flex;flex-direction:column;gap:.5rem}.humanized-description{display:flex;align-items:center;gap:.5rem}.timezone-field{width:250px}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "ngmodule", type: ReactiveFormsModule }, { kind: "directive", type: i1.DefaultValueAccessor, selector: "input:not([type=checkbox])[formControlName],textarea[formControlName],input:not([type=checkbox])[formControl],textarea[formControl],input:not([type=checkbox])[ngModel],textarea[ngModel],[ngDefaultControl]" }, { kind: "directive", type: i1.NumberValueAccessor, selector: "input[type=number][formControlName],input[type=number][formControl],input[type=number][ngModel]" }, { kind: "directive", type: i1.NgControlStatus, selector: "[formControlName],[ngModel],[formControl]" }, { kind: "directive", type: i1.NgControlStatusGroup, selector: "[formGroupName],[formArrayName],[ngModelGroup],[formGroup],[formArray],form:not([ngNoForm]),[ngForm]" }, { kind: "directive", type: i1.MinValidator, selector: "input[type=number][min][formControlName],input[type=number][min][formControl],input[type=number][min][ngModel]", inputs: ["min"] }, { kind: "directive", type: i1.MaxValidator, selector: "input[type=number][max][formControlName],input[type=number][max][formControl],input[type=number][max][ngModel]", inputs: ["max"] }, { kind: "directive", type: i1.FormControlDirective, selector: "[formControl]", inputs: ["formControl", "disabled", "ngModel"], outputs: ["ngModelChange"], exportAs: ["ngForm"] }, { kind: "directive", type: i1.FormGroupDirective, selector: "[formGroup]", inputs: ["formGroup"], outputs: ["ngSubmit"], exportAs: ["ngForm"] }, { kind: "directive", type: i1.FormControlName, selector: "[formControlName]", inputs: ["formControlName", "disabled", "ngModel"], outputs: ["ngModelChange"] }, { kind: "ngmodule", type: MatTabsModule }, { kind: "component", type: i2.MatTab, selector: "mat-tab", inputs: ["disabled", "label", "aria-label", "aria-labelledby", "labelClass", "bodyClass", "id"], exportAs: ["matTab"] }, { kind: "component", type: i2.MatTabGroup, selector: "mat-tab-group", inputs: ["color", "fitInkBarToContent", "mat-stretch-tabs", "mat-align-tabs", "dynamicHeight", "selectedIndex", "headerPosition", "animationDuration", "contentTabIndex", "disablePagination", "disableRipple", "preserveContent", "backgroundColor", "aria-label", "aria-labelledby"], outputs: ["selectedIndexChange", "focusChange", "animationDone", "selectedTabChange"], exportAs: ["matTabGroup"] }, { kind: "ngmodule", type: MatRadioModule }, { kind: "ngmodule", type: MatSelectModule }, { kind: "component", type: i3.MatFormField, selector: "mat-form-field", inputs: ["hideRequiredMarker", "color", "floatLabel", "appearance", "subscriptSizing", "hintLabel"], exportAs: ["matFormField"] }, { kind: "directive", type: i3.MatLabel, selector: "mat-label" }, { kind: "directive", type: i3.MatSuffix, selector: "[matSuffix], [matIconSuffix], [matTextSuffix]", inputs: ["matTextSuffix"] }, { kind: "component", type: i3.MatSelect, selector: "mat-select", inputs: ["aria-describedby", "panelClass", "disabled", "disableRipple", "tabIndex", "hideSingleSelectionIndicator", "placeholder", "required", "multiple", "disableOptionCentering", "compareWith", "value", "aria-label", "aria-labelledby", "errorStateMatcher", "typeaheadDebounceInterval", "sortComparator", "id", "panelWidth", "canSelectNullableOptions"], outputs: ["openedChange", "opened", "closed", "selectionChange", "valueChange"], exportAs: ["matSelect"] }, { kind: "component", type: i3.MatOption, selector: "mat-option", inputs: ["value", "id", "disabled"], outputs: ["onSelectionChange"], exportAs: ["matOption"] }, { kind: "ngmodule", type: MatInputModule }, { kind: "directive", type: i4.MatInput, selector: "input[matInput], textarea[matInput], select[matNativeControl],      input[matNativeControl], textarea[matNativeControl]", inputs: ["disabled", "id", "placeholder", "name", "required", "type", "errorStateMatcher", "aria-describedby", "value", "readonly", "disabledInteractive"], exportAs: ["matInput"] }, { kind: "ngmodule", type: MatFormFieldModule }, { kind: "ngmodule", type: MatListModule }, { kind: "component", type: i5.MatList, selector: "mat-list", exportAs: ["matList"] }, { kind: "component", type: i5.MatListItem, selector: "mat-list-item, a[mat-list-item], button[mat-list-item]", inputs: ["activated"], exportAs: ["matListItem"] }, { kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i6.MatButton, selector: "    button[matButton], a[matButton], button[mat-button], button[mat-raised-button],    button[mat-flat-button], button[mat-stroked-button], a[mat-button], a[mat-raised-button],    a[mat-flat-button], a[mat-stroked-button]  ", inputs: ["matButton"], exportAs: ["matButton", "matAnchor"] }, { kind: "component", type: i6.MatIconButton, selector: "button[mat-icon-button], a[mat-icon-button], button[matIconButton], a[matIconButton]", exportAs: ["matButton", "matAnchor"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i7.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "ngmodule", type: MatTooltipModule }, { kind: "directive", type: i8.MatTooltip, selector: "[matTooltip]", inputs: ["matTooltipPosition", "matTooltipPositionAtOrigin", "matTooltipDisabled", "matTooltipShowDelay", "matTooltipHideDelay", "matTooltipTouchGestures", "matTooltip", "matTooltipClass"], exportAs: ["matTooltip"] }, { kind: "ngmodule", type: MatSliderModule }, { kind: "component", type: i9.MatSlider, selector: "mat-slider", inputs: ["disabled", "discrete", "showTickMarks", "min", "color", "disableRipple", "max", "step", "displayWith"], exportAs: ["matSlider"] }, { kind: "directive", type: i9.MatSliderThumb, selector: "input[matSliderThumb]", inputs: ["value"], outputs: ["valueChange", "dragStart", "dragEnd"], exportAs: ["matSliderThumb"] }, { kind: "ngmodule", type: MatChipsModule }, { kind: "component", type: i10.MatChipListbox, selector: "mat-chip-listbox", inputs: ["multiple", "aria-orientation", "selectable", "compareWith", "required", "hideSingleSelectionIndicator", "value"], outputs: ["change"] }, { kind: "component", type: i10.MatChipOption, selector: "mat-basic-chip-option, [mat-basic-chip-option], mat-chip-option, [mat-chip-option]", inputs: ["selectable", "selected"], outputs: ["selectionChange"] }, { kind: "ngmodule", type: MatSnackBarModule }, { kind: "directive", type: PraxisIconDirective, selector: "mat-icon[praxisIcon]", inputs: ["praxisIcon"] }, { kind: "pipe", type: i11.DatePipe, name: "date" }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: PdxCronBuilderComponent, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: PdxCronBuilderComponent, decorators: [{
             type: Component,
             args: [{ selector: 'pdx-cron-builder', standalone: true, imports: [
                         CommonModule,
@@ -1336,6 +1336,294 @@ const CRON_BUILDER_AI_CAPABILITIES = {
     ],
 };
 
+const PRAXIS_CRON_BUILDER_AUTHORING_MANIFEST = {
+    schemaVersion: '1.0.0',
+    componentId: 'pdx-cron-builder',
+    ownerPackage: '@praxisui/cron-builder',
+    configSchemaId: 'CronBuilderMetadata',
+    manifestVersion: '1.0.0',
+    runtimeInputs: [
+        { name: 'metadata', type: 'CronBuilderMetadata', description: 'Builder UI, timezone, locale, presets, validation and preview configuration.' },
+        { name: 'value', type: 'string | ScheduleAuthoringConfig', description: 'Current CRON string compatibility value or canonical schedule authoring config.' },
+        { name: 'disabled', type: 'boolean', description: 'ControlValueAccessor disabled state.' },
+    ],
+    editableTargets: [
+        { kind: 'expression', resolver: 'schedule-expression', description: 'Canonical CRON expression under schedule.expression or legacy value.' },
+        { kind: 'frequency', resolver: 'schedule-kind-and-recurrence', description: 'Business recurrence intent compiled into a canonical expression.' },
+        { kind: 'timezone', resolver: 'schedule-timezone', description: 'IANA timezone used for preview and schedule metadata.' },
+        { kind: 'preview', resolver: 'schedule-preview-config', description: 'Read-only preview generation request for next occurrences.' },
+        { kind: 'validation', resolver: 'schedule-validation-request', description: 'Read-only validation diagnostics request for expression or schedule config.' },
+        { kind: 'preset', resolver: 'cron-preset-by-label-or-expression', description: 'Preset entry in metadata.presets[] or top-level presets[].' },
+    ],
+    operations: [
+        {
+            operationId: 'cron.expression.set',
+            title: 'Set CRON expression',
+            scope: 'global',
+            targetKind: 'expression',
+            target: { kind: 'expression', resolver: 'schedule-expression', ambiguityPolicy: 'fail', required: false },
+            inputSchema: {
+                type: 'object',
+                required: ['cron'],
+                properties: {
+                    cron: { type: 'string' },
+                    dialect: { enum: ['unix', 'quartz', 'aws-eventbridge', 'kubernetes', 'github-actions', 'gcp-scheduler'] },
+                    seconds: { type: 'boolean' },
+                },
+            },
+            effects: [{
+                    kind: 'compile-domain-patch',
+                    handler: 'cron-expression-set',
+                    handlerContract: {
+                        reads: ['schedule.expression', 'schedule.timezone', 'metadata.timezone', 'value'],
+                        writes: ['schedule.kind', 'schedule.expression', 'value', 'diagnostics'],
+                        identityKeys: ['schedule.expression.cron', 'schedule.expression.dialect'],
+                        inputSchema: {
+                            type: 'object',
+                            required: ['cron'],
+                            properties: {
+                                cron: { type: 'string' },
+                                dialect: { enum: ['unix', 'quartz', 'aws-eventbridge', 'kubernetes', 'github-actions', 'gcp-scheduler'] },
+                                seconds: { type: 'boolean' },
+                            },
+                        },
+                        failureModes: ['invalid-expression', 'invalid-dialect', 'seconds-field-mismatch'],
+                        description: 'Validates and normalizes an explicit CRON expression before writing schedule.expression and the compatibility value.',
+                    },
+                }],
+            destructive: false,
+            requiresConfirmation: false,
+            validators: ['cron-expression-valid', 'cron-dialect-compatible', 'editor-runtime-round-trip'],
+            affectedPaths: ['schedule.kind', 'schedule.expression', 'schedule.expression.cron', 'schedule.expression.dialect', 'schedule.expression.seconds', 'value', 'diagnostics'],
+            submissionImpact: 'affects-submission',
+            preconditions: ['config-initialized'],
+        },
+        {
+            operationId: 'cron.frequency.set',
+            title: 'Set schedule frequency',
+            scope: 'global',
+            targetKind: 'frequency',
+            target: { kind: 'frequency', resolver: 'schedule-kind-and-recurrence', ambiguityPolicy: 'fail', required: false },
+            inputSchema: {
+                type: 'object',
+                required: ['kind', 'recurrence'],
+                properties: {
+                    kind: { enum: ['once', 'interval', 'daily', 'weekly', 'monthly', 'customCron'] },
+                    recurrence: { type: 'object' },
+                    dialect: { enum: ['unix', 'quartz', 'aws-eventbridge', 'kubernetes', 'github-actions', 'gcp-scheduler'] },
+                },
+            },
+            effects: [{
+                    kind: 'compile-domain-patch',
+                    handler: 'cron-frequency-to-expression',
+                    handlerContract: {
+                        reads: ['schedule.kind', 'schedule.recurrence', 'schedule.timezone', 'schedule.expression.dialect'],
+                        writes: ['schedule.kind', 'schedule.recurrence', 'schedule.expression', 'value'],
+                        identityKeys: ['schedule.kind'],
+                        inputSchema: {
+                            type: 'object',
+                            required: ['kind', 'recurrence'],
+                            properties: {
+                                kind: { enum: ['once', 'interval', 'daily', 'weekly', 'monthly', 'customCron'] },
+                                recurrence: { type: 'object' },
+                                dialect: { enum: ['unix', 'quartz', 'aws-eventbridge', 'kubernetes', 'github-actions', 'gcp-scheduler'] },
+                            },
+                        },
+                        failureModes: ['unsupported-kind', 'non-portable-frequency', 'invalid-recurrence', 'cron-compile-failed'],
+                        description: 'Compiles structured recurrence intent through compileScheduleExpression and updates the canonical schedule expression only when diagnostics have no errors.',
+                    },
+                }],
+            destructive: false,
+            requiresConfirmation: false,
+            validators: ['frequency-maps-to-canonical-expression', 'cron-expression-valid', 'diagnostics-before-patch'],
+            affectedPaths: ['schedule.kind', 'schedule.recurrence', 'schedule.expression', 'value'],
+            submissionImpact: 'affects-submission',
+            preconditions: ['config-initialized'],
+        },
+        {
+            operationId: 'cron.timezone.set',
+            title: 'Set schedule timezone',
+            scope: 'global',
+            targetKind: 'timezone',
+            target: { kind: 'timezone', resolver: 'schedule-timezone', ambiguityPolicy: 'fail', required: false },
+            inputSchema: { type: 'object', required: ['timezone'], properties: { timezone: { type: 'string' } } },
+            effects: [{
+                    kind: 'compile-domain-patch',
+                    handler: 'cron-timezone-set',
+                    handlerContract: {
+                        reads: ['value', 'schedule', 'metadata.timezone', 'metadata.previewOccurrences', 'metadata.previewFrom', 'metadata.locale'],
+                        writes: ['schedule.timezone', 'metadata.timezone', 'preview', 'diagnostics'],
+                        identityKeys: ['schedule.expression.cron', 'schedule.timezone'],
+                        inputSchema: { type: 'object', required: ['timezone'], properties: { timezone: { type: 'string' } } },
+                        failureModes: ['invalid-timezone', 'invalid-expression', 'preview-generation-failed'],
+                        description: 'Sets the IANA timezone used by schedule and metadata, then regenerates preview/diagnostics from the same expression.',
+                    },
+                }],
+            destructive: false,
+            requiresConfirmation: false,
+            validators: ['timezone-valid', 'preview-matches-expression', 'editor-runtime-round-trip'],
+            affectedPaths: ['schedule.timezone', 'metadata.timezone', 'preview', 'diagnostics'],
+            submissionImpact: 'affects-submission',
+            preconditions: ['config-initialized'],
+        },
+        {
+            operationId: 'cron.preset.apply',
+            title: 'Apply CRON preset',
+            scope: 'meta',
+            targetKind: 'preset',
+            target: { kind: 'preset', resolver: 'cron-preset-by-label-or-expression', ambiguityPolicy: 'fail', required: true },
+            inputSchema: {
+                type: 'object',
+                required: ['labelOrCron'],
+                properties: {
+                    labelOrCron: { type: 'string' },
+                    timezone: { type: 'string' },
+                },
+            },
+            effects: [{
+                    kind: 'compile-domain-patch',
+                    handler: 'cron-preset-apply',
+                    handlerContract: {
+                        reads: ['metadata.presets[]', 'presets[]', 'schedule.timezone', 'metadata.timezone'],
+                        writes: ['schedule.kind', 'schedule.expression', 'schedule.timezone', 'value'],
+                        identityKeys: ['metadata.presets[].label', 'metadata.presets[].cron', 'presets[].label', 'presets[].cron'],
+                        inputSchema: {
+                            type: 'object',
+                            required: ['labelOrCron'],
+                            properties: {
+                                labelOrCron: { type: 'string' },
+                                timezone: { type: 'string' },
+                            },
+                        },
+                        failureModes: ['preset-not-found', 'preset-cron-invalid', 'timezone-invalid'],
+                        description: 'Resolves a preset by label or cron, validates it through normalizeScheduleValue/createSchedulePreview, then applies the canonical expression.',
+                    },
+                }],
+            destructive: false,
+            requiresConfirmation: false,
+            validators: ['preset-exists', 'preset-maps-to-canonical-expression', 'cron-expression-valid'],
+            affectedPaths: ['schedule.kind', 'schedule.expression', 'schedule.timezone', 'value'],
+            submissionImpact: 'affects-submission',
+            preconditions: ['config-initialized', 'target-preset-exists'],
+        },
+        {
+            operationId: 'cron.validate',
+            title: 'Validate schedule',
+            scope: 'global',
+            targetKind: 'validation',
+            target: { kind: 'validation', resolver: 'schedule-validation-request', ambiguityPolicy: 'fail', required: false },
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    cron: { type: 'string' },
+                    schedule: { type: 'object' },
+                    timezone: { type: 'string' },
+                    dialect: { enum: ['unix', 'quartz', 'aws-eventbridge', 'kubernetes', 'github-actions', 'gcp-scheduler'] },
+                },
+            },
+            effects: [{
+                    kind: 'compile-domain-patch',
+                    handler: 'cron-validation-diagnostics',
+                    handlerContract: {
+                        reads: ['value', 'schedule', 'metadata.timezone'],
+                        writes: ['diagnostics'],
+                        identityKeys: ['schedule.expression.cron', 'schedule.timezone'],
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                cron: { type: 'string' },
+                                schedule: { type: 'object' },
+                                timezone: { type: 'string' },
+                                dialect: { enum: ['unix', 'quartz', 'aws-eventbridge', 'kubernetes', 'github-actions', 'gcp-scheduler'] },
+                            },
+                        },
+                        failureModes: ['invalid-expression', 'invalid-timezone', 'invalid-recurrence'],
+                        description: 'Runs normalizeScheduleValue and validateScheduleAuthoringConfig and returns diagnostics without mutating schedule/value paths.',
+                    },
+                }],
+            destructive: false,
+            requiresConfirmation: false,
+            validators: ['invalid-schedules-return-diagnostics', 'cron-expression-valid', 'timezone-valid'],
+            affectedPaths: ['diagnostics'],
+            submissionImpact: 'none',
+            preconditions: ['config-initialized'],
+        },
+        {
+            operationId: 'cron.preview.generate',
+            title: 'Generate schedule preview',
+            scope: 'global',
+            targetKind: 'preview',
+            target: { kind: 'preview', resolver: 'schedule-preview-config', ambiguityPolicy: 'fail', required: false },
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    occurrences: { type: 'number' },
+                    from: { type: 'string' },
+                    timezone: { type: 'string' },
+                    locale: { type: 'string' },
+                },
+            },
+            effects: [{
+                    kind: 'compile-domain-patch',
+                    handler: 'cron-preview-generate',
+                    handlerContract: {
+                        reads: ['value', 'schedule', 'metadata.previewOccurrences', 'metadata.previewFrom', 'metadata.timezone', 'metadata.locale'],
+                        writes: ['preview', 'diagnostics'],
+                        identityKeys: ['schedule.expression.cron', 'schedule.timezone', 'metadata.previewFrom'],
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                occurrences: { type: 'number' },
+                                from: { type: 'string' },
+                                timezone: { type: 'string' },
+                                locale: { type: 'string' },
+                            },
+                        },
+                        failureModes: ['invalid-expression', 'invalid-timezone', 'preview-empty', 'diagnostics-contain-errors'],
+                        description: 'Runs createSchedulePreview and returns read-only preview occurrences plus diagnostics; it does not patch the schedule when validation fails.',
+                    },
+                }],
+            destructive: false,
+            requiresConfirmation: false,
+            validators: ['preview-matches-expression', 'timezone-valid', 'invalid-schedules-return-diagnostics'],
+            affectedPaths: ['preview', 'diagnostics'],
+            submissionImpact: 'none',
+            preconditions: ['config-initialized'],
+        },
+    ],
+    validators: [
+        { validatorId: 'cron-expression-valid', level: 'error', code: 'PCRON001', description: 'CRON expressions must pass the canonical cron-runtime parser for the selected dialect before schedule/value paths are patched.' },
+        { validatorId: 'cron-dialect-compatible', level: 'error', code: 'PCRON002', description: 'Field count, seconds support and dialect-specific rules must match CRON_DIALECTS.' },
+        { validatorId: 'timezone-valid', level: 'error', code: 'PCRON003', description: 'Timezone must be a valid IANA timezone accepted by Intl.DateTimeFormat and schedule preview.' },
+        { validatorId: 'frequency-maps-to-canonical-expression', level: 'error', code: 'PCRON004', description: 'Structured frequency intent must compile through compileScheduleExpression into the canonical expression when portable.' },
+        { validatorId: 'preset-exists', level: 'error', code: 'PCRON005', description: 'Preset operations must resolve an existing preset by label or cron expression.' },
+        { validatorId: 'preset-maps-to-canonical-expression', level: 'error', code: 'PCRON006', description: 'Preset cron values must normalize into ScheduleAuthoringConfig and a valid canonical expression.' },
+        { validatorId: 'preview-matches-expression', level: 'error', code: 'PCRON007', description: 'Preview occurrences must be generated from the same expression, timezone and from-date requested by authoring.' },
+        { validatorId: 'invalid-schedules-return-diagnostics', level: 'error', code: 'PCRON008', description: 'Validation and preview requests for invalid schedules must return diagnostics and must not patch schedule/value fields.' },
+        { validatorId: 'diagnostics-before-patch', level: 'error', code: 'PCRON009', description: 'Operations that compile recurrence or presets must evaluate diagnostics before mutating canonical schedule/value paths.' },
+        { validatorId: 'editor-runtime-round-trip', level: 'error', code: 'PCRON010', description: 'ControlValueAccessor, runtime preview and AI adapter snapshots must preserve expression and timezone.' },
+    ],
+    roundTripRequirements: [
+        'Expression and timezone edits must round-trip through ControlValueAccessor, normalizeScheduleValue and createSchedulePreview without losing the selected timezone.',
+        'Structured frequency authoring must use ScheduleAuthoringConfig and compileScheduleExpression as the canonical source of recurrence semantics.',
+        'Validation and preview operations are read-only: invalid schedules return diagnostics and must not mutate schedule/value paths.',
+        'Preset operations must resolve stable label/cron identities and validate the resulting expression before applying it.',
+        'Preview generation must use the same expression, timezone, locale, occurrences and from-date that are visible in the schedule config or metadata input.',
+    ],
+    examples: [
+        { id: 'weekday-0800', request: 'Run every weekday at 08:00.', operationId: 'cron.frequency.set', params: { kind: 'daily', recurrence: { daily: { times: ['08:00'], onlyWeekdays: true } }, dialect: 'unix' }, isPositive: true },
+        { id: 'every-15-minutes', request: 'Run every 15 minutes.', operationId: 'cron.frequency.set', params: { kind: 'interval', recurrence: { interval: { every: 15, unit: 'minutes' } }, dialect: 'unix' }, isPositive: true },
+        { id: 'monthly-first-day', request: 'Run monthly on the first day at 09:00.', operationId: 'cron.frequency.set', params: { kind: 'monthly', recurrence: { monthly: { mode: 'dayOfMonth', dayOfMonth: 1, times: ['09:00'] } }, dialect: 'unix' }, isPositive: true },
+        { id: 'set-explicit-expression', request: 'Use cron expression 0 8 * * 1-5.', operationId: 'cron.expression.set', params: { cron: '0 8 * * 1-5', dialect: 'unix', seconds: false }, isPositive: true },
+        { id: 'change-timezone-preview', request: 'Change timezone to America/Sao_Paulo and preview the next runs.', operationId: 'cron.timezone.set', params: { timezone: 'America/Sao_Paulo' }, isPositive: true },
+        { id: 'preview-next-five', request: 'Preview the next five runs from 2026-04-20T00:00:00Z.', operationId: 'cron.preview.generate', params: { occurrences: 5, from: '2026-04-20T00:00:00.000Z', timezone: 'UTC' }, isPositive: true },
+        { id: 'apply-business-hours-preset', request: 'Apply the business hours preset.', operationId: 'cron.preset.apply', target: 'business hours', params: { labelOrCron: 'business hours' }, isPositive: true },
+        { id: 'reject-impossible-expression', request: 'Use cron expression 99 99 * * *.', operationId: 'cron.expression.set', params: { cron: '99 99 * * *', dialect: 'unix' }, isPositive: false },
+        { id: 'diagnose-invalid-expression', request: 'Validate 99 99 * * * and explain why it is invalid.', operationId: 'cron.validate', params: { cron: '99 99 * * *', dialect: 'unix' }, isPositive: true },
+        { id: 'reject-invalid-timezone', request: 'Change timezone to Mars/Olympus.', operationId: 'cron.timezone.set', params: { timezone: 'Mars/Olympus' }, isPositive: false },
+    ],
+};
+
 /*
  * Public API Surface of praxis-cron-builder
  */
@@ -1344,4 +1632,4 @@ const CRON_BUILDER_AI_CAPABILITIES = {
  * Generated bundle index. Do not edit.
  */
 
-export { CRON_BUILDER_AI_CAPABILITIES, CRON_DIALECTS, PDX_CRON_BUILDER_DOC_META_LEGACY, PdxCronBuilderComponent, SCHEDULE_AUTHORING_CONFIG_VERSION, compileScheduleExpression, createSchedulePreview, getCronDialectDefinition, inferCronDialect, normalizeScheduleValue, validateScheduleAuthoringConfig };
+export { CRON_BUILDER_AI_CAPABILITIES, CRON_DIALECTS, PDX_CRON_BUILDER_DOC_META_LEGACY, PRAXIS_CRON_BUILDER_AUTHORING_MANIFEST, PdxCronBuilderComponent, SCHEDULE_AUTHORING_CONFIG_VERSION, compileScheduleExpression, createSchedulePreview, getCronDialectDefinition, inferCronDialect, normalizeScheduleValue, validateScheduleAuthoringConfig };

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "@praxisui/cron-builder",
-  "version": "8.0.0-beta.6",
+  "version": "8.0.0-beta.61",
   "description": "Cron expression builder utilities and components for Praxis UI.",
   "peerDependencies": {
-    "@angular/common": "^20.1.0",
-    "@angular/core": "^20.1.0",
-    "@angular/forms": "^20.1.0",
-    "@angular/cdk": "^20.1.0",
-    "@angular/material": "^20.1.0",
-    "@praxisui/core": "^8.0.0-beta.6"
+    "@angular/common": "^21.0.0",
+    "@angular/core": "^21.0.0",
+    "@angular/forms": "^21.0.0",
+    "@angular/cdk": "^21.0.0",
+    "@angular/material": "^21.0.0",
+    "@praxisui/core": "^8.0.0-beta.61",
+    "@praxisui/ai": "^8.0.0-beta.61",
+    "rxjs": "~7.8.0"
   },
   "dependencies": {
     "tslib": "^2.3.0",
@@ -39,14 +41,15 @@
   ],
   "sideEffects": false,
   "module": "fesm2022/praxisui-cron-builder.mjs",
-  "typings": "index.d.ts",
+  "typings": "types/praxisui-cron-builder.d.ts",
   "exports": {
     "./package.json": {
       "default": "./package.json"
     },
     ".": {
-      "types": "./index.d.ts",
+      "types": "./types/praxisui-cron-builder.d.ts",
       "default": "./fesm2022/praxisui-cron-builder.mjs"
     }
-  }
+  },
+  "type": "module"
 }

package/{index.d.ts → types/praxisui-cron-builder.d.ts}

@@ -2,7 +2,7 @@ import * as i0 from '@angular/core';
 import { OnInit, OnDestroy } from '@angular/core';
 import { ControlValueAccessor, FormGroup, FormControl } from '@angular/forms';
 import { MatTabChangeEvent } from '@angular/material/tabs';
-import { AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog } from '@praxisui/core';
+import { AiCapabilityCatalog, AiCapability, AiCapabilityCategory, AiValueKind, ComponentAuthoringManifest } from '@praxisui/core';
 
 declare const SCHEDULE_AUTHORING_CONFIG_VERSION: "v1";
 type ScheduleAuthoringConfigVersion = typeof SCHEDULE_AUTHORING_CONFIG_VERSION;
@@ -282,5 +282,7 @@ interface CapabilityCatalog extends AiCapabilityCatalog {
 }
 declare const CRON_BUILDER_AI_CAPABILITIES: CapabilityCatalog;
 
-export { CRON_BUILDER_AI_CAPABILITIES, CRON_DIALECTS, PDX_CRON_BUILDER_DOC_META_LEGACY, PdxCronBuilderComponent, SCHEDULE_AUTHORING_CONFIG_VERSION, compileScheduleExpression, createSchedulePreview, getCronDialectDefinition, inferCronDialect, normalizeScheduleValue, validateScheduleAuthoringConfig };
+declare const PRAXIS_CRON_BUILDER_AUTHORING_MANIFEST: ComponentAuthoringManifest;
+
+export { CRON_BUILDER_AI_CAPABILITIES, CRON_DIALECTS, PDX_CRON_BUILDER_DOC_META_LEGACY, PRAXIS_CRON_BUILDER_AUTHORING_MANIFEST, PdxCronBuilderComponent, SCHEDULE_AUTHORING_CONFIG_VERSION, compileScheduleExpression, createSchedulePreview, getCronDialectDefinition, inferCronDialect, normalizeScheduleValue, validateScheduleAuthoringConfig };
 export type { AdvancedCronFormValue, Capability, CapabilityCatalog, CapabilityCategory, CompiledScheduleExpression, CreateSchedulePreviewOptions, CronBuilderMetadata, CronDialect, CronDialectDefinition, CronPresetType, DailySchedule, IntervalSchedule, MonthlySchedule, OnceSchedule, Recurrence, ScheduleAuthoringConfig, ScheduleAuthoringConfigVersion, ScheduleCronExpression, ScheduleDiagnostic, ScheduleExecutionPolicy, ScheduleGovernance, ScheduleInput, ScheduleKind, ScheduleNormalizeOptions, ScheduleNormalizeResult, SchedulePreviewConfig, SchedulePreviewOccurrence, SchedulePreviewResult, ScheduleRecurrence, ScheduleSeverity, ScheduleTimeUnit, ScheduleWeekday, ScheduleWindow, SimpleCronFormValue, ValueKind, WeeklySchedule };