@royalschedule/maps 4.0.31 → 4.1.0-beta.0

package/dist/RS/to/initial-configuration.mjs

@@ -0,0 +1,41 @@
+import { getDayIndex, getVertexId } from "../../core/util.mjs";
+import { makeChainable } from "../../common/make-chainable/index.mjs";
+import { idOf } from "./input/util/util.mjs";
+import { omitBy, uniq } from "lodash-es";
+import moment from "moment";
+
+//#region src/RS/to/initial-configuration.ts
+function getPosition(start, end) {
+	const mmtMidnight = moment.utc(start).clone().startOf("day");
+	return {
+		day: getDayIndex(start),
+		start: moment.utc(start).diff(mmtMidnight, "minutes"),
+		end: moment.utc(end).diff(mmtMidnight, "minutes")
+	};
+}
+function initialConfiguration(events, lockedTimes, options) {
+	const fromEvents = events.map((x) => {
+		if (x.parked) return;
+		if (!x.start || !x.end) return;
+		return omitBy({
+			id: idOf.event(x, options),
+			...getPosition(x.start, x.end),
+			collection: x.course ? getVertexId(x.course, options) : void 0,
+			dependencies: x.inLocations?.map((x) => x ? getVertexId(x, options) : null).filter((x) => x != null)
+		}, (x) => x == null);
+	}).filter((x) => x != null);
+	const fromLockedTimes = lockedTimes.map((x) => {
+		if (!x.type || x.type == "ANY") return;
+		if (!x.start || !x.end) return;
+		return omitBy({
+			id: idOf.lockedTime(x, options),
+			...getPosition(x.start, x.end),
+			dependencies: makeChainable(x.coalesced ?? []).chain((x) => x.filter((x) => x.toModel == "locations").map((x) => getVertexId(x.to, options)), (x) => uniq(x)).value
+		}, (x) => x == null);
+	}).filter((x) => x != null);
+	return [{ events: fromEvents.concat(fromLockedTimes) }];
+}
+
+//#endregion
+export { initialConfiguration };
+//# sourceMappingURL=initial-configuration.mjs.map

package/dist/RS/to/initial-configuration.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"initial-configuration.mjs","names":[],"sources":["../../../src/RS/to/initial-configuration.ts"],"sourcesContent":["import moment from 'moment';\nimport { omitBy, uniq } from 'lodash-es';\nimport type { ConnectedTypes } from '../make-connected';\nimport { idOf } from './input/util/util';\nimport { getDayIndex, getVertexId } from '../../core/util';\nimport type { DateType } from '../../common/types';\nimport type { Types } from '../types';\nimport { makeChainable } from '../../common/make-chainable';\n\nfunction getPosition (\n  start: DateType,\n  end:   DateType\n): Pick<Types.eventConfiguration, 'day' | 'start' | 'end'> {\n  const mmtMidnight = moment.utc(start).clone().startOf('day');\n  return {\n    day:   getDayIndex(start),\n    start: moment.utc(start).diff(mmtMidnight, 'minutes'),\n    end:   moment.utc(end  ).diff(mmtMidnight, 'minutes'),\n  };\n}\n\nexport function initialConfiguration (\n  events:      ConnectedTypes.event[],\n  lockedTimes: ConnectedTypes.lockedTime[],\n  options:     Types.parsedToOptions\n): Types.configuration[] {\n  const fromEvents = events\n    .map(x => {\n      if (x.parked) return;\n      if (!x.start || !x.end) return;\n\n      const doc: Types.eventConfiguration = {\n        id: idOf.event(x, options),\n        ...getPosition(x.start, x.end),\n\n        collection:   x.course ? getVertexId(x.course, options) : undefined,\n        dependencies: x.inLocations?.map(x => x ? getVertexId(x, options) : null).filter(x => x != null),\n      };\n      return omitBy(doc, x => x == null) as Types.eventConfiguration;\n    })\n    .filter(x => x != null);\n\n  const fromLockedTimes = lockedTimes\n    .map(x => {\n      if (!x.type || x.type == 'ANY') return;\n      if (!x.start || !x.end) return;\n\n      const doc: Types.eventConfiguration = {\n        id: idOf.lockedTime(x, options),\n        ...getPosition(x.start, x.end),\n\n        dependencies: makeChainable(x.coalesced ?? [])\n          .chain(\n            x => x\n              .filter(x => x.toModel == 'locations')\n              .map(x => getVertexId(x.to, options)),\n            x => uniq(x)\n          )\n          .value\n      };\n      return omitBy(doc, x => x == null) as Types.eventConfiguration;\n    })\n    .filter(x => x != null);\n\n  return [{\n    events: fromEvents.concat(fromLockedTimes)\n  }];\n};"],"mappings":";;;;;;;AASA,SAAS,YACP,OACA,KACyD;CACzD,MAAM,cAAc,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,MAAM;AAC5D,QAAO;EACL,KAAO,YAAY,MAAM;EACzB,OAAO,OAAO,IAAI,MAAM,CAAC,KAAK,aAAa,UAAU;EACrD,KAAO,OAAO,IAAI,IAAM,CAAC,KAAK,aAAa,UAAU;EACtD;;AAGH,SAAgB,qBACd,QACA,aACA,SACuB;CACvB,MAAM,aAAa,OAChB,KAAI,MAAK;AACR,MAAI,EAAE,OAAQ;AACd,MAAI,CAAC,EAAE,SAAS,CAAC,EAAE,IAAK;AASxB,SAAO,OAP+B;GACpC,IAAI,KAAK,MAAM,GAAG,QAAQ;GAC1B,GAAG,YAAY,EAAE,OAAO,EAAE,IAAI;GAE9B,YAAc,EAAE,SAAS,YAAY,EAAE,QAAQ,QAAQ,GAAG;GAC1D,cAAc,EAAE,aAAa,KAAI,MAAK,IAAI,YAAY,GAAG,QAAQ,GAAG,KAAK,CAAC,QAAO,MAAK,KAAK,KAAK;GACjG,GACkB,MAAK,KAAK,KAAK;GAClC,CACD,QAAO,MAAK,KAAK,KAAK;CAEzB,MAAM,kBAAkB,YACrB,KAAI,MAAK;AACR,MAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,MAAO;AAChC,MAAI,CAAC,EAAE,SAAS,CAAC,EAAE,IAAK;AAexB,SAAO,OAb+B;GACpC,IAAI,KAAK,WAAW,GAAG,QAAQ;GAC/B,GAAG,YAAY,EAAE,OAAO,EAAE,IAAI;GAE9B,cAAc,cAAc,EAAE,aAAa,EAAE,CAAC,CAC3C,OACC,MAAK,EACF,QAAO,MAAK,EAAE,WAAW,YAAY,CACrC,KAAI,MAAK,YAAY,EAAE,IAAI,QAAQ,CAAC,GACvC,MAAK,KAAK,EAAE,CACb,CACA;GACJ,GACkB,MAAK,KAAK,KAAK;GAClC,CACD,QAAO,MAAK,KAAK,KAAK;AAEzB,QAAO,CAAC,EACN,QAAQ,WAAW,OAAO,gBAAgB,EAC3C,CAAC"}

package/dist/RS/to/input/default.mjs

@@ -0,0 +1,28 @@
+import { getVertexId } from "../../../core/util.mjs";
+import { min2hrs, toTimeFloat } from "./util/util.mjs";
+import { computesDefaultIntervalId } from "./intervals.mjs";
+
+//#region src/RS/to/input/default.ts
+function parseDefault(settings, options) {
+	return {
+		intervals: computesDefaultIntervalId(settings, options),
+		period: settings.period ? getVertexId(settings.period, options) : void 0,
+		minGroupBreakDuration: settings.defaultGroupMinimumBreakLength ?? 0,
+		minDependencyBreakDuration: settings.defaultDependencyMinimumBreakLength ?? 0,
+		minEventBreakDuration: settings.defaultEventMinimumBreakLength ?? 0,
+		preferredTime: toTimeFloat(settings.potentialCenter ?? "12:00"),
+		eventDensity: settings.defaultEventDensity ?? 1,
+		maxEventDurationVariance: settings.defaultEventDurationVariance ?? 0,
+		maxNumWorkingHours: min2hrs(settings.defaultMaximumScheduleSpan?.weekly) ?? false,
+		maxNumDailyWorkingHours: min2hrs(settings.defaultMaximumScheduleSpan?.daily) ?? false,
+		dependencyRank: settings.defaultDependencyRank ?? 0,
+		groupRank: settings.defaultGroupRank ?? 0,
+		dayRank: settings.defaultDayRank ?? 0,
+		groupWeight: settings.defaultGroupWeight ?? 0,
+		eventWeight: settings.defaultEventWeight ?? 0
+	};
+}
+
+//#endregion
+export { parseDefault };
+//# sourceMappingURL=default.mjs.map

