@lilaquadrat/studio 12.1.0 → 12.3.0

package/lib/src/helpers/shiftPlanningReports.d.ts

@@ -0,0 +1,7 @@
+import type { WithId } from 'mongodb';
+import type { Shift, ShiftResponse, ShiftReportContext } from '@lilaquadrat/interfaces';
+export declare const unavailableParticipantStates: Set<string>;
+export declare const scheduleWindowMilliseconds: number;
+export declare const boundedPlanningInstant: (timestamp: number) => string;
+/** This calculation has no persistence side effects, so reads and prospective writes use the same rules. */
+export declare function reportShift(shift: WithId<Shift>, context: ShiftReportContext, includeWorkingTime?: boolean, evidence?: Map<string, number>): ShiftResponse;

package/lib/src/helpers/shiftPlanningReports.js

@@ -0,0 +1,135 @@
+import { breakViolation, calculateWorkingTime, effectivePolicy, minuteMilliseconds, previousDate, workedDates, workedMinutesByDate } from './shiftPlanningTime.js';
+import { violationIdentity } from './shiftPlanningValidation.js';
+export const unavailableParticipantStates = new Set(['blocked', 'unchecked', 'notuseful', 'canceled']);
+// 366 configurable days + seven-day shifts + two days for timezone/DST boundary differences.
+export const scheduleWindowMilliseconds = 375 * 24 * 60 * minuteMilliseconds;
+const firstInstant = Date.parse('0000-01-01T00:00:00Z');
+const lastInstant = Date.parse('9999-12-31T23:59:59.999Z');
+export const boundedPlanningInstant = (timestamp) => new Date(Math.max(firstInstant, Math.min(lastInstant, timestamp))).toISOString();
+function participantUnavailable(shift, assignment, context) {
+    const participant = context.participants.find((entry) => entry._id.equals(assignment.participant));
+    return !participant || participant.project !== shift.project || !shift.list || !participant.list.equals(shift.list)
+        || !participant.user.equals(assignment.customer) || unavailableParticipantStates.has(participant.state)
+        || !context.customers.some((entry) => entry._id.equals(assignment.customer));
+}
+function restViolations(shift, policy, otherShifts, add) {
+    if (!policy.minimumRest.enabled)
+        return;
+    // Overlaps are separate attention items; their intervals must not become an implicit assignment prohibition.
+    const previous = otherShifts.filter((entry) => entry.end <= shift.start).sort((left, right) => right.end.localeCompare(left.end))[0];
+    if (!previous)
+        return;
+    const restingMinutes = (Date.parse(shift.start) - Date.parse(previous.end)) / minuteMilliseconds;
+    if (restingMinutes < policy.minimumRest.minutes) {
+        add('rest', { relatedShift: previous._id.toHexString() }, policy.minimumRest.minutes - restingMinutes);
+    }
+}
+function dailyHoursSeverity(shift, assignment, timeZone, policy, otherShifts) {
+    if (!policy.maximumDailyWorkMinutes.enabled)
+        return 0;
+    const totals = new Map();
+    for (const scheduled of [shift, ...otherShifts]) {
+        const assigned = scheduled.assignments.find((entry) => entry.customer.equals(assignment.customer));
+        if (!assigned)
+            continue;
+        for (const [date, minutes] of workedMinutesByDate(scheduled, assigned, timeZone)) {
+            totals.set(date, (totals.get(date) ?? 0) + minutes);
+        }
+    }
+    let severity = 0;
+    // The candidate's own dates decide which local days are charged, so a shift around midnight is attributed to the days it works.
+    for (const [date, minutes] of workedMinutesByDate(shift, assignment, timeZone)) {
+        severity = Math.max(severity, (totals.get(date) ?? 0) - policy.maximumDailyWorkMinutes.minutes);
+    }
+    return severity;
+}
+function consecutiveDaySeverity(shift, assignment, timeZone, policy, otherShifts) {
+    if (!policy.maximumConsecutiveWorkingDays.enabled)
+        return 0;
+    // Each evaluated plan chooses its local calendar; stored shift.day cannot describe another plan's overnight work.
+    const allDays = new Set();
+    for (const scheduled of [shift, ...otherShifts]) {
+        const assigned = scheduled.assignments.find((entry) => entry.customer.equals(assignment.customer));
+        workedDates(scheduled, assigned, timeZone).forEach((day) => allDays.add(day));
+    }
+    let severity = 0;
+    for (const day of workedDates(shift, assignment, timeZone)) {
+        let count = 1;
+        let cursor = previousDate(day);
+        while (allDays.has(cursor)) {
+            count += 1;
+            cursor = previousDate(cursor);
+        }
+        severity = Math.max(severity, count - policy.maximumConsecutiveWorkingDays.days);
+    }
+    return severity;
+}
+/** This calculation has no persistence side effects, so reads and prospective writes use the same rules. */
+export function reportShift(shift, context, includeWorkingTime = true, evidence) {
+    const response = { ...shift, participants: shift.assignments.map((assignment) => {
+            const customer = context.customers.find((entry) => entry._id.equals(assignment.customer));
+            const detail = context.participantDetails.find((entry) => entry._id?.equals(assignment.participant));
+            // Carry the participant's own answers and both model definitions so the shift's conditions can be scored.
+            const answers = {};
+            if (detail)
+                for (const [key, value] of Object.entries(detail))
+                    if (key.startsWith('s-'))
+                        answers[key] = value;
+            return {
+                ...answers,
+                participant: assignment.participant,
+                customer: assignment.customer,
+                name: customer ? [customer.name, customer.prename].filter(Boolean).join(', ') : '',
+                email: customer?.email ?? '',
+                ...(detail?.structures ? { structures: detail.structures } : {}),
+                ...(detail?.user ? { user: detail.user } : {}),
+            };
+        }), unavailableParticipantIds: [], violations: [], workingTime: [] };
+    const plan = context.plans.find((entry) => entry._id.equals(shift.plan));
+    const policy = plan ? effectivePolicy(context.settings, plan.settingsOverrides) : null;
+    for (const assignment of shift.assignments) {
+        const customer = assignment.customer.toHexString();
+        const add = (rule, references = {}, severity = 1) => {
+            const violation = { customer, shift: shift._id.toHexString(), rule, ...references };
+            response.violations.push(violation);
+            evidence?.set(violationIdentity(violation), severity);
+        };
+        if (participantUnavailable(shift, assignment, context))
+            response.unavailableParticipantIds.push(assignment.participant.toHexString());
+        const otherShifts = context.schedules.filter((entry) => !entry._id.equals(shift._id)
+            && entry.assignments.some((other) => other.customer.equals(assignment.customer)));
+        for (const other of otherShifts) {
+            // Severity is the shared minutes, so the evidence comparison can tell an increased overlap from a reduced one.
+            if (other.start < shift.end && other.end > shift.start) {
+                const overlapMinutes = (Math.min(Date.parse(shift.end), Date.parse(other.end)) - Math.max(Date.parse(shift.start), Date.parse(other.start))) / minuteMilliseconds;
+                add('overlap', { relatedShift: other._id.toHexString() }, Math.max(1, Math.round(overlapMinutes)));
+            }
+        }
+        if (!policy || !plan) {
+            add('settingsMissing');
+            continue;
+        }
+        if (includeWorkingTime)
+            response.workingTime.push(calculateWorkingTime(shift, assignment, plan.timeZone, policy));
+        if (breakViolation(shift, assignment, policy))
+            add('breaks');
+        if (policy.absenceEnforcement) {
+            for (const absence of context.absences) {
+                if (absence.customer.equals(assignment.customer) && absence.start < shift.end && absence.end > shift.start) {
+                    // IDs explain attention without disclosing a sickness/vacation reason to another department.
+                    add('absence', { absence: absence._id.toHexString() });
+                }
+            }
+        }
+        // The upcoming shift's plan owns the required incoming rest, regardless of which shift was edited.
+        restViolations(shift, policy, otherShifts, add);
+        const consecutiveSeverity = consecutiveDaySeverity(shift, assignment, plan.timeZone, policy, otherShifts);
+        if (consecutiveSeverity > 0)
+            add('consecutiveDays', {}, consecutiveSeverity);
+        const dailySeverity = dailyHoursSeverity(shift, assignment, plan.timeZone, policy, otherShifts);
+        if (dailySeverity > 0)
+            add('dailyHours', {}, dailySeverity);
+    }
+    return response;
+}
+//# sourceMappingURL=shiftPlanningReports.js.map

