manim-web 0.2.0

package/dist/mobjects/geometry/LabeledGeometry.d.ts

@@ -0,0 +1,372 @@
+import { Vector3Tuple } from '../../core/Mobject';
+import { VGroup } from '../../core/VGroup';
+import { Line, LineOptions } from './Line';
+import { Arrow, ArrowOptions } from './Arrow';
+import { Dot, DotOptions } from './Dot';
+import { Circle } from './Circle';
+import { Text } from '../text/Text';
+/**
+ * Direction constants for label positioning
+ */
+export type LabelDirection = 'UP' | 'DOWN' | 'LEFT' | 'RIGHT' | 'UL' | 'UR' | 'DL' | 'DR';
+/**
+ * Label orientation options for lines
+ */
+export type LabelOrientation = 'parallel' | 'perpendicular' | 'horizontal';
+/**
+ * Options for creating a LabeledLine
+ */
+export interface LabeledLineOptions extends Omit<LineOptions, 'start' | 'end'> {
+    /** Start point of the line. Default: [0, 0, 0] */
+    start?: Vector3Tuple;
+    /** End point of the line. Default: [1, 0, 0] */
+    end?: Vector3Tuple;
+    /** Text label content */
+    label: string;
+    /** Position of label along line (0 = start, 0.5 = midpoint, 1 = end). Default: 0.5 */
+    labelPosition?: number;
+    /** Label orientation relative to line. Default: 'parallel' */
+    labelOrientation?: LabelOrientation;
+    /** Distance of label from line. Default: 0.2 */
+    labelOffset?: number;
+    /** Font size for label. Default: 36 */
+    labelFontSize?: number;
+    /** Color for label text. Default: same as line color */
+    labelColor?: string;
+}
+/**
+ * LabeledLine - A line with an attached text label
+ *
+ * Creates a line segment with a text label positioned at a specified point
+ * along the line (default: midpoint). The label can be oriented parallel
+ * or perpendicular to the line.
+ *
+ * @example
+ * ```typescript
+ * // Create a labeled line at midpoint
+ * const line = new LabeledLine({
+ *   start: [-2, 0, 0],
+ *   end: [2, 0, 0],
+ *   label: 'Distance = 4'
+ * });
+ *
+ * // Label perpendicular to line
+ * const perpLine = new LabeledLine({
+ *   start: [0, -1, 0],
+ *   end: [0, 2, 0],
+ *   label: 'Height',
+ *   labelOrientation: 'perpendicular',
+ *   labelOffset: 0.3
+ * });
+ * ```
+ */
+export declare class LabeledLine extends VGroup {
+    private _line;
+    private _label;
+    private _labelPosition;
+    private _labelOrientation;
+    private _labelOffset;
+    constructor(options: LabeledLineOptions);
+    /**
+     * Update the label position and orientation based on line geometry
+     */
+    private _updateLabelPosition;
+    /**
+     * Get the underlying Line mobject
+     */
+    getLine(): Line;
+    /**
+     * Get the Text label mobject
+     */
+    getLabel(): Text;
+    /**
+     * Set the label text
+     */
+    setLabelText(text: string): this;
+    /**
+     * Set the label position along the line
+     */
+    setLabelPosition(position: number): this;
+    /**
+     * Set the label offset from the line
+     */
+    setLabelOffset(offset: number): this;
+    /**
+     * Update line endpoints and reposition label
+     */
+    setEndpoints(start: Vector3Tuple, end: Vector3Tuple): this;
+    /**
+     * Create a copy of this LabeledLine
+     */
+    protected _createCopy(): LabeledLine;
+}
+/**
+ * Options for creating a LabeledArrow
+ */
+export interface LabeledArrowOptions extends Omit<ArrowOptions, 'start' | 'end'> {
+    /** Start point of the arrow. Default: [0, 0, 0] */
+    start?: Vector3Tuple;
+    /** End point of the arrow (where the tip points). Default: [1, 0, 0] */
+    end?: Vector3Tuple;
+    /** Text label content */
+    label: string;
+    /** Position of label along arrow (0 = start, 0.5 = midpoint, 1 = end). Default: 0.5 */
+    labelPosition?: number;
+    /** Label orientation relative to arrow. Default: 'parallel' */
+    labelOrientation?: LabelOrientation;
+    /** Distance of label from arrow. Default: 0.25 */
+    labelOffset?: number;
+    /** Font size for label. Default: 36 */
+    labelFontSize?: number;
+    /** Color for label text. Default: same as arrow color */
+    labelColor?: string;
+}
+/**
+ * LabeledArrow - An arrow with an attached text label
+ *
+ * Creates an arrow with a text label positioned near the arrow body.
+ *
+ * @example
+ * ```typescript
+ * // Create a labeled arrow
+ * const arrow = new LabeledArrow({
+ *   start: [-2, 0, 0],
+ *   end: [2, 0, 0],
+ *   label: 'Force F'
+ * });
+ *
+ * // Label near the tip
+ * const tipArrow = new LabeledArrow({
+ *   start: [0, 0, 0],
+ *   end: [3, 1, 0],
+ *   label: 'v',
+ *   labelPosition: 0.7
+ * });
+ * ```
+ */
+export declare class LabeledArrow extends VGroup {
+    private _arrow;
+    private _label;
+    private _labelPosition;
+    private _labelOrientation;
+    private _labelOffset;
+    constructor(options: LabeledArrowOptions);
+    /**
+     * Update the label position and orientation based on arrow geometry
+     */
+    private _updateLabelPosition;
+    /**
+     * Get the underlying Arrow mobject
+     */
+    getArrow(): Arrow;
+    /**
+     * Get the Text label mobject
+     */
+    getLabel(): Text;
+    /**
+     * Set the label text
+     */
+    setLabelText(text: string): this;
+    /**
+     * Set the label position along the arrow
+     */
+    setLabelPosition(position: number): this;
+    /**
+     * Set the label offset from the arrow
+     */
+    setLabelOffset(offset: number): this;
+    /**
+     * Update arrow endpoints and reposition label
+     */
+    setEndpoints(start: Vector3Tuple, end: Vector3Tuple): this;
+    /**
+     * Create a copy of this LabeledArrow
+     */
+    protected _createCopy(): LabeledArrow;
+}
+/**
+ * Options for creating a LabeledDot
+ */
+export interface LabeledDotOptions extends Omit<DotOptions, 'point'> {
+    /** Position of the dot. Default: [0, 0, 0] */
+    point?: Vector3Tuple;
+    /** Text label content */
+    label: string;
+    /** Direction of label relative to dot. Default: 'UP' */
+    labelDirection?: LabelDirection;
+    /** Distance of label from dot center. Default: 0.3 */
+    labelOffset?: number;
+    /** Font size for label. Default: 36 */
+    labelFontSize?: number;
+    /** Color for label text. Default: white */
+    labelColor?: string;
+}
+/**
+ * LabeledDot - A dot with an attached text label
+ *
+ * Creates a small filled circle (dot) with a text label positioned
+ * in a specified direction relative to the dot.
+ *
+ * @example
+ * ```typescript
+ * // Create a labeled point
+ * const pointA = new LabeledDot({
+ *   point: [1, 2, 0],
+ *   label: 'A',
+ *   labelDirection: 'UR'
+ * });
+ *
+ * // Label below the dot
+ * const pointB = new LabeledDot({
+ *   point: [-1, 0, 0],
+ *   label: 'B',
+ *   labelDirection: 'DOWN',
+ *   labelOffset: 0.4
+ * });
+ * ```
+ */
+export declare class LabeledDot extends VGroup {
+    private _dot;
+    private _label;
+    private _labelDirection;
+    private _labelOffset;
+    constructor(options: LabeledDotOptions);
+    /**
+     * Update the label position based on dot position and direction
+     */
+    private _updateLabelPosition;
+    /**
+     * Get the underlying Dot mobject
+     */
+    getDot(): Dot;
+    /**
+     * Get the Text label mobject
+     */
+    getLabel(): Text;
+    /**
+     * Move the dot and label to a new position
+     */
+    moveTo(point: Vector3Tuple): this;
+    /**
+     * Set the label text
+     */
+    setLabelText(text: string): this;
+    /**
+     * Set the label direction
+     */
+    setLabelDirection(direction: LabelDirection): this;
+    /**
+     * Set the label offset from the dot
+     */
+    setLabelOffset(offset: number): this;
+    /**
+     * Get the position of the dot
+     */
+    getPoint(): Vector3Tuple;
+    /**
+     * Create a copy of this LabeledDot
+     */
+    protected _createCopy(): LabeledDot;
+}
+/**
+ * Options for creating an AnnotationDot
+ */
+export interface AnnotationDotOptions extends Omit<DotOptions, 'point'> {
+    /** Position of the dot. Default: [0, 0, 0] */
+    point?: Vector3Tuple;
+    /** Optional text label content */
+    label?: string;
+    /** Direction of label relative to dot. Default: 'UR' */
+    labelDirection?: LabelDirection;
+    /** Distance of label from dot center. Default: 0.4 */
+    labelOffset?: number;
+    /** Font size for label. Default: 36 */
+    labelFontSize?: number;
+    /** Color for label text. Default: same as dot color */
+    labelColor?: string;
+    /** Whether to show outline/glow effect. Default: true */
+    showOutline?: boolean;
+    /** Color of the outline. Default: same as dot color with lower opacity */
+    outlineColor?: string;
+    /** Scale of the outline relative to dot. Default: 1.5 */
+    outlineScale?: number;
+    /** Opacity of the outline. Default: 0.3 */
+    outlineOpacity?: number;
+}
+/**
+ * AnnotationDot - A larger, more visible dot for annotations
+ *
+ * Creates a prominent dot with optional outline/glow effect and text label.
+ * Useful for marking important points in visualizations.
+ *
+ * @example
+ * ```typescript
+ * // Create an annotation dot with glow
+ * const annotDot = new AnnotationDot({
+ *   point: [2, 1, 0],
+ *   label: 'Critical Point',
+ *   color: '#ff0000'
+ * });
+ *
+ * // Without outline
+ * const simpleAnnot = new AnnotationDot({
+ *   point: [0, 0, 0],
+ *   showOutline: false,
+ *   label: 'Origin'
+ * });
+ * ```
+ */
+export declare class AnnotationDot extends VGroup {
+    private _dot;
+    private _outline;
+    private _label;
+    private _labelDirection;
+    private _labelOffset;
+    private _showOutline;
+    constructor(options?: AnnotationDotOptions);
+    /**
+     * Update the label position based on dot position and direction
+     */
+    private _updateLabelPosition;
+    /**
+     * Get the underlying Dot mobject
+     */
+    getDot(): Dot;
+    /**
+     * Get the outline Circle (if enabled)
+     */
+    getOutline(): Circle | null;
+    /**
+     * Get the Text label mobject (if set)
+     */
+    getLabel(): Text | null;
+    /**
+     * Move the dot (and outline/label) to a new position
+     */
+    moveTo(point: Vector3Tuple): this;
+    /**
+     * Set the label text
+     */
+    setLabelText(text: string): this;
+    /**
+     * Set the label direction
+     */
+    setLabelDirection(direction: LabelDirection): this;
+    /**
+     * Set the label offset from the dot
+     */
+    setLabelOffset(offset: number): this;
+    /**
+     * Get the position of the dot
+     */
+    getPoint(): Vector3Tuple;
+    /**
+     * Show or hide the outline
+     */
+    setShowOutline(show: boolean): this;
+    /**
+     * Create a copy of this AnnotationDot
+     */
+    protected _createCopy(): AnnotationDot;
+}
+//# sourceMappingURL=LabeledGeometry.d.ts.map

