@wireweave/core 3.1.0-beta.9 → 4.0.0-beta.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/README.md +17 -126
  2. package/dist/app.cjs +31 -0
  3. package/dist/app.d.cts +488 -0
  4. package/dist/app.d.ts +488 -0
  5. package/dist/app.js +31 -0
  6. package/dist/chunk-3RWGG5EC.js +18088 -0
  7. package/dist/chunk-4TMDPWPR.cjs +196 -0
  8. package/dist/chunk-5DGRIQDU.cjs +842 -0
  9. package/dist/chunk-7VTK6LHL.cjs +4374 -0
  10. package/dist/chunk-ETV4XYOV.cjs +7 -0
  11. package/dist/chunk-IMUVIIJR.cjs +18088 -0
  12. package/dist/chunk-JJWAFHSV.js +842 -0
  13. package/dist/chunk-MD6MNOEQ.cjs +2905 -0
  14. package/dist/chunk-PKBMQBKP.js +7 -0
  15. package/dist/chunk-QOS4IC75.js +4374 -0
  16. package/dist/chunk-R5WBZWBC.js +196 -0
  17. package/dist/chunk-V3HVWC7C.js +2905 -0
  18. package/dist/chunk-WV724EAW.js +0 -0
  19. package/dist/chunk-XENFKHRC.cjs +1 -0
  20. package/dist/chunk-XYACLXXF.js +51612 -0
  21. package/dist/chunk-ZPHNXJRY.cjs +51612 -0
  22. package/dist/index-Br7pNaf3.d.cts +240 -0
  23. package/dist/index-CghCKUPx.d.ts +337 -0
  24. package/dist/index-Da_B3eoM.d.ts +240 -0
  25. package/dist/index-G906GEtg.d.cts +337 -0
  26. package/dist/index.cjs +963 -64577
  27. package/dist/index.d.cts +13 -522
  28. package/dist/index.d.ts +13 -522
  29. package/dist/index.js +711 -64118
  30. package/dist/interaction.cjs +17 -0
  31. package/dist/interaction.d.cts +3 -0
  32. package/dist/interaction.d.ts +3 -0
  33. package/dist/interaction.js +17 -0
  34. package/dist/parser.cjs +18 -7832
  35. package/dist/parser.d.cts +10 -1
  36. package/dist/parser.d.ts +10 -1
  37. package/dist/parser.js +16 -7800
  38. package/dist/renderer.cjs +7 -53162
  39. package/dist/renderer.d.cts +19 -239
  40. package/dist/renderer.d.ts +19 -239
  41. package/dist/renderer.js +37 -53137
  42. package/dist/spec.cjs +42 -2883
  43. package/dist/spec.d.cts +4 -75
  44. package/dist/spec.d.ts +4 -75
  45. package/dist/spec.js +25 -2818
  46. package/dist/types-Dkgr0Wyc.d.cts +75 -0
  47. package/dist/types-Dkgr0Wyc.d.ts +75 -0
  48. package/dist/v4-types-Baz9yqAS.d.cts +137 -0
  49. package/dist/v4-types-Baz9yqAS.d.ts +137 -0
  50. package/package.json +22 -1
