@polagram/core 0.0.4 → 0.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polagram/core",
-  "version": "0.0.4",
+  "version": "0.1.0",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -34,7 +34,8 @@
     "build": "tsc && vite build",
     "test": "vitest run",
     "test:watch": "vitest",
-    "gen:docs": "node ../cli/dist/index.js run -c docs/sequence/polagram.yml"
+    "lint": "biome lint .",
+    "gen:docs": "node ../cli/dist/index.js generate -c docs/sequence/polagram.yml"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",

package/dist/src/api.d.ts

@@ -1,84 +0,0 @@
-import { PolagramRoot } from './ast';
-import { FragmentSelector, GroupSelector, Lens, MessageSelector, ParticipantSelector, TextMatcher } from './transformer/types';
-/**
- * Polagram Fluent API
- *
- * Provides a high-level, chainable interface for transformations.
- *
- * @example
- * const result = Polagram.init(mermaidCode)
- *   .focusParticipant('PaymentService')
- *   .removeParticipant('DebugLogger')
- *   .toMermaid();
- */
-export declare class Polagram {
-    private constructor();
-    /**
-     * Initialize a new Polagram transformation pipeline.
-     * @param code Source diagram code
-     * @param format Input format ('mermaid' or 'plantuml')
-     */
-    static init(code: string, format?: 'mermaid' | 'plantuml'): PolagramBuilder;
-}
-/**
- * Builder class for chaining transformations.
- */
-export declare class PolagramBuilder {
-    private ast;
-    private layers;
-    private sourceFormat;
-    constructor(ast: PolagramRoot, sourceFormat?: 'mermaid' | 'plantuml');
-    /**
-     * Focus on specific participants.
-     * Keeps only interactions involving the matched participants.
-     * @param selector Name (string/RegExp) or detailed ParticipantSelector
-     */
-    focusParticipant(selector: TextMatcher | Partial<ParticipantSelector>): this;
-    /**
-     * Remove specific participants and their interactions.
-     * @param selector Name (string/RegExp) or detailed ParticipantSelector
-     */
-    removeParticipant(selector: TextMatcher | Partial<ParticipantSelector>): this;
-    /**
-     * Remove specific messages.
-     * @param selector Message text (string/RegExp) or detailed MessageSelector
-     */
-    removeMessage(selector: TextMatcher | Partial<MessageSelector>): this;
-    /**
-     * Remove specific groups (visual boxes).
-     * @param selector Group name (string/RegExp) or detailed GroupSelector
-     */
-    removeGroup(selector: TextMatcher | Partial<GroupSelector>): this;
-    /**
-     * Resolve (unwrap) specific fragments like 'alt', 'opt', 'loop'.
-     * Promotes the content of the matched branch and removes the wrapper.
-     * @param selector Condition text (string/RegExp) or detailed FragmentSelector
-     */
-    resolveFragment(selector: TextMatcher | Partial<FragmentSelector>): this;
-    /**
-     * Apply a Lens (a named set of transformation layers).
-     * @param lens Lens object containing layers
-     */
-    applyLens(lens: Lens): this;
-    /**
-     * Generate Mermaid code from the transformed AST.
-     */
-    toMermaid(): string;
-    /**
-     * Generate PlantUML code from the transformed AST.
-     */
-    toPlantUML(): string;
-    /**
-     * Get the transformed AST (for advanced use cases).
-     */
-    toAST(): PolagramRoot;
-    /**
-     * Get the source format detected/specified during init.
-     */
-    getSourceFormat(): 'mermaid' | 'plantuml';
-    private normalizeParticipantSelector;
-    private normalizeMessageSelector;
-    private normalizeGroupSelector;
-    private normalizeFragmentSelector;
-    private isTextMatcher;
-}

package/dist/src/api.js