package/lib/src/helpers/shiftPlanningReports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shiftPlanningReports.js","sourceRoot":"","sources":["../../../src/helpers/shiftPlanningReports.ts"],"names":[],"mappings":"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"}

package/lib/src/helpers/shiftPlanningSchemas.d.ts

@@ -0,0 +1,143 @@
+import type { SchemaObject } from 'ajv';
+export declare const objectSchema: (properties: Record<string, SchemaObject>, required?: string[]) => SchemaObject;
+export declare const objectIdSchema: SchemaObject;
+export declare const instantSchema: SchemaObject;
+/** `enabled` is omitted by clients when false, so it must never be required; omission means false. */
+export declare const policyProperties: {
+    daytime: SchemaObject;
+    nighttime: SchemaObject;
+    maximumConsecutiveWorkingDays: SchemaObject;
+    maximumDailyWorkMinutes: SchemaObject;
+    minimumRest: SchemaObject;
+    breaks: SchemaObject;
+    absenceEnforcement: {
+        type: string;
+    };
+};
+export declare const policySchema: SchemaObject;
+export declare const structureConditionProperties: {
+    structure: SchemaObject;
+    constraint: {
+        enum: string[];
+    };
+    grade: {
+        enum: string[];
+    };
+    operator: {
+        enum: string[];
+    };
+    value: {
+        anyOf: ({
+            type: string;
+            maxLength: number;
+        } | {
+            type: string;
+            maxLength?: undefined;
+        })[];
+    };
+};
+export declare const structureConditionSchema: SchemaObject;
+export declare const areaProperties: {
+    id: SchemaObject;
+    name: SchemaObject;
+    description: SchemaObject;
+    location: SchemaObject;
+    address: SchemaObject;
+    structures: SchemaObject;
+};
+export declare const planningDateSchema: SchemaObject;
+export declare const dayAreaProperties: {
+    area: SchemaObject;
+};
+export declare const dayProperties: {
+    date: SchemaObject;
+    name: SchemaObject;
+    areas: {
+        type: string;
+        maxItems: number;
+        items: SchemaObject;
+    };
+};
+export declare const planWorkAreaProperties: {
+    area: SchemaObject;
+    categoryIds: {
+        type: string;
+        maxItems: number;
+        items: SchemaObject;
+    };
+};
+export declare const workAreaCategoriesSchema: SchemaObject;
+/** Same states the list participant views offer; `unchecked` is stored but not offered by the UI. */
+export declare const participantStates: string[];
+export declare const participantStateSchema: SchemaObject;
+export declare const workHoursSchema: SchemaObject;
+export declare const planProperties: {
+    name: SchemaObject;
+    timeZone: SchemaObject;
+    settingsOverrides: SchemaObject;
+    workAreaCategories: SchemaObject;
+    defaultParticipantState: {
+        anyOf: SchemaObject[];
+    };
+    workHours: SchemaObject;
+};
+export declare const planInputProperties: {
+    list: SchemaObject;
+    name: SchemaObject;
+    timeZone: SchemaObject;
+    settingsOverrides: SchemaObject;
+    workAreaCategories: SchemaObject;
+    defaultParticipantState: {
+        anyOf: SchemaObject[];
+    };
+    workHours: SchemaObject;
+};
+export declare const scopeProperties: {
+    company: SchemaObject;
+    project: SchemaObject;
+    list: SchemaObject;
+};
+export declare const shiftProperties: {
+    area: SchemaObject;
+    day: SchemaObject;
+    title: SchemaObject;
+    start: SchemaObject;
+    end: SchemaObject;
+};
+export declare const shiftStaffingProperties: {
+    structures: SchemaObject;
+    requiredPeople: SchemaObject;
+    matchingPeople: SchemaObject;
+};
+export declare const breakSchema: SchemaObject;
+export declare const assignmentProperties: {
+    participant: SchemaObject;
+    breaks: {
+        type: string;
+        maxItems: number;
+        items: SchemaObject;
+    };
+};
+export declare const assignmentInputSchema: {
+    type: string;
+    maxItems: number;
+    items: SchemaObject;
+};
+export declare const assignmentSchema: {
+    type: string;
+    maxItems: number;
+    items: SchemaObject;
+};
+export declare const absenceProperties: {
+    customer: SchemaObject;
+    type: {
+        enum: string[];
+    };
+    start: SchemaObject;
+    end: SchemaObject;
+};
+export declare const filterProperties: {
+    from: SchemaObject;
+    to: SchemaObject;
+    site: SchemaObject;
+};

