@polagram/core 0.0.2 → 0.0.4

package/README.md

@@ -2,6 +2,8 @@
 
 `@polagram/core` is the core parsing and AST manipulation library for the Polagram project. It provides functionality to parse diagram languages (currently focusing on Mermaid Sequence Diagrams) into a generic Polagram Abstract Syntax Tree (AST).
 
+**Official Website:** [https://polagram.org/](https://polagram.org/)
+
 ## Installation
 
 ```bash

package/dist/index.d.ts

@@ -17,6 +17,11 @@ export declare interface ActivationNode {
  */
 export declare function applyLens(root: PolagramRoot, lens: Lens): PolagramRoot;
 
+/**
+ * Supported diagram formats
+ */
+export declare type DiagramFormat = 'mermaid' | 'plantuml';
+
 /**
  * Strategy Interface for Diagram Parsing.
  * Implements the Strategy Pattern: different formats implement this interface.
@@ -49,6 +54,58 @@ export declare interface FocusLayer {
     selector: ParticipantSelector;
 }
 
+/**
+ * Format detection utilities for diagram source code.
+ * Detects diagram format based on file extension and content analysis.
+ */
+export declare class FormatDetector {
+    /**
+     * File extensions mapped to their diagram formats
+     */
+    private static readonly EXTENSION_MAP;
+    /**
+     * Content patterns for format detection
+     */
+    private static readonly CONTENT_PATTERNS;
+    /**
+     * Detect diagram format from file path and content.
+     *
+     * @param filePath - Path to the diagram file
+     * @param content - Content of the diagram file
+     * @returns Detected format, or null if format cannot be determined
+     *
+     * @example
+     * ```typescript
+     * const format = FormatDetector.detect('diagram.puml', content);
+     * if (format === 'plantuml') {
+     *   // Process as PlantUML
+     * }
+     * ```
+     */
+    static detect(filePath: string, content: string): DiagramFormat | null;
+    /**
+     * Detect format based on file extension.
+     *
+     * @param filePath - Path to the diagram file
+     * @returns Detected format, or null if extension is not recognized
+     */
+    static detectByExtension(filePath: string): DiagramFormat | null;
+    /**
+     * Detect format based on content patterns.
+     *
+     * @param content - Content of the diagram file
+     * @returns Detected format, or null if no pattern matches
+     */
+    static detectByContent(content: string): DiagramFormat | null;
+    /**
+     * Get file extension for a given format.
+     *
+     * @param format - Diagram format
+     * @returns Default file extension for the format
+     */
+    static getDefaultExtension(format: DiagramFormat): string;
+}
+
 export declare interface FragmentBranch {
     id: string;
     condition?: string;
@@ -90,9 +147,9 @@ declare const LensSchema: z.ZodObject<{
     suffix: z.ZodOptional<z.ZodString>;
     layers: z.ZodArray<z.ZodObject<{
         action: z.ZodEnum<{
-            resolve: "resolve";
             focus: "focus";
             remove: "remove";
+            resolve: "resolve";
         }>;
         selector: z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"fragment">;
@@ -254,6 +311,22 @@ export declare interface ParticipantSelector {
 
 export declare type ParticipantType = 'participant' | 'actor' | 'boundary' | 'control' | 'entity' | 'database' | 'collections' | 'queue';
 
+export declare class PlantUMLGeneratorVisitor implements PolagramVisitor {
+    generate(root: PolagramRoot): string;
+    visitRoot(node: PolagramRoot): string;
+    visitParticipant(node: Participant): string;
+    visitGroup(node: ParticipantGroup, context?: Map<string, Participant>): string;
+    visitMessage(node: MessageNode): string;
+    visitFragment(node: FragmentNode): string;
+    private visitEvent;
+    visitNote(node: NoteNode): string;
+    visitActivation(node: ActivationNode): string;
+    visitParticipantGroup(_node: ParticipantGroup): string;
+    visitDivider(_node: DividerNode): string;
+    visitSpacer(_node: SpacerNode): string;
+    visitReference(_node: ReferenceNode): string;
+}
+
 /**
  * Polagram Fluent API
  *
@@ -270,9 +343,9 @@ export declare class Polagram {
     /**
      * Initialize a new Polagram transformation pipeline.
      * @param code Source diagram code
-     * @param format Input format (currently only 'mermaid' is supported)
+     * @param format Input format ('mermaid' or 'plantuml')
      */
-    static init(code: string, format?: 'mermaid'): PolagramBuilder;
+    static init(code: string, format?: 'mermaid' | 'plantuml'): PolagramBuilder;
 }
 
 /**
@@ -281,7 +354,8 @@ export declare class Polagram {
 export declare class PolagramBuilder {
     private ast;
     private layers;
-    constructor(ast: PolagramRoot);
+    private sourceFormat;
+    constructor(ast: PolagramRoot, sourceFormat?: 'mermaid' | 'plantuml');
     /**
      * Focus on specific participants.
      * Keeps only interactions involving the matched participants.
@@ -318,10 +392,18 @@ export declare class PolagramBuilder {
      * 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;
@@ -342,9 +424,9 @@ export declare const PolagramConfigSchema: z.ZodObject<{
             suffix: z.ZodOptional<z.ZodString>;
             layers: z.ZodArray<z.ZodObject<{
                 action: z.ZodEnum<{
-                    resolve: "resolve";
                     focus: "focus";
                     remove: "remove";
+                    resolve: "resolve";
                 }>;
                 selector: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     kind: z.ZodLiteral<"fragment">;
@@ -390,6 +472,14 @@ export declare const PolagramConfigSchema: z.ZodObject<{
                 }, z.core.$strip>], "kind">;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
+        format: z.ZodOptional<z.ZodEnum<{
+            mermaid: "mermaid";
+            plantuml: "plantuml";
+        }>>;
+        outputFormat: z.ZodOptional<z.ZodEnum<{
+            mermaid: "mermaid";
+            plantuml: "plantuml";
+        }>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 
@@ -498,9 +588,9 @@ declare const TargetConfigSchema: z.ZodObject<{
         suffix: z.ZodOptional<z.ZodString>;
         layers: z.ZodArray<z.ZodObject<{
             action: z.ZodEnum<{
-                resolve: "resolve";
                 focus: "focus";
                 remove: "remove";
+                resolve: "resolve";
             }>;
             selector: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"fragment">;
@@ -546,6 +636,14 @@ declare const TargetConfigSchema: z.ZodObject<{
             }, z.core.$strip>], "kind">;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
+    format: z.ZodOptional<z.ZodEnum<{
+        mermaid: "mermaid";
+        plantuml: "plantuml";
+    }>>;
+    outputFormat: z.ZodOptional<z.ZodEnum<{
+        mermaid: "mermaid";
+        plantuml: "plantuml";
+    }>>;
 }, z.core.$strip>;
 
 export declare type TextMatcher = string | RegExp | {