@@ -1,183 +0,0 @@
-import { MermaidGeneratorVisitor } from './generator/generators/mermaid';
-import { PlantUMLGeneratorVisitor } from './generator/generators/plantuml';
-import { ParserFactory } from './parser';
-import { TransformationEngine } from './transformer/orchestration/engine';
-/**
- * Polagram Fluent API
- *
- * Provides a high-level, chainable interface for transformations.
- *
- * @example
- * const result = Polagram.init(mermaidCode)
- *   .focusParticipant('PaymentService')
- *   .removeParticipant('DebugLogger')
- *   .toMermaid();
- */
-export class Polagram {
-    constructor() { }
-    /**
-     * Initialize a new Polagram transformation pipeline.
-     * @param code Source diagram code
-     * @param format Input format ('mermaid' or 'plantuml')
-     */
-    static init(code, format = 'mermaid') {
-        const parser = ParserFactory.getParser(format);
-        const ast = parser.parse(code);
-        return new PolagramBuilder(ast, format);
-    }
-}
-/**
- * Builder class for chaining transformations.
- */
-export class PolagramBuilder {
-    constructor(ast, sourceFormat = 'mermaid') {
-        Object.defineProperty(this, "ast", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "layers", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: []
-        });
-        Object.defineProperty(this, "sourceFormat", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.ast = ast;
-        this.sourceFormat = sourceFormat;
-    }
-    // -- Entity Filtering --
-    /**
-     * Focus on specific participants.
-     * Keeps only interactions involving the matched participants.
-     * @param selector Name (string/RegExp) or detailed ParticipantSelector
-     */
-    focusParticipant(selector) {
-        this.layers.push({
-            action: 'focus',
-            selector: this.normalizeParticipantSelector(selector)
-        });
-        return this;
-    }
-    /**
-     * Remove specific participants and their interactions.
-     * @param selector Name (string/RegExp) or detailed ParticipantSelector
-     */
-    removeParticipant(selector) {
-        this.layers.push({
-            action: 'remove',
-            selector: this.normalizeParticipantSelector(selector)
-        });
-        return this;
-    }
-    // -- Message Filtering --
-    /**
-     * Remove specific messages.
-     * @param selector Message text (string/RegExp) or detailed MessageSelector
-     */
-    removeMessage(selector) {
-        this.layers.push({
-            action: 'remove',
-            selector: this.normalizeMessageSelector(selector)
-        });
-        return this;
-    }
-    // -- Group Filtering --
-    /**
-     * Remove specific groups (visual boxes).
-     * @param selector Group name (string/RegExp) or detailed GroupSelector
-     */
-    removeGroup(selector) {
-        this.layers.push({
-            action: 'remove',
-            selector: this.normalizeGroupSelector(selector)
-        });
-        return this;
-    }
-    // -- Structural Resolution --
-    /**
-     * Resolve (unwrap) specific fragments like 'alt', 'opt', 'loop'.
-     * Promotes the content of the matched branch and removes the wrapper.
-     * @param selector Condition text (string/RegExp) or detailed FragmentSelector
-     */
-    resolveFragment(selector) {
-        this.layers.push({
-            action: 'resolve',
-            selector: this.normalizeFragmentSelector(selector)
-        });
-        return this;
-    }
-    /**
-     * Apply a Lens (a named set of transformation layers).
-     * @param lens Lens object containing layers
-     */
-    applyLens(lens) {
-        this.layers.push(...lens.layers);
-        return this;
-    }
-    /**
-     * Generate Mermaid code from the transformed AST.
-     */
-    toMermaid() {
-        const engine = new TransformationEngine();
-        const transformedAst = engine.transform(this.ast, this.layers);
-        const generator = new MermaidGeneratorVisitor();
-        return generator.generate(transformedAst);
-    }
-    /**
-     * Generate PlantUML code from the transformed AST.
-     */
-    toPlantUML() {
-        const engine = new TransformationEngine();
-        const transformedAst = engine.transform(this.ast, this.layers);
-        const generator = new PlantUMLGeneratorVisitor();
-        return generator.generate(transformedAst);
-    }
-    /**
-     * Get the transformed AST (for advanced use cases).
-     */
-    toAST() {
-        const engine = new TransformationEngine();
-        return engine.transform(this.ast, this.layers);
-    }
-    /**
-     * Get the source format detected/specified during init.
-     */
-    getSourceFormat() {
-        return this.sourceFormat;
-    }
-    // -- Helper Methods --
-    normalizeParticipantSelector(selector) {
-        if (this.isTextMatcher(selector)) {
-            return { kind: 'participant', name: selector };
-        }
-        return { kind: 'participant', ...selector };
-    }
-    normalizeMessageSelector(selector) {
-        if (this.isTextMatcher(selector)) {
-            return { kind: 'message', text: selector };
-        }
-        return { kind: 'message', ...selector };
-    }
-    normalizeGroupSelector(selector) {
-        if (this.isTextMatcher(selector)) {
-            return { kind: 'group', name: selector };
-        }
-        return { kind: 'group', ...selector };
-    }
-    normalizeFragmentSelector(selector) {
-        if (this.isTextMatcher(selector)) {
-            return { kind: 'fragment', condition: selector };
-        }
-        return { kind: 'fragment', ...selector };
-    }
-    isTextMatcher(val) {
-        return typeof val === 'string' || val instanceof RegExp || (typeof val === 'object' && val !== null && 'pattern' in val && !('kind' in val));
-    }
-}

