xray-manager 1.1.1 → 1.3.0

package/dist/types/layout.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * Layout Type Definitions
+ *
+ * Core types for terminal layout system supporting responsive layouts
+ * and multi-column displays.
+ *
+ * Feature: 005-ui-layout-expansion
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LAYOUT_MODE_THRESHOLDS = exports.MIN_TERMINAL_SIZE = exports.DEFAULT_LAYOUT = exports.ContentRegionType = exports.LayoutMode = void 0;
+exports.validateLayout = validateLayout;
+exports.validateRegion = validateRegion;
+/**
+ * Layout mode enum - defines different terminal size strategies
+ */
+/* eslint-disable @typescript-eslint/no-unused-vars, no-unused-vars */
+var LayoutMode;
+(function (LayoutMode) {
+    /** Narrow terminals (< 80 columns) */
+    LayoutMode["COMPACT"] = "compact";
+    /** Standard terminals (80-120 columns) */
+    LayoutMode["STANDARD"] = "standard";
+    /** Wide terminals (> 120 columns) */
+    LayoutMode["WIDE"] = "wide";
+})(LayoutMode || (exports.LayoutMode = LayoutMode = {}));
+/* eslint-enable @typescript-eslint/no-unused-vars, no-unused-vars */
+/**
+ * Content region type enum - categorizes different UI regions
+ */
+/* eslint-disable @typescript-eslint/no-unused-vars, no-unused-vars */
+var ContentRegionType;
+(function (ContentRegionType) {
+    /** Page header/title area */
+    ContentRegionType["HEADER"] = "header";
+    /** Menu options area */
+    ContentRegionType["MENU"] = "menu";
+    /** Status information area */
+    ContentRegionType["STATUS"] = "status";
+    /** Main content area */
+    ContentRegionType["CONTENT"] = "content";
+    /** Footer/hints area */
+    ContentRegionType["FOOTER"] = "footer";
+})(ContentRegionType || (exports.ContentRegionType = ContentRegionType = {}));
+/**
+ * Default layout configuration for non-TTY or fallback scenarios
+ */
+exports.DEFAULT_LAYOUT = {
+    width: 80,
+    height: 24,
+    mode: LayoutMode.STANDARD,
+    columns: 1,
+    regions: [],
+    timestamp: 0,
+};
+/**
+ * Minimum terminal size constraints
+ */
+exports.MIN_TERMINAL_SIZE = {
+    width: 60,
+    height: 20,
+};
+/**
+ * Layout mode thresholds for width-based mode selection
+ */
+exports.LAYOUT_MODE_THRESHOLDS = {
+    COMPACT_MAX: 79,
+    STANDARD_MIN: 80,
+    STANDARD_MAX: 120,
+    WIDE_MIN: 121,
+};
+/**
+ * Validate that a TerminalLayout configuration is valid
+ *
+ * @param layout - Layout to validate
+ * @returns true if valid
+ * @throws Error if validation fails
+ */
+function validateLayout(layout) {
+    // 1. Check minimum size
+    if (layout.width < exports.MIN_TERMINAL_SIZE.width || layout.height < exports.MIN_TERMINAL_SIZE.height) {
+        throw new Error(`Terminal too small: ${layout.width}x${layout.height} (min: ${exports.MIN_TERMINAL_SIZE.width}x${exports.MIN_TERMINAL_SIZE.height})`);
+    }
+    // 2. Check mode matches width
+    const expectedMode = layout.width < exports.LAYOUT_MODE_THRESHOLDS.STANDARD_MIN
+        ? LayoutMode.COMPACT
+        : layout.width > exports.LAYOUT_MODE_THRESHOLDS.STANDARD_MAX
+            ? LayoutMode.WIDE
+            : LayoutMode.STANDARD;
+    if (layout.mode !== expectedMode) {
+        throw new Error(`LayoutMode mismatch: expected ${expectedMode} for width ${layout.width}, got ${layout.mode}`);
+    }
+    // 3. Check columns constraint
+    if (layout.mode === LayoutMode.WIDE && layout.columns < 2) {
+        throw new Error(`WIDE mode requires columns >= 2, got ${layout.columns}`);
+    }
+    if (layout.mode !== LayoutMode.WIDE && layout.columns !== 1) {
+        throw new Error(`Non-WIDE mode requires columns = 1, got ${layout.columns}`);
+    }
+    // 4. Validate all content regions
+    for (const region of layout.regions) {
+        validateRegion(region, layout);
+    }
+    return true;
+}
+/**
+ * Validate that a ContentRegion is valid within a given layout
+ *
+ * @param region - Region to validate
+ * @param layout - Parent layout
+ * @returns true if valid
+ * @throws Error if validation fails
+ */
+function validateRegion(region, layout) {
+    // 1. Check position bounds
+    if (region.position.row < 0 || region.position.row >= layout.height) {
+        throw new Error(`Region ${region.id}: row ${region.position.row} out of bounds (0-${layout.height - 1})`);
+    }
+    if (region.position.column < 0 || region.position.column >= layout.width) {
+        throw new Error(`Region ${region.id}: column ${region.position.column} out of bounds (0-${layout.width - 1})`);
+    }
+    // 2. Check size bounds
+    const maxWidth = layout.width - region.position.column;
+    const maxHeight = layout.height - region.position.row;
+    if (region.size.width <= 0 || region.size.width > maxWidth) {
+        throw new Error(`Region ${region.id}: width ${region.size.width} out of bounds (1-${maxWidth})`);
+    }
+    if (region.size.height <= 0 || region.size.height > maxHeight) {
+        throw new Error(`Region ${region.id}: height ${region.size.height} out of bounds (1-${maxHeight})`);
+    }
+    // 3. Check padding validity
+    const totalHorizontalPadding = region.padding.left + region.padding.right;
+    const totalVerticalPadding = region.padding.top + region.padding.bottom;
+    if (totalHorizontalPadding >= region.size.width) {
+        throw new Error(`Region ${region.id}: horizontal padding ${totalHorizontalPadding} >= width ${region.size.width}`);
+    }
+    if (totalVerticalPadding >= region.size.height) {
+        throw new Error(`Region ${region.id}: vertical padding ${totalVerticalPadding} >= height ${region.size.height}`);
+    }
+    return true;
+}
+//# sourceMappingURL=layout.js.map

