@diagrammo/dgmo 0.75.0 → 0.76.0

package/dist/advanced.d.ts

@@ -2178,6 +2178,18 @@ interface SketchBox {
     readonly collapsed: boolean;
     /** child node ids, declaration order */
     readonly children: readonly string[];
+    /**
+     * Child BOX ids, declaration order (decision #58 — sketch nests to depth 2,
+     * matching boxes-and-lines §14). Empty on an inner box: depth 2 is the bound.
+     */
+    readonly childBoxes: readonly string[];
+    /**
+     * The box this box sits inside, or null at the top level. Membership lives on
+     * the CHILD, the same shape `boxes-and-lines` uses (`parentGroup`) and the one
+     * the sketch rebuild's canvas model arrived at independently — a tree cannot
+     * express double membership, so this cannot either.
+     */
+    readonly parentBoxId: string | null;
     readonly lineNumber: number;
 }
 interface SketchOptions {
@@ -2206,6 +2218,33 @@ declare function isSketchShapeKind(value: string): value is SketchShapeKind;
 
 declare function parseSketch(content: string, palette?: PaletteColors): ParsedSketch;
 
+/**
+ * Emit DGMO source for a parsed sketch.
+ *
+ * The output re-parses to an equivalent scene (`sameSketch`) and raises no
+ * diagnostics. It is not pretty-printed: this is the correctness emitter, whose
+ * only reader is the parser. Presentation — stable aliases, ordering,
+ * whitespace — is a separate job.
+ */
+declare function emitSketch(parsed: ParsedSketch): string;
+interface CanonicalScene {
+    title: string | null;
+    options: string;
+    tags: string;
+    nodes: string[];
+    boxes: string[];
+    edges: string[];
+}
+/**
+ * A scene reduced to what the PICTURE says, so two scenes that draw the same
+ * thing compare equal. Ids and line numbers are dropped (they are parse
+ * artifacts), sets are sorted (declaration order is not meaning), and edges are
+ * keyed by resolved endpoint names rather than ids.
+ */
+declare function canonicalSketch(parsed: ParsedSketch): CanonicalScene;
+/** True when two parses describe the same picture. */
+declare function sameSketch(a: ParsedSketch, b: ParsedSketch): boolean;
+
 interface SketchLayoutNode {
     readonly id: string;
     readonly label: string;
@@ -6772,4 +6811,4 @@ declare function uncoveredCharacters(text: string, coverage: FontCoverage): read
  */
 declare function fontPortabilityWarning(runs: readonly UncoveredRun[]): string | undefined;
 
-export { ARROW_DIAGNOSTIC_CODES, type Activation, type AncestorInfo, type ArcLink, type ArcNodeGroup, type BLCollapseResult, type BLEdge, type BLGroup, type BLLayoutEdge, type BLLayoutGroup, type BLLayoutNode, type BLLayoutResult, type BLNode, type BlipTrend, type BlockCell, type BlockGrid, type BlockLayoutItem, type BlockLayoutResult, type BlockNode, type BlockOptions, type BodyFigure, type BodyOptions, type BodyPart, type BracketMode, type BracketSide, type C4ArrowType, type C4DeploymentNode, type C4Element, type C4ElementType, type C4Group, type C4LayoutBoundary, type C4LayoutEdge, type C4LayoutNode, type C4LayoutResult, type C4LegendEntry, type C4LegendGroup, type C4Relationship, type C4Shape, type C4TagEntry, type C4TagGroup, type ChartDataPoint, type ChartEra, type ChartType$1 as ChartType, type ClassLayoutEdge, type ClassLayoutNode, type ClassLayoutResult, type ClassMember, type ClassModifier, type ClassNode, type ClassRelationship, type ClockEntry, type ClockFace, type ClockZoneKind, type CodepointRange, type CollapsedMindmapResult, type CollapsedOrgResult, type CollapsedSitemapResult, type CollapsedView, CompactViewState, type ComputedInfraEdge, type ComputedInfraModel, type ComputedInfraNode, type ContextRelationship, type CountUnits, type CreateMapGeoQueryOptions, type CycleEdge, type CycleLayoutEdge, type CycleLayoutNode, type CycleLayoutResult, type CycleNode, type CycleRenderOptions, type D3ExportDimensions, DgmoError, type DiagramSymbols, type Duration, type DurationUnit, type ERCardinality, type ERColumn, type ERConstraint, type ERLayoutEdge, type ERLayoutNode, type ERLayoutResult, type ERRelationship, type ERTable, type ElseIfBranch, type EventLineEra, type EventLineEvent, type EventLineFocus, type EventLineOptions, type ExpandedActivity, type ExtendedChartType, type FamilyChild, type FamilyChildEdge, type FamilyLayoutNode, type FamilyLayoutResult, type FamilyMarriageBar, type FamilyPerson, type FamilySex, type FamilyUnion, type FocusOrgResult, type FocusResult, type FocusTarget, type FontCoverage, type GanttDependency, type GanttEra, type GanttGroup, type GroupRow as GanttGroupRow, type GanttHolidays, type GanttInteractiveOptions, type LaneHeaderRow as GanttLaneHeaderRow, type GanttMarker, type GanttNode, type GanttOptions, type Row as GanttRow, type GanttTask, type TaskRow as GanttTaskRow, GeoExtent, type GetOrCreateNameResult, type GoalMode, type GoalOptions, type GraphDirection, type GraphEdge, type GraphGroup, type GraphNode, type GraphShape, INFRA_BEHAVIOR_KEYS, INVALID_COLOR_CODE, INVALID_CSS_COLOR_HEX, type InfraAvailabilityPercentiles, type InfraBehaviorKey, type InfraCbState, type InfraComputeParams, type InfraDiagnostic, type InfraEdge, type InfraGroup, type InfraLatencyPercentiles, type InfraLayoutEdge, type InfraLayoutGroup, type InfraLayoutNode, type InfraLayoutResult, type InfraLegendGroup, type InfraNode, type InfraPlaybackState, type InfraProperty, type InfraRole, type InfraTagGroup, type InlineSpan, type JourneyMapAnnotation, type JourneyMapInteractiveOptions, type JourneyMapLayout, type JourneyMapPersona, type JourneyMapPhase, type JourneyMapStep, type KanbanCard, type KanbanColumn, type KanbanTagEntry, type KanbanTagGroup, LEGEND_GEAR_PILL_W, LEGEND_HEIGHT, type LayoutEdge, type LayoutGroup, type LayoutNode, type LayoutOptions$1 as LayoutOptions, type LayoutResult$1 as LayoutResult, type LegendCallbacks, type LegendConfig, type LegendControl, type LegendGroupData, type LegendHandle, type LegendLayout, type LegendMode, type LegendPalette, type LegendPosition, type LegendState, MapData, type MapExportDimensions, type MapGeoQuery, type MapLayout, type MapLayoutInset, type MapLayoutLeg, MapLayoutLegend, type MapLayoutPoi, type MapLayoutRegion, type MapLayoutStretch, type MemberVisibility, type MindmapLayoutEdge, type MindmapLayoutNode, type MindmapLayoutResult, type MindmapNode, type MonteCarloResult, type NameEntry, type NearestCity, type NodeDetail, type OrgContainerBounds, type OrgLayoutEdge, type OrgLayoutNode, type OrgLayoutResult, PaletteColors, PaletteConfig, type ParseInArrowLabelResult, type ParsedBlock, type ParsedBody, type ParsedBoxesAndLines, type ParsedBracket, type ParsedC4, type ParsedChart, type ParsedClassDiagram, type ParsedClock, type ParsedCountdown, type ParsedCycle, type ParsedERDiagram, type ParsedEventLine, type ParsedExtendedChart, type ParsedFamily, type ParsedGantt, type ParsedGoal, type ParsedGraph, type ParsedInfra, type ParsedJourneyMap, type ParsedKanban, type ParsedLiveLink, ParsedMap, type ParsedMindmap, ParsedOrg, type ParsedPert, type ParsedPyramid, ParsedRaci, type ParsedRing, type ParsedSequenceDgmo, type ParsedSitemap, type ParsedSketch, type ParsedSwimlane, type ParsedTechRadar, type ParsedTreemap, type ParsedVersionControl, type ParsedVisualization, type ParsedWireframe, type ParticipantType, type PertActivity, type Anchor as PertAnchor, type PertDirection, type PertEdge, type PertGroup, type PertLayoutEdge, type PertLayoutGroup, type PertLayoutNode, type LayoutOverrides as PertLayoutOverrides, type LayoutResult as PertLayoutResult, type PertMilestone, type PertOptions, type PertRenderOptions, type PlaceResolution, type PlacedLabel, type ProjectedCity, type PyramidLayer, type QuadrantPosition, RACI_ERROR_CODES, VARIANTS as RACI_VARIANTS, RACI_WARNING_CODES, RECOGNIZED_COLOR_NAMES, RULE_COUNT, type RaciDragSource, type RaciInteractionHandlers, RaciMarker, RaciTask, RaciVariant, type RadialCell, type RadialLayoutResult, type RawMatch, type RawSeed, type RecurRule, type RegionToken, type RelationshipType, type RenderStep, type ResolvedActivity, type ResolvedGroup$1 as ResolvedGroup, ResolvedMap, type ResolvedPert, type ResolvedGroup as ResolvedPertGroup, type ResolvedSchedule, type ResolvedTask, type ResultCard, type ResultTokens, type RingLayer, type RoundMode, SKETCH_AUTO_LAYOUT_DEFAULTS, SKETCH_FOOT_H, SKETCH_FOOT_W, SKETCH_GEOMETRY, SKETCH_HALF_SLOT_X, SKETCH_HALF_SLOT_Y, SKETCH_SEP, SKETCH_SHAPE_KINDS, SKETCH_SLOT_X, SKETCH_SLOT_Y, ScaleContext, type SectionMessageGroup, type SequenceBlock, type SequenceElement, type SequenceGroup, type SequenceMessage, type SequenceNote, type SequenceParticipant, type SequenceRenderOptions, type SequenceSection, type SimulateOptions, type SitemapContainerBounds, type SitemapDirection, type SitemapEdge, type SitemapLayoutEdge, type SitemapLayoutNode, type SitemapLayoutResult, type SitemapLegendEntry, type SitemapLegendGroup, type SitemapNode, type SketchAt, type SketchAutoLayoutFlags, type SketchBox, type SketchCollapseResult, type SketchEdge, type SketchEdgeGeometry, type SketchEdgeHeads, type SketchLayout, type SketchLayoutBox, type SketchLayoutNode, type SketchLayoutOptions, type SketchNode, type SketchOptions, type SketchRenderOptions, type SketchShapeKind, type StateCollapseResult, type SwimEdge, type SwimEvent, type SwimLane, type SwimNode, type SwimPhase, type SwimShape, type LayoutBand as SwimlaneLayoutBand, type SwimlaneLayoutResult, TagEntry, TagGroup, type TechRadarBlip, type TechRadarLayoutPoint, type TechRadarQuadrant, type TechRadarRing, type TreemapCell, type TreemapColorMode, type TreemapLayoutResult, type TreemapNode, type TreemapOptions, type UncoveredRun, type VCBranch, type VCNode, type VCNote, type VCOptions, type VCRef, type VisualizationType, type WireframeElement, type WireframeElementType, type WireframeFormFactor, type WireframeLayout, type WireframeLayoutNode, type WorkWindow, type ZoneSuggestion, addDurationToDate, albersSkewFallback, analyzePert, applyCollapseProjection, applyGroupOrdering, applyPositionOverrides, atlasPalette, authoredCollapsedIds, blueprintPalette, buildNoteMessageMap, buildRenderSequence, buildSimulationContext, buildTagLaneRowList, calculateSchedule, catppuccinPalette, clearEventLineMuted, collapseBoxesAndLines, collapseMindmapTree, collapseOrgTree, collapseSitemapTree, collapseSketch, collapseStateGroups, collectDiagramRoles, collectTasks, colorNames, computeActivations, computeCardArchive, computeCardMove, computeCycleLayout, computeInfra, computeInfraLegendGroups, computeLegendLayout, computeRadarLayout, computeTimeTicks, controlsGroupCapsuleWidth, createMapGeoQuery, displayName, extractSymbols$2 as extractClassSymbols, extractSymbols$1 as extractErSymbols, extractSymbols$3 as extractFlowchartSymbols, extractSymbols as extractInfraSymbols, extractPertSymbols, focusBoxesAndLines, focusEventLine, focusOrgTree, fontPortabilityWarning, formatDateLabel, formatOffsetLabel, getExtendedChartLegendGroups, getLegendReservedHeight, getOrCreateName, getRadarGeometry, getSimpleChartLegendGroups, groupMessagesBySection, inferParticipantType, inferRoles, invalidColorDiagnostic, isArchiveColumn, isInvalidColorToken, isRecognizedColorName, isSequenceBlock, isSequenceNote, isSketchShapeKind, layoutBlock, layoutBoxesAndLines, layoutBracket, layoutC4Components, layoutC4Containers, layoutC4Context, layoutC4Deployment, layoutClassDiagram, layoutERDiagram, layoutFamily, layoutGraph, layoutInfra, layoutJourneyMap, layoutMap, layoutMindmap, layoutOrg, layoutPert, layoutSitemap, layoutSketch, layoutSwimlane, layoutTreemap, layoutTreemapRadial, layoutWireframe, loadMapData, looksLikeClassDiagram, looksLikeERDiagram, looksLikeFlowchart, looksLikeMap, looksLikePert, looksLikeSequence, looksLikeSitemap, looksLikeState, mapBackgroundColor, mapContentAspect, mapExportDimensions, mapNeutralLandColor, measurePertAnalysisBlock, mulberry32, nearestNamedColor, nord, nordPalette, normalizeName, normalizePlace, orderArcNodes, parseAndLayoutInfra, parseBlock, parseBody, parseBoxesAndLines, parseBracket, parseC4, parseChart, parseClassDiagram, parseClock, parseCountdown, parseCycle, parseDataRowValues, parseERDiagram, parseEventLine, parseExtendedChart, parseFamily, parseFixedOffset, parseFlowchart, parseGantt, parseGoal, parseInArrowLabel, parseInfra, parseInlineMarkdown, parseJourneyMap, parseKanban, parseLiveLink, parseMap, parseMindmap, parsePert, parsePyramid, parseRing, parseSequenceDgmo, parseSequenceDgmo as parseSequenceDiagram, parseSitemap, parseSketch, parseState, parseSwimlane, parseTechRadar, parseTimelineDate, parseTreemap, parseVersionControl, parseVisualization, parseWireframe, cellAppendMarker as raciCellAppendMarker, cellCycle as raciCellCycle, cellRemove as raciCellRemove, cellReplace as raciCellReplace, relayoutPert, render, renderArcDiagram, renderBlock, renderBlockForExport, renderBody, renderBodyForExport, renderBoxesAndLines, renderBoxesAndLinesForExport, renderBracket, renderBracketForExport, renderC4ComponentsForExport, renderC4Containers, renderC4ContainersForExport, renderC4Context, renderC4ContextForExport, renderC4Deployment, renderC4DeploymentForExport, renderClassDiagram, renderClassDiagramForExport, renderClock, renderClockForExport, renderCountdown, renderCountdownForExport, renderCycle, renderCycleForExport, renderERDiagram, renderERDiagramForExport, renderEventLine, renderEventLineForExport, renderFamily, renderFamilyForExport, renderFlowchart, renderFlowchartForExport, renderGantt, renderGoal, renderGoalForExport, renderInfra, renderJourneyMap, renderJourneyMapForExport, renderKanban, renderKanbanForExport, renderLegendD3, renderLegendSvg, renderLegendSvgFromConfig, renderLiveLinkCard, renderMap, renderMapForExport, renderMindmap, renderMindmapForExport, renderOrg, renderOrgForExport, renderPert, renderPertAnalysisBlock, renderPertForExport, renderPyramid, renderPyramidForExport, renderQuadrant, renderQuadrantFocus, renderQuadrantFocusForExport, renderRaci, renderRaciForExport, renderRing, renderRingForExport, renderSequenceDiagram, renderSitemap, renderSitemapForExport, renderSketch, renderSketchForExport, renderSlopeChart, renderState, renderStateForExport, renderSwimlaneForExport, renderTechRadar, renderTechRadarForExport, renderTimeline, renderTreemap, renderTreemapForExport, renderTreemapRadial, renderTreemapRadialForExport, renderVenn, renderVersionControl, renderVersionControlForExport, renderWireframe, renderWordCloud, resolveColor, resolveColorWithDiagnostic, resolveMap, resolvePlace, resolveTaskName, rollUpContextRelationships, sampleBetaPert, searchZones, seriesColors, simulateCanonical, simulateFast, sketchEdgeGeometry, sketchSlotToPx, slatePalette, startClocks, startCountdowns, targetToMs, textFromSvg, tickClocks, tickCountdowns, tidewaterPalette, tokyoNightPalette, truncateBareUrl, uncoveredCharacters, validateComputed, validateInfra, validateLabelCharacters };
+export { ARROW_DIAGNOSTIC_CODES, type Activation, type AncestorInfo, type ArcLink, type ArcNodeGroup, type BLCollapseResult, type BLEdge, type BLGroup, type BLLayoutEdge, type BLLayoutGroup, type BLLayoutNode, type BLLayoutResult, type BLNode, type BlipTrend, type BlockCell, type BlockGrid, type BlockLayoutItem, type BlockLayoutResult, type BlockNode, type BlockOptions, type BodyFigure, type BodyOptions, type BodyPart, type BracketMode, type BracketSide, type C4ArrowType, type C4DeploymentNode, type C4Element, type C4ElementType, type C4Group, type C4LayoutBoundary, type C4LayoutEdge, type C4LayoutNode, type C4LayoutResult, type C4LegendEntry, type C4LegendGroup, type C4Relationship, type C4Shape, type C4TagEntry, type C4TagGroup, type ChartDataPoint, type ChartEra, type ChartType$1 as ChartType, type ClassLayoutEdge, type ClassLayoutNode, type ClassLayoutResult, type ClassMember, type ClassModifier, type ClassNode, type ClassRelationship, type ClockEntry, type ClockFace, type ClockZoneKind, type CodepointRange, type CollapsedMindmapResult, type CollapsedOrgResult, type CollapsedSitemapResult, type CollapsedView, CompactViewState, type ComputedInfraEdge, type ComputedInfraModel, type ComputedInfraNode, type ContextRelationship, type CountUnits, type CreateMapGeoQueryOptions, type CycleEdge, type CycleLayoutEdge, type CycleLayoutNode, type CycleLayoutResult, type CycleNode, type CycleRenderOptions, type D3ExportDimensions, DgmoError, type DiagramSymbols, type Duration, type DurationUnit, type ERCardinality, type ERColumn, type ERConstraint, type ERLayoutEdge, type ERLayoutNode, type ERLayoutResult, type ERRelationship, type ERTable, type ElseIfBranch, type EventLineEra, type EventLineEvent, type EventLineFocus, type EventLineOptions, type ExpandedActivity, type ExtendedChartType, type FamilyChild, type FamilyChildEdge, type FamilyLayoutNode, type FamilyLayoutResult, type FamilyMarriageBar, type FamilyPerson, type FamilySex, type FamilyUnion, type FocusOrgResult, type FocusResult, type FocusTarget, type FontCoverage, type GanttDependency, type GanttEra, type GanttGroup, type GroupRow as GanttGroupRow, type GanttHolidays, type GanttInteractiveOptions, type LaneHeaderRow as GanttLaneHeaderRow, type GanttMarker, type GanttNode, type GanttOptions, type Row as GanttRow, type GanttTask, type TaskRow as GanttTaskRow, GeoExtent, type GetOrCreateNameResult, type GoalMode, type GoalOptions, type GraphDirection, type GraphEdge, type GraphGroup, type GraphNode, type GraphShape, INFRA_BEHAVIOR_KEYS, INVALID_COLOR_CODE, INVALID_CSS_COLOR_HEX, type InfraAvailabilityPercentiles, type InfraBehaviorKey, type InfraCbState, type InfraComputeParams, type InfraDiagnostic, type InfraEdge, type InfraGroup, type InfraLatencyPercentiles, type InfraLayoutEdge, type InfraLayoutGroup, type InfraLayoutNode, type InfraLayoutResult, type InfraLegendGroup, type InfraNode, type InfraPlaybackState, type InfraProperty, type InfraRole, type InfraTagGroup, type InlineSpan, type JourneyMapAnnotation, type JourneyMapInteractiveOptions, type JourneyMapLayout, type JourneyMapPersona, type JourneyMapPhase, type JourneyMapStep, type KanbanCard, type KanbanColumn, type KanbanTagEntry, type KanbanTagGroup, LEGEND_GEAR_PILL_W, LEGEND_HEIGHT, type LayoutEdge, type LayoutGroup, type LayoutNode, type LayoutOptions$1 as LayoutOptions, type LayoutResult$1 as LayoutResult, type LegendCallbacks, type LegendConfig, type LegendControl, type LegendGroupData, type LegendHandle, type LegendLayout, type LegendMode, type LegendPalette, type LegendPosition, type LegendState, MapData, type MapExportDimensions, type MapGeoQuery, type MapLayout, type MapLayoutInset, type MapLayoutLeg, MapLayoutLegend, type MapLayoutPoi, type MapLayoutRegion, type MapLayoutStretch, type MemberVisibility, type MindmapLayoutEdge, type MindmapLayoutNode, type MindmapLayoutResult, type MindmapNode, type MonteCarloResult, type NameEntry, type NearestCity, type NodeDetail, type OrgContainerBounds, type OrgLayoutEdge, type OrgLayoutNode, type OrgLayoutResult, PaletteColors, PaletteConfig, type ParseInArrowLabelResult, type ParsedBlock, type ParsedBody, type ParsedBoxesAndLines, type ParsedBracket, type ParsedC4, type ParsedChart, type ParsedClassDiagram, type ParsedClock, type ParsedCountdown, type ParsedCycle, type ParsedERDiagram, type ParsedEventLine, type ParsedExtendedChart, type ParsedFamily, type ParsedGantt, type ParsedGoal, type ParsedGraph, type ParsedInfra, type ParsedJourneyMap, type ParsedKanban, type ParsedLiveLink, ParsedMap, type ParsedMindmap, ParsedOrg, type ParsedPert, type ParsedPyramid, ParsedRaci, type ParsedRing, type ParsedSequenceDgmo, type ParsedSitemap, type ParsedSketch, type ParsedSwimlane, type ParsedTechRadar, type ParsedTreemap, type ParsedVersionControl, type ParsedVisualization, type ParsedWireframe, type ParticipantType, type PertActivity, type Anchor as PertAnchor, type PertDirection, type PertEdge, type PertGroup, type PertLayoutEdge, type PertLayoutGroup, type PertLayoutNode, type LayoutOverrides as PertLayoutOverrides, type LayoutResult as PertLayoutResult, type PertMilestone, type PertOptions, type PertRenderOptions, type PlaceResolution, type PlacedLabel, type ProjectedCity, type PyramidLayer, type QuadrantPosition, RACI_ERROR_CODES, VARIANTS as RACI_VARIANTS, RACI_WARNING_CODES, RECOGNIZED_COLOR_NAMES, RULE_COUNT, type RaciDragSource, type RaciInteractionHandlers, RaciMarker, RaciTask, RaciVariant, type RadialCell, type RadialLayoutResult, type RawMatch, type RawSeed, type RecurRule, type RegionToken, type RelationshipType, type RenderStep, type ResolvedActivity, type ResolvedGroup$1 as ResolvedGroup, ResolvedMap, type ResolvedPert, type ResolvedGroup as ResolvedPertGroup, type ResolvedSchedule, type ResolvedTask, type ResultCard, type ResultTokens, type RingLayer, type RoundMode, SKETCH_AUTO_LAYOUT_DEFAULTS, SKETCH_FOOT_H, SKETCH_FOOT_W, SKETCH_GEOMETRY, SKETCH_HALF_SLOT_X, SKETCH_HALF_SLOT_Y, SKETCH_SEP, SKETCH_SHAPE_KINDS, SKETCH_SLOT_X, SKETCH_SLOT_Y, ScaleContext, type SectionMessageGroup, type SequenceBlock, type SequenceElement, type SequenceGroup, type SequenceMessage, type SequenceNote, type SequenceParticipant, type SequenceRenderOptions, type SequenceSection, type SimulateOptions, type SitemapContainerBounds, type SitemapDirection, type SitemapEdge, type SitemapLayoutEdge, type SitemapLayoutNode, type SitemapLayoutResult, type SitemapLegendEntry, type SitemapLegendGroup, type SitemapNode, type SketchAt, type SketchAutoLayoutFlags, type SketchBox, type SketchCollapseResult, type SketchEdge, type SketchEdgeGeometry, type SketchEdgeHeads, type SketchLayout, type SketchLayoutBox, type SketchLayoutNode, type SketchLayoutOptions, type SketchNode, type SketchOptions, type SketchRenderOptions, type SketchShapeKind, type StateCollapseResult, type SwimEdge, type SwimEvent, type SwimLane, type SwimNode, type SwimPhase, type SwimShape, type LayoutBand as SwimlaneLayoutBand, type SwimlaneLayoutResult, TagEntry, TagGroup, type TechRadarBlip, type TechRadarLayoutPoint, type TechRadarQuadrant, type TechRadarRing, type TreemapCell, type TreemapColorMode, type TreemapLayoutResult, type TreemapNode, type TreemapOptions, type UncoveredRun, type VCBranch, type VCNode, type VCNote, type VCOptions, type VCRef, type VisualizationType, type WireframeElement, type WireframeElementType, type WireframeFormFactor, type WireframeLayout, type WireframeLayoutNode, type WorkWindow, type ZoneSuggestion, addDurationToDate, albersSkewFallback, analyzePert, applyCollapseProjection, applyGroupOrdering, applyPositionOverrides, atlasPalette, authoredCollapsedIds, blueprintPalette, buildNoteMessageMap, buildRenderSequence, buildSimulationContext, buildTagLaneRowList, calculateSchedule, canonicalSketch, catppuccinPalette, clearEventLineMuted, collapseBoxesAndLines, collapseMindmapTree, collapseOrgTree, collapseSitemapTree, collapseSketch, collapseStateGroups, collectDiagramRoles, collectTasks, colorNames, computeActivations, computeCardArchive, computeCardMove, computeCycleLayout, computeInfra, computeInfraLegendGroups, computeLegendLayout, computeRadarLayout, computeTimeTicks, controlsGroupCapsuleWidth, createMapGeoQuery, displayName, emitSketch, extractSymbols$2 as extractClassSymbols, extractSymbols$1 as extractErSymbols, extractSymbols$3 as extractFlowchartSymbols, extractSymbols as extractInfraSymbols, extractPertSymbols, focusBoxesAndLines, focusEventLine, focusOrgTree, fontPortabilityWarning, formatDateLabel, formatOffsetLabel, getExtendedChartLegendGroups, getLegendReservedHeight, getOrCreateName, getRadarGeometry, getSimpleChartLegendGroups, groupMessagesBySection, inferParticipantType, inferRoles, invalidColorDiagnostic, isArchiveColumn, isInvalidColorToken, isRecognizedColorName, isSequenceBlock, isSequenceNote, isSketchShapeKind, layoutBlock, layoutBoxesAndLines, layoutBracket, layoutC4Components, layoutC4Containers, layoutC4Context, layoutC4Deployment, layoutClassDiagram, layoutERDiagram, layoutFamily, layoutGraph, layoutInfra, layoutJourneyMap, layoutMap, layoutMindmap, layoutOrg, layoutPert, layoutSitemap, layoutSketch, layoutSwimlane, layoutTreemap, layoutTreemapRadial, layoutWireframe, loadMapData, looksLikeClassDiagram, looksLikeERDiagram, looksLikeFlowchart, looksLikeMap, looksLikePert, looksLikeSequence, looksLikeSitemap, looksLikeState, mapBackgroundColor, mapContentAspect, mapExportDimensions, mapNeutralLandColor, measurePertAnalysisBlock, mulberry32, nearestNamedColor, nord, nordPalette, normalizeName, normalizePlace, orderArcNodes, parseAndLayoutInfra, parseBlock, parseBody, parseBoxesAndLines, parseBracket, parseC4, parseChart, parseClassDiagram, parseClock, parseCountdown, parseCycle, parseDataRowValues, parseERDiagram, parseEventLine, parseExtendedChart, parseFamily, parseFixedOffset, parseFlowchart, parseGantt, parseGoal, parseInArrowLabel, parseInfra, parseInlineMarkdown, parseJourneyMap, parseKanban, parseLiveLink, parseMap, parseMindmap, parsePert, parsePyramid, parseRing, parseSequenceDgmo, parseSequenceDgmo as parseSequenceDiagram, parseSitemap, parseSketch, parseState, parseSwimlane, parseTechRadar, parseTimelineDate, parseTreemap, parseVersionControl, parseVisualization, parseWireframe, cellAppendMarker as raciCellAppendMarker, cellCycle as raciCellCycle, cellRemove as raciCellRemove, cellReplace as raciCellReplace, relayoutPert, render, renderArcDiagram, renderBlock, renderBlockForExport, renderBody, renderBodyForExport, renderBoxesAndLines, renderBoxesAndLinesForExport, renderBracket, renderBracketForExport, renderC4ComponentsForExport, renderC4Containers, renderC4ContainersForExport, renderC4Context, renderC4ContextForExport, renderC4Deployment, renderC4DeploymentForExport, renderClassDiagram, renderClassDiagramForExport, renderClock, renderClockForExport, renderCountdown, renderCountdownForExport, renderCycle, renderCycleForExport, renderERDiagram, renderERDiagramForExport, renderEventLine, renderEventLineForExport, renderFamily, renderFamilyForExport, renderFlowchart, renderFlowchartForExport, renderGantt, renderGoal, renderGoalForExport, renderInfra, renderJourneyMap, renderJourneyMapForExport, renderKanban, renderKanbanForExport, renderLegendD3, renderLegendSvg, renderLegendSvgFromConfig, renderLiveLinkCard, renderMap, renderMapForExport, renderMindmap, renderMindmapForExport, renderOrg, renderOrgForExport, renderPert, renderPertAnalysisBlock, renderPertForExport, renderPyramid, renderPyramidForExport, renderQuadrant, renderQuadrantFocus, renderQuadrantFocusForExport, renderRaci, renderRaciForExport, renderRing, renderRingForExport, renderSequenceDiagram, renderSitemap, renderSitemapForExport, renderSketch, renderSketchForExport, renderSlopeChart, renderState, renderStateForExport, renderSwimlaneForExport, renderTechRadar, renderTechRadarForExport, renderTimeline, renderTreemap, renderTreemapForExport, renderTreemapRadial, renderTreemapRadialForExport, renderVenn, renderVersionControl, renderVersionControlForExport, renderWireframe, renderWordCloud, resolveColor, resolveColorWithDiagnostic, resolveMap, resolvePlace, resolveTaskName, rollUpContextRelationships, sameSketch, sampleBetaPert, searchZones, seriesColors, simulateCanonical, simulateFast, sketchEdgeGeometry, sketchSlotToPx, slatePalette, startClocks, startCountdowns, targetToMs, textFromSvg, tickClocks, tickCountdowns, tidewaterPalette, tokyoNightPalette, truncateBareUrl, uncoveredCharacters, validateComputed, validateInfra, validateLabelCharacters };

package/dist/advanced.js

@@ -33,7 +33,7 @@ import {
 } from "./chunk-XHROEQ23.js";
 import {
   renderLiveLinkCard
-} from "./chunk-LYLRNAX2.js";
+} from "./chunk-3EGIU5WY.js";
 import {
   authoredCollapsedIds,
   layoutBlock,
@@ -79,18 +79,18 @@ import {
 import {
   renderMap,
   renderMapForExport
-} from "./chunk-DSH7NJ2G.js";
+} from "./chunk-EGXJWRO6.js";
 import "./chunk-MS5574I7.js";
 import {
   mapContentAspect,
   mapExportDimensions
-} from "./chunk-F4CPZRG2.js";
+} from "./chunk-JLJ7SP4X.js";
 import {
   albersSkewFallback,
   layoutMap,
   mapBackgroundColor,
   mapNeutralLandColor
-} from "./chunk-BFTRW24X.js";
+} from "./chunk-FMZEU7MF.js";
 import {
   decodeFeatures,
   regionAt
@@ -105,7 +105,7 @@ import {
   inferRoles,
   parseAndLayoutInfra,
   renderInfra
-} from "./chunk-IGQW7TKM.js";
+} from "./chunk-GFXFRKUG.js";
 import {
   measurePertAnalysisBlock,
   renderPert,
@@ -136,7 +136,7 @@ import {
 import {
   renderState,
   renderStateForExport
-} from "./chunk-XFLLYY3V.js";
+} from "./chunk-TF76LCZS.js";
 import {
   collapseStateGroups
 } from "./chunk-SQ7IY53Q.js";
@@ -165,11 +165,11 @@ import {
 import {
   renderFlowchart,
   renderFlowchartForExport
-} from "./chunk-QUYYL3LP.js";
-import "./chunk-PDKUANDZ.js";
+} from "./chunk-OBYZU23V.js";
+import "./chunk-7IATMZSA.js";
 import {
   layoutGraph
-} from "./chunk-GE5RO4BS.js";
+} from "./chunk-N6MZSBOL.js";
 import {
   computeInfra
 } from "./chunk-ICZ7M6IZ.js";