package/dist/src/ast/ast.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/ast/ast.test.js

@@ -1,146 +0,0 @@
-// packages/core/test/complex_ast_example.test.ts
-import { describe, expect, it } from 'vitest';
-describe('Polagram AST Definition', () => {
-    it('should support a complex lossless scenario', () => {
-        // This "Rosetta Stone" object attempts to use ALL new features
-        // to prove they are correctly typed and coexist.
-        const complexAst = {
-            kind: 'root',
-            meta: {
-                version: '1.0.0',
-                source: 'plantuml',
-                title: 'Complex Order System',
-                theme: {
-                    participantPadding: '10'
-                }
-            },
-            groups: [
-                {
-                    kind: 'group',
-                    id: 'g_1',
-                    name: 'AWS Cloud',
-                    type: 'box',
-                    participantIds: ['p_db', 'p_sqs'],
-                    style: { backgroundColor: '#f0f0f0' }
-                }
-            ],
-            participants: [
-                {
-                    id: 'p_user',
-                    name: 'User',
-                    type: 'actor'
-                },
-                {
-                    id: 'p_api',
-                    name: 'API Gateway',
-                    type: 'control'
-                },
-                {
-                    id: 'p_sqs',
-                    name: 'Order Queue',
-                    type: 'queue'
-                },
-                {
-                    id: 'p_db',
-                    name: 'DynamoDB',
-                    type: 'database'
-                }
-            ],
-            events: [
-                // 1. Found message (from unknown)
-                {
-                    kind: 'message',
-                    id: 'm_1',
-                    from: null,
-                    to: 'p_user',
-                    text: 'User lands on page',
-                    type: 'sync',
-                    style: { line: 'solid', head: 'arrow' }
-                },
-                // 2. Activation independent of message
-                {
-                    kind: 'activation',
-                    participantId: 'p_user',
-                    action: 'activate'
-                },
-                // 3. Message with lifecycle
-                {
-                    kind: 'message',
-                    id: 'm_2',
-                    from: 'p_user',
-                    to: 'p_api',
-                    text: 'POST /order',
-                    type: 'sync',
-                    style: { line: 'solid', head: 'arrow' },
-                    lifecycle: { activateTarget: true }
-                },
-                // 4. Create message (Lifecycle)
-                {
-                    kind: 'message',
-                    id: 'm_3',
-                    from: 'p_api',
-                    to: 'p_sqs',
-                    text: 'new OrderMessage()',
-                    type: 'create', // Explicit create
-                    style: { line: 'dotted', head: 'arrow' }
-                },
-                // 5. Visual Divider
-                {
-                    kind: 'divider',
-                    id: 'd_1',
-                    text: 'Async Processing'
-                },
-                // 6. Visual Spacer (Delay)
-                {
-                    kind: 'spacer',
-                    id: 's_1',
-                    text: '... 5 seconds later ...'
-                },
-                // 7. Grouping/Fragment (Loop)
-                {
-                    kind: 'fragment',
-                    id: 'f_1',
-                    operator: 'loop',
-                    branches: [
-                        {
-                            id: 'b_1',
-                            condition: 'Every 1s',
-                            events: [
-                                {
-                                    kind: 'message',
-                                    id: 'm_poll',
-                                    from: 'p_db',
-                                    to: 'p_sqs',
-                                    text: 'Check items',
-                                    type: 'sync',
-                                    style: { line: 'solid', head: 'arrow' }
-                                }
-                            ]
-                        }
-                    ]
-                },
-                // 8. Reference (Ref)
-                {
-                    kind: 'ref',
-                    id: 'r_1',
-                    text: 'Payment Processing',
-                    link: 'payment.mermaid',
-                    participantIds: ['p_api', 'p_db']
-                },
-                // 9. Destroy (Lifecycle)
-                {
-                    kind: 'message',
-                    id: 'm_del',
-                    from: 'p_api',
-                    to: 'p_sqs',
-                    text: 'delete',
-                    type: 'destroy',
-                    style: { line: 'solid', head: 'cross' } // X marker
-                }
-            ]
-        };
-        expect(complexAst).toBeTruthy();
-        expect(complexAst.participants.length).toBe(4);
-        expect(complexAst.events.length).toBe(9);
-    });
-});

