@codefrydev/svg-engine 0.1.0

package/dist/wc.d.cts

@@ -0,0 +1,151 @@
+declare function defineSvgEngineComponents(): void;
+
+type ElementType = "select" | "point" | "text" | "line" | "string" | "surface" | "cart" | "disk" | "com" | "particle" | "pivot" | "dashed" | "dashed_line" | "vector" | "ray" | "ground" | "table_edge" | "block" | "sphere" | "shell" | "cylinder" | "slab" | "semicircle" | "quarter_circle" | "cone" | "curved_wedge" | "incline" | "ladder" | "spring" | "pulley" | "rod" | "hinge" | "arc" | "arc_arrow" | "container" | "pipe" | "liquid" | "orbit" | "wire" | "resistor" | "capacitor" | "inductor" | "diode" | "battery" | "meter_v" | "meter_a" | "piston_cylinder" | "heat_engine" | "conduction_rod" | "pv_axes" | "thermo_process" | "carnot_cycle" | "maxwell_boltzmann" | "diatomic_gas" | "random_walk" | "lens_convex" | "lens_concave" | "mirror_concave" | "mirror_convex" | "prism" | "glass_slab" | "slit_double" | "slit_single" | "photon" | "nucleus" | "wedge" | "dimension" | "axes" | "pole_piece" | "b_field_line" | "b_field_curve" | "bezier" | "b_region_in" | "b_region_out" | "current_wire" | "bar_magnet" | "coil" | "meter" | "ac_source" | "axes_3d" | "charge_pos" | "charge_neg" | "dipole" | "charged_plate_pos" | "charged_plate_neg" | "gaussian_sphere" | "gaussian_cylinder" | "mirror_plane" | "energy_level" | "circle" | "ellipse" | "rectangle" | "angle" | "parabola_v" | "parabola_h" | "hyperbola" | "modulus" | "exponential" | "logarithmic" | "sine_wave" | "step_function" | "shaded_area" | "atom" | "charge_plus" | "charge_minus" | "benzene" | "cyclohexane" | "cyclopentane" | "cyclobutane" | "cyclopropane" | "radical" | "lone_pair"
+/** Rotation preset / reference/Rotation.html */
+ | "point_mass" | "block_mass" | "com_indicator" | "system_boundary" | "dashed_path" | "rocket" | "uniform_rod" | "solid_disk" | "hoop_ring" | "rolling_body" | "inclined_wedge" | "curve_arrow"
+/** reference/WaveOcillation.html */
+ | "mass_box" | "pendulum" | "phasor" | "damped_wave" | "vane_liquid" | "torsion_pendulum" | "standing_wave" | "wave_pulse" | "shm_graph" | "energy_graph" | "strobe_shm" | "wall" | "tuning_fork" | "speaker" | "wavefronts" | "mach_cone" | "beats_graph";
+interface ElementData {
+    id: number | string;
+    type: ElementType | string;
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    label?: string;
+    value?: string;
+    color?: string;
+    strokeWidth?: number;
+    fontSize?: number;
+    fillOpacity?: number;
+    lineStyle?: "solid" | "dashed" | "dotted" | string;
+    curveHeight?: number;
+    /** Quadratic/cubic-style control points (e.g. bezier tool). */
+    cps?: {
+        x: number;
+        y: number;
+    }[];
+    showArrow?: boolean;
+    compression?: number;
+    showHeat?: boolean;
+    engineType?: "engine" | "refrigerator" | string;
+    efficiency?: number;
+    processType?: "isotherm" | "adiabatic" | "isobaric" | "isochoric" | string;
+    t1?: number;
+    t2?: number;
+    showRotations?: boolean;
+    steps?: number;
+    rotation?: number;
+    /** Modern physics / energy level diagrams (reference/ElectroStatics.html). */
+    energy?: string;
+    /** P–V axes labels (reference/thermo.html). */
+    xLabel?: string;
+    yLabel?: string;
+    /** Point mass, COM marker, pivot scale (reference/Rotation.html). */
+    size?: number;
+    showVelocity?: boolean;
+    showOmega?: boolean;
+    /** Spring coil count (reference/Rotation.html spring path). */
+    coils?: number;
+    /** Wave / SHM (reference/WaveOcillation.html). */
+    amplitude?: number;
+    loops?: number;
+    graphType?: "x" | "v" | "a" | "all" | string;
+    domain?: "time" | "position" | string;
+    damping?: number;
+    frequency?: number;
+    beatFreq?: number;
+    velocityRatio?: number;
+    rings?: number;
+    machNumber?: number;
+    showForces?: boolean;
+    showProjection?: boolean;
+    [key: string]: unknown;
+}
+interface ToolDef {
+    id: string;
+    name: string;
+}
+interface ToolCategory {
+    name: string;
+    tools: ToolDef[];
+}
+interface Preset {
+    name: string;
+    elements: ElementData[];
+    toolCategories: ToolCategory[];
+}
+
+declare const presets: {
+    mechanics: Preset;
+    circuit: Preset;
+    thermo: Preset;
+    optical: Preset;
+    magnetism: Preset;
+    light: Preset;
+    waves: Preset;
+    waveOscillation: Preset;
+    rotation: Preset;
+    graph: Preset;
+    electrostatics: Preset;
+    chemistry: Preset;
+    mechanical: Preset;
+};
+
+type EditorWindowMode = "floating" | "inline";
+
+type PresetKey = keyof typeof presets;
+declare class CodefrydevSvgEngine extends HTMLElement {
+    static observedAttributes: string[];
+    private root?;
+    private editorRef;
+    /** Overrides parsed `data` attribute when set from JS. */
+    private _elements;
+    private _preset;
+    private _mode;
+    private _viewMode;
+    /** Keeps Editor from resetting on unrelated attribute updates (e.g. title). */
+    private committedInitial;
+    private pendingReseed;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string): void;
+    get elements(): ElementData[];
+    set elements(els: ElementData[]);
+    get preset(): PresetKey | undefined;
+    set preset(v: PresetKey | undefined);
+    get mode(): EditorWindowMode;
+    set mode(v: EditorWindowMode);
+    get viewMode(): boolean;
+    set viewMode(v: boolean);
+    getData(): ElementData[];
+    setData(els: ElementData[]): void;
+    toJSON(): string;
+    clear(): void;
+    minimize(): void;
+    maximize(): void;
+    restore(): void;
+    close(): void;
+    private readParsedInitial;
+    private render;
+}
+
+declare class CodefrydevSvgEnginePrev extends HTMLElement {
+    static observedAttributes: string[];
+    private root?;
+    private svgRef;
+    private _elements;
+    private _showGrid;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+    get elements(): ElementData[];
+    set elements(els: ElementData[]);
+    get showGrid(): boolean;
+    set showGrid(v: boolean);
+    setData(els: ElementData[]): void;
+    toSvg(): string;
+    private render;
+}
+
+export { CodefrydevSvgEngine, CodefrydevSvgEnginePrev, type PresetKey, defineSvgEngineComponents };

