@aibrains/shared-types 0.15.0 → 0.17.0

package/dist/utils/currency.js

@@ -2,44 +2,112 @@
 /**
  * Currency Formatting Utilities
  *
- * NPR formatting with Nepal-style lakh/crore grouping.
+ * Generic currency formatting with special support for South Asian
+ * lakh/crore grouping (NPR, INR) and standard Western grouping.
  * Pure utility functions — NOT in schema files.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatCurrency = formatCurrency;
 exports.formatNPR = formatNPR;
+// ============================================================================
+// CURRENCY REGISTRY
+// ============================================================================
+const CURRENCY_META = {
+    NPR: { code: 'NPR', symbol: 'NPR', symbolNative: 'रू', grouping: 'south_asian' },
+    INR: { code: 'INR', symbol: 'INR', symbolNative: '₹', grouping: 'south_asian' },
+    USD: { code: 'USD', symbol: '$', grouping: 'western' },
+    GBP: { code: 'GBP', symbol: '£', grouping: 'western' },
+    CAD: { code: 'CAD', symbol: 'CA$', grouping: 'western' },
+    AUD: { code: 'AUD', symbol: 'A$', grouping: 'western' },
+};
+// ============================================================================
+// INTERNAL HELPERS
+// ============================================================================
 /**
- * Format an amount as NPR currency string.
- * Uses Nepal's number formatting (commas at lakh/crore positions).
+ * Apply South Asian grouping: last 3 digits, then groups of 2.
+ * e.g. 1234567 → "12,34,567"
+ */
+function groupSouthAsian(intPart) {
+    if (intPart.length <= 3)
+        return intPart;
+    const last3 = intPart.slice(-3);
+    const rest = intPart.slice(0, -3);
+    const pairs = rest.replace(/\B(?=(\d{2})+(?!\d))/g, ',');
+    return `${pairs},${last3}`;
+}
+/**
+ * Apply Western grouping: groups of 3.
+ * e.g. 1234567 → "1,234,567"
+ */
+function groupWestern(intPart) {
+    return intPart.replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+}
+// ============================================================================
+// PUBLIC API
+// ============================================================================
+/**
+ * Generic currency formatter.
+ *
+ * Picks the correct digit-grouping style (lakh/crore vs. Western)
+ * based on the currency code. Falls back to Western grouping for
+ * unknown currencies.
+ *
+ * @param amount   - numeric amount (supports 0 and negatives for credits)
+ * @param currency - ISO 4217 currency code (e.g. 'NPR', 'USD')
+ * @param options  - formatting overrides
  *
  * Examples:
- *   formatNPR(12500)      → "NPR 12,500.00"
- *   formatNPR(12500, { locale: 'ne', showSymbol: true }) → "रू १२,५००.००"
- *   formatNPR(150000)     → "NPR 1,50,000.00" (lakh grouping)
+ *   formatCurrency(0, 'NPR')           → "NPR 0.00"
+ *   formatCurrency(150000, 'NPR')      → "NPR 1,50,000.00"
+ *   formatCurrency(-500, 'NPR')        → "NPR -500.00"
+ *   formatCurrency(1234567, 'USD')      → "$ 1,234,567.00"
+ *   formatCurrency(1234567, 'INR')      → "INR 12,34,567.00"
  */
