@pantoken/utils 0.2.5 → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Danny Wahl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.mts

@@ -63,6 +63,23 @@ declare function focusOutlineRules(selector?: string): string;
 //#region src/index.d.ts
 /** The colour mode to collapse `light-dark()` to. */
 type Mode = "light" | "dark";
+/** One entry of the pantoken spacing scale: the short key, the long (word) key, and the shared CSS value. */
+interface SpacingStep {
+  /** The short scale key, e.g. `"sm"` (the zero step's short key is `"0"`). */
+  short: string;
+  /** The long, word-spelled key, e.g. `"small"` (the zero step's long key is `"none"`). */
+  long: string;
+  /** The CSS value — a token reference, or a plain `"0"`/`"auto"`. */
+  value: string;
+}
+/**
+ * The pantoken spacing scale, `none`/`0` → `2xl` — the single shared source for
+ * `@pantoken/components`' spacing/gap utilities and `@pantoken/interactions`' `resolveSpace`, so the
+ * two never drift apart.
+ */
+declare const SPACING_STEPS: readonly SpacingStep[];
+/** The `auto` step — margin only, spelled the same both ways. */
+declare const SPACING_AUTO_STEP: SpacingStep;
 /**
  * Strip `<script>` elements and event-handler attributes from SVG markup.
  *
@@ -311,4 +328,4 @@ interface TokenUtilityGroup {
  */
 declare function tokenUtilitiesCss(groups: readonly TokenUtilityGroup[], options?: UtilityOptions): string;
 //#endregion
-export { ColorUtilityNames, ELEVATION_NAMES, FOCUSABLE_SELECTOR, LIGHT_DARK_RE, Mode, ResolveOptions, Rgba, TokenUtilityGroup, UtilityOptions, VAR_RE, camelCase, colorUtilitiesCss, danglingReferences, elevationDeclarations, extractInstuiRefs, focusOutlineDeclarations, focusOutlineRules, makeResolver, parseHexColor, resolveTokens, sanitizeSvg, tokenNames, tokenUtilitiesCss, unknownReferences };
+export { ColorUtilityNames, ELEVATION_NAMES, FOCUSABLE_SELECTOR, LIGHT_DARK_RE, Mode, ResolveOptions, Rgba, SPACING_AUTO_STEP, SPACING_STEPS, SpacingStep, TokenUtilityGroup, UtilityOptions, VAR_RE, camelCase, colorUtilitiesCss, danglingReferences, elevationDeclarations, extractInstuiRefs, focusOutlineDeclarations, focusOutlineRules, makeResolver, parseHexColor, resolveTokens, sanitizeSvg, tokenNames, tokenUtilitiesCss, unknownReferences };

package/dist/index.mjs