package/dist/mobjects/geometry/LabeledGeometry.d.ts.map

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

package/dist/mobjects/geometry/Line.d.ts

@@ -0,0 +1,83 @@
+import { VMobject } from '../../core/VMobject';
+import { Vector3Tuple } from '../../core/Mobject';
+/**
+ * Options for creating a Line
+ */
+export interface LineOptions {
+    /** Start point of the line. Default: [0, 0, 0] */
+    start?: Vector3Tuple;
+    /** End point of the line. Default: [1, 0, 0] */
+    end?: Vector3Tuple;
+    /** Stroke color as CSS color string. Default: WHITE */
+    color?: string;
+    /** Stroke width in pixels. Default: 4 (Manim's default) */
+    strokeWidth?: number;
+}
+/**
+ * Line - A straight line segment VMobject
+ *
+ * Creates a simple line from a start point to an end point.
+ *
+ * @example
+ * ```typescript
+ * // Create a horizontal line
+ * const line = new Line();
+ *
+ * // Create a diagonal line
+ * const diagonal = new Line({
+ *   start: [-1, -1, 0],
+ *   end: [1, 1, 0],
+ *   color: '#00ff00'
+ * });
+ * ```
+ */
+export declare class Line extends VMobject {
+    private _start;
+    private _end;
+    constructor(options?: LineOptions);
+    /**
+     * Generate the line points as a degenerate cubic Bezier
+     */
+    private _generatePoints;
+    /**
+     * Get the start point (derived from transformed _points3D when available)
+     */
+    getStart(): Vector3Tuple;
+    /**
+     * Set the start point
+     */
+    setStart(point: Vector3Tuple): this;
+    /**
+     * Get the end point (derived from transformed _points3D when available)
+     */
+    getEnd(): Vector3Tuple;
+    /**
+     * Set the end point
+     */
+    setEnd(point: Vector3Tuple): this;
+    /**
+     * Get the length of the line
+     */
+    getLength(): number;
+    /**
+     * Get the midpoint of the line
+     */
+    getMidpoint(): Vector3Tuple;
+    /**
+     * Get the direction vector of the line (normalized)
+     */
+    getDirection(): Vector3Tuple;
+    /**
+     * Get the angle of the line in the XY plane (in radians)
+     */
+    getAngle(): number;
+    /**
+     * Get a point along the line at parameter t (0 = start, 1 = end)
+     */
+    pointAlongPath(t: number): Vector3Tuple;
+    /**
+     * Create a copy of this Line
+     */
+    protected _createCopy(): Line;
+}
+//# sourceMappingURL=Line.d.ts.map

