@jbctechsolutions/mcp-office365 2.5.1

package/dist/utils/errors.d.ts

@@ -0,0 +1,218 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * Custom error classes for the Outlook MCP server.
+ */
+/**
+ * Error codes for categorizing errors.
+ */
+export declare const ErrorCode: {
+    readonly DATABASE_NOT_FOUND: "DATABASE_NOT_FOUND";
+    readonly DATABASE_LOCKED: "DATABASE_LOCKED";
+    readonly DATABASE_ERROR: "DATABASE_ERROR";
+    readonly CONTENT_FILE_NOT_FOUND: "CONTENT_FILE_NOT_FOUND";
+    readonly CONTENT_PARSE_ERROR: "CONTENT_PARSE_ERROR";
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    readonly NOT_FOUND: "NOT_FOUND";
+    readonly OUTLOOK_NOT_RUNNING: "OUTLOOK_NOT_RUNNING";
+    readonly APPLESCRIPT_PERMISSION_DENIED: "APPLESCRIPT_PERMISSION_DENIED";
+    readonly APPLESCRIPT_TIMEOUT: "APPLESCRIPT_TIMEOUT";
+    readonly APPLESCRIPT_ERROR: "APPLESCRIPT_ERROR";
+    readonly GRAPH_AUTH_REQUIRED: "GRAPH_AUTH_REQUIRED";
+    readonly GRAPH_RATE_LIMITED: "GRAPH_RATE_LIMITED";
+    readonly GRAPH_PERMISSION_DENIED: "GRAPH_PERMISSION_DENIED";
+    readonly GRAPH_ERROR: "GRAPH_ERROR";
+    readonly ATTACHMENT_NOT_FOUND: "ATTACHMENT_NOT_FOUND";
+    readonly ATTACHMENT_TOO_LARGE: "ATTACHMENT_TOO_LARGE";
+    readonly ATTACHMENT_SAVE_ERROR: "ATTACHMENT_SAVE_ERROR";
+    readonly MAIL_SEND_ERROR: "MAIL_SEND_ERROR";
+    readonly RECURRING_EVENT_ERROR: "RECURRING_EVENT_ERROR";
+    readonly APPROVAL_EXPIRED: "APPROVAL_EXPIRED";
+    readonly APPROVAL_INVALID: "APPROVAL_INVALID";
+    readonly TARGET_CHANGED: "TARGET_CHANGED";
+};
+export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
+/**
+ * Base class for all Outlook MCP errors.
+ */
+export declare abstract class OutlookMcpError extends Error {
+    abstract readonly code: ErrorCode;
+    constructor(message: string);
+}
+/**
+ * Thrown when the Outlook database file cannot be found.
+ */
+export declare class DatabaseNotFoundError extends OutlookMcpError {
+    readonly code: "DATABASE_NOT_FOUND";
+    constructor(path: string);
+}
+/**
+ * Thrown when the Outlook database is locked by another process.
+ */
+export declare class DatabaseLockedError extends OutlookMcpError {
+    readonly code: "DATABASE_LOCKED";
+    constructor();
+}
+/**
+ * Thrown for general database errors.
+ */
+export declare class DatabaseError extends OutlookMcpError {
+    readonly cause?: Error | undefined;
+    readonly code: "DATABASE_ERROR";
+    constructor(message: string, cause?: Error | undefined);
+}
+/**
+ * Thrown when an olk15 content file cannot be found.
+ */
+export declare class ContentFileNotFoundError extends OutlookMcpError {
+    readonly code: "CONTENT_FILE_NOT_FOUND";
+    constructor(path: string);
+}
+/**
+ * Thrown when an olk15 file cannot be parsed.
+ */
+export declare class ContentParseError extends OutlookMcpError {
+    readonly cause?: Error | undefined;
+    readonly code: "CONTENT_PARSE_ERROR";
+    constructor(path: string, cause?: Error | undefined);
+}
+/**
+ * Thrown for input validation errors.
+ */
+export declare class ValidationError extends OutlookMcpError {
+    readonly code: "VALIDATION_ERROR";
+    constructor(message: string);
+}
+/**
+ * Thrown when a requested resource is not found.
+ */
+export declare class NotFoundError extends OutlookMcpError {
+    readonly code: "NOT_FOUND";
+    constructor(resourceType: string, id: number | string);
+}
+/**
+ * Type guard to check if an error is an OutlookMcpError.
+ */
+export declare function isOutlookMcpError(error: unknown): error is OutlookMcpError;
+/**
+ * Wraps an unknown error in an OutlookMcpError if needed.
+ */
+export declare function wrapError(error: unknown, defaultMessage: string): OutlookMcpError;
+/**
+ * Thrown when Outlook is not running and needs to be.
+ */
+export declare class OutlookNotRunningError extends OutlookMcpError {
+    readonly code: "OUTLOOK_NOT_RUNNING";
+    constructor();
+}
+/**
+ * Thrown when AppleScript automation permission is denied.
+ */
+export declare class AppleScriptPermissionError extends OutlookMcpError {
+    readonly code: "APPLESCRIPT_PERMISSION_DENIED";
+    constructor();
+}
+/**
+ * Thrown when AppleScript execution times out.
+ */
+export declare class AppleScriptTimeoutError extends OutlookMcpError {
+    readonly code: "APPLESCRIPT_TIMEOUT";
+    constructor(operation: string);
+}
+/**
+ * Thrown for general AppleScript errors.
+ */
+export declare class AppleScriptError extends OutlookMcpError {
+    readonly cause?: Error | undefined;
+    readonly code: "APPLESCRIPT_ERROR";
+    constructor(message: string, cause?: Error | undefined);
+}
+/**
+ * Thrown when Microsoft Graph authentication is required.
+ */
+export declare class GraphAuthRequiredError extends OutlookMcpError {
+    readonly code: "GRAPH_AUTH_REQUIRED";
+    constructor();
+}
+/**
+ * Thrown when the Graph API rate limit is exceeded.
+ */
+export declare class GraphRateLimitedError extends OutlookMcpError {
+    readonly code: "GRAPH_RATE_LIMITED";
+    readonly retryAfter: number | undefined;
+    constructor(retryAfter?: number);
+}
+/**
+ * Thrown when the Graph API denies access due to permissions.
+ */
+export declare class GraphPermissionDeniedError extends OutlookMcpError {
+    readonly code: "GRAPH_PERMISSION_DENIED";
+    constructor(scope?: string);
+}
+/**
+ * Thrown for general Microsoft Graph API errors.
+ */
+export declare class GraphError extends OutlookMcpError {
+    readonly cause?: Error | undefined;
+    readonly code: "GRAPH_ERROR";
+    constructor(message: string, cause?: Error | undefined);
+}
+/**
+ * Thrown when an attachment file cannot be found.
+ */
+export declare class AttachmentNotFoundError extends OutlookMcpError {
+    readonly code: "ATTACHMENT_NOT_FOUND";
+    constructor(path: string);
+}
+/**
+ * Thrown when an attachment exceeds the size limit.
+ */
+export declare class AttachmentTooLargeError extends OutlookMcpError {
+    readonly code: "ATTACHMENT_TOO_LARGE";
+    constructor(name: string, sizeBytes: number, maxBytes: number);
+}
+/**
+ * Thrown when saving an attachment to disk fails.
+ */
+export declare class AttachmentSaveError extends OutlookMcpError {
+    readonly code: "ATTACHMENT_SAVE_ERROR";
+    constructor(name: string, reason: string);
+}
+/**
+ * Thrown when sending an email fails.
+ */
+export declare class MailSendError extends OutlookMcpError {
+    readonly code: "MAIL_SEND_ERROR";
+    constructor(reason: string);
+}
+/**
+ * Thrown when there's an error with recurring events.
+ */
+export declare class RecurringEventError extends OutlookMcpError {
+    readonly code: "RECURRING_EVENT_ERROR";
+    constructor(message: string);
+}
+/**
+ * Thrown when an approval token has expired.
+ */
+export declare class ApprovalExpiredError extends OutlookMcpError {
+    readonly code: "APPROVAL_EXPIRED";
+    constructor();
+}
+/**
+ * Thrown when an approval token is invalid.
+ */
+export declare class ApprovalInvalidError extends OutlookMcpError {
+    readonly code: "APPROVAL_INVALID";
+    constructor(reason: string);
+}
+/**
+ * Thrown when the target has been modified since the approval was generated.
+ */
+export declare class TargetChangedError extends OutlookMcpError {
+    readonly code: "TARGET_CHANGED";
+    constructor();
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

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

package/dist/utils/errors.js

@@ -0,0 +1,306 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * Custom error classes for the Outlook MCP server.
+ */
+/**
+ * Error codes for categorizing errors.
+ */
+export const ErrorCode = {
+    DATABASE_NOT_FOUND: 'DATABASE_NOT_FOUND',
+    DATABASE_LOCKED: 'DATABASE_LOCKED',
+    DATABASE_ERROR: 'DATABASE_ERROR',
+    CONTENT_FILE_NOT_FOUND: 'CONTENT_FILE_NOT_FOUND',
+    CONTENT_PARSE_ERROR: 'CONTENT_PARSE_ERROR',
+    VALIDATION_ERROR: 'VALIDATION_ERROR',
+    NOT_FOUND: 'NOT_FOUND',
+    OUTLOOK_NOT_RUNNING: 'OUTLOOK_NOT_RUNNING',
+    APPLESCRIPT_PERMISSION_DENIED: 'APPLESCRIPT_PERMISSION_DENIED',
+    APPLESCRIPT_TIMEOUT: 'APPLESCRIPT_TIMEOUT',
+    APPLESCRIPT_ERROR: 'APPLESCRIPT_ERROR',
+    GRAPH_AUTH_REQUIRED: 'GRAPH_AUTH_REQUIRED',
+    GRAPH_RATE_LIMITED: 'GRAPH_RATE_LIMITED',
+    GRAPH_PERMISSION_DENIED: 'GRAPH_PERMISSION_DENIED',
+    GRAPH_ERROR: 'GRAPH_ERROR',
+    ATTACHMENT_NOT_FOUND: 'ATTACHMENT_NOT_FOUND',
+    ATTACHMENT_TOO_LARGE: 'ATTACHMENT_TOO_LARGE',
+    ATTACHMENT_SAVE_ERROR: 'ATTACHMENT_SAVE_ERROR',
+    MAIL_SEND_ERROR: 'MAIL_SEND_ERROR',
+    RECURRING_EVENT_ERROR: 'RECURRING_EVENT_ERROR',
+    APPROVAL_EXPIRED: 'APPROVAL_EXPIRED',
+    APPROVAL_INVALID: 'APPROVAL_INVALID',
+    TARGET_CHANGED: 'TARGET_CHANGED',
+};
+/**
+ * Base class for all Outlook MCP errors.
+ */
+export class OutlookMcpError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = this.constructor.name;
+        // Maintains proper stack trace for where error was thrown
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+/**
+ * Thrown when the Outlook database file cannot be found.
+ */
+export class DatabaseNotFoundError extends OutlookMcpError {
+    code = ErrorCode.DATABASE_NOT_FOUND;
+    constructor(path) {
+        super(`Outlook database not found at: ${path}. ` +
+            'Make sure Outlook for Mac has been opened at least once.');
+    }
+}
+/**
+ * Thrown when the Outlook database is locked by another process.
+ */
+export class DatabaseLockedError extends OutlookMcpError {
+    code = ErrorCode.DATABASE_LOCKED;
+    constructor() {
+        super('Outlook database is locked. ' +
+            'This may happen during a sync operation. Please try again in a few seconds.');
+    }
+}
+/**
+ * Thrown for general database errors.
+ */
+export class DatabaseError extends OutlookMcpError {
+    cause;
+    code = ErrorCode.DATABASE_ERROR;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+    }
+}
+/**
+ * Thrown when an olk15 content file cannot be found.
+ */
+export class ContentFileNotFoundError extends OutlookMcpError {
+    code = ErrorCode.CONTENT_FILE_NOT_FOUND;
+    constructor(path) {
+        super(`Content file not found: ${path}`);
+    }
+}
+/**
+ * Thrown when an olk15 file cannot be parsed.
+ */
+export class ContentParseError extends OutlookMcpError {
+    cause;
+    code = ErrorCode.CONTENT_PARSE_ERROR;
+    constructor(path, cause) {
+        super(`Failed to parse content file: ${path}`);
+        this.cause = cause;
+    }
+}
+/**
+ * Thrown for input validation errors.
+ */
+export class ValidationError extends OutlookMcpError {
+    code = ErrorCode.VALIDATION_ERROR;
+    constructor(message) {
+        super(message);
+    }
+}
+/**
+ * Thrown when a requested resource is not found.
+ */
+export class NotFoundError extends OutlookMcpError {
+    code = ErrorCode.NOT_FOUND;
+    constructor(resourceType, id) {
+        super(`${resourceType} with ID ${id} not found`);
+    }
+}
+/**
+ * Type guard to check if an error is an OutlookMcpError.
+ */
+export function isOutlookMcpError(error) {
+    return error instanceof OutlookMcpError;
+}
+/**
+ * Wraps an unknown error in an OutlookMcpError if needed.
+ */
+export function wrapError(error, defaultMessage) {
+    if (isOutlookMcpError(error)) {
+        return error;
+    }
+    if (error instanceof Error) {
+        return new DatabaseError(error.message, error);
+    }
+    return new DatabaseError(defaultMessage);
+}
+// =============================================================================
+// AppleScript Errors
+// =============================================================================
+/**
+ * Thrown when Outlook is not running and needs to be.
+ */
+export class OutlookNotRunningError extends OutlookMcpError {
+    code = ErrorCode.OUTLOOK_NOT_RUNNING;
+    constructor() {
+        super('Microsoft Outlook is not running. ' +
+            'Please start Outlook and try again.');
+    }
+}
+/**
+ * Thrown when AppleScript automation permission is denied.
+ */
+export class AppleScriptPermissionError extends OutlookMcpError {
+    code = ErrorCode.APPLESCRIPT_PERMISSION_DENIED;
+    constructor() {
+        super('Automation permission denied for Microsoft Outlook. ' +
+            'Please grant access in System Settings > Privacy & Security > Automation.');
+    }
+}
+/**
+ * Thrown when AppleScript execution times out.
+ */
+export class AppleScriptTimeoutError extends OutlookMcpError {
+    code = ErrorCode.APPLESCRIPT_TIMEOUT;
+    constructor(operation) {
+        super(`AppleScript operation timed out: ${operation}. ` +
+            'This may happen with large data sets. Try reducing the limit.');
+    }
+}
+/**
+ * Thrown for general AppleScript errors.
+ */
+export class AppleScriptError extends OutlookMcpError {
+    cause;
+    code = ErrorCode.APPLESCRIPT_ERROR;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+    }
+}
+// =============================================================================
+// Microsoft Graph API Errors
+// =============================================================================
+/**
+ * Thrown when Microsoft Graph authentication is required.
+ */
+export class GraphAuthRequiredError extends OutlookMcpError {
+    code = ErrorCode.GRAPH_AUTH_REQUIRED;
+    constructor() {
+        super('Microsoft Graph authentication required. ' +
+            'Run: npx @jbctechsolutions/mcp-office365 auth');
+    }
+}
+/**
+ * Thrown when the Graph API rate limit is exceeded.
+ */
+export class GraphRateLimitedError extends OutlookMcpError {
+    code = ErrorCode.GRAPH_RATE_LIMITED;
+    retryAfter;
+    constructor(retryAfter) {
+        super('Microsoft Graph API rate limit exceeded. ' +
+            (retryAfter != null ? `Retry after ${retryAfter} seconds.` : 'Please try again later.'));
+        this.retryAfter = retryAfter;
+    }
+}
+/**
+ * Thrown when the Graph API denies access due to permissions.
+ */
+export class GraphPermissionDeniedError extends OutlookMcpError {
+    code = ErrorCode.GRAPH_PERMISSION_DENIED;
+    constructor(scope) {
+        super('Microsoft Graph permission denied. ' +
+            (scope != null
+                ? `The application needs the '${scope}' permission.`
+                : 'Please check your application permissions in Azure AD.'));
+    }
+}
+/**
+ * Thrown for general Microsoft Graph API errors.
+ */
+export class GraphError extends OutlookMcpError {
+    cause;
+    code = ErrorCode.GRAPH_ERROR;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+    }
+}
+// =============================================================================
+// Event Management and Email Errors
+// =============================================================================
+/**
+ * Thrown when an attachment file cannot be found.
+ */
+export class AttachmentNotFoundError extends OutlookMcpError {
+    code = ErrorCode.ATTACHMENT_NOT_FOUND;
+    constructor(path) {
+        super(`Attachment file not found: ${path}. Please check the file path exists.`);
+    }
+}
+/**
+ * Thrown when an attachment exceeds the size limit.
+ */
+export class AttachmentTooLargeError extends OutlookMcpError {
+    code = ErrorCode.ATTACHMENT_TOO_LARGE;
+    constructor(name, sizeBytes, maxBytes) {
+        super(`Attachment "${name}" is ${Math.round(sizeBytes / 1024 / 1024)}MB ` +
+            `which exceeds the maximum size of ${Math.round(maxBytes / 1024 / 1024)}MB.`);
+    }
+}
+/**
+ * Thrown when saving an attachment to disk fails.
+ */
+export class AttachmentSaveError extends OutlookMcpError {
+    code = ErrorCode.ATTACHMENT_SAVE_ERROR;
+    constructor(name, reason) {
+        super(`Failed to save attachment "${name}": ${reason}`);
+    }
+}
+/**
+ * Thrown when sending an email fails.
+ */
+export class MailSendError extends OutlookMcpError {
+    code = ErrorCode.MAIL_SEND_ERROR;
+    constructor(reason) {
+        super(`Failed to send email: ${reason}`);
+    }
+}
+/**
+ * Thrown when there's an error with recurring events.
+ */
+export class RecurringEventError extends OutlookMcpError {
+    code = ErrorCode.RECURRING_EVENT_ERROR;
+    constructor(message) {
+        super(message);
+    }
+}
+// =============================================================================
+// Approval Errors
+// =============================================================================
+/**
+ * Thrown when an approval token has expired.
+ */
+export class ApprovalExpiredError extends OutlookMcpError {
+    code = ErrorCode.APPROVAL_EXPIRED;
+    constructor() {
+        super('Approval token has expired. Please prepare the operation again.');
+    }
+}
+/**
+ * Thrown when an approval token is invalid.
+ */
+export class ApprovalInvalidError extends OutlookMcpError {
+    code = ErrorCode.APPROVAL_INVALID;
+    constructor(reason) {
+        super(`Invalid approval token: ${reason}`);
+    }
+}
+/**
+ * Thrown when the target has been modified since the approval was generated.
+ */
+export class TargetChangedError extends OutlookMcpError {
+    code = ErrorCode.TARGET_CHANGED;
+    constructor() {
+        super('The target has been modified since the approval was generated. ' +
+            'Please prepare the operation again.');
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * Utility functions and error classes.
+ */
+export { APPLE_EPOCH_OFFSET, appleTimestampToIso, appleTimestampToDate, isoToAppleTimestamp, dateToAppleTimestamp, } from './dates.js';
+export { ErrorCode, OutlookMcpError, DatabaseNotFoundError, DatabaseLockedError, DatabaseError, ContentFileNotFoundError, ContentParseError, ValidationError, NotFoundError, isOutlookMcpError, wrapError, } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AAEH,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,SAAS,EACT,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,SAAS,GACV,MAAM,aAAa,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,10 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * Utility functions and error classes.
+ */
+export { APPLE_EPOCH_OFFSET, appleTimestampToIso, appleTimestampToDate, isoToAppleTimestamp, dateToAppleTimestamp, } from './dates.js';
+export { ErrorCode, OutlookMcpError, DatabaseNotFoundError, DatabaseLockedError, DatabaseError, ContentFileNotFoundError, ContentParseError, ValidationError, NotFoundError, isOutlookMcpError, wrapError, } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AAEH,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,SAAS,EACT,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,SAAS,GACV,MAAM,aAAa,CAAC"}

package/dist/visualization/html.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * Self-contained HTML visualization renderer for Planner data.
+ * All styles are inline -- no external dependencies.
+ */
+import { type PlanVisualizationData } from './types.js';
+/**
+ * Render a Kanban board as self-contained HTML with CSS Grid.
+ */
+export declare function renderKanbanHtml(data: PlanVisualizationData): string;
+/**
+ * Render a Gantt chart as self-contained HTML with CSS positioning.
+ */
+export declare function renderGanttHtml(data: PlanVisualizationData): string;
+/**
+ * Render a summary dashboard as self-contained HTML.
+ */
+export declare function renderSummaryHtml(data: PlanVisualizationData): string;
+/**
+ * Render a burndown chart as self-contained HTML with an inline SVG line chart.
+ */
+export declare function renderBurndownHtml(data: PlanVisualizationData): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/visualization/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/visualization/html.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AAEH,OAAO,EACL,KAAK,qBAAqB,EAI3B,MAAM,YAAY,CAAC;AAcpB;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CA2CpE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CA4EnE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAkFrE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CA2FtE"}