package/lib/src/helpers/shiftPlanningSchemas.js

@@ -0,0 +1,87 @@
+export const objectSchema = (properties, required = Object.keys(properties)) => ({
+    type: 'object', properties, required, additionalProperties: false,
+});
+const text = (maxLength, minLength = 0) => ({ type: 'string', minLength, maxLength });
+const integer = (minimum, maximum) => ({ type: 'integer', minimum, maximum });
+export const objectIdSchema = { shiftPlanningObjectId: true };
+export const instantSchema = {
+    type: 'string', format: 'date-time', maxLength: 40,
+    pattern: '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?(?:Z|[+-]\\d{2}:\\d{2})$',
+};
+const clockSchema = { type: 'string', pattern: '^(?:[01]\\d|2[0-3]):[0-5]\\d$' };
+const clockPeriod = objectSchema({ start: clockSchema, end: clockSchema });
+/** `enabled` is omitted by clients when false, so it must never be required; omission means false. */
+export const policyProperties = {
+    daytime: clockPeriod,
+    nighttime: clockPeriod,
+    maximumConsecutiveWorkingDays: objectSchema({ enabled: { type: 'boolean' }, days: integer(1, 366) }, ['days']),
+    maximumDailyWorkMinutes: objectSchema({ enabled: { type: 'boolean' }, minutes: integer(1, 1440) }, ['minutes']),
+    minimumRest: objectSchema({ enabled: { type: 'boolean' }, minutes: integer(0, 10080) }, []),
+    breaks: objectSchema({
+        enabled: { type: 'boolean' }, maximumContinuousWorkMinutes: integer(1, 10080),
+        minimumQualifyingBreakMinutes: integer(1, 1440),
+        requirements: { type: 'array', maxItems: 10, items: objectSchema({
+                afterWorkMinutes: integer(1, 10080), minimumTotalBreakMinutes: integer(1, 1440),
+            }) },
+    }, ['maximumContinuousWorkMinutes', 'minimumQualifyingBreakMinutes', 'requirements']),
+    absenceEnforcement: { type: 'boolean' },
+};
+export const policySchema = objectSchema(policyProperties, Object.keys(policyProperties).filter((key) => key !== 'absenceEnforcement'));
+const addressProperties = Object.fromEntries(['street', 'streetNumber', 'zipcode', 'city', 'country_name', 'addressAddition'].map((key) => [key, text(250)]));
+addressProperties.country = { type: 'string', pattern: '^[A-Za-z]{2}$' };
+addressProperties.osm_id = { type: 'number' };
+export const structureConditionProperties = {
+    structure: text(24, 1),
+    constraint: { enum: ['required', 'forbidden'] },
+    grade: { enum: ['very-positive', 'positive', 'negative', 'very-negative'] },
+    operator: { enum: ['lt', 'lte', 'eq', 'gt', 'gte'] },
+    value: { anyOf: [{ type: 'string', maxLength: 250 }, { type: 'number' }, { type: 'boolean' }] },
+};
+export const structureConditionSchema = objectSchema(structureConditionProperties, ['structure']);
+const structuresSchema = { type: 'array', maxItems: 100, items: structureConditionSchema };
+export const areaProperties = {
+    id: text(100, 1), name: text(100, 1), description: text(2500), location: text(250), address: objectSchema(addressProperties, []),
+    structures: structuresSchema,
+};
+export const planningDateSchema = { type: 'string', format: 'date', pattern: '^\\d{4}-\\d{2}-\\d{2}$' };
+export const dayAreaProperties = { area: objectIdSchema };
+export const dayProperties = {
+    date: planningDateSchema,
+    name: text(100, 1),
+    areas: { type: 'array', maxItems: 100, items: objectSchema(dayAreaProperties, ['area']) },
+};
+export const planWorkAreaProperties = { area: objectIdSchema, categoryIds: { type: 'array', maxItems: 10, items: objectIdSchema } };
+export const workAreaCategoriesSchema = { type: 'array', maxItems: 200, items: objectSchema(planWorkAreaProperties, ['area']) };
+/** Same states the list participant views offer; `unchecked` is stored but not offered by the UI. */
+export const participantStates = ['unchecked', 'paid', 'notuseful', 'confirmed', 'enlisted', 'reserved', 'waiting', 'blocked', 'finalized', 'canceled'];
+export const participantStateSchema = { enum: participantStates };
+export const workHoursSchema = objectSchema({ start: integer(0, 23), end: integer(1, 24) });
+export const planProperties = {
+    name: text(100, 1), timeZone: text(100, 1),
+    settingsOverrides: objectSchema(policyProperties, []),
+    workAreaCategories: workAreaCategoriesSchema,
+    defaultParticipantState: { anyOf: [participantStateSchema, { type: 'null' }] },
+    workHours: workHoursSchema,
+};
+export const planInputProperties = { ...planProperties, list: objectIdSchema };
+export const scopeProperties = { company: text(200, 1), project: text(200, 1), list: objectIdSchema };
+export const shiftProperties = {
+    area: objectIdSchema,
+    day: objectIdSchema,
+    title: text(100, 1), start: instantSchema, end: instantSchema,
+};
+export const shiftStaffingProperties = {
+    structures: structuresSchema,
+    requiredPeople: integer(0, 1000),
+    matchingPeople: integer(0, 1000),
+};
+export const breakSchema = objectSchema({ start: instantSchema, end: instantSchema });
+export const assignmentProperties = {
+    participant: objectIdSchema,
+    breaks: { type: 'array', maxItems: 20, items: breakSchema },
+};
+export const assignmentInputSchema = { type: 'array', maxItems: 100, items: objectSchema(assignmentProperties, ['participant']) };
+export const assignmentSchema = { type: 'array', maxItems: 100, items: objectSchema({ ...assignmentProperties, customer: objectIdSchema }) };
+export const absenceProperties = { customer: objectIdSchema, type: { enum: ['vacation', 'sickness'] }, start: instantSchema, end: instantSchema };
+export const filterProperties = { from: instantSchema, to: instantSchema, site: integer(1, Number.MAX_SAFE_INTEGER) };
+//# sourceMappingURL=shiftPlanningSchemas.js.map