@@ -204,7 +204,7 @@ import {
 import {
   renderClassDiagram,
   renderClassDiagramForExport
-} from "./chunk-ZMKCG3FT.js";
+} from "./chunk-C576CU77.js";
 import {
   layoutClassDiagram
 } from "./chunk-LM3HY3VG.js";
@@ -228,7 +228,7 @@ import {
   collapseSketch,
   layoutSketch,
   sketchSlotToPx
-} from "./chunk-6DYZ2JM6.js";
+} from "./chunk-BZQCAZZZ.js";
 import {
   renderSketch,
   renderSketchForExport,
@@ -314,8 +314,8 @@ import {
   renderSlopeChart,
   renderVenn,
   renderWordCloud
-} from "./chunk-M3IVOGZE.js";
-import "./chunk-XCAEHWQB.js";
+} from "./chunk-4CRLM3IT.js";
+import "./chunk-PAW4RMH3.js";
 import "./chunk-EOYPX6SF.js";
 import {
   renderLegendSvg,
@@ -370,7 +370,7 @@ import {
   parseDgmo,
   parseDgmoChartType,
   parseVisualization
-} from "./chunk-R5JPMW2F.js";
+} from "./chunk-FTTB64OJ.js";
 import {
   normalizePlace,
   parseClock,
@@ -460,8 +460,8 @@ import {
   SKETCH_SHAPE_KINDS,
   isSketchShapeKind,
   parseSketch
-} from "./chunk-TDHD3HNO.js";
-import "./chunk-RT7ACF77.js";
+} from "./chunk-F4X5NVKY.js";
+import "./chunk-EGY3TS62.js";
 import {
   parseSwimlane
 } from "./chunk-W7UBPARG.js";