-function formatNPR(amount, options = {}) {
-    const { locale = 'en', showSymbol = true, decimals = 2 } = options;
-    // Format with Nepal-style grouping (##,##,###.##)
-    const fixed = Math.abs(amount).toFixed(decimals);
+function formatCurrency(amount, currency, options = {}) {
+    var _a, _b;
+    const { locale, showSymbol = true, decimals = 2 } = options;
+    const meta = CURRENCY_META[currency];
+    const grouping = (_a = meta === null || meta === void 0 ? void 0 : meta.grouping) !== null && _a !== void 0 ? _a : 'western';
+    // Handle NaN / undefined defensively
+    const safeAmount = Number.isFinite(amount) ? amount : 0;
+    const isNegative = safeAmount < 0;
+    const fixed = Math.abs(safeAmount).toFixed(decimals);
     const [intPart, decPart] = fixed.split('.');
-    // Apply lakh/crore grouping: last 3 digits, then groups of 2
-    let grouped;
-    if (intPart.length <= 3) {
-        grouped = intPart;
-    }
-    else {
-        const last3 = intPart.slice(-3);
-        const rest = intPart.slice(0, -3);
-        const pairs = rest.replace(/\B(?=(\d{2})+(?!\d))/g, ',');
-        grouped = `${pairs},${last3}`;
-    }
-    // Convert digits to Devanagari for Nepali locale
+    const grouped = grouping === 'south_asian'
+        ? groupSouthAsian(intPart)
+        : groupWestern(intPart);
     let formatted = decPart ? `${grouped}.${decPart}` : grouped;
+    // Convert digits to Devanagari for Nepali locale
     if (locale === 'ne') {
         formatted = formatted.replace(/[0-9]/g, (d) => String.fromCharCode(0x0966 + Number(d)));
     }
-    if (amount < 0)
+    if (isNegative)
         formatted = `-${formatted}`;
-    const symbol = locale === 'ne' ? 'रू' : 'NPR';
-    return showSymbol ? `${symbol} ${formatted}` : formatted;
+    if (!showSymbol)
+        return formatted;
+    // Pick display symbol
+    let symbol;
+    if (locale === 'ne' && (meta === null || meta === void 0 ? void 0 : meta.symbolNative)) {
+        symbol = meta.symbolNative;
+    }
+    else {
+        symbol = (_b = meta === null || meta === void 0 ? void 0 : meta.symbol) !== null && _b !== void 0 ? _b : currency;
+    }
+    return `${symbol} ${formatted}`;
+}
+/**
+ * Format an amount as NPR currency string.
+ * Convenience wrapper around formatCurrency for Nepali Rupees.
+ * Uses Nepal's lakh/crore grouping (##,##,###.##).
+ *
+ * Examples:
+ *   formatNPR(0)           → "NPR 0.00"
+ *   formatNPR(12500)       → "NPR 12,500.00"
+ *   formatNPR(150000)      → "NPR 1,50,000.00"
+ *   formatNPR(-500)        → "NPR -500.00"
+ *   formatNPR(12500, { locale: 'ne' }) → "रू १२,५००.००"
+ */
+function formatNPR(amount, options = {}) {
+    return formatCurrency(amount, 'NPR', options);
 }
 //# sourceMappingURL=currency.js.map

package/dist/utils/currency.js.map

@@ -1 +1 @@
-{"version":3,"file":"currency.js","sourceRoot":"","sources":["../../src/utils/currency.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAiBH,8BAiCC;AA1CD;;;;;;;;GAQG;AACH,SAAgB,SAAS,CACvB,MAAc,EACd,UAA8B,EAAE;IAEhC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,GAAG,IAAI,EAAE,QAAQ,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAEnE,kDAAkD;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE5C,6DAA6D;IAC7D,IAAI,OAAe,CAAC;IACpB,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,GAAG,OAAO,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;QACzD,OAAO,GAAG,GAAG,KAAK,IAAI,KAAK,EAAE,CAAC;IAChC,CAAC;IAED,iDAAiD;IACjD,IAAI,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IAC5D,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAC5C,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CACxC,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,GAAG,CAAC;QAAE,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;IAE5C,MAAM,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9C,OAAO,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"currency.js","sourceRoot":"","sources":["../../src/utils/currency.ts"],"names":[],"mappings":"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"}

package/dist/utils/date-format.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Calendar-System-Aware Date Formatting
+ *
+ * Wraps Gregorian and BS formatting under a single API.
+ * All dates stored as Gregorian ISO — this formats for display.
+ */
+/**
+ * Format an ISO date according to the school's calendar system.
+ */
+export declare function formatSchoolDate(isoDate: string, calendarSystem: string, format?: string): string;
+/**
+ * Parse a date string back to Gregorian ISO, based on calendar system.
+ */
+export declare function parseSchoolDate(dateString: string, calendarSystem: string): string;
+/**
+ * Generate an academic year label based on calendar system.
+ * Gregorian: "2025-2026", BS: "2082-2083"
+ */
+export declare function getAcademicYearLabel(startDate: string, endDate: string, calendarSystem: string): string;
+//# sourceMappingURL=date-format.d.ts.map

package/dist/utils/date-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-format.d.ts","sourceRoot":"","sources":["../../src/utils/date-format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAuBR;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAMlF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GACrB,MAAM,CAYR"}

package/dist/utils/date-format.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * Calendar-System-Aware Date Formatting
+ *
+ * Wraps Gregorian and BS formatting under a single API.
+ * All dates stored as Gregorian ISO — this formats for display.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatSchoolDate = formatSchoolDate;
+exports.parseSchoolDate = parseSchoolDate;
+exports.getAcademicYearLabel = getAcademicYearLabel;
+const bikram_sambat_1 = require("./bikram-sambat");
+/**
+ * Format an ISO date according to the school's calendar system.
+ */
+function formatSchoolDate(isoDate, calendarSystem, format) {
+    if (!isoDate)
+        return '';
+    if (calendarSystem === 'bikram_sambat') {
+        return (0, bikram_sambat_1.formatBsDate)(isoDate, format);
+    }
+    // Gregorian formatting
+    const date = new Date(isoDate);
+    if (isNaN(date.getTime()))
+        return isoDate;
+    if (format === 'long') {
+        return date.toLocaleDateString('en-US', { year: 'numeric', month: 'long', day: 'numeric' });
+    }
+    if (format === 'short') {
+        return date.toLocaleDateString('en-US', { year: 'numeric', month: 'short', day: 'numeric' });
+    }
+    // Default: YYYY-MM-DD
+    const yyyy = date.getFullYear();
+    const mm = String(date.getMonth() + 1).padStart(2, '0');
+    const dd = String(date.getDate()).padStart(2, '0');
+    return `${yyyy}-${mm}-${dd}`;
+}
+/**
+ * Parse a date string back to Gregorian ISO, based on calendar system.
+ */
+function parseSchoolDate(dateString, calendarSystem) {
+    if (calendarSystem === 'bikram_sambat') {
+        return (0, bikram_sambat_1.parseBsDate)(dateString);
+    }
+    // Already Gregorian
+    return dateString;
+}
+/**
+ * Generate an academic year label based on calendar system.
+ * Gregorian: "2025-2026", BS: "2082-2083"
+ */
+function getAcademicYearLabel(startDate, endDate, calendarSystem) {
+    if (calendarSystem === 'bikram_sambat') {
+        const startBs = (0, bikram_sambat_1.gregorianToBs)(startDate);
+        const endBs = (0, bikram_sambat_1.gregorianToBs)(endDate);
+        if (startBs.year === endBs.year)
+            return String(startBs.year);
+        return `${startBs.year}-${endBs.year}`;
+    }
+    const startYear = new Date(startDate).getFullYear();
+    const endYear = new Date(endDate).getFullYear();
+    if (startYear === endYear)
+        return String(startYear);
+    return `${startYear}-${endYear}`;
+}
+//# sourceMappingURL=date-format.js.map

package/dist/utils/date-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-format.js","sourceRoot":"","sources":["../../src/utils/date-format.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAOH,4CA2BC;AAKD,0CAMC;AAMD,oDAgBC;AAjED,mDAA2E;AAE3E;;GAEG;AACH,SAAgB,gBAAgB,CAC9B,OAAe,EACf,cAAsB,EACtB,MAAe;IAEf,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAExB,IAAI,cAAc,KAAK,eAAe,EAAE,CAAC;QACvC,OAAO,IAAA,4BAAY,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,uBAAuB;IACvB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,OAAO,CAAC;IAE1C,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED,sBAAsB;IACtB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAChC,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxD,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnD,OAAO,GAAG,IAAI,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,UAAkB,EAAE,cAAsB;IACxE,IAAI,cAAc,KAAK,eAAe,EAAE,CAAC;QACvC,OAAO,IAAA,2BAAW,EAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IACD,oBAAoB;IACpB,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB,CAClC,SAAiB,EACjB,OAAe,EACf,cAAsB;IAEtB,IAAI,cAAc,KAAK,eAAe,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAA,6BAAa,EAAC,SAAS,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,IAAA,6BAAa,EAAC,OAAO,CAAC,CAAC;QACrC,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;YAAE,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7D,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;IACpD,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,SAAS,KAAK,OAAO;QAAE,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,OAAO,GAAG,SAAS,IAAI,OAAO,EAAE,CAAC;AACnC,CAAC"}

package/dist/utils/school-hours.d.ts

@@ -0,0 +1,48 @@
+/**
+ * School Hours Validation Utility
+ *
+ * Validates schedule slots, school days, and generates default bell schedule periods.
+ * All time values are HH:mm format (24-hour).
+ */
+export interface SchoolHoursConfig {
+    startTime: string;
+    endTime: string;
+    schoolDays: number[];
+    periodDuration: number;
+}
+export interface Period {
+    number: number;
+    startTime: string;
+    endTime: string;
+    type: 'class' | 'break';
+    label: string;
+}
+/**
+ * Check if a time falls within school hours (inclusive start, exclusive end)
+ */
+export declare function isWithinSchoolHours(time: string, startTime: string, endTime: string): boolean;
+/**
+ * Check if a day of week is a school day
+ */
+export declare function isSchoolDay(dayOfWeek: number, schoolDays: number[]): boolean;
+/**
+ * Validate a schedule slot against school hours config.
+ * Returns error message string or null if valid.
+ */
+export declare function validateScheduleSlot(params: {
+    startTime: string;
+    endTime: string;
+    dayOfWeek: number;
+    schoolConfig: SchoolHoursConfig;
+}): string | null;
+/**
+ * Auto-generate bell schedule periods based on school hours and period duration.
+ * Inserts breaks between periods.
+ */
+export declare function generateDefaultPeriods(startTime: string, endTime: string, periodDuration: number, breakDuration?: number): Period[];
+/**
+ * Validate a bell schedule against school hours.
+ * Returns array of error messages (empty if valid).
+ */
+export declare function validateBellSchedule(periods: Period[], schoolConfig: SchoolHoursConfig): string[];
+//# sourceMappingURL=school-hours.d.ts.map

package/dist/utils/school-hours.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"school-hours.d.ts","sourceRoot":"","sources":["../../src/utils/school-hours.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAmBD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAK7F;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAE5E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,iBAAiB,CAAC;CACjC,GAAG,MAAM,GAAG,IAAI,CAyBhB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,aAAa,GAAE,MAAW,GACzB,MAAM,EAAE,CAiCV;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EAAE,EACjB,YAAY,EAAE,iBAAiB,GAC9B,MAAM,EAAE,CA+BV"}

package/dist/utils/school-hours.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * School Hours Validation Utility
+ *
+ * Validates schedule slots, school days, and generates default bell schedule periods.
+ * All time values are HH:mm format (24-hour).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isWithinSchoolHours = isWithinSchoolHours;
+exports.isSchoolDay = isSchoolDay;
+exports.validateScheduleSlot = validateScheduleSlot;
+exports.generateDefaultPeriods = generateDefaultPeriods;
+exports.validateBellSchedule = validateBellSchedule;
+/**
+ * Parse HH:mm string to minutes since midnight
+ */
+function parseTime(time) {
+    const [h, m] = time.split(':').map(Number);
+    return h * 60 + m;
+}
+/**
+ * Format minutes since midnight to HH:mm
+ */
+function formatTime(minutes) {
+    const h = Math.floor(minutes / 60);
+    const m = minutes % 60;
+    return `${String(h).padStart(2, '0')}:${String(m).padStart(2, '0')}`;
+}
+/**
+ * Check if a time falls within school hours (inclusive start, exclusive end)
+ */
+function isWithinSchoolHours(time, startTime, endTime) {
+    const t = parseTime(time);
+    const start = parseTime(startTime);
+    const end = parseTime(endTime);
+    return t >= start && t <= end;
+}
+/**
+ * Check if a day of week is a school day
+ */
+function isSchoolDay(dayOfWeek, schoolDays) {
+    return schoolDays.includes(dayOfWeek);
+}
+/**
+ * Validate a schedule slot against school hours config.
+ * Returns error message string or null if valid.
+ */
+function validateScheduleSlot(params) {
+    const { startTime, endTime, dayOfWeek, schoolConfig } = params;
+    // Check school day
+    if (!isSchoolDay(dayOfWeek, schoolConfig.schoolDays)) {
+        const dayNames = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];
+        return `${dayNames[dayOfWeek]} is not a school day`;
+    }
+    // Check start time
+    if (!isWithinSchoolHours(startTime, schoolConfig.startTime, schoolConfig.endTime)) {
+        return `Start time ${startTime} falls outside school hours (${schoolConfig.startTime}-${schoolConfig.endTime})`;
+    }
+    // Check end time
+    if (!isWithinSchoolHours(endTime, schoolConfig.startTime, schoolConfig.endTime)) {
+        return `End time ${endTime} falls outside school hours (${schoolConfig.startTime}-${schoolConfig.endTime})`;
+    }
+    // Check order
+    if (parseTime(endTime) <= parseTime(startTime)) {
+        return `End time ${endTime} must be after start time ${startTime}`;
+    }
+    return null;
+}
+/**
+ * Auto-generate bell schedule periods based on school hours and period duration.
+ * Inserts breaks between periods.
+ */
+function generateDefaultPeriods(startTime, endTime, periodDuration, breakDuration = 10) {
+    const periods = [];
+    let currentTime = parseTime(startTime);
+    const schoolEnd = parseTime(endTime);
+    let periodNumber = 1;
+    while (currentTime + periodDuration <= schoolEnd) {
+        // Add class period
+        periods.push({
+            number: periodNumber,
+            startTime: formatTime(currentTime),
+            endTime: formatTime(currentTime + periodDuration),
+            type: 'class',
+            label: `Period ${periodNumber}`,
+        });
+        currentTime += periodDuration;
+        periodNumber++;
+        // Add break if there's room for another period after break
+        if (currentTime + breakDuration + periodDuration <= schoolEnd) {
+            periods.push({
+                number: periodNumber - 1, // breaks share the preceding period number
+                startTime: formatTime(currentTime),
+                endTime: formatTime(currentTime + breakDuration),
+                type: 'break',
+                label: periodNumber === 5 ? 'Lunch Break' : 'Break',
+            });
+            currentTime += breakDuration;
+        }
+    }
+    return periods;
+}
+/**
+ * Validate a bell schedule against school hours.
+ * Returns array of error messages (empty if valid).
+ */
+function validateBellSchedule(periods, schoolConfig) {
+    const errors = [];
+    const classPeriods = periods.filter(p => p.type === 'class');
+    if (classPeriods.length === 0) {
+        errors.push('Bell schedule must have at least one class period');
+        return errors;
+    }
+    // First period must not start before school start
+    const firstPeriod = classPeriods[0];
+    if (parseTime(firstPeriod.startTime) < parseTime(schoolConfig.startTime)) {
+        errors.push(`First period starts at ${firstPeriod.startTime}, before school start time ${schoolConfig.startTime}`);
+    }
+    // Last period must not end after school end
+    const lastPeriod = classPeriods[classPeriods.length - 1];
+    if (parseTime(lastPeriod.endTime) > parseTime(schoolConfig.endTime)) {
+        errors.push(`Last period ends at ${lastPeriod.endTime}, after school end time ${schoolConfig.endTime}`);
+    }
+    // Check period duration alignment (warning-level, not error)
+    for (const period of classPeriods) {
+        const duration = parseTime(period.endTime) - parseTime(period.startTime);
+        if (duration !== schoolConfig.periodDuration && duration !== schoolConfig.periodDuration * 2) {
+            // Allow single or double periods
+            errors.push(`Period ${period.number} duration (${duration}min) doesn't match configured period duration (${schoolConfig.periodDuration}min)`);
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=school-hours.js.map

package/dist/utils/school-hours.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aibrains/shared-types",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "Shared Zod schemas, TypeScript types, and validators for Education data models.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",