vizcraft 0.1.1

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> vizcraft@0.1.1 build /home/runner/work/vizcraft/vizcraft/packages/core
+> tsc
+

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# vizcraft
+
+## 0.1.1
+
+### Patch Changes
+
+- [`0d9ea7c`](https://github.com/ChipiKaf/vizcraft/commit/0d9ea7c4a59ef8d629b0c126b709f331d0c15e20) Thanks [@ChipiKaf](https://github.com/ChipiKaf)! - update access in config to public
+
+## 0.1.0
+
+### Minor Changes
+
+- [`184a4ae`](https://github.com/ChipiKaf/vizcraft/commit/184a4ae8d664aeb96296f73a5975a900a6155ad9) Thanks [@ChipiKaf](https://github.com/ChipiKaf)! - Initial release of Vizcraft, a fluent, type-safe SVG scene builder for composing nodes, edges, animations, and overlays with incremental DOM updates and no framework dependency.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chipili Kafwilo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/animations.d.ts

@@ -0,0 +1,22 @@
+import type { VizNode, VizEdge, VizAnimSpec } from './types';
+export interface CoreAnimRendererContext<T = any> {
+    spec: VizAnimSpec<T>;
+    element: VizNode | VizEdge;
+}
+export interface CoreAnimRenderer<T = any> {
+    getClass?: (ctx: CoreAnimRendererContext<T>) => string;
+    getStyle?: (ctx: CoreAnimRendererContext<T>) => Record<string, string | number>;
+}
+export declare class CoreAnimationRegistry {
+    private nodeAnims;
+    private edgeAnims;
+    constructor();
+    registerNode(id: string, renderer: CoreAnimRenderer): this;
+    registerEdge(id: string, renderer: CoreAnimRenderer): this;
+    getNodeRenderer(id: string): CoreAnimRenderer | undefined;
+    getEdgeRenderer(id: string): CoreAnimRenderer | undefined;
+}
+export declare const coreFlowAnimation: CoreAnimRenderer<{
+    duration?: string;
+}>;
+export declare const defaultCoreAnimationRegistry: CoreAnimationRegistry;

package/dist/animations.js

@@ -0,0 +1,30 @@
+export class CoreAnimationRegistry {
+    nodeAnims = new Map();
+    edgeAnims = new Map();
+    constructor() { }
+    registerNode(id, renderer) {
+        this.nodeAnims.set(id, renderer);
+        return this;
+    }
+    registerEdge(id, renderer) {
+        this.edgeAnims.set(id, renderer);
+        return this;
+    }
+    getNodeRenderer(id) {
+        return this.nodeAnims.get(id);
+    }
+    getEdgeRenderer(id) {
+        return this.edgeAnims.get(id);
+    }
+}
+// Default Implementations
+export const coreFlowAnimation = {
+    getClass: () => 'viz-anim-flow',
+    getStyle: ({ spec }) => {
+        const duration = spec.params?.duration ?? '2s';
+        return {
+            '--viz-anim-duration': duration,
+        };
+    },
+};
+export const defaultCoreAnimationRegistry = new CoreAnimationRegistry().registerEdge('flow', coreFlowAnimation);

package/dist/builder.d.ts

@@ -0,0 +1,55 @@
+import type { VizScene, VizNode, VizEdge, NodeLabel, EdgeLabel, AnimationConfig, VizGridConfig } from './types';
+interface VizBuilder {
+    view(w: number, h: number): VizBuilder;
+    grid(cols: number, rows: number, padding?: {
+        x: number;
+        y: number;
+    }): VizBuilder;
+    overlay<T>(id: string, params: T, key?: string): VizBuilder;
+    node(id: string): NodeBuilder;
+    edge(from: string, to: string, id?: string): EdgeBuilder;
+    build(): VizScene;
+    _getGridConfig(): VizGridConfig | null;
+    _getViewBox(): {
+        w: number;
+        h: number;
+    };
+    svg(): string;
+    mount(container: HTMLElement): void;
+}
+interface NodeBuilder {
+    at(x: number, y: number): NodeBuilder;
+    cell(col: number, row: number, align?: 'center' | 'start' | 'end'): NodeBuilder;
+    circle(r: number): NodeBuilder;
+    rect(w: number, h: number, rx?: number): NodeBuilder;
+    diamond(w: number, h: number): NodeBuilder;
+    label(text: string, opts?: Partial<NodeLabel>): NodeBuilder;
+    class(name: string): NodeBuilder;
+    animate(type: string, config?: AnimationConfig): NodeBuilder;
+    data(payload: unknown): NodeBuilder;
+    onClick(handler: (id: string, node: VizNode) => void): NodeBuilder;
+    done(): VizBuilder;
+    node(id: string): NodeBuilder;
+    edge(from: string, to: string, id?: string): EdgeBuilder;
+    overlay<T>(id: string, params: T, key?: string): VizBuilder;
+    build(): VizScene;
+    svg(): string;
+}
+interface EdgeBuilder {
+    straight(): EdgeBuilder;
+    label(text: string, opts?: Partial<EdgeLabel>): EdgeBuilder;
+    arrow(enabled?: boolean): EdgeBuilder;
+    class(name: string): EdgeBuilder;
+    hitArea(px: number): EdgeBuilder;
+    animate(type: string, config?: AnimationConfig): EdgeBuilder;
+    data(payload: unknown): EdgeBuilder;
+    onClick(handler: (id: string, edge: VizEdge) => void): EdgeBuilder;
+    done(): VizBuilder;
+    node(id: string): NodeBuilder;
+    edge(from: string, to: string, id?: string): EdgeBuilder;
+    overlay<T>(id: string, params: T, key?: string): VizBuilder;
+    build(): VizScene;
+    svg(): string;
+}
+export declare function viz(): VizBuilder;
+export {};