edsger 0.82.0 → 0.84.0

package/assets/diagrams/csharp.yaml

@@ -0,0 +1,48 @@
+id: csharp
+name: C# / .NET Overlay
+version: 0.1.0
+kind: diagrams
+extends: base
+appliesTo: [csharp]
+
+groups:
+  - id: architecture
+    name: Architecture & Structure
+    diagrams:
+      - id: aspnet-layers
+        title: ASP.NET Layered Architecture
+        type: flowchart
+        appliesWhen: >
+          An ASP.NET Core web API/app (Controllers or Minimal APIs) with services
+          and EF Core. Shows the request path through the layers and DI.
+        detect:
+          [
+            "ControllerBase",
+            "[ApiController]",
+            "MapGet",
+            "MapPost",
+            "AddScoped",
+            "IServiceCollection"
+          ]
+        guidance: >
+          Read the controllers/endpoints, registered services, and DbContext to
+          map Endpoints → Services → Repositories/DbContext → Database as a
+          `flowchart TB` with layers in `subgraph`s. Reflect the real
+          dependency-injection wiring where you can see it.
+        references:
+          - "https://learn.microsoft.com/aspnet/core/fundamentals/"
+
+  - id: data
+    name: Data & Persistence
+    diagrams:
+      - id: efcore-model
+        title: EF Core Model
+        type: classDiagram
+        appliesWhen: >
+          Entity Framework Core models / a DbContext are present. Shows the
+          entity classes and their navigation-property relationships.
+        detect: ["DbContext", "DbSet<", "[Key]", "HasMany", "WithOne", "EntityFramework"]
+        guidance: >
+          Model the entity POCOs and their navigation properties as a
+          `classDiagram`, using the DbContext `DbSet`s and fluent/attribute
+          configuration to get the relationships and multiplicities right.

package/assets/diagrams/dart.yaml

@@ -0,0 +1,41 @@
+id: dart
+name: Dart / Flutter Overlay
+version: 0.1.0
+kind: diagrams
+extends: base
+appliesTo: [dart]
+
+groups:
+  - id: architecture
+    name: Architecture & Structure
+    diagrams:
+      - id: flutter-widget-tree
+        title: Flutter Widget Tree
+        type: flowchart
+        appliesWhen: >
+          A Flutter app. Shows the widget composition for the main screens —
+          the Flutter equivalent of a component tree.
+        detect:
+          ["flutter", "StatelessWidget", "StatefulWidget", "MaterialApp", "Scaffold", "*.dart"]
+        guidance: >
+          From `main.dart` and the routed screens, map the important widgets and
+          their build-tree composition as a `flowchart TD`. Focus on the screen
+          scaffolds and reusable widgets; note where state is injected
+          (Provider/InheritedWidget) rather than every layout widget.
+        references:
+          - "https://docs.flutter.dev/ui/widgets-intro"
+
+  - id: behavioral
+    name: Behaviour & Control Flow
+    diagrams:
+      - id: bloc-state
+        title: State Management (BLoC / Cubit)
+        type: stateDiagram-v2
+        appliesWhen: >
+          The app uses BLoC/Cubit (or Riverpod/Provider) state management. Shows
+          the states a feature moves through and the events driving them.
+        detect: ["bloc", "cubit", "riverpod", "provider", "emit(", "StateNotifier"]
+        guidance: >
+          Pick a representative feature's BLoC/Cubit and model its states and the
+          events/transitions between them as a `stateDiagram-v2`, tracing each
+          transition to an `emit`/event handler in the code.

package/assets/diagrams/go.yaml