package/dist/mobjects/geometry/Line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Line.d.ts","sourceRoot":"","sources":["../../../src/mobjects/geometry/Line.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,gDAAgD;IAChD,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,IAAK,SAAQ,QAAQ;IAChC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,IAAI,CAAe;gBAEf,OAAO,GAAE,WAAgB;IAoBrC;;OAEG;IACH,OAAO,CAAC,eAAe;IAsBvB;;OAEG;IACH,QAAQ,IAAI,YAAY;IAQxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAMnC;;OAEG;IACH,MAAM,IAAI,YAAY;IAQtB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAMjC;;OAEG;IACH,SAAS,IAAI,MAAM;IAOnB;;OAEG;IACH,WAAW,IAAI,YAAY;IAQ3B;;OAEG;IACH,YAAY,IAAI,YAAY;IAY5B;;OAEG;IACH,QAAQ,IAAI,MAAM;IAOlB;;OAEG;IACH,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,YAAY;IAQvC;;OAEG;cACgB,WAAW,IAAI,IAAI;CAQvC"}

package/dist/mobjects/geometry/Polygon.d.ts

@@ -0,0 +1,155 @@
+import { VMobject } from '../../core/VMobject';
+import { Vector3Tuple } from '../../core/Mobject';
+/**
+ * Options for creating a Polygon
+ */
+export interface PolygonOptions {
+    /** Array of vertices defining the polygon. Required. */
+    vertices: Vector3Tuple[];
+    /** Stroke color as CSS color string. Default: Manim's blue (#58C4DD) */
+    color?: string;
+    /** Fill opacity from 0 to 1. Default: 0 */
+    fillOpacity?: number;
+    /** Stroke width in pixels. Default: 4 (Manim's default) */
+    strokeWidth?: number;
+    /** Whether to close the polygon. Default: true */
+    closed?: boolean;
+}
+/**
+ * Polygon - A polygonal VMobject defined by vertices
+ *
+ * Creates a polygon by connecting a series of vertices with line segments.
+ *
+ * @example
+ * ```typescript
+ * // Create a triangle
+ * const triangle = new Polygon({
+ *   vertices: [
+ *     [0, 1, 0],
+ *     [-1, -0.5, 0],
+ *     [1, -0.5, 0]
+ *   ]
+ * });
+ *
+ * // Create an open path (not closed)
+ * const path = new Polygon({
+ *   vertices: [[0, 0, 0], [1, 1, 0], [2, 0, 0]],
+ *   closed: false
+ * });
+ * ```
+ */
+export declare class Polygon extends VMobject {
+    private _vertices;
+    private _closed;
+    constructor(options: PolygonOptions);
+    /**
+     * Generate the polygon points from vertices as line segments
+     */
+    private _generatePoints;
+    /**
+     * Get the vertices of the polygon
+     */
+    getVertices(): Vector3Tuple[];
+    /**
+     * Set the vertices of the polygon
+     */
+    setVertices(vertices: Vector3Tuple[]): this;
+    /**
+     * Get whether the polygon is closed
+     */
+    isClosed(): boolean;
+    /**
+     * Set whether the polygon is closed
+     */
+    setClosed(value: boolean): this;
+    /**
+     * Get the number of vertices
+     */
+    getVertexCount(): number;
+    /**
+     * Get a specific vertex by index
+     */
+    getVertex(index: number): Vector3Tuple;
+    /**
+     * Set a specific vertex by index
+     */
+    setVertex(index: number, point: Vector3Tuple): this;
+    /**
+     * Get the centroid of the polygon
+     */
+    getCentroid(): Vector3Tuple;
+    /**
+     * Calculate the area of the polygon using the Shoelace formula (2D, in XY plane)
+     * Returns a positive value for counter-clockwise vertices, negative for clockwise
+     */
+    getSignedArea(): number;
+    /**
+     * Get the area of the polygon (absolute value)
+     */
+    getArea(): number;
+    /**
+     * Get the perimeter of the polygon
+     */
+    getPerimeter(): number;
+    /**
+     * Create a copy of this Polygon
+     */
+    protected _createCopy(): Polygon;
+}
+/**
+ * Triangle - A polygon with exactly 3 vertices
+ */
+export declare class Triangle extends Polygon {
+    constructor(options?: Omit<PolygonOptions, 'vertices' | 'closed'> & {
+        vertices?: [Vector3Tuple, Vector3Tuple, Vector3Tuple];
+    });
+}
+/**
+ * RegularPolygon - A polygon with all sides equal and all angles equal
+ */
+export declare class RegularPolygon extends Polygon {
+    private _numSides;
+    private _radius;
+    constructor(options?: Omit<PolygonOptions, 'vertices' | 'closed'> & {
+        numSides?: number;
+        radius?: number;
+        center?: Vector3Tuple;
+        startAngle?: number;
+    });
+    private static _generateVertices;
+    /**
+     * Get the number of sides
+     */
+    getNumSides(): number;
+    /**
+     * Get the radius (circumradius)
+     */
+    getPolygonRadius(): number;
+    /**
+     * Get the apothem (inradius)
+     */
+    getApothem(): number;
+    /**
+     * Get the side length
+     */
+    getSideLength(): number;
+}
+/**
+ * Hexagon - A regular hexagon (6 sides)
+ */
+export declare class Hexagon extends RegularPolygon {
+    constructor(options?: Omit<PolygonOptions, 'vertices' | 'closed'> & {
+        radius?: number;
+        center?: Vector3Tuple;
+    });
+}
+/**
+ * Pentagon - A regular pentagon (5 sides)
+ */
+export declare class Pentagon extends RegularPolygon {
+    constructor(options?: Omit<PolygonOptions, 'vertices' | 'closed'> & {
+        radius?: number;
+        center?: Vector3Tuple;
+    });
+}
+//# sourceMappingURL=Polygon.d.ts.map