@@ -121,16 +121,69 @@ function focusOutlineRules(selector = FOCUSABLE_SELECTOR) {
 /**
 * `@pantoken/utils` — shared, upstream-free helpers used across the pantoken packages: the token
 * reference resolver (with `light-dark()` handling), the two token regexes (typed via `arkregex`),
-* kebab→camel case, hex-colour parsing, and the generic token→utility-class emitters
-* ({@link colorUtilitiesCss}, {@link tokenUtilitiesCss}) that both `@pantoken/components` (semantic
-* tier) and `@pantoken/plugin-primitives` (raw-palette tier) build on. Depends only on
-* `@pantoken/model` (types) + `arkregex`, so any package can use it without pulling the GitHub-only
-* upstream.
+* kebab→camel case, hex-colour parsing, the shared spacing scale ({@link SPACING_STEPS}), and the
+* generic token→utility-class emitters ({@link colorUtilitiesCss}, {@link tokenUtilitiesCss}) that
+* both `@pantoken/components` (semantic tier) and `@pantoken/plugin-primitives` (raw-palette tier)
+* build on. Depends only on `@pantoken/model` (types) + `arkregex`, so any package can use it without
+* pulling the GitHub-only upstream.
 *
 * @module
 * @beta
 */
 /**
+* The pantoken spacing scale, `none`/`0` → `2xl` — the single shared source for
+* `@pantoken/components`' spacing/gap utilities and `@pantoken/interactions`' `resolveSpace`, so the
+* two never drift apart.
+*/
+const SPACING_STEPS = [
+	{
+		short: "0",
+		long: "none",
+		value: "var(--instui-component-shared-tokens-spacing-general-space-none)"
+	},
+	{
+		short: "2xs",
+		long: "xx-small",
+		value: "var(--instui-spacing-space2xs)"
+	},
+	{
+		short: "xs",
+		long: "x-small",
+		value: "var(--instui-spacing-space-xs)"
+	},
+	{
+		short: "sm",
+		long: "small",
+		value: "var(--instui-spacing-space-sm)"
+	},
+	{
+		short: "md",
+		long: "medium",
+		value: "var(--instui-spacing-space-md)"
+	},
+	{
+		short: "lg",
+		long: "large",
+		value: "var(--instui-spacing-space-lg)"
+	},
+	{
+		short: "xl",
+		long: "x-large",
+		value: "var(--instui-spacing-space-xl)"
+	},
+	{
+		short: "2xl",
+		long: "xx-large",
+		value: "var(--instui-spacing-space2xl)"
+	}
+];
+/** The `auto` step — margin only, spelled the same both ways. */
+const SPACING_AUTO_STEP = {
+	short: "auto",
+	long: "auto",
+	value: "auto"
+};
+/**
 * Strip `<script>` elements and event-handler attributes from SVG markup.
 *
 * Defense-in-depth for SVG decoded from vendored data URIs or contributed by plugins.
@@ -420,4 +473,4 @@ function tokenUtilitiesCss(groups, options = {}) {
 	})).join("\n")}\n`;
 }
 //#endregion
-export { ELEVATION_NAMES, FOCUSABLE_SELECTOR, LIGHT_DARK_RE, VAR_RE, camelCase, colorUtilitiesCss, danglingReferences, elevationDeclarations, extractInstuiRefs, focusOutlineDeclarations, focusOutlineRules, makeResolver, parseHexColor, resolveTokens, sanitizeSvg, tokenNames, tokenUtilitiesCss, unknownReferences };
+export { ELEVATION_NAMES, FOCUSABLE_SELECTOR, LIGHT_DARK_RE, SPACING_AUTO_STEP, SPACING_STEPS, VAR_RE, camelCase, colorUtilitiesCss, danglingReferences, elevationDeclarations, extractInstuiRefs, focusOutlineDeclarations, focusOutlineRules, makeResolver, parseHexColor, resolveTokens, sanitizeSvg, tokenNames, tokenUtilitiesCss, unknownReferences };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pantoken/utils",
-  "version": "0.2.5",
+  "version": "0.3.0",
   "description": "Shared pantoken helpers: token reference resolver, typed regexes (arkregex), name-case, and hex-colour parsing.",
   "homepage": "https://pantoken.iywahl.com",
   "bugs": "https://github.com/thedannywahl/pantoken/issues",
@@ -23,22 +23,22 @@
     "access": "public",
     "provenance": true
   },
-  "scripts": {
-    "dev": "vp pack --watch",
-    "test": "vp test",
-    "check": "vp check"
-  },
   "dependencies": {
-    "@pantoken/model": "workspace:*",
-    "arkregex": "catalog:"
+    "arkregex": "^0.0.8",
+    "@pantoken/model": "0.3.0"
   },
   "devDependencies": {
-    "@types/node": "catalog:",
-    "typescript": "catalog:",
-    "vite": "catalog:",
-    "vite-plus": "catalog:"
+    "@types/node": "^24.13.3",
+    "typescript": "^7.0.2",
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.2.9",
+    "vite-plus": "0.2.9"
   },
   "engines": {
     "node": ">=22.18.0"
+  },
+  "scripts": {
+    "dev": "vp pack --watch",
+    "test": "vp test",
+    "check": "vp check"
   }
-}
+}