logicstamp-context 0.1.1 → 0.2.1

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 (159) hide show
  1. package/LLM_CONTEXT.md +4 -3
  2. package/README.md +116 -19
  3. package/dist/cli/commands/compare.d.ts.map +1 -1
  4. package/dist/cli/commands/compare.js +17 -8
  5. package/dist/cli/commands/compare.js.map +1 -1
  6. package/dist/cli/commands/context/bundleFormatter.d.ts +20 -0
  7. package/dist/cli/commands/context/bundleFormatter.d.ts.map +1 -0
  8. package/dist/cli/commands/context/bundleFormatter.js +55 -0
  9. package/dist/cli/commands/context/bundleFormatter.js.map +1 -0
  10. package/dist/cli/commands/context/configManager.d.ts +23 -0
  11. package/dist/cli/commands/context/configManager.d.ts.map +1 -0
  12. package/dist/cli/commands/context/configManager.js +69 -0
  13. package/dist/cli/commands/context/configManager.js.map +1 -0
  14. package/dist/cli/commands/context/contractBuilder.d.ts +18 -0
  15. package/dist/cli/commands/context/contractBuilder.d.ts.map +1 -0
  16. package/dist/cli/commands/context/contractBuilder.js +72 -0
  17. package/dist/cli/commands/context/contractBuilder.js.map +1 -0
  18. package/dist/cli/commands/context/fileWriter.d.ts +38 -0
  19. package/dist/cli/commands/context/fileWriter.d.ts.map +1 -0
  20. package/dist/cli/commands/context/fileWriter.js +170 -0
  21. package/dist/cli/commands/context/fileWriter.js.map +1 -0
  22. package/dist/cli/commands/context/statsCalculator.d.ts +44 -0
  23. package/dist/cli/commands/context/statsCalculator.d.ts.map +1 -0
  24. package/dist/cli/commands/context/statsCalculator.js +150 -0
  25. package/dist/cli/commands/context/statsCalculator.js.map +1 -0
  26. package/dist/cli/commands/context/tokenEstimator.d.ts +76 -0
  27. package/dist/cli/commands/context/tokenEstimator.d.ts.map +1 -0
  28. package/dist/cli/commands/context/tokenEstimator.js +258 -0
  29. package/dist/cli/commands/context/tokenEstimator.js.map +1 -0
  30. package/dist/cli/commands/context.d.ts +1 -0
  31. package/dist/cli/commands/context.d.ts.map +1 -1
  32. package/dist/cli/commands/context.js +72 -399
  33. package/dist/cli/commands/context.js.map +1 -1
  34. package/dist/cli/commands/style.d.ts +11 -0
  35. package/dist/cli/commands/style.d.ts.map +1 -0
  36. package/dist/cli/commands/style.js +15 -0
  37. package/dist/cli/commands/style.js.map +1 -0
  38. package/dist/cli/handlers/cleanHandler.d.ts +5 -0
  39. package/dist/cli/handlers/cleanHandler.d.ts.map +1 -0
  40. package/dist/cli/handlers/cleanHandler.js +28 -0
  41. package/dist/cli/handlers/cleanHandler.js.map +1 -0
  42. package/dist/cli/handlers/compareHandler.d.ts +5 -0
  43. package/dist/cli/handlers/compareHandler.d.ts.map +1 -0
  44. package/dist/cli/handlers/compareHandler.js +332 -0
  45. package/dist/cli/handlers/compareHandler.js.map +1 -0
  46. package/dist/cli/handlers/contextHandler.d.ts +5 -0
  47. package/dist/cli/handlers/contextHandler.d.ts.map +1 -0
  48. package/dist/cli/handlers/contextHandler.js +24 -0
  49. package/dist/cli/handlers/contextHandler.js.map +1 -0
  50. package/dist/cli/handlers/initHandler.d.ts +6 -0
  51. package/dist/cli/handlers/initHandler.d.ts.map +1 -0
  52. package/dist/cli/handlers/initHandler.js +30 -0
  53. package/dist/cli/handlers/initHandler.js.map +1 -0
  54. package/dist/cli/handlers/styleHandler.d.ts +5 -0
  55. package/dist/cli/handlers/styleHandler.d.ts.map +1 -0
  56. package/dist/cli/handlers/styleHandler.js +30 -0
  57. package/dist/cli/handlers/styleHandler.js.map +1 -0
  58. package/dist/cli/handlers/validateHandler.d.ts +5 -0
  59. package/dist/cli/handlers/validateHandler.d.ts.map +1 -0
  60. package/dist/cli/handlers/validateHandler.js +23 -0
  61. package/dist/cli/handlers/validateHandler.js.map +1 -0
  62. package/dist/cli/parser/argumentParser.d.ts +44 -0
  63. package/dist/cli/parser/argumentParser.d.ts.map +1 -0
  64. package/dist/cli/parser/argumentParser.js +194 -0
  65. package/dist/cli/parser/argumentParser.js.map +1 -0
  66. package/dist/cli/parser/helpText.d.ts +11 -0
  67. package/dist/cli/parser/helpText.d.ts.map +1 -0
  68. package/dist/cli/parser/helpText.js +373 -0
  69. package/dist/cli/parser/helpText.js.map +1 -0
  70. package/dist/cli/stamp.js +14 -821
  71. package/dist/cli/stamp.js.map +1 -1
  72. package/dist/core/astParser/detectors.d.ts +24 -0
  73. package/dist/core/astParser/detectors.d.ts.map +1 -0
  74. package/dist/core/astParser/detectors.js +102 -0
  75. package/dist/core/astParser/detectors.js.map +1 -0
  76. package/dist/core/astParser/extractors/componentExtractor.d.ts +13 -0
  77. package/dist/core/astParser/extractors/componentExtractor.d.ts.map +1 -0
  78. package/dist/core/astParser/extractors/componentExtractor.js +41 -0
  79. package/dist/core/astParser/extractors/componentExtractor.js.map +1 -0
  80. package/dist/core/astParser/extractors/eventExtractor.d.ts +14 -0
  81. package/dist/core/astParser/extractors/eventExtractor.d.ts.map +1 -0
  82. package/dist/core/astParser/extractors/eventExtractor.js +49 -0
  83. package/dist/core/astParser/extractors/eventExtractor.js.map +1 -0
  84. package/dist/core/astParser/extractors/propExtractor.d.ts +14 -0
  85. package/dist/core/astParser/extractors/propExtractor.d.ts.map +1 -0
  86. package/dist/core/astParser/extractors/propExtractor.js +73 -0
  87. package/dist/core/astParser/extractors/propExtractor.js.map +1 -0
  88. package/dist/core/astParser/extractors/stateExtractor.d.ts +13 -0
  89. package/dist/core/astParser/extractors/stateExtractor.d.ts.map +1 -0
  90. package/dist/core/astParser/extractors/stateExtractor.js +66 -0
  91. package/dist/core/astParser/extractors/stateExtractor.js.map +1 -0
  92. package/dist/core/astParser.d.ts.map +1 -1
  93. package/dist/core/astParser.js +5 -307
  94. package/dist/core/astParser.js.map +1 -1
  95. package/dist/core/contractBuilder.d.ts +1 -0
  96. package/dist/core/contractBuilder.d.ts.map +1 -1
  97. package/dist/core/contractBuilder.js +1 -0
  98. package/dist/core/contractBuilder.js.map +1 -1
  99. package/dist/core/pack/builder.d.ts +35 -0
  100. package/dist/core/pack/builder.d.ts.map +1 -0
  101. package/dist/core/pack/builder.js +76 -0
  102. package/dist/core/pack/builder.js.map +1 -0
  103. package/dist/core/pack/collector.d.ts +20 -0
  104. package/dist/core/pack/collector.d.ts.map +1 -0
  105. package/dist/core/pack/collector.js +71 -0
  106. package/dist/core/pack/collector.js.map +1 -0
  107. package/dist/core/pack/loader.d.ts +23 -0
  108. package/dist/core/pack/loader.d.ts.map +1 -0
  109. package/dist/core/pack/loader.js +66 -0
  110. package/dist/core/pack/loader.js.map +1 -0
  111. package/dist/core/pack/resolver.d.ts +21 -0
  112. package/dist/core/pack/resolver.d.ts.map +1 -0
  113. package/dist/core/pack/resolver.js +79 -0
  114. package/dist/core/pack/resolver.js.map +1 -0
  115. package/dist/core/pack.d.ts +17 -27
  116. package/dist/core/pack.d.ts.map +1 -1
  117. package/dist/core/pack.js +18 -225
  118. package/dist/core/pack.js.map +1 -1
  119. package/dist/core/styleExtractor/index.d.ts +11 -0
  120. package/dist/core/styleExtractor/index.d.ts.map +1 -0
  121. package/dist/core/styleExtractor/index.js +11 -0
  122. package/dist/core/styleExtractor/index.js.map +1 -0
  123. package/dist/core/styleExtractor/layout.d.ts +14 -0
  124. package/dist/core/styleExtractor/layout.d.ts.map +1 -0
  125. package/dist/core/styleExtractor/layout.js +86 -0
  126. package/dist/core/styleExtractor/layout.js.map +1 -0
  127. package/dist/core/styleExtractor/motion.d.ts +20 -0
  128. package/dist/core/styleExtractor/motion.d.ts.map +1 -0
  129. package/dist/core/styleExtractor/motion.js +74 -0
  130. package/dist/core/styleExtractor/motion.js.map +1 -0
  131. package/dist/core/styleExtractor/scss.d.ts +30 -0
  132. package/dist/core/styleExtractor/scss.d.ts.map +1 -0
  133. package/dist/core/styleExtractor/scss.js +80 -0
  134. package/dist/core/styleExtractor/scss.js.map +1 -0
  135. package/dist/core/styleExtractor/styleExtractor.d.ts +11 -0
  136. package/dist/core/styleExtractor/styleExtractor.d.ts.map +1 -0
  137. package/dist/core/styleExtractor/styleExtractor.js +115 -0
  138. package/dist/core/styleExtractor/styleExtractor.js.map +1 -0
  139. package/dist/core/styleExtractor/styled.d.ts +13 -0
  140. package/dist/core/styleExtractor/styled.d.ts.map +1 -0
  141. package/dist/core/styleExtractor/styled.js +31 -0
  142. package/dist/core/styleExtractor/styled.js.map +1 -0
  143. package/dist/core/styleExtractor/tailwind.d.ts +16 -0
  144. package/dist/core/styleExtractor/tailwind.d.ts.map +1 -0
  145. package/dist/core/styleExtractor/tailwind.js +85 -0
  146. package/dist/core/styleExtractor/tailwind.js.map +1 -0
  147. package/dist/core/styleExtractor.d.ts +8 -0
  148. package/dist/core/styleExtractor.d.ts.map +1 -0
  149. package/dist/core/styleExtractor.js +8 -0
  150. package/dist/core/styleExtractor.js.map +1 -0
  151. package/dist/types/UIFContract.d.ts +71 -0
  152. package/dist/types/UIFContract.d.ts.map +1 -1
  153. package/dist/types/UIFContract.js.map +1 -1
  154. package/dist/utils/tokens.d.ts +18 -10
  155. package/dist/utils/tokens.d.ts.map +1 -1
  156. package/dist/utils/tokens.js +100 -10
  157. package/dist/utils/tokens.js.map +1 -1
  158. package/package.json +5 -1
  159. package/schema/logicstamp.context.schema.json +288 -0
