@outbuild-company/schedule-core 1.25.0 → 1.26.0

package/dist/index.d.cts

@@ -724,6 +724,12 @@ interface ScheduleAutoScheduleAction {
  *
  * Link `lag` inputs are working days and are converted to stored working hours.
  * Consumer analytics context is carried by optional `eventSource` fields.
+ *
+ * `CELL_COPY`'s `copiedText` and `CELL_PASTE_COPIED`'s `clipboardText` carry the
+ * host's OS-clipboard text alongside the structured value. When `clipboardText`
+ * no longer matches the `copiedText` stashed at copy time (or nothing was ever
+ * copied through the core), the paste falls back to that raw text through the
+ * target column's own `parseInput` instead of the stashed structured value.
  */
 type DispatchAction = {
     kind: typeof DISPATCH_ACTION_KIND.ACTIVITY_COPY;
@@ -752,6 +758,7 @@ type DispatchAction = {
     kind: typeof DISPATCH_ACTION_KIND.CELL_COPY;
     activityId: ActivityId;
     column: EditableColumnName;
+    copiedText?: string;
     eventSource?: string;
 } | {
     kind: typeof DISPATCH_ACTION_KIND.CELL_CLIPBOARD_CLEAR;
@@ -760,6 +767,7 @@ type DispatchAction = {
     kind: typeof DISPATCH_ACTION_KIND.CELL_PASTE_COPIED;
     activityIds: ReadonlyArray<ActivityId>;
     column: EditableColumnName;
+    clipboardText?: string;
     eventSource?: string;
 } | {
     kind: typeof DISPATCH_ACTION_KIND.PERSISTENCE_ACKNOWLEDGE;
@@ -2154,25 +2162,35 @@ interface ScheduleCellsApi {
      * Copies one activity's cell value to core-owned clipboard state.
      *
      * Predecessor and successor columns copy the underlying dependency links;
-     * every other column copies its canonical field value.
+     * every other column copies its canonical field value alongside `copiedText`,
+     * the host's OS-clipboard text at copy time.
      * @param activityId - Source activity.
      * @param column - Source column.
+     * @param copiedText - Host OS-clipboard text to stash alongside the value.
      * @param context - Optional consumer event source.
      * @returns The complete dispatch result.
      */
-    copy(activityId: ActivityId, column: EditableColumnName, context?: MutationContext): Promise<DispatchResult>;
+    copy(activityId: ActivityId, column: EditableColumnName, copiedText?: string, context?: MutationContext): Promise<DispatchResult>;
     /**
      * Pastes the copied cell value into one or more activities' column.
      *
      * Predecessor and successor columns paste cross-compatibly with each
-     * other; every other column is rejected unless its own pipeline accepts
-     * the copied value.
+     * other and ignore `clipboardText`. For every other column: `tags`,
+     * `responsables`, `subcontract_id`, `constraint_type` and `calendar_id`
+     * only accept a paste whose source was the exact same column, rejected
+     * with `CELL_PASTE_COLUMN_MISMATCH` otherwise; every other column pair is
+     * left to the target column's own pipeline. When `clipboardText` no
+     * longer matches the text stashed at copy time (or nothing was ever
+     * copied through the core), the stashed value is dropped and
+     * `clipboardText` itself is pasted through the target column's own
+     * `parseInput` instead.
      * @param activityIds - Destination activities.
      * @param column - Destination column.
+     * @param clipboardText - Host OS-clipboard text at paste time.
      * @param context - Optional consumer event source.
      * @returns The complete dispatch result.
      */
-    paste(activityIds: ReadonlyArray<ActivityId>, column: EditableColumnName, context?: MutationContext): Promise<DispatchResult>;
+    paste(activityIds: ReadonlyArray<ActivityId>, column: EditableColumnName, clipboardText?: string, context?: MutationContext): Promise<DispatchResult>;
     /** @returns The complete result of clearing core-owned cell clipboard state. */
     clearClipboard(context?: MutationContext): Promise<DispatchResult>;
 }
@@ -3669,6 +3687,7 @@ declare const REJECTION_REASON: {
     readonly NO_ACTIVITY_SELECTION: "no_activity_selection";
     readonly CLIPBOARD_EMPTY: "clipboard_empty";
     readonly CLIPBOARD_SNAPSHOT_INVALID: "clipboard_snapshot_invalid";
+    readonly CELL_PASTE_COLUMN_MISMATCH: "cell_paste_column_mismatch";
     readonly ACTIVITY_PASTE_INVARIANT_FAILED: "activity_paste_invariant_failed";
     readonly SOLE_SCHEDULE_ROOT: "sole_schedule_root";
     readonly ANCHOR_SIBLING_CONFLICT: "anchor_sibling_conflict";

package/dist/index.d.ts

@@ -724,6 +724,12 @@ interface ScheduleAutoScheduleAction {
  *
  * Link `lag` inputs are working days and are converted to stored working hours.
  * Consumer analytics context is carried by optional `eventSource` fields.
+ *
+ * `CELL_COPY`'s `copiedText` and `CELL_PASTE_COPIED`'s `clipboardText` carry the
+ * host's OS-clipboard text alongside the structured value. When `clipboardText`
+ * no longer matches the `copiedText` stashed at copy time (or nothing was ever
+ * copied through the core), the paste falls back to that raw text through the
+ * target column's own `parseInput` instead of the stashed structured value.
  */
 type DispatchAction = {
     kind: typeof DISPATCH_ACTION_KIND.ACTIVITY_COPY;
@@ -752,6 +758,7 @@ type DispatchAction = {
     kind: typeof DISPATCH_ACTION_KIND.CELL_COPY;
     activityId: ActivityId;
     column: EditableColumnName;
+    copiedText?: string;
     eventSource?: string;
 } | {
     kind: typeof DISPATCH_ACTION_KIND.CELL_CLIPBOARD_CLEAR;
@@ -760,6 +767,7 @@ type DispatchAction = {
     kind: typeof DISPATCH_ACTION_KIND.CELL_PASTE_COPIED;
     activityIds: ReadonlyArray<ActivityId>;
     column: EditableColumnName;
+    clipboardText?: string;
     eventSource?: string;
 } | {
     kind: typeof DISPATCH_ACTION_KIND.PERSISTENCE_ACKNOWLEDGE;
@@ -2154,25 +2162,35 @@ interface ScheduleCellsApi {
      * Copies one activity's cell value to core-owned clipboard state.
      *
      * Predecessor and successor columns copy the underlying dependency links;
-     * every other column copies its canonical field value.
+     * every other column copies its canonical field value alongside `copiedText`,
+     * the host's OS-clipboard text at copy time.
      * @param activityId - Source activity.
      * @param column - Source column.
+     * @param copiedText - Host OS-clipboard text to stash alongside the value.
      * @param context - Optional consumer event source.
      * @returns The complete dispatch result.
      */
-    copy(activityId: ActivityId, column: EditableColumnName, context?: MutationContext): Promise<DispatchResult>;
+    copy(activityId: ActivityId, column: EditableColumnName, copiedText?: string, context?: MutationContext): Promise<DispatchResult>;
     /**
      * Pastes the copied cell value into one or more activities' column.
      *
      * Predecessor and successor columns paste cross-compatibly with each
-     * other; every other column is rejected unless its own pipeline accepts
-     * the copied value.
+     * other and ignore `clipboardText`. For every other column: `tags`,
+     * `responsables`, `subcontract_id`, `constraint_type` and `calendar_id`
+     * only accept a paste whose source was the exact same column, rejected
+     * with `CELL_PASTE_COLUMN_MISMATCH` otherwise; every other column pair is
+     * left to the target column's own pipeline. When `clipboardText` no
+     * longer matches the text stashed at copy time (or nothing was ever
+     * copied through the core), the stashed value is dropped and
+     * `clipboardText` itself is pasted through the target column's own
+     * `parseInput` instead.
      * @param activityIds - Destination activities.
      * @param column - Destination column.
+     * @param clipboardText - Host OS-clipboard text at paste time.
      * @param context - Optional consumer event source.
      * @returns The complete dispatch result.
      */
-    paste(activityIds: ReadonlyArray<ActivityId>, column: EditableColumnName, context?: MutationContext): Promise<DispatchResult>;
+    paste(activityIds: ReadonlyArray<ActivityId>, column: EditableColumnName, clipboardText?: string, context?: MutationContext): Promise<DispatchResult>;
     /** @returns The complete result of clearing core-owned cell clipboard state. */
     clearClipboard(context?: MutationContext): Promise<DispatchResult>;
 }
@@ -3669,6 +3687,7 @@ declare const REJECTION_REASON: {
     readonly NO_ACTIVITY_SELECTION: "no_activity_selection";
     readonly CLIPBOARD_EMPTY: "clipboard_empty";
     readonly CLIPBOARD_SNAPSHOT_INVALID: "clipboard_snapshot_invalid";
+    readonly CELL_PASTE_COLUMN_MISMATCH: "cell_paste_column_mismatch";
     readonly ACTIVITY_PASTE_INVARIANT_FAILED: "activity_paste_invariant_failed";
     readonly SOLE_SCHEDULE_ROOT: "sole_schedule_root";
     readonly ANCHOR_SIBLING_CONFLICT: "anchor_sibling_conflict";

package/dist/index.js

@@ -628,17 +628,19 @@ function createActivitiesApi(engine) {
 }
 function createCellsApi(engine) {
   return {
-    copy: (activityId, column, context = {}) => engine.dispatch({
+    copy: (activityId, column, copiedText, context = {}) => engine.dispatch({
       ...context,
       kind: DISPATCH_ACTION_KIND.CELL_COPY,
       activityId,
-      column
+      column,
+      ...copiedText === void 0 ? {} : { copiedText }
     }),
-    paste: (activityIds, column, context = {}) => engine.dispatch({
+    paste: (activityIds, column, clipboardText, context = {}) => engine.dispatch({
       ...context,
       kind: DISPATCH_ACTION_KIND.CELL_PASTE_COPIED,
       activityIds,
-      column
+      column,
+      ...clipboardText === void 0 ? {} : { clipboardText }
     }),
     clearClipboard: (context = {}) => engine.dispatch({
       ...context,
@@ -955,6 +957,7 @@ var REJECTION_REASON = {
   NO_ACTIVITY_SELECTION: "no_activity_selection",
   CLIPBOARD_EMPTY: "clipboard_empty",
   CLIPBOARD_SNAPSHOT_INVALID: "clipboard_snapshot_invalid",
+  CELL_PASTE_COLUMN_MISMATCH: "cell_paste_column_mismatch",
   ACTIVITY_PASTE_INVARIANT_FAILED: "activity_paste_invariant_failed",
   SOLE_SCHEDULE_ROOT: "sole_schedule_root",
   ANCHOR_SIBLING_CONFLICT: "anchor_sibling_conflict",
@@ -19010,7 +19013,12 @@ function dispatchCellCopy(action, deps) {
     return { ok: false, reason: REJECTION_REASON.INVALID_VALUE };
   }
   const raw = action.column === COLUMN.DURATION ? canonicalValue / deps.hoursPerDay : cloneDomainValue(canonicalValue);
-  deps.clipboard.value = { kind: CELL_CLIPBOARD_KIND.FIELD, raw };
+  deps.clipboard.value = {
+    kind: CELL_CLIPBOARD_KIND.FIELD,
+    raw,
+    sourceColumn: action.column,
+    text: action.copiedText ?? null
+  };
   return emptyChangeSet(action);
 }
 function dispatchCellClipboardClear(action, clipboard) {
@@ -19019,6 +19027,39 @@ function dispatchCellClipboardClear(action, clipboard) {
 }
 
 // src/cell-copy-paste/paste.ts
+var RESTRICTED_CELL_COLUMNS = /* @__PURE__ */ new Set([
+  COLUMN.TAGS,
+  COLUMN.RESPONSABLES,
+  COLUMN.SUBCONTRACT_ID,
+  COLUMN.CONSTRAINT_TYPE,
+  COLUMN.CALENDAR_ID
+]);
+function isIncompatibleCellPaste(sourceColumn, targetColumn) {
+  if (sourceColumn === targetColumn) return false;
+  return RESTRICTED_CELL_COLUMNS.has(sourceColumn) || RESTRICTED_CELL_COLUMNS.has(targetColumn);
+}
+function resolveExternalPasteText(stashedField, clipboardText) {
+  if (clipboardText === void 0) return null;
+  const rawIsTrustworthy = stashedField !== null && (stashedField.text === null || stashedField.text === clipboardText);
+  return rawIsTrustworthy ? null : clipboardText;
+}
+function resolveFieldPasteValue(clipboard, column, clipboardText) {
+  const stashedField = clipboard !== null && clipboard.kind === CELL_CLIPBOARD_KIND.FIELD ? clipboard : null;
+  const externalText = resolveExternalPasteText(stashedField, clipboardText);
+  if (externalText !== null) {
+    return { ok: true, newValue: externalText };
+  }
+  if (clipboard !== null && clipboard.kind !== CELL_CLIPBOARD_KIND.FIELD) {
+    return { ok: false, reason: REJECTION_REASON.INVALID_VALUE };
+  }
+  if (stashedField === null) {
+    return { ok: false, reason: REJECTION_REASON.CLIPBOARD_EMPTY };
+  }
+  if (isIncompatibleCellPaste(stashedField.sourceColumn, column)) {
+    return { ok: false, reason: REJECTION_REASON.CELL_PASTE_COLUMN_MISMATCH };
+  }
+  return { ok: true, newValue: stashedField.raw };
+}
 function toDiffPlaceholder(activityId) {
   return String(activityId);
 }
@@ -19051,11 +19092,45 @@ function linkOperationsForTarget(targetActivityId, isPredecessors, clipboard, de
   });
   return diff.operations;
 }
-async function dispatchCellPasteCopied(action, options, deps) {
-  const clipboard = deps.cellClipboard.value;
+async function dispatchCellPasteLinkColumn(action, clipboard, options, deps) {
   if (clipboard === null) {
     return { ok: false, reason: REJECTION_REASON.CLIPBOARD_EMPTY };
   }
+  if (clipboard.kind !== CELL_CLIPBOARD_KIND.LINKS) {
+    return { ok: false, reason: REJECTION_REASON.INVALID_VALUE };
+  }
+  const hasSelfReference = action.activityIds.some(
+    (activityId) => clipboard.specs.some(
+      (spec) => String(spec.otherActivityId) === String(activityId)
+    )
+  );
+  if (hasSelfReference) {
+    return { ok: false, reason: LINK_REJECTION_REASON.SELF_LINK };
+  }
+  const isPredecessors = action.column === COLUMN.CUSTOM_PREDECESSORS;
+  const operations = action.activityIds.flatMap(
+    (activityId) => linkOperationsForTarget(activityId, isPredecessors, clipboard, deps)
+  );
+  const createEntries = operations.filter(
+    (operation) => operation.kind === LINK_OPERATION_KIND.CREATE
+  ).map((operation) => ({
+    operation,
+    linkId: deps.linkIdGen.next()
+  }));
+  const creation = validateLinkCreateBatch(createEntries, {
+    port: deps.adapter,
+    rejectParentLinkMutations: options.rejectParentLinkMutations ?? false
+  });
+  if (!creation.applied) {
+    return {
+      ok: false,
+      reason: creation.rejected ?? REJECTION_REASON.INVALID
+    };
+  }
+  return dispatchLinkBatch(operations, action, options, deps);
+}
+async function dispatchCellPasteCopied(action, options, deps) {
+  const clipboard = deps.cellClipboard.value;
   if (action.activityIds.length === 0) {
     return { ok: false, reason: REJECTION_REASON.ACTIVITY_IDS_EMPTY };
   }
@@ -19066,53 +19141,25 @@ async function dispatchCellPasteCopied(action, options, deps) {
     return { ok: false, reason: REJECTION_REASON.ACTIVITY_NOT_FOUND };
   }
   if (action.column === COLUMN.CUSTOM_PREDECESSORS || action.column === COLUMN.CUSTOM_SUCESSORS) {
-    if (clipboard.kind !== CELL_CLIPBOARD_KIND.LINKS) {
-      return { ok: false, reason: REJECTION_REASON.INVALID_VALUE };
-    }
-    const hasSelfReference = action.activityIds.some(
-      (activityId) => clipboard.specs.some(
-        (spec) => String(spec.otherActivityId) === String(activityId)
-      )
-    );
-    if (hasSelfReference) {
-      return { ok: false, reason: LINK_REJECTION_REASON.SELF_LINK };
-    }
-    const isPredecessors = action.column === COLUMN.CUSTOM_PREDECESSORS;
-    const operations = action.activityIds.flatMap(
-      (activityId) => linkOperationsForTarget(activityId, isPredecessors, clipboard, deps)
-    );
-    const createEntries = operations.filter(
-      (operation) => operation.kind === LINK_OPERATION_KIND.CREATE
-    ).map((operation) => ({
-      operation,
-      linkId: deps.linkIdGen.next()
-    }));
-    const creation = validateLinkCreateBatch(createEntries, {
-      port: deps.adapter,
-      rejectParentLinkMutations: options.rejectParentLinkMutations ?? false
-    });
-    if (!creation.applied) {
-      return {
-        ok: false,
-        reason: creation.rejected ?? REJECTION_REASON.INVALID
-      };
-    }
-    return dispatchLinkBatch(operations, action, options, deps);
-  }
-  if (clipboard.kind !== CELL_CLIPBOARD_KIND.FIELD) {
-    return { ok: false, reason: REJECTION_REASON.INVALID_VALUE };
+    return dispatchCellPasteLinkColumn(action, clipboard, options, deps);
   }
   if (!findPipelineForColumn(action.column)) {
     return { ok: false, reason: REJECTION_REASON.NO_PIPELINE_FOR_COLUMN };
   }
   const column = action.column;
+  const resolution = resolveFieldPasteValue(
+    clipboard,
+    column,
+    action.clipboardText
+  );
+  if (!resolution.ok) return resolution;
   const result = await dispatchBulkEdit(
     {
       kind: DISPATCH_ACTION_KIND.BULK_EDIT,
       edits: action.activityIds.map((activityId) => ({
         activityId,
         column,
-        newValue: clipboard.raw
+        newValue: resolution.newValue
       })),
       ...action.eventSource === void 0 ? {} : { eventSource: action.eventSource }
     },