@praxisui/cron-builder 8.0.0-beta.11 → 8.0.0-beta.12

package/README.md

@@ -149,6 +149,11 @@ Expression, frequency, timezone and preset operations may patch canonical
 `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

@@ -1336,8 +1336,6 @@ const CRON_BUILDER_AI_CAPABILITIES = {
     ],
 };
 
-const cronDialectEnum = ['unix', 'quartz', 'aws-eventbridge', 'kubernetes', 'github-actions', 'gcp-scheduler'];
-const scheduleKindEnum = ['once', 'interval', 'daily', 'weekly', 'monthly', 'customCron'];
 const PRAXIS_CRON_BUILDER_AUTHORING_MANIFEST = {
     schemaVersion: '1.0.0',
     componentId: 'pdx-cron-builder',
@@ -1369,14 +1367,35 @@ const PRAXIS_CRON_BUILDER_AUTHORING_MANIFEST = {
                 required: ['cron'],
                 properties: {
                     cron: { type: 'string' },
-                    dialect: { enum: cronDialectEnum },
+                    dialect: { enum: ['unix', 'quartz', 'aws-eventbridge', 'kubernetes', 'github-actions', 'gcp-scheduler'] },
                     seconds: { type: 'boolean' },
                 },
             },
-            effects: [{ kind: 'merge-object', path: 'schedule.expression' }, { kind: 'set-value', path: 'schedule.kind' }],
+            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.cron', 'schedule.expression.dialect', 'schedule.expression.seconds', 'value'],
-            submissionImpact: true,
+            affectedPaths: ['schedule.kind', 'schedule.expression', 'schedule.expression.cron', 'schedule.expression.dialect', 'schedule.expression.seconds', 'value', 'diagnostics'],
+            submissionImpact: 'affects-submission',
             preconditions: ['config-initialized'],
         },
         {
@@ -1389,9 +1408,9 @@ const PRAXIS_CRON_BUILDER_AUTHORING_MANIFEST = {
                 type: 'object',
                 required: ['kind', 'recurrence'],
                 properties: {
-                    kind: { enum: scheduleKindEnum },
+                    kind: { enum: ['once', 'interval', 'daily', 'weekly', 'monthly', 'customCron'] },
                     recurrence: { type: 'object' },
-                    dialect: { enum: cronDialectEnum },
+                    dialect: { enum: ['unix', 'quartz', 'aws-eventbridge', 'kubernetes', 'github-actions', 'gcp-scheduler'] },
                 },
             },
             effects: [{
@@ -1405,18 +1424,20 @@ const PRAXIS_CRON_BUILDER_AUTHORING_MANIFEST = {
                             type: 'object',
                             required: ['kind', 'recurrence'],
                             properties: {
-                                kind: { enum: scheduleKindEnum },
+                                kind: { enum: ['once', 'interval', 'daily', 'weekly', 'monthly', 'customCron'] },
                                 recurrence: { type: 'object' },
-                                dialect: { enum: cronDialectEnum },
+                                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: true,
+            submissionImpact: 'affects-submission',
             preconditions: ['config-initialized'],
         },
         {
@@ -1426,16 +1447,29 @@ const PRAXIS_CRON_BUILDER_AUTHORING_MANIFEST = {
             targetKind: 'timezone',
             target: { kind: 'timezone', resolver: 'schedule-timezone', ambiguityPolicy: 'fail', required: false },
             inputSchema: { type: 'object', required: ['timezone'], properties: { timezone: { type: 'string' } } },
-            effects: [{ kind: 'set-value', path: 'schedule.timezone' }, { kind: 'set-value', path: 'metadata.timezone' }],
+            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'],
-            submissionImpact: true,
+            affectedPaths: ['schedule.timezone', 'metadata.timezone', 'preview', 'diagnostics'],
+            submissionImpact: 'affects-submission',
             preconditions: ['config-initialized'],
         },
         {
             operationId: 'cron.preset.apply',
             title: 'Apply CRON preset',
-            scope: 'global',
+            scope: 'meta',
             targetKind: 'preset',
             target: { kind: 'preset', resolver: 'cron-preset-by-label-or-expression', ambiguityPolicy: 'fail', required: true },
             inputSchema: {
@@ -1465,9 +1499,11 @@ const PRAXIS_CRON_BUILDER_AUTHORING_MANIFEST = {
                         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: true,
+            submissionImpact: 'affects-submission',
             preconditions: ['config-initialized', 'target-preset-exists'],
         },
         {
@@ -1482,7 +1518,7 @@ const PRAXIS_CRON_BUILDER_AUTHORING_MANIFEST = {
                     cron: { type: 'string' },
                     schedule: { type: 'object' },
                     timezone: { type: 'string' },
-                    dialect: { enum: cronDialectEnum },
+                    dialect: { enum: ['unix', 'quartz', 'aws-eventbridge', 'kubernetes', 'github-actions', 'gcp-scheduler'] },
                 },
             },
             effects: [{
@@ -1498,16 +1534,18 @@ const PRAXIS_CRON_BUILDER_AUTHORING_MANIFEST = {
                                 cron: { type: 'string' },
                                 schedule: { type: 'object' },
                                 timezone: { type: 'string' },
-                                dialect: { enum: cronDialectEnum },
+                                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: false,
+            submissionImpact: 'none',
             preconditions: ['config-initialized'],
         },
         {
@@ -1545,9 +1583,11 @@ const PRAXIS_CRON_BUILDER_AUTHORING_MANIFEST = {
                         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: false,
+            submissionImpact: 'none',
             preconditions: ['config-initialized'],
         },
     ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/cron-builder",
-  "version": "8.0.0-beta.11",
+  "version": "8.0.0-beta.12",
   "description": "Cron expression builder utilities and components for Praxis UI.",
   "peerDependencies": {
     "@angular/common": "^20.1.0",
@@ -8,7 +8,7 @@
     "@angular/forms": "^20.1.0",
     "@angular/cdk": "^20.1.0",
     "@angular/material": "^20.1.0",
-    "@praxisui/core": "^8.0.0-beta.11"
+    "@praxisui/core": "^8.0.0-beta.12"
   },
   "dependencies": {
     "tslib": "^2.3.0",