@deepseek-ai/dsh-client-ui-schedule 0.2.1-rc.5 → 0.2.2-alpha.3

package/lib/types/client/clear-ended.d.ts

@@ -0,0 +1,33 @@
+/** Host-wide removal of every ended task, as the management page's one action reports it. */
+import type { RemoteResult } from '@deepseek-ai/dsh-api-remotes/client';
+import type { ScheduleDeleteInactiveResult } from '@deepseek-ai/dsh-schedule/client';
+/** How one bulk removal settled; the wiring reports it as an app-wide notice. */
+export type ClearEndedOutcome = {
+    readonly cleared: true;
+    readonly count: number;
+} | {
+    readonly cleared: false;
+};
+/** Remote removal and the authoritative readback that follows it. */
+export interface ClearEndedDependencies {
+    /** Ask the Host to remove every ended task; it answers how many rows it removed. */
+    readonly removeInactive: () => Promise<RemoteResult<ScheduleDeleteInactiveResult>>;
+    /**
+     * Read the catalog again, naming the newest request ordinal so a read sent
+     * before the removal is superseded rather than reused.
+     * @returns resolution after the read result is published.
+     */
+    readonly refresh: () => Promise<void>;
+}
+/**
+ * Create the management page's bulk removal callback.
+ *
+ * The call names no task ids: the Host owns which rows are ended, and a
+ * delivery can have moved the catalog between the confirmation and the
+ * request. The readback follows the acknowledged removal and supersedes a read
+ * issued before it, so the list follows the removal rather than a stale read.
+ * @param deps - Remote removal and its catalog readback.
+ * @returns a callback that resolves once the settled outcome is available.
+ */
+export declare function createClearEnded(deps: ClearEndedDependencies): () => Promise<ClearEndedOutcome>;
+//# sourceMappingURL=clear-ended.d.ts.map

package/lib/types/client/editor-store.d.ts

@@ -0,0 +1,32 @@
+/** Unsaved task forms survive navigation without persisting business records. */
+import { type EngineStoreHandle } from '@deepseek-ai/dsh-client-store';
+import type { PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ScheduleCatalogEntry } from '@deepseek-ai/dsh-schedule/client';
+import type { TaskEditorDraft } from './TaskEditorFields.tsx';
+import type { HostEditFailure, TaskCreateOutcome } from './TaskDetail.tsx';
+type EditorFailure = HostEditFailure | Extract<TaskCreateOutcome, {
+    failed: string;
+}>['failed'];
+interface EditorDraft {
+    readonly draft: TaskEditorDraft;
+    readonly base: ScheduleCatalogEntry | undefined;
+    readonly initial?: TaskEditorDraft;
+    readonly pending?: boolean;
+    readonly failure?: EditorFailure;
+}
+interface EditorState {
+    drafts: Record<string, EditorDraft | undefined>;
+}
+declare const editorActions: {
+    setDraft: (state: EditorState, key: string, draft: EditorDraft) => void;
+    clearDraft: (state: EditorState, key: string) => void;
+};
+/**
+ * Declare drafts retained by the framework for one entry's scope.
+ * @returns the entry's store handle.
+ */
+export declare function createEditorStore(): EngineStoreHandle<EditorState, typeof editorActions>;
+/** Framework-bound selectors and actions; components never receive the store itself. */
+export type TaskEditorStoreProps = PropsStore<ReturnType<typeof createEditorStore>>;
+export {};
+//# sourceMappingURL=editor-store.d.ts.map

package/lib/types/client/editor-timing.d.ts

