@royalschedule/maps 4.1.3 → 4.1.5

package/dist/RS/to/input/util/parse-group-references.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-group-references.mjs","names":[],"sources":["../../../../../src/RS/to/input/util/parse-group-references.ts"],"sourcesContent":["import { groupBy } from 'lodash-es';\nimport type { ConnectedTypes } from '../../../make-connected';\nimport { idOf } from './util';\nimport { getVertexId } from '../../../../core/util';\nimport type { Types } from '../../../types';\nimport { makeChainable } from '../../../../common/make-chainable';\nimport type { GroupWithExclude, Wrapped } from '../../../../core/interfaces/vertices/util/edges';\n\n/**\n * Merges group references with their parent groups while ensuring that a group is present at\n * most once and that parent groups are prioritized as they carry no member exclusions.\n */\nfunction mergeWithParentGroups (\n  references: GroupWithExclude.Util.Value<ConnectedTypes.group, ConnectedTypes.person>[],\n  options:    Types.parsedToOptions\n): GroupWithExclude.Util.Value<ConnectedTypes.group, ConnectedTypes.person>[] {\n  return makeChainable(references)\n    .chain(\n      x => x.flatMap((x): ((typeof x) & { isParentGroup?: boolean })[] => ([\n        x, ...(x.to.parentGroups ?? []).map(y => ({ to: y, isParentGroup: true }))\n      ])),\n      x => groupBy(x, x => getVertexId(x.to, options)),\n      x => Object.values(x)\n        .map(xs => xs.find(x => x.isParentGroup) ?? xs.at(0))\n        .filter(x => x != null)\n    )\n    .value;\n}\n\ntype ItemAndType =\n  | { item: ConnectedTypes.event,      type: 'event'      }\n  | { item: ConnectedTypes.lockedTime, type: 'lockedTime' };\n\ntype Source = {\n  teachers?:     Wrapped.Util.Value<'to', ConnectedTypes.teacher>[];\n  groups?:       GroupWithExclude.Util.Value<ConnectedTypes.group, ConnectedTypes.person>[];\n  participants?: Wrapped.Util.Value<'to', ConnectedTypes.person>[];\n};\n\n/**\n * Returns the source of group, teacher, and participant references for a given item while taking into account event inheritance.\n */\nfunction getSources (itemAndType: ItemAndType): Source {\n  if (itemAndType.type == 'lockedTime') return {\n    teachers: itemAndType.item.coalesced?.filter(x => x.toModel == 'teachers'),\n    groups:   itemAndType.item.coalesced?.filter(x => x.toModel == 'groups'  )\n  };\n\n  const item = itemAndType.item;\n  const teachersSource = item.teachers\n    ? item\n    : ('course' in item && item.course ? item.course : item);\n  const groupsAndParticipantsSource = (item.groups || item.participants)\n    ? item\n    : ('course' in item && item.course ? item.course : item);\n  return {\n    teachers:     teachersSource.teachers                  ?? undefined,\n    groups:       groupsAndParticipantsSource.groups       ?? undefined,\n    participants: groupsAndParticipantsSource.participants ?? undefined\n  };\n}\n\n/**\n * Parses group references from a course or event while carrying out event inheritance and taking into account parent groups.\n */\nexport function parseGroupReferences (\n  itemAndType: ItemAndType,\n  options:     Types.parsedToOptions\n): Types.Shared.GroupReferenceSets {\n  const sources = getSources(itemAndType);\n\n  const teacherReferences = (sources.teachers ?? [])\n    .map((x): Types.Shared.GroupReference => ({ group: idOf.teacher(x.to, options) }));\n\n  const groupReferences = mergeWithParentGroups(sources.groups ?? [], options)\n    .map((x): Types.Shared.GroupReference | Types.Shared.IndividualsReference => {\n      if (x.to.species != 'class' || x.exclude?.length) return { individuals: idOf.groupReference(x, options) };   // use individuals set if not a plain group reference\n      return { group: idOf.group(x.to, options) };\n    });\n\n  const participantReferences = sources.participants?.length\n    ? { individuals: sources.participants.map(x => idOf.person(x.to, options)) } as Types.Shared.IndividualsReference\n    : undefined;\n\n  // combine all references\n  return new Array<Types.Shared.GroupReference | Types.Shared.IndividualsReference>()\n    .concat(\n      teacherReferences,\n      groupReferences,\n      participantReferences ? [participantReferences] : []\n    )\n    .map(x => [x]);\n}"],"mappings":";;;;;;;;;;AAYA,SAAS,sBACP,YACA,SAC4E;AAC5E,QAAO,cAAc,WAAW,CAC7B,OACC,MAAK,EAAE,SAAS,MAAqD,CACnE,GAAG,IAAI,EAAE,GAAG,gBAAgB,EAAE,EAAE,KAAI,OAAM;EAAE,IAAI;EAAG,eAAe;EAAM,EAAE,CAC3E,CAAE,GACH,MAAK,QAAQ,IAAG,MAAK,YAAY,EAAE,IAAI,QAAQ,CAAC,GAChD,MAAK,OAAO,OAAO,EAAE,CAClB,KAAI,OAAM,GAAG,MAAK,MAAK,EAAE,cAAc,IAAI,GAAG,GAAG,EAAE,CAAC,CACpD,QAAO,MAAK,KAAK,KAAK,CAC1B,CACA;;;;;AAgBL,SAAS,WAAY,aAAkC;AACrD,KAAI,YAAY,QAAQ,aAAc,QAAO;EAC3C,UAAU,YAAY,KAAK,WAAW,QAAO,MAAK,EAAE,WAAW,WAAW;EAC1E,QAAU,YAAY,KAAK,WAAW,QAAO,MAAK,EAAE,WAAW,SAAW;EAC3E;CAED,MAAM,OAAO,YAAY;CACzB,MAAM,iBAAiB,KAAK,WACxB,OACC,YAAY,QAAQ,KAAK,SAAS,KAAK,SAAS;CACrD,MAAM,8BAA+B,KAAK,UAAU,KAAK,eACrD,OACC,YAAY,QAAQ,KAAK,SAAS,KAAK,SAAS;AACrD,QAAO;EACL,UAAc,eAAe,YAA6B;EAC1D,QAAc,4BAA4B,UAAgB;EAC1D,cAAc,4BAA4B,gBAAgB;EAC3D;;;;;AAMH,SAAgB,qBACd,aACA,SACiC;CACjC,MAAM,UAAU,WAAW,YAAY;CAEvC,MAAM,qBAAqB,QAAQ,YAAY,EAAE,EAC9C,KAAK,OAAoC,EAAE,OAAO,KAAK,QAAQ,EAAE,IAAI,QAAQ,EAAE,EAAE;CAEpF,MAAM,kBAAkB,sBAAsB,QAAQ,UAAU,EAAE,EAAE,QAAQ,CACzE,KAAK,MAAuE;AAC3E,MAAI,EAAE,GAAG,WAAW,WAAW,EAAE,SAAS,OAAQ,QAAO,EAAE,aAAa,KAAK,eAAe,GAAG,QAAQ,EAAE;AACzG,SAAO,EAAE,OAAO,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE;GAC3C;CAEJ,MAAM,wBAAwB,QAAQ,cAAc,SAChD,EAAE,aAAa,QAAQ,aAAa,KAAI,MAAK,KAAK,OAAO,EAAE,IAAI,QAAQ,CAAC,EAAE,GAC1E;AAGJ,QAAO,IAAI,OAAwE,CAChF,OACC,mBACA,iBACA,wBAAwB,CAAC,sBAAsB,GAAG,EAAE,CACrD,CACA,KAAI,MAAK,CAAC,EAAE,CAAC"}

package/dist/RS/to/input/util/parse-location-references.mjs

@@ -0,0 +1,35 @@
+import { getVertexId } from "../../../../core/util.mjs";
+import { makeChainable } from "../../../../common/make-chainable/index.mjs";
+import { groupBy } from "lodash-es";
+
+//#region src/RS/to/input/util/parse-location-references.ts
+function toLocationReferences(coalesced) {
+	return coalesced?.map((x, i) => x.toModel == "locations" ? {
+		locations: [x.to],
+		groupIndex: i,
+		rank: 0
+	} : null).filter((x) => x != null);
+}
+function isCoalescedReferenceList(references) {
+	return !!references?.[0] && "toModel" in references[0];
+}
+function parseLocationReferences(references, options) {
+	const normalizedReferences = isCoalescedReferenceList(references) ? toLocationReferences(references) : references;
+	if (!normalizedReferences) return;
+	return makeChainable(normalizedReferences).chain((x) => x.map(({ locations, groupIndex, rank }) => ({
+		dependency: getVertexId(locations[0], options),
+		rank,
+		groupIndex
+	})).filter((x) => {
+		const includedLocations = options.partialScheduleOptions?.includedLocations;
+		if (!includedLocations) return true;
+		return includedLocations.has(x.dependency);
+	}), (x) => groupBy(x, (x) => x.groupIndex), (x) => Object.values(x).map((xs) => xs.map((x) => ({
+		dependency: x.dependency,
+		...x.rank != null && { rank: x.rank }
+	})))).value;
+}
+
+//#endregion
+export { parseLocationReferences };
+//# sourceMappingURL=parse-location-references.mjs.map

package/dist/RS/to/input/util/parse-location-references.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-location-references.mjs","names":[],"sources":["../../../../../src/RS/to/input/util/parse-location-references.ts"],"sourcesContent":["import { groupBy } from 'lodash-es';\nimport type { ConnectedTypes } from '../../../make-connected';\nimport type { Types } from '../../../types';\nimport { getVertexId } from '../../../../core/util';\nimport { makeChainable } from '../../../../common/make-chainable';\nimport type { AvailableLocation } from '../../../../core/interfaces/vertices/util/edges';\n\n\ntype LocationReference = AvailableLocation.Util.Value<ConnectedTypes.location, { groupIndex?: number; rank?: number; }>;\n\n// Normalize locked-time coalesced edges into the location reference shape used elsewhere.\nfunction toLocationReferences (coalesced: ConnectedTypes.lockedTime['coalesced']): LocationReference[] | undefined {\n  return coalesced\n    ?.map((x, i): LocationReference | null => x.toModel == 'locations'\n      ?  { locations: [x.to as ConnectedTypes.location], groupIndex: i, rank: 0 }\n      : null\n    )\n    .filter(x => x != null);\n}\n\nfunction isCoalescedReferenceList (\n  references: LocationReference[] | ConnectedTypes.lockedTime['coalesced'] | null | undefined\n): references is NonNullable<ConnectedTypes.lockedTime['coalesced']> {\n  return !!references?.[0] && 'toModel' in references[0];\n}\n\nexport function parseLocationReferences (\n  references: LocationReference[] | null | undefined,\n  options:    Types.parsedToOptions\n): Types.Shared.DependencyReference[][] | undefined;\nexport function parseLocationReferences (\n  references: ConnectedTypes.lockedTime['coalesced'],\n  options:    Types.parsedToOptions\n): Types.Shared.DependencyReference[][] | undefined;\n\nexport function parseLocationReferences (\n  references: LocationReference[] | ConnectedTypes.lockedTime['coalesced'] | null | undefined,\n  options:    Types.parsedToOptions\n) {\n  // Support both event-style location references and locked-time coalesced edges.\n  const normalizedReferences: LocationReference[] | null | undefined = isCoalescedReferenceList(references)\n    ? toLocationReferences(references)\n    : references;\n\n  if (!normalizedReferences) return;\n\n  return makeChainable(normalizedReferences)\n    .chain(\n      x => x\n        .map(({ locations, groupIndex, rank }) => ({\n          dependency: getVertexId(locations[0], options),\n          rank:       rank,\n          groupIndex: groupIndex\n        }))\n        .filter(x => {\n          // remove all references to excluded locations based on partial schedule options\n          const includedLocations = options.partialScheduleOptions?.includedLocations;\n          if (!includedLocations) return true;\n          return includedLocations.has(x.dependency);\n        }),\n      x => groupBy(x, x => x.groupIndex),\n      x => Object.values(x)\n        .map(xs => xs.map(x => ({\n          dependency: x.dependency,\n          ...x.rank != null && { rank: x.rank },\n        }) as Types.Shared.DependencyReference))\n    )\n    .value;\n}\n\n// export function parseSelectedLocations (event: ConnectedTypes.event, options: Types.parsedToOptions) {\n\n//   const locationsRef = event.locations ?? event.course?.locations;\n//   const dependencies = parseLocationReferences(locationsRef, options);\n//   const inLocations  = event.inLocations ?? [];\n\n//   // simply use inLocations if they match the number of dependencies\n//   if (inLocations.length === dependencies?.length) {\n//     return inLocations.map(x =>  x ? getVertexId(x, options) : null);\n//   }\n\n//   // otherwise, fill inLocations with nulls to match the number of dependencies\n//   return inLocations\n//     .map(x =>  x ? getVertexId(x, options) : null)\n//     .concat(Array\n//       .from({ length: Math.max((dependencies?.length ?? 0) - inLocations.length, 0) })\n//       .map(() => null as string | null)\n//     );\n// }"],"mappings":";;;;;AAWA,SAAS,qBAAsB,WAAoF;AACjH,QAAO,WACH,KAAK,GAAG,MAAgC,EAAE,WAAW,cAClD;EAAE,WAAW,CAAC,EAAE,GAA8B;EAAE,YAAY;EAAG,MAAM;EAAG,GACzE,KACH,CACA,QAAO,MAAK,KAAK,KAAK;;AAG3B,SAAS,yBACP,YACmE;AACnE,QAAO,CAAC,CAAC,aAAa,MAAM,aAAa,WAAW;;AAYtD,SAAgB,wBACd,YACA,SACA;CAEA,MAAM,uBAA+D,yBAAyB,WAAW,GACrG,qBAAqB,WAAW,GAChC;AAEJ,KAAI,CAAC,qBAAsB;AAE3B,QAAO,cAAc,qBAAqB,CACvC,OACC,MAAK,EACF,KAAK,EAAE,WAAW,YAAY,YAAY;EACzC,YAAY,YAAY,UAAU,IAAI,QAAQ;EAClC;EACA;EACb,EAAE,CACF,QAAO,MAAK;EAEX,MAAM,oBAAoB,QAAQ,wBAAwB;AAC1D,MAAI,CAAC,kBAAmB,QAAO;AAC/B,SAAO,kBAAkB,IAAI,EAAE,WAAW;GAC1C,GACJ,MAAK,QAAQ,IAAG,MAAK,EAAE,WAAW,GAClC,MAAK,OAAO,OAAO,EAAE,CAClB,KAAI,OAAM,GAAG,KAAI,OAAM;EACtB,YAAY,EAAE;EACd,GAAG,EAAE,QAAQ,QAAQ,EAAE,MAAM,EAAE,MAAM;EACtC,EAAsC,CAAC,CAC3C,CACA"}

package/dist/RS/to/input/util/parse-max-working-hours.mjs

@@ -0,0 +1,14 @@
+import { min2hrs } from "./util.mjs";
+
+//#region src/RS/to/input/util/parse-max-working-hours.ts
+function parseMaxWorkingHours(group) {
+	if (!group.maximumScheduleSpan) return;
+	return {
+		maxNumWorkingHours: min2hrs(group.maximumScheduleSpan.weekly) ?? false,
+		maxNumDailyWorkingHours: min2hrs(group.maximumScheduleSpan.daily) ?? false
+	};
+}
+
+//#endregion
+export { parseMaxWorkingHours };
+//# sourceMappingURL=parse-max-working-hours.mjs.map

package/dist/RS/to/input/util/parse-max-working-hours.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-max-working-hours.mjs","names":[],"sources":["../../../../../src/RS/to/input/util/parse-max-working-hours.ts"],"sourcesContent":["import type { ConnectedTypes } from '../../../make-connected';\nimport type { Types } from '../../../types';\nimport { min2hrs } from './util';\n\nexport function parseMaxWorkingHours (\n  group: ConnectedTypes.group | ConnectedTypes.teacher\n): Pick<Types.Entities.Group, 'maxNumWorkingHours' | 'maxNumDailyWorkingHours'> | undefined {\n  if (!group.maximumScheduleSpan) return;\n\n  return {\n    maxNumWorkingHours:      min2hrs(group.maximumScheduleSpan.weekly) ?? false,\n    maxNumDailyWorkingHours: min2hrs(group.maximumScheduleSpan.daily ) ?? false,\n  };\n}\n"],"mappings":";;;AAIA,SAAgB,qBACd,OAC0F;AAC1F,KAAI,CAAC,MAAM,oBAAqB;AAEhC,QAAO;EACL,oBAAyB,QAAQ,MAAM,oBAAoB,OAAO,IAAI;EACtE,yBAAyB,QAAQ,MAAM,oBAAoB,MAAO,IAAI;EACvE"}

package/dist/RS/to/input/util/parse-minimum-break-length.mjs

@@ -0,0 +1,19 @@
+//#region src/RS/to/input/util/parse-minimum-break-length.ts
+function parseMinimumBreakLength(value) {
+	if (value == null) return;
+	if (typeof value === "boolean") return value;
+	if (typeof value === "number") return value;
+	if (Array.isArray(value)) {
+		if (value.length !== 2) throw new Error("(RS::To::parseMinimumBreakLength) BreakLength array must have exactly two elements");
+		const [bef, aft] = value;
+		return {
+			bef,
+			aft
+		};
+	}
+	throw new Error("(RS::To::parseMinimumBreakLength) BreakLength is neither boolean, number or number array");
+}
+
+//#endregion
+export { parseMinimumBreakLength };
+//# sourceMappingURL=parse-minimum-break-length.mjs.map

package/dist/RS/to/input/util/parse-minimum-break-length.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-minimum-break-length.mjs","names":[],"sources":["../../../../../src/RS/to/input/util/parse-minimum-break-length.ts"],"sourcesContent":["import type { CoreTypes } from '../../../../core';\nimport type { Types } from '../../../types';\n\nexport function parseMinimumBreakLength (value: CoreTypes.breakLength | null | undefined): Types.Shared.EventBreakDuration | undefined {\n  if (value == null) return;\n\n  if (typeof value === 'boolean') return value;\n  if (typeof value === 'number') return value;\n\n  if (Array.isArray(value)) {\n    if (value.length !== 2) throw new Error('(RS::To::parseMinimumBreakLength) BreakLength array must have exactly two elements');\n    const [bef, aft] = value;\n    return { bef, aft };\n  }\n\n  throw new Error('(RS::To::parseMinimumBreakLength) BreakLength is neither boolean, number or number array');\n};\n"],"mappings":";AAGA,SAAgB,wBAAyB,OAA8F;AACrI,KAAI,SAAS,KAAM;AAEnB,KAAI,OAAO,UAAU,UAAW,QAAO;AACvC,KAAI,OAAO,UAAU,SAAU,QAAO;AAEtC,KAAI,MAAM,QAAQ,MAAM,EAAE;AACxB,MAAI,MAAM,WAAW,EAAG,OAAM,IAAI,MAAM,qFAAqF;EAC7H,MAAM,CAAC,KAAK,OAAO;AACnB,SAAO;GAAE;GAAK;GAAK;;AAGrB,OAAM,IAAI,MAAM,2FAA2F"}

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

@@ -0,0 +1,100 @@
+import { getVertexId } from "../../../../core/util.mjs";
+
+//#region src/RS/to/input/util/util.ts
+function min2hrs(min) {
+	if (min == null) return;
+	return min / 60;
+}
+/**
+* Converts a time string in the format "HH:MM" to a float representation, e.g., "12:30" becomes 12.3.
+*/
+function toTimeFloat(str) {
+	return parseFloat(str.replace(":", "."));
+}
+const COLLECTION_ID = {
+	persons: "persons",
+	groups: "groups",
+	teachers: "teachers",
+	events: "events",
+	lockedTimes: "lockedtimes"
+};
+const COLLECTION_BY_ID = Object.fromEntries(Object.entries(COLLECTION_ID).map(([collection, id]) => [id, collection]));
+function parseAggregateId(aggregateId, expectedCollection) {
+	const indexOfDot = aggregateId.indexOf(".");
+	if (indexOfDot == -1) throw new Error(`(RS::To::fromId) Missing collection separator in aggregate id "${aggregateId}"`);
+	const collectionId = aggregateId.substring(0, indexOfDot).toLowerCase();
+	const entityId = aggregateId.substring(indexOfDot + 1);
+	if (!entityId) throw new Error(`(RS::To::fromId) Missing entity id in aggregate id "${aggregateId}"`);
+	const collection = COLLECTION_BY_ID[collectionId];
+	if (!collection) throw new Error(`(RS::To::fromId) Unknown collection id "${collectionId}" in aggregate id "${aggregateId}"`);
+	if (expectedCollection && collection != expectedCollection) throw new Error(`(RS::To::fromId) Expected collection "${expectedCollection}" but got "${collection}" in aggregate id "${aggregateId}"`);
+	return {
+		collection,
+		entityId
+	};
+}
+let idOf;
+(function(_idOf) {
+	function person(person, options) {
+		return `${COLLECTION_ID.persons}.${getVertexId(person, options)}`;
+	}
+	_idOf.person = person;
+	function group(group, options) {
+		return `${COLLECTION_ID.groups}.${getVertexId(group, options)}`;
+	}
+	_idOf.group = group;
+	function teacher(teacher, options) {
+		return `${COLLECTION_ID.teachers}.${getVertexId(teacher, options)}`;
+	}
+	_idOf.teacher = teacher;
+	function event(event, options) {
+		return `${COLLECTION_ID.events}.${getVertexId(event, options)}`;
+	}
+	_idOf.event = event;
+	function lockedTime(lockedTime, options) {
+		return `${COLLECTION_ID.lockedTimes}.${getVertexId(lockedTime, options)}`;
+	}
+	_idOf.lockedTime = lockedTime;
+	function groupReference(group, options) {
+		return `${COLLECTION_ID.groups}.${getVertexId(group.to, options)}` + (group.exclude?.length ? ".exclude." + group.exclude.map((x) => getVertexId(x, options)).sort().join(".") : "");
+	}
+	_idOf.groupReference = groupReference;
+	function intervalPairReference(interval, rootInterval, options) {
+		if (interval === null) interval = void 0;
+		if (rootInterval === null) rootInterval = void 0;
+		if (interval && interval.length == 0) interval = void 0;
+		return (rootInterval ? getVertexId(rootInterval, options) + "&" : "") + JSON.stringify(interval);
+	}
+	_idOf.intervalPairReference = intervalPairReference;
+})(idOf || (idOf = {}));
+let fromId;
+(function(_fromId) {
+	function aggregate(aggregateId) {
+		return parseAggregateId(aggregateId);
+	}
+	_fromId.aggregate = aggregate;
+	function person(aggregateId) {
+		return parseAggregateId(aggregateId, "persons").entityId;
+	}
+	_fromId.person = person;
+	function group(aggregateId) {
+		return parseAggregateId(aggregateId, "groups").entityId;
+	}
+	_fromId.group = group;
+	function teacher(aggregateId) {
+		return parseAggregateId(aggregateId, "teachers").entityId;
+	}
+	_fromId.teacher = teacher;
+	function event(aggregateId) {
+		return parseAggregateId(aggregateId, "events").entityId;
+	}
+	_fromId.event = event;
+	function lockedTime(aggregateId) {
+		return parseAggregateId(aggregateId, "lockedTimes").entityId;
+	}
+	_fromId.lockedTime = lockedTime;
+})(fromId || (fromId = {}));
+
+//#endregion
+export { COLLECTION_ID, fromId, idOf, min2hrs, toTimeFloat };
+//# sourceMappingURL=util.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"util.mjs","names":[],"sources":["../../../../../src/RS/to/input/util/util.ts"],"sourcesContent":["import type { ConnectedTypes } from '../../../make-connected';\nimport type { Types } from '../../../types';\nimport type { Collection } from '../../../../core/types/common';\nimport { getVertexId } from '../../../../core/util';\nimport type { GroupWithExclude } from '../../../../core/interfaces/vertices/util/edges';\nimport type { Interval } from '../../../../core/interfaces';\n\nexport function min2hrs (min: number | undefined | null) {\n  if (min == null) return;\n  return min / 60;\n}\n\n/**\n * Converts a time string in the format \"HH:MM\" to a float representation, e.g., \"12:30\" becomes 12.3.\n */\nexport function toTimeFloat (str: string) {\n  return parseFloat(str.replace(':', '.'));\n}\n\nexport function getPeriodIndex (\n  period:     ConnectedTypes.period | string | undefined | null,\n  periodsMap: Map<string | undefined, number>,\n  options:    Types.parsedToOptions\n): number | undefined {\n  // if no periods exist, return undefined\n  if (periodsMap.size == 0) return;\n\n  // if no period is given, return undefined\n  if (!period) return;\n\n  const id = getVertexId(period, options);\n  const periodIndex = periodsMap.get(id);\n  if (periodIndex === undefined) {\n    throw new Error(`(RS::To::getPeriodIndex) Period \"${id}\" is not in periodsMap`);\n  }\n  return periodIndex;\n}\n\nexport const COLLECTION_ID = {\n  persons:     'persons'     as const,\n  groups:      'groups'      as const,\n  teachers:    'teachers'    as const,\n  events:      'events'      as const,\n  lockedTimes: 'lockedtimes' as const,\n} satisfies Partial<Record<Collection, string>>;\n\n/**\n * a type generic that inverses a record type, i.e., { a: 'x', b: 'y' } becomes { x: 'a', y: 'b' }\n */\ntype InverseRecord<T extends Record<string, string>> = {\n  [K in keyof T as T[K]]: K\n};\n\nconst COLLECTION_BY_ID = Object.fromEntries(Object.entries(COLLECTION_ID).map(([collection, id]) => [id, collection])) as InverseRecord<typeof COLLECTION_ID>;\n\n\nexport type AggregateCollection = keyof typeof COLLECTION_ID;\n\ntype AggregateIdParts<TCollection extends AggregateCollection = AggregateCollection> = {\n  collection: TCollection\n  entityId:   string\n};\n\n\nfunction parseAggregateId<TCollection extends AggregateCollection = AggregateCollection> (\n  aggregateId: string,\n  expectedCollection?: TCollection\n): AggregateIdParts<TCollection> {\n  const indexOfDot = aggregateId.indexOf('.');\n  if (indexOfDot == -1) {\n    throw new Error(`(RS::To::fromId) Missing collection separator in aggregate id \"${aggregateId}\"`);\n  }\n\n  const collectionId = aggregateId.substring(0, indexOfDot).toLowerCase() as keyof typeof COLLECTION_BY_ID;\n  const entityId = aggregateId.substring(indexOfDot + 1);\n\n  if (!entityId) {\n    throw new Error(`(RS::To::fromId) Missing entity id in aggregate id \"${aggregateId}\"`);\n  }\n\n  const collection = COLLECTION_BY_ID[collectionId];\n  if (!collection) {\n    throw new Error(`(RS::To::fromId) Unknown collection id \"${collectionId}\" in aggregate id \"${aggregateId}\"`);\n  }\n\n  if (expectedCollection && collection != expectedCollection) {\n    throw new Error(`(RS::To::fromId) Expected collection \"${expectedCollection}\" but got \"${collection}\" in aggregate id \"${aggregateId}\"`);\n  }\n\n  return {\n    collection: collection as TCollection,\n    entityId,\n  };\n}\n\n/**\n * returns a combined id for the vertex or edge by combining the type(s) and id(s).\n */\nexport namespace idOf {\n  /** `persons.id` */\n  export function person (\n    person:  ConnectedTypes.person | string,\n    options: Types.parsedToOptions\n  ): string {\n    return `${COLLECTION_ID.persons}.${ getVertexId(person, options) }`;\n  }\n\n  /** `groups.id` */\n  export function group (\n    group:   ConnectedTypes.group | string,\n    options: Types.parsedToOptions\n  ): string {\n    return `${COLLECTION_ID.groups}.${ getVertexId(group, options) }`;\n  }\n\n  /** `teachers.id` */\n  export function teacher (\n    teacher: ConnectedTypes.teacher | string,\n    options: Types.parsedToOptions\n  ): string {\n    return `${COLLECTION_ID.teachers}.${ getVertexId(teacher, options) }`;\n  }\n\n  /** `events.id` */\n  export function event (\n    event:   ConnectedTypes.event | string,\n    options: Types.parsedToOptions\n  ): string {\n    return `${COLLECTION_ID.events}.${ getVertexId(event, options) }`;\n  }\n\n  /** `lockedtimes.id` */\n  export function lockedTime (\n    lockedTime: ConnectedTypes.lockedTime | string,\n    options:    Types.parsedToOptions\n  ): string {\n    return `${COLLECTION_ID.lockedTimes}.${ getVertexId(lockedTime, options) }`;\n  }\n\n  /** `groups.id<.exclude.id1.id2...>` */\n  export function groupReference (\n    group:   GroupWithExclude.Util.Value<ConnectedTypes.group, ConnectedTypes.person>,\n    options: Types.parsedToOptions\n  ): string {\n    return `${COLLECTION_ID.groups}.${ getVertexId(group.to, options) }`\n      + (group.exclude?.length\n        ? '.exclude.' + group.exclude\n          .map(x => getVertexId(x, options))\n          .sort()\n          .join('.')\n        : '');\n  }\n\n  /** `<rootIntervalsId&>JSON.stringify(intervals)>` */\n  export function intervalPairReference (\n    interval:     Interval[]           | undefined,\n    rootInterval: ConnectedTypes.rootInterval | undefined,\n    options:      Types.parsedToOptions\n  ): string {\n    // replace null with undefined\n    if (interval     === null) interval     = undefined;\n    if (rootInterval === null) rootInterval = undefined;\n\n    // replace empty intervals with undefined\n    if (interval && interval.length == 0) interval = undefined;\n\n    const out = (rootInterval ? getVertexId(rootInterval, options) + '&' : '') + JSON.stringify(interval);\n    return out;\n  }\n}\n\nexport namespace fromId {\n  export function aggregate (aggregateId: string): AggregateIdParts {\n    return parseAggregateId(aggregateId);\n  }\n\n  /** `persons.id` -> `id` */\n  export function person (aggregateId: string): string {\n    return parseAggregateId(aggregateId, 'persons').entityId;\n  }\n\n  /** `groups.id` -> `id` */\n  export function group (aggregateId: string): string {\n    return parseAggregateId(aggregateId, 'groups').entityId;\n  }\n\n  /** `teachers.id` -> `id` */\n  export function teacher (aggregateId: string): string {\n    return parseAggregateId(aggregateId, 'teachers').entityId;\n  }\n\n  /** `events.id` -> `id` */\n  export function event (aggregateId: string): string {\n    return parseAggregateId(aggregateId, 'events').entityId;\n  }\n\n  /** `lockedtimes.id` -> `id` */\n  export function lockedTime (aggregateId: string): string {\n    return parseAggregateId(aggregateId, 'lockedTimes').entityId;\n  }\n}\n"],"mappings":";;;AAOA,SAAgB,QAAS,KAAgC;AACvD,KAAI,OAAO,KAAM;AACjB,QAAO,MAAM;;;;;AAMf,SAAgB,YAAa,KAAa;AACxC,QAAO,WAAW,IAAI,QAAQ,KAAK,IAAI,CAAC;;AAsB1C,MAAa,gBAAgB;CAC3B,SAAa;CACb,QAAa;CACb,UAAa;CACb,QAAa;CACb,aAAa;CACd;AASD,MAAM,mBAAmB,OAAO,YAAY,OAAO,QAAQ,cAAc,CAAC,KAAK,CAAC,YAAY,QAAQ,CAAC,IAAI,WAAW,CAAC,CAAC;AAWtH,SAAS,iBACP,aACA,oBAC+B;CAC/B,MAAM,aAAa,YAAY,QAAQ,IAAI;AAC3C,KAAI,cAAc,GAChB,OAAM,IAAI,MAAM,kEAAkE,YAAY,GAAG;CAGnG,MAAM,eAAe,YAAY,UAAU,GAAG,WAAW,CAAC,aAAa;CACvE,MAAM,WAAW,YAAY,UAAU,aAAa,EAAE;AAEtD,KAAI,CAAC,SACH,OAAM,IAAI,MAAM,uDAAuD,YAAY,GAAG;CAGxF,MAAM,aAAa,iBAAiB;AACpC,KAAI,CAAC,WACH,OAAM,IAAI,MAAM,2CAA2C,aAAa,qBAAqB,YAAY,GAAG;AAG9G,KAAI,sBAAsB,cAAc,mBACtC,OAAM,IAAI,MAAM,yCAAyC,mBAAmB,aAAa,WAAW,qBAAqB,YAAY,GAAG;AAG1I,QAAO;EACO;EACZ;EACD;;;;CAQM,SAAS,OACd,QACA,SACQ;AACR,SAAO,GAAG,cAAc,QAAQ,GAAI,YAAY,QAAQ,QAAQ;;;CAI3D,SAAS,MACd,OACA,SACQ;AACR,SAAO,GAAG,cAAc,OAAO,GAAI,YAAY,OAAO,QAAQ;;;CAIzD,SAAS,QACd,SACA,SACQ;AACR,SAAO,GAAG,cAAc,SAAS,GAAI,YAAY,SAAS,QAAQ;;;CAI7D,SAAS,MACd,OACA,SACQ;AACR,SAAO,GAAG,cAAc,OAAO,GAAI,YAAY,OAAO,QAAQ;;;CAIzD,SAAS,WACd,YACA,SACQ;AACR,SAAO,GAAG,cAAc,YAAY,GAAI,YAAY,YAAY,QAAQ;;;CAInE,SAAS,eACd,OACA,SACQ;AACR,SAAO,GAAG,cAAc,OAAO,GAAI,YAAY,MAAM,IAAI,QAAQ,MAC5D,MAAM,SAAS,SACd,cAAc,MAAM,QACnB,KAAI,MAAK,YAAY,GAAG,QAAQ,CAAC,CACjC,MAAM,CACN,KAAK,IAAI,GACV;;;CAID,SAAS,sBACd,UACA,cACA,SACQ;AAER,MAAI,aAAiB,KAAM,YAAe;AAC1C,MAAI,iBAAiB,KAAM,gBAAe;AAG1C,MAAI,YAAY,SAAS,UAAU,EAAG,YAAW;AAGjD,UADa,eAAe,YAAY,cAAc,QAAQ,GAAG,MAAM,MAAM,KAAK,UAAU,SAAS;;;;;;CAMhG,SAAS,UAAW,aAAuC;AAChE,SAAO,iBAAiB,YAAY;;;CAI/B,SAAS,OAAQ,aAA6B;AACnD,SAAO,iBAAiB,aAAa,UAAU,CAAC;;;CAI3C,SAAS,MAAO,aAA6B;AAClD,SAAO,iBAAiB,aAAa,SAAS,CAAC;;;CAI1C,SAAS,QAAS,aAA6B;AACpD,SAAO,iBAAiB,aAAa,WAAW,CAAC;;;CAI5C,SAAS,MAAO,aAA6B;AAClD,SAAO,iBAAiB,aAAa,SAAS,CAAC;;;CAI1C,SAAS,WAAY,aAA6B;AACvD,SAAO,iBAAiB,aAAa,cAAc,CAAC"}

package/dist/RS/to/schedules.d.mts

@@ -0,0 +1,7 @@
+import { Types } from "../types/index.mjs";
+
+//#region src/RS/to/schedules.d.ts
+declare function schedules(data: Types.toInput, _options?: Types.toOptions): Types.toOutput;
+//#endregion
+export { schedules };
+//# sourceMappingURL=schedules.d.mts.map

package/dist/RS/to/schedules.mjs

@@ -0,0 +1,51 @@
+import { CoreMap } from "../../core/index.mjs";
+import { COLLECTION_ID } from "./input/util/util.mjs";
+import { parseInput } from "./input/input.mjs";
+import { makeConnected } from "../make-connected.mjs";
+import { initialConfiguration } from "./initial-configuration.mjs";
+import { structure } from "../types/to.mjs";
+import { pick } from "lodash-es";
+
+//#region src/RS/to/schedules.ts
+function transformId(id) {
+	const indexOfDot = id.indexOf(".");
+	if (indexOfDot == -1) return COLLECTION_ID.events + "." + id;
+	const prefix = id.substring(0, indexOfDot).toLowerCase();
+	const suffix = id.substring(indexOfDot + 1);
+	if (prefix == COLLECTION_ID.lockedTimes.toLowerCase()) return COLLECTION_ID.lockedTimes + "." + suffix;
+	if (prefix == COLLECTION_ID.events.toLowerCase()) return COLLECTION_ID.events + "." + suffix;
+	throw new Error(`(RS::To::transformId) Unknown id prefix "${prefix}" in id "${id}"`);
+}
+function schedules(data, _options = {}) {
+	const options = (() => {
+		const x = _options.partialScheduleOptions;
+		const partialScheduleOptions = x ? {
+			includedEvents: x.includedEvents ? new Set(x.includedEvents) : void 0,
+			includedLocations: x.includedLocations ? new Set(x.includedLocations) : void 0,
+			omittedEventsHandling: x.omittedEventsHandling
+		} : void 0;
+		return {
+			..._options,
+			partialScheduleOptions
+		};
+	})();
+	if (options.partialScheduleOptions?.includedEvents?.size) options.partialScheduleOptions.includedEvents = new Set([...options.partialScheduleOptions.includedEvents].map((x) => transformId(x)));
+	const connectedData = makeConnected(data);
+	return {
+		meta: {
+			structure,
+			division: pick(connectedData.division, "displayName", "start", "end")
+		},
+		algorithmParameters: {
+			weights: options.algorithmWeightParameters,
+			computeTimeMultiplier: options.computeTimeMultiplier
+		},
+		input: parseInput(connectedData, options),
+		...options.appendCoreData && { coreData: CoreMap.to.schedules(data) },
+		...options.appendOutput && { output: initialConfiguration(connectedData.events, connectedData.lockedTimes, options) }
+	};
+}
+
+//#endregion
+export { schedules };
+//# sourceMappingURL=schedules.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schedules.mjs","names":[],"sources":["../../../src/RS/to/schedules.ts"],"sourcesContent":["import { pick } from 'lodash-es';\nimport { parseInput } from './input/input';\nimport { makeConnected } from '../make-connected';\nimport { initialConfiguration } from './initial-configuration';\nimport type { Types } from '../types';\nimport { CoreMap } from '../../core';\nimport { structure } from '../types/to';\nimport { COLLECTION_ID } from './input/util/util';\n\nfunction transformId (id: string): string {\n  // should be interpreted as event id\n  const indexOfDot = id.indexOf('.');\n  if (indexOfDot == -1) return COLLECTION_ID.events + '.' + id;\n\n  // split on first dot only\n  const prefix = id.substring(0, indexOfDot).toLowerCase();\n  const suffix = id.substring(indexOfDot + 1);\n\n  if (prefix == COLLECTION_ID.lockedTimes.toLowerCase()) return COLLECTION_ID.lockedTimes + '.' + suffix;\n  if (prefix == COLLECTION_ID.events     .toLowerCase()) return COLLECTION_ID.events      + '.' + suffix;\n\n  throw new Error(`(RS::To::transformId) Unknown id prefix \"${prefix}\" in id \"${id}\"`);\n}\n\nexport function schedules (\n  data:     Types.toInput,\n  _options: Types.toOptions = {}\n): Types.toOutput {\n  ////\n  //// parse the options\n  ////\n  const options = ((): Types.parsedToOptions => {\n    const x = _options.partialScheduleOptions;\n    const partialScheduleOptions: Types.parsedToOptions['partialScheduleOptions'] = x\n      ? {\n        includedEvents:        x.includedEvents    ? new Set(x.includedEvents)    : undefined,\n        includedLocations:     x.includedLocations ? new Set(x.includedLocations) : undefined,\n        omittedEventsHandling: x.omittedEventsHandling\n      }\n      : undefined;\n\n    return { ..._options, partialScheduleOptions };\n  })();\n\n  ////\n  //// for backward compatibility: add default collection to included events set\n  ////\n  if (options.partialScheduleOptions?.includedEvents?.size) {\n    options.partialScheduleOptions.includedEvents = new Set(\n      [...options.partialScheduleOptions.includedEvents].map(x => transformId(x))\n    );\n  }\n\n\n  // we will work only with connected schedule data\n  const connectedData = makeConnected(data);\n\n  return {\n    meta: {\n      structure: structure,\n      division:  pick(connectedData.division, 'displayName', 'start', 'end'),\n    },\n    algorithmParameters: {\n      weights:               options.algorithmWeightParameters,\n      computeTimeMultiplier: options.computeTimeMultiplier\n    },\n    input: parseInput(connectedData, options),\n    ...options.appendCoreData && { coreData: CoreMap.to.schedules(data) },\n    ...options.appendOutput   && { output: initialConfiguration(connectedData.events, connectedData.lockedTimes, options) },\n  };\n};"],"mappings":";;;;;;;;;AASA,SAAS,YAAa,IAAoB;CAExC,MAAM,aAAa,GAAG,QAAQ,IAAI;AAClC,KAAI,cAAc,GAAI,QAAO,cAAc,SAAS,MAAM;CAG1D,MAAM,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC,aAAa;CACxD,MAAM,SAAS,GAAG,UAAU,aAAa,EAAE;AAE3C,KAAI,UAAU,cAAc,YAAY,aAAa,CAAE,QAAO,cAAc,cAAc,MAAM;AAChG,KAAI,UAAU,cAAc,OAAY,aAAa,CAAE,QAAO,cAAc,SAAc,MAAM;AAEhG,OAAM,IAAI,MAAM,4CAA4C,OAAO,WAAW,GAAG,GAAG;;AAGtF,SAAgB,UACd,MACA,WAA4B,EAAE,EACd;CAIhB,MAAM,iBAAwC;EAC5C,MAAM,IAAI,SAAS;EACnB,MAAM,yBAA0E,IAC5E;GACA,gBAAuB,EAAE,iBAAoB,IAAI,IAAI,EAAE,eAAe,GAAM;GAC5E,mBAAuB,EAAE,oBAAoB,IAAI,IAAI,EAAE,kBAAkB,GAAG;GAC5E,uBAAuB,EAAE;GAC1B,GACC;AAEJ,SAAO;GAAE,GAAG;GAAU;GAAwB;KAC5C;AAKJ,KAAI,QAAQ,wBAAwB,gBAAgB,KAClD,SAAQ,uBAAuB,iBAAiB,IAAI,IAClD,CAAC,GAAG,QAAQ,uBAAuB,eAAe,CAAC,KAAI,MAAK,YAAY,EAAE,CAAC,CAC5E;CAKH,MAAM,gBAAgB,cAAc,KAAK;AAEzC,QAAO;EACL,MAAM;GACO;GACX,UAAW,KAAK,cAAc,UAAU,eAAe,SAAS,MAAM;GACvE;EACD,qBAAqB;GACnB,SAAuB,QAAQ;GAC/B,uBAAuB,QAAQ;GAChC;EACD,OAAO,WAAW,eAAe,QAAQ;EACzC,GAAG,QAAQ,kBAAkB,EAAE,UAAU,QAAQ,GAAG,UAAU,KAAK,EAAE;EACrE,GAAG,QAAQ,gBAAkB,EAAE,QAAQ,qBAAqB,cAAc,QAAQ,cAAc,aAAa,QAAQ,EAAE;EACxH"}

package/dist/RS/types/algorithm-parameters.d.mts

@@ -0,0 +1,17 @@
+//#region src/RS/types/algorithm-parameters.d.ts
+type ParameterName = 'overlap' | 'doubleBooking' | 'timeFrame' | 'insufficientBreak' | 'dailyOvertime' | 'gap' | 'dependencyAlternation' | 'overtime' | 'dependencyRank' | 'dayRank' | 'groupRank' | 'distribution' | 'preferredTime';
+type AlgorithmWeightParameters = Record<ParameterName, number | false>;
+type AlgorithmParameters = {
+  /**
+   * Weights for different features used in the scheduling algorithm.
+   */
+  weights?: AlgorithmWeightParameters;
+  /**
+   * A multiplier that lets the schedule algorithm run for a longer time to find better solutions.
+   * @default 1
+   */
+  computeTimeMultiplier?: number;
+};
+//#endregion
+export { AlgorithmParameters, AlgorithmWeightParameters };
+//# sourceMappingURL=algorithm-parameters.d.mts.map

package/dist/RS/types/configurations.d.mts

@@ -0,0 +1,10 @@
+import { Types } from "./index.mjs";
+
+//#region src/RS/types/configurations.d.ts
+type Configuration = {
+  score?: [number, number, number, number];
+  events: Types.eventConfiguration[];
+};
+//#endregion
+export { Configuration };
+//# sourceMappingURL=configurations.d.mts.map

package/dist/RS/types/event-configuration.d.mts

@@ -0,0 +1,20 @@
+//#region src/RS/types/event-configuration.d.ts
+interface EventConfiguration {
+  id: string;
+  start: number;
+  end: number;
+  day: number;
+  collection?: string;
+  dependencies?: string[];
+  /**
+   * @deprecated Currently no need to use this as groups are fixed
+   */
+  groups?: ({
+    groups: string[];
+  } | {
+    individuals: string[];
+  })[];
+}
+//#endregion
+export { EventConfiguration };
+//# sourceMappingURL=event-configuration.d.mts.map

package/dist/RS/types/index.d.mts

@@ -0,0 +1,21 @@
+import { ParsedToOptions, Structure, ToInput, ToOptions, ToOutput } from "./to.mjs";
+import { EventConfiguration } from "./event-configuration.mjs";
+import { Configuration } from "./configurations.mjs";
+import { ScheduleData } from "./schedule-data.mjs";
+
+//#region src/RS/types/index.d.ts
+declare namespace Types {
+  export import Shared = _Shared;
+  export import Entities = _Entities;
+  type scheduleData = ScheduleData;
+  type toInput = ToInput;
+  type toOptions = ToOptions;
+  type parsedToOptions = ParsedToOptions;
+  type toOutput = ToOutput;
+  type structure = Structure;
+  type eventConfiguration = EventConfiguration;
+  type configuration = Configuration;
+}
+//#endregion
+export { Types };
+//# sourceMappingURL=index.d.mts.map

package/dist/RS/types/schedule-data.d.mts

@@ -0,0 +1,20 @@
+import { Types } from "./index.mjs";
+
+//#region src/RS/types/schedule-data.d.ts
+interface ScheduleData {
+  settings: Types.Entities.Settings;
+  default: Types.Entities.DefaultValues;
+  periods: Types.Entities.Period[];
+  intervals: Types.Entities.Interval[];
+  events: Types.Entities.Event[];
+  groups: Types.Entities.Group[];
+  dependencies: Types.Entities.Dependency[];
+  individuals: (Types.Entities.Individual | Types.Entities.IndividualsSet)[];
+  blockedTimes: Types.Entities.BlockedTime[];
+  activities: Types.Entities.Activity[];
+  unitableEvents: Types.Entities.UnitableEventsSet[];
+  linkedEvents: Types.Entities.LinkedEventsSet[];
+}
+//#endregion
+export { ScheduleData };
+//# sourceMappingURL=schedule-data.d.mts.map

package/dist/RS/types/to.d.mts

@@ -0,0 +1,64 @@
+import { BaseOptions } from "../../common/types.mjs";
+import { Types } from "../../core/types/index.mjs";
+import "../../core/index.mjs";
+import { MixedScheduleData } from "../make-connected.mjs";
+import { AlgorithmParameters, AlgorithmWeightParameters } from "./algorithm-parameters.mjs";
+import { Types as Types$1 } from "./index.mjs";
+
+//#region src/RS/types/to.d.ts
+type ToInput = MixedScheduleData;
+type PartialScheduleOptions<IDs extends Array<string> | Set<string>> = {
+  /** @description undefined means all included */includedEvents?: IDs; /** @description undefined means all included */
+  includedLocations?: IDs;
+  omittedEventsHandling: 'ignore' | 'freeze';
+};
+interface ToOptions extends BaseOptions {
+  /**
+   * Includes some metadata about entities. Currently this only includes name but might be extended in the future.
+   * This is useful when running the algorithm locally from its GUI.
+   * @default false
+   */
+  includeEntityMeta?: boolean;
+  /**
+   * If true, the output will include the full core data. This enables the resulting output file to be uploaded as a new schedule.
+   * @default false
+   */
+  appendCoreData?: boolean;
+  /**
+   * If true, the output will include current configuration of events and locked times as `output` entry.
+   * @default false
+   */
+  appendOutput?: boolean;
+  /**
+   * Allows to specify that only a subset of events and/or locations should be included in the schedule optimization, and how the omitted events should be handled.
+   */
+  partialScheduleOptions?: PartialScheduleOptions<Array<string> | Set<string>>;
+  /**
+   * The weight parameters to be used by the algorithm. One may also specify `false` for any of the parameters to disable the corresponding feature.
+   */
+  algorithmWeightParameters?: AlgorithmWeightParameters;
+  /**
+   * The time multiplier to be used by the algorithm. A number twice as large implies that the algorithm will spend twice as much time optimizing the schedule.
+   * @default 1
+   */
+  computeTimeMultiplier?: number;
+}
+interface ParsedToOptions extends Omit<ToOptions, 'partialScheduleOptions'> {
+  partialScheduleOptions?: PartialScheduleOptions<Set<string>>;
+}
+declare const structure = "RS/algorithm-6.0.0";
+type Structure = typeof structure;
+interface ToOutput {
+  meta: {
+    structure?: Structure;
+    division: Pick<Types.Deep.Division, 'displayName' | 'start' | 'end'>;
+  };
+  algorithmParameters: AlgorithmParameters;
+  score?: [number, number, number, number];
+  input: Types$1.scheduleData;
+  output?: Types$1.configuration[];
+  coreData?: Partial<Types.SerializedWithOptionalId.Schedule>;
+}
+//#endregion
+export { ParsedToOptions, Structure, ToInput, ToOptions, ToOutput };
+//# sourceMappingURL=to.d.mts.map

package/dist/RS/types/to.mjs

@@ -0,0 +1,6 @@
+//#region src/RS/types/to.ts
+const structure = "RS/algorithm-6.0.0";
+
+//#endregion
+export { structure };
+//# sourceMappingURL=to.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"to.mjs","names":[],"sources":["../../../src/RS/types/to.ts"],"sourcesContent":["import type { BaseOptions } from '../../common/types';\nimport type { CoreTypes } from '../../core';\nimport type { MixedScheduleData } from '../make-connected';\nimport type { Types } from './';\nimport type { AlgorithmParameters, AlgorithmWeightParameters } from './algorithm-parameters';\n\n\nexport type ToInput = MixedScheduleData;\n\ntype PartialScheduleOptions<IDs extends Array<string> | Set<string>> = {\n  /** @description undefined means all included */\n  includedEvents?:       IDs;\n  /** @description undefined means all included */\n  includedLocations?:    IDs;\n  omittedEventsHandling: 'ignore' | 'freeze';\n};\n\nexport interface ToOptions extends BaseOptions {\n  /**\n   * Includes some metadata about entities. Currently this only includes name but might be extended in the future.\n   * This is useful when running the algorithm locally from its GUI.\n   * @default false\n   */\n  includeEntityMeta?: boolean;\n\n  /**\n   * If true, the output will include the full core data. This enables the resulting output file to be uploaded as a new schedule.\n   * @default false\n   */\n  appendCoreData?: boolean;\n\n  /**\n   * If true, the output will include current configuration of events and locked times as `output` entry.\n   * @default false\n   */\n  appendOutput?: boolean;\n\n  /**\n   * Allows to specify that only a subset of events and/or locations should be included in the schedule optimization, and how the omitted events should be handled.\n   */\n  partialScheduleOptions?: PartialScheduleOptions<Array<string> | Set<string>>\n\n  /**\n   * The weight parameters to be used by the algorithm. One may also specify `false` for any of the parameters to disable the corresponding feature.\n   */\n  algorithmWeightParameters?: AlgorithmWeightParameters;\n\n  /**\n   * The time multiplier to be used by the algorithm. A number twice as large implies that the algorithm will spend twice as much time optimizing the schedule.\n   * @default 1\n   */\n  computeTimeMultiplier?: number;\n}\n\nexport interface ParsedToOptions extends Omit<ToOptions, 'partialScheduleOptions'> {\n  partialScheduleOptions?: PartialScheduleOptions<Set<string>>\n}\n\nexport const structure = 'RS/algorithm-6.0.0';\nexport type Structure = typeof structure;\nexport interface ToOutput {\n  meta:      {\n    structure?: Structure;\n    division:   Pick<CoreTypes.Deep.Division, 'displayName' | 'start' | 'end'>;\n  };\n  algorithmParameters: AlgorithmParameters;\n  score?:              [number, number, number, number];\n  input:               Types.scheduleData;\n  output?:             Types.configuration[];\n  coreData?:           Partial<CoreTypes.SerializedWithOptionalId.Schedule>;\n}"],"mappings":";AA0DA,MAAa,YAAY"}

package/dist/SS12000/from/activities.mjs

@@ -0,0 +1,35 @@
+import { isNil, omitBy } from "lodash-es";
+
+//#region src/SS12000/from/activities.ts
+var activities_default = (activities, options) => {
+	if (!Array.isArray(activities)) throw new Error("(SS12000::From::Activities) Activities input is not of array type", { cause: "invalid_input" });
+	const parentActivities = new Set(activities.map((x) => x.parentActivity?.id).filter(Boolean));
+	return activities.map((activity) => {
+		if (parentActivities.has(activity.id)) return;
+		const groupIndexSet = [...new Set([void 0, ...activity.rooms?.map(({ index }) => index) ?? []])];
+		return {
+			ids: activity.id,
+			startDate: activity.startDate,
+			...omitBy({
+				displayName: activity.displayName,
+				comment: activity.comment,
+				subject: activity.subject,
+				endDate: activity.endDate,
+				syllabus: activity._embedded?.syllabus
+			}, isNil),
+			...activity.minutesPlanned && { plannedDuration: `${Math.ceil(activity.minutesPlanned / 60)} hrs` },
+			type: activity.activityType,
+			groups: activity.groups?.map(({ id }) => ({ to: id })),
+			teachers: activity.teachers?.map(({ duty: { id } }) => ({ to: id })),
+			...activity.rooms && { locations: activity.rooms?.map(({ room, index }) => ({
+				locations: [room.id],
+				groupIndex: groupIndexSet.indexOf(index)
+			})) },
+			...activity._embedded?.syllabus && { subject: activity._embedded.syllabus.subjectCode }
+		};
+	}).filter((x) => x != null);
+};
+
+//#endregion
+export { activities_default as default };
+//# sourceMappingURL=activities.mjs.map

package/dist/SS12000/from/activities.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"activities.mjs","names":[],"sources":["../../../src/SS12000/from/activities.ts"],"sourcesContent":["import { isNil, omitBy } from 'lodash-es';\nimport type { CoreTypes } from '../../core';\nimport type { Activity } from '../types/activities';\n\nexport default (\n  activities: Activity[],\n  options?:   { interval?: { start: string, end: string } }\n):  CoreTypes.MixedWithoutInternalId.Course[] => {\n  if (!Array.isArray(activities))\n    throw new Error('(SS12000::From::Activities) Activities input is not of array type', { cause: 'invalid_input' });\n\n  const parentActivities = new Set(activities.map(x => x.parentActivity?.id).filter(Boolean));\n\n  return activities\n    .map((activity): CoreTypes.MixedWithoutInternalId.Course | undefined => {\n      // Skip activities that are above courses\n      if (parentActivities.has(activity.id)) return;\n\n      const groupIndexSet = [...new Set<number | undefined>([undefined, ...(activity.rooms?.map(({ index }) => index) ?? [])])];\n\n      const doc = {\n        ids:       activity.id,\n        startDate: activity.startDate,\n        ...omitBy({\n          displayName: activity.displayName,\n          comment:     activity.comment,\n          subject:     activity.subject,\n          endDate:     activity.endDate,\n          syllabus:    activity._embedded?.syllabus,\n        }, isNil),\n        ...activity.minutesPlanned && { plannedDuration: `${ Math.ceil(activity.minutesPlanned / 60) } hrs` },\n        type:     activity.activityType,\n        groups:   activity.groups?.map(({ id }) => ({ to: id })),\n        teachers: activity.teachers?.map(({ duty: { id } }) => ({ to: id })),\n        // not in the standard\n        ...activity.rooms && {\n          locations: activity.rooms?.map(({ room, index }) => ({ locations: [room.id!] as [string], groupIndex: groupIndexSet.indexOf(index) })),\n        },\n        ...activity._embedded?.syllabus && {\n          subject: activity._embedded.syllabus.subjectCode,\n        }\n      };\n      return doc;\n    })\n    .filter(x => x != null);\n};"],"mappings":";;;AAIA,0BACE,YACA,YAC+C;AAC/C,KAAI,CAAC,MAAM,QAAQ,WAAW,CAC5B,OAAM,IAAI,MAAM,qEAAqE,EAAE,OAAO,iBAAiB,CAAC;CAElH,MAAM,mBAAmB,IAAI,IAAI,WAAW,KAAI,MAAK,EAAE,gBAAgB,GAAG,CAAC,OAAO,QAAQ,CAAC;AAE3F,QAAO,WACJ,KAAK,aAAkE;AAEtE,MAAI,iBAAiB,IAAI,SAAS,GAAG,CAAE;EAEvC,MAAM,gBAAgB,CAAC,GAAG,IAAI,IAAwB,CAAC,QAAW,GAAI,SAAS,OAAO,KAAK,EAAE,YAAY,MAAM,IAAI,EAAE,CAAE,CAAC,CAAC;AAwBzH,SAtBY;GACV,KAAW,SAAS;GACpB,WAAW,SAAS;GACpB,GAAG,OAAO;IACR,aAAa,SAAS;IACtB,SAAa,SAAS;IACtB,SAAa,SAAS;IACtB,SAAa,SAAS;IACtB,UAAa,SAAS,WAAW;IAClC,EAAE,MAAM;GACT,GAAG,SAAS,kBAAkB,EAAE,iBAAiB,GAAI,KAAK,KAAK,SAAS,iBAAiB,GAAG,CAAE,OAAO;GACrG,MAAU,SAAS;GACnB,QAAU,SAAS,QAAQ,KAAK,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE;GACxD,UAAU,SAAS,UAAU,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,IAAI,EAAE;GAEpE,GAAG,SAAS,SAAS,EACnB,WAAW,SAAS,OAAO,KAAK,EAAE,MAAM,aAAa;IAAE,WAAW,CAAC,KAAK,GAAI;IAAc,YAAY,cAAc,QAAQ,MAAM;IAAE,EAAE,EACvI;GACD,GAAG,SAAS,WAAW,YAAY,EACjC,SAAS,SAAS,UAAU,SAAS,aACtC;GACF;GAED,CACD,QAAO,MAAK,KAAK,KAAK"}

package/dist/SS12000/from/calendar-events.mjs

@@ -0,0 +1,20 @@
+import rooms_default from "./rooms.mjs";
+import moment from "moment";
+
+//#region src/SS12000/from/calendar-events.ts
+var calendar_events_default = (events) => {
+	if (!Array.isArray(events)) throw new Error("(SS12000::From::CalendarEvents) CalendarEvent input is not of array type", { cause: "invalid_input" });
+	return events.map((event) => ({
+		ids: event.id,
+		start: event.startTime.toString(),
+		end: event.endTime.toString(),
+		duration: moment(event.endTime).diff(event.endTime, "m"),
+		preferredDuration: moment(event.endTime).diff(event.endTime, "m"),
+		course: event.activity.id,
+		inLocations: rooms_default(event.rooms ?? [])
+	}));
+};
+
+//#endregion
+export { calendar_events_default as default };
+//# sourceMappingURL=calendar-events.mjs.map

package/dist/SS12000/from/calendar-events.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-events.mjs","names":["toRoom"],"sources":["../../../src/SS12000/from/calendar-events.ts"],"sourcesContent":["import moment from 'moment';\nimport type { CoreTypes } from '../../core';\nimport type { CalendarEvent } from '../types/calendar-events';\nimport toRoom from './rooms';\n\nexport default (events: CalendarEvent[]): CoreTypes.MixedWithoutInternalId.Event[] => {\n  if (!Array.isArray(events))\n    throw new Error('(SS12000::From::CalendarEvents) CalendarEvent input is not of array type', { cause: 'invalid_input' });\n\n  return events\n    .map((event): CoreTypes.MixedWithoutInternalId.Event => ({\n      ids:               event.id,\n      start:             event.startTime.toString(),\n      end:               event.endTime.toString(),\n      duration:          moment(event.endTime).diff(event.endTime, 'm'),\n      preferredDuration: moment(event.endTime).diff(event.endTime, 'm'),\n      course:            event.activity.id,\n      inLocations:       toRoom(event.rooms ?? []),\n      //    resources:               toResource([])\n    }));\n};\n"],"mappings":";;;;AAKA,+BAAgB,WAAsE;AACpF,KAAI,CAAC,MAAM,QAAQ,OAAO,CACxB,OAAM,IAAI,MAAM,4EAA4E,EAAE,OAAO,iBAAiB,CAAC;AAEzH,QAAO,OACJ,KAAK,WAAmD;EACvD,KAAmB,MAAM;EACzB,OAAmB,MAAM,UAAU,UAAU;EAC7C,KAAmB,MAAM,QAAQ,UAAU;EAC3C,UAAmB,OAAO,MAAM,QAAQ,CAAC,KAAK,MAAM,SAAS,IAAI;EACjE,mBAAmB,OAAO,MAAM,QAAQ,CAAC,KAAK,MAAM,SAAS,IAAI;EACjE,QAAmB,MAAM,SAAS;EAClC,aAAmBA,cAAO,MAAM,SAAS,EAAE,CAAC;EAE7C,EAAE"}

package/dist/SS12000/from/duties.mjs

@@ -0,0 +1,31 @@
+import persons_default from "./persons.mjs";
+import { omit } from "lodash-es";
+
+//#region src/SS12000/from/duties.ts
+var duties_default = (duties) => {
+	if (!Array.isArray(duties)) throw new Error("(SS12000::From::Duties) Teacher input is not of array type", { cause: "invalid_input" });
+	const toDisplayName = (firstName, lastName) => {
+		const first = firstName?.trim();
+		const last = lastName?.trim();
+		if (first && last) return `${first} ${last}`;
+		return first || last || void 0;
+	};
+	return duties.map((duty) => {
+		const person = duty._embedded?.person ?? duty.person;
+		const displayName = duty.displayName ?? toDisplayName(person?.givenName, person?.familyName) ?? person?.displayName;
+		return {
+			ids: duty.id,
+			displayName,
+			signature: duty.signature,
+			...(duty.person || duty._embedded?.person) && { person: {
+				type: "Teacher",
+				...duty.person && { ids: duty.person.id },
+				...duty._embedded?.person && omit(persons_default([duty._embedded.person])[0], "type")
+			} }
+		};
+	});
+};
+
+//#endregion
+export { duties_default as default };
+//# sourceMappingURL=duties.mjs.map

package/dist/SS12000/from/duties.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"duties.mjs","names":["toPerson"],"sources":["../../../src/SS12000/from/duties.ts"],"sourcesContent":["import { omit } from 'lodash-es';\nimport type { CoreTypes } from '../../core';\nimport type { Duty } from '../types/duties';\nimport toPerson from './persons';\n\nexport default (duties: Duty[]): CoreTypes.MixedWithoutInternalId.Teacher[] => {\n  if (!Array.isArray(duties))\n    throw new Error('(SS12000::From::Duties) Teacher input is not of array type', { cause: 'invalid_input' });\n\n  const toDisplayName = (firstName?: string, lastName?: string) => {\n    const first = firstName?.trim();\n    const last = lastName?.trim();\n    if (first && last) return `${ first } ${ last }`;\n    return first || last || undefined;\n  };\n\n  return duties\n    .map((duty): CoreTypes.MixedWithoutInternalId.Teacher => {\n      const person = duty._embedded?.person ?? duty.person;\n      const displayName = duty.displayName\n        ?? toDisplayName(person?.givenName, person?.familyName)\n        ?? person?.displayName;\n\n      return ({\n        ids:         duty.id,\n        displayName: displayName,\n        signature:   duty.signature,\n        ...(duty.person || duty._embedded?.person) && {\n          person: {\n            type: 'Teacher',\n            ...duty.person && { ids: duty.person.id },\n            ...duty._embedded?.person && omit(toPerson([ duty._embedded.person ])[0], 'type')\n          }\n        }\n      });\n    });\n};\n"],"mappings":";;;;AAKA,sBAAgB,WAA+D;AAC7E,KAAI,CAAC,MAAM,QAAQ,OAAO,CACxB,OAAM,IAAI,MAAM,8DAA8D,EAAE,OAAO,iBAAiB,CAAC;CAE3G,MAAM,iBAAiB,WAAoB,aAAsB;EAC/D,MAAM,QAAQ,WAAW,MAAM;EAC/B,MAAM,OAAO,UAAU,MAAM;AAC7B,MAAI,SAAS,KAAM,QAAO,GAAI,MAAO,GAAI;AACzC,SAAO,SAAS,QAAQ;;AAG1B,QAAO,OACJ,KAAK,SAAmD;EACvD,MAAM,SAAS,KAAK,WAAW,UAAU,KAAK;EAC9C,MAAM,cAAc,KAAK,eACpB,cAAc,QAAQ,WAAW,QAAQ,WAAW,IACpD,QAAQ;AAEb,SAAQ;GACN,KAAa,KAAK;GACL;GACb,WAAa,KAAK;GAClB,IAAI,KAAK,UAAU,KAAK,WAAW,WAAW,EAC5C,QAAQ;IACN,MAAM;IACN,GAAG,KAAK,UAAU,EAAE,KAAK,KAAK,OAAO,IAAI;IACzC,GAAG,KAAK,WAAW,UAAU,KAAKA,gBAAS,CAAE,KAAK,UAAU,OAAQ,CAAC,CAAC,IAAI,OAAO;IAClF,EACF;GACF;GACD"}

package/dist/SS12000/from/groups.mjs

@@ -0,0 +1,23 @@
+import moment from "moment";
+
+//#region src/SS12000/from/groups.ts
+function _transformGroupMembers(members, options) {
+	return [...new Set(members?.filter((member) => {
+		if (options?.end && member.startDate && !moment(member.startDate).isBefore(moment(options.end))) return false;
+		if (options?.start && member.endDate && !moment(member.endDate).isAfter(moment(options.start))) return false;
+		return true;
+	}).map((member) => member.person.id).filter(Boolean))];
+}
+var groups_default = (groups, options) => {
+	if (!Array.isArray(groups)) throw new Error("(SS12000::From::Groups) Group input is not of array type", { cause: "invalid_input" });
+	return groups.map((group) => ({
+		ids: group.id,
+		displayName: group.displayName,
+		...group.groupType == "Klass" && { species: "class" },
+		...group.groupMemberships && { members: _transformGroupMembers(group.groupMemberships, options) }
+	}));
+};
+
+//#endregion
+export { groups_default as default };
+//# sourceMappingURL=groups.mjs.map

package/dist/SS12000/from/groups.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups.mjs","names":[],"sources":["../../../src/SS12000/from/groups.ts"],"sourcesContent":["import moment from 'moment';\nimport type { CoreTypes } from '../../core';\nimport type { Group } from '../types/groups';\n\nfunction _transformGroupMembers (\n  members:  Group['groupMemberships'],\n  options?: Pick<CoreTypes.Deep.Division, 'start' | 'end'>\n) {\n  return [\n    ...new Set(\n      members?.filter(member => {\n        if (options?.end && member.startDate && !moment(member.startDate).isBefore(moment(options.end)))\n          return false;\n        if (options?.start && member.endDate && !moment(member.endDate).isAfter(moment(options.start)))\n          return false;\n        return true;\n      })\n        .map((member) => member.person.id)\n        .filter(Boolean)\n    )\n  ];\n}\n\nexport default (\n  groups:   Group[],\n  options?: Pick<CoreTypes.Deep.Division, 'start' | 'end'>\n): CoreTypes.MixedWithoutInternalId.Group[] => {\n  if (!Array.isArray(groups))\n    throw new Error('(SS12000::From::Groups) Group input is not of array type', { cause: 'invalid_input' });\n\n  return groups\n    .map((group): CoreTypes.MixedWithoutInternalId.Group => ({\n      ids:         group.id,\n      displayName: group.displayName,\n      ...group.groupType == 'Klass' && { species: 'class' },\n      ...group.groupMemberships && {\n        members: _transformGroupMembers(group.groupMemberships, options)\n      }\n    }));\n};"],"mappings":";;;AAIA,SAAS,uBACP,SACA,SACA;AACA,QAAO,CACL,GAAG,IAAI,IACL,SAAS,QAAO,WAAU;AACxB,MAAI,SAAS,OAAO,OAAO,aAAa,CAAC,OAAO,OAAO,UAAU,CAAC,SAAS,OAAO,QAAQ,IAAI,CAAC,CAC7F,QAAO;AACT,MAAI,SAAS,SAAS,OAAO,WAAW,CAAC,OAAO,OAAO,QAAQ,CAAC,QAAQ,OAAO,QAAQ,MAAM,CAAC,CAC5F,QAAO;AACT,SAAO;GACP,CACC,KAAK,WAAW,OAAO,OAAO,GAAG,CACjC,OAAO,QAAQ,CACnB,CACF;;AAGH,sBACE,QACA,YAC6C;AAC7C,KAAI,CAAC,MAAM,QAAQ,OAAO,CACxB,OAAM,IAAI,MAAM,4DAA4D,EAAE,OAAO,iBAAiB,CAAC;AAEzG,QAAO,OACJ,KAAK,WAAmD;EACvD,KAAa,MAAM;EACnB,aAAa,MAAM;EACnB,GAAG,MAAM,aAAa,WAAW,EAAE,SAAS,SAAS;EACrD,GAAG,MAAM,oBAAoB,EAC3B,SAAS,uBAAuB,MAAM,kBAAkB,QAAQ,EACjE;EACF,EAAE"}