package/dist/src/ast/index.d.ts

@@ -1,119 +0,0 @@
-/**
- * Polagram Abstract Syntax Tree (AST) Definitions
- *
- * Designed to be a lossless representation of Sequence Diagrams from:
- * - Mermaid
- * - PlantUML
- *
- * It captures structure, semantics (lifecycle, grouping), and necessary visual hints.
- */
-export interface PolagramRoot {
-    kind: 'root';
-    meta: MetaData;
-    participants: Participant[];
-    groups: ParticipantGroup[];
-    events: EventNode[];
-}
-export interface MetaData {
-    version: string;
-    source: 'mermaid' | 'plantuml' | 'unknown';
-    title?: string;
-    theme?: Record<string, string>;
-}
-export interface Participant {
-    id: string;
-    name: string;
-    alias?: string;
-    type: ParticipantType;
-    stereotype?: string;
-    style?: StyleProps;
-}
-export type ParticipantType = 'participant' | 'actor' | 'boundary' | 'control' | 'entity' | 'database' | 'collections' | 'queue';
-export interface ParticipantGroup {
-    kind: 'group';
-    id: string;
-    name?: string;
-    type?: string;
-    participantIds: string[];
-    style?: StyleProps;
-}
-export type EventNode = MessageNode | FragmentNode | NoteNode | DividerNode | ActivationNode | ReferenceNode | SpacerNode;
-export type MessageEndpoint = string | null;
-/**
- * Represents a directional interaction.
- * Includes standard sync/async calls, returns, and object creation/deletion.
- */
-export interface MessageNode {
-    kind: 'message';
-    id: string;
-    from: MessageEndpoint;
-    to: MessageEndpoint;
-    text: string;
-    type: 'sync' | 'async' | 'reply' | 'create' | 'destroy';
-    style: {
-        line: 'solid' | 'dotted';
-        head: 'arrow' | 'async' | 'open' | 'cross';
-        color?: string;
-    };
-    lifecycle?: {
-        activateTarget?: boolean;
-        deactivateSource?: boolean;
-    };
-}
-export interface FragmentNode {
-    kind: 'fragment';
-    id: string;
-    operator: FragmentOperator;
-    branches: FragmentBranch[];
-}
-export type FragmentOperator = 'alt' | 'opt' | 'loop' | 'par' | 'break' | 'critical' | 'rect' | 'group';
-export interface FragmentBranch {
-    id: string;
-    condition?: string;
-    events: EventNode[];
-}
-export interface NoteNode {
-    kind: 'note';
-    id: string;
-    text: string;
-    position: 'left' | 'right' | 'over';
-    participantIds: string[];
-    style?: StyleProps;
-}
-/**
- * Independent activation/deactivation not tied to a specific message line.
- * e.g., Mermaid "activate A", PlantUML "activate A"
- */
-export interface ActivationNode {
-    kind: 'activation';
-    participantId: string;
-    action: 'activate' | 'deactivate';
-    style?: StyleProps;
-}
-/**
- * Refers to another sequence diagram or a frame covering participants.
- * e.g., PlantUML "ref over A, B : Init"
- */
-export interface ReferenceNode {
-    kind: 'ref';
-    id: string;
-    text: string;
-    participantIds: string[];
-    link?: string;
-}
-export interface DividerNode {
-    kind: 'divider';
-    id: string;
-    text?: string;
-}
-export interface SpacerNode {
-    kind: 'spacer';
-    id: string;
-    height?: number;
-    text?: string;
-}
-export interface StyleProps {
-    color?: string;
-    backgroundColor?: string;
-    shape?: string;
-}

package/dist/src/ast/index.js

@@ -1,2 +0,0 @@
-// packages/core/src/ast.ts
-export {};

package/dist/src/config/index.d.ts

@@ -1 +0,0 @@
-export * from './schema';

package/dist/src/config/index.js

@@ -1 +0,0 @@
-export * from './schema';