package/dist/index.d.cts CHANGED
@@ -1,10 +1,15 @@
1
- import { h as AnyNode, A as AccordionNode, a as AlertNode, j as AvatarNode, B as BadgeNode, r as BreadcrumbNode, s as ButtonNode, C as CardNode, w as CheckboxNode, x as ColNode, z as ComponentDefinitionNode, H as ComponentUseNode, I as ContainerComponentNode, J as ContainerNode, K as DataNode, L as DefinitionNode, N as DisplayNode, O as DividerComponentNode, P as DrawerNode, S as DropdownNode, T as FeedbackNode, V as FooterNode, W as GridNode, Z as HeaderNode, $ as IconNode, a2 as ImageNode, a3 as InputComponentNode, a4 as InputNode, aa as LayoutDefinitionNode, ab as LayoutNode, ac as LeafNode, ad as LinkNode, af as ListNode, ag as MainNode, aj as ModalNode, ao as NavNode, ap as NavigationNode, aq as NodeType, ar as OverlayNode, as as PageNode, at as PlaceholderNode, au as PopoverNode, ax as ProgressNode, ay as RadioNode, aB as RowNode, aC as SectionNode, aD as SelectNode, aG as SidebarNode, aI as SliderNode, aJ as SlotNode, aN as SpinnerNode, aV as SwitchNode, aX as TableNode, aY as TabsNode, a_ as TextContentNode, a$ as TextNode, b3 as TextareaNode, b5 as TitleNode, b6 as ToastNode, b8 as TooltipNode, be as WireframeDocument, aK as SourceLocation, aR as StateDeclaration, aS as StateGuard, a6 as InteractionEffect, a5 as InputType } from './types-vhPCZpAW.cjs';
2
- export { b as AlertVariant, c as AlignValue, d as AnchorPosition, e as AnnotationItemNode, f as AnnotationNode, g as AnnotationsNode, i as AppearanceProps, k as AvatarSize, l as AvatarSizeToken, m as BadgeSize, n as BadgeSizeToken, o as BadgeVariant, p as BaseNode, q as BreadcrumbItem, t as ButtonSize, u as ButtonSizeToken, v as ButtonVariant, y as CommonProps, D as ComponentInputValue, E as ComponentParameter, F as ComponentParameterType, G as ComponentSlotFill, M as DirectionValue, Q as DrawerPosition, R as DropdownItemNode, U as FlexProps, X as GridProps, Y as GuardedOutcomeProps, _ as HeightValue, a0 as IconSize, a1 as IconSizeToken, a7 as InteractionHandler, a8 as InteractiveProps, a9 as JustifyValue, ae as ListItemNode, ah as MarkerColor, ai as MarkerNode, ak as NavBlockItem, al as NavChild, am as NavGroupNode, an as NavItem, av as Position, aw as PositionProps, az as RelativeNode, aA as RepeatNode, aE as SelectOption, aF as ShadowValue, aH as SizeProps, aL as SpacingProps, aM as SpacingValue, aO as SpinnerSize, aP as SpinnerSizeToken, aQ as StackNode, aT as StateValue, aU as StateValueType, aW as TabNode, aZ as TextAlign, b0 as TextSize, b1 as TextSizeToken, b2 as TextWeight, b4 as TitleLevel, b7 as ToastPosition, b9 as TooltipPosition, ba as TopLevelNode, bb as ValueWithUnit, bc as VariantScopedProps, bd as WidthValue } from './types-vhPCZpAW.cjs';
3
- export { ExpectedToken, ParseError, ParseErrorInfo, ParseOptions, ParseResult, getErrors, isValid, parse, tryParse } from './parser.cjs';
4
- import { SiteOptions } from './renderer.cjs';
5
- export { AnnotationStyle, CanvasOptions, CanvasRenderResult, ENABLED_GUARD_ATTR, EXTERNAL_NAVIGATE_ATTR, HtmlRenderer, INERT_HREF, INTERACTIVE_ATTR_NAMES, IconData, IconElement, InteractiveAttrs, PageRenderResult, PlacedPage, RenderContext, RenderOptions, RenderResult, ShellMiss, SiteModel, SiteScreen, SiteShell, SvgRenderOptions, SvgRenderResult, TYPED_INTERACTION_ATTR, ThemeColors, ThemeConfig, VISIBLE_GUARD_ATTR, anchorIntent, buildSiteModel, createHtmlRenderer, darkTheme, defaultTheme, generateComponentStyles, generateStyles, getIconData, getTheme, guardedOutcomeAttrs, interactiveAttrs, layoutCanvas, lucideIcons, render, renderCanvas, renderIconSvg, renderPage, renderSite, renderToHtml, renderToSvg, renderUnknownIconSvg, resolvePageDimensions } from './renderer.cjs';
6
- import { ComponentCategory } from './spec.cjs';
7
- export { ATTRIBUTE_MAP, ATTRIBUTE_OVERRIDES, ATTRIBUTE_SPECS, AttributeOverride, AttributeSpec, AttributeValueType, BLOCK_NODE_SPECS, BOX_ATTRIBUTES, COMPONENT_MAP, COMPONENT_NAMES, COMPONENT_SPECS, COMPONENT_SPEC_BY_NAME, CONTAINER_ATTRIBUTES, ComponentSpec, ELEMENT_NODE_TYPE_MAP, GRAMMAR_BLOCK_NODE_TYPES, GRAMMAR_CHILD_KEYWORDS, GRAMMAR_ELEMENTS, GrammarBlockNodeType, GrammarElementName, GrammarNodeType, INTERACTIVE_ATTRIBUTES, LUCIDE_ICON_NAMES, NODE_TYPE_MAP, VALID_ATTRIBUTE_NAMES, VALID_COMPONENT_NAMES, attributeFor, getValidAttributes, isValidAttribute } from './spec.cjs';
1
+ import { h as AnyNode, A as AccordionNode, a as AlertNode, j as AvatarNode, B as BadgeNode, r as BreadcrumbNode, s as ButtonNode, C as CardNode, w as CheckboxNode, x as ColNode, z as ComponentDefinitionNode, H as ComponentUseNode, I as ContainerComponentNode, J as ContainerNode, K as DataNode, L as DefinitionNode, N as DisplayNode, O as DividerComponentNode, P as DrawerNode, S as DropdownNode, T as FeedbackNode, V as FooterNode, W as GridNode, Z as HeaderNode, $ as IconNode, a2 as ImageNode, a3 as InputComponentNode, a4 as InputNode, aa as LayoutDefinitionNode, ab as LayoutNode, ac as LeafNode, ad as LinkNode, af as ListNode, ag as MainNode, aj as ModalNode, ao as NavNode, ap as NavigationNode, aq as NodeType, ar as OverlayNode, as as PageNode, at as PlaceholderNode, au as PopoverNode, ax as ProgressNode, ay as RadioNode, aB as RowNode, aC as SectionNode, aD as SelectNode, aG as SidebarNode, aI as SliderNode, aJ as SlotNode, aN as SpinnerNode, aV as SwitchNode, aX as TableNode, aY as TabsNode, a_ as TextContentNode, a$ as TextNode, b3 as TextareaNode, b5 as TitleNode, b6 as ToastNode, b8 as TooltipNode, be as WireframeDocument, aK as SourceLocation } from './types-vhPCZpAW.cjs';
2
+ export { b as AlertVariant, c as AlignValue, d as AnchorPosition, e as AnnotationItemNode, f as AnnotationNode, g as AnnotationsNode, i as AppearanceProps, k as AvatarSize, l as AvatarSizeToken, m as BadgeSize, n as BadgeSizeToken, o as BadgeVariant, p as BaseNode, q as BreadcrumbItem, t as ButtonSize, u as ButtonSizeToken, v as ButtonVariant, y as CommonProps, D as ComponentInputValue, E as ComponentParameter, F as ComponentParameterType, G as ComponentSlotFill, M as DirectionValue, Q as DrawerPosition, R as DropdownItemNode, U as FlexProps, X as GridProps, Y as GuardedOutcomeProps, _ as HeightValue, a0 as IconSize, a1 as IconSizeToken, a5 as InputType, a6 as InteractionEffect, a7 as InteractionHandler, a8 as InteractiveProps, a9 as JustifyValue, ae as ListItemNode, ah as MarkerColor, ai as MarkerNode, ak as NavBlockItem, al as NavChild, am as NavGroupNode, an as NavItem, av as Position, aw as PositionProps, az as RelativeNode, aA as RepeatNode, aE as SelectOption, aF as ShadowValue, aH as SizeProps, aL as SpacingProps, aM as SpacingValue, aO as SpinnerSize, aP as SpinnerSizeToken, aQ as StackNode, aR as StateDeclaration, aS as StateGuard, aT as StateValue, aU as StateValueType, aW as TabNode, aZ as TextAlign, b0 as TextSize, b1 as TextSizeToken, b2 as TextWeight, b4 as TitleLevel, b7 as ToastPosition, b9 as TooltipPosition, ba as TopLevelNode, bb as ValueWithUnit, bc as VariantScopedProps, bd as WidthValue } from './types-vhPCZpAW.cjs';
3
+ export { ExpectedToken, ParseError, ParseErrorInfo, ParseOptions, ParseResult, getErrors, getV4SourceSpan, isValid, parse, parseV4, tryParse, tryParseV4 } from './parser.cjs';
4
+ export { ENABLED_GUARD_ATTR, EXTERNAL_NAVIGATE_ATTR, HtmlRenderer, INERT_HREF, INTERACTIVE_ATTR_NAMES, IconData, IconElement, InteractiveAttrs, PlacedPage, ShellMiss, SiteModel, SiteScreen, SiteShell, TYPED_INTERACTION_ATTR, VISIBLE_GUARD_ATTR, anchorIntent, buildSiteModel, createHtmlRenderer, generateComponentStyles, generateStyles, getIconData, guardedOutcomeAttrs, interactiveAttrs, layoutCanvas, lucideIcons, render, renderCanvas, renderIconSvg, renderPage, renderToHtml, renderToSvg, renderUnknownIconSvg, resolvePageDimensions } from './renderer.cjs';
5
+ export { ATTRIBUTE_MAP, ATTRIBUTE_OVERRIDES, ATTRIBUTE_SPECS, BLOCK_NODE_SPECS, BOX_ATTRIBUTES, COMPONENT_MAP, COMPONENT_NAMES, COMPONENT_SPECS, COMPONENT_SPEC_BY_NAME, CONTAINER_ATTRIBUTES, ELEMENT_NODE_TYPE_MAP, GRAMMAR_BLOCK_NODE_TYPES, GRAMMAR_CHILD_KEYWORDS, GRAMMAR_ELEMENTS, GrammarBlockNodeType, GrammarElementName, GrammarNodeType, INTERACTIVE_ATTRIBUTES, LUCIDE_ICON_NAMES, NODE_TYPE_MAP, VALID_ATTRIBUTE_NAMES, VALID_COMPONENT_NAMES, attributeFor, getValidAttributes, isValidAttribute } from './spec.cjs';
6
+ import { C as ComponentCategory } from './types-Dkgr0Wyc.cjs';
7
+ export { A as AttributeOverride, a as AttributeSpec, b as AttributeValueType, c as ComponentSpec } from './types-Dkgr0Wyc.cjs';
8
+ import { h as ScreenFields, k as ScreenTransitionGraph } from './index-G906GEtg.cjs';
9
+ export { I as InteractionDiagnostic, a as InteractionDiagnosticCode, b as InteractionKind, c as InteractionModel, N as NormalizedInteraction, d as NormalizedInteractionEffect, e as NormalizedInteractionHandler, S as ScreenAction, f as ScreenDisplay, g as ScreenElement, i as ScreenFieldsSummary, j as ScreenInput, T as TransitionEdge, l as TransitionScreen, m as collectInteractions, n as interactionSignature, o as isUrlTarget, p as normalizeInteractionHandlers, q as normalizeStateGuard } from './index-G906GEtg.cjs';
10
+ export { AppArtifact, AppBundle, AppCompileResult, AppComponentInput, AppComponentInstanceId, AppDefinitionKind, AppDocument, AppLayoutInput, AppLinkDiagnostic, AppLinkDiagnosticCode, AppLinkResult, AppManifest, AppManifestModule, AppModuleInput, AppNodeId, AppNodeKind, AppReferenceInput, AppResult, AppScreenInput, AppSourceMapEntry, AppSourceSpan, CompileAppOptions, CreateAppBundleOptions, Diagnostic, InstanceStep, LinkedApp, LinkedIdentity, ResolvedAppComponent, ResolvedAppLayout, ResolvedAppModule, ResolvedAppReference, ResolvedAppScreen, RuntimeBrowserEffect, RuntimeInput, RuntimeSnapshot, RuntimeTrace, ScreenReference, SourceMapEntry, advanceClock, compileApp, createAppBundle, createAppComponentInstanceId, createAppNodeId, createRuntime, linkAndCompileApp, linkApp, reduceEvent, renderSite as renderAppSite, resetRuntime } from './app.cjs';
11
+ export { A as AnnotationStyle, C as CanvasOptions, a as CanvasRenderResult, P as PageRenderResult, R as RenderContext, b as RenderOptions, c as RenderResult, S as SiteOptions, d as SvgRenderOptions, e as SvgRenderResult, T as ThemeColors, f as ThemeConfig, g as darkTheme, h as defaultTheme, i as getTheme, r as renderSite } from './index-Br7pNaf3.cjs';
12
+ export { C as CanonicalDefinition, a as CanonicalModule, b as CanonicalNode, c as CanonicalParameter, d as CanonicalPrimitive, e as CanonicalSymbol, f as CanonicalUse, P as ParsedDocument, V as V4Diagnostic, h as V4ParseError, i as V4ParseOptions, j as V4ParseResult, k as V4SourceSpan } from './v4-types-Baz9yqAS.cjs';
8
13
 