@@ -0,0 +1,47 @@
+/** Lossless guided and Custom editor projections for typed Schedule timing. */
+import type { ScheduleCatalogEntry, ScheduleTiming } from '@deepseek-ai/dsh-schedule/client';
+/** Periods represented by guided controls, plus a lossless advanced editor. */
+export type FrequencyPreset = 'once' | 'minutely' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'advanced';
+/** Editable values that determine one typed timing selector. */
+export interface TimingDraft {
+    readonly frequency: FrequencyPreset;
+    readonly interval: string;
+    readonly start: string;
+    readonly timeZone: string;
+    readonly rrule: string;
+    /** Stored typed timing, retained in Custom and used to anchor guided edits to the current period. */
+    readonly retainedTiming?: ScheduleTiming;
+    readonly weekdays: readonly number[];
+    /** Day of the month; a month without that day runs on its last day. */
+    readonly monthDay: number;
+    /** Daily `HH:MM` clock time. */
+    readonly dailyTime: string;
+}
+/**
+ * Initial form values for a new schedule.
+ * @returns Guided timing with a one-hour-ahead one-shot default.
+ */
+export declare function defaultTiming(): TimingDraft;
+/**
+ * Format guided timing as DTSTART and RRULE content lines; return advanced text verbatim.
+ * Draft fields and future occurrences require separate validation.
+ * @param draft - Guided timing values or advanced text.
+ * @param intervalFromNow - Use the current minute for intervals and the current period for edited typed recurrences;
+ * false preserves the draft anchor.
+ * @returns RFC 5545 content lines.
+ */
+export declare function rruleFromDraft(draft: TimingDraft, intervalFromNow?: boolean): string;
+/**
+ * Recover only supported form rules; unknown rules remain verbatim in Advanced mode.
+ * @param record - Stored schedule to edit.
+ * @returns Guided values or the original advanced text.
+ */
+export declare function timingFromRecord(record: ScheduleCatalogEntry): TimingDraft;
+/**
+ * Resolve Custom Cron or RRULE text into its distinct management type.
+ * @param draft - Current rule editor values, including any untouched stored timing.
+ * @param intervalFromNow - Whether saves anchor intervals and edited typed recurrences to the current date and time.
+ * @returns Typed timing for the shared Schedule management API.
+ */
+export declare function timingFromDraft(draft: TimingDraft, intervalFromNow?: boolean): ScheduleTiming;
+//# sourceMappingURL=editor-timing.d.ts.map

package/lib/types/client/frequency-locales.d.ts