package/dist/types/layout.js.map

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

package/dist/types/ui-components.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Interface for the Dashboard Widget
+ * Responsible for rendering the persistent status header.
+ */
+export interface IDashboardWidget {
+    /**
+     * Refreshes the internal data snapshot (service status, user count, etc.)
+     */
+    refresh(): Promise<void>;
+    /**
+     * Renders the dashboard as a formatted string string suitable for printing.
+     * Should respect terminal width and use box-drawing characters.
+     * @param width - The available width in columns.
+     */
+    render(_width: number): string;
+}
+export interface IScreenManager {
+    /**
+     * Clears the terminal screen and scrollback (if supported/configured).
+     */
+    clear(): void;
+    /**
+     * Renders the complete frame: Dashboard + Breadcrumb + Content Placeholder
+     * @param dashboard - The dashboard widget instance
+     * @param breadcrumb - The current breadcrumb string
+     */
+    renderHeader(_dashboard: IDashboardWidget, _breadcrumb: string): void;
+}
+/**
+ * Interface for Navigation Manager
+ * Tracks the user's current location in the menu hierarchy.
+ */
+export interface INavigationManager {
+    /**
+     * Pushes a new menu level onto the stack.
+     * @param label - The display label for the new level.
+     */
+    push(_label: string): void;
+    /**
+     * Pops the current level off the stack.
+     * @returns The label of the popped level.
+     */
+    pop(): string | undefined;
+    /**
+     * Returns the formatted breadcrumb string (e.g., "Home > User Management")
+     */
+    getBreadcrumb(): string;
+    /**
+     * Gets the current depth of the stack.
+     */
+    getDepth(): number;
+}
+//# sourceMappingURL=ui-components.d.ts.map

package/dist/types/ui-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-components.d.ts","sourceRoot":"","sources":["../../src/types/ui-components.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;;;OAIG;IACH,YAAY,CAAC,UAAU,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACvE;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;;OAGG;IACH,GAAG,IAAI,MAAM,GAAG,SAAS,CAAC;IAE1B;;OAEG;IACH,aAAa,IAAI,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,IAAI,MAAM,CAAC;CACpB"}