@@ -504,7 +504,7 @@ import {
   INFRA_BEHAVIOR_KEYS,
   extractSymbols as extractSymbols4,
   parseInfra
-} from "./chunk-2NRIGEHZ.js";
+} from "./chunk-46KVXDUJ.js";
 import {
   parseGantt
 } from "./chunk-TPN7RJOM.js";
@@ -524,7 +524,7 @@ import {
   extractSymbols,
   looksLikeFlowchart,
   parseFlowchart
-} from "./chunk-DU3OIBQE.js";
+} from "./chunk-NWNSXHA5.js";
 import "./chunk-7TF3QOOD.js";
 import {
   looksLikeState,
@@ -535,7 +535,7 @@ import {
   extractSymbols as extractSymbols2,
   looksLikeClassDiagram,
   parseClassDiagram
-} from "./chunk-SUA56ZSB.js";
+} from "./chunk-LTTZX6RD.js";
 import {
   extractSymbols as extractSymbols3,
   looksLikeERDiagram,
@@ -682,6 +682,165 @@ function collapseBoxesAndLines(parsed, collapsedGroups) {
   };
 }
 
+// src/sketch/emit.ts
+var LIFTED_KEYS = /* @__PURE__ */ new Set(["shape", "at", "as"]);
+function atText(at) {
+  return at ? `at: ${String(at.c)} ${String(at.r)}` : null;
+}
+function safeValue(value) {
+  return value.includes(",") ? value.replace(/,/g, " \u2014") : value;
+}
+function tailFor(thing, at, extra = []) {
+  const alias = thing.alias !== void 0 ? ` as ${thing.alias}` : "";
+  const parts = [];
+  const atPart = atText(at);
+  if (atPart) parts.push(atPart);
+  for (const [k, v] of Object.entries(thing.metadata)) {
+    if (LIFTED_KEYS.has(k)) continue;
+    parts.push(`${k}: ${safeValue(v)}`);
+  }
+  parts.push(...extra);
+  return `${alias}${parts.length > 0 ? ` ${parts.join(", ")}` : ""}`;
+}
+function shapeLine(node, indent) {
+  const extra = [];
+  if (node.shape !== "rectangle") extra.push(`shape: ${node.shape}`);
+  const out = [`${indent}${node.label}${tailFor(node, node.at, extra)}`];
+  if (node.description !== void 0 && node.description !== "") {
+    for (const line of node.description.split("\n")) {
+      out.push(`${indent}  > ${line}`);
+    }
+  }
+  return out;
+}
+function boxLine(box, indent) {
+  const extra = box.collapsed ? ["collapsed"] : [];
+  return `${indent}[${box.label}]${tailFor(box, box.at, extra)}`;
+}
+function edgeText(edge, target) {
+  const d = edge.dashed;
+  const label = edge.label ?? "";
+  if (label === "") {
+    if (edge.heads === "none") return `${d ? "~~" : "--"} ${target}`;
+    if (edge.heads === "both") return `${d ? "<~>" : "<->"} ${target}`;
+    return `${d ? "~>" : "->"} ${target}`;
+  }
+  const l = safeValue(label);
+  if (edge.heads === "none")
+    return `${d ? "~" : "-"}${l}${d ? "~" : "-"} ${target}`;
+  if (edge.heads === "both")
+    return `${d ? "<~" : "<-"}${l}${d ? "~>" : "->"} ${target}`;
+  return `${d ? "~" : "-"}${l}${d ? "~>" : "->"} ${target}`;
+}
+function emitSketch(parsed) {
+  const lines = [];
+  lines.push(parsed.title ? `sketch ${parsed.title}` : "sketch");
+  const o = parsed.options;
+  if (o.noLegend) lines.push("no-legend");
+  if (o.legendInline === true) lines.push("legend-inline");
+  if (o.fillMode === "solid") lines.push("fill-solid");
+  if (o.fillMode === "outline") lines.push("fill-outline");
+  if (o.noDescriptions) lines.push("no-descriptions");
+  for (const group of parsed.tagGroups) {
+    lines.push("");
+    lines.push(
+      group.alias !== void 0 ? `tag ${group.name} as ${group.alias}` : `tag ${group.name}`
+    );
+    for (const entry of group.entries) {
+      const isDefault = group.defaultValue !== void 0 && entry.value === group.defaultValue;
+      lines.push(`  ${entry.value}${isDefault ? " default" : ""}`);
+    }
+  }
+  const refOf = (id) => {
+    const node = parsed.nodes.find((n) => n.id === id);
+    if (node) return node.alias ?? node.label;
+    const box = parsed.boxes.find((b) => b.id === id);
+    if (box) return box.alias ?? `[${box.label}]`;
+    return id;
+  };
+  const edgesBySource = /* @__PURE__ */ new Map();
+  for (const edge of parsed.edges) {
+    const list = edgesBySource.get(edge.sourceId);
+    if (list) list.push(edge);
+    else edgesBySource.set(edge.sourceId, [edge]);
+  }
+  const emitEdgesFor = (id, indent) => {
+    for (const edge of edgesBySource.get(id) ?? []) {
+      lines.push(`${indent}${edgeText(edge, refOf(edge.targetId))}`);
+    }
+  };
+  const nodesByBox = /* @__PURE__ */ new Map();
+  const rootNodes = [];
+  for (const node of parsed.nodes) {
+    if (node.boxLabel === void 0) {
+      rootNodes.push(node);
+      continue;
+    }
+    const list = nodesByBox.get(node.boxLabel);
+    if (list) list.push(node);
+    else nodesByBox.set(node.boxLabel, [node]);
+  }
+  const emitBox = (box, depth) => {
+    const indent = "  ".repeat(depth);
+    lines.push("");
+    lines.push(boxLine(box, indent));
+    emitEdgesFor(box.id, `${indent}  `);
+    for (const node of nodesByBox.get(box.label) ?? []) {
+      lines.push(...shapeLine(node, `${indent}  `));
+      emitEdgesFor(node.id, `${indent}    `);
+    }
+    for (const childId of box.childBoxes) {
+      const child = parsed.boxes.find((b) => b.id === childId);
+      if (child) emitBox(child, depth + 1);
+    }
+  };
+  for (const node of rootNodes) {
+    lines.push("");
+    lines.push(...shapeLine(node, ""));
+    emitEdgesFor(node.id, "  ");
+  }
+  for (const box of parsed.boxes) {
+    if (box.parentBoxId !== null) continue;
+    emitBox(box, 0);
+  }
+  return `${lines.join("\n")}
+`;
+}
+function canonicalSketch(parsed) {
+  const nameOf = (id) => {
+    const node = parsed.nodes.find((n) => n.id === id);
+    if (node) return `n:${node.label}`;
+    const box = parsed.boxes.find((b) => b.id === id);
+    if (box) return `b:${box.label}`;
+    return `?:${id}`;
+  };
+  const meta = (m) => Object.entries(m).filter(([k]) => !LIFTED_KEYS.has(k)).sort(([a], [b]) => a.localeCompare(b)).map(([k, v]) => `${k}=${v}`).join(";");
+  return {
+    title: parsed.title,
+    options: JSON.stringify({
+      noLegend: parsed.options.noLegend,
+      legendInline: parsed.options.legendInline === true,
+      fillMode: parsed.options.fillMode ?? null,
+      noDescriptions: parsed.options.noDescriptions
+    }),
+    tags: parsed.tagGroups.map(
+      (g) => `${g.name}[${g.entries.map((e) => e.value).join("|")}]${g.defaultValue ?? ""}`
+    ).sort().join(","),
+    nodes: parsed.nodes.map(
+      (n) => `${n.label}|${n.shape}|${n.at ? `${String(n.at.c)},${String(n.at.r)}` : "-"}|${n.boxLabel ?? "-"}|${n.description ?? ""}|${meta(n.metadata)}`
+    ).sort(),
+    boxes: parsed.boxes.map(
+      (b) => `${b.label}|${b.at ? `${String(b.at.c)},${String(b.at.r)}` : "-"}|${String(b.collapsed)}|${b.parentBoxId === null ? "-" : parsed.boxes.find((x) => x.id === b.parentBoxId)?.label ?? "?"}|${meta(b.metadata)}`
+    ).sort(),
+    edges: parsed.edges.map(
+      (e) => `${nameOf(e.sourceId)}->${nameOf(e.targetId)}|${e.label ?? ""}|${e.heads}|${String(e.dashed)}`
+    ).sort()
+  };
+}
+function sameSketch(a, b) {
+  return JSON.stringify(canonicalSketch(a)) === JSON.stringify(canonicalSketch(b));
+}
+
 // src/boxes-and-lines/focus.ts
 var GROUP_PREFIX = "__group_";
 var groupKey = (label) => `${GROUP_PREFIX}${label}`;