9
14
  /**
10
15
  * Type guards for wireweave AST
@@ -1202,282 +1207,6 @@ interface AnalysisOptions {
1202
1207
  */
1203
1208
  declare function analyze(doc: WireframeDocument, options?: AnalysisOptions): AnalysisResult;
1204
1209
 
1205
- /** Overlay toggle is distinct from the typed boolean-state `toggle` effect. */
1206
- type NormalizedInteractionEffect = InteractionEffect | {
1207
- kind: 'toggle-overlay';
1208
- target: string;
1209
- } | {
1210
- kind: 'legacy-action';
1211
- action: string;
1212
- };
1213
- interface NormalizedInteractionHandler {
1214
- event: 'click';
1215
- guard?: StateGuard;
1216
- effects: NormalizedInteractionEffect[];
1217
- }
1218
- interface NormalizedInteraction {
1219
- screenIndex: number;
1220
- source: 'screen' | 'layout';
1221
- signature: string;
1222
- handler: NormalizedInteractionHandler;
1223
- /** Present when this entry came from a legacy scalar intent attribute. */
1224
- legacyKind?: InteractionKind;
1225
- trigger: {
1226
- nodeType: NodeType;
1227
- label?: string;
1228
- loc?: SourceLocation;
1229
- item?: {
1230
- index: number;
1231
- };
1232
- };
1233
- }
1234
- type InteractionDiagnosticCode = 'invalid-state-declaration' | 'duplicate-state-declaration' | 'invalid-interaction-handler' | 'unknown-legacy-action';
1235
- interface InteractionDiagnostic {
1236
- code: InteractionDiagnosticCode;
1237
- message: string;
1238
- screenIndex?: number;
1239
- source?: 'screen' | 'layout';
1240
- loc?: SourceLocation;
1241
- }
1242
- interface InteractionModel {
1243
- states: StateDeclaration[];
1244
- interactions: NormalizedInteraction[];
1245
- diagnostics: InteractionDiagnostic[];
1246
- }
1247
- /** Normalize a guard object emitted by the generic DSL object grammar. */
1248
- declare function normalizeStateGuard(value: unknown): StateGuard | undefined;
1249
- /**
1250
- * Normalize the public `on=` shape. Malformed handlers are inert; diagnostics
1251
- * are added by {@link collectInteractions}, where screen/source context exists.
1252
- */
1253
- declare function normalizeInteractionHandlers(value: unknown): NormalizedInteractionHandler[];
1254
- /** Stable payload shared by rendered DOM markers and the runtime registry. */
1255
- declare function interactionSignature(handler: NormalizedInteractionHandler): string;
1256
- /**
1257
- * The canonical interaction/state source for graph extraction and renderSite.
1258
- * Layout intent is expanded once per screen using that layout, so shared chrome
1259
- * has the same reachable routes in both consumers.
1260
- */
1261
- declare function collectInteractions(doc: WireframeDocument): InteractionModel;
1262
-
1263
- /**
1264
- * Types for the deterministic extraction module.
1265
- *
1266
- * These shapes mirror the SSOT (single-source-of-truth) Screen skeleton slots —
1267
- * title / UI 요소·입력 필드 / 표시 데이터 / 전이 — so a downstream SSOT authoring
1268
- * step can map a parsed `WireframeDocument` onto Screen nodes without any prose
1269
- * generation. Everything here is derived structurally from the AST; there is no
1270
- * heuristic text synthesis.
1271
- */
1272
-
1273
- /**
1274
- * The kind of interaction an interactive node triggers, taken directly from the
1275
- * DSL `InteractiveProps` (`navigate` / `opens` / `toggles` / `action`).
1276
- */
1277
- type InteractionKind = 'navigate' | 'opens' | 'toggles' | 'action';
1278
- /**
1279
- * A meaningful UI node on a screen (any real AST component node below the page).
1280
- */
1281
- interface ScreenElement {
1282
- nodeType: NodeType;
1283
- category: ComponentCategory;
1284
- /** Short caption: form label, card/section title, avatar/icon name, etc. */
1285
- label?: string;
1286
- /** Textual body for content-bearing nodes (text/title/link/button/badge…). */
1287
- content?: string;
1288
- loc?: SourceLocation;
1289
- }
1290
- /**
1291
- * A form input field (the 7 `InputComponentNode` types — excludes Button, which
1292
- * the spec files under the `input` category but is an action, not a field).
1293
- */
1294
- interface ScreenInput {
1295
- nodeType: NodeType;
1296
- label?: string;
1297
- /** Present on `Input` only. */
1298
- inputType?: InputType;
1299
- placeholder?: string;
1300
- required?: boolean;
1301
- disabled?: boolean;
1302
- /** Present on `Select` — option labels, normalised to strings. */
1303
- options?: string[];
1304
- loc?: SourceLocation;
1305
- }
1306
- /**
1307
- * A display / data / text node — the read-only "표시 데이터" of a screen.
1308
- */
1309
- interface ScreenDisplay {
1310
- nodeType: NodeType;
1311
- category: ComponentCategory;
1312
- content?: string;
1313
- label?: string;
1314
- loc?: SourceLocation;
1315
- }
1316
- /**
1317
- * A single interaction emitted by a node. A node carrying more than one
1318
- * `InteractiveProps` (e.g. `navigate` + `action`) yields one entry per prop, in
1319
- * a fixed order (navigate, opens, toggles, action).
1320
- */
1321
- interface ScreenAction {
1322
- nodeType: NodeType;
1323
- label?: string;
1324
- kind: InteractionKind;
1325
- /** The raw target string as written in the DSL. */
1326
- target: string;
1327
- /**
1328
- * Present when the action is a menu item inside a nav/dropdown/breadcrumb
1329
- * container rather than a component node. `nodeType` is then the container's
1330
- * type, `label` is the item's label, and `index` is its position within the
1331
- * container's flattened item list.
1332
- */
1333
- item?: {
1334
- index: number;
1335
- };
1336
- /** The container node's location for item-level actions; items carry no `loc`. */
1337
- loc?: SourceLocation;
1338
- }
1339
- /**
1340
- * Per-screen derived counts and boolean rollups.
1341
- */
1342
- interface ScreenFieldsSummary {
1343
- /** Total meaningful component nodes below the page. */
1344
- total: number;
1345
- /** Count of nodes per component category. */
1346
- byCategory: Record<ComponentCategory, number>;
1347
- inputCount: number;
1348
- displayCount: number;
1349
- actionCount: number;
1350
- /** At least one form input field is present. */
1351
- hasForm: boolean;
1352
- /** At least one navigation-category node (nav/tabs/breadcrumb) is present. */
1353
- hasNavigation: boolean;
1354
- /** At least one overlay container (modal/drawer/popover/tooltip/dropdown). */
1355
- hasOverlay: boolean;
1356
- }
1357
- /**
1358
- * The full structured field set extracted from one page.
1359
- */
1360
- interface ScreenFields {
1361
- title?: string;
1362
- viewport?: string | number;
1363
- device?: string;
1364
- elements: ScreenElement[];
1365
- inputs: ScreenInput[];
1366
- displayData: ScreenDisplay[];
1367
- actions: ScreenAction[];
1368
- summary: ScreenFieldsSummary;
1369
- loc?: SourceLocation;
1370
- }
1371
- /**
1372
- * A node in the screen-transition graph.
1373
- *
1374
- * `id` is the page's declared identifier — a stable slug an author opted into —
1375
- * and `title` is its display heading. They are separate namespaces: `id` is what
1376
- * a `navigate` target should key off, `title` is what a reader sees. Either can
1377
- * be absent.
1378
- */
1379
- interface TransitionScreen {
1380
- id?: string;
1381
- title?: string;
1382
- index: number;
1383
- loc?: SourceLocation;
1384
- }
1385
- /**
1386
- * A resolved or dangling transition trigger.
1387
- */
1388
- interface TransitionEdge {
1389
- from: {
1390
- pageIndex: number;
1391
- id?: string;
1392
- title?: string;
1393
- };
1394
- /**
1395
- * The destination page for a resolved `navigate` edge. Always `null` for
1396
- * `opens` / `toggles` / `action`, which are intra-page or opaque and never
1397
- * cross a page boundary.
1398
- *
1399
- * `id` / `title` mirror {@link TransitionScreen}: present when the page
1400
- * declares them, so a consumer can address the destination by its stable slug
1401
- * rather than by display text.
1402
- */
1403
- to: {
1404
- pageIndex: number;
1405
- id?: string;
1406
- title?: string;
1407
- } | null;
1408
- /** The raw target string as written in the DSL. */
1409
- target: string;
1410
- kind: InteractionKind;
1411
- /** Typed event metadata; absent for legacy scalar interaction attributes. */
1412
- event?: 'click';
1413
- guard?: StateGuard;
1414
- effect?: NormalizedInteractionEffect;
1415
- /** A shared-layout edge is expanded once for every screen using that layout. */
1416
- source?: 'screen' | 'layout';
1417
- /**
1418
- * What fired the transition. For a component node, `nodeType` is that node's
1419
- * type. For a menu item inside a nav/dropdown/breadcrumb, `nodeType` is the
1420
- * container's type, `label` is the item's label, and `item.index` is the
1421
- * item's position within the container — the presence of `item` marks an
1422
- * item-level trigger.
1423
- */
1424
- trigger: {
1425
- nodeType: NodeType;
1426
- label?: string;
1427
- loc?: SourceLocation;
1428
- item?: {
1429
- index: number;
1430
- };
1431
- };
1432
- /**
1433
- * Whether `target` names a concrete destination for its kind:
1434
- * - `navigate`: a page whose `id` matches `target`, or — failing that — whose
1435
- * `title` matches it. Identifiers are consulted before display text; see
1436
- * `extract/transitions.ts` for why. Also `true` for an `external` target: a
1437
- * URL is a complete destination, it is simply not one of this document's
1438
- * pages, which is why `to` is `null` there.
1439
- * - `opens` / `toggles`: a `Modal` / `Drawer` with `id === target` in the
1440
- * source page.
1441
- * - `action`: always `false` (an opaque handler id has no structural target).
1442
- */
1443
- resolved: boolean;
1444
- /**
1445
- * Present, and always `true`, when a `navigate` target is a URL rather than
1446
- * the name of a page (see `interaction/target.ts`). Such an edge leaves the
1447
- * document: `to` is `null` because there is no page to point at, and it is
1448
- * never {@link ScreenTransitionGraph.dangling | dangling} — an outbound link
1449
- * is a destination the author meant, not a reference that failed to resolve.
1450
- *
1451
- * This is what separates an external link from an `action`: both have
1452
- * `to === null`, but an `action` is an opaque handler with `resolved: false`,
1453
- * while an external link is a real destination the browser can follow.
1454
- */
1455
- external?: true;
1456
- }
1457
- /**
1458
- * The screen-transition graph derived from a whole document.
1459
- */
1460
- interface ScreenTransitionGraph {
1461
- screens: TransitionScreen[];
1462
- edges: TransitionEdge[];
1463
- /**
1464
- * The subset of `navigate` edges whose target matched neither a page `id` nor
1465
- * a page title and is not a URL (`resolved === false`, `to === null`) — a name
1466
- * that was meant to be a screen and found none. This is the defect list: a
1467
- * consumer reporting "broken transitions" counts exactly these. Intra-page
1468
- * `opens` / `toggles` and opaque `action` edges are not page transitions and
1469
- * never appear here, and neither do `external` links.
1470
- */
1471
- dangling: TransitionEdge[];
1472
- /**
1473
- * The subset of `navigate` edges leaving the document — targets that are URLs
1474
- * rather than page names ({@link TransitionEdge.external}). Kept apart from
1475
- * `dangling` so a consumer can show outbound links without counting correct
1476
- * authoring as breakage.
1477
- */
1478
- external: TransitionEdge[];
1479
- }
1480
-
1481
1210
  /**
1482
1211
  * E3 — Screen field extraction.
1483
1212
  *
@@ -1670,242 +1399,4 @@ declare function getNodeSource(source: string, doc: WireframeDocument, path: str
1670
1399
  */