package/dist/types/ui-components.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ui-components.js.map

package/dist/types/ui-components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-components.js","sourceRoot":"","sources":["../../src/types/ui-components.ts"],"names":[],"mappings":""}

package/dist/types/user.d.ts

@@ -21,6 +21,17 @@ export interface User {
     /** 最后修改时间 */
     updatedAt?: string;
 }
+/**
+ * 用户配置（用于显示）
+ */
+export interface UserConfig {
+    username: string;
+    uuid: string;
+    port?: number;
+    protocol?: string;
+    flow?: string;
+    status?: string;
+}
 /**
  * 用户创建参数
  */

package/dist/types/user.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/types/user.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IAEX,eAAe;IACf,KAAK,EAAE,MAAM,CAAC;IAEd,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAElB,0BAA0B;IAC1B,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;IAE9B,eAAe;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IAEd,aAAa;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,eAAe;IACf,KAAK,EAAE,MAAM,CAAC;IAEd,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IAEd,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,eAAe;IACf,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,aAAa;IACb,IAAI,EAAE,IAAI,CAAC;IAEX,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAElB,YAAY;IACZ,aAAa,EAAE,MAAM,CAAC;IAEtB,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC;IAEnB,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IAEjB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IAEjB,iBAAiB;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW;IACX,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IAE/B,WAAW;IACX,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,GAAG,WAAW,CAAC;IAE7C,WAAW;IACX,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAE3B,cAAc;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,cAAc;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,aAAa;IACb,OAAO,EAAE,OAAO,CAAC;IAEjB,WAAW;IACX,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IAEzD,iBAAiB;IACjB,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ,iBAAiB;IACjB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IAEf,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,eAAe;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IAEf,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/types/user.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IAEX,eAAe;IACf,KAAK,EAAE,MAAM,CAAC;IAEd,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAElB,0BAA0B;IAC1B,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;IAE9B,eAAe;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IAEd,aAAa;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,eAAe;IACf,KAAK,EAAE,MAAM,CAAC;IAEd,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IAEd,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,eAAe;IACf,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,aAAa;IACb,IAAI,EAAE,IAAI,CAAC;IAEX,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAElB,YAAY;IACZ,aAAa,EAAE,MAAM,CAAC;IAEtB,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC;IAEnB,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IAEjB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IAEjB,iBAAiB;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW;IACX,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IAE/B,WAAW;IACX,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,GAAG,WAAW,CAAC;IAE7C,WAAW;IACX,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAE3B,cAAc;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,cAAc;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,aAAa;IACb,OAAO,EAAE,OAAO,CAAC;IAEjB,WAAW;IACX,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IAEzD,iBAAiB;IACjB,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ,iBAAiB;IACjB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IAEf,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,eAAe;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IAEf,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/utils/layout.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Layout Utility Functions
+ *
+ * Pure functions for layout calculations, text fitting, and rendering
+ * Feature: 005-ui-layout-expansion
+ */
+/**
+ * Table column definition
+ */
+export interface TableColumn {
+    header: string;
+    key: string;
+    width?: number;
+    align?: 'left' | 'center' | 'right';
+}
+/**
+ * Render options for tables and sections
+ */
+export interface RenderOptions {
+    showBorder?: boolean;
+    borderStyle?: 'single' | 'double' | 'compact';
+    padding?: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+}
+/**
+ * Calculate the display width of a string, accounting for Chinese characters
+ *
+ * Chinese characters (and other full-width characters) occupy 2 columns,
+ * while ASCII characters occupy 1 column.
+ *
+ * @param text - Input text
+ * @returns Display width in terminal columns
+ */
+export declare function calculateDisplayWidth(text: string): number;
+/**
+ * Calculate the width of each column in a multi-column layout
+ *
+ * Formula: (totalWidth - (columns - 1) * gap) / columns
+ *
+ * @param totalWidth - Total available width
+ * @param columns - Number of columns
+ * @param gap - Space between columns
+ * @returns Width of each column (rounded down)
+ */
+export declare function calculateColumnWidth(totalWidth: number, columns: number, gap: number): number;
+/**
+ * Fit text to a specific width by truncating or padding
+ *
+ * @param text - Input text
+ * @param width - Target width in columns
+ * @param align - Alignment ('left', 'center', 'right')
+ * @param ellipsis - Ellipsis string for truncation (default '...')
+ * @returns Text adjusted to exact width
+ */
+export declare function fitText(text: string, width: number, align?: 'left' | 'center' | 'right', ellipsis?: string): string;
+/**
+ * Render a horizontal separator line
+ *
+ * @param width - Width of separator in columns
+ * @param char - Character to use (default '─')
+ * @param color - Optional chalk color name
+ * @returns Separator string
+ */
+export declare function renderSeparator(width: number, char?: string, color?: string): string;
+/**
+ * Render a header with optional alignment and border
+ *
+ * @param title - Header title text
+ * @param width - Total width
+ * @param align - Alignment
+ * @param options - Render options
+ * @returns Rendered header string
+ */
+export declare function renderHeader(title: string, width: number, align?: 'left' | 'center' | 'right', options?: {
+    showBorder?: boolean;
+    color?: string;
+}): string;
+/**
+ * Apply padding to a text block
+ *
+ * @param text - Original text (can be multi-line)
+ * @param padding - Padding configuration
+ * @param width - Target width (for horizontal padding)
+ * @returns Padded text
+ */
+export declare function applyPadding(text: string, padding: {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}, width: number): string;
+/**
+ * Render a table using cli-table3
+ *
+ * @param columns - Column definitions
+ * @param rows - Data rows
+ * @param options - Render options
+ * @returns Rendered table string
+ */
+export declare function renderTable(columns: TableColumn[], rows: Record<string, unknown>[], options?: RenderOptions): string;
+/**
+ * Render a section with title and content
+ *
+ * @param title - Section title
+ * @param content - Section content (can be multi-line)
+ * @param options - Render options
+ * @returns Rendered section string
+ */
+export declare function renderSection(title: string, content: string, options?: RenderOptions): string;
+/**
+ * Distribute items evenly across multiple columns
+ *
+ * @param items - Array of items to distribute
+ * @param columnCount - Number of columns to create
+ * @returns Array of columns, each containing a subset of items
+ *
+ * @example
+ * distributeToColumns(['A', 'B', 'C', 'D', 'E', 'F'], 2)
+ * // Returns: [['A', 'B', 'C'], ['D', 'E', 'F']]
+ *
+ * distributeToColumns(['A', 'B', 'C', 'D', 'E'], 2)
+ * // Returns: [['A', 'B', 'C'], ['D', 'E']]
+ */
+export declare function distributeToColumns<T>(items: T[], columnCount: number): T[][];
+/**
+ * Render multiple columns of text side by side
+ *
+ * @param columns - Array of columns, each containing lines of text
+ * @param totalWidth - Total width available for all columns
+ * @param gap - Space between columns (default: 2)
+ * @returns Rendered multi-column text
+ *
+ * @example
+ * renderColumns([['Line 1', 'Line 2'], ['Col 2 Line 1', 'Col 2 Line 2']], 80, 2)
+ * // Returns text with two columns side by side
+ */
+export declare function renderColumns(columns: string[][], totalWidth: number, gap?: number): string;
+//# sourceMappingURL=layout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/utils/layout.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC9C,OAAO,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAwB1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7F;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAM,GAAG,QAAQ,GAAG,OAAgB,EAC3C,QAAQ,GAAE,MAAc,GACvB,MAAM,CAwCR;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAY,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAczF;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAM,GAAG,QAAQ,GAAG,OAAkB,EAC7C,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACjD,MAAM,CAiBR;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACrE,KAAK,EAAE,MAAM,GACZ,MAAM,CAuBR;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,WAAW,EAAE,EACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,OAAO,CAAC,EAAE,aAAa,GACtB,MAAM,CAkFR;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,aAAa,GACtB,MAAM,CAoDR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAoB7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,MAAU,GAAG,MAAM,CAyB9F"}