@@ -0,0 +1,44 @@
+id: go
+name: Go Overlay
+version: 0.1.0
+kind: diagrams
+extends: base
+appliesTo: [go]
+
+groups:
+  - id: behavioral
+    name: Behaviour & Control Flow
+    diagrams:
+      - id: goroutine-concurrency
+        title: Goroutine / Channel Concurrency
+        type: flowchart
+        appliesWhen: >
+          The program uses goroutines and channels for a concurrent pipeline,
+          fan-out/fan-in, or worker pool. One of Go's most illuminating and
+          hardest-to-read-from-source structures.
+        detect: ["go func", "chan ", "make(chan", "sync.WaitGroup", "errgroup", "worker pool"]
+        guidance: >
+          Identify the concurrent structure (producers, worker pool, fan-in
+          collector) and render it as a `flowchart LR` where goroutines are nodes
+          and channels are the edges between them (label edges with the channel's
+          element type). Show closing/cancellation (context) where it matters.
+        references:
+          - "https://go.dev/blog/pipelines"
+
+  - id: architecture
+    name: Architecture & Structure
+    diagrams:
+      - id: go-package-layout
+        title: Package Layout (cmd / internal / pkg)
+        type: flowchart
+        appliesWhen: >
+          A multi-package Go module, especially one using the standard
+          cmd/internal/pkg layout. Shows the import direction between packages.
+        detect: ["cmd/", "internal/", "pkg/", "go.mod"]
+        guidance: >
+          Read go.mod and the package imports to map the top-level packages and
+          their import edges as a `flowchart LR`, keeping the dependency direction
+          faithful (binaries in cmd/ depend inward on internal/pkg, never the
+          reverse). Flag any import cycle you find.
+        references:
+          - "https://go.dev/doc/modules/layout"

package/assets/diagrams/java.yaml

@@ -0,0 +1,43 @@
+id: java
+name: Java Overlay
+version: 0.1.0
+kind: diagrams
+extends: base
+appliesTo: [java]
+
+groups:
+  - id: architecture
+    name: Architecture & Structure
+    diagrams:
+      - id: spring-layered-architecture
+        title: Spring Layered Architecture
+        type: flowchart
+        appliesWhen: >
+          A Spring / Spring Boot application (or similar layered JVM app). Shows
+          the Controller → Service → Repository layering and the beans wired
+          between them.
+        detect:
+          ["@RestController", "@Controller", "@Service", "@Repository", "spring-boot", "@Component"]
+        guidance: >
+          Read the annotated components and map the layers (Controller, Service,
+          Repository/Mapper, plus config/clients) and their dependency edges as a
+          `flowchart TB`, grouping each layer in a `subgraph`. Show the datasource
+          and any external clients the repositories/services call.
+        references:
+          - "https://docs.spring.io/spring-boot/reference/using/structuring-your-code.html"
+
+  - id: data
+    name: Data & Persistence
+    diagrams:
+      - id: jpa-entity-model
+        title: JPA Entity Model
+        type: classDiagram
+        appliesWhen: >
+          JPA/Hibernate entities are present (@Entity). Complements the ER diagram
+          by showing the object model and its relationship annotations.
+        detect:
+          ["@Entity", "@Table", "@OneToMany", "@ManyToOne", "hibernate", "jakarta.persistence"]
+        guidance: >
+          Model the @Entity classes as a `classDiagram` with fields and the JPA
+          relationships (@OneToMany/@ManyToOne/@ManyToMany) rendered with correct
+          multiplicity. Keep to the core aggregate roots and their neighbours.

package/assets/diagrams/python.yaml