1671
1400
  declare function buildDomTree(doc: WireframeDocument, pageIndexBase?: number): DomTreeNode[];
1672
1401
 
1673
- /**
1674
- * What a `navigate` target names.
1675
- *
1676
- * The DSL documents `navigate` as pointing at "a URL or a page", so every target
1677
- * is read one of two ways, and the reading decides everything downstream. A page
1678
- * name resolves against the document and travels to the consumer as declared
1679
- * intent; a URL is a destination the browser already knows how to reach, so it
1680
- * belongs in the anchor and the document graph has nothing to say about it.
1681
- *
1682
- * The renderer and the transition extractor must read a target identically — the
1683
- * renderer decides whether the value belongs in `href`, the extractor decides
1684
- * whether an unmatched value is an authoring mistake. Two copies of that rule
1685
- * would drift, and the moment they disagree one of the two starts calling
1686
- * correct authoring a defect. So the rule lives here, below both, and neither
1687
- * layer has to depend on the other to reach it.
1688
- */
1689
- /**
1690
- * Whether a `navigate` target is a URL rather than the name of a page.
1691
- *
1692
- * A URL is recognised by shape, not by resolving it:
1693
- * - a path or protocol-relative reference — `/reset`, `//cdn.example.com/x`
1694
- * - an in-page fragment or bare query — `#terms`, `?tab=2`
1695
- * - anything opening with an RFC 3986 scheme — `https:`, `mailto:`, `tel:`
1696
- *
1697
- * A target containing whitespace is never a URL: a URL carrying a space is
1698
- * invalid until the space is percent-encoded, whereas page titles are written
1699
- * as prose and routinely contain spaces. Screening on that first is what keeps
1700
- * an English heading like `"Note: draft"` from reading as a scheme.
1701
- *
1702
- * The remaining ambiguities are decided in favour of "page", because a page name
1703
- * is the common case and the cost of the two mistakes is not symmetric: calling
1704
- * a page a URL yields a link that goes nowhere, while calling a URL a page
1705
- * yields an edge reported as unresolved — visible, not silent. So a
1706
- * schemeless host (`www.example.com`) is a page name; authors write the scheme.
1707
- */
1708
- declare function isUrlTarget(target: string | undefined): target is string;
1709
-
1710
- /** A source file and exact span within it. */
1711
- interface AppSourceSpan {
1712
- sourceId: string;
1713
- location: SourceLocation;
1714
- }
1715
- /** The two reusable definition kinds addressable by an app reference. */
1716
- type AppDefinitionKind = 'layout' | 'component';
1717
- /** Every stable, top-level node kind in a linked application. */
1718
- type AppNodeKind = AppDefinitionKind | 'screen';
1719
- /** A manifest entry assigning one module its stable application namespace. */
1720
- interface AppManifestModule {
1721
- id: string;
1722
- namespace: string;
1723
- location: SourceLocation;
1724
- }
1725
- /**
1726
- * Core-owned manifest describing the modules that make up one application.
1727
- * @public
1728
- */
1729
- interface AppManifest {
1730
- id: string;
1731
- sourceId: string;
1732
- modules: readonly AppManifestModule[];
1733
- }
1734
- /** A reference to a layout or component, local to the owner namespace by default. */
1735
- interface AppReferenceInput {
1736
- kind: AppDefinitionKind;
1737
- id: string;
1738
- namespace?: string;
1739
- source: AppSourceSpan;
1740
- }
1741
- interface AppNodeInput<TNode> {
1742
- /** Stable identifier within the module namespace and node kind. */
1743
- id: string;
1744
- node: TNode;
1745
- source: AppSourceSpan;
1746
- }
1747
- /** A layout declaration and the reusable definitions it depends on. */
1748
- interface AppLayoutInput extends AppNodeInput<LayoutDefinitionNode> {
1749
- references?: readonly AppReferenceInput[];
1750
- }
1751
- /** A component declaration and the reusable definitions it depends on. */
1752
- interface AppComponentInput extends AppNodeInput<ComponentDefinitionNode> {
1753
- references?: readonly AppReferenceInput[];
1754
- }
1755
- /** A screen declaration and the layouts/components it consumes. */
1756
- interface AppScreenInput extends AppNodeInput<PageNode> {
1757
- references?: readonly AppReferenceInput[];
1758
- }
1759
- /**
1760
- * One parsed Wireweave module supplied to the Core linker.
1761
- * @public
1762
- */
1763
- interface AppModuleInput {
1764
- id: string;
1765
- source: AppSourceSpan;
1766
- layouts: readonly AppLayoutInput[];
1767
- components: readonly AppComponentInput[];
1768
- screens: readonly AppScreenInput[];
1769
- }
1770
- /** Opaque stable identity assigned by the linker. */
1771
- type AppNodeId = string & {
1772
- readonly __appNodeId: unique symbol;
1773
- };
1774
- /** Stable identity of one expanded component invocation. */
1775
- type AppComponentInstanceId = string & {
1776
- readonly __appComponentInstanceId: unique symbol;
1777
- };
1778
- /** A reference whose target has been resolved to stable app identity. */
1779
- interface ResolvedAppReference {
1780
- kind: AppDefinitionKind;
1781
- id: string;
1782
- namespace: string;
1783
- targetId: AppNodeId;
1784
- source: AppSourceSpan;
1785
- }
1786
- interface ResolvedAppNode<TKind extends AppNodeKind, TNode> {
1787
- nodeId: AppNodeId;
1788
- kind: TKind;
1789
- id: string;
1790
- moduleId: string;
1791
- namespace: string;
1792
- node: TNode;
1793
- source: AppSourceSpan;
1794
- references: readonly ResolvedAppReference[];
1795
- }
1796
- type ResolvedAppLayout = ResolvedAppNode<'layout', LayoutDefinitionNode>;
1797
- type ResolvedAppComponent = ResolvedAppNode<'component', ComponentDefinitionNode>;
1798
- type ResolvedAppScreen = ResolvedAppNode<'screen', PageNode>;
1799
- /** Stable node-to-source mapping emitted in manifest order. */
1800
- interface AppSourceMapEntry {
1801
- nodeId: AppNodeId;
1802
- source: AppSourceSpan;
1803
- }
1804
- /** One resolved module in a linked application document. */
1805
- interface ResolvedAppModule {
1806
- id: string;
1807
- namespace: string;
1808
- layouts: readonly ResolvedAppLayout[];
1809
- components: readonly ResolvedAppComponent[];
1810
- screens: readonly ResolvedAppScreen[];
1811
- }
1812
- /**
1813
- * Core's dependency-closed representation of a multi-module application.
1814
- * @public
1815
- */
1816
- interface AppDocument {
1817
- type: 'AppDocument';
1818
- id: string;
1819
- modules: readonly ResolvedAppModule[];
1820
- layouts: readonly ResolvedAppLayout[];
1821
- components: readonly ResolvedAppComponent[];
1822
- screens: readonly ResolvedAppScreen[];
1823
- sourceMap: readonly AppSourceMapEntry[];
1824
- }
1825
- /** Stable machine-readable linker diagnostic kinds. */
1826
- type AppLinkDiagnosticCode = 'missing-module' | 'duplicate-module' | 'duplicate-namespace' | 'duplicate-definition' | 'duplicate-screen' | 'missing-reference' | 'cyclic-reference' | 'invalid-component-definition' | 'invalid-component-invocation';
1827
- /**
1828
- * A deterministic linker failure with the exact source span that caused it.
1829
- * @public
1830
- */
1831
- interface AppLinkDiagnostic {
1832
- code: AppLinkDiagnosticCode;
1833
- message: string;
1834
- source: AppSourceSpan;
1835
- }
1836
- type AppLinkResult = {
1837
- ok: true;
1838
- document: AppDocument;
1839
- diagnostics: readonly [];
1840
- } | {
1841
- ok: false;
1842
- document: null;
1843
- diagnostics: readonly AppLinkDiagnostic[];
1844
- };
1845
-
1846
- /**
1847
- * Create the stable identity used by linked documents and source maps.
1848
- * Each segment is encoded so punctuation in authored identifiers cannot collide.
1849
- *
1850
- * @public
1851
- */
1852
- declare function createAppNodeId(namespace: string, kind: AppNodeKind, id: string): AppNodeId;
1853
- /** Create the stable identity of an invocation from its owner and structural path. */
1854
- declare function createAppComponentInstanceId(ownerId: AppNodeId, targetId: AppNodeId, path: readonly number[]): AppComponentInstanceId;
1855
- /**
1856
- * Link parsed Wireweave modules into one dependency-closed application document.
1857
- * The function is pure and returns no document whenever validation finds an error.
1858
- *
1859
- * @public
1860
- * @example
1861
- * `const result = linkApp(manifest, modules)`
1862
- */
1863
- declare function linkApp(manifest: AppManifest, modules: readonly AppModuleInput[]): AppLinkResult;
1864
-
1865
- /**
1866
- * Options for {@link compileApp}.
1867
- *
1868
- * Application artifacts always use neutral annotation styling. The option is
1869
- * intentionally omitted here so every compiler caller gets the same wireframe
1870
- * presentation while legacy render entry points keep their historical default.
1871
- *
1872
- * @public
1873
- */
1874
- type CompileAppOptions = Omit<SiteOptions, 'annotationStyle'>;
1875
- /** Result of linking modules and compiling the resulting application. @public */
1876
- type AppCompileResult = {
1877
- ok: true;
1878
- document: AppDocument;
1879
- html: string;
1880
- diagnostics: readonly [];
1881
- } | {
1882
- ok: false;
1883
- document: null;
1884
- html: null;
1885
- diagnostics: readonly AppLinkDiagnostic[];
1886
- };
1887
- /**
1888
- * Compile one linked application into a deterministic, self-contained HTML document.
1889
- *
1890
- * The linker has already expanded component invocations and resolved shared
1891
- * layouts. This function only projects those resolved nodes into the generic
1892
- * site compositor, using stable app identities for layout names so modules
1893
- * cannot collide.
1894
- *
1895
- * @public
1896
- * @example
1897
- * `const html = compileApp(linked.document)`
1898
- */
1899
- declare function compileApp(document: AppDocument, options?: CompileAppOptions): string;
1900
- /**
1901
- * Link application modules and compile them when linking succeeds.
1902
- *
1903
- * Linker diagnostics remain explicit and no partial HTML is emitted on failure.
1904
- *
1905
- * @public
1906
- * @example
1907
- * `const result = linkAndCompileApp(manifest, modules)`
1908
- */
1909
- declare function linkAndCompileApp(manifest: AppManifest, modules: readonly AppModuleInput[], options?: CompileAppOptions): AppCompileResult;
1910
-
1911
- export { ANCHOR_LOC_ATTR, ANCHOR_PATH_ATTR, type AccessibilityMetrics, AccordionNode, AlertNode, type AnalysisOptions, type AnalysisResult, type AnchorEntry, AnyNode, type AppCompileResult, type AppComponentInput, type AppComponentInstanceId, type AppDefinitionKind, type AppDocument, type AppLayoutInput, type AppLinkDiagnostic, type AppLinkDiagnosticCode, type AppLinkResult, type AppManifest, type AppManifestModule, type AppModuleInput, type AppNodeId, type AppNodeKind, type AppReferenceInput, type AppScreenInput, type AppSourceMapEntry, type AppSourceSpan, type AttributeChange, AvatarNode, BadgeNode, BreadcrumbNode, ButtonNode, CardNode, CheckboxNode, ColNode, type CompileAppOptions, type ComplexityMetrics, ComponentCategory, ComponentDefinitionNode, type ComponentParameterReference, type ComponentStats, ComponentUseNode, ContainerComponentNode, ContainerNode, type ContentAnalysis, DEFAULT_VIEWPORT, DEVICE_PRESETS, DataNode, DefinitionNode, type DiffChangeType, type DiffOptions, type DiffResult, type DiffSummary, DisplayNode, DividerComponentNode, type DomTreeNode, DrawerNode, DropdownNode, type ExportOptions, FeedbackNode, type FigmaAutoLayout, type FigmaColor, type FigmaCounterAxisAlign, type FigmaExportResult, type FigmaLayoutMode, type FigmaNode, type FigmaNodeType, type FigmaPrimaryAxisAlign, type FigmaSize, type FigmaSizingMode, type FigmaSolidFill, type FigmaStroke, type FigmaTextAlign, type FigmaTextStyle, FooterNode, GridNode, HeaderNode, IconNode, ImageNode, InputComponentNode, InputNode, InputType, type InteractionDiagnostic, type InteractionDiagnosticCode, InteractionEffect, type InteractionKind, type InteractionModel, type JsonExportResult, type JsonNode, type LayoutAnalysis, LayoutDefinitionNode, LayoutNode, LeafNode, LinkNode, ListNode, MainNode, ModalNode, NavNode, NavigationNode, type NodeChange, type NodePredicate, NodeType, type NormalizedInteraction, type NormalizedInteractionEffect, type NormalizedInteractionHandler, OverlayNode, PageNode, PlaceholderNode, PopoverNode, type PreviewWrapperOptions, ProgressNode, REPEAT_EXPANSION_BUDGET, RadioNode, RepeatBudgetError, type ResolvedAppComponent, type ResolvedAppLayout, type ResolvedAppModule, type ResolvedAppReference, type ResolvedAppScreen, RowNode, type ScreenAction, type ScreenDisplay, type ScreenElement, type ScreenFields, type ScreenFieldsSummary, type ScreenInput, type ScreenTransitionGraph, SectionNode, SelectNode, SidebarNode, SiteOptions, SliderNode, SlotNode, SourceLocation, type SourceSlice, SpinnerNode, StateDeclaration, StateGuard, SwitchNode, TableNode, TabsNode, TextContentNode, TextNode, TextareaNode, TitleNode, ToastNode, TooltipNode, type TransitionEdge, type TransitionScreen, type TreeMetrics, type ValidationError, type ValidationOptions, type ValidationResult, type ViewportSize, type WalkCallback, WireframeDocument, analyze, areIdentical, buildAnchorIndex, buildDomTree, calculateViewportScale, cloneNode, collectInteractions, collectParameterReferences, compileApp, contains, countNodes, createAppComponentInstanceId, createAppNodeId, diff, documentDefinitions, documentPages, expandRepeats, expandVariants, exportToFigma, exportToFigmaString, exportToJson, exportToJsonString, extractAllScreenFields, extractScreenFields, extractScreenTransitions, filterUnscopedPages, filterVariantScope, find, findAll, findByType, formatWireframeCode, getAncestors, getChangeSummary, getDevicePresets, getMaxDepth, getNodeSource, getNodeTypes, getPageSource, getValidationErrors, hasChildren, importFromJson, interactionSignature, isAccordionNode, isAlertNode, isAvatarNode, isBadgeNode, isBreadcrumbNode, isButtonNode, isCardNode, isCheckboxNode, isColNode, isComponentDefinitionNode, isComponentUseNode, isContainerComponentNode, isContainerNode, isDataNode, isDefinitionNode, isDisplayNode, isDividerNode, isDrawerNode, isDropdownNode, isFeedbackNode, isFooterNode, isGridNode, isHeaderNode, isIconNode, isImageNode, isInputComponentNode, isInputNode, isLayoutDefinitionNode, isLayoutNode, isLeafNode, isLinkNode, isListNode, isMainNode, isModalNode, isNavNode, isNavigationNode, isNodeType, isOverlayNode, isPageNode, isPlaceholderNode, isPopoverNode, isProgressNode, isRadioNode, isRowNode, isSectionNode, isSelectNode, isSidebarNode, isSliderNode, isSlotNode, isSpinnerNode, isSwitchNode, isTableNode, isTabsNode, isTextContentNode, isTextNode, isTextareaNode, isTitleNode, isToastNode, isTooltipNode, isUrlTarget, isValidAst, isValidDevicePreset, linkAndCompileApp, linkApp, mapNodes, normalizeInteractionHandlers, normalizeStateGuard, parameterReferenceName, parseViewportString, printWireframe, resetFigmaIdCounter, resolveAnchor, resolveViewport, validate, variantScope, walk, walkDocument, wrapInPreviewContainer };
1402
+ export { ANCHOR_LOC_ATTR, ANCHOR_PATH_ATTR, type AccessibilityMetrics, AccordionNode, AlertNode, type AnalysisOptions, type AnalysisResult, type AnchorEntry, AnyNode, type AttributeChange, AvatarNode, BadgeNode, BreadcrumbNode, ButtonNode, CardNode, CheckboxNode, ColNode, type ComplexityMetrics, ComponentCategory, ComponentDefinitionNode, type ComponentParameterReference, type ComponentStats, ComponentUseNode, ContainerComponentNode, ContainerNode, type ContentAnalysis, DEFAULT_VIEWPORT, DEVICE_PRESETS, DataNode, DefinitionNode, type DiffChangeType, type DiffOptions, type DiffResult, type DiffSummary, DisplayNode, DividerComponentNode, type DomTreeNode, DrawerNode, DropdownNode, type ExportOptions, FeedbackNode, type FigmaAutoLayout, type FigmaColor, type FigmaCounterAxisAlign, type FigmaExportResult, type FigmaLayoutMode, type FigmaNode, type FigmaNodeType, type FigmaPrimaryAxisAlign, type FigmaSize, type FigmaSizingMode, type FigmaSolidFill, type FigmaStroke, type FigmaTextAlign, type FigmaTextStyle, FooterNode, GridNode, HeaderNode, IconNode, ImageNode, InputComponentNode, InputNode, type JsonExportResult, type JsonNode, type LayoutAnalysis, LayoutDefinitionNode, LayoutNode, LeafNode, LinkNode, ListNode, MainNode, ModalNode, NavNode, NavigationNode, type NodeChange, type NodePredicate, NodeType, OverlayNode, PageNode, PlaceholderNode, PopoverNode, type PreviewWrapperOptions, ProgressNode, REPEAT_EXPANSION_BUDGET, RadioNode, RepeatBudgetError, RowNode, ScreenFields, ScreenTransitionGraph, SectionNode, SelectNode, SidebarNode, SliderNode, SlotNode, SourceLocation, type SourceSlice, SpinnerNode, SwitchNode, TableNode, TabsNode, TextContentNode, TextNode, TextareaNode, TitleNode, ToastNode, TooltipNode, type TreeMetrics, type ValidationError, type ValidationOptions, type ValidationResult, type ViewportSize, type WalkCallback, WireframeDocument, analyze, areIdentical, buildAnchorIndex, buildDomTree, calculateViewportScale, cloneNode, collectParameterReferences, contains, countNodes, diff, documentDefinitions, documentPages, expandRepeats, expandVariants, exportToFigma, exportToFigmaString, exportToJson, exportToJsonString, extractAllScreenFields, extractScreenFields, extractScreenTransitions, filterUnscopedPages, filterVariantScope, find, findAll, findByType, formatWireframeCode, getAncestors, getChangeSummary, getDevicePresets, getMaxDepth, getNodeSource, getNodeTypes, getPageSource, getValidationErrors, hasChildren, importFromJson, isAccordionNode, isAlertNode, isAvatarNode, isBadgeNode, isBreadcrumbNode, isButtonNode, isCardNode, isCheckboxNode, isColNode, isComponentDefinitionNode, isComponentUseNode, isContainerComponentNode, isContainerNode, isDataNode, isDefinitionNode, isDisplayNode, isDividerNode, isDrawerNode, isDropdownNode, isFeedbackNode, isFooterNode, isGridNode, isHeaderNode, isIconNode, isImageNode, isInputComponentNode, isInputNode, isLayoutDefinitionNode, isLayoutNode, isLeafNode, isLinkNode, isListNode, isMainNode, isModalNode, isNavNode, isNavigationNode, isNodeType, isOverlayNode, isPageNode, isPlaceholderNode, isPopoverNode, isProgressNode, isRadioNode, isRowNode, isSectionNode, isSelectNode, isSidebarNode, isSliderNode, isSlotNode, isSpinnerNode, isSwitchNode, isTableNode, isTabsNode, isTextContentNode, isTextNode, isTextareaNode, isTitleNode, isToastNode, isTooltipNode, isValidAst, isValidDevicePreset, mapNodes, parameterReferenceName, parseViewportString, printWireframe, resetFigmaIdCounter, resolveAnchor, resolveViewport, validate, variantScope, walk, walkDocument, wrapInPreviewContainer };