package/dist/wc.d.ts

@@ -0,0 +1,151 @@
+declare function defineSvgEngineComponents(): void;
+
+type ElementType = "select" | "point" | "text" | "line" | "string" | "surface" | "cart" | "disk" | "com" | "particle" | "pivot" | "dashed" | "dashed_line" | "vector" | "ray" | "ground" | "table_edge" | "block" | "sphere" | "shell" | "cylinder" | "slab" | "semicircle" | "quarter_circle" | "cone" | "curved_wedge" | "incline" | "ladder" | "spring" | "pulley" | "rod" | "hinge" | "arc" | "arc_arrow" | "container" | "pipe" | "liquid" | "orbit" | "wire" | "resistor" | "capacitor" | "inductor" | "diode" | "battery" | "meter_v" | "meter_a" | "piston_cylinder" | "heat_engine" | "conduction_rod" | "pv_axes" | "thermo_process" | "carnot_cycle" | "maxwell_boltzmann" | "diatomic_gas" | "random_walk" | "lens_convex" | "lens_concave" | "mirror_concave" | "mirror_convex" | "prism" | "glass_slab" | "slit_double" | "slit_single" | "photon" | "nucleus" | "wedge" | "dimension" | "axes" | "pole_piece" | "b_field_line" | "b_field_curve" | "bezier" | "b_region_in" | "b_region_out" | "current_wire" | "bar_magnet" | "coil" | "meter" | "ac_source" | "axes_3d" | "charge_pos" | "charge_neg" | "dipole" | "charged_plate_pos" | "charged_plate_neg" | "gaussian_sphere" | "gaussian_cylinder" | "mirror_plane" | "energy_level" | "circle" | "ellipse" | "rectangle" | "angle" | "parabola_v" | "parabola_h" | "hyperbola" | "modulus" | "exponential" | "logarithmic" | "sine_wave" | "step_function" | "shaded_area" | "atom" | "charge_plus" | "charge_minus" | "benzene" | "cyclohexane" | "cyclopentane" | "cyclobutane" | "cyclopropane" | "radical" | "lone_pair"
+/** Rotation preset / reference/Rotation.html */
+ | "point_mass" | "block_mass" | "com_indicator" | "system_boundary" | "dashed_path" | "rocket" | "uniform_rod" | "solid_disk" | "hoop_ring" | "rolling_body" | "inclined_wedge" | "curve_arrow"
+/** reference/WaveOcillation.html */
+ | "mass_box" | "pendulum" | "phasor" | "damped_wave" | "vane_liquid" | "torsion_pendulum" | "standing_wave" | "wave_pulse" | "shm_graph" | "energy_graph" | "strobe_shm" | "wall" | "tuning_fork" | "speaker" | "wavefronts" | "mach_cone" | "beats_graph";
+interface ElementData {
+    id: number | string;
+    type: ElementType | string;
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    label?: string;
+    value?: string;
+    color?: string;
+    strokeWidth?: number;
+    fontSize?: number;
+    fillOpacity?: number;
+    lineStyle?: "solid" | "dashed" | "dotted" | string;
+    curveHeight?: number;
+    /** Quadratic/cubic-style control points (e.g. bezier tool). */
+    cps?: {
+        x: number;
+        y: number;
+    }[];
+    showArrow?: boolean;
+    compression?: number;
+    showHeat?: boolean;
+    engineType?: "engine" | "refrigerator" | string;
+    efficiency?: number;
+    processType?: "isotherm" | "adiabatic" | "isobaric" | "isochoric" | string;
+    t1?: number;
+    t2?: number;
+    showRotations?: boolean;
+    steps?: number;
+    rotation?: number;
+    /** Modern physics / energy level diagrams (reference/ElectroStatics.html). */
+    energy?: string;
+    /** P–V axes labels (reference/thermo.html). */
+    xLabel?: string;
+    yLabel?: string;
+    /** Point mass, COM marker, pivot scale (reference/Rotation.html). */
+    size?: number;
+    showVelocity?: boolean;
+    showOmega?: boolean;
+    /** Spring coil count (reference/Rotation.html spring path). */
+    coils?: number;
+    /** Wave / SHM (reference/WaveOcillation.html). */
+    amplitude?: number;
+    loops?: number;
+    graphType?: "x" | "v" | "a" | "all" | string;
+    domain?: "time" | "position" | string;
+    damping?: number;
+    frequency?: number;
+    beatFreq?: number;
+    velocityRatio?: number;
+    rings?: number;
+    machNumber?: number;
+    showForces?: boolean;
+    showProjection?: boolean;
+    [key: string]: unknown;
+}
+interface ToolDef {
+    id: string;
+    name: string;
+}
+interface ToolCategory {
+    name: string;
+    tools: ToolDef[];
+}
+interface Preset {
+    name: string;
+    elements: ElementData[];
+    toolCategories: ToolCategory[];
+}
+
+declare const presets: {
+    mechanics: Preset;
+    circuit: Preset;
+    thermo: Preset;
+    optical: Preset;
+    magnetism: Preset;
+    light: Preset;
+    waves: Preset;
+    waveOscillation: Preset;
+    rotation: Preset;
+    graph: Preset;
+    electrostatics: Preset;
+    chemistry: Preset;
+    mechanical: Preset;
+};
+
+type EditorWindowMode = "floating" | "inline";
+
+type PresetKey = keyof typeof presets;
+declare class CodefrydevSvgEngine extends HTMLElement {
+    static observedAttributes: string[];
+    private root?;
+    private editorRef;
+    /** Overrides parsed `data` attribute when set from JS. */
+    private _elements;
+    private _preset;
+    private _mode;
+    private _viewMode;
+    /** Keeps Editor from resetting on unrelated attribute updates (e.g. title). */
+    private committedInitial;
+    private pendingReseed;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string): void;
+    get elements(): ElementData[];
+    set elements(els: ElementData[]);
+    get preset(): PresetKey | undefined;
+    set preset(v: PresetKey | undefined);
+    get mode(): EditorWindowMode;
+    set mode(v: EditorWindowMode);
+    get viewMode(): boolean;
+    set viewMode(v: boolean);
+    getData(): ElementData[];
+    setData(els: ElementData[]): void;
+    toJSON(): string;
+    clear(): void;
+    minimize(): void;
+    maximize(): void;
+    restore(): void;
+    close(): void;
+    private readParsedInitial;
+    private render;
+}
+
+declare class CodefrydevSvgEnginePrev extends HTMLElement {
+    static observedAttributes: string[];
+    private root?;
+    private svgRef;
+    private _elements;
+    private _showGrid;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+    get elements(): ElementData[];
+    set elements(els: ElementData[]);
+    get showGrid(): boolean;
+    set showGrid(v: boolean);
+    setData(els: ElementData[]): void;
+    toSvg(): string;
+    private render;
+}
+
+export { CodefrydevSvgEngine, CodefrydevSvgEnginePrev, type PresetKey, defineSvgEngineComponents };