@pisell/pisellos 2.2.313 → 2.2.315

package/dist/modules/ResourcePlanner/planner.js

@@ -1,4 +1,8 @@
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
 function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
@@ -171,7 +175,11 @@ function resolveCutOffPolicyIssue(policy) {
   return null;
 }
 function addLeadWindow(base, unit, unitType, _timezoneName) {
-  if (unitType === 'days') return addLocalCalendarDays(base, unit);
+  if (unitType === 'days') {
+    var leadDate = addLocalCalendarDays(base, unit);
+    // Positive day lead times start at midnight; zero days keeps the current-time boundary.
+    return Math.trunc(unit) > 0 ? localDateToScalarStart(formatLocalDate(leadDate)) : leadDate;
+  }
   if (unitType === 'hours') return addLocalHours(base, unit);
   return addLocalMinutes(base, unit);
 }
@@ -263,6 +271,18 @@ function evaluateCandidateTimeGate(params) {
     };
   }
   var policy = product.cutOffPolicy;
+  // Current duration items can be shown outside business hours. Their real
+  // interval must remain unavailable, including products with no resource groups.
+  if (evaluationContext.useDurationTimeGrid && product.kind === 'duration' && !projection.meta.defaults.operatingHours.windows.some(function (window) {
+    var range = normalizeAbsoluteRange(window);
+    return range && contains(range, candidateRange);
+  })) {
+    return {
+      status: 'unavailable',
+      reasonCodes: ['outside_operating_hours'],
+      conflictCode: 'booking_cutoff'
+    };
+  }
   if (!policy) return null;
   if (resolveCutOffPolicyIssue(policy)) {
     return {
@@ -299,8 +319,8 @@ function evaluateCandidateTimeGate(params) {
     // otherwise a minute refresh turns it into 0 capacity and incorrectly
     // advances a create flow to the next slot. The earlier `past` gate still
     // rejects the anchor once its booking range has ended.
-    var isActivePosDurationAnchor = evaluationContext.useExactDurationCandidateMinute && product.kind === 'duration' && !product.isFlexibleDuration && evaluationContext.durationCandidateAnchorAtMs === candidateRange.start;
-    var usesMinutePrecision = product.isFlexibleDuration || evaluationContext.useExactDurationCandidateMinute && product.kind === 'duration';
+    var isActivePosDurationAnchor = evaluationContext.useExactDurationCandidateMinute && !evaluationContext.enforceSaleCutoff && product.kind === 'duration' && !product.isFlexibleDuration && evaluationContext.durationCandidateAnchorAtMs === candidateRange.start;
+    var usesMinutePrecision = product.isFlexibleDuration || evaluationContext.useDurationTimeGrid || evaluationContext.useExactDurationCandidateMinute && product.kind === 'duration';
     var hasNotReachedStart = isActivePosDurationAnchor || (usesMinutePrecision ? floorToMinute(now) <= candidateRange.start : now < candidateRange.start);
     if (hasNotReachedStart) return null;
     return {
@@ -494,7 +514,7 @@ function normalizeResources(resources) {
   });
 }
 function normalizeOperatingHours(params) {
-  var _params$input, _params$input2, _params$input3, _params$input4;
+  var _params$input, _params$input2, _params$input3, _params$input4, _params$input5, _params$input6;
   var fallbackWindows = enumerateDates(params.dateRange.startDate, params.dateRange.endDate).map(function (date) {
     var start = toDateTimeInDate(date, params.businessHours.startTime, params.timezoneName);
     var end = toDateTimeInDate(date, params.businessHours.endTime, params.timezoneName);
@@ -530,11 +550,43 @@ function normalizeOperatingHours(params) {
   };
   var windows = normalizeWindows(sourceWindows);
   var excludedWindows = normalizeWindows(((_params$input = params.input) === null || _params$input === void 0 ? void 0 : _params$input.excludedWindows) || []);
+  // Keep original dates and opening anchors separately: the availability
+  // windows below may be clipped at midnight or merged without segment identity.
+  var periodMap = new Map();
+  var originalPeriods = ((_params$input2 = params.input) === null || _params$input2 === void 0 ? void 0 : _params$input2.businessPeriods) || [].concat(_toConsumableArray(sourceWindows), _toConsumableArray(((_params$input3 = params.input) === null || _params$input3 === void 0 ? void 0 : _params$input3.excludedWindows) || [])).map(function (window) {
+    return {
+      businessDate: window.businessDate || window.startAt.slice(0, 10),
+      startAt: window.openingAnchorAt || window.startAt,
+      endAt: window.endAt
+    };
+  });
+  originalPeriods.forEach(function (period) {
+    var range = normalizeAbsoluteRange(period);
+    if (!range) return;
+    var previous = periodMap.get(period.businessDate);
+    periodMap.set(period.businessDate, {
+      start: previous ? Math.min(previous.start, range.start) : range.start,
+      end: previous ? Math.max(previous.end, range.end) : range.end
+    });
+  });
+  var businessPeriods = Array.from(periodMap, function (_ref) {
+    var _ref2 = _slicedToArray(_ref, 2),
+      businessDate = _ref2[0],
+      range = _ref2[1];
+    return {
+      businessDate: businessDate,
+      startAt: formatDateTime(range.start, params.timezoneName, params.fixedOffsetMinutes),
+      endAt: formatDateTime(range.end, params.timezoneName, params.fixedOffsetMinutes)
+    };
+  }).sort(function (left, right) {
+    return left.startAt.localeCompare(right.startAt);
+  });
   return _objectSpread({
-    source: ((_params$input2 = params.input) === null || _params$input2 === void 0 ? void 0 : _params$input2.source) || params.fallbackSource,
-    scheduleIds: uniqById(((_params$input3 = params.input) === null || _params$input3 === void 0 ? void 0 : _params$input3.scheduleIds) || []),
-    missingScheduleIds: uniqById(((_params$input4 = params.input) === null || _params$input4 === void 0 ? void 0 : _params$input4.missingScheduleIds) || []),
-    windows: windows
+    source: ((_params$input4 = params.input) === null || _params$input4 === void 0 ? void 0 : _params$input4.source) || params.fallbackSource,
+    scheduleIds: uniqById(((_params$input5 = params.input) === null || _params$input5 === void 0 ? void 0 : _params$input5.scheduleIds) || []),
+    missingScheduleIds: uniqById(((_params$input6 = params.input) === null || _params$input6 === void 0 ? void 0 : _params$input6.missingScheduleIds) || []),
+    windows: windows,
+    businessPeriods: businessPeriods
   }, excludedWindows.length > 0 ? {
     excludedWindows: excludedWindows
   } : {});
@@ -553,8 +605,8 @@ function matchesRequirementGroup(requirementGroup, resource, product) {
   return resource.capacity >= resolveRequiredCapacity(requirementGroup, product, partySize);
 }
 function resolveRequiredCapacity(requirementGroup, product, partySize) {
-  var _ref, _ref2;
-  return Math.max(1, Number((_ref = (_ref2 = partySize !== null && partySize !== void 0 ? partySize : requirementGroup.capacityRequired) !== null && _ref2 !== void 0 ? _ref2 : product.capacityRequired) !== null && _ref !== void 0 ? _ref : 1) || 1);
+  var _ref3, _ref4;
+  return Math.max(1, Number((_ref3 = (_ref4 = partySize !== null && partySize !== void 0 ? partySize : requirementGroup.capacityRequired) !== null && _ref4 !== void 0 ? _ref4 : product.capacityRequired) !== null && _ref3 !== void 0 ? _ref3 : 1) || 1);
 }
 function buildCellKey(params) {
   return [String(params.productId), params.groupId, String(params.resourceId), params.start, params.end].join(':');
@@ -608,8 +660,8 @@ function buildCells(projection) {
           boundaries.add(window.start);
           boundaries.add(window.end);
         });
-        occupancies.forEach(function (_ref3) {
-          var range = _ref3.range;
+        occupancies.forEach(function (_ref5) {
+          var range = _ref5.range;
           boundaries.add(range.start);
           boundaries.add(range.end);
         });
@@ -627,11 +679,11 @@ function buildCells(projection) {
           var isInsideWorkingWindow = windows.some(function (window) {
             return contains(window, segment);
           });
-          var segmentOccupancies = isInsideWorkingWindow ? occupancies.filter(function (_ref4) {
-            var range = _ref4.range;
+          var segmentOccupancies = isInsideWorkingWindow ? occupancies.filter(function (_ref6) {
+            var range = _ref6.range;
             return overlaps(range, segment);
-          }).map(function (_ref5) {
-            var occupancy = _ref5.occupancy;
+          }).map(function (_ref7) {
+            var occupancy = _ref7.occupancy;
             return occupancy;
           }) : [];
           var usedCapacity = segmentOccupancies.reduce(function (sum, occupancy) {
@@ -1108,6 +1160,211 @@ function createDurationTimeRangeWithEnd(product, start, bookingEnd, projection,
     scheduleRefs: []
   };
 }
+
+/** Resolve the label without changing the real calendar timestamp. */
+export function getDurationBusinessDate(projection, startAt) {
+  var start = toDateTime(startAt);
+  var periods = projection.meta.defaults.operatingHours.businessPeriods || [];
+  var period = _toConsumableArray(periods).reverse().find(function (item) {
+    var range = normalizeAbsoluteRange(item);
+    return range && range.start <= start && start < range.end;
+  });
+  return (period === null || period === void 0 ? void 0 : period.businessDate) || startAt.slice(0, 10);
+}
+function getAlignedDurationRanges(params) {
+  var _request$rememberedSt, _request$editingStart;
+  var projection = params.projection,
+    product = params.product,
+    request = params.request,
+    runtimeOptions = params.runtimeOptions,
+    dateRange = params.dateRange,
+    operatingRanges = params.operatingRanges,
+    baseRanges = params.baseRanges,
+    resourceWindowIndex = params.resourceWindowIndex,
+    fixedOffsetMinutes = params.fixedOffsetMinutes;
+  var step = projection.meta.defaults.slotStepMinutes;
+  var now = floorToMinute(toDateTime(runtimeOptions.evaluatedAt || projection.meta.durationCandidateAnchorAt));
+  if (!Number.isFinite(now)) throw availabilityError('INVALID_TARGET_FILTER', 'evaluatedAt 必须是有效时间');
+  var nowAt = formatDateTime(now, projection.meta.timezone, fixedOffsetMinutes);
+  var currentBusinessDate = getDurationBusinessDate(projection, nowAt);
+  var inRequestedDays = function inRequestedDays(date) {
+    return date >= dateRange.startDate && date <= dateRange.endDate;
+  };
+  var periods = (projection.meta.defaults.operatingHours.businessPeriods || []).filter(function (period) {
+    return inRequestedDays(period.businessDate);
+  });
+  // A prepared month includes tomorrow's windows too; the single-day UI must
+  // receive the selected business cycle's end, not tomorrow's closing time.
+  var operatingEndAt = dateRange.startDate === dateRange.endDate && periods.length ? periods.reduce(function (latest, period) {
+    return period.endAt > latest ? period.endAt : latest;
+  }, periods[0].endAt) : undefined;
+  var ranges = [];
+  var duration = resolveRequestedDurationMinutes(product, request);
+  var addRange = function addRange(start, end, businessDate) {
+    if (end <= start) return;
+    var candidate = createDurationTimeRangeWithEnd(product, start, end, projection, fixedOffsetMinutes);
+    candidate.businessDate = businessDate || getDurationBusinessDate(projection, candidate.startAt);
+    if (inRequestedDays(candidate.businessDate)) ranges.push(candidate);
+  };
+  // A flexible end comes from resources that actually cover this exact start,
+  // never from the next future window. Keep alternative real ends separate.
+  var flexibleEnds = function flexibleEnds(start) {
+    var _projection$meta$defa;
+    var operating = operatingRanges.find(function (range) {
+      return range.start <= start && start < range.end;
+    });
+    if (!operating) return [];
+    var businessDate = getDurationBusinessDate(projection, formatDateTime(start, projection.meta.timezone, fixedOffsetMinutes));
+    var period = (_projection$meta$defa = projection.meta.defaults.operatingHours.businessPeriods) === null || _projection$meta$defa === void 0 ? void 0 : _projection$meta$defa.find(function (item) {
+      return item.businessDate === businessDate;
+    });
+    var operatingEnd = Math.min(operating.end, period ? toDateTime(period.endAt) : operating.end);
+    var requiredGroups = (product.requirementGroups || []).filter(function (group) {
+      return group.required !== false;
+    });
+    var groups = requiredGroups.map(function (group) {
+      return projection.resources.filter(function (resource) {
+        return matchesRequirementGroup(group, resource, product, request.partySize);
+      }).filter(function (resource) {
+        var _request$resourceIds;
+        return !((_request$resourceIds = request.resourceIds) !== null && _request$resourceIds !== void 0 && _request$resourceIds.length) || request.resourceIds.some(function (id) {
+          return sameId(id, resource.id);
+        });
+      }).flatMap(function (resource) {
+        return (resourceWindowIndex.get(String(resource.id)) || []).filter(function (range) {
+          return range.start <= start && start < range.end;
+        }).map(function (range) {
+          return Math.min(range.end, operatingEnd);
+        });
+      });
+    });
+    if (groups.some(function (ends) {
+      return ends.length === 0;
+    })) return [];
+    if (!groups.length) return [operatingEnd];
+    return Array.from(new Set(groups.flat())).filter(function (end) {
+      return groups.every(function (ends) {
+        return ends.some(function (availableEnd) {
+          return availableEnd >= end;
+        });
+      });
+    }).sort(function (left, right) {
+      return left - right;
+    });
+  };
+  if (product.isFlexibleDuration) {
+    // Preserve the existing continuous-window UI, with the business-day label.
+    periods.forEach(function (period) {
+      var periodRange = normalizeAbsoluteRange(period);
+      baseRanges.forEach(function (range) {
+        var start = Math.max(range.start, periodRange.start, now);
+        var end = Math.min(range.end, periodRange.end);
+        if (start < end) addRange(start, end, period.businessDate);
+      });
+    });
+  } else {
+    periods.forEach(function (period) {
+      var periodRange = normalizeAbsoluteRange(period);
+      var anchor = 60 % step === 0 ? toDateStart(period.businessDate) : periodRange.start;
+      baseRanges.forEach(function (range) {
+        var lower = Math.max(range.start, periodRange.start, now);
+        var upper = Math.min(range.end, periodRange.end);
+        var cursor = anchor + Math.ceil((lower - anchor) / (step * 60000)) * step * 60000;
+        for (; cursor + duration * 60000 <= upper; cursor += step * 60000) {
+          addRange(cursor, cursor + duration * 60000, period.businessDate);
+        }
+      });
+    });
+  }
+  var unavailableCurrentTime;
+  if (inRequestedDays(currentBusinessDate)) {
+    if (product.isFlexibleDuration) {
+      var ends = flexibleEnds(now);
+      ends.forEach(function (end) {
+        return addRange(now, end, currentBusinessDate);
+      });
+      if (!ends.length) {
+        unavailableCurrentTime = {
+          productId: product.id,
+          startAt: nowAt,
+          date: formatDate(now),
+          businessDate: currentBusinessDate,
+          startTime: formatTime(now),
+          status: 'unavailable',
+          reasonCodes: [operatingRanges.some(function (range) {
+            return range.start <= now && now < range.end;
+          }) ? 'outside_resource_window' : 'outside_operating_hours']
+        };
+      }
+    } else {
+      // Even outside a working window the fixed product has a real end. Query
+      // reports unavailable; POS manual capabilities remain a separate policy.
+      addRange(now, now + duration * 60000, currentBusinessDate);
+    }
+  }
+  var rememberedAt = (_request$rememberedSt = request.rememberedStartAtByProductId) === null || _request$rememberedSt === void 0 ? void 0 : _request$rememberedSt[String(product.id)];
+  if (rememberedAt !== undefined) {
+    var start = toDateTime(rememberedAt);
+    if (!Number.isFinite(start)) throw availabilityError('INVALID_TARGET_FILTER', '记忆开始时间必须是完整日期时间');
+    if (product.isFlexibleDuration) {
+      flexibleEnds(start).forEach(function (end) {
+        return addRange(start, end);
+      });
+    } else {
+      addRange(start, start + duration * 60000);
+    }
+  }
+  var editingAt = (_request$editingStart = request.editingStartAtByProductId) === null || _request$editingStart === void 0 ? void 0 : _request$editingStart[String(product.id)];
+  if (editingAt !== undefined) {
+    var _request$durationMinu3;
+    var _start = toDateTime(editingAt);
+    var editingDuration = Number((_request$durationMinu3 = request.durationMinutesByProductId) === null || _request$durationMinu3 === void 0 ? void 0 : _request$durationMinu3[String(product.id)]);
+    if (!Number.isFinite(_start) || !Number.isInteger(editingDuration) || editingDuration <= 0) {
+      throw availabilityError('INVALID_TARGET_FILTER', '编辑时间必须包含完整开始日期时间和明确的正整数时长');
+    }
+    // Editing restores the original interval, including its actual overnight
+    // date. It neither adopts the current grid nor recomputes a flexible end.
+    if (request.allowOutsideOperatingHoursForRequestedStartTimes || operatingRanges.some(function (range) {
+      return range.start <= _start && _start < range.end;
+    })) {
+      addRange(_start, addMinutesZoned(_start, editingDuration, projection.meta.timezone));
+    }
+  }
+
+  // Explicit custom input keeps its existing start + requested duration
+  // semantics. Remembered input above must never use this default-30 path.
+  if (dateRange.startDate === dateRange.endDate) {
+    resolveRequestedDurationStartTimes(product, request).forEach(function (startTime) {
+      var sameDayStart = toDateTimeInDate(dateRange.startDate, startTime);
+      var period = periods.find(function (item) {
+        return item.businessDate === dateRange.startDate;
+      });
+      var periodRange = period ? normalizeAbsoluteRange(period) : null;
+      var nextDayStart = addLocalCalendarDays(sameDayStart, 1);
+      // HH:mm is entered within a selected business day, whose early hours
+      // may belong to the next calendar day. Do not move other out-of-hours
+      // manual input to tomorrow merely because the business closes overnight.
+      var start = periodRange && !(periodRange.start <= sameDayStart && sameDayStart < periodRange.end) && periodRange.start <= nextDayStart && nextDayStart < periodRange.end ? nextDayStart : sameDayStart;
+      if (request.allowOutsideOperatingHoursForRequestedStartTimes || operatingRanges.some(function (range) {
+        return range.start <= start && start < range.end;
+      })) {
+        addRange(start, start + duration * 60000);
+      }
+    });
+  }
+  return _objectSpread(_objectSpread({
+    productId: product.id,
+    title: product.title,
+    kind: product.kind,
+    slotStepMinutes: step
+  }, operatingEndAt ? {
+    operatingEndAt: operatingEndAt
+  } : {}), {}, {
+    ranges: dedupeProductRanges(ranges)
+  }, unavailableCurrentTime ? {
+    unavailableCurrentTime: unavailableCurrentTime
+  } : {});
+}
 export function getProductTimeRanges(projection) {
   var _extractFixedOffsetMi3, _request$productIds;
   var request = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
@@ -1173,6 +1430,19 @@ export function getProductTimeRanges(projection) {
       return current === null ? ranges : intersectRangeLists(current, ranges);
     }, null) || [] : null;
     var baseRanges = resourceRanges === null ? operatingRanges : intersectRangeLists(resourceRanges, operatingRanges);
+    if (runtimeOptions.useDurationTimeGrid) {
+      return getAlignedDurationRanges({
+        projection: projection,
+        product: product,
+        request: request,
+        runtimeOptions: runtimeOptions,
+        dateRange: dateRange,
+        operatingRanges: operatingRanges,
+        baseRanges: baseRanges,
+        resourceWindowIndex: resourceWindowIndex,
+        fixedOffsetMinutes: fixedOffsetMinutes
+      });
+    }
     var durationMinutes = resolveRequestedDurationMinutes(product, request);
     var flexibleStartAt = function () {
       if (!product.isFlexibleDuration) return undefined;
@@ -1454,7 +1724,9 @@ function buildEvaluationContext(params) {
     selectionsByGroupKey: selectionsByGroupKey,
     useExactDurationCandidateMinute: params.useExactDurationCandidateMinute === true,
     durationCandidateAnchorAtMs: Number.isFinite(durationCandidateAnchorAt) ? floorToMinute(durationCandidateAnchorAt) : null,
-    allowExcludedScheduleDateOverride: params.allowExcludedScheduleDateOverride === true
+    allowExcludedScheduleDateOverride: params.allowExcludedScheduleDateOverride === true,
+    useDurationTimeGrid: params.useDurationTimeGrid === true,
+    enforceSaleCutoff: params.enforceSaleCutoff === true
   };
 }
 function summarizeStatuses(statuses) {
@@ -1504,7 +1776,7 @@ function summarizeStatusAggregate(aggregate) {
   return 'unavailable';
 }
 function evaluateMatchedResourceSummary(params) {
-  var _ref6, _params$matchedCell$m;
+  var _ref8, _params$matchedCell$m;
   var isPast = params.candidateRange.endMs <= params.evaluationContext.evaluatedAtMs;
   if (!params.matchedCell) {
     return {
@@ -1516,7 +1788,7 @@ function evaluateMatchedResourceSummary(params) {
     };
   }
   var remainingCapacity = Math.max(0, params.matchedCell.remainingCapacity || 0);
-  var maxCapacity = Math.max(0, (_ref6 = (_params$matchedCell$m = params.matchedCell.maxCapacity) !== null && _params$matchedCell$m !== void 0 ? _params$matchedCell$m : params.resourceCapacity) !== null && _ref6 !== void 0 ? _ref6 : 0);
+  var maxCapacity = Math.max(0, (_ref8 = (_params$matchedCell$m = params.matchedCell.maxCapacity) !== null && _params$matchedCell$m !== void 0 ? _params$matchedCell$m : params.resourceCapacity) !== null && _ref8 !== void 0 ? _ref8 : 0);
   var maxPartySize = isPast ? 0 : remainingCapacity;
   var status = function () {
     if (isPast) return 'past';
@@ -1942,6 +2214,8 @@ export function queryAvailabilityProjection(projection, request) {
     projection: projection,
     evaluatedAt: evaluatedAt,
     resourceIds: request.resourceIds,
+    useDurationTimeGrid: runtimeOptions.useDurationTimeGrid,
+    enforceSaleCutoff: runtimeOptions.enforceSaleCutoff,
     useExactDurationCandidateMinute: runtimeOptions.useExactDurationCandidateMinute,
     allowExcludedScheduleDateOverride: runtimeOptions.allowExcludedScheduleDateOverride
   });
@@ -2032,6 +2306,8 @@ export function queryAvailabilityProjection(projection, request) {
     partySize: normalizedPartySize
   }, {
     evaluatedAt: evaluatedAt,
+    useDurationTimeGrid: runtimeOptions.useDurationTimeGrid,
+    enforceSaleCutoff: runtimeOptions.enforceSaleCutoff,
     useExactDurationCandidateMinute: runtimeOptions.useExactDurationCandidateMinute,
     allowExcludedScheduleDateOverride: runtimeOptions.allowExcludedScheduleDateOverride
   });
@@ -2060,7 +2336,8 @@ export function queryAvailabilityProjection(projection, request) {
           candidateRangeCache: candidateRangeCache,
           evaluationContext: evaluationContext
         });
-        var aggregate = byDate.get(candidate.date) || {
+        var candidateDate = runtimeOptions.useDurationTimeGrid ? candidate.businessDate || candidate.date : candidate.date;
+        var aggregate = byDate.get(candidateDate) || {
           availableCount: 0,
           totalCount: 0,
           maxPartySize: 0,
@@ -2080,8 +2357,26 @@ export function queryAvailabilityProjection(projection, request) {
         evaluated.reasonCodes.forEach(function (reasonCode) {
           return aggregate.reasonCodeSet.add(reasonCode);
         });
-        byDate.set(candidate.date, aggregate);
+        byDate.set(candidateDate, aggregate);
       });
+      if (group.unavailableCurrentTime) {
+        var current = group.unavailableCurrentTime;
+        var aggregate = byDate.get(current.businessDate) || {
+          availableCount: 0,
+          totalCount: 0,
+          maxPartySize: 0,
+          remainingCapacity: 0,
+          maxCapacity: 0,
+          reasonCodeSet: new Set(),
+          statusAggregate: createStatusAggregate()
+        };
+        aggregate.totalCount += 1;
+        pushStatusAggregate(aggregate.statusAggregate, 'unavailable');
+        current.reasonCodes.forEach(function (reason) {
+          return aggregate.reasonCodeSet.add(reason);
+        });
+        byDate.set(current.businessDate, aggregate);
+      }
       var dates = enumerateDates(dateRange.startDate, dateRange.endDate).map(function (date) {
         var aggregate = byDate.get(date);
         return {
@@ -2143,10 +2438,22 @@ export function queryAvailabilityProjection(projection, request) {
       evaluated.reasonCodes.forEach(function (reasonCode) {
         return productReasonCodeSet.add(reasonCode);
       });
-      var dateAggregate = dateStatusMap.get(candidate.date) || createStatusAggregate();
+      var candidateDate = runtimeOptions.useDurationTimeGrid ? candidate.businessDate || candidate.date : candidate.date;
+      var dateAggregate = dateStatusMap.get(candidateDate) || createStatusAggregate();
       pushStatusAggregate(dateAggregate, evaluated.status);
-      dateStatusMap.set(candidate.date, dateAggregate);
+      dateStatusMap.set(candidateDate, dateAggregate);
     });
+    if (group.unavailableCurrentTime) {
+      var current = group.unavailableCurrentTime;
+      totalTimeCount += 1;
+      pushStatusAggregate(productStatusAggregate, 'unavailable');
+      current.reasonCodes.forEach(function (reason) {
+        return productReasonCodeSet.add(reason);
+      });
+      var dateAggregate = dateStatusMap.get(current.businessDate) || createStatusAggregate();
+      pushStatusAggregate(dateAggregate, 'unavailable');
+      dateStatusMap.set(current.businessDate, dateAggregate);
+    }
     var availableDateCount = Array.from(dateStatusMap.values()).filter(function (aggregate) {
       var status = summarizeStatusAggregate(aggregate);
       return status === 'available' || status === 'limited';
@@ -2233,6 +2540,8 @@ export function validateAvailabilitySelection(projection, params) {
       projection: projection,
       evaluatedAt: evaluatedAt,
       requirementSelections: params.requirementSelections,
+      useDurationTimeGrid: runtimeOptions.useDurationTimeGrid,
+      enforceSaleCutoff: runtimeOptions.enforceSaleCutoff,
       useExactDurationCandidateMinute: runtimeOptions.useExactDurationCandidateMinute,
       allowExcludedScheduleDateOverride: runtimeOptions.allowExcludedScheduleDateOverride
     })

package/dist/modules/ResourcePlanner/types.d.ts

@@ -92,6 +92,9 @@ export interface AvailabilityProduct {
     raw?: Record<string, any>;
 }
 export interface AvailabilityResourceWindow extends AvailabilityAbsoluteRange {
+    /** Original business day and opening anchor, before coverage clipping. */
+    businessDate?: string;
+    openingAnchorAt?: string;
     source?: string;
     raw?: Record<string, any>;
 }
@@ -101,10 +104,15 @@ export interface AvailabilityOperatingHoursSnapshot {
     scheduleIds: AvailabilityId[];
     missingScheduleIds: AvailabilityId[];
     windows: AvailabilityResourceWindow[];
+    /** Complete business cycles; lunch gaps remain in windows, not in this envelope. */
+    businessPeriods?: AvailabilityBusinessPeriod[];
     /** Schedule windows omitted only because their date is excluded. POS may use
      * these to surface an unavailable, manually selectable candidate. */
     excludedWindows?: AvailabilityResourceWindow[];
 }
+export interface AvailabilityBusinessPeriod extends AvailabilityAbsoluteRange {
+    businessDate: string;
+}
 export interface AvailabilityResource {
     id: AvailabilityId;
     formId?: AvailabilityId;
@@ -212,6 +220,17 @@ export interface ProductTimeRange extends AvailabilityDisplayRange {
     bookingEndAt: string;
     scheduleRefs: AvailabilityScheduleRef[];
     primaryScheduleRef?: AvailabilityScheduleRef;
+    /** Business-day label. date/startAt keep the actual calendar date. */
+    businessDate?: string;
+}
+export interface UnavailableCurrentTime {
+    productId: AvailabilityId;
+    startAt: string;
+    date: string;
+    businessDate: string;
+    startTime: string;
+    status: 'unavailable';
+    reasonCodes: string[];
 }
 export interface ProductTimeRangeGroup {
     productId: AvailabilityId;
@@ -221,6 +240,8 @@ export interface ProductTimeRangeGroup {
     /** 单日查询对应营业窗口的最终结束时刻，不受资源排班是否为空影响。 */
     operatingEndAt?: string;
     ranges: ProductTimeRange[];
+    /** A display-only current item when flexible duration has no valid end. Never submit it. */
+    unavailableCurrentTime?: UnavailableCurrentTime;
 }
 export interface AvailabilityAssignment extends AvailabilityAbsoluteRange {
     productId: AvailabilityId;
@@ -242,6 +263,10 @@ export interface GetProductTimeRangesRequest {
     partySize?: number;
     durationMinutesByProductId?: Record<string, number>;
     durationStartTimesByProductId?: Record<string, string[]>;
+    /** Restore only the exact remembered start; recompute the end from current product/windows. */
+    rememberedStartAtByProductId?: Record<string, string>;
+    /** Edit only: preserve the full actual start plus an explicit durationMinutesByProductId. */
+    editingStartAtByProductId?: Record<string, string>;
     /**
      * POS 手工输入时间的兼容开关：只为明确请求的 start time 补候选，
      * 不改变常规候选列表仍按营业时间生成的规则。
@@ -250,6 +275,10 @@ export interface GetProductTimeRangesRequest {
 }
 export interface GetProductTimeRangesRuntimeOptions {
     evaluatedAt?: string;
+    /** Enabled by the POS/Kiosk facade only; other consumers retain their existing grid. */
+    useDurationTimeGrid?: boolean;
+    /** Automatic remembered selection must not use POS opening-minute cutoff exceptions. */
+    enforceSaleCutoff?: boolean;
     /**
      * Internal POS capability: fixed-duration candidates start from the stable
      * context anchor's current minute instead of rounding up to ten minutes, and

package/dist/modules/Schedule/index.d.ts

@@ -10,6 +10,10 @@ export declare class ScheduleModule extends BaseModule implements Module, Schedu
     private openCache;
     private fatherModule;
     private hasLoadedScheduleList;
+    private scheduleListPromise;
+    private scheduleListRequestVersion;
+    private scheduleCatalogScope;
+    private otherParams;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options: ModuleOptions): Promise<void>;
     /**
@@ -19,6 +23,9 @@ export declare class ScheduleModule extends BaseModule implements Module, Schedu
      * scheduleModule.updateOtherParams({ openCache: true, cacheId: 'cache-2' });
      */
     updateOtherParams(params: Record<string, any>): void;
+    private syncScheduleCatalogScope;
+    private resetScheduleCatalog;
+    destroy(): void;
     /**
      * 加载当前店铺下所有 schedule
      *
@@ -27,6 +34,7 @@ export declare class ScheduleModule extends BaseModule implements Module, Schedu
     loadAllSchedule(options?: {
         useCache?: boolean;
     }): Promise<void>;
+    private loadScheduleCatalog;
     setScheduleList(list: ScheduleItem[]): void;
     private syncScheduleMap;
     getScheduleList(): ScheduleItem[];