package/lib/src/helpers/shiftPlanningSchemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shiftPlanningSchemas.js","sourceRoot":"","sources":["../../../src/helpers/shiftPlanningSchemas.ts"],"names":[],"mappings":"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"}

package/lib/src/helpers/shiftPlanningTime.d.ts

@@ -0,0 +1,24 @@
+import type { Shift, ShiftAssignment, ShiftPlanningPolicy, ShiftPlanningPolicyOverrides, ShiftWorkingTime } from '@lilaquadrat/interfaces';
+export declare const minuteMilliseconds = 60000;
+export declare const maximumShiftMilliseconds: number;
+export declare function planningValidation(path: string, message: string): never;
+export declare function normalizeInstant(value: string): string;
+export declare function normalizeDate(value: string): string;
+export declare function interval(start: string, end: string): {
+    start: string;
+    end: string;
+};
+export declare function localFormatter(timeZone: string): Intl.DateTimeFormat;
+export declare function localDate(instant: string, timeZone: string): string;
+export declare function previousDate(date: string): string;
+export declare function validatePolicy(policy?: ShiftPlanningPolicyOverrides): void;
+export declare function effectivePolicy(company: ShiftPlanningPolicy | undefined, overrides: ShiftPlanningPolicyOverrides): ShiftPlanningPolicy | null;
+export declare function normalizeBreaks(shift: Pick<Shift, 'start' | 'end'>, assignment: ShiftAssignment): ShiftAssignment;
+export declare function workSegments(shift: Pick<Shift, 'start' | 'end'>, assignment: ShiftAssignment): Array<[number, number]>;
+/** Local clock boundaries classify work, while UTC elapsed minutes prevent DST from inventing or losing time. */
+export declare function calculateWorkingTime(shift: Shift, assignment: ShiftAssignment, timeZone: string, policy: ShiftPlanningPolicy): ShiftWorkingTime;
+export declare function workedDates(shift: Shift, assignment: ShiftAssignment, timeZone: string): Set<string>;
+/** Break-excluded work minutes keyed by local calendar date; UTC stepping keeps DST from inventing or losing time. */
+export declare function workedMinutesByDate(shift: Shift, assignment: ShiftAssignment, timeZone: string): Map<string, number>;
+/** Short interruptions reduce net work, but cannot satisfy break rights or reset uninterrupted working time. */
+export declare function breakViolation(shift: Shift, assignment: ShiftAssignment, policy: ShiftPlanningPolicy): boolean;

