@salesforce/metadata-core-sdk 1.0.0

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 (150) hide show
  1. package/LICENSE.txt +27 -0
  2. package/README.md +219 -0
  3. package/dist/index.d.ts +38 -0
  4. package/dist/index.d.ts.map +1 -0
  5. package/dist/index.js +22 -0
  6. package/dist/index.js.map +1 -0
  7. package/dist/sdk/abstractions/core/IPlatformContext.d.ts +45 -0
  8. package/dist/sdk/abstractions/core/IPlatformContext.d.ts.map +1 -0
  9. package/dist/sdk/abstractions/core/IPlatformContext.js +8 -0
  10. package/dist/sdk/abstractions/core/IPlatformContext.js.map +1 -0
  11. package/dist/sdk/abstractions/core/index.d.ts +8 -0
  12. package/dist/sdk/abstractions/core/index.d.ts.map +1 -0
  13. package/dist/sdk/abstractions/core/index.js +8 -0
  14. package/dist/sdk/abstractions/core/index.js.map +1 -0
  15. package/dist/sdk/abstractions/index.d.ts +17 -0
  16. package/dist/sdk/abstractions/index.d.ts.map +1 -0
  17. package/dist/sdk/abstractions/index.js +20 -0
  18. package/dist/sdk/abstractions/index.js.map +1 -0
  19. package/dist/sdk/abstractions/services/IFileSystem.d.ts +114 -0
  20. package/dist/sdk/abstractions/services/IFileSystem.d.ts.map +1 -0
  21. package/dist/sdk/abstractions/services/IFileSystem.js +8 -0
  22. package/dist/sdk/abstractions/services/IFileSystem.js.map +1 -0
  23. package/dist/sdk/abstractions/services/ILogger.d.ts +63 -0
  24. package/dist/sdk/abstractions/services/ILogger.d.ts.map +1 -0
  25. package/dist/sdk/abstractions/services/ILogger.js +18 -0
  26. package/dist/sdk/abstractions/services/ILogger.js.map +1 -0
  27. package/dist/sdk/abstractions/services/ITelemetry.d.ts +159 -0
  28. package/dist/sdk/abstractions/services/ITelemetry.d.ts.map +1 -0
  29. package/dist/sdk/abstractions/services/ITelemetry.js +97 -0
  30. package/dist/sdk/abstractions/services/ITelemetry.js.map +1 -0
  31. package/dist/sdk/abstractions/services/index.d.ts +10 -0
  32. package/dist/sdk/abstractions/services/index.d.ts.map +1 -0
  33. package/dist/sdk/abstractions/services/index.js +10 -0
  34. package/dist/sdk/abstractions/services/index.js.map +1 -0
  35. package/dist/sdk/abstractions/types/FileMetadata.d.ts +15 -0
  36. package/dist/sdk/abstractions/types/FileMetadata.d.ts.map +1 -0
  37. package/dist/sdk/abstractions/types/FileMetadata.js +8 -0
  38. package/dist/sdk/abstractions/types/FileMetadata.js.map +1 -0
  39. package/dist/sdk/abstractions/types/Result.d.ts +15 -0
  40. package/dist/sdk/abstractions/types/Result.d.ts.map +1 -0
  41. package/dist/sdk/abstractions/types/Result.js +8 -0
  42. package/dist/sdk/abstractions/types/Result.js.map +1 -0
  43. package/dist/sdk/abstractions/types/index.d.ts +9 -0
  44. package/dist/sdk/abstractions/types/index.d.ts.map +1 -0
  45. package/dist/sdk/abstractions/types/index.js +9 -0
  46. package/dist/sdk/abstractions/types/index.js.map +1 -0
  47. package/dist/sdk/constants.d.ts +35 -0
  48. package/dist/sdk/constants.d.ts.map +1 -0
  49. package/dist/sdk/constants.js +35 -0
  50. package/dist/sdk/constants.js.map +1 -0
  51. package/dist/sdk/contracts/core/IMetadataParser.d.ts +49 -0
  52. package/dist/sdk/contracts/core/IMetadataParser.d.ts.map +1 -0
  53. package/dist/sdk/contracts/core/IMetadataParser.js +8 -0
  54. package/dist/sdk/contracts/core/IMetadataParser.js.map +1 -0
  55. package/dist/sdk/contracts/core/IVisualizationPlugin.d.ts +65 -0
  56. package/dist/sdk/contracts/core/IVisualizationPlugin.d.ts.map +1 -0
  57. package/dist/sdk/contracts/core/IVisualizationPlugin.js +8 -0
  58. package/dist/sdk/contracts/core/IVisualizationPlugin.js.map +1 -0
  59. package/dist/sdk/contracts/core/index.d.ts +9 -0
  60. package/dist/sdk/contracts/core/index.d.ts.map +1 -0
  61. package/dist/sdk/contracts/core/index.js +9 -0
  62. package/dist/sdk/contracts/core/index.js.map +1 -0
  63. package/dist/sdk/contracts/index.d.ts +9 -0
  64. package/dist/sdk/contracts/index.d.ts.map +1 -0
  65. package/dist/sdk/contracts/index.js +9 -0
  66. package/dist/sdk/contracts/index.js.map +1 -0
  67. package/dist/sdk/contracts/types/MetadataPluginInfo.d.ts +56 -0
  68. package/dist/sdk/contracts/types/MetadataPluginInfo.d.ts.map +1 -0
  69. package/dist/sdk/contracts/types/MetadataPluginInfo.js +8 -0
  70. package/dist/sdk/contracts/types/MetadataPluginInfo.js.map +1 -0
  71. package/dist/sdk/contracts/types/PluginConfig.d.ts +16 -0
  72. package/dist/sdk/contracts/types/PluginConfig.d.ts.map +1 -0
  73. package/dist/sdk/contracts/types/PluginConfig.js +8 -0
  74. package/dist/sdk/contracts/types/PluginConfig.js.map +1 -0
  75. package/dist/sdk/contracts/types/PluginContext.d.ts +22 -0
  76. package/dist/sdk/contracts/types/PluginContext.d.ts.map +1 -0
  77. package/dist/sdk/contracts/types/PluginContext.js +8 -0
  78. package/dist/sdk/contracts/types/PluginContext.js.map +1 -0
  79. package/dist/sdk/contracts/types/PluginError.d.ts +50 -0
  80. package/dist/sdk/contracts/types/PluginError.d.ts.map +1 -0
  81. package/dist/sdk/contracts/types/PluginError.js +31 -0
  82. package/dist/sdk/contracts/types/PluginError.js.map +1 -0
  83. package/dist/sdk/contracts/types/ValidationResult.d.ts +15 -0
  84. package/dist/sdk/contracts/types/ValidationResult.d.ts.map +1 -0
  85. package/dist/sdk/contracts/types/ValidationResult.js +8 -0
  86. package/dist/sdk/contracts/types/ValidationResult.js.map +1 -0
  87. package/dist/sdk/contracts/types/VersionInfo.d.ts +24 -0
  88. package/dist/sdk/contracts/types/VersionInfo.d.ts.map +1 -0
  89. package/dist/sdk/contracts/types/VersionInfo.js +8 -0
  90. package/dist/sdk/contracts/types/VersionInfo.js.map +1 -0
  91. package/dist/sdk/contracts/types/index.d.ts +13 -0
  92. package/dist/sdk/contracts/types/index.d.ts.map +1 -0
  93. package/dist/sdk/contracts/types/index.js +13 -0
  94. package/dist/sdk/contracts/types/index.js.map +1 -0
  95. package/dist/sdk/design-system/index.d.ts +11 -0
  96. package/dist/sdk/design-system/index.d.ts.map +1 -0
  97. package/dist/sdk/design-system/index.js +12 -0
  98. package/dist/sdk/design-system/index.js.map +1 -0
  99. package/dist/sdk/design-system/tokens/colors.d.ts +122 -0
  100. package/dist/sdk/design-system/tokens/colors.d.ts.map +1 -0
  101. package/dist/sdk/design-system/tokens/colors.js +142 -0
  102. package/dist/sdk/design-system/tokens/colors.js.map +1 -0
  103. package/dist/sdk/design-system/tokens/spacing.d.ts +24 -0
  104. package/dist/sdk/design-system/tokens/spacing.d.ts.map +1 -0
  105. package/dist/sdk/design-system/tokens/spacing.js +24 -0
  106. package/dist/sdk/design-system/tokens/spacing.js.map +1 -0
  107. package/dist/sdk/design-system/tokens/typography.d.ts +31 -0
  108. package/dist/sdk/design-system/tokens/typography.d.ts.map +1 -0
  109. package/dist/sdk/design-system/tokens/typography.js +31 -0
  110. package/dist/sdk/design-system/tokens/typography.js.map +1 -0
  111. package/dist/sdk/design-system/utils.d.ts +66 -0
  112. package/dist/sdk/design-system/utils.d.ts.map +1 -0
  113. package/dist/sdk/design-system/utils.js +116 -0
  114. package/dist/sdk/design-system/utils.js.map +1 -0
  115. package/dist/sdk/design-system/vscode-design-system.css +623 -0
  116. package/dist/sdk/utils/errors/ErrorBoundary.d.ts +35 -0
  117. package/dist/sdk/utils/errors/ErrorBoundary.d.ts.map +1 -0
  118. package/dist/sdk/utils/errors/ErrorBoundary.js +65 -0
  119. package/dist/sdk/utils/errors/ErrorBoundary.js.map +1 -0
  120. package/dist/sdk/utils/errors/ErrorBuilder.d.ts +107 -0
  121. package/dist/sdk/utils/errors/ErrorBuilder.d.ts.map +1 -0
  122. package/dist/sdk/utils/errors/ErrorBuilder.js +163 -0
  123. package/dist/sdk/utils/errors/ErrorBuilder.js.map +1 -0
  124. package/dist/sdk/utils/errors/setupHandlers.d.ts +12 -0
  125. package/dist/sdk/utils/errors/setupHandlers.d.ts.map +1 -0
  126. package/dist/sdk/utils/errors/setupHandlers.js +42 -0
  127. package/dist/sdk/utils/errors/setupHandlers.js.map +1 -0
  128. package/dist/sdk/utils/logger.d.ts +41 -0
  129. package/dist/sdk/utils/logger.d.ts.map +1 -0
  130. package/dist/sdk/utils/logger.js +54 -0
  131. package/dist/sdk/utils/logger.js.map +1 -0
  132. package/dist/sdk/utils/test-helpers/architecture-test-utils.d.ts +146 -0
  133. package/dist/sdk/utils/test-helpers/architecture-test-utils.d.ts.map +1 -0
  134. package/dist/sdk/utils/test-helpers/architecture-test-utils.js +286 -0
  135. package/dist/sdk/utils/test-helpers/architecture-test-utils.js.map +1 -0
  136. package/dist/sdk/utils/test-helpers/index.d.ts +8 -0
  137. package/dist/sdk/utils/test-helpers/index.d.ts.map +1 -0
  138. package/dist/sdk/utils/test-helpers/index.js +8 -0
  139. package/dist/sdk/utils/test-helpers/index.js.map +1 -0
  140. package/dist/sdk/utils/xmlParser.d.ts +38 -0
  141. package/dist/sdk/utils/xmlParser.d.ts.map +1 -0
  142. package/dist/sdk/utils/xmlParser.js +79 -0
  143. package/dist/sdk/utils/xmlParser.js.map +1 -0
  144. package/dist/sdk/webviewMessageTypes.d.ts +24 -0
  145. package/dist/sdk/webviewMessageTypes.d.ts.map +1 -0
  146. package/dist/sdk/webviewMessageTypes.js +23 -0
  147. package/dist/sdk/webviewMessageTypes.js.map +1 -0
  148. package/package.json +80 -0
  149. package/src/sdk/utils/test-helpers/architecture-test-utils.ts +365 -0
  150. package/src/sdk/utils/test-helpers/index.ts +20 -0