@@ -11,14 +11,20 @@
  */
 /** Simplified Chinese rule and duration copy, key-set source of truth. */
 export declare const frequencyZh: {
+    readonly 'frequency.hostMonthly': "每月 {days} 日 {time}，不足该日则月末";
+    readonly 'frequency.hostDailyInterval': "每 {interval} 天 {time}";
+    readonly 'frequency.hostWeeklyInterval': "每 {interval} 周的周{weekdays} {time}";
+    readonly 'frequency.hostMonthlyInterval': "每 {interval} 个月的 {days} 日 {time}，不足该日则月末";
+    readonly 'frequency.hostZone': "{rule}（{timeZone}）";
+    readonly 'frequency.hostCustom': "自定义";
     readonly 'time.locale': "zh-CN";
     readonly 'time.utcPrefix': "UTC";
     readonly 'frequency.daily': "每天 {time}（{timeZone}）";
     readonly 'frequency.dailyLocal': "每天 {time}";
     readonly 'frequency.weekly': "每周{weekdays} {time}（{timeZone}）";
     readonly 'frequency.weeklyLocal': "每周{weekdays} {time}";
-    readonly 'frequency.cron': "Cron {expression}（{timeZone}）";
-    readonly 'frequency.cronLocal': "Cron {expression}";
+    readonly 'frequency.cron': "自定义（{timeZone}）";
+    readonly 'frequency.cronLocal': "自定义";
     readonly 'frequency.cronRule': "{rule}（{timeZone}）";
     readonly 'cron.list.join': "、";
     readonly 'cron.part.join': " ";
@@ -68,4 +74,382 @@ export declare const frequencyZh: {
 };
 /** English rule and duration copy, key-identical to the Chinese source. */
 export declare const frequencyEn: Record<keyof typeof frequencyZh, string>;
+/** Japanese copy, checked against the English keys. */
+export declare const frequencyJa: {
+    'frequency.hostMonthly': string;
+    'frequency.hostDailyInterval': string;
+    'frequency.hostWeeklyInterval': string;
+    'frequency.hostMonthlyInterval': string;
+    'frequency.hostZone': string;
+    'frequency.hostCustom': string;
+    'time.locale': string;
+    'time.utcPrefix': string;
+    'frequency.daily': string;
+    'frequency.dailyLocal': string;
+    'frequency.weekly': string;
+    'frequency.weeklyLocal': string;
+    'frequency.cron': string;
+    'frequency.cronLocal': string;
+    'frequency.cronRule': string;
+    'cron.list.join': string;
+    'cron.part.join': string;
+    'cron.weekday.name': string;
+    'cron.weekday.range': string;
+    'cron.months': string;
+    'cron.day.every': string;
+    'cron.day.weekdays': string;
+    'cron.day.monthDays': string;
+    'cron.day.both': string;
+    'cron.day.bothStarred': string;
+    'cron.hours.range': string;
+    'cron.hours.list': string;
+    'cron.time.everyMinute': string;
+    'cron.time.everyMinutes': string;
+    'cron.time.joinedEveryMinute': string;
+    'cron.time.joinedEveryMinutes': string;
+    'cron.time.everyHour': string;
+    'cron.time.joinedEveryHour': string;
+    'cron.time.everyNHours': string;
+    'cron.time.joinedEveryNHours': string;
+    'cron.time.hourlyAt': string;
+    'cron.time.joinedHourlyAt': string;
+    'cron.time.hoursEveryMinute': string;
+    'cron.time.hoursEveryMinutes': string;
+    'cron.time.at': string;
+    'cron.time.hoursAt': string;
+    'frequency.weekday.join': string;
+    'frequency.weekday.1': string;
+    'frequency.weekday.2': string;
+    'frequency.weekday.3': string;
+    'frequency.weekday.4': string;
+    'frequency.weekday.5': string;
+    'frequency.weekday.6': string;
+    'frequency.weekday.7': string;
+    'unit.day.one': string;
+    'unit.day.other': string;
+    'unit.hour.one': string;
+    'unit.hour.other': string;
+    'unit.minute.one': string;
+    'unit.minute.other': string;
+    'unit.second.one': string;
+    'unit.second.other': string;
+    'relative.now': string;
+    'relative.future': string;
+    'relative.overdue': string;
+};
+/** Spanish dictionary, checked against the English keys. */
+export declare const frequencyEs: {
+    'time.locale': string;
+    'time.utcPrefix': string;
+    'frequency.daily': string;
+    'frequency.dailyLocal': string;
+    'frequency.weekly': string;
+    'frequency.weeklyLocal': string;
+    'frequency.cron': string;
+    'frequency.cronLocal': string;
+    'frequency.cronRule': string;
+    'cron.list.join': string;
+    'cron.part.join': string;
+    'cron.weekday.name': string;
+    'cron.weekday.range': string;
+    'cron.months': string;
+    'cron.day.every': string;
+    'cron.day.weekdays': string;
+    'cron.day.monthDays': string;
+    'cron.day.both': string;
+    'cron.day.bothStarred': string;
+    'cron.hours.range': string;
+    'cron.hours.list': string;
+    'cron.time.everyMinute': string;
+    'cron.time.everyMinutes': string;
+    'cron.time.joinedEveryMinute': string;
+    'cron.time.joinedEveryMinutes': string;
+    'cron.time.everyHour': string;
+    'cron.time.joinedEveryHour': string;
+    'cron.time.everyNHours': string;
+    'cron.time.joinedEveryNHours': string;
+    'cron.time.hourlyAt': string;
+    'cron.time.joinedHourlyAt': string;
+    'cron.time.hoursEveryMinute': string;
+    'cron.time.hoursEveryMinutes': string;
+    'cron.time.at': string;
+    'cron.time.hoursAt': string;
+    'frequency.weekday.join': string;
+    'frequency.weekday.1': string;
+    'frequency.weekday.2': string;
+    'frequency.weekday.3': string;
+    'frequency.weekday.4': string;
+    'frequency.weekday.5': string;
+    'frequency.weekday.6': string;
+    'frequency.weekday.7': string;
+    'unit.day.one': string;
+    'unit.day.other': string;
+    'unit.hour.one': string;
+    'unit.hour.other': string;
+    'unit.minute.one': string;
+    'unit.minute.other': string;
+    'unit.second.one': string;
+    'unit.second.other': string;
+    'relative.now': string;
+    'relative.future': string;
+    'relative.overdue': string;
+    'frequency.hostMonthly': string;
+    'frequency.hostDailyInterval': string;
+    'frequency.hostWeeklyInterval': string;
+    'frequency.hostMonthlyInterval': string;
+    'frequency.hostZone': string;
+    'frequency.hostCustom': string;
+};
+/** French dictionary, checked against the English keys. */
+export declare const frequencyFr: {
+    'time.locale': string;
+    'time.utcPrefix': string;
+    'frequency.daily': string;
+    'frequency.dailyLocal': string;
+    'frequency.weekly': string;
+    'frequency.weeklyLocal': string;
+    'frequency.cron': string;
+    'frequency.cronLocal': string;
+    'frequency.cronRule': string;
+    'cron.list.join': string;
+    'cron.part.join': string;
+    'cron.weekday.name': string;
+    'cron.weekday.range': string;
+    'cron.months': string;
+    'cron.day.every': string;
+    'cron.day.weekdays': string;
+    'cron.day.monthDays': string;
+    'cron.day.both': string;
+    'cron.day.bothStarred': string;
+    'cron.hours.range': string;
+    'cron.hours.list': string;
+    'cron.time.everyMinute': string;
+    'cron.time.everyMinutes': string;
+    'cron.time.joinedEveryMinute': string;
+    'cron.time.joinedEveryMinutes': string;
+    'cron.time.everyHour': string;
+    'cron.time.joinedEveryHour': string;
+    'cron.time.everyNHours': string;
+    'cron.time.joinedEveryNHours': string;
+    'cron.time.hourlyAt': string;
+    'cron.time.joinedHourlyAt': string;
+    'cron.time.hoursEveryMinute': string;
+    'cron.time.hoursEveryMinutes': string;
+    'cron.time.at': string;
+    'cron.time.hoursAt': string;
+    'frequency.weekday.join': string;
+    'frequency.weekday.1': string;
+    'frequency.weekday.2': string;
+    'frequency.weekday.3': string;
+    'frequency.weekday.4': string;
+    'frequency.weekday.5': string;
+    'frequency.weekday.6': string;
+    'frequency.weekday.7': string;
+    'unit.day.one': string;
+    'unit.day.other': string;
+    'unit.hour.one': string;
+    'unit.hour.other': string;
+    'unit.minute.one': string;
+    'unit.minute.other': string;
+    'unit.second.one': string;
+    'unit.second.other': string;
+    'relative.now': string;
+    'relative.future': string;
+    'relative.overdue': string;
+    'frequency.hostMonthly': string;
+    'frequency.hostDailyInterval': string;
+    'frequency.hostWeeklyInterval': string;
+    'frequency.hostMonthlyInterval': string;
+    'frequency.hostZone': string;
+    'frequency.hostCustom': string;
+};
+/** German dictionary, checked against the English keys. */
+export declare const frequencyDe: {
+    'time.locale': string;
+    'time.utcPrefix': string;
+    'frequency.daily': string;
+    'frequency.dailyLocal': string;
+    'frequency.weekly': string;
+    'frequency.weeklyLocal': string;
+    'frequency.cron': string;
+    'frequency.cronLocal': string;
+    'frequency.cronRule': string;
+    'cron.list.join': string;
+    'cron.part.join': string;
+    'cron.weekday.name': string;
+    'cron.weekday.range': string;
+    'cron.months': string;
+    'cron.day.every': string;
+    'cron.day.weekdays': string;
+    'cron.day.monthDays': string;
+    'cron.day.both': string;
+    'cron.day.bothStarred': string;
+    'cron.hours.range': string;
+    'cron.hours.list': string;
+    'cron.time.everyMinute': string;
+    'cron.time.everyMinutes': string;
+    'cron.time.joinedEveryMinute': string;
+    'cron.time.joinedEveryMinutes': string;
+    'cron.time.everyHour': string;
+    'cron.time.joinedEveryHour': string;
+    'cron.time.everyNHours': string;
+    'cron.time.joinedEveryNHours': string;
+    'cron.time.hourlyAt': string;
+    'cron.time.joinedHourlyAt': string;
+    'cron.time.hoursEveryMinute': string;
+    'cron.time.hoursEveryMinutes': string;
+    'cron.time.at': string;
+    'cron.time.hoursAt': string;
+    'frequency.weekday.join': string;
+    'frequency.weekday.1': string;
+    'frequency.weekday.2': string;
+    'frequency.weekday.3': string;
+    'frequency.weekday.4': string;
+    'frequency.weekday.5': string;
+    'frequency.weekday.6': string;
+    'frequency.weekday.7': string;
+    'unit.day.one': string;
+    'unit.day.other': string;
+    'unit.hour.one': string;
+    'unit.hour.other': string;
+    'unit.minute.one': string;
+    'unit.minute.other': string;
+    'unit.second.one': string;
+    'unit.second.other': string;
+    'relative.now': string;
+    'relative.future': string;
+    'relative.overdue': string;
+    'frequency.hostMonthly': string;
+    'frequency.hostDailyInterval': string;
+    'frequency.hostWeeklyInterval': string;
+    'frequency.hostMonthlyInterval': string;
+    'frequency.hostZone': string;
+    'frequency.hostCustom': string;
+};
+/** Russian dictionary, checked against the English keys. */
+export declare const frequencyRu: {
+    'time.locale': string;
+    'time.utcPrefix': string;
+    'frequency.daily': string;
+    'frequency.dailyLocal': string;
+    'frequency.weekly': string;
+    'frequency.weeklyLocal': string;
+    'frequency.cron': string;
+    'frequency.cronLocal': string;
+    'frequency.cronRule': string;
+    'cron.list.join': string;
+    'cron.part.join': string;
+    'cron.weekday.name': string;
+    'cron.weekday.range': string;
+    'cron.months': string;
+    'cron.day.every': string;
+    'cron.day.weekdays': string;
+    'cron.day.monthDays': string;
+    'cron.day.both': string;
+    'cron.day.bothStarred': string;
+    'cron.hours.range': string;
+    'cron.hours.list': string;
+    'cron.time.everyMinute': string;
+    'cron.time.everyMinutes': string;
+    'cron.time.joinedEveryMinute': string;
+    'cron.time.joinedEveryMinutes': string;
+    'cron.time.everyHour': string;
+    'cron.time.joinedEveryHour': string;
+    'cron.time.everyNHours': string;
+    'cron.time.joinedEveryNHours': string;
+    'cron.time.hourlyAt': string;
+    'cron.time.joinedHourlyAt': string;
+    'cron.time.hoursEveryMinute': string;
+    'cron.time.hoursEveryMinutes': string;
+    'cron.time.at': string;
+    'cron.time.hoursAt': string;
+    'frequency.weekday.join': string;
+    'frequency.weekday.1': string;
+    'frequency.weekday.2': string;
+    'frequency.weekday.3': string;
+    'frequency.weekday.4': string;
+    'frequency.weekday.5': string;
+    'frequency.weekday.6': string;
+    'frequency.weekday.7': string;
+    'unit.day.one': string;
+    'unit.day.other': string;
+    'unit.hour.one': string;
+    'unit.hour.other': string;
+    'unit.minute.one': string;
+    'unit.minute.other': string;
+    'unit.second.one': string;
+    'unit.second.other': string;
+    'relative.now': string;
+    'relative.future': string;
+    'relative.overdue': string;
+    'frequency.hostMonthly': string;
+    'frequency.hostDailyInterval': string;
+    'frequency.hostWeeklyInterval': string;
+    'frequency.hostMonthlyInterval': string;
+    'frequency.hostZone': string;
+    'frequency.hostCustom': string;
+};
+/** Portuguese dictionary, checked against the English keys. */
+export declare const frequencyPt: {
+    'time.locale': string;
+    'time.utcPrefix': string;
+    'frequency.daily': string;
+    'frequency.dailyLocal': string;
+    'frequency.weekly': string;
+    'frequency.weeklyLocal': string;
+    'frequency.cron': string;
+    'frequency.cronLocal': string;
+    'frequency.cronRule': string;
+    'cron.list.join': string;
+    'cron.part.join': string;
+    'cron.weekday.name': string;
+    'cron.weekday.range': string;
+    'cron.months': string;
+    'cron.day.every': string;
+    'cron.day.weekdays': string;
+    'cron.day.monthDays': string;
+    'cron.day.both': string;
+    'cron.day.bothStarred': string;
+    'cron.hours.range': string;
+    'cron.hours.list': string;
+    'cron.time.everyMinute': string;
+    'cron.time.everyMinutes': string;
+    'cron.time.joinedEveryMinute': string;
+    'cron.time.joinedEveryMinutes': string;
+    'cron.time.everyHour': string;
+    'cron.time.joinedEveryHour': string;
+    'cron.time.everyNHours': string;
+    'cron.time.joinedEveryNHours': string;
+    'cron.time.hourlyAt': string;
+    'cron.time.joinedHourlyAt': string;
+    'cron.time.hoursEveryMinute': string;
+    'cron.time.hoursEveryMinutes': string;
+    'cron.time.at': string;
+    'cron.time.hoursAt': string;
+    'frequency.weekday.join': string;
+    'frequency.weekday.1': string;
+    'frequency.weekday.2': string;
+    'frequency.weekday.3': string;
+    'frequency.weekday.4': string;
+    'frequency.weekday.5': string;
+    'frequency.weekday.6': string;
+    'frequency.weekday.7': string;
+    'unit.day.one': string;
+    'unit.day.other': string;
+    'unit.hour.one': string;
+    'unit.hour.other': string;
+    'unit.minute.one': string;
+    'unit.minute.other': string;
+    'unit.second.one': string;
+    'unit.second.other': string;
+    'relative.now': string;
+    'relative.future': string;
+    'relative.overdue': string;
+    'frequency.hostMonthly': string;
+    'frequency.hostDailyInterval': string;
+    'frequency.hostWeeklyInterval': string;
+    'frequency.hostMonthlyInterval': string;
+    'frequency.hostZone': string;
+    'frequency.hostCustom': string;
+};
 //# sourceMappingURL=frequency-locales.d.ts.map

package/lib/types/client/index.d.ts

@@ -24,8 +24,8 @@
  * `sidebar.session.row.leading` seat marks an idle row whose Session has an
  * active task, and its `sidebar.session.row.hover` seat lists those tasks
  * inside the row's hover card. Both project the same source, so N visible rows
- * issue one query rather than one per row. The header entry keeps its own
- * per-Session source.
+ * issue one query rather than one per row. The header entry projects the same
+ * source onto the open Session's active tasks.
  */
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
 import { type ScheduleCatalogKey } from './locales.ts';
@@ -38,12 +38,12 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
         'schedule.manager': TaskManagerKey;
     }
 }
-/** Required services for catalogs, ambient Session marks, the right Sidebar, Remote queries, and original-Session navigation. */
+/** Required services for catalogs, ambient Session marks, the right Sidebar, Remote queries, linked-Session navigation, and access. */
 export declare const inject: string[];
 /**
  * Register the Host task page, the Session-header reminder catalog, the
  * right-Sidebar page that shows one task's detail, and the transcript card of
- * one created task.
+ * one created task while the current Peer may read the task catalog.
  * @param ctx - browser services used by these contributions.
  */
 export declare function apply(ctx: ClientContext): void;