@ksp-gonogo/ui-kit 1.0.0-rc.21 → 1.0.0-rc.25

package/dist/tokens.css

@@ -792,6 +792,8 @@ textarea {
   --inset-jog-wheel-label: 0 var(--space-2);
   /* The room a Meter figure keeps for the held mark drawn outside it. */
   --inset-meter-mark: var(--space-6);
+  /* The room an avatar keeps from the edge of the control it sits in, on each side. */
+  --inset-avatar: var(--space-4);
 
   /* Fields. */
   --inset-field: var(--space-6) var(--space-8);

package/dist/{units-Cl-8ZdJc.d.ts → units-DZYIWBWP.d.ts}

@@ -7,23 +7,34 @@ import { DeclaredUnit, UnitDeclarations, UnitRung } from '@ksp-gonogo/sitrep-sdk
  * Every type in this module reads `UnitDeclarations` and nothing else, which is
  * what makes a unit an Uplink merges into it indistinguishable here from a
  * first-party one.
+ *
+ * @category Unit
  */
 type KindOfSymbol<Unit extends string> = Unit extends DeclaredUnit ? UnitDeclarations[Unit] extends {
     kind: infer Kind;
 } ? Kind : never : never;
-/** Every declared symbol that measures `Kind`. */
+/**
+ * Every declared symbol that measures `Kind`.
+ *
+ * @category Unit
+ */
 type SymbolsOfKind<Kind> = {
     [Unit in DeclaredUnit]: KindOfSymbol<Unit> extends Kind ? Unit : never;
 }[DeclaredUnit];
-/** The ladder `Unit` is declared on, or `never` for a unit that climbs none. */
+/**
+ * The ladder `Unit` is declared on, or `never` for a unit that climbs none.
+ *
+ * @category Unit
+ */
 type LadderOfSymbol<Unit extends string> = Unit extends DeclaredUnit ? UnitDeclarations[Unit] extends {
     ladder: infer Ladder extends string;
 } ? Ladder : never : never;
 /**
  * Every symbol of kind `Kind` that exists only as a conversion TARGET (`°C`),
- * which the declarations do not name and {@link kindOfConversion} still
- * resolves. A pair whose source is itself undeclared is skipped, or `°C→K`
+ * which the declarations do not name but a conversion still reaches. A pair whose source is itself undeclared is skipped, or `°C→K`
  * would make every kind accept `K`.
+ *
+ * @category Unit
  */
 type ConversionTargetsOfKind<Kind> = {
     [Conversion in keyof typeof CONVERSIONS]: Conversion extends `${infer Source}→${infer Target}` ? [KindOfSymbol<Source>] extends [never] ? never : [KindOfSymbol<Source>] extends [Kind] ? Target : never : never;
@@ -70,6 +81,10 @@ type PresentableAsKind<Kind> = SymbolsOfKind<Kind> | ConversionTargetsOfKind<Kin
  * `m` and `km` are interchangeable and `m` and `m/s` are not, and it selects
  * the ladder and the precision rule.
  *
+ * A kind names a dimension, never a unit symbol: `length` is what `m` and `km`
+ * measure, `planeAngle` is what `°` measures and `universalTime` is what `ut`
+ * measures.
+ *
  * @category Unit
  */
 type KnownQuantityKind = "length" | "speed" | "acceleration" | "mass" | "force" | "pressure" | "temperature" | "time" | "universalTime" | "specificImpulse" | "irlTime" | "planeAngle" | "power" | "data" | "dataRate" | "doseRate" | "irradiance" | "level" | "density" | "massFlow" | "gravParameter" | "dimensionless" | "percent" | "scienceData" | "scienceRate" | "ratio" | "area" | "volume" | "angularSpeed" | "funds" | "science" | "reputation" | "fundsRate" | "reputationRate" | "count" | "id" | "resourceUnits" | "resourceFlow" | "text" | "flag" | "enum" | "n/a";
@@ -191,6 +206,11 @@ declare function writeQuantity(quantity: {
     magnitude: number;
     unit: string;
 } | null | undefined, opts?: FormatQuantityOptions): string;
+/**
+ * How a quantity is written: the unit to pin, the number of decimals, and the scale to draw it against.
+ *
+ * @category Unit
+ */
 interface FormatQuantityOptions {
     /**
      * Pin the unit rather than letting the ladder choose, for where convention
@@ -219,7 +239,13 @@ interface FormatQuantityOptions {
     as?: string;
     /** Override the kind's decimal places. */
     decimals?: number;
-    /** The rung the value was last shown at, so a value hovering on a boundary does not flicker. */
+    /**
+     * The unit the last render settled on, read from the formatted quantity's `rung`.
+     * Pass it back so a value hovering on a boundary between two units does not
+     * flicker between them. Nothing keeps it for you: {@link Unit} formats each
+     * render from its props alone, so a caller that wants the steadiness holds
+     * the last rung and passes it here.
+     */
     heldSymbol?: string;
 }
 /**
@@ -267,4 +293,4 @@ declare function quantityScale(reference: {
     unit: string;
 } | null | undefined, opts?: FormatQuantityOptions): QuantityScale;
 
-export { type FormatQuantityOptions as F, type KindOfGroup as K, type LadderName as L, type PresentableAs as P, type QuantityKind as Q, type Rung as R, type UnitGroupKey as U, type FormatsFor as a, type FormatsForKind as b, type PresentableAsKind as c, type KnownQuantityKind as d, type QuantityScale as e, speakQuantity as f, quantityScale as q, setQuantityLocale as s, writeQuantity as w };
+export { type ConversionTargetsOfKind as C, type FormatQuantityOptions as F, type KindOfGroup as K, type LadderName as L, type PresentableAs as P, type QuantityKind as Q, type Rung as R, type SymbolsOfKind as S, type UnitGroupKey as U, type FormatsFor as a, type FormatsForKind as b, type PresentableAsKind as c, type KindOfSymbol as d, type KnownQuantityKind as e, type LadderOfSymbol as f, type QuantityScale as g, speakQuantity as h, quantityScale as q, setQuantityLocale as s, writeQuantity as w };

package/package.json

@@ -2,7 +2,7 @@
   "name": "@ksp-gonogo/ui-kit",
   "description": "Export-safe design system for Gonogo mission-control widgets and third-party Uplinks",
   "license": "MIT",
-  "version": "1.0.0-rc.21",
+  "version": "1.0.0-rc.25",
   "type": "module",
   "repository": {
     "type": "git",
@@ -33,14 +33,15 @@
     "./guards": {
       "types": "./dist/guards.d.ts",
       "import": "./dist/guards.js"
-    }
+    },
+    "./reads-index.json": "./dist/reads-index.json"
   },
   "types": "./dist/index.d.ts",
   "files": [
     "dist"
   ],
   "scripts": {
-    "build": "tsup && node scripts/extend-package-specifiers.mjs && cp node_modules/@ksp-gonogo/theme/dist/tokens.css dist/tokens.css",
+    "build": "tsup && node scripts/extend-package-specifiers.mjs && cp node_modules/@ksp-gonogo/theme/dist/tokens.css dist/tokens.css && node ../../scripts/build-reads-index.mjs @ksp-gonogo/ui-kit src/index.ts,src/guards.ts,src/gridUnits.ts",
     "dev": "tsup --watch",
     "lint": "tsc --noEmit",
     "render:markers": "node scripts/render-markers.ts",
@@ -75,23 +76,15 @@
   },
   "peerDependencies": {
     "@fontsource/jetbrains-mono": "^5.0.0",
-    "esbuild": "^0.25.0 || ^0.28.0",
     "jest-axe": "^10.0.0",
-    "playwright": "^1.50.0",
     "react": "^18.0.0",
     "styled-components": "^6.0.0",
-    "@ksp-gonogo/sitrep-sdk": "1.0.0-rc.21"
+    "@ksp-gonogo/sitrep-sdk": "1.0.0-rc.25"
   },
   "peerDependenciesMeta": {
     "jest-axe": {
       "optional": true
     },
-    "esbuild": {
-      "optional": true
-    },
-    "playwright": {
-      "optional": true
-    },
     "@fontsource/jetbrains-mono": {
       "optional": true
     }