@praxisui/cron-builder 8.0.0-beta.0 → 8.0.0-beta.100

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "@praxisui/cron-builder",
-  "version": "8.0.0-beta.0",
+  "version": "8.0.0-beta.100",
   "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.0"
+    "@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.100",
+    "@praxisui/ai": "^8.0.0-beta.100",
+    "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/types/praxisui-cron-builder.d.ts

@@ -0,0 +1,288 @@
+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 { AiCapabilityCatalog, AiCapability, AiCapabilityCategory, AiValueKind, ComponentAuthoringManifest } from '@praxisui/core';
+
+declare const SCHEDULE_AUTHORING_CONFIG_VERSION: "v1";
+type ScheduleAuthoringConfigVersion = typeof SCHEDULE_AUTHORING_CONFIG_VERSION;
+type CronDialect = 'unix' | 'quartz' | 'aws-eventbridge' | 'kubernetes' | 'github-actions' | 'gcp-scheduler';
+type ScheduleKind = 'once' | 'interval' | 'daily' | 'weekly' | 'monthly' | 'customCron';
+type ScheduleTimeUnit = 'minutes' | 'hours' | 'days' | 'weeks';
+type ScheduleWeekday = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+type ScheduleSeverity = 'error' | 'warning' | 'info';
+interface CronDialectDefinition {
+    dialect: CronDialect;
+    label: string;
+    fieldCount: {
+        min: number;
+        max: number;
+    };
+    supportsSeconds: boolean;
+    supportsYear: boolean;
+    supportsNamedMonths: boolean;
+    supportsNamedWeekdays: boolean;
+    supportsQuestionMark: boolean;
+    supportsLast: boolean;
+    supportsNearestWeekday: boolean;
+    supportsNthWeekday: boolean;
+    timezoneMode: 'external-field' | 'host-local' | 'fixed-utc' | 'expression-prefix-unsupported';
+    dayOfMonthDayOfWeekRule: 'either-or-question-mark' | 'unix-or' | 'host-specific';
+    examples: readonly string[];
+}
+interface ScheduleDiagnostic {
+    severity: ScheduleSeverity;
+    code: string;
+    field?: string;
+    message: string;
+    suggestion?: string;
+}
+interface ScheduleCronExpression {
+    cron: string;
+    dialect: CronDialect;
+    seconds?: boolean;
+}
+interface OnceSchedule {
+    runAt: string;
+}
+interface IntervalSchedule {
+    every: number;
+    unit: ScheduleTimeUnit;
+}
+interface DailySchedule {
+    times: string[];
+    onlyWeekdays?: boolean;
+}
+interface WeeklySchedule {
+    daysOfWeek: ScheduleWeekday[];
+    times: string[];
+}
+interface MonthlySchedule {
+    mode: 'dayOfMonth' | 'nthWeekday' | 'lastDay' | 'lastWeekday';
+    dayOfMonth?: number;
+    nth?: 1 | 2 | 3 | 4 | 5;
+    weekday?: ScheduleWeekday;
+    times: string[];
+}
+interface ScheduleRecurrence {
+    once?: OnceSchedule;
+    interval?: IntervalSchedule;
+    daily?: DailySchedule;
+    weekly?: WeeklySchedule;
+    monthly?: MonthlySchedule;
+}
+interface ScheduleWindow {
+    startAt?: string;
+    endAt?: string;
+}
+interface ScheduleExecutionPolicy {
+    enabled?: boolean;
+    misfirePolicy?: 'skip' | 'run-late' | 'run-once';
+    concurrencyPolicy?: 'allow' | 'forbid' | 'replace';
+    flexibleWindowMinutes?: number;
+    jitterMinutes?: number;
+}
+interface SchedulePreviewConfig {
+    occurrences?: number;
+    from?: string;
+}
+interface ScheduleGovernance {
+    name?: string;
+    description?: string;
+    owner?: string;
+    tags?: string[];
+}
+interface ScheduleAuthoringConfig {
+    version: ScheduleAuthoringConfigVersion;
+    kind: ScheduleKind;
+    timezone: string;
+    locale?: string;
+    expression?: ScheduleCronExpression;
+    recurrence?: ScheduleRecurrence;
+    window?: ScheduleWindow;
+    executionPolicy?: ScheduleExecutionPolicy;
+    preview?: SchedulePreviewConfig;
+    governance?: ScheduleGovernance;
+}
+declare const CRON_DIALECTS: Record<CronDialect, CronDialectDefinition>;
+declare function getCronDialectDefinition(dialect: CronDialect): CronDialectDefinition;
+
+interface ScheduleNormalizeOptions {
+    timezone?: string;
+    locale?: string;
+    dialect?: CronDialect;
+    previewOccurrences?: number;
+}
+interface ScheduleNormalizeResult {
+    config: ScheduleAuthoringConfig | null;
+    diagnostics: ScheduleDiagnostic[];
+}
+type ScheduleInput = string | ScheduleAuthoringConfig | null | undefined;
+declare function normalizeScheduleValue(value: ScheduleInput, options?: ScheduleNormalizeOptions): ScheduleNormalizeResult;
+declare function inferCronDialect(expression: string): CronDialect;
+
+interface CompiledScheduleExpression {
+    cron: string;
+    dialect: CronDialect;
+    seconds: boolean;
+}
+interface SchedulePreviewOccurrence {
+    instant: string;
+    localDateTime: string;
+    timezone: string;
+}
+interface SchedulePreviewResult {
+    config: ScheduleAuthoringConfig | null;
+    expression: CompiledScheduleExpression | null;
+    humanized: string;
+    occurrences: SchedulePreviewOccurrence[];
+    diagnostics: ScheduleDiagnostic[];
+}
+interface CreateSchedulePreviewOptions extends SchedulePreviewConfig, Pick<ScheduleNormalizeOptions, 'timezone' | 'locale' | 'dialect'> {
+}
+declare function compileScheduleExpression(config: ScheduleAuthoringConfig): {
+    expression: CompiledScheduleExpression | null;
+    diagnostics: ScheduleDiagnostic[];
+};
+declare function validateScheduleAuthoringConfig(config: ScheduleAuthoringConfig): ScheduleDiagnostic[];
+declare function createSchedulePreview(value: string | ScheduleAuthoringConfig | null | undefined, preview?: CreateSchedulePreviewOptions): SchedulePreviewResult;
+
+interface Recurrence {
+}
+interface CronBuilderMetadata {
+    mode?: 'simple' | 'advanced' | 'both';
+    fields?: {
+        seconds?: boolean;
+        minutes?: boolean;
+        hours?: boolean;
+        dom?: boolean;
+        month?: boolean;
+        dow?: boolean;
+    };
+    timezone?: string;
+    locale?: string;
+    presets?: Array<{
+        label: string;
+        cron: string;
+    }>;
+    previewOccurrences?: number;
+    previewFrom?: Date;
+    validators?: {
+        requiredMessage?: string;
+        invalidCronMessage?: string;
+    };
+    validationTrigger?: 'change' | 'blur';
+    validationDebounce?: number;
+    errorPosition?: 'tooltip' | 'inline';
+    showInlineErrors?: boolean;
+    hint?: string;
+}
+type CronPresetType = 'everyNMinutes' | 'dailyAt' | 'weekly' | 'monthlyDay' | 'monthlyNthWeekday';
+interface SimpleCronFormValue {
+    type: CronPresetType;
+    everyN: number;
+    dailyTime: string;
+    weeklyDays: number[];
+    weeklyTime: string;
+    monthlyDay: number;
+    monthlyTime: string;
+    nth: number;
+    nthDay: number;
+    nthTime: string;
+}
+interface AdvancedCronFormValue {
+    seconds?: string;
+    minutes: string;
+    hours: string;
+    dayOfMonth: string;
+    month: string;
+    dayOfWeek: string;
+}
+declare class PdxCronBuilderComponent implements ControlValueAccessor, OnInit, OnDestroy {
+    private readonly fb;
+    private readonly clipboard;
+    private readonly snackBar;
+    metadata: CronBuilderMetadata;
+    value: string | Recurrence | null;
+    isDisabled: boolean;
+    activeTab: 'simple' | 'advanced';
+    selectedTabIndex: number;
+    readonly form: FormGroup;
+    readonly simpleForm: FormGroup;
+    readonly timezoneControl: FormControl<string>;
+    private readonly destroy$;
+    humanized: string;
+    preview: Date[];
+    structuredPreview: SchedulePreviewOccurrence[];
+    scheduleConfig: ScheduleAuthoringConfig | null;
+    scheduleDiagnostics: ScheduleDiagnostic[];
+    error: string | null;
+    readonly weekdayLabels: readonly ["Dom", "Seg", "Ter", "Qua", "Qui", "Sex", "Sáb"];
+    readonly weeklyDayOptions: readonly [0, 1, 2, 3, 4, 5, 6];
+    readonly nthOrderOptions: readonly [1, 2, 3, 4, 5];
+    readonly nthDayOptions: readonly [1, 2, 3, 4, 5, 6, 0];
+    readonly timezoneOptions: readonly ["UTC", "America/Sao_Paulo", "Europe/London", "America/New_York"];
+    constructor();
+    get simpleControls(): Record<string, FormControl>;
+    ngOnInit(): void;
+    onChange: (value: any) => void;
+    onTouched: () => void;
+    writeValue(value: string | Recurrence | null): void;
+    registerOnChange(fn: any): void;
+    registerOnTouched(fn: any): void;
+    setDisabledState?(isDisabled: boolean): void;
+    onTabChange(event: MatTabChangeEvent): void;
+    setPreset(cron: string): void;
+    updateValue(cron: string, emitEvent?: boolean): void;
+    copyCron(): void;
+    copyHumanized(): void;
+    importCron(): void;
+    private refreshScheduleState;
+    private parseCronString;
+    private syncSimpleForm;
+    private buildCronFromSimple;
+    private parseTime;
+    private toTime;
+    private pad;
+    private constructCronString;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PdxCronBuilderComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PdxCronBuilderComponent, "pdx-cron-builder", never, { "metadata": { "alias": "metadata"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+declare const PDX_CRON_BUILDER_DOC_META_LEGACY: any;
+
+/**
+ * Capabilities catalog for Cron Builder (pdx-cron-builder inputs + metadata).
+ * Paths follow component inputs (patch merged at config root).
+ */
+
+declare module '@praxisui/core' {
+    interface AiCapabilityCategoryMap {
+        meta: true;
+        schedule: true;
+        recurrence: true;
+        dialects: true;
+        fields: true;
+        presets: true;
+        policy: true;
+        preview: true;
+        governance: true;
+        i18n: true;
+        ui: true;
+    }
+}
+type CapabilityCategory = AiCapabilityCategory;
+type ValueKind = AiValueKind;
+interface Capability extends AiCapability {
+    category: CapabilityCategory;
+}
+interface CapabilityCatalog extends AiCapabilityCatalog {
+    capabilities: Capability[];
+}
+declare const CRON_BUILDER_AI_CAPABILITIES: CapabilityCatalog;
+
+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 };

package/index.d.ts

@@ -1,137 +0,0 @@
-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';
-
-interface Recurrence {
-}
-interface CronBuilderMetadata {
-    mode?: 'simple' | 'advanced' | 'both';
-    fields?: {
-        seconds?: boolean;
-        minutes?: boolean;
-        hours?: boolean;
-        dom?: boolean;
-        month?: boolean;
-        dow?: boolean;
-    };
-    timezone?: string;
-    locale?: string;
-    presets?: Array<{
-        label: string;
-        cron: string;
-    }>;
-    previewOccurrences?: number;
-    previewFrom?: Date;
-    validators?: {
-        requiredMessage?: string;
-        invalidCronMessage?: string;
-    };
-    validationTrigger?: 'change' | 'blur';
-    validationDebounce?: number;
-    errorPosition?: 'tooltip' | 'inline';
-    showInlineErrors?: boolean;
-    hint?: string;
-}
-type CronPresetType = 'everyNMinutes' | 'dailyAt' | 'weekly' | 'monthlyDay' | 'monthlyNthWeekday';
-interface SimpleCronFormValue {
-    type: CronPresetType;
-    everyN: number;
-    dailyTime: string;
-    weeklyDays: number[];
-    weeklyTime: string;
-    monthlyDay: number;
-    monthlyTime: string;
-    nth: number;
-    nthDay: number;
-    nthTime: string;
-}
-interface AdvancedCronFormValue {
-    seconds?: string;
-    minutes: string;
-    hours: string;
-    dayOfMonth: string;
-    month: string;
-    dayOfWeek: string;
-}
-declare class PdxCronBuilderComponent implements ControlValueAccessor, OnInit, OnDestroy {
-    private readonly fb;
-    private readonly clipboard;
-    private readonly snackBar;
-    metadata: CronBuilderMetadata;
-    value: string | Recurrence | null;
-    isDisabled: boolean;
-    activeTab: 'simple' | 'advanced';
-    selectedTabIndex: number;
-    readonly form: FormGroup;
-    readonly simpleForm: FormGroup;
-    readonly timezoneControl: FormControl<string>;
-    private readonly destroy$;
-    humanized: string;
-    preview: Date[];
-    error: string | null;
-    readonly weekdayLabels: readonly ["Dom", "Seg", "Ter", "Qua", "Qui", "Sex", "Sáb"];
-    readonly weeklyDayOptions: readonly [0, 1, 2, 3, 4, 5, 6];
-    readonly nthOrderOptions: readonly [1, 2, 3, 4, 5];
-    readonly nthDayOptions: readonly [1, 2, 3, 4, 5, 6, 0];
-    readonly timezoneOptions: readonly ["UTC", "America/Sao_Paulo", "Europe/London", "America/New_York"];
-    constructor();
-    get simpleControls(): Record<string, FormControl>;
-    ngOnInit(): void;
-    onChange: (value: any) => void;
-    onTouched: () => void;
-    writeValue(value: string | Recurrence | null): void;
-    registerOnChange(fn: any): void;
-    registerOnTouched(fn: any): void;
-    setDisabledState?(isDisabled: boolean): void;
-    onTabChange(event: MatTabChangeEvent): void;
-    setPreset(cron: string): void;
-    updateValue(cron: string, emitEvent?: boolean): void;
-    copyCron(): void;
-    copyHumanized(): void;
-    importCron(): void;
-    private validate;
-    private humanize;
-    private generatePreview;
-    private parseCronString;
-    private syncSimpleForm;
-    private buildCronFromSimple;
-    private parseTime;
-    private toTime;
-    private pad;
-    private constructCronString;
-    ngOnDestroy(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<PdxCronBuilderComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PdxCronBuilderComponent, "pdx-cron-builder", never, { "metadata": { "alias": "metadata"; "required": false; }; }, {}, never, never, true, never>;
-}
-
-declare const PDX_CRON_BUILDER_DOC_META_LEGACY: any;
-
-/**
- * Capabilities catalog for Cron Builder (pdx-cron-builder inputs + metadata).
- * Paths follow component inputs (patch merged at config root).
- */
-
-declare module '@praxisui/core' {
-    interface AiCapabilityCategoryMap {
-        meta: true;
-        fields: true;
-        presets: true;
-        preview: true;
-        i18n: true;
-        ui: true;
-    }
-}
-type CapabilityCategory = AiCapabilityCategory;
-type ValueKind = AiValueKind;
-interface Capability extends AiCapability {
-    category: CapabilityCategory;
-}
-interface CapabilityCatalog extends AiCapabilityCatalog {
-    capabilities: Capability[];
-}
-declare const CRON_BUILDER_AI_CAPABILITIES: CapabilityCatalog;
-
-export { CRON_BUILDER_AI_CAPABILITIES, PDX_CRON_BUILDER_DOC_META_LEGACY, PdxCronBuilderComponent };
-export type { AdvancedCronFormValue, Capability, CapabilityCatalog, CapabilityCategory, CronBuilderMetadata, CronPresetType, Recurrence, SimpleCronFormValue, ValueKind };