@@ -1878,6 +2037,7 @@ export {
   buildSimulationContext,
   buildTagLaneRowList,
   calculateSchedule,
+  canonicalSketch,
   catppuccinPalette,
   chartTypeParsers,
   chartTypes,
@@ -1908,6 +2068,7 @@ export {
   decodeDiagramUrl,
   decodeViewState,
   displayName,
+  emitSketch,
   encodeDiagramUrl,
   encodeViewState,
   extractSymbols2 as extractClassSymbols,
@@ -2143,6 +2304,7 @@ export {
   resolvePlace,
   resolveTaskName,
   rollUpContextRelationships,
+  sameSketch,
   sampleBetaPert,
   searchMapLocations,
   searchZones,

package/dist/block.css

@@ -1,8 +1,19 @@
 /* @diagrammo/dgmo block — standard embed chrome.
- * Override the [data-theme="dark"] selectors if your site uses .dark or
- * another color-mode convention. */
+ * Dark mode is keyed on a data-theme="dark" attribute (Starlight, Docusaurus)
+ * AND an html.dark class (Tailwind, next-themes, VitePress), so all of those
+ * work as shipped. Add your own selector if your site marks dark a third way.
+ *
+ * No selector is spelled in bracket form anywhere in these comments on
+ * purpose: the adapters that re-key the attribute rules onto another host's
+ * signal match that exact substring, and a mention inside a comment would be
+ * swallowed into a rule they then emit as garbage. */
 
-/* === Color-mode visibility (dual-render) === */
+/* === Color-mode visibility (dual-render) ===
+ * The dark wrapper also carries the "hidden" ATTRIBUTE, so a page that never
+ * loaded this stylesheet shows the light diagram rather than both of them.
+ * Every rule below is author-origin and therefore still overrides it.
+ * Keep the two host conventions in separate rule blocks — the adapters
+ * rewrite by literal replace and a folded rule would half-rewrite. */
 .dgmo-dark {
   display: none;
 }
@@ -12,6 +23,12 @@
 [data-theme="dark"] .dgmo-dark {
   display: block;
 }
+html.dark .dgmo-light {
+  display: none;
+}
+html.dark .dgmo-dark {
+  display: block;
+}
 
 /* === Diagram sizing ===
  * SVGs are emitted with viewBox only (no fixed width/height). Force them to

package/dist/block.d.ts

@@ -9,10 +9,18 @@ import './tag-groups-DrHT2tEc.js';
  * consumers, and the `BLOCK_CSS` string export for embedders that inject a
  * `<style>` tag.
  *
- * Dark mode keys off `[data-theme="dark"]`. Hosts with a different signal
- * (`html.dark`, `body.theme-dark`) rewrite the selector at their build step —
+ * Dark mode keys off BOTH `[data-theme="dark"]` (Starlight, Docusaurus) and
+ * `html.dark` (Tailwind, next-themes, VitePress), because those two cover
+ * essentially every host and picking one silently left the other half of the
+ * ecosystem with a diagram that never toggled. A host on a third signal
+ * (`body.theme-dark`) still rewrites the selector at its build step —
  * fumadocs-dgmo/nextra-dgmo's build-css.mjs is the reference adapter.
  *
+ * 🔴 Keep the two conventions in SEPARATE rule blocks. `auto/styles.ts`
+ * re-scopes the `[data-theme="dark"]` rules onto `.dgmo-theme-dark` with a
+ * regex that swallows everything up to the `{`, so folding them into one
+ * multi-selector rule would drag `html.dark` into the re-scoped copy too.
+ *
  * The `.dgmo-tok-*` role colors mirror LIGHT_ROLE_STYLES (light) and
  * NORD_ROLE_STYLES (dark) from editor/highlight-api.ts. A parity test
  * (tests/block.test.ts) guards against drift — update both when either

package/dist/block.js

@@ -4,11 +4,11 @@ import {
 } from "./chunk-D3K4U3ZM.js";
 import {
   render
-} from "./chunk-M3IVOGZE.js";
+} from "./chunk-4CRLM3IT.js";
 import {
   docsLink,
   renderErrorCard
-} from "./chunk-XCAEHWQB.js";
+} from "./chunk-PAW4RMH3.js";
 import "./chunk-EOYPX6SF.js";
 import "./chunk-JL7BDLC6.js";
 import "./chunk-L65WI4HO.js";
@@ -27,7 +27,7 @@ import "./chunk-MTGGOCND.js";
 import {
   encodeDiagramUrl
 } from "./chunk-U7VO6JAA.js";
-import "./chunk-R5JPMW2F.js";
+import "./chunk-FTTB64OJ.js";
 import "./chunk-SH4PPRU7.js";
 import "./chunk-A2RUBBVT.js";
 import "./chunk-5PFNUDXR.js";
@@ -51,8 +51,8 @@ import {
 } from "./chunk-WFA6IULY.js";
 import "./chunk-BWJLLNUX.js";
 import "./chunk-KRTLS3G6.js";
-import "./chunk-TDHD3HNO.js";
-import "./chunk-RT7ACF77.js";
+import "./chunk-F4X5NVKY.js";
+import "./chunk-EGY3TS62.js";
 import "./chunk-W7UBPARG.js";
 import "./chunk-S5P5Z5Y5.js";
 import "./chunk-QQJUTGQH.js";
@@ -66,7 +66,7 @@ import "./chunk-UCZBRGJN.js";
 import "./chunk-7BMX2M3F.js";
 import "./chunk-3SP6G4LN.js";
 import "./chunk-ZM27UI5O.js";
-import "./chunk-2NRIGEHZ.js";
+import "./chunk-46KVXDUJ.js";
 import "./chunk-TPN7RJOM.js";
 import "./chunk-EQW6HOP4.js";
 import {
@@ -74,11 +74,11 @@ import {
 } from "./chunk-DAOFNU6J.js";
 import "./chunk-7NSNE52V.js";
 import "./chunk-C3Z4DX3V.js";
-import "./chunk-DU3OIBQE.js";
+import "./chunk-NWNSXHA5.js";
 import "./chunk-7TF3QOOD.js";
 import "./chunk-M5JT2AU7.js";
 import "./chunk-NXMESY4J.js";
-import "./chunk-SUA56ZSB.js";
+import "./chunk-LTTZX6RD.js";
 import "./chunk-ICVIJLBA.js";
 import "./chunk-76NHL5UG.js";
 import "./chunk-E6PNTYRK.js";
@@ -572,10 +572,21 @@ function escapeAttr(s) {
 // src/embed/css.ts
 var BLOCK_CSS = `
 /* @diagrammo/dgmo block \u2014 standard embed chrome.
- * Override the [data-theme="dark"] selectors if your site uses .dark or
- * another color-mode convention. */
+ * Dark mode is keyed on a data-theme="dark" attribute (Starlight, Docusaurus)
+ * AND an html.dark class (Tailwind, next-themes, VitePress), so all of those
+ * work as shipped. Add your own selector if your site marks dark a third way.
+ *
+ * No selector is spelled in bracket form anywhere in these comments on
+ * purpose: the adapters that re-key the attribute rules onto another host's
+ * signal match that exact substring, and a mention inside a comment would be
+ * swallowed into a rule they then emit as garbage. */
 
-/* === Color-mode visibility (dual-render) === */
+/* === Color-mode visibility (dual-render) ===
+ * The dark wrapper also carries the "hidden" ATTRIBUTE, so a page that never
+ * loaded this stylesheet shows the light diagram rather than both of them.
+ * Every rule below is author-origin and therefore still overrides it.
+ * Keep the two host conventions in separate rule blocks \u2014 the adapters
+ * rewrite by literal replace and a folded rule would half-rewrite. */
 .dgmo-dark {
   display: none;
 }
@@ -585,6 +596,12 @@ var BLOCK_CSS = `
 [data-theme="dark"] .dgmo-dark {
   display: block;
 }
+html.dark .dgmo-light {
+  display: none;
+}
+html.dark .dgmo-dark {
+  display: block;
+}
 
 /* === Diagram sizing ===
  * SVGs are emitted with viewBox only (no fixed width/height). Force them to
@@ -1068,7 +1085,7 @@ async function renderDgmoBlock(source, options = {}) {
       renderTheme("dark")
     ]);
     const background = opts.background === "auto" ? defaultEmbedBackground(chartType) : opts.background;
-    svgsHtml = `<div class="${escapeAttr(innerClasses(opts, "dgmo-light"))}" data-dgmo-bg="${escapeAttr(palette.light.bg)}">${normalizeSvgForEmbed(light, { background })}</div><div class="${escapeAttr(innerClasses(opts, "dgmo-dark"))}" data-dgmo-bg="${escapeAttr(palette.dark.bg)}">${normalizeSvgForEmbed(dark, { background })}</div>`;
+    svgsHtml = `<div class="${escapeAttr(innerClasses(opts, "dgmo-light"))}" data-dgmo-bg="${escapeAttr(palette.light.bg)}">${normalizeSvgForEmbed(light, { background })}</div><div class="${escapeAttr(innerClasses(opts, "dgmo-dark"))}" data-dgmo-bg="${escapeAttr(palette.dark.bg)}" hidden>${normalizeSvgForEmbed(dark, { background })}</div>`;
   } else {
     const svg = await renderTheme(opts.colorMode);
     const background = opts.background === "auto" ? defaultEmbedBackground(chartType) : opts.background;

package/dist/chart-meta.js

@@ -10,7 +10,7 @@ import {
 } from "./chunk-U7VO6JAA.js";
 import {
   parseDgmoChartType
-} from "./chunk-R5JPMW2F.js";
+} from "./chunk-FTTB64OJ.js";
 import "./chunk-SH4PPRU7.js";
 import "./chunk-A2RUBBVT.js";
 import "./chunk-5PFNUDXR.js";
@@ -33,8 +33,8 @@ import "./chunk-Z7KVOVE4.js";
 import "./chunk-WFA6IULY.js";
 import "./chunk-BWJLLNUX.js";
 import "./chunk-KRTLS3G6.js";
-import "./chunk-TDHD3HNO.js";
-import "./chunk-RT7ACF77.js";
+import "./chunk-F4X5NVKY.js";
+import "./chunk-EGY3TS62.js";
 import "./chunk-W7UBPARG.js";
 import "./chunk-S5P5Z5Y5.js";
 import "./chunk-QQJUTGQH.js";
@@ -48,17 +48,17 @@ import "./chunk-UCZBRGJN.js";
 import "./chunk-7BMX2M3F.js";
 import "./chunk-3SP6G4LN.js";
 import "./chunk-ZM27UI5O.js";
-import "./chunk-2NRIGEHZ.js";
+import "./chunk-46KVXDUJ.js";
 import "./chunk-TPN7RJOM.js";
 import "./chunk-EQW6HOP4.js";
 import "./chunk-DAOFNU6J.js";
 import "./chunk-7NSNE52V.js";
 import "./chunk-C3Z4DX3V.js";
-import "./chunk-DU3OIBQE.js";
+import "./chunk-NWNSXHA5.js";
 import "./chunk-7TF3QOOD.js";
 import "./chunk-M5JT2AU7.js";
 import "./chunk-NXMESY4J.js";
-import "./chunk-SUA56ZSB.js";
+import "./chunk-LTTZX6RD.js";
 import "./chunk-ICVIJLBA.js";
 import "./chunk-76NHL5UG.js";
 import "./chunk-E6PNTYRK.js";

package/dist/{chunk-LYLRNAX2.js → chunk-3EGIU5WY.js}

@@ -1,6 +1,6 @@
 import {
   MONO_FAMILY
-} from "./chunk-XCAEHWQB.js";
+} from "./chunk-PAW4RMH3.js";
 import {
   FONT_FAMILY
 } from "./chunk-UTCPNJND.js";
@@ -62,4 +62,4 @@ function escapeXml(s) {
 export {
   renderLiveLinkCard
 };
-//# sourceMappingURL=chunk-LYLRNAX2.js.map
+//# sourceMappingURL=chunk-3EGIU5WY.js.map