package/dist/mobjects/geometry/Polygon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Polygon.d.ts","sourceRoot":"","sources":["../../../src/mobjects/geometry/Polygon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,OAAQ,SAAQ,QAAQ;IACnC,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,OAAO,CAAU;gBAEb,OAAO,EAAE,cAAc;IAyBnC;;OAEG;IACH,OAAO,CAAC,eAAe;IAoCvB;;OAEG;IACH,WAAW,IAAI,YAAY,EAAE;IAI7B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;IAS3C;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAM/B;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY;IAOtC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IASnD;;OAEG;IACH,WAAW,IAAI,YAAY;IAsB3B;;;OAGG;IACH,aAAa,IAAI,MAAM;IAiBvB;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,YAAY,IAAI,MAAM;IAqBtB;;OAEG;cACgB,WAAW,IAAI,OAAO;CAS1C;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,OAAO;gBAEjC,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,UAAU,GAAG,QAAQ,CAAC,GAAG;QACrD,QAAQ,CAAC,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;KAClD;CAaT;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,OAAO;IACzC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;gBAGtB,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,UAAU,GAAG,QAAQ,CAAC,GAAG;QACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,YAAY,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KAChB;IAiBR,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAqBhC;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,aAAa,IAAI,MAAM;CAGxB;AAED;;GAEG;AACH,qBAAa,OAAQ,SAAQ,cAAc;gBAEvC,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,UAAU,GAAG,QAAQ,CAAC,GAAG;QACrD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,YAAY,CAAC;KAClB;CAIT;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,cAAc;gBAExC,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,UAAU,GAAG,QAAQ,CAAC,GAAG;QACrD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,YAAY,CAAC;KAClB;CAIT"}