package/dist/RS/to/input/default.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.mjs","names":[],"sources":["../../../../src/RS/to/input/default.ts"],"sourcesContent":["import type { Types } from '../../types';\nimport { computesDefaultIntervalId } from './intervals';\nimport { min2hrs, toTimeFloat } from './util/util';\nimport type { ConnectedTypes } from '../../make-connected';\nimport { getVertexId } from '../../../core/util';\n\nexport function parseDefault (\n  settings:   ConnectedTypes.divisionSettings,\n  options:    Types.parsedToOptions\n): Types.Entities.DefaultValues {\n  const res: Types.Entities.DefaultValues = {\n    intervals: computesDefaultIntervalId(settings, options),\n    period:    settings.period ? getVertexId(settings.period, options) : undefined,\n\n    minGroupBreakDuration:      settings.defaultGroupMinimumBreakLength      ?? 0,\n    minDependencyBreakDuration: settings.defaultDependencyMinimumBreakLength ?? 0,\n    minEventBreakDuration:      settings.defaultEventMinimumBreakLength      ?? 0,\n\n    preferredTime: toTimeFloat(settings.potentialCenter ?? '12:00'),\n    eventDensity:  settings.defaultEventDensity ?? 1,\n\n    maxEventDurationVariance: settings.defaultEventDurationVariance ?? 0,\n\n    maxNumWorkingHours:      min2hrs(settings.defaultMaximumScheduleSpan?.weekly) ?? false,\n    maxNumDailyWorkingHours: min2hrs(settings.defaultMaximumScheduleSpan?.daily ) ?? false,\n\n    dependencyRank: settings.defaultDependencyRank ?? 0,\n    groupRank:      settings.defaultGroupRank      ?? 0,\n    dayRank:        settings.defaultDayRank        ?? 0,\n\n    groupWeight: settings.defaultGroupWeight  ?? 0,\n    eventWeight: settings.defaultEventWeight  ?? 0,\n  };\n\n  return res;\n};"],"mappings":";;;;;AAMA,SAAgB,aACd,UACA,SAC8B;AAyB9B,QAxB0C;EACxC,WAAW,0BAA0B,UAAU,QAAQ;EACvD,QAAW,SAAS,SAAS,YAAY,SAAS,QAAQ,QAAQ,GAAG;EAErE,uBAA4B,SAAS,kCAAuC;EAC5E,4BAA4B,SAAS,uCAAuC;EAC5E,uBAA4B,SAAS,kCAAuC;EAE5E,eAAe,YAAY,SAAS,mBAAmB,QAAQ;EAC/D,cAAe,SAAS,uBAAuB;EAE/C,0BAA0B,SAAS,gCAAgC;EAEnE,oBAAyB,QAAQ,SAAS,4BAA4B,OAAO,IAAI;EACjF,yBAAyB,QAAQ,SAAS,4BAA4B,MAAO,IAAI;EAEjF,gBAAgB,SAAS,yBAAyB;EAClD,WAAgB,SAAS,oBAAyB;EAClD,SAAgB,SAAS,kBAAyB;EAElD,aAAa,SAAS,sBAAuB;EAC7C,aAAa,SAAS,sBAAuB;EAC9C"}

package/dist/RS/to/input/dependencies.mjs

@@ -0,0 +1,31 @@
+import { getVertexId } from "../../../core/util.mjs";
+import { idOf } from "./util/util.mjs";
+import { parseDayIndices } from "./util/parse-days.mjs";
+import { omitBy } from "lodash-es";
+
+//#region src/RS/to/input/dependencies.ts
+function fromLocations(locations, settings, options) {
+	return locations.filter((x) => {
+		const id = getVertexId(x, options);
+		const includedLocations = options.partialScheduleOptions?.includedLocations;
+		if (includedLocations && !includedLocations.has(id)) return false;
+		return true;
+	}).map((location) => {
+		const doc = {
+			id: getVertexId(location, options),
+			minBreakDuration: location.minBreakLength,
+			days: parseDayIndices(location.days, settings),
+			intervals: [[{
+				start: 0,
+				end: 24
+			}]],
+			blockedTimes: location.lockedTimes?.map((x) => idOf.lockedTime(x, options))
+		};
+		if (options.includeEntityMeta) doc.name = location.displayName;
+		return omitBy(doc, (x) => x == null);
+	});
+}
+
+//#endregion
+export { fromLocations };
+//# sourceMappingURL=dependencies.mjs.map