package/lib/src/helpers/shiftPlanningTime.js

@@ -0,0 +1,215 @@
+import ImmutableError from '../classes/errors/Immutable.error.js';
+export const minuteMilliseconds = 60000;
+export const maximumShiftMilliseconds = 7 * 24 * 60 * minuteMilliseconds;
+// Candidate trials revisit the same instants; bounds keep reuse independent of process lifetime.
+const formatters = new Map();
+const partsByFormatter = new WeakMap();
+const maximumFormatters = 16;
+const maximumLocalParts = 4096;
+export function planningValidation(path, message) {
+    throw new ImmutableError('VALIDATION_FAILED', [{
+            instancePath: path, schemaPath: '#/shiftPlanning', keyword: 'shiftPlanning', params: {}, message,
+        }]);
+}
+export function normalizeInstant(value) {
+    const instant = Date.parse(value);
+    if (!Number.isFinite(instant))
+        planningValidation('', 'must be a valid instant');
+    const normalized = new Date(instant).toISOString();
+    if (!/^\d{4}-/.test(normalized))
+        planningValidation('', 'must normalize to a four-digit ISO year');
+    return normalized;
+}
+export function normalizeDate(value) {
+    const instant = new Date(`${value}T00:00:00Z`);
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(value) || Number.isNaN(instant.getTime())
+        || instant.toISOString().slice(0, 10) !== value)
+        planningValidation('/date', 'must be a valid date');
+    return value;
+}
+export function interval(start, end) {
+    const result = { start: normalizeInstant(start), end: normalizeInstant(end) };
+    if (result.end <= result.start)
+        planningValidation('/end', 'must be after start');
+    return result;
+}
+export function localFormatter(timeZone) {
+    const cached = formatters.get(timeZone);
+    if (cached)
+        return cached;
+    try {
+        const formatter = new Intl.DateTimeFormat('en-GB', {
+            timeZone, year: 'numeric', month: '2-digit', day: '2-digit',
+            hour: '2-digit', minute: '2-digit', hourCycle: 'h23',
+        });
+        if (formatters.size >= maximumFormatters)
+            formatters.delete(formatters.keys().next().value);
+        formatters.set(timeZone, formatter);
+        return formatter;
+    }
+    catch {
+        return planningValidation('/timeZone', 'must be a valid IANA time zone');
+    }
+}
+function localParts(formatter, instant) {
+    let cache = partsByFormatter.get(formatter);
+    if (!cache) {
+        cache = new Map();
+        partsByFormatter.set(formatter, cache);
+    }
+    const cached = cache.get(instant);
+    if (cached)
+        return cached;
+    const parts = Object.fromEntries(formatter.formatToParts(instant).map((part) => [part.type, part.value]));
+    const result = { date: `${parts.year.padStart(4, '0')}-${parts.month}-${parts.day}`, clock: `${parts.hour}:${parts.minute}` };
+    if (cache.size >= maximumLocalParts)
+        cache.delete(cache.keys().next().value);
+    cache.set(instant, result);
+    return result;
+}
+export function localDate(instant, timeZone) {
+    return localParts(localFormatter(timeZone), Date.parse(instant)).date;
+}
+export function previousDate(date) {
+    const instant = new Date(`${date}T12:00:00Z`);
+    instant.setUTCDate(instant.getUTCDate() - 1);
+    return instant.toISOString().slice(0, 10);
+}
+export function validatePolicy(policy = {}) {
+    if (policy.daytime && policy.nighttime) {
+        if (policy.daytime.start === policy.daytime.end
+            || policy.daytime.start !== policy.nighttime.end || policy.daytime.end !== policy.nighttime.start) {
+            planningValidation('/settings', 'daytime and nighttime must partition the day');
+        }
+    }
+    if (policy.breaks) {
+        if (policy.breaks.enabled && !policy.breaks.requirements.length) {
+            planningValidation('/settings/breaks/requirements', 'enabled break rules require thresholds');
+        }
+        let previousWork = 0;
+        let previousBreak = 0;
+        for (const requirement of policy.breaks.requirements) {
+            if (requirement.afterWorkMinutes <= previousWork || requirement.minimumTotalBreakMinutes < previousBreak) {
+                planningValidation('/settings/breaks/requirements', 'thresholds must increase and required breaks must not decrease');
+            }
+            previousWork = requirement.afterWorkMinutes;
+            previousBreak = requirement.minimumTotalBreakMinutes;
+        }
+    }
+}
+export function effectivePolicy(company, overrides) {
+    // Whole groups replace defaults, including false; null signals setup/attention rather than silently disabling rules.
+    const result = { ...company, ...overrides };
+    if (!result.daytime || !result.nighttime || !result.maximumConsecutiveWorkingDays
+        || !result.maximumDailyWorkMinutes || !result.minimumRest || !result.breaks)
+        return null;
+    // Two individually valid groups may be incompatible after inheritance.
+    try {
+        validatePolicy(result);
+    }
+    catch {
+        return null;
+    }
+    // Booleans are omitted when false, so a missing flag is false.
+    return { ...result, absenceEnforcement: result.absenceEnforcement === true };
+}
+export function normalizeBreaks(shift, assignment) {
+    let previousEnd = shift.start;
+    const breaks = assignment.breaks.map((entry) => {
+        const normalized = interval(entry.start, entry.end);
+        if (normalized.start < previousEnd || normalized.end > shift.end) {
+            planningValidation('/assignments/breaks', 'breaks must be ordered, non-overlapping and inside the shift');
+        }
+        previousEnd = normalized.end;
+        return normalized;
+    });
+    return { ...assignment, breaks };
+}
+export function workSegments(shift, assignment) {
+    const segments = [];
+    let cursor = Date.parse(shift.start);
+    for (const entry of assignment.breaks) {
+        const start = Date.parse(entry.start);
+        if (start > cursor)
+            segments.push([cursor, start]);
+        cursor = Date.parse(entry.end);
+    }
+    if (cursor < Date.parse(shift.end))
+        segments.push([cursor, Date.parse(shift.end)]);
+    return segments;
+}
+/** Local clock boundaries classify work, while UTC elapsed minutes prevent DST from inventing or losing time. */
+export function calculateWorkingTime(shift, assignment, timeZone, policy) {
+    const formatter = localFormatter(timeZone);
+    const workingTime = {
+        customer: assignment.customer.toHexString(), daytimeMinutes: 0, nighttimeMinutes: 0,
+        breakMinutes: assignment.breaks.reduce((total, entry) => total + (Date.parse(entry.end) - Date.parse(entry.start)) / minuteMilliseconds, 0),
+    };
+    const daytime = policy.daytime;
+    for (const [start, end] of workSegments(shift, assignment)) {
+        let cursor = start;
+        // Real UTC minutes keep classification correct through both skipped and repeated DST hours.
+        while (cursor < end) {
+            const next = Math.min(end, (Math.floor(cursor / minuteMilliseconds) + 1) * minuteMilliseconds);
+            const local = localParts(formatter, cursor);
+            const isDaytime = daytime.start < daytime.end
+                ? local.clock >= daytime.start && local.clock < daytime.end
+                : local.clock >= daytime.start || local.clock < daytime.end;
+            workingTime[isDaytime ? 'daytimeMinutes' : 'nighttimeMinutes'] += (next - cursor) / minuteMilliseconds;
+            cursor = next;
+        }
+    }
+    return workingTime;
+}
+export function workedDates(shift, assignment, timeZone) {
+    const formatter = localFormatter(timeZone);
+    const result = new Set();
+    for (const [start, end] of workSegments(shift, assignment)) {
+        // A six-hour step cannot skip a calendar date, including across timezone transitions.
+        for (let cursor = start; cursor < end; cursor += 6 * 60 * minuteMilliseconds) {
+            result.add(localParts(formatter, cursor).date);
+        }
+        result.add(localParts(formatter, end - 1).date);
+    }
+    return result;
+}
+/** Break-excluded work minutes keyed by local calendar date; UTC stepping keeps DST from inventing or losing time. */
+export function workedMinutesByDate(shift, assignment, timeZone) {
+    const formatter = localFormatter(timeZone);
+    const result = new Map();
+    for (const [start, end] of workSegments(shift, assignment)) {
+        for (let cursor = start; cursor < end; cursor += minuteMilliseconds) {
+            const next = Math.min(end, cursor + minuteMilliseconds);
+            const date = localParts(formatter, cursor).date;
+            result.set(date, (result.get(date) ?? 0) + (next - cursor) / minuteMilliseconds);
+        }
+    }
+    return result;
+}
+/** Short interruptions reduce net work, but cannot satisfy break rights or reset uninterrupted working time. */
+export function breakViolation(shift, assignment, policy) {
+    if (!policy.breaks.enabled)
+        return false;
+    const requirements = policy.breaks;
+    let cursor = Date.parse(shift.start);
+    let continuous = 0;
+    let maximumContinuous = 0;
+    let qualifyingBreaks = 0;
+    let allBreaks = 0;
+    for (const entry of assignment.breaks) {
+        continuous += (Date.parse(entry.start) - cursor) / minuteMilliseconds;
+        maximumContinuous = Math.max(maximumContinuous, continuous);
+        const duration = (Date.parse(entry.end) - Date.parse(entry.start)) / minuteMilliseconds;
+        allBreaks += duration;
+        if (duration >= requirements.minimumQualifyingBreakMinutes) {
+            qualifyingBreaks += duration;
+            continuous = 0;
+        }
+        cursor = Date.parse(entry.end);
+    }
+    maximumContinuous = Math.max(maximumContinuous, continuous + (Date.parse(shift.end) - cursor) / minuteMilliseconds);
+    const worked = (Date.parse(shift.end) - Date.parse(shift.start)) / minuteMilliseconds - allBreaks;
+    return maximumContinuous > requirements.maximumContinuousWorkMinutes
+        || requirements.requirements.some((entry) => worked > entry.afterWorkMinutes && qualifyingBreaks < entry.minimumTotalBreakMinutes);
+}
+//# sourceMappingURL=shiftPlanningTime.js.map