@@ -0,0 +1,142 @@
1
+ /**
2
+ * Copyright (c) 2025, Salesforce, Inc.
3
+ * All rights reserved.
4
+ * Licensed under the BSD 3-Clause license.
5
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
6
+ **/
7
+ export const colorTokens = {
8
+ // ===== SEMANTIC TOKEN SYSTEM =====
9
+ // Based on Viz. & Preview Guidelines for native VS Code integration
10
+ // 1. Canvas & Shell (Global Environment)
11
+ canvas: {
12
+ bg: '--mv-canvas-bg',
13
+ grid: '--mv-canvas-grid',
14
+ minimapBg: '--mv-minimap-bg',
15
+ },
16
+ panel: {
17
+ bg: '--mv-panel-bg',
18
+ border: '--mv-panel-border',
19
+ shadow: '--mv-panel-shadow',
20
+ },
21
+ // 2. Core Entities (Node Contract)
22
+ node: {
23
+ bg: '--mv-node-bg',
24
+ border: '--mv-node-border',
25
+ bgHover: '--mv-node-bg-hover',
26
+ bgSelected: '--mv-node-bg-selected',
27
+ fg: '--mv-node-fg',
28
+ fgSecondary: '--mv-node-fg-secondary',
29
+ },
30
+ edge: {
31
+ neutral: '--mv-edge-neutral',
32
+ active: '--mv-edge-active',
33
+ },
34
+ // 3. Semantic Variants (Framework API)
35
+ // 3A. Functional Accents - The "Four Pillars"
36
+ // Teams must map their metadata concepts to these four categories
37
+ functionalAccents: {
38
+ data: '--mv-accent-data', // Persistence: SObjects, Fields, Custom Settings
39
+ logic: '--mv-accent-logic', // Processing: Apex, Flow, Triggers, Bots
40
+ ui: '--mv-accent-ui', // Presentation: Flexipages, LWC, Layouts, Tabs
41
+ system: '--mv-accent-system', // Configuration: Profiles, Perm Sets, Connected Apps
42
+ },
43
+ // 3B. State Indicators - Universal Status
44
+ // Teams must use these for state indication
45
+ stateIndicators: {
46
+ positive: '--mv-status-positive', // Valid, Active, Granted, Success, Start
47
+ negative: '--mv-status-negative', // Invalid, Error, Blocked, Denied, Stop
48
+ warning: '--mv-status-warning', // Deprecated, Draft, Inactive, Decision
49
+ info: '--mv-status-info', // Reference, Annotation, Note
50
+ neutral: '--mv-status-neutral', // Inactive, Null, Skipped, Unknown
51
+ },
52
+ // 4. Internal Component Tokens
53
+ marker: {
54
+ primary: '--mv-marker-primary',
55
+ muted: '--mv-marker-muted',
56
+ },
57
+ separator: '--mv-separator',
58
+ regionZone: '--mv-region-zone',
59
+ // 5. Accessibility (High Contrast)
60
+ highContrast: {
61
+ border: '--mv-hc-border',
62
+ selection: '--mv-hc-selection',
63
+ },
64
+ // ===== GENERAL PURPOSE TOKENS =====
65
+ // Background colors
66
+ backgrounds: {
67
+ primary: '--mv-bg-primary',
68
+ secondary: '--mv-bg-secondary',
69
+ elevated: '--mv-bg-elevated',
70
+ surface: '--mv-bg-surface',
71
+ surfaceHover: '--mv-bg-surface-hover',
72
+ input: '--mv-bg-input',
73
+ overlay: '--mv-bg-overlay',
74
+ },
75
+ // Text colors
76
+ text: {
77
+ primary: '--mv-text-primary',
78
+ secondary: '--mv-text-secondary',
79
+ muted: '--mv-text-muted',
80
+ inverse: '--mv-text-inverse',
81
+ },
82
+ // Interactive colors
83
+ interactive: {
84
+ primary: '--mv-interactive-primary',
85
+ primaryHover: '--mv-interactive-primary-hover',
86
+ secondary: '--mv-interactive-secondary',
87
+ focus: '--mv-interactive-focus',
88
+ focusBorder: '--mv-interactive-focus-border',
89
+ },
90
+ // Button colors
91
+ button: {
92
+ primaryBg: '--mv-button-primary-bg',
93
+ primaryFg: '--mv-button-primary-fg',
94
+ secondaryBg: '--mv-button-secondary-bg',
95
+ secondaryFg: '--mv-button-secondary-fg',
96
+ },
97
+ // Border colors
98
+ borders: {
99
+ default: '--mv-border-default',
100
+ primary: '--mv-border-primary',
101
+ hover: '--mv-border-hover',
102
+ input: '--mv-border-input',
103
+ focus: '--mv-border-focus',
104
+ dropdown: '--mv-border-dropdown',
105
+ },
106
+ // Status colors
107
+ status: {
108
+ error: '--mv-status-error',
109
+ errorBg: '--mv-status-error-bg',
110
+ errorBorder: '--mv-status-error-border',
111
+ warning: '--mv-status-warning',
112
+ warningBg: '--mv-status-warning-bg',
113
+ warningBorder: '--mv-status-warning-border',
114
+ success: '--mv-status-success',
115
+ info: '--mv-status-info',
116
+ infoBg: '--mv-status-info-bg',
117
+ infoBorder: '--mv-status-info-border',
118
+ },
119
+ // Accent colors
120
+ accents: {
121
+ cyan: '--mv-accent-cyan',
122
+ cyanLight: '--mv-accent-cyan-light',
123
+ yellow: '--mv-accent-yellow',
124
+ },
125
+ // Shadow colors
126
+ shadows: {
127
+ light: '--mv-shadow-light',
128
+ medium: '--mv-shadow-medium',
129
+ heavy: '--mv-shadow-heavy',
130
+ text: '--mv-shadow-text',
131
+ },
132
+ };
133
+ /**
134
+ * CSS shadow utilities
135
+ */
136
+ export const shadowTokens = {
137
+ sm: '--mv-shadow-sm',
138
+ md: '--mv-shadow-md',
139
+ lg: '--mv-shadow-lg',
140
+ xl: '--mv-shadow-xl',
141
+ };
142
+ //# sourceMappingURL=colors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"colors.js","sourceRoot":"","sources":["../../../../src/sdk/design-system/tokens/colors.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,oCAAoC;IACpC,oEAAoE;IAEpE,yCAAyC;IACzC,MAAM,EAAE;QACN,EAAE,EAAE,gBAAgB;QACpB,IAAI,EAAE,kBAAkB;QACxB,SAAS,EAAE,iBAAiB;KAC7B;IAED,KAAK,EAAE;QACL,EAAE,EAAE,eAAe;QACnB,MAAM,EAAE,mBAAmB;QAC3B,MAAM,EAAE,mBAAmB;KAC5B;IAED,mCAAmC;IACnC,IAAI,EAAE;QACJ,EAAE,EAAE,cAAc;QAClB,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,oBAAoB;QAC7B,UAAU,EAAE,uBAAuB;QACnC,EAAE,EAAE,cAAc;QAClB,WAAW,EAAE,wBAAwB;KACtC;IAED,IAAI,EAAE;QACJ,OAAO,EAAE,mBAAmB;QAC5B,MAAM,EAAE,kBAAkB;KAC3B;IAED,uCAAuC;IAEvC,8CAA8C;IAC9C,kEAAkE;IAClE,iBAAiB,EAAE;QACjB,IAAI,EAAE,kBAAkB,EAAE,iDAAiD;QAC3E,KAAK,EAAE,mBAAmB,EAAE,yCAAyC;QACrE,EAAE,EAAE,gBAAgB,EAAE,+CAA+C;QACrE,MAAM,EAAE,oBAAoB,EAAE,qDAAqD;KACpF;IAED,0CAA0C;IAC1C,4CAA4C;IAC5C,eAAe,EAAE;QACf,QAAQ,EAAE,sBAAsB,EAAE,yCAAyC;QAC3E,QAAQ,EAAE,sBAAsB,EAAE,wCAAwC;QAC1E,OAAO,EAAE,qBAAqB,EAAE,wCAAwC;QACxE,IAAI,EAAE,kBAAkB,EAAE,8BAA8B;QACxD,OAAO,EAAE,qBAAqB,EAAE,mCAAmC;KACpE;IAED,+BAA+B;IAC/B,MAAM,EAAE;QACN,OAAO,EAAE,qBAAqB;QAC9B,KAAK,EAAE,mBAAmB;KAC3B;IAED,SAAS,EAAE,gBAAgB;IAC3B,UAAU,EAAE,kBAAkB;IAE9B,mCAAmC;IACnC,YAAY,EAAE;QACZ,MAAM,EAAE,gBAAgB;QACxB,SAAS,EAAE,mBAAmB;KAC/B;IAED,qCAAqC;IAErC,oBAAoB;IACpB,WAAW,EAAE;QACX,OAAO,EAAE,iBAAiB;QAC1B,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,kBAAkB;QAC5B,OAAO,EAAE,iBAAiB;QAC1B,YAAY,EAAE,uBAAuB;QACrC,KAAK,EAAE,eAAe;QACtB,OAAO,EAAE,iBAAiB;KAC3B;IAED,cAAc;IACd,IAAI,EAAE;QACJ,OAAO,EAAE,mBAAmB;QAC5B,SAAS,EAAE,qBAAqB;QAChC,KAAK,EAAE,iBAAiB;QACxB,OAAO,EAAE,mBAAmB;KAC7B;IAED,qBAAqB;IACrB,WAAW,EAAE;QACX,OAAO,EAAE,0BAA0B;QACnC,YAAY,EAAE,gCAAgC;QAC9C,SAAS,EAAE,4BAA4B;QACvC,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,+BAA+B;KAC7C;IAED,gBAAgB;IAChB,MAAM,EAAE;QACN,SAAS,EAAE,wBAAwB;QACnC,SAAS,EAAE,wBAAwB;QACnC,WAAW,EAAE,0BAA0B;QACvC,WAAW,EAAE,0BAA0B;KACxC;IAED,gBAAgB;IAChB,OAAO,EAAE;QACP,OAAO,EAAE,qBAAqB;QAC9B,OAAO,EAAE,qBAAqB;QAC9B,KAAK,EAAE,mBAAmB;QAC1B,KAAK,EAAE,mBAAmB;QAC1B,KAAK,EAAE,mBAAmB;QAC1B,QAAQ,EAAE,sBAAsB;KACjC;IAED,gBAAgB;IAChB,MAAM,EAAE;QACN,KAAK,EAAE,mBAAmB;QAC1B,OAAO,EAAE,sBAAsB;QAC/B,WAAW,EAAE,0BAA0B;QACvC,OAAO,EAAE,qBAAqB;QAC9B,SAAS,EAAE,wBAAwB;QACnC,aAAa,EAAE,4BAA4B;QAC3C,OAAO,EAAE,qBAAqB;QAC9B,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,qBAAqB;QAC7B,UAAU,EAAE,yBAAyB;KACtC;IAED,gBAAgB;IAChB,OAAO,EAAE;QACP,IAAI,EAAE,kBAAkB;QACxB,SAAS,EAAE,wBAAwB;QACnC,MAAM,EAAE,oBAAoB;KAC7B;IAED,gBAAgB;IAChB,OAAO,EAAE;QACP,KAAK,EAAE,mBAAmB;QAC1B,MAAM,EAAE,oBAAoB;QAC5B,KAAK,EAAE,mBAAmB;QAC1B,IAAI,EAAE,kBAAkB;KACzB;CACO,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,EAAE,EAAE,gBAAgB;IACpB,EAAE,EAAE,gBAAgB;IACpB,EAAE,EAAE,gBAAgB;IACpB,EAAE,EAAE,gBAAgB;CACZ,CAAC"}
@@ -0,0 +1,24 @@
1
+ /**
2
+ * Copyright (c) 2025, Salesforce, Inc.
3
+ * All rights reserved.
4
+ * Licensed under the BSD 3-Clause license.
5
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
6
+ **/
7
+ export declare const spacingTokens: {
8
+ readonly xs: "var(--mv-spacing-xs)";
9
+ readonly sm: "var(--mv-spacing-sm)";
10
+ readonly md: "var(--mv-spacing-md)";
11
+ readonly lg: "var(--mv-spacing-lg)";
12
+ readonly xl: "var(--mv-spacing-xl)";
13
+ readonly '2xl': "var(--mv-spacing-2xl)";
14
+ readonly '3xl': "var(--mv-spacing-3xl)";
15
+ };
16
+ export declare const borderRadiusTokens: {
17
+ readonly none: "var(--mv-radius-none)";
18
+ readonly sm: "var(--mv-radius-sm)";
19
+ readonly md: "var(--mv-radius-md)";
20
+ readonly lg: "var(--mv-radius-lg)";
21
+ readonly xl: "var(--mv-radius-xl)";
22
+ readonly full: "var(--mv-radius-full)";
23
+ };
24
+ //# sourceMappingURL=spacing.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"spacing.d.ts","sourceRoot":"","sources":["../../../../src/sdk/design-system/tokens/spacing.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ,eAAO,MAAM,aAAa;;;;;;;;CAQhB,CAAC;AAEX,eAAO,MAAM,kBAAkB;;;;;;;CAOrB,CAAC"}
@@ -0,0 +1,24 @@
1
+ /**
2
+ * Copyright (c) 2025, Salesforce, Inc.
3
+ * All rights reserved.
4
+ * Licensed under the BSD 3-Clause license.
5
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
6
+ **/
7
+ export const spacingTokens = {
8
+ xs: 'var(--mv-spacing-xs)', // 0.25rem
9
+ sm: 'var(--mv-spacing-sm)', // 0.5rem
10
+ md: 'var(--mv-spacing-md)', // 1rem
11
+ lg: 'var(--mv-spacing-lg)', // 1.5rem
12
+ xl: 'var(--mv-spacing-xl)', // 2rem
13
+ '2xl': 'var(--mv-spacing-2xl)', // 3rem
14
+ '3xl': 'var(--mv-spacing-3xl)', // 4rem
15
+ };
16
+ export const borderRadiusTokens = {
17
+ none: 'var(--mv-radius-none)',
18
+ sm: 'var(--mv-radius-sm)',
19
+ md: 'var(--mv-radius-md)',
20
+ lg: 'var(--mv-radius-lg)',
21
+ xl: 'var(--mv-radius-xl)',
22
+ full: 'var(--mv-radius-full)',
23
+ };
24
+ //# sourceMappingURL=spacing.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"spacing.js","sourceRoot":"","sources":["../../../../src/sdk/design-system/tokens/spacing.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,EAAE,EAAE,sBAAsB,EAAE,UAAU;IACtC,EAAE,EAAE,sBAAsB,EAAE,SAAS;IACrC,EAAE,EAAE,sBAAsB,EAAE,OAAO;IACnC,EAAE,EAAE,sBAAsB,EAAE,SAAS;IACrC,EAAE,EAAE,sBAAsB,EAAE,OAAO;IACnC,KAAK,EAAE,uBAAuB,EAAE,OAAO;IACvC,KAAK,EAAE,uBAAuB,EAAE,OAAO;CAC/B,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,uBAAuB;IAC7B,EAAE,EAAE,qBAAqB;IACzB,EAAE,EAAE,qBAAqB;IACzB,EAAE,EAAE,qBAAqB;IACzB,EAAE,EAAE,qBAAqB;IACzB,IAAI,EAAE,uBAAuB;CACrB,CAAC"}
@@ -0,0 +1,31 @@
1
+ /**
2
+ * Copyright (c) 2025, Salesforce, Inc.
3
+ * All rights reserved.
4
+ * Licensed under the BSD 3-Clause license.
5
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
6
+ **/
7
+ export declare const fontFamilyTokens: {
8
+ readonly default: "var(--mv-font-family)";
9
+ readonly mono: "var(--mv-font-family-mono)";
10
+ };
11
+ export declare const fontSizeTokens: {
12
+ readonly xs: "var(--mv-font-size-xs)";
13
+ readonly sm: "var(--mv-font-size-sm)";
14
+ readonly base: "var(--mv-font-size-base)";
15
+ readonly lg: "var(--mv-font-size-lg)";
16
+ readonly xl: "var(--mv-font-size-xl)";
17
+ readonly '2xl': "var(--mv-font-size-2xl)";
18
+ readonly '3xl': "var(--mv-font-size-3xl)";
19
+ };
20
+ export declare const fontWeightTokens: {
21
+ readonly normal: "var(--mv-font-weight-normal)";
22
+ readonly medium: "var(--mv-font-weight-medium)";
23
+ readonly semibold: "var(--mv-font-weight-semibold)";
24
+ readonly bold: "var(--mv-font-weight-bold)";
25
+ };
26
+ export declare const lineHeightTokens: {
27
+ readonly tight: "var(--mv-line-height-tight)";
28
+ readonly normal: "var(--mv-line-height-normal)";
29
+ readonly relaxed: "var(--mv-line-height-relaxed)";
30
+ };
31
+ //# sourceMappingURL=typography.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"typography.d.ts","sourceRoot":"","sources":["../../../../src/sdk/design-system/tokens/typography.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ,eAAO,MAAM,gBAAgB;;;CAGnB,CAAC;AAEX,eAAO,MAAM,cAAc;;;;;;;;CAQjB,CAAC;AAEX,eAAO,MAAM,gBAAgB;;;;;CAKnB,CAAC;AAEX,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC"}
@@ -0,0 +1,31 @@
1
+ /**
2
+ * Copyright (c) 2025, Salesforce, Inc.
3
+ * All rights reserved.
4
+ * Licensed under the BSD 3-Clause license.
5
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
6
+ **/
7
+ export const fontFamilyTokens = {
8
+ default: 'var(--mv-font-family)',
9
+ mono: 'var(--mv-font-family-mono)',
10
+ };
11
+ export const fontSizeTokens = {
12
+ xs: 'var(--mv-font-size-xs)',
13
+ sm: 'var(--mv-font-size-sm)',
14
+ base: 'var(--mv-font-size-base)',
15
+ lg: 'var(--mv-font-size-lg)',
16
+ xl: 'var(--mv-font-size-xl)',
17
+ '2xl': 'var(--mv-font-size-2xl)',
18
+ '3xl': 'var(--mv-font-size-3xl)',
19
+ };
20
+ export const fontWeightTokens = {
21
+ normal: 'var(--mv-font-weight-normal)',
22
+ medium: 'var(--mv-font-weight-medium)',
23
+ semibold: 'var(--mv-font-weight-semibold)',
24
+ bold: 'var(--mv-font-weight-bold)',
25
+ };
26
+ export const lineHeightTokens = {
27
+ tight: 'var(--mv-line-height-tight)',
28
+ normal: 'var(--mv-line-height-normal)',
29
+ relaxed: 'var(--mv-line-height-relaxed)',
30
+ };
31
+ //# sourceMappingURL=typography.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"typography.js","sourceRoot":"","sources":["../../../../src/sdk/design-system/tokens/typography.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,OAAO,EAAE,uBAAuB;IAChC,IAAI,EAAE,4BAA4B;CAC1B,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,EAAE,EAAE,wBAAwB;IAC5B,EAAE,EAAE,wBAAwB;IAC5B,IAAI,EAAE,0BAA0B;IAChC,EAAE,EAAE,wBAAwB;IAC5B,EAAE,EAAE,wBAAwB;IAC5B,KAAK,EAAE,yBAAyB;IAChC,KAAK,EAAE,yBAAyB;CACxB,CAAC;AAEX,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,MAAM,EAAE,8BAA8B;IACtC,MAAM,EAAE,8BAA8B;IACtC,QAAQ,EAAE,gCAAgC;IAC1C,IAAI,EAAE,4BAA4B;CAC1B,CAAC;AAEX,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,KAAK,EAAE,6BAA6B;IACpC,MAAM,EAAE,8BAA8B;IACtC,OAAO,EAAE,+BAA+B;CAChC,CAAC"}
@@ -0,0 +1,66 @@
1
+ /**
2
+ * Copyright (c) 2025, Salesforce, Inc.
3
+ * All rights reserved.
4
+ * Licensed under the BSD 3-Clause license.
5
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
6
+ **/
7
+ /**
8
+ * Get the computed value of a CSS variable from the document root
9
+ *
10
+ * @param variable - CSS variable name (e.g., '--mv-bg-primary')
11
+ * @returns The computed value from the document root, or variable name if not in browser context
12
+ *
13
+ * @example
14
+ * ```typescript
15
+ * import { getCSSVariableValue } from '@salesforce/metadata-core-sdk';
16
+ *
17
+ * const primaryBg = getCSSVariableValue('--mv-bg-primary');
18
+ * // Returns actual computed color like "#3c3c3c"
19
+ * ```
20
+ */
21
+ export declare function getCSSVariableValue(variable: string): string;
22
+ /**
23
+ * Get multiple CSS variables at once
24
+ *
25
+ * @param variables - Array of CSS variable names
26
+ * @returns Object mapping variable names to their computed values
27
+ *
28
+ * @example
29
+ * ```typescript
30
+ * const values = getCSSVariableValues(['--mv-bg-primary', '--mv-text-primary']);
31
+ * // Returns: { '--mv-bg-primary': '#3c3c3c', '--mv-text-primary': '#cccccc' }
32
+ * ```
33
+ */
34
+ export declare function getCSSVariableValues(variables: string[]): Record<string, string>;
35
+ /**
36
+ * Resolve token object to computed values
37
+ * Recursively resolves nested token structures by replacing CSS variable names with their computed values
38
+ *
39
+ * @param tokens - Token object with CSS variable names
40
+ * @returns New object with same structure but computed values instead of variable names
41
+ *
42
+ * @example
43
+ * ```typescript
44
+ * import { colorTokens, resolveTokens } from '@salesforce/metadata-core-sdk';
45
+ *
46
+ * const resolved = resolveTokens(colorTokens);
47
+ * // resolved.backgrounds.primary is now "#3c3c3c" instead of "--mv-bg-primary"
48
+ * ```
49
+ */
50
+ export declare function resolveTokens<T extends Record<string, any>>(tokens: T): T;
51
+ /**
52
+ * Helper to wrap a CSS variable name in var() for CSS usage
53
+ *
54
+ * @param variable - CSS variable name (e.g., '--mv-bg-primary')
55
+ * @returns CSS var() function (e.g., 'var(--mv-bg-primary)')
56
+ *
57
+ * @example
58
+ * ```typescript
59
+ * import { colorTokens, cssVar } from '@salesforce/metadata-core-sdk';
60
+ *
61
+ * element.style.backgroundColor = cssVar(colorTokens.backgrounds.primary);
62
+ * // Sets backgroundColor to 'var(--mv-bg-primary)'
63
+ * ```
64
+ */
65
+ export declare function cssVar(variable: string): string;
66
+ //# sourceMappingURL=utils.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/sdk/design-system/utils.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAmBJ;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAe5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMhF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAiBzE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE/C"}
@@ -0,0 +1,116 @@
1
+ /**
2
+ * Copyright (c) 2025, Salesforce, Inc.
3
+ * All rights reserved.
4
+ * Licensed under the BSD 3-Clause license.
5
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
6
+ **/
7
+ /**
8
+ * Generic CSS Variable Resolution Utilities
9
+ *
10
+ * Provides simple, generic utilities for resolving CSS variables at runtime.
11
+ * No plugin-specific logic, no fallback values, no hardcoded CSS variables.
12
+ */
13
+ /**
14
+ * Check if we're in a browser/webview context where DOM is available
15
+ */
16
+ function isBrowserContext() {
17
+ return (typeof globalThis.window !== 'undefined' &&
18
+ typeof globalThis.document !== 'undefined');
19
+ }
20
+ /**
21
+ * Get the computed value of a CSS variable from the document root
22
+ *
23
+ * @param variable - CSS variable name (e.g., '--mv-bg-primary')
24
+ * @returns The computed value from the document root, or variable name if not in browser context
25
+ *
26
+ * @example
27
+ * ```typescript
28
+ * import { getCSSVariableValue } from '@salesforce/metadata-core-sdk';
29
+ *
30
+ * const primaryBg = getCSSVariableValue('--mv-bg-primary');
31
+ * // Returns actual computed color like "#3c3c3c"
32
+ * ```
33
+ */
34
+ export function getCSSVariableValue(variable) {
35
+ if (!isBrowserContext()) {
36
+ // Return the variable name itself as fallback when not in browser context
37
+ // This allows the code to work in Node.js context without errors
38
+ return variable;
39
+ }
40
+ const doc = globalThis.document;
41
+ const getComputedStyle = globalThis.getComputedStyle;
42
+ if (!doc || !getComputedStyle) {
43
+ return variable;
44
+ }
45
+ return getComputedStyle(doc.documentElement).getPropertyValue(variable).trim();
46
+ }
47
+ /**
48
+ * Get multiple CSS variables at once
49
+ *
50
+ * @param variables - Array of CSS variable names
51
+ * @returns Object mapping variable names to their computed values
52
+ *
53
+ * @example
54
+ * ```typescript
55
+ * const values = getCSSVariableValues(['--mv-bg-primary', '--mv-text-primary']);
56
+ * // Returns: { '--mv-bg-primary': '#3c3c3c', '--mv-text-primary': '#cccccc' }
57
+ * ```
58
+ */
59
+ export function getCSSVariableValues(variables) {
60
+ const result = {};
61
+ variables.forEach((variable) => {
62
+ result[variable] = getCSSVariableValue(variable);
63
+ });
64
+ return result;
65
+ }
66
+ /**
67
+ * Resolve token object to computed values
68
+ * Recursively resolves nested token structures by replacing CSS variable names with their computed values
69
+ *
70
+ * @param tokens - Token object with CSS variable names
71
+ * @returns New object with same structure but computed values instead of variable names
72
+ *
73
+ * @example
74
+ * ```typescript
75
+ * import { colorTokens, resolveTokens } from '@salesforce/metadata-core-sdk';
76
+ *
77
+ * const resolved = resolveTokens(colorTokens);
78
+ * // resolved.backgrounds.primary is now "#3c3c3c" instead of "--mv-bg-primary"
79
+ * ```
80
+ */
81
+ export function resolveTokens(tokens) {
82
+ const resolved = {};
83
+ for (const [key, value] of Object.entries(tokens)) {
84
+ if (typeof value === 'string' && value.startsWith('--')) {
85
+ // This is a CSS variable name, resolve it
86
+ resolved[key] = getCSSVariableValue(value);
87
+ }
88
+ else if (typeof value === 'object' && value !== null) {
89
+ // This is a nested object, recurse
90
+ resolved[key] = resolveTokens(value);
91
+ }
92
+ else {
93
+ // This is some other value, keep as-is
94
+ resolved[key] = value;
95
+ }
96
+ }
97
+ return resolved;
98
+ }
99
+ /**
100
+ * Helper to wrap a CSS variable name in var() for CSS usage
101
+ *
102
+ * @param variable - CSS variable name (e.g., '--mv-bg-primary')
103
+ * @returns CSS var() function (e.g., 'var(--mv-bg-primary)')
104
+ *
105
+ * @example
106
+ * ```typescript
107
+ * import { colorTokens, cssVar } from '@salesforce/metadata-core-sdk';
108
+ *
109
+ * element.style.backgroundColor = cssVar(colorTokens.backgrounds.primary);
110
+ * // Sets backgroundColor to 'var(--mv-bg-primary)'
111
+ * ```
112
+ */
113
+ export function cssVar(variable) {
114
+ return `var(${variable})`;
115
+ }
116
+ //# sourceMappingURL=utils.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/sdk/design-system/utils.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ;;;;;GAKG;AAEH;;GAEG;AACH,SAAS,gBAAgB;IACvB,OAAO,CACL,OAAQ,UAAkB,CAAC,MAAM,KAAK,WAAW;QACjD,OAAQ,UAAkB,CAAC,QAAQ,KAAK,WAAW,CACpD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;QACxB,0EAA0E;QAC1E,iEAAiE;QACjE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,GAAG,GAAI,UAAkB,CAAC,QAAQ,CAAC;IACzC,MAAM,gBAAgB,GAAI,UAAkB,CAAC,gBAAgB,CAAC;IAE9D,IAAI,CAAC,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,gBAAgB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;AACjF,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAmB;IACtD,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC7B,MAAM,CAAC,QAAQ,CAAC,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,aAAa,CAAgC,MAAS;IACpE,MAAM,QAAQ,GAAG,EAAO,CAAC;IAEzB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACxD,0CAA0C;YAC1C,QAAQ,CAAC,GAAc,CAAC,GAAG,mBAAmB,CAAC,KAAK,CAAQ,CAAC;QAC/D,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACvD,mCAAmC;YACnC,QAAQ,CAAC,GAAc,CAAC,GAAG,aAAa,CAAC,KAAK,CAAQ,CAAC;QACzD,CAAC;aAAM,CAAC;YACN,uCAAuC;YACvC,QAAQ,CAAC,GAAc,CAAC,GAAG,KAAY,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,MAAM,CAAC,QAAgB;IACrC,OAAO,OAAO,QAAQ,GAAG,CAAC;AAC5B,CAAC"}