@@ -0,0 +1,41 @@
+id: python
+name: Python Overlay
+version: 0.1.0
+kind: diagrams
+extends: base
+appliesTo: [python]
+
+groups:
+  - id: data
+    name: Data & Persistence
+    diagrams:
+      - id: etl-dag
+        title: Workflow / ETL DAG
+        type: flowchart
+        appliesWhen: >
+          A data-orchestration or pipeline framework is used (Airflow, Dagster,
+          Prefect, Luigi, dbt) or there is an explicit multi-stage data pipeline.
+          Shows tasks and their dependency DAG.
+        detect: ["airflow", "dagster", "prefect", "luigi", "dbt", "dag", "@task", "pipeline"]
+        guidance: >
+          Read the DAG/flow definitions and render the tasks and their upstream
+          dependencies as a `flowchart LR` that mirrors the real DAG edges. Label
+          nodes with the operator/task name and group by stage where it helps.
+        references:
+          - "https://airflow.apache.org/docs/apache-airflow/stable/core-concepts/dags.html"
+
+  - id: behavioral
+    name: Behaviour & Control Flow
+    diagrams:
+      - id: async-task-flow
+        title: Background Task Flow
+        type: sequenceDiagram
+        appliesWhen: >
+          A task queue or async worker system is used (Celery, RQ, Dramatiq,
+          arq). Shows how a job is enqueued, brokered, and processed.
+        detect: ["celery", "rq", "dramatiq", "arq", "broker", "worker", "@shared_task"]
+        guidance: >
+          Trace one representative job from the producer through the broker
+          (Redis/RabbitMQ) to the worker and any result backend. Emit a
+          `sequenceDiagram` across Client, Producer, Broker, Worker (and Result
+          store), including retry/failure branches with `alt`.

package/assets/diagrams/typescript.yaml

@@ -0,0 +1,45 @@
+id: typescript
+name: TypeScript / JavaScript Overlay
+version: 0.1.0
+kind: diagrams
+extends: base
+appliesTo: [typescript]
+
+# Adds JS/TS-idiomatic diagrams. New diagram ids are appended to the base groups
+# of the same id; base diagrams are unchanged.
+groups:
+  - id: architecture
+    name: Architecture & Structure
+    diagrams:
+      - id: react-component-tree
+        title: Frontend Component Tree
+        type: flowchart
+        appliesWhen: >
+          A component-based frontend is present (React, Next.js, Vue, Svelte, or
+          Angular). Shows the component hierarchy and the main data/props flow.
+        detect: ["react", "next", "vue", "svelte", "@angular", "*.tsx", "*.vue", "*.svelte"]
+        guidance: >
+          Starting from the root/App and route entry points, map the important
+          components and their parent→child composition as a `flowchart TD`.
+          Annotate edges with the key props/state passed down and mark
+          container/smart components vs presentational ones. Focus on the routed
+          screens and shared components, not every leaf.
+        references:
+          - "https://react.dev/learn/thinking-in-react"
+
+  - id: behavioral
+    name: Behaviour & Control Flow
+    diagrams:
+      - id: middleware-chain
+        title: HTTP Middleware / Handler Chain
+        type: flowchart
+        appliesWhen: >
+          A Node HTTP framework with a middleware pipeline is used (Express, Koa,
+          Fastify, NestJS). Shows the order requests pass through middleware to a
+          handler and back.
+        detect: ["express", "koa", "fastify", "@nestjs", "middleware", "app.use"]
+        guidance: >
+          Read the server bootstrap and route registration to reconstruct the
+          ordered middleware pipeline (logging, auth, body-parsing, validation,
+          the route handler, error handler). Emit a `flowchart LR` in the real
+          registration order, showing the error-handling branch.

package/assets/diagrams-viewer/assets/abnfDiagram-VRR7QNED-CWLpbgGU.js