@@ -195,6 +195,10 @@
195
195
  "links": {
196
196
  "$ref": "#/definitions/ContractLinks"
197
197
  },
198
+ "style": {
199
+ "$ref": "#/definitions/StyleMetadata",
200
+ "description": "Optional style metadata (only when --include-style is used)"
201
+ },
198
202
  "semanticHash": {
199
203
  "type": "string",
200
204
  "pattern": "^uif:[a-f0-9]{24}$",
@@ -425,6 +429,290 @@
425
429
  }
426
430
  },
427
431
  "additionalProperties": false
432
+ },
433
+ "StyleMetadata": {
434
+ "type": "object",
435
+ "properties": {
436
+ "styleSources": {
437
+ "$ref": "#/definitions/StyleSources"
438
+ },
439
+ "layout": {
440
+ "$ref": "#/definitions/LayoutMetadata"
441
+ },
442
+ "visual": {
443
+ "$ref": "#/definitions/VisualMetadata"
444
+ },
445
+ "animation": {
446
+ "$ref": "#/definitions/AnimationMetadata"
447
+ },
448
+ "pageLayout": {
449
+ "$ref": "#/definitions/PageLayoutMetadata"
450
+ }
451
+ },
452
+ "additionalProperties": false
453
+ },
454
+ "StyleSources": {
455
+ "type": "object",
456
+ "properties": {
457
+ "tailwind": {
458
+ "type": "object",
459
+ "properties": {
460
+ "categories": {
461
+ "type": "object",
462
+ "additionalProperties": {
463
+ "type": "array",
464
+ "items": {
465
+ "type": "string"
466
+ }
467
+ },
468
+ "description": "Tailwind classes categorized by type (layout, spacing, colors, typography, borders, effects)"
469
+ },
470
+ "breakpoints": {
471
+ "type": "array",
472
+ "items": {
473
+ "type": "string"
474
+ },
475
+ "description": "Responsive breakpoints used (sm, md, lg, xl, 2xl)"
476
+ },
477
+ "classCount": {
478
+ "type": "number",
479
+ "description": "Total number of Tailwind classes detected"
480
+ }
481
+ },
482
+ "additionalProperties": false
483
+ },
484
+ "scssModule": {
485
+ "type": "string",
486
+ "description": "Path to imported SCSS module file"
487
+ },
488
+ "scssDetails": {
489
+ "type": "object",
490
+ "properties": {
491
+ "selectors": {
492
+ "type": "array",
493
+ "items": {
494
+ "type": "string"
495
+ },
496
+ "description": "CSS selectors found in the SCSS file"
497
+ },
498
+ "properties": {
499
+ "type": "array",
500
+ "items": {
501
+ "type": "string"
502
+ },
503
+ "description": "CSS properties used"
504
+ },
505
+ "features": {
506
+ "type": "object",
507
+ "properties": {
508
+ "variables": {
509
+ "type": "boolean",
510
+ "description": "Uses SCSS variables"
511
+ },
512
+ "nesting": {
513
+ "type": "boolean",
514
+ "description": "Uses SCSS nesting"
515
+ },
516
+ "mixins": {
517
+ "type": "boolean",
518
+ "description": "Uses SCSS mixins"
519
+ }
520
+ },
521
+ "additionalProperties": false
522
+ }
523
+ },
524
+ "additionalProperties": false
525
+ },
526
+ "cssModule": {
527
+ "type": "string",
528
+ "description": "Path to imported CSS module file"
529
+ },
530
+ "cssDetails": {
531
+ "type": "object",
532
+ "properties": {
533
+ "selectors": {
534
+ "type": "array",
535
+ "items": {
536
+ "type": "string"
537
+ }
538
+ },
539
+ "properties": {
540
+ "type": "array",
541
+ "items": {
542
+ "type": "string"
543
+ }
544
+ }
545
+ },
546
+ "additionalProperties": false
547
+ },
548
+ "inlineStyles": {
549
+ "type": "boolean",
550
+ "description": "Uses inline styles (style={{...}})"
551
+ },
552
+ "styledComponents": {
553
+ "type": "object",
554
+ "properties": {
555
+ "components": {
556
+ "type": "array",
557
+ "items": {
558
+ "type": "string"
559
+ },
560
+ "description": "Styled component names (e.g., ['div', 'Button'])"
561
+ },
562
+ "usesTheme": {
563
+ "type": "boolean",
564
+ "description": "Uses theme"
565
+ },
566
+ "usesCssProp": {
567
+ "type": "boolean",
568
+ "description": "Uses css prop"
569
+ }
570
+ },
571
+ "additionalProperties": false
572
+ },
573
+ "motion": {
574
+ "type": "object",
575
+ "properties": {
576
+ "components": {
577
+ "type": "array",
578
+ "items": {
579
+ "type": "string"
580
+ },
581
+ "description": "Motion components (motion.div, motion.button, etc.)"
582
+ },
583
+ "variants": {
584
+ "type": "array",
585
+ "items": {
586
+ "type": "string"
587
+ },
588
+ "description": "Variant names used"
589
+ },
590
+ "features": {
591
+ "type": "object",
592
+ "properties": {
593
+ "gestures": {
594
+ "type": "boolean",
595
+ "description": "Uses gesture handlers (whileHover, whileTap, etc.)"
596
+ },
597
+ "layoutAnimations": {
598
+ "type": "boolean",
599
+ "description": "Uses layout animations (layout prop)"
600
+ },
601
+ "viewportAnimations": {
602
+ "type": "boolean",
603
+ "description": "Uses viewport-triggered animations (useInView, viewport)"
604
+ }
605
+ },
606
+ "required": ["gestures", "layoutAnimations", "viewportAnimations"],
607
+ "additionalProperties": false
608
+ }
609
+ },
610
+ "required": ["features"],
611
+ "additionalProperties": false
612
+ }
613
+ },
614
+ "additionalProperties": false
615
+ },
616
+ "LayoutMetadata": {
617
+ "type": "object",
618
+ "properties": {
619
+ "type": {
620
+ "type": "string",
621
+ "enum": ["flex", "grid", "relative", "absolute"],
622
+ "description": "Layout type"
623
+ },
624
+ "cols": {
625
+ "type": "string",
626
+ "description": "Grid column pattern (e.g., 'grid-cols-2 md:grid-cols-3')"
627
+ },
628
+ "hasHeroPattern": {
629
+ "type": "boolean",
630
+ "description": "Indicates hero section pattern (large text + CTA buttons)"
631
+ },
632
+ "hasFeatureCards": {
633
+ "type": "boolean",
634
+ "description": "Indicates feature card grid pattern"
635
+ },
636
+ "sections": {
637
+ "type": "array",
638
+ "items": {
639
+ "type": "string"
640
+ },
641
+ "description": "Identified page sections"
642
+ }
643
+ },
644
+ "additionalProperties": false
645
+ },
646
+ "VisualMetadata": {
647
+ "type": "object",
648
+ "properties": {
649
+ "colors": {
650
+ "type": "array",
651
+ "items": {
652
+ "type": "string"
653
+ },
654
+ "description": "Color utility classes (sorted, limited to top 10)"
655
+ },
656
+ "spacing": {
657
+ "type": "array",
658
+ "items": {
659
+ "type": "string"
660
+ },
661
+ "description": "Spacing utility classes (sorted, limited to top 10)"
662
+ },
663
+ "radius": {
664
+ "type": "string",
665
+ "description": "Most common border radius pattern"
666
+ },
667
+ "typography": {
668
+ "type": "array",
669
+ "items": {
670
+ "type": "string"
671
+ },
672
+ "description": "Typography classes (sorted, limited to top 10)"
673
+ }
674
+ },
675
+ "additionalProperties": false
676
+ },
677
+ "AnimationMetadata": {
678
+ "type": "object",
679
+ "properties": {
680
+ "type": {
681
+ "type": "string",
682
+ "description": "Animation type (e.g., 'fade-in', 'slide')"
683
+ },
684
+ "library": {
685
+ "type": "string",
686
+ "enum": ["framer-motion", "css"],
687
+ "description": "Animation library"
688
+ },
689
+ "trigger": {
690
+ "type": "string",
691
+ "description": "Trigger type (e.g., 'inView', 'hover', 'click')"
692
+ }
693
+ },
694
+ "additionalProperties": false
695
+ },
696
+ "PageLayoutMetadata": {
697
+ "type": "object",
698
+ "properties": {
699
+ "pageRole": {
700
+ "type": "string",
701
+ "description": "Page role (e.g., 'landing', 'dashboard')"
702
+ },
703
+ "sections": {
704
+ "type": "array",
705
+ "items": {
706
+ "type": "string"
707
+ },
708
+ "description": "Page sections"
709
+ },
710
+ "ctaCount": {
711
+ "type": "number",
712
+ "description": "Number of call-to-action elements"
713
+ }
714
+ },
715
+ "additionalProperties": false
428
716
  }
429
717
  }
430
718
  }