package/dist/RS/to/input/dependencies.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.mjs","names":[],"sources":["../../../../src/RS/to/input/dependencies.ts"],"sourcesContent":["import { omitBy } from 'lodash-es';\nimport type { ConnectedTypes } from '../../make-connected';\nimport { getVertexId } from '../../../core/util';\nimport { parseDayIndices } from './util/parse-days';\nimport type { Types } from '../../types';\nimport { idOf } from './util/util';\n\nexport function fromLocations (\n  locations: ConnectedTypes.location[],\n  settings:  ConnectedTypes.divisionSettings,\n  options:   Types.parsedToOptions\n) {\n  return locations\n    .filter(x => {\n      const id = getVertexId(x, options);\n\n      // filter location references based on partial schedule options\n      const includedLocations = options.partialScheduleOptions?.includedLocations;\n      if (includedLocations && !includedLocations.has(id)) return false;\n      return true;\n    })\n    .map(location => {\n      const id = getVertexId(location, options);\n\n      const doc: Types.Entities.Dependency = {\n        id,\n        minBreakDuration: location.minBreakLength,\n        days:             parseDayIndices(location.days, settings),\n        intervals:        [[{ start: 0, end: 24.00 }]],  // as there is currently no way to specify intervals for locations\n        blockedTimes:     location.lockedTimes?.map(x => idOf.lockedTime(x, options)),\n      };\n\n      if (options.includeEntityMeta) {\n        doc.name = location.displayName;\n      }\n\n      return omitBy(doc, x => x == null) as Types.Entities.Dependency;\n    });\n}"],"mappings":";;;;;;AAOA,SAAgB,cACd,WACA,UACA,SACA;AACA,QAAO,UACJ,QAAO,MAAK;EACX,MAAM,KAAK,YAAY,GAAG,QAAQ;EAGlC,MAAM,oBAAoB,QAAQ,wBAAwB;AAC1D,MAAI,qBAAqB,CAAC,kBAAkB,IAAI,GAAG,CAAE,QAAO;AAC5D,SAAO;GACP,CACD,KAAI,aAAY;EAGf,MAAM,MAAiC;GACrC,IAHS,YAAY,UAAU,QAAQ;GAIvC,kBAAkB,SAAS;GAC3B,MAAkB,gBAAgB,SAAS,MAAM,SAAS;GAC1D,WAAkB,CAAC,CAAC;IAAE,OAAO;IAAG,KAAK;IAAO,CAAC,CAAC;GAC9C,cAAkB,SAAS,aAAa,KAAI,MAAK,KAAK,WAAW,GAAG,QAAQ,CAAC;GAC9E;AAED,MAAI,QAAQ,kBACV,KAAI,OAAO,SAAS;AAGtB,SAAO,OAAO,MAAK,MAAK,KAAK,KAAK;GAClC"}

package/dist/RS/to/input/events.mjs

@@ -0,0 +1,101 @@
+import { getDayIndex, getVertexId } from "../../../core/util.mjs";
+import { makeChainable } from "../../../common/make-chainable/index.mjs";
+import { idOf } from "./util/util.mjs";
+import { parseDayIndices } from "./util/parse-days.mjs";
+import { getDefaultInterval } from "./intervals.mjs";
+import { parseMinimumBreakLength } from "./util/parse-minimum-break-length.mjs";
+import { parseGroupReferences } from "./util/parse-group-references.mjs";
+import { parseLocationReferences } from "./util/parse-location-references.mjs";
+import { groupBy, omit, omitBy } from "lodash-es";
+import moment from "moment";
+
+//#region src/RS/to/input/events.ts
+function toDayAndStart(start) {
+	return {
+		start: parseFloat(moment.utc(start).format("HH.mm")),
+		day: getDayIndex(start)
+	};
+}
+function fromEvents(_events, settings, options) {
+	const defaultInterval = getDefaultInterval(settings);
+	const events = (_events ?? []).map((event) => {
+		const id = getVertexId(event, options);
+		const duration = event.preferredDuration;
+		if (!duration) throw new Error(`(RS::To::fromEvents) Event "${id}" has no duration`);
+		const maxDurationVariance = event.linkedEventsSet == null ? event.durationVariance ?? event.course?.eventDurationVariance : 0;
+		const preferredTime = (() => {
+			const centerOfAttraction = event.centerOfAttraction ?? event.course?.centerOfAttraction;
+			if (!centerOfAttraction) return;
+			return parseFloat(centerOfAttraction.replace(":", "."));
+		})();
+		const period = (() => {
+			const periodId = event.period ?? event.course?.period;
+			if (!periodId) return;
+			return getVertexId(periodId, options);
+		})();
+		const intervals = event.intervals ?? event.course?.intervals ?? defaultInterval;
+		const doc = {
+			id: idOf.event(event, options),
+			duration,
+			maxDurationVariance,
+			weight: event.weight ?? event.course?.weight,
+			density: event.density ?? event.course?.density,
+			preferredTime,
+			period,
+			days: parseDayIndices(event.days ?? event.course?.days, settings),
+			dependencies: parseLocationReferences(event.locations ?? event.course?.locations, options),
+			groups: parseGroupReferences({
+				type: "event",
+				item: event
+			}, options),
+			intervals: idOf.intervalPairReference(intervals, void 0, options),
+			blockedTimes: (event.lockedTimes ?? event.course?.lockedTimes)?.map((x) => idOf.lockedTime(x, options)),
+			minBreakDuration: parseMinimumBreakLength(event.minBreakLength ?? event.course?.minBreakLength),
+			distributionKey: event.course?.id,
+			course: event.course
+		};
+		if (event.fixedStart && event.start) Object.assign(doc, toDayAndStart(event.start));
+		if (options.includeEntityMeta) doc.name = event.displayName ?? event.course?.displayName;
+		if (options.partialScheduleOptions) {
+			const { includedEvents, omittedEventsHandling } = options.partialScheduleOptions;
+			if (includedEvents && !includedEvents.has(doc.id)) {
+				if (omittedEventsHandling == "ignore") return;
+				if (omittedEventsHandling == "freeze") {
+					if (event.parked || !event.start || !event.duration) return;
+					Object.assign(doc, toDayAndStart(event.start));
+					doc.duration = event.duration;
+					doc.maxDurationVariance = 0;
+					const numDays = settings.numDays ?? 5;
+					doc.days = Array.from({ length: numDays }, (_, i) => i);
+					doc.intervals = Array.from({ length: numDays }, () => [{
+						start: 0,
+						end: 24
+					}]);
+					doc.dependencies = (event.inLocations ?? []).filter((x) => !!x).map((x) => {
+						const id = getVertexId(x, options);
+						const includedLocations = options.partialScheduleOptions?.includedLocations;
+						if (includedLocations && !includedLocations.has(id)) return;
+						return [{ dependency: id }];
+					}).filter((x) => x != null);
+				}
+			}
+		}
+		return omitBy(doc, (x) => x == null);
+	}).filter((x) => !!x);
+	const activities = makeChainable(events).chain((x) => x.filter((x) => !!x.course)).chain((x) => Object.entries(groupBy(x, (x) => getVertexId(x.course, options))).map(([id, events]) => {
+		const doc = {
+			id,
+			events: events.map((x) => x.id)
+		};
+		if (options.includeEntityMeta) doc.name = events[0].course?.displayName;
+		return doc;
+	})).value;
+	return {
+		events: events.map((x) => omit(x, "course")),
+		activities
+	};
+}
+
+//#endregion
+export { fromEvents, toDayAndStart };
+//# sourceMappingURL=events.mjs.map

package/dist/RS/to/input/events.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.mjs","names":[],"sources":["../../../../src/RS/to/input/events.ts"],"sourcesContent":["import moment from 'moment';\nimport { groupBy, omit, omitBy } from 'lodash-es';\nimport { parseMinimumBreakLength } from './util/parse-minimum-break-length';\nimport type { Types } from '../../types';\nimport { parseGroupReferences } from './util/parse-group-references';\nimport { parseLocationReferences } from './util/parse-location-references';\nimport type { ConnectedTypes } from '../../make-connected';\nimport { getDayIndex, getVertexId } from '../../../core/util';\nimport { idOf } from './util/util';\nimport { parseDayIndices } from './util/parse-days';\nimport type { DateType } from '../../../common/types';\nimport { getDefaultInterval } from './intervals';\nimport { makeChainable } from '../../../common/make-chainable';\n\nexport function toDayAndStart (start: DateType) {\n  return {\n    start: parseFloat(moment.utc(start).format('HH.mm')),\n    day:   getDayIndex(start)\n  };\n}\n\ntype _Event = Types.Entities.Event & {\n  course?: ConnectedTypes.course;\n}\n\n// a type generic that makes certain properties of T required\ntype RequireProperties<T, K extends keyof T> = T & { [P in K]-?: T[P] };\n\ntype Out =  {\n  events:     Types.Entities.Event[];\n  activities: Types.Entities.Activity[];\n}\nexport function fromEvents (\n  _events:  ConnectedTypes.event[],\n  settings: ConnectedTypes.divisionSettings,\n  options:  Types.parsedToOptions\n): Out {\n  const defaultInterval = getDefaultInterval(settings);\n\n  const events = (_events ?? [])\n    .map(event => {\n      const id = getVertexId(event, options);\n\n      const duration = event.preferredDuration;\n      if (!duration) throw new Error(`(RS::To::fromEvents) Event \"${id}\" has no duration`);\n\n      // allow duration variance only if the event isn't linked\n      const maxDurationVariance = event.linkedEventsSet == null\n        ? (event.durationVariance ?? event.course?.eventDurationVariance)\n        : 0;\n\n      const preferredTime = (() => {\n        const centerOfAttraction = event.centerOfAttraction ?? event.course?.centerOfAttraction;\n        if (!centerOfAttraction) return;\n        return parseFloat(centerOfAttraction.replace(':', '.'));\n      })()\n\n      const period = (() => {\n        const periodId = event.period ?? event.course?.period;\n        if (!periodId) return;\n        return getVertexId(periodId, options);\n      })();\n\n      const intervals = event.intervals ?? event.course?.intervals ?? defaultInterval;\n\n      const doc: _Event = {\n        id:                  idOf.event(event, options),\n        duration:            duration,\n        maxDurationVariance: maxDurationVariance,\n        weight:              event.weight  ?? event.course?.weight,\n        density:             event.density ?? event.course?.density,\n        preferredTime:       preferredTime,\n        period:              period,\n        days:                parseDayIndices                 (event.days ?? event.course?.days, settings),\n        dependencies:        parseLocationReferences   (event.locations ?? event.course?.locations, options),\n        groups:              parseGroupReferences      ({ type: 'event', item: event }, options),\n        intervals:           idOf.intervalPairReference(intervals, undefined, options),\n        blockedTimes:        (event.lockedTimes ?? event.course?.lockedTimes)?.map(x => idOf.lockedTime(x, options)),\n        minBreakDuration:    parseMinimumBreakLength   (event.minBreakLength ?? event.course?.minBreakLength),\n        distributionKey:     event.course?.id,\n\n        // temporary data\n        course: event.course,\n      };\n\n      // if the event has a fixed day and start\n      if (event.fixedStart && event.start) {\n        Object.assign(doc, toDayAndStart(event.start));\n      }\n\n      if (options.includeEntityMeta) {\n        doc.name = event.displayName ?? event.course?.displayName;\n      }\n\n      ////\n      //// filter events based on partialScheduleOptions\n      ////\n      if (options.partialScheduleOptions) {\n        const { includedEvents, omittedEventsHandling } = options.partialScheduleOptions;\n        if (includedEvents && !includedEvents.has(doc.id)) {  // collection.id  => take into account dynamic locked times too!\n\n          if (omittedEventsHandling == 'ignore') return;\n\n          if (omittedEventsHandling == 'freeze') {\n            // must not be parked and have a start and duration to be frozen, otherwise it's ignored\n            if (event.parked || !event.start || !event.duration) return;\n\n            // fix day, start and end\n            Object.assign(doc, toDayAndStart(event.start));\n            doc.duration = event.duration;\n            doc.maxDurationVariance = 0;\n\n            // override intervals and days to not cause conflicts\n            const numDays = settings.numDays ?? 5;\n            doc.days      = Array.from({ length: numDays }, (_, i) => i);\n            doc.intervals = Array.from({ length: numDays }, () => [{ start: 0, end: 24.00 }]);\n\n            // fix locations\n            doc.dependencies = (event.inLocations ?? [])\n              .filter((x): x is NonNullable<typeof x> => !!x)\n              .map(x => {\n                const id = getVertexId(x, options);\n\n                // filter location references based on partial schedule options\n                const includedLocations = options.partialScheduleOptions?.includedLocations;\n                if (includedLocations && !includedLocations.has(id)) return;\n\n                return [{ dependency: id }] as Types.Shared.DependencyReference[];\n              })\n              .filter(x => x != null);\n          }\n\n        }\n      }\n\n      return omitBy(doc, x => x == null) as typeof doc;\n    })\n    .filter((x): x is NonNullable<typeof x> => !!x);\n\n  const activities = makeChainable(events)\n    .chain(x => x.filter((x): x is RequireProperties<typeof x, 'course'> => !!x.course))\n    .chain(x => Object.entries(groupBy(x, x => getVertexId(x.course, options)))\n      .map(([id, events]) => {\n        const doc: Types.Entities.Activity = {\n          id:     id,\n          events: events.map(x => x.id)\n        };\n\n        if (options.includeEntityMeta) {\n          doc.name = events[0].course?.displayName;\n        }\n\n        return doc;\n      })\n    ).value;\n\n  // remove temporary data from events\n  const outEvents = events.map(x => omit(x, 'course' satisfies keyof typeof x));\n\n  return {\n    events: outEvents,\n    activities\n  };\n}"],"mappings":";;;;;;;;;;;;AAcA,SAAgB,cAAe,OAAiB;AAC9C,QAAO;EACL,OAAO,WAAW,OAAO,IAAI,MAAM,CAAC,OAAO,QAAQ,CAAC;EACpD,KAAO,YAAY,MAAM;EAC1B;;AAcH,SAAgB,WACd,SACA,UACA,SACK;CACL,MAAM,kBAAkB,mBAAmB,SAAS;CAEpD,MAAM,UAAU,WAAW,EAAE,EAC1B,KAAI,UAAS;EACZ,MAAM,KAAK,YAAY,OAAO,QAAQ;EAEtC,MAAM,WAAW,MAAM;AACvB,MAAI,CAAC,SAAU,OAAM,IAAI,MAAM,+BAA+B,GAAG,mBAAmB;EAGpF,MAAM,sBAAsB,MAAM,mBAAmB,OAChD,MAAM,oBAAoB,MAAM,QAAQ,wBACzC;EAEJ,MAAM,uBAAuB;GAC3B,MAAM,qBAAqB,MAAM,sBAAsB,MAAM,QAAQ;AACrE,OAAI,CAAC,mBAAoB;AACzB,UAAO,WAAW,mBAAmB,QAAQ,KAAK,IAAI,CAAC;MACrD;EAEJ,MAAM,gBAAgB;GACpB,MAAM,WAAW,MAAM,UAAU,MAAM,QAAQ;AAC/C,OAAI,CAAC,SAAU;AACf,UAAO,YAAY,UAAU,QAAQ;MACnC;EAEJ,MAAM,YAAY,MAAM,aAAa,MAAM,QAAQ,aAAa;EAEhE,MAAM,MAAc;GAClB,IAAqB,KAAK,MAAM,OAAO,QAAQ;GAC1B;GACA;GACrB,QAAqB,MAAM,UAAW,MAAM,QAAQ;GACpD,SAAqB,MAAM,WAAW,MAAM,QAAQ;GAC/B;GACA;GACrB,MAAqB,gBAAiC,MAAM,QAAQ,MAAM,QAAQ,MAAM,SAAS;GACjG,cAAqB,wBAA2B,MAAM,aAAa,MAAM,QAAQ,WAAW,QAAQ;GACpG,QAAqB,qBAA2B;IAAE,MAAM;IAAS,MAAM;IAAO,EAAE,QAAQ;GACxF,WAAqB,KAAK,sBAAsB,WAAW,QAAW,QAAQ;GAC9E,eAAsB,MAAM,eAAe,MAAM,QAAQ,cAAc,KAAI,MAAK,KAAK,WAAW,GAAG,QAAQ,CAAC;GAC5G,kBAAqB,wBAA2B,MAAM,kBAAkB,MAAM,QAAQ,eAAe;GACrG,iBAAqB,MAAM,QAAQ;GAGnC,QAAQ,MAAM;GACf;AAGD,MAAI,MAAM,cAAc,MAAM,MAC5B,QAAO,OAAO,KAAK,cAAc,MAAM,MAAM,CAAC;AAGhD,MAAI,QAAQ,kBACV,KAAI,OAAO,MAAM,eAAe,MAAM,QAAQ;AAMhD,MAAI,QAAQ,wBAAwB;GAClC,MAAM,EAAE,gBAAgB,0BAA0B,QAAQ;AAC1D,OAAI,kBAAkB,CAAC,eAAe,IAAI,IAAI,GAAG,EAAE;AAEjD,QAAI,yBAAyB,SAAU;AAEvC,QAAI,yBAAyB,UAAU;AAErC,SAAI,MAAM,UAAU,CAAC,MAAM,SAAS,CAAC,MAAM,SAAU;AAGrD,YAAO,OAAO,KAAK,cAAc,MAAM,MAAM,CAAC;AAC9C,SAAI,WAAW,MAAM;AACrB,SAAI,sBAAsB;KAG1B,MAAM,UAAU,SAAS,WAAW;AACpC,SAAI,OAAY,MAAM,KAAK,EAAE,QAAQ,SAAS,GAAG,GAAG,MAAM,EAAE;AAC5D,SAAI,YAAY,MAAM,KAAK,EAAE,QAAQ,SAAS,QAAQ,CAAC;MAAE,OAAO;MAAG,KAAK;MAAO,CAAC,CAAC;AAGjF,SAAI,gBAAgB,MAAM,eAAe,EAAE,EACxC,QAAQ,MAAkC,CAAC,CAAC,EAAE,CAC9C,KAAI,MAAK;MACR,MAAM,KAAK,YAAY,GAAG,QAAQ;MAGlC,MAAM,oBAAoB,QAAQ,wBAAwB;AAC1D,UAAI,qBAAqB,CAAC,kBAAkB,IAAI,GAAG,CAAE;AAErD,aAAO,CAAC,EAAE,YAAY,IAAI,CAAC;OAC3B,CACD,QAAO,MAAK,KAAK,KAAK;;;;AAM/B,SAAO,OAAO,MAAK,MAAK,KAAK,KAAK;GAClC,CACD,QAAQ,MAAkC,CAAC,CAAC,EAAE;CAEjD,MAAM,aAAa,cAAc,OAAO,CACrC,OAAM,MAAK,EAAE,QAAQ,MAAkD,CAAC,CAAC,EAAE,OAAO,CAAC,CACnF,OAAM,MAAK,OAAO,QAAQ,QAAQ,IAAG,MAAK,YAAY,EAAE,QAAQ,QAAQ,CAAC,CAAC,CACxE,KAAK,CAAC,IAAI,YAAY;EACrB,MAAM,MAA+B;GAC3B;GACR,QAAQ,OAAO,KAAI,MAAK,EAAE,GAAG;GAC9B;AAED,MAAI,QAAQ,kBACV,KAAI,OAAO,OAAO,GAAG,QAAQ;AAG/B,SAAO;GACP,CACH,CAAC;AAKJ,QAAO;EACL,QAHgB,OAAO,KAAI,MAAK,KAAK,GAAG,SAAkC,CAAC;EAI3E;EACD"}

package/dist/RS/to/input/groups.mjs

@@ -0,0 +1,32 @@
+import { idOf } from "./util/util.mjs";
+import { parseDayIndices } from "./util/parse-days.mjs";
+import { parseMaxWorkingHours } from "./util/parse-max-working-hours.mjs";
+import { getDefaultInterval } from "./intervals.mjs";
+import { omitBy } from "lodash-es";
+
+//#region src/RS/to/input/groups.ts
+function fromGroups(groups, settings, options) {
+	const defaultInterval = getDefaultInterval(settings);
+	return groups.filter((group) => group.species == "class").map((group) => {
+		const intervals = group.intervals ?? defaultInterval;
+		const rootInterval = group.rootInterval ?? settings.defaultRootInterval;
+		const doc = {
+			id: idOf.group(group, options),
+			group_type: "classes",
+			weight: group.weight,
+			minimizeGaps: true,
+			minimizeDependencyAlternation: false,
+			intervals: idOf.intervalPairReference(intervals, rootInterval, options),
+			days: parseDayIndices(group.days, settings),
+			blockedTimes: group.lockedTimes?.map((x) => idOf.lockedTime(x, options)),
+			minBreakDuration: group.minBreakLength,
+			...parseMaxWorkingHours(group)
+		};
+		if (options.includeEntityMeta) doc.name = group.displayName;
+		return omitBy(doc, (x) => x == null);
+	});
+}
+
+//#endregion
+export { fromGroups };
+//# sourceMappingURL=groups.mjs.map

package/dist/RS/to/input/groups.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups.mjs","names":[],"sources":["../../../../src/RS/to/input/groups.ts"],"sourcesContent":["import { omitBy } from 'lodash-es';\nimport type { Types } from '../../types';\nimport type { ConnectedTypes } from '../../make-connected';\nimport { parseDayIndices } from './util/parse-days';\nimport { parseMaxWorkingHours } from './util/parse-max-working-hours';\nimport { idOf } from './util/util';\nimport { getDefaultInterval } from './intervals';\n\nexport function fromGroups (\n  groups:   ConnectedTypes.group[],\n  settings: ConnectedTypes.divisionSettings,\n  options:  Types.parsedToOptions\n): Types.Entities.Group[] {\n  const defaultInterval = getDefaultInterval(settings);\n\n  return groups\n    .filter(group => group.species == 'class')\n    .map(group => {\n      const intervals    = group.intervals    ?? defaultInterval;\n      const rootInterval = group.rootInterval ?? settings.defaultRootInterval;\n\n      const doc: Types.Entities.Group = {\n        id:                            idOf.group(group, options),\n        group_type:                    'classes',\n        weight:                        group.weight,\n        minimizeGaps:                  true,\n        minimizeDependencyAlternation: false,\n        intervals:                     idOf.intervalPairReference(intervals, rootInterval, options),\n        days:                          parseDayIndices(group.days, settings),\n        blockedTimes:                  group.lockedTimes?.map(x => idOf.lockedTime(x, options)),\n        minBreakDuration:              group.minBreakLength,\n        ...parseMaxWorkingHours(group),\n      };\n\n      if (options.includeEntityMeta) {\n        doc.name = group.displayName;\n      }\n\n      return omitBy(doc, x => x == null) as Types.Entities.Group;\n    });\n};\n"],"mappings":";;;;;;;AAQA,SAAgB,WACd,QACA,UACA,SACwB;CACxB,MAAM,kBAAkB,mBAAmB,SAAS;AAEpD,QAAO,OACJ,QAAO,UAAS,MAAM,WAAW,QAAQ,CACzC,KAAI,UAAS;EACZ,MAAM,YAAe,MAAM,aAAgB;EAC3C,MAAM,eAAe,MAAM,gBAAgB,SAAS;EAEpD,MAAM,MAA4B;GAChC,IAA+B,KAAK,MAAM,OAAO,QAAQ;GACzD,YAA+B;GAC/B,QAA+B,MAAM;GACrC,cAA+B;GAC/B,+BAA+B;GAC/B,WAA+B,KAAK,sBAAsB,WAAW,cAAc,QAAQ;GAC3F,MAA+B,gBAAgB,MAAM,MAAM,SAAS;GACpE,cAA+B,MAAM,aAAa,KAAI,MAAK,KAAK,WAAW,GAAG,QAAQ,CAAC;GACvF,kBAA+B,MAAM;GACrC,GAAG,qBAAqB,MAAM;GAC/B;AAED,MAAI,QAAQ,kBACV,KAAI,OAAO,MAAM;AAGnB,SAAO,OAAO,MAAK,MAAK,KAAK,KAAK;GAClC"}

package/dist/RS/to/input/individuals.mjs

@@ -0,0 +1,45 @@
+import { getVertexId } from "../../../core/util.mjs";
+import { makeChainable } from "../../../common/make-chainable/index.mjs";
+import { idOf } from "./util/util.mjs";
+import { omitBy, uniqBy } from "lodash-es";
+
+//#region src/RS/to/input/individuals.ts
+function fromPersonsToIndividuals(persons, options) {
+	return persons.map((person) => {
+		const doc = {
+			id: idOf.person(person, options),
+			group: person.group ? `groups.${getVertexId(person.group, options)}` : void 0
+		};
+		if (options.includeEntityMeta) doc.name = person.displayName;
+		return omitBy(doc, (x) => x == null);
+	});
+}
+function fromGroupToIndividualsSet(id, reference, options) {
+	const members = new Set(reference.to.members?.map((x) => getVertexId(x, options)));
+	const excluded = new Set(reference.exclude?.map((x) => getVertexId(x, options)));
+	const doc = {
+		id,
+		individuals: [...members.difference(excluded)].map((x) => idOf.person(x, options))
+	};
+	if (options.includeEntityMeta) doc.name = reference.to.displayName + (reference.exclude?.length ? ` (excl. ${reference.exclude.map((x) => x.displayName).join(", ")})` : "");
+	return doc;
+}
+function extractUniqueIndividuals(persons, courses, events, lockedTimes, options) {
+	const individuals = fromPersonsToIndividuals(persons, options);
+	const uniqueIndividualsSetsFromGroupReferences = makeChainable([
+		...courses,
+		...events,
+		...lockedTimes
+	]).chain((x) => x.map((item) => {
+		if ("groups" in item) return item.groups;
+		if ("coalesced" in item) return item.coalesced?.filter((x) => x.toModel == "groups");
+	}).flatMap((references) => (references ?? []).filter((x) => x.to.species != "class" || x.exclude?.length).map((x) => ({
+		id: idOf.groupReference(x, options),
+		value: x
+	}))), (x) => uniqBy(x, (x) => x.id).map((x) => fromGroupToIndividualsSet(x.id, x.value, options))).value;
+	return individuals.concat(uniqueIndividualsSetsFromGroupReferences);
+}
+
+//#endregion
+export { extractUniqueIndividuals };
+//# sourceMappingURL=individuals.mjs.map

package/dist/RS/to/input/individuals.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"individuals.mjs","names":[],"sources":["../../../../src/RS/to/input/individuals.ts"],"sourcesContent":["import { omitBy, uniqBy } from 'lodash-es';\nimport type { Types } from '../../types';\nimport type { ConnectedTypes } from '../../make-connected';\nimport { getVertexId } from '../../../core/util';\nimport { idOf } from './util/util';\nimport { makeChainable } from '../../../common/make-chainable';\nimport type { GroupWithExclude } from '../../../core/interfaces/vertices/util/edges';\n\n\nfunction fromPersonsToIndividuals (\n  persons:  ConnectedTypes.person[],\n  options:  Types.parsedToOptions\n): Types.Entities.Individual[] {\n  return persons.map(person => {\n    const doc: Types.Entities.Individual = {\n      id:    idOf.person(person, options),\n      group: person.group ? `groups.${ getVertexId(person.group, options) }` : undefined,\n    };\n\n    if (options.includeEntityMeta) {\n      doc.name = person.displayName;\n    }\n\n    return omitBy(doc, x => x == null) as Types.Entities.Individual;\n  });\n}\n\nfunction fromGroupToIndividualsSet (\n  id:        string,\n  reference: GroupWithExclude.Util.Value<ConnectedTypes.group, ConnectedTypes.person>,\n  options:   Types.parsedToOptions\n): Types.Entities.IndividualsSet {\n  const members   = new Set(reference.to.members?.map(x => getVertexId(x, options)));\n  const excluded  = new Set(reference.exclude?.map(x => getVertexId(x, options)));\n  const remaining = members.difference(excluded);\n\n  const doc: Types.Entities.IndividualsSet = {\n    id:          id,\n    individuals: [...remaining].map(x => idOf.person(x, options)),\n  };\n\n  if (options.includeEntityMeta) {\n    doc.name = reference.to.displayName + (reference.exclude?.length ? ` (excl. ${ reference.exclude.map(x => x.displayName).join(', ') })` : '');\n  }\n\n  return doc;\n}\n\nexport function extractUniqueIndividuals (\n  persons:     ConnectedTypes.person[],\n  courses:     ConnectedTypes.course[],\n  events:      ConnectedTypes.event[],\n  lockedTimes: ConnectedTypes.lockedTime[],\n  options:     Types.parsedToOptions\n): (Types.Entities.Individual | Types.Entities.IndividualsSet)[] {\n  const individuals = fromPersonsToIndividuals(persons, options);\n\n  const uniqueIndividualsSetsFromGroupReferences = makeChainable([...courses, ...events, ...lockedTimes])\n    .chain(\n      x => x\n        .map((item): GroupWithExclude.Util.Value<ConnectedTypes.group, ConnectedTypes.person>[] | undefined => {\n          if ('groups'    in item) return item.groups;   // we may ignore the parent groups as they are all plain group references\n          if ('coalesced' in item) return item.coalesced\n            ?.filter(x => x.toModel == 'groups');\n          return;\n        })\n        .flatMap(references => (references ?? [])\n          .filter(x => x.to.species != 'class' || x.exclude?.length)   // if plain group reference we will use the group directly\n          .map(x => ({ id: idOf.groupReference(x, options), value: x }))\n        ),\n      x => uniqBy(x, x => x.id)\n        .map(x => fromGroupToIndividualsSet(x.id, x.value, options))\n    )\n    .value;\n\n  return individuals.concat(uniqueIndividualsSetsFromGroupReferences);\n};\n"],"mappings":";;;;;;AASA,SAAS,yBACP,SACA,SAC6B;AAC7B,QAAO,QAAQ,KAAI,WAAU;EAC3B,MAAM,MAAiC;GACrC,IAAO,KAAK,OAAO,QAAQ,QAAQ;GACnC,OAAO,OAAO,QAAQ,UAAW,YAAY,OAAO,OAAO,QAAQ,KAAM;GAC1E;AAED,MAAI,QAAQ,kBACV,KAAI,OAAO,OAAO;AAGpB,SAAO,OAAO,MAAK,MAAK,KAAK,KAAK;GAClC;;AAGJ,SAAS,0BACP,IACA,WACA,SAC+B;CAC/B,MAAM,UAAY,IAAI,IAAI,UAAU,GAAG,SAAS,KAAI,MAAK,YAAY,GAAG,QAAQ,CAAC,CAAC;CAClF,MAAM,WAAY,IAAI,IAAI,UAAU,SAAS,KAAI,MAAK,YAAY,GAAG,QAAQ,CAAC,CAAC;CAG/E,MAAM,MAAqC;EAC5B;EACb,aAAa,CAAC,GAJE,QAAQ,WAAW,SAAS,CAIjB,CAAC,KAAI,MAAK,KAAK,OAAO,GAAG,QAAQ,CAAC;EAC9D;AAED,KAAI,QAAQ,kBACV,KAAI,OAAO,UAAU,GAAG,eAAe,UAAU,SAAS,SAAS,WAAY,UAAU,QAAQ,KAAI,MAAK,EAAE,YAAY,CAAC,KAAK,KAAK,CAAE,KAAK;AAG5I,QAAO;;AAGT,SAAgB,yBACd,SACA,SACA,QACA,aACA,SAC+D;CAC/D,MAAM,cAAc,yBAAyB,SAAS,QAAQ;CAE9D,MAAM,2CAA2C,cAAc;EAAC,GAAG;EAAS,GAAG;EAAQ,GAAG;EAAY,CAAC,CACpG,OACC,MAAK,EACF,KAAK,SAAiG;AACrG,MAAI,YAAe,KAAM,QAAO,KAAK;AACrC,MAAI,eAAe,KAAM,QAAO,KAAK,WACjC,QAAO,MAAK,EAAE,WAAW,SAAS;GAEtC,CACD,SAAQ,gBAAe,cAAc,EAAE,EACrC,QAAO,MAAK,EAAE,GAAG,WAAW,WAAW,EAAE,SAAS,OAAO,CACzD,KAAI,OAAM;EAAE,IAAI,KAAK,eAAe,GAAG,QAAQ;EAAE,OAAO;EAAG,EAAE,CAC/D,GACH,MAAK,OAAO,IAAG,MAAK,EAAE,GAAG,CACtB,KAAI,MAAK,0BAA0B,EAAE,IAAI,EAAE,OAAO,QAAQ,CAAC,CAC/D,CACA;AAEH,QAAO,YAAY,OAAO,yCAAyC"}

package/dist/RS/to/input/input.mjs

@@ -0,0 +1,59 @@
+import { fromLocations } from "./dependencies.mjs";
+import { extractUniqueIntervals } from "./intervals.mjs";
+import { fromTeachers } from "./teachers.mjs";
+import { fromEvents } from "./events.mjs";
+import { parseSettings } from "./settings.mjs";
+import { parseDefault } from "./default.mjs";
+import { fromLockedTimes } from "./locked-times.mjs";
+import { parsePeriods } from "./periods.mjs";
+import { fromGroups } from "./groups.mjs";
+import { extractUniqueIndividuals } from "./individuals.mjs";
+import { fromLinkedEventsSets } from "./linked-events-sets.mjs";
+
+//#region src/RS/to/input/input.ts
+function parseInput(data, options = {}) {
+	const _settings = data.settings;
+	const _division = data.division;
+	const _groups = data.groups ?? [];
+	const _teachers = data.teachers ?? [];
+	const _locations = data.locations ?? [];
+	const _events = data.events ?? [];
+	const _lockedTimes = data.lockedTimes ?? [];
+	const _courses = data.courses ?? [];
+	const _persons = data.persons ?? [];
+	const _periods = data.periods ?? [];
+	const _linkedEventsSets = data.linkedEventsSets ?? [];
+	[
+		_groups,
+		_teachers,
+		_courses,
+		_events,
+		_lockedTimes
+	].forEach((entities) => {
+		entities.forEach((entity) => {
+			if (entity.intervals && entity.intervals.length == 0) entity.intervals = void 0;
+			else if (entity.intervals === null) entity.intervals = void 0;
+		});
+	});
+	const _fromEvents = fromEvents(_events, _settings, options);
+	const _fromLockedTimes = fromLockedTimes(_lockedTimes, _settings, options);
+	const linkedEvents = fromLinkedEventsSets(_linkedEventsSets, _settings, new Set(_fromEvents.events.map((x) => x.id)), options);
+	return {
+		settings: parseSettings(_settings),
+		default: parseDefault(_settings, options),
+		periods: parsePeriods(_periods, _division, options),
+		intervals: extractUniqueIntervals(_settings, _groups, _teachers, _courses, _events, _lockedTimes, options),
+		dependencies: fromLocations(_locations, _settings, options),
+		groups: [...fromGroups(_groups, _settings, options), ...fromTeachers(_teachers, _settings, options)],
+		individuals: extractUniqueIndividuals(_persons, _courses, _events, _lockedTimes, options),
+		blockedTimes: _fromLockedTimes.blockedTimes,
+		events: [..._fromEvents.events, ..._fromLockedTimes.events],
+		activities: [..._fromEvents.activities, ..._fromLockedTimes.activities],
+		linkedEvents,
+		unitableEvents: []
+	};
+}
+
+//#endregion
+export { parseInput };
+//# sourceMappingURL=input.mjs.map

package/dist/RS/to/input/input.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.mjs","names":[],"sources":["../../../../src/RS/to/input/input.ts"],"sourcesContent":["import type { Types } from '../../types';\nimport type { ConnectedScheduleData } from '../../make-connected';\nimport { fromLocations } from './dependencies';\nimport { fromTeachers } from './teachers';\nimport { fromEvents } from './events';\nimport { parseSettings } from './settings';\nimport { parseDefault } from './default';\nimport { fromLockedTimes } from './locked-times';\nimport { parsePeriods } from './periods';\nimport { fromGroups } from './groups';\nimport { extractUniqueIntervals } from './intervals';\nimport { extractUniqueIndividuals } from './individuals';\nimport { fromLinkedEventsSets } from './linked-events-sets';\n\nexport function parseInput (\n  data:    ConnectedScheduleData,\n  options: Types.parsedToOptions = {}\n): Types.scheduleData {\n\n  const _settings         = data.settings;\n  const _division         = data.division;\n  const _groups           = data.groups           ?? [];\n  const _teachers         = data.teachers         ?? [];\n  const _locations        = data.locations        ?? [];\n  const _events           = data.events           ?? [];\n  const _lockedTimes      = data.lockedTimes      ?? [];\n  const _courses          = data.courses          ?? [];\n  const _persons          = data.persons          ?? [];\n  const _periods          = data.periods          ?? [];\n  const _linkedEventsSets = data.linkedEventsSets ?? [];\n\n\n  ////\n  //// replace empty/null intervals with undefined\n  ////\n  [_groups, _teachers, /* _locations, */ _courses, _events, _lockedTimes].forEach(entities => {\n    entities.forEach(entity => {\n      if      (entity.intervals && entity.intervals.length == 0) entity.intervals = undefined;\n      else if (entity.intervals === null                       ) entity.intervals = undefined;\n    });\n  });\n\n  const _fromEvents      = fromEvents     (_events,      _settings, options);\n  const _fromLockedTimes = fromLockedTimes(_lockedTimes, _settings, options);\n\n  const presentEventIds = new Set(_fromEvents.events.map(x => x.id));\n\n  const linkedEvents = fromLinkedEventsSets(_linkedEventsSets, _settings, presentEventIds, options);\n\n  const out: Types.scheduleData = {\n    settings: parseSettings(_settings),\n    default:  parseDefault (_settings, options),\n\n    periods:   parsePeriods(_periods, _division, options),\n    intervals: extractUniqueIntervals(_settings, _groups, _teachers, _courses, _events, _lockedTimes, options),\n\n    dependencies: fromLocations(_locations, _settings, options),\n\n    groups: [\n      ...fromGroups  (_groups, _settings, options),\n      ...fromTeachers(_teachers, _settings, options)\n    ],\n\n    individuals: extractUniqueIndividuals(_persons, _courses, _events, _lockedTimes, options),\n\n    blockedTimes: _fromLockedTimes.blockedTimes,\n\n    events: [\n      ..._fromEvents.events,\n      ..._fromLockedTimes.events\n    ],\n\n    activities: [\n      ..._fromEvents.activities,\n      ..._fromLockedTimes.activities\n    ],\n\n    linkedEvents: linkedEvents,\n\n    unitableEvents: [],\n  };\n  return out;\n};"],"mappings":";;;;;;;;;;;;;AAcA,SAAgB,WACd,MACA,UAAiC,EAAE,EACf;CAEpB,MAAM,YAAoB,KAAK;CAC/B,MAAM,YAAoB,KAAK;CAC/B,MAAM,UAAoB,KAAK,UAAoB,EAAE;CACrD,MAAM,YAAoB,KAAK,YAAoB,EAAE;CACrD,MAAM,aAAoB,KAAK,aAAoB,EAAE;CACrD,MAAM,UAAoB,KAAK,UAAoB,EAAE;CACrD,MAAM,eAAoB,KAAK,eAAoB,EAAE;CACrD,MAAM,WAAoB,KAAK,WAAoB,EAAE;CACrD,MAAM,WAAoB,KAAK,WAAoB,EAAE;CACrD,MAAM,WAAoB,KAAK,WAAoB,EAAE;CACrD,MAAM,oBAAoB,KAAK,oBAAoB,EAAE;AAMrD;EAAC;EAAS;EAA6B;EAAU;EAAS;EAAa,CAAC,SAAQ,aAAY;AAC1F,WAAS,SAAQ,WAAU;AACzB,OAAS,OAAO,aAAa,OAAO,UAAU,UAAU,EAAG,QAAO,YAAY;YACrE,OAAO,cAAc,KAA6B,QAAO,YAAY;IAC9E;GACF;CAEF,MAAM,cAAmB,WAAgB,SAAc,WAAW,QAAQ;CAC1E,MAAM,mBAAmB,gBAAgB,cAAc,WAAW,QAAQ;CAI1E,MAAM,eAAe,qBAAqB,mBAAmB,WAFrC,IAAI,IAAI,YAAY,OAAO,KAAI,MAAK,EAAE,GAAG,CAAC,EAEuB,QAAQ;AAkCjG,QAhCgC;EAC9B,UAAU,cAAc,UAAU;EAClC,SAAU,aAAc,WAAW,QAAQ;EAE3C,SAAW,aAAa,UAAU,WAAW,QAAQ;EACrD,WAAW,uBAAuB,WAAW,SAAS,WAAW,UAAU,SAAS,cAAc,QAAQ;EAE1G,cAAc,cAAc,YAAY,WAAW,QAAQ;EAE3D,QAAQ,CACN,GAAG,WAAa,SAAS,WAAW,QAAQ,EAC5C,GAAG,aAAa,WAAW,WAAW,QAAQ,CAC/C;EAED,aAAa,yBAAyB,UAAU,UAAU,SAAS,cAAc,QAAQ;EAEzF,cAAc,iBAAiB;EAE/B,QAAQ,CACN,GAAG,YAAY,QACf,GAAG,iBAAiB,OACrB;EAED,YAAY,CACV,GAAG,YAAY,YACf,GAAG,iBAAiB,WACrB;EAEa;EAEd,gBAAgB,EAAE;EACnB"}

package/dist/RS/to/input/intervals.mjs

@@ -0,0 +1,129 @@
+import { getDayIndex } from "../../../core/util.mjs";
+import { makeChainable } from "../../../common/make-chainable/index.mjs";
+import { idOf } from "./util/util.mjs";
+import { groupBy, uniqBy } from "lodash-es";
+import moment from "moment";
+
+//#region src/RS/to/input/intervals.ts
+/**
+* Parses a date input into a moment object.
+*
+* Accepts an ISO date string, a string in 'HH:mm' format, or a DateType.
+* - If the input is in 'HH:mm' format, it is parsed as a UTC time on the epoch date.
+* - Otherwise, the input is parsed as a full UTC date.
+*
+* @param date - The date input to parse.
+* @returns A moment object representing the parsed date and time.
+*/
+function parseIntervalDate(date) {
+	if (typeof date == "string") {
+		if (/^\d{1,2}:\d{2}$/.test(date)) return moment.utc(date, "HH:mm");
+		return moment.utc(date);
+	}
+	return moment.utc(date);
+}
+/**
+* Removes the shorthand notation (a single day to represent all days)
+*/
+function standardizeIntervals(intervals, settings) {
+	if (intervals?.length == 1) {
+		const i = intervals[0];
+		const start = parseIntervalDate(i.start);
+		const end = parseIntervalDate(i.end);
+		return Array.from({ length: settings.numDays }, () => ({
+			start: start.clone(),
+			end: end.clone()
+		}));
+	}
+	return intervals;
+}
+/**
+* Converts the intervals to float type intervals
+*/
+function toFloatIntervals(intervals) {
+	return intervals?.map((i, day) => {
+		if (!i.start || !i.end) throw new Error(`(RS::To::toFloatIntervals) Interval missing start or end for day ${day}: ${JSON.stringify(i)}`);
+		return {
+			start: parseFloat(parseIntervalDate(i.start).format("HH.mm")),
+			end: parseFloat(parseIntervalDate(i.end).format("HH.mm"))
+		};
+	});
+}
+/**
+* Converts
+*/
+function combineAndMapIntervals(_intervals, rootInterval, settings) {
+	const intervals = toFloatIntervals(standardizeIntervals(_intervals, settings));
+	if (rootInterval) {
+		if (!intervals) throw new Error("(RS::To::combineAndMapIntervals) no accompanying intervals for rootInterval");
+		return makeChainable(rootInterval.intervals).chain((x) => groupBy(x, (i) => getDayIndex(i.start)), (x) => Object.entries(x).map(([day, is]) => {
+			const limits = intervals.at(parseInt(day));
+			if (!limits) throw new Error(`(RS::To::combineAndMapIntervals) Day ${day} not found in dayStartAndEnds`);
+			return is.map((i) => ({
+				start: parseFloat(parseIntervalDate(i.start).format("HH.mm")),
+				end: parseFloat(parseIntervalDate(i.end).format("HH.mm")),
+				binary: true
+			})).filter((i) => i.start >= limits.start && i.end <= limits.end);
+		}).reduce((acc, curr, index) => {
+			acc[index] = curr;
+			return acc;
+		}, Array.from({ length: settings.numDays }, () => []))).value;
+	}
+	if (intervals) return intervals.map((i) => [i]);
+}
+/**
+* extracts the default interval given the division settings
+*/
+function getDefaultInterval(settings) {
+	const { dayStart, dayEnd } = settings;
+	if (!dayStart) throw new Error("(RS::To::getDefaultInterval) \"settings.dayStart\" is falsy");
+	if (!dayEnd) throw new Error("(RS::To::getDefaultInterval) \"settings.dayEnd\" is falsy");
+	return [{
+		start: dayStart,
+		end: dayEnd
+	}];
+}
+/**
+* Computes the default interval id given the division settings
+*/
+function computesDefaultIntervalId(settings, options) {
+	return idOf.intervalPairReference(getDefaultInterval(settings), void 0, options);
+}
+/**
+* Extracts all unique intervals and interval-root interval pairs used by the provided entities
+*/
+function extractUniqueIntervals(settings, groups, teachers, courses, events, lockedTimes, options) {
+	const defaultInterval = getDefaultInterval(settings);
+	const withRootIntervals = [...groups, ...teachers].map((item) => {
+		const intervals = item.intervals ?? defaultInterval;
+		const rootInterval = item.rootInterval ?? settings.defaultRootInterval;
+		return {
+			id: idOf.intervalPairReference(intervals, rootInterval, options),
+			data: [intervals, rootInterval]
+		};
+	});
+	const withoutRootIntervals = [
+		{ intervals: defaultInterval },
+		...courses,
+		...events,
+		...lockedTimes
+	].map((item) => {
+		const interval = item.intervals ?? ("course" in item ? item.course?.intervals : void 0) ?? defaultInterval;
+		return {
+			id: idOf.intervalPairReference(interval, void 0, options),
+			data: [interval, void 0]
+		};
+	});
+	return makeChainable(withRootIntervals).chain((x) => x.concat(withoutRootIntervals), (x) => uniqBy(x, (x) => x.id), (x) => x.map(({ id, data: [_intervals, rootInterval] }) => {
+		const value = combineAndMapIntervals(_intervals, rootInterval, settings);
+		if (!value) return;
+		return {
+			id,
+			value
+		};
+	}).filter((x) => x != null)).value;
+}
+
+//#endregion
+export { computesDefaultIntervalId, extractUniqueIntervals, getDefaultInterval };
+//# sourceMappingURL=intervals.mjs.map

package/dist/RS/to/input/intervals.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"intervals.mjs","names":[],"sources":["../../../../src/RS/to/input/intervals.ts"],"sourcesContent":["import moment from 'moment';\nimport { groupBy, uniqBy } from 'lodash-es';\nimport type { Types } from '../../types';\nimport type { ConnectedTypes } from '../../make-connected';\nimport { idOf } from './util/util';\nimport { getDayIndex } from '../../../core/util';\nimport type { DateType } from '../../../common/types';\nimport { makeChainable } from '../../../common/make-chainable';\nimport type { Interval } from '../../../core/interfaces';\n\n/**\n * Parses a date input into a moment object.\n *\n * Accepts an ISO date string, a string in 'HH:mm' format, or a DateType.\n * - If the input is in 'HH:mm' format, it is parsed as a UTC time on the epoch date.\n * - Otherwise, the input is parsed as a full UTC date.\n *\n * @param date - The date input to parse.\n * @returns A moment object representing the parsed date and time.\n */\nexport function parseIntervalDate (date: string | DateType): moment.Moment {\n  if (typeof date == 'string') {\n    // in case of HH:mm format, parse as UTC time on epoch date\n    if (/^\\d{1,2}:\\d{2}$/.test(date)) {\n      return moment.utc(date, 'HH:mm');\n    }\n\n    // otherwise parse as full date\n    return moment.utc(date);\n  }\n\n  return moment.utc(date);\n}\n\n/**\n * Removes the shorthand notation (a single day to represent all days)\n */\nfunction standardizeIntervals (\n  intervals:     Interval[] | undefined,\n  settings:      ConnectedTypes.divisionSettings\n): Interval[] | undefined {\n  if (intervals?.length == 1) {\n    const i = intervals[0];\n    const start = parseIntervalDate(i.start);\n    const end   = parseIntervalDate(i.end  );\n    return Array.from({ length: settings.numDays }, () => ({ start: start.clone(), end: end.clone() }));\n  }\n\n  return intervals;\n}\n\n/**\n * Converts the intervals to float type intervals\n */\nfunction toFloatIntervals (\n  intervals: Interval[] | undefined\n): { start: number, end: number }[] | undefined {\n  return intervals?.map((i, day: number) => {\n    if (!i.start || !i.end) throw new Error(`(RS::To::toFloatIntervals) Interval missing start or end for day ${day}: ${JSON.stringify(i)}`);\n    const start = parseFloat(parseIntervalDate(i.start).format('HH.mm'));\n    const end   = parseFloat(parseIntervalDate(i.end  ).format('HH.mm'));\n    return { start, end };\n  });\n}\n\n/**\n * Converts\n */\nfunction combineAndMapIntervals (\n  _intervals:    Interval[]           | undefined,\n  rootInterval:  ConnectedTypes.rootInterval | undefined,\n  settings:      ConnectedTypes.divisionSettings\n): Types.Shared.Interval[][] | undefined {\n  const intervals = toFloatIntervals(standardizeIntervals(_intervals, settings));\n\n  if (rootInterval) {\n    if (!intervals) throw new Error('(RS::To::combineAndMapIntervals) no accompanying intervals for rootInterval');\n    return makeChainable(rootInterval.intervals)\n      .chain(\n        x => groupBy(x, i => getDayIndex(i.start)),\n        x => Object.entries(x)\n          .map(([day, is]) => {\n            const limits = intervals.at(parseInt(day));\n            if (!limits) throw new Error(`(RS::To::combineAndMapIntervals) Day ${day} not found in dayStartAndEnds`);\n\n            // remove all block intervals that lay outside the day start and end\n            return is\n              .map(i => ({\n                start:  parseFloat(parseIntervalDate(i.start).format('HH.mm')),\n                end:    parseFloat(parseIntervalDate(i.end  ).format('HH.mm')),\n                binary: true\n              } satisfies Types.Shared.Interval))\n              .filter(i => i.start >= limits.start && i.end <= limits.end);\n          })\n          // ensure that all days are represented, even if empty\n          .reduce<Types.Shared.Interval[][]>((acc, curr, index) => {\n            acc[index] = curr;\n            return acc;\n          }, Array.from({ length: settings.numDays }, () => []))\n      )\n      .value;\n  }\n  if (intervals) {\n    return intervals.map(i => [i]);\n  }\n  return;\n};\n\n/**\n * extracts the default interval given the division settings\n */\nexport function getDefaultInterval (settings: ConnectedTypes.divisionSettings): Interval[] {\n  const { dayStart, dayEnd } = settings;\n  if (!dayStart) throw new Error('(RS::To::getDefaultInterval) \"settings.dayStart\" is falsy');\n  if (!dayEnd  ) throw new Error('(RS::To::getDefaultInterval) \"settings.dayEnd\" is falsy');\n  return [{ start: dayStart, end: dayEnd }];\n}\n\n/**\n * Computes the default interval id given the division settings\n */\nexport function computesDefaultIntervalId (\n  settings: ConnectedTypes.divisionSettings,\n  options:  Types.parsedToOptions\n): string {\n  return idOf.intervalPairReference(getDefaultInterval(settings), undefined, options);\n}\n\n/**\n * Extracts all unique intervals and interval-root interval pairs used by the provided entities\n */\nexport function extractUniqueIntervals (\n  settings:    ConnectedTypes.divisionSettings,\n  groups:      ConnectedTypes.group[],\n  teachers:    ConnectedTypes.teacher[],\n  courses:     ConnectedTypes.course[],\n  events:      ConnectedTypes.event[],\n  lockedTimes: ConnectedTypes.lockedTime[],\n  options:  Types.parsedToOptions\n): Types.Entities.Interval[] {\n  const defaultInterval = getDefaultInterval(settings);\n\n  type InheritedWithId = { id: string, data: [Interval<DateType>[] | undefined, ConnectedTypes.rootInterval | undefined] };\n\n  const withRootIntervals = [...groups, ...teachers]\n    .map((item): InheritedWithId => {\n      const intervals    = item.intervals    ?? defaultInterval;\n      const rootInterval = item.rootInterval ?? settings.defaultRootInterval;\n\n      return {\n        id:   idOf.intervalPairReference(intervals, rootInterval, options),\n        data: [intervals, rootInterval]\n      };\n    });\n\n  const withoutRootIntervals = [{ intervals: defaultInterval }, ...courses, ...events, ...lockedTimes]\n    .map((item): InheritedWithId => {\n      const interval = item.intervals ?? ('course' in item ? item.course?.intervals : undefined) ?? defaultInterval;\n\n      return {\n        id:   idOf.intervalPairReference(interval, undefined, options),\n        data: [interval, undefined]\n      };\n    });\n\n  return makeChainable(withRootIntervals)\n    .chain(\n      x => x.concat(withoutRootIntervals),\n      x => uniqBy(x, x => x.id),\n      x => x\n        .map(({ id, data: [_intervals, rootInterval] }) => {\n          // compute the corresponding root interval for each interval pair\n          const value = combineAndMapIntervals(_intervals, rootInterval, settings);\n          if (!value) return;\n          return { id, value } as Required<Types.Entities.Interval>;\n        })\n        .filter(x => x != null)\n    )\n    .value;\n};\n"],"mappings":"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"}