@@ -0,0 +1 @@
+import{g as p,r as u,d as a}from"./chunk-MOJQB5TN-BvLm4a6B.js";import{p as f}from"./chunk-JWPE2WC7-dsh1qiy0.js";import{_ as n,l as o}from"./diagrams-CF48btj0.js";import{M as c,b as d}from"./cynefin-VYW2F7L2-nm5z0Jwc.js";var v=d().RailroadAbnf.parser.LangiumParser,l=n(e=>{const r=e.alternatives.map(g);return r.length===1?r[0]:{type:"choice",alternatives:r}},"transformAlternation"),g=n(e=>{const r=e.elements.map(y);return r.length===1?r[0]:{type:"sequence",elements:r}},"transformConcatenation"),b=n(e=>{if(e.includes("*")){const[t,s]=e.split("*"),i=t?parseInt(t,10):0,m=s?parseInt(s,10):1/0;return{min:i,max:m}}const r=parseInt(e,10);return{min:r,max:r}},"parseRepeat"),y=n(e=>{const r=A(e.primary);if(!e.repeat)return r;const{min:t,max:s}=b(e.repeat);return t===0&&s===1?{type:"optional",element:r}:{type:"repetition",element:r,min:t,max:s}},"transformElement"),A=n(e=>{switch(e.$type){case"AbnfStringLiteral":return{type:"terminal",value:e.value};case"AbnfNumVal":return{type:"terminal",value:e.value};case"AbnfRuleName":return{type:"nonterminal",name:e.name};case"AbnfGroup":return l(e.element);case"AbnfOptionalGroup":return{type:"optional",element:l(e.element)};default:throw new Error(`Unsupported ABNF primary node: ${e.$type}`)}},"transformPrimary"),P=n(e=>({name:e.name,definition:l(e.definition)}),"transformRule"),h=n(e=>{f(e,a),e.title&&a.setTitle(e.title),e.rules.map(r=>a.addRule(P(r)))},"populateDb"),R={parse:n(e=>{a.clear(),o.debug("[ABNF Parser] Starting Langium parse");const r=v.parse(e);if(r.lexerErrors.length>0||r.parserErrors.length>0)throw new c(r);const t=r.value;o.debug("[ABNF Parser] Parsed rules:",t.rules.length),h(t),o.debug("[ABNF Parser] Parse complete")},"parse"),parser:{yy:a}},w={parser:R,db:a,renderer:u,styles:p};export{w as diagram};

package/assets/diagrams-viewer/assets/arc-B4VipCr_.js

@@ -0,0 +1 @@
+import{Y as ln,$ as an,a0 as y,a1 as tn,a2 as F,a3 as q,a4 as _,a5 as un,a6 as rn,a7 as J,a8 as o,a9 as j,aa as sn,ab as on,ac as fn}from"./diagrams-CF48btj0.js";function cn(l){return l.innerRadius}function yn(l){return l.outerRadius}function gn(l){return l.startAngle}function dn(l){return l.endAngle}function mn(l){return l&&l.padAngle}function pn(l,h,I,D,v,A,z,a){var O=I-l,i=D-h,n=z-v,d=a-A,u=d*O-n*i;if(!(u*u<y))return u=(n*(h-A)-d*(l-v))/u,[l+u*O,h+u*i]}function U(l,h,I,D,v,A,z){var a=l-I,O=h-D,i=(z?A:-A)/J(a*a+O*O),n=i*O,d=-i*a,u=l+n,s=h+d,f=I+n,c=D+d,B=(u+f)/2,t=(s+c)/2,m=f-u,g=c-s,R=m*m+g*g,T=v-A,P=u*c-f*s,S=(g<0?-1:1)*J(fn(0,T*T*R-P*P)),Y=(P*g-m*S)/R,$=(-P*m-g*S)/R,w=(P*g+m*S)/R,p=(-P*m+g*S)/R,x=Y-B,e=$-t,r=w-B,C=p-t;return x*x+e*e>r*r+C*C&&(Y=w,$=p),{cx:Y,cy:$,x01:-n,y01:-d,x11:Y*(v/T-1),y11:$*(v/T-1)}}function hn(){var l=cn,h=yn,I=j(0),D=null,v=gn,A=dn,z=mn,a=null,O=ln(i);function i(){var n,d,u=+l.apply(this,arguments),s=+h.apply(this,arguments),f=v.apply(this,arguments)-an,c=A.apply(this,arguments)-an,B=un(c-f),t=c>f;if(a||(a=n=O()),s<u&&(d=s,s=u,u=d),!(s>y))a.moveTo(0,0);else if(B>tn-y)a.moveTo(s*F(f),s*q(f)),a.arc(0,0,s,f,c,!t),u>y&&(a.moveTo(u*F(c),u*q(c)),a.arc(0,0,u,c,f,t));else{var m=f,g=c,R=f,T=c,P=B,S=B,Y=z.apply(this,arguments)/2,$=Y>y&&(D?+D.apply(this,arguments):J(u*u+s*s)),w=_(un(s-u)/2,+I.apply(this,arguments)),p=w,x=w,e,r;if($>y){var C=sn($/u*q(Y)),K=sn($/s*q(Y));(P-=C*2)>y?(C*=t?1:-1,R+=C,T-=C):(P=0,R=T=(f+c)/2),(S-=K*2)>y?(K*=t?1:-1,m+=K,g-=K):(S=0,m=g=(f+c)/2)}var G=s*F(m),H=s*q(m),L=u*F(T),M=u*q(T);if(w>y){var N=s*F(g),Q=s*q(g),V=u*F(R),W=u*q(R),E;if(B<rn)if(E=pn(G,H,V,W,N,Q,L,M)){var X=G-E[0],Z=H-E[1],b=N-E[0],k=Q-E[1],nn=1/q(on((X*b+Z*k)/(J(X*X+Z*Z)*J(b*b+k*k)))/2),en=J(E[0]*E[0]+E[1]*E[1]);p=_(w,(u-en)/(nn-1)),x=_(w,(s-en)/(nn+1))}else p=x=0}S>y?x>y?(e=U(V,W,G,H,s,x,t),r=U(N,Q,L,M,s,x,t),a.moveTo(e.cx+e.x01,e.cy+e.y01),x<w?a.arc(e.cx,e.cy,x,o(e.y01,e.x01),o(r.y01,r.x01),!t):(a.arc(e.cx,e.cy,x,o(e.y01,e.x01),o(e.y11,e.x11),!t),a.arc(0,0,s,o(e.cy+e.y11,e.cx+e.x11),o(r.cy+r.y11,r.cx+r.x11),!t),a.arc(r.cx,r.cy,x,o(r.y11,r.x11),o(r.y01,r.x01),!t))):(a.moveTo(G,H),a.arc(0,0,s,m,g,!t)):a.moveTo(G,H),!(u>y)||!(P>y)?a.lineTo(L,M):p>y?(e=U(L,M,N,Q,u,-p,t),r=U(G,H,V,W,u,-p,t),a.lineTo(e.cx+e.x01,e.cy+e.y01),p<w?a.arc(e.cx,e.cy,p,o(e.y01,e.x01),o(r.y01,r.x01),!t):(a.arc(e.cx,e.cy,p,o(e.y01,e.x01),o(e.y11,e.x11),!t),a.arc(0,0,u,o(e.cy+e.y11,e.cx+e.x11),o(r.cy+r.y11,r.cx+r.x11),t),a.arc(r.cx,r.cy,p,o(r.y11,r.x11),o(r.y01,r.x01),!t))):a.arc(0,0,u,T,R,t)}if(a.closePath(),n)return a=null,n+""||null}return i.centroid=function(){var n=(+l.apply(this,arguments)+ +h.apply(this,arguments))/2,d=(+v.apply(this,arguments)+ +A.apply(this,arguments))/2-rn/2;return[F(d)*n,q(d)*n]},i.innerRadius=function(n){return arguments.length?(l=typeof n=="function"?n:j(+n),i):l},i.outerRadius=function(n){return arguments.length?(h=typeof n=="function"?n:j(+n),i):h},i.cornerRadius=function(n){return arguments.length?(I=typeof n=="function"?n:j(+n),i):I},i.padRadius=function(n){return arguments.length?(D=n==null?null:typeof n=="function"?n:j(+n),i):D},i.startAngle=function(n){return arguments.length?(v=typeof n=="function"?n:j(+n),i):v},i.endAngle=function(n){return arguments.length?(A=typeof n=="function"?n:j(+n),i):A},i.padAngle=function(n){return arguments.length?(z=typeof n=="function"?n:j(+n),i):z},i.context=function(n){return arguments.length?(a=n??null,i):a},i}export{hn as d};