@chipmobilesdk/rn-theme 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,116 @@
 # @chipmobilesdk/rn-theme
 
+## 1.3.0
+
+### Minor Changes
+
+- Every peer range has an upper bound, and no package declares a peer it does not use. ([#21](https://github.com/operationd8979/chip-mobile-sdk/pull/21))
+
+  A peer range is now a caret, a tilde or an explicit `<`, except for `react` and
+  `react-native`: an app brings exactly one of each, so a floor is the only useful thing
+  to say about them. Every other peer is a library the app installs beside us, and an
+  open `>=` was a promise about versions nobody had run — mmkv 3→4 lost entitlements and
+  pending purchases exactly that way.
+
+  **Four of the new ceilings exclude a version that is already published**, so an app
+  that took the open range at its word may now see a peer warning. The new bound is the
+  major this release is tested against, which is the thing the old range failed to say:
+
+  | Peer | Was | Now | Published above the ceiling |
+  |---|---|---|---|
+  | `react-native-app-auth` (rn-auth) | `>=8` | `^8.0.0` | 9.0.0 |
+  | `react-native-keychain` (rn-auth) | `>=10` | `^10.0.0` | 11.0.0 |
+  | `@op-engineering/op-sqlite` (rn-local-db) | `>=17.1.0` | `^17.1.0` | 18.x, 19.x |
+  | `@react-native-firebase/messaging` (rn-notification) | `>=26.0.0` | `^26.0.0` | 27.x |
+
+  The others — `react-native-vision-camera` `^5.1.1`, `react-native-svg` `^15.15.0`,
+  `react-native-unistyles` `^3.2.0`, `@dr.pogodin/react-native-fs` `^2.39.2`,
+  `react-native-quick-crypto` `^1.0.0`, `react-native-notify-kit` `^10.5.0`,
+  `react-native-localize` `^3.7.0`, `react-native-mmkv` `^4.0.0` — exclude nothing that
+  exists today. rn-payment's mmkv range was already bounded (`>=4.0.0 <5`) and is now
+  written as the caret that means the same thing.
+
+  Peers nothing imports are gone. `rn-theme`, `rn-local-db` and `rn-notification` asked
+  for `react` without having a component or a hook between them; `rn-auth`, `rn-ai` and
+  `rn-i18n` asked for `react-native` without touching a React Native API (rn-auth reaches
+  both native modules through `lazyPeer`, rn-i18n formats on `Intl`); `rn-notification`
+  asked for `@react-native-firebase/app`, which messaging declares itself. `rn-ai` no
+  longer peers on `@chipmobilesdk/rn-auth` at all — it asks for a `TokenProvider`, a
+  two-method interface rn-auth's `auth` satisfies, so an app with its own token source
+  installs nothing extra. An app that enables push or signs in through rn-auth installs
+  the same packages as before; it is the manifest that stopped overstating.
+
+  `react-native-localize` is declared optional, which is what the code already did: the
+  time-zone reader goes through `lazyPeer` and falls back to `Intl` without it. The
+  `peerDependenciesMeta` entries that said `optional: false` are gone — that is npm's
+  default, and writing it down only invited the question of which peers were undecided.
+
+  `npm run check:manifests` now fails on an unbounded peer range, a peer nothing in
+  `src/` imports, and a `peerDependenciesMeta` entry for either, so the policy holds
+  without anyone remembering it.
+
+- Every package now ships built JavaScript with declaration files, instead of asking the
+  app to compile its TypeScript. ([#22](https://github.com/operationd8979/chip-mobile-sdk/pull/22))
+
+  Each tarball carries `lib/commonjs`, `lib/module` and `lib/typescript` (built with
+  `react-native-builder-bob`), and `src/` alongside them. What that changes for a
+  consumer:
+
+  - **Nothing to add to `transformIgnorePatterns`.** `require` resolves to the CommonJS
+    build, so an app's Jest loads this package without being told to transform it. That
+    was the one thing every consuming app had to know about us (DEP-04).
+  - **Typechecking reads our `.d.ts`** rather than compiling our source under our
+    `tsconfig`. A consumer's stricter — or looser — settings no longer meet our code.
+  - **`import` resolves to ESM**, so a bundler can tree-shake what it does not use.
+
+  No exported name changed, and no subpath moved: `.`, `./testing`, `./push`,
+  `./advanced`, `./app-auth`, `./keychain` and rn-core's twelve subpaths resolve exactly
+  as before, each now with its own declarations for both module systems. publint and
+  `attw --profile node16` pass on all twelve packages, which they could not before.
+
+  Inside the monorepo nothing changed either, and that is deliberate: every subpath also
+  declares a private `chipmobilesdk-source` condition pointing at its TypeScript, and
+  Metro, Jest and `tsc` here ask for that condition first. The demo app bundles 371
+  modules straight from `packages/*/src`, so editing a package still changes the app with
+  no build step, and coverage is still measured on the source. The condition is named for
+  this organization rather than using the conventional `source` because third-party
+  packages declare that one too — `@dr.pogodin/react-native-fs` does — and asking for it
+  pulled their sources into our stricter compile.
+
+  `npm run build:packages` builds everything, `prepack` rebuilds before any `npm pack`,
+  and `lib/` is git-ignored: the published bytes are produced by the release, never
+  committed. `npm run check:manifests` now fails a package whose `main`, `module`,
+  `types`, `source` condition, `files`, build script or `prepack` do not match this shape.
+
+### Patch Changes
+
+- Each package's public API and its weight are now recorded in the repository, so a change
+  to either is reviewed rather than discovered. ([#23](https://github.com/operationd8979/chip-mobile-sdk/pull/23))
+
+  `packages/<pkg>/etc/*.api.md` is an api-extractor report per entrypoint — twenty-seven
+  of them, generated from the declarations the package publishes and committed. A renamed
+  type, a widened union, one more optional field: all of it shows up in a pull request's
+  diff. `npm run check:api` fails when a report is out of date and `npm run api:update`
+  rewrites them.
+
+  A report that moves now needs a **minor or major** changeset for that package.
+  `check:changesets` enforces it, because the report is generated from what the package
+  publishes, and a patch release that moves the public surface is how a consumer's build
+  breaks on `npm update`. A report added for the first time is a baseline, not a change.
+  `./testing` deliberately has no report: test doubles are not a surface a release is
+  gated on.
+
+  `npm run check:size` holds every entrypoint to a budget in `.size-limit.json`, measured
+  on the ESM build with peers and rn-core treated as external — they are what an app
+  installs beside us, not our weight. Each budget started at today's measurement plus five
+  per cent, so growth becomes a decision someone makes instead of a drift nobody sees. The
+  current figures run from 500 B (`rn-core/lazy`) to 19 kB (rn-notification).
+
+  No behaviour or API changed in this release; the entry is here so the changelog records
+  when the reports and the budgets began.
+- Updated dependencies ([#22](https://github.com/operationd8979/chip-mobile-sdk/pull/22), [#23](https://github.com/operationd8979/chip-mobile-sdk/pull/23)):
+  - @chipmobilesdk/rn-core@0.2.0
+
 ## 1.2.0
 
 ### Minor Changes

package/README.md

@@ -269,7 +269,9 @@ override colours and numbers, Unistyles options and breakpoints.
 ## Dependency Classification
 
 - `dependencies`: none. HCT colour maths is vendored under `src/vendor/mcu` (Apache-2.0).
-- `peerDependencies`: `react`, `react-native`, `react-native-unistyles`.
+- `peerDependencies`: `react-native` (for its style types) and `react-native-unistyles`
+  `^3.2.0`. No `react` peer: there is no component and no hook here, only tokens,
+  presets and the Unistyles configuration.
 
 ## Unistyles 3 Style Authoring and TypeScript Diagnostics
 

package/lib/commonjs/color/categorical.js

@@ -0,0 +1,35 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.buildCategorical = buildCategorical;
+var _index = require("../vendor/mcu/index.js");
+var _parse = require("./parse.js");
+const SERIES_COUNT = 8;
+const SERIES_CHROMA = 48;
+/** 3 × 45°: consecutive series land far apart on the hue wheel. */
+const HUE_STEP = 135;
+
+/**
+ * Alternating tones. Every tone clears 3:1 against `surface` (98 / 6), and the
+ * 15-unit L* step keeps neighbours apart even when colour vision cannot
+ * separate their hues.
+ */
+const SERIES_TONES = {
+  light: [40, 55],
+  dark: [80, 60]
+};
+
+/**
+ * Categorical series colours for charts, starting at the primary hue
+ * (spec US-11). Status colours stay free for status.
+ */
+function buildCategorical(primary, scheme) {
+  const startHue = _index.Hct.fromInt((0, _parse.argbFromColor)(primary)).hue;
+  const tones = SERIES_TONES[scheme];
+  return Array.from({
+    length: SERIES_COUNT
+  }, (_, index) => (0, _parse.hexFromArgb)(_index.Hct.from((startHue + index * HUE_STEP) % 360, SERIES_CHROMA, tones[index % 2]).toInt()));
+}
+//# sourceMappingURL=categorical.js.map

package/lib/commonjs/color/categorical.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_index","require","_parse","SERIES_COUNT","SERIES_CHROMA","HUE_STEP","SERIES_TONES","light","dark","buildCategorical","primary","scheme","startHue","Hct","fromInt","argbFromColor","hue","tones","Array","from","length","_","index","hexFromArgb","toInt"],"sourceRoot":"../../../src","sources":["color/categorical.ts"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAEA,IAAAC,MAAA,GAAAD,OAAA;AAEA,MAAME,YAAY,GAAG,CAAC;AACtB,MAAMC,aAAa,GAAG,EAAE;AACxB;AACA,MAAMC,QAAQ,GAAG,GAAG;;AAEpB;AACA;AACA;AACA;AACA;AACA,MAAMC,YAAmD,GAAG;EAC3DC,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;EACfC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE;AACd,CAAC;;AAED;AACA;AACA;AACA;AACO,SAASC,gBAAgBA,CAACC,OAAe,EAAEC,MAAmB,EAAY;EAChF,MAAMC,QAAQ,GAAGC,UAAG,CAACC,OAAO,CAAC,IAAAC,oBAAa,EAACL,OAAO,CAAC,CAAC,CAACM,GAAG;EACxD,MAAMC,KAAK,GAAGX,YAAY,CAACK,MAAM,CAAC;EAElC,OAAOO,KAAK,CAACC,IAAI,CAAC;IAAEC,MAAM,EAAEjB;EAAa,CAAC,EAAE,CAACkB,CAAC,EAAEC,KAAK,KACpD,IAAAC,kBAAW,EACVV,UAAG,CAACM,IAAI,CAAC,CAACP,QAAQ,GAAGU,KAAK,GAAGjB,QAAQ,IAAI,GAAG,EAAED,aAAa,EAAEa,KAAK,CAACK,KAAK,GAAG,CAAC,CAAC,CAAC,CAACE,KAAK,CAAC,CACtF,CACD,CAAC;AACF","ignoreList":[]}

package/lib/commonjs/color/contrast.js

@@ -0,0 +1,199 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.TEXT_CONTRAST = exports.NON_TEXT_CONTRAST = void 0;
+exports.auditTheme = auditTheme;
+exports.contrastRatio = contrastRatio;
+var _parse = require("./parse.js");
+/** WCAG 2.x minimum ratio for text (1.4.3). */
+const TEXT_CONTRAST = exports.TEXT_CONTRAST = 4.5;
+/** WCAG 2.x minimum ratio for non-text boundaries (1.4.11). */
+const NON_TEXT_CONTRAST = exports.NON_TEXT_CONTRAST = 3;
+const WHITE = {
+  r: 255,
+  g: 255,
+  b: 255,
+  a: 1
+};
+const LUMINANCE_OFFSET = 0.05;
+const ACCENT_ROLES = ['primary', 'secondary', 'tertiary', 'error', 'success', 'warning', 'info'];
+const SEMANTIC_ROLES = ['error', 'success', 'warning', 'info'];
+const BASE_BACKGROUNDS = ['color.background', 'color.surface'];
+const SURFACE_TIERS = ['surfaceContainerLowest', 'surfaceContainerLow', 'surfaceContainer', 'surfaceContainerHigh', 'surfaceContainerHighest'];
+function capitalize(value) {
+  return value.charAt(0).toUpperCase() + value.slice(1);
+}
+function onBase(foreground, target = TEXT_CONTRAST) {
+  return BASE_BACKGROUNDS.map(background => ({
+    foreground,
+    background,
+    target
+  }));
+}
+
+/**
+ * Every pair the package guarantees, expressed as theme paths. Paths missing
+ * from a theme (e.g. presets an older theme does not have) are skipped.
+ */
+function guaranteedPairs(theme) {
+  const pairs = [];
+  for (const role of SEMANTIC_ROLES) {
+    pairs.push(...onBase(`color.${role}`));
+  }
+  for (const role of ACCENT_ROLES) {
+    const on = `on${capitalize(role)}`;
+    pairs.push({
+      foreground: `color.${on}`,
+      background: `color.${role}`,
+      target: TEXT_CONTRAST
+    }, {
+      foreground: `color.${on}Container`,
+      background: `color.${role}Container`,
+      target: TEXT_CONTRAST
+    });
+  }
+  pairs.push({
+    foreground: 'color.onBackground',
+    background: 'color.background',
+    target: TEXT_CONTRAST
+  }, {
+    foreground: 'color.onSurface',
+    background: 'color.surface',
+    target: TEXT_CONTRAST
+  }, {
+    foreground: 'color.onSurfaceVariant',
+    background: 'color.surfaceVariant',
+    target: TEXT_CONTRAST
+  }, ...onBase('color.onSurfaceVariant'), {
+    foreground: 'color.inverseOnSurface',
+    background: 'color.inverseSurface',
+    target: TEXT_CONTRAST
+  }, {
+    foreground: 'color.inversePrimary',
+    background: 'color.inverseSurface',
+    target: TEXT_CONTRAST
+  }, ...SURFACE_TIERS.map(tier => ({
+    foreground: 'color.onSurface',
+    background: `color.${tier}`,
+    target: TEXT_CONTRAST
+  })), ...onBase('color.outline', NON_TEXT_CONTRAST));
+  const tones = readPath(theme, 'tone');
+  if (isRecord(tones)) {
+    for (const name of Object.keys(tones)) {
+      const tone = `tone.${name}`;
+      pairs.push(...onBase(`${tone}.fg`), {
+        foreground: `${tone}.onContainer`,
+        background: `${tone}.container`,
+        target: TEXT_CONTRAST
+      }, {
+        foreground: `${tone}.onFill`,
+        background: `${tone}.fill`,
+        target: TEXT_CONTRAST
+      }, {
+        foreground: `${tone}.border`,
+        background: 'color.background',
+        target: NON_TEXT_CONTRAST
+      });
+    }
+  }
+  const text = readPath(theme, 'text');
+  if (isRecord(text)) {
+    for (const name of Object.keys(text)) {
+      // `text.disabled` deliberately uses the contrast-exempt disabled colour.
+      if (name !== 'disabled') {
+        pairs.push(...onBase(`text.${name}.color`));
+      }
+    }
+  }
+  const categorical = readPath(theme, 'categorical');
+  if (Array.isArray(categorical)) {
+    categorical.forEach((_, index) => {
+      pairs.push({
+        foreground: `categorical.${index}`,
+        background: 'color.surface',
+        target: NON_TEXT_CONTRAST
+      });
+    });
+  }
+  return pairs;
+}
+function isRecord(value) {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function readPath(source, path) {
+  return path.split('.').reduce((node, key) => {
+    if (Array.isArray(node)) {
+      return node[Number(key)];
+    }
+    return isRecord(node) ? node[key] : undefined;
+  }, source);
+}
+function channelLuminance(channel) {
+  const value = channel / 255;
+  return value <= 0.04045 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;
+}
+function relativeLuminance({
+  r,
+  g,
+  b
+}) {
+  return 0.2126 * channelLuminance(r) + 0.7152 * channelLuminance(g) + 0.0722 * channelLuminance(b);
+}
+function composite(top, bottom) {
+  const mix = (upper, lower) => upper * top.a + lower * (1 - top.a);
+  return {
+    r: mix(top.r, bottom.r),
+    g: mix(top.g, bottom.g),
+    b: mix(top.b, bottom.b),
+    a: 1
+  };
+}
+
+/**
+ * WCAG contrast ratio of two colour strings. Translucent colours are
+ * composited first: the background over `base` (default white), then the
+ * foreground over the result.
+ */
+function contrastRatio(foreground, background, base) {
+  const fg = (0, _parse.parseColor)(foreground);
+  const bg = (0, _parse.parseColor)(background);
+  const baseColor = (base != null ? (0, _parse.parseColor)(base) : null) ?? WHITE;
+  if (!fg || !bg) {
+    throw new Error(`contrastRatio: unsupported colour "${!fg ? foreground : background}".`);
+  }
+  const opaqueBackground = composite(bg, composite(baseColor, WHITE));
+  const opaqueForeground = composite(fg, opaqueBackground);
+  const lighter = Math.max(relativeLuminance(opaqueForeground), relativeLuminance(opaqueBackground));
+  const darker = Math.min(relativeLuminance(opaqueForeground), relativeLuminance(opaqueBackground));
+  return (lighter + LUMINANCE_OFFSET) / (darker + LUMINANCE_OFFSET);
+}
+
+/**
+ * Checks every contrast pair the package guarantees against the given theme
+ * and returns the ones below target. An empty list means the theme passes.
+ * `color.disabled` is never audited: inactive components are exempt from
+ * WCAG 1.4.3.
+ */
+function auditTheme(theme) {
+  const base = readPath(theme, 'color.background');
+  const failures = [];
+  for (const pair of guaranteedPairs(theme)) {
+    const foreground = readPath(theme, pair.foreground);
+    const background = readPath(theme, pair.background);
+    if (typeof foreground !== 'string' || typeof background !== 'string') {
+      continue;
+    }
+    const ratio = contrastRatio(foreground, background, typeof base === 'string' ? base : undefined);
+    if (ratio < pair.target) {
+      // Floored so a reported ratio never reads as passing (4.499 → 4.49).
+      failures.push({
+        ...pair,
+        ratio: Math.floor(ratio * 100) / 100
+      });
+    }
+  }
+  return failures;
+}
+//# sourceMappingURL=contrast.js.map

package/lib/commonjs/color/contrast.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_parse","require","TEXT_CONTRAST","exports","NON_TEXT_CONTRAST","WHITE","r","g","b","a","LUMINANCE_OFFSET","ACCENT_ROLES","SEMANTIC_ROLES","BASE_BACKGROUNDS","SURFACE_TIERS","capitalize","value","charAt","toUpperCase","slice","onBase","foreground","target","map","background","guaranteedPairs","theme","pairs","role","push","on","tier","tones","readPath","isRecord","name","Object","keys","tone","text","categorical","Array","isArray","forEach","_","index","source","path","split","reduce","node","key","Number","undefined","channelLuminance","channel","relativeLuminance","composite","top","bottom","mix","upper","lower","contrastRatio","base","fg","parseColor","bg","baseColor","Error","opaqueBackground","opaqueForeground","lighter","Math","max","darker","min","auditTheme","failures","pair","ratio","floor"],"sourceRoot":"../../../src","sources":["color/contrast.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/color/parse.js

@@ -0,0 +1,110 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.argbFromColor = argbFromColor;
+exports.formatColor = formatColor;
+exports.hexFromArgb = hexFromArgb;
+exports.isOpaqueColor = isOpaqueColor;
+exports.isValidColor = isValidColor;
+exports.parseColor = parseColor;
+exports.withAlpha = withAlpha;
+var _index = require("../vendor/mcu/index.js");
+/** A colour channel set: red/green/blue 0–255, alpha 0–1. */
+
+const HEX_PATTERN = /^#([0-9a-f]{3}|[0-9a-f]{4}|[0-9a-f]{6}|[0-9a-f]{8})$/i;
+const RGB_PATTERN = /^rgba?\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*(?:,\s*(\d*\.?\d+)\s*)?\)$/i;
+const CHANNEL_MAX = 255;
+
+/**
+ * Parses the colour formats the package accepts: `#RGB`, `#RGBA`, `#RRGGBB`,
+ * `#RRGGBBAA`, `rgb(r, g, b)` and `rgba(r, g, b, a)`. Returns `null` for
+ * anything else, including named colours and `hsl()`.
+ */
+function parseColor(value) {
+  if (typeof value !== 'string') {
+    return null;
+  }
+  const color = value.trim();
+  const hex = HEX_PATTERN.exec(color);
+  if (hex) {
+    return parseHex(hex[1]);
+  }
+  const rgb = RGB_PATTERN.exec(color);
+  if (!rgb) {
+    return null;
+  }
+  const [r, g, b] = [rgb[1], rgb[2], rgb[3]].map(Number);
+  const a = rgb[4] == null ? 1 : Number(rgb[4]);
+  if ([r, g, b].some(channel => channel > CHANNEL_MAX) || a > 1) {
+    return null;
+  }
+  return {
+    r,
+    g,
+    b,
+    a
+  };
+}
+function parseHex(digits) {
+  const full = digits.length <= 4 ? digits.split('').map(digit => digit + digit).join('') : digits;
+  const channel = index => parseInt(full.slice(index * 2, index * 2 + 2), 16);
+  return {
+    r: channel(0),
+    g: channel(1),
+    b: channel(2),
+    a: full.length === 8 ? channel(3) / CHANNEL_MAX : 1
+  };
+}
+function isValidColor(value) {
+  return parseColor(value) !== null;
+}
+function isOpaqueColor(value) {
+  return parseColor(value)?.a === 1;
+}
+
+/** ARGB integer of an opaque colour string; throws for anything else. */
+function argbFromColor(value) {
+  const rgba = parseColor(value);
+  if (!rgba || rgba.a !== 1) {
+    throw new Error(`Expected an opaque colour, received "${value}".`);
+  }
+  return (0, _index.argbFromRgb)(rgba.r, rgba.g, rgba.b);
+}
+function toHexPair(channel) {
+  return Math.round(channel).toString(16).padStart(2, '0').toUpperCase();
+}
+function hexFromArgb(argb) {
+  // eslint-disable-next-line no-bitwise -- unpacking the ARGB integer's channels
+  const [r, g, b] = [argb >> 16 & 0xff, argb >> 8 & 0xff, argb & 0xff];
+  return `#${toHexPair(r)}${toHexPair(g)}${toHexPair(b)}`;
+}
+function formatColor({
+  r,
+  g,
+  b,
+  a
+}) {
+  const rgb = `#${toHexPair(r)}${toHexPair(g)}${toHexPair(b)}`;
+  return a >= 1 ? rgb : `${rgb}${toHexPair(a * CHANNEL_MAX)}`;
+}
+
+/**
+ * Applies an opacity to a colour, multiplying any alpha it already has.
+ * Returns `#RRGGBBAA` (or `#RRGGBB` when the result is opaque).
+ */
+function withAlpha(color, alpha) {
+  const rgba = parseColor(color);
+  if (!rgba) {
+    throw new Error(`withAlpha: "${color}" is not a supported colour.`);
+  }
+  if (!Number.isFinite(alpha) || alpha < 0 || alpha > 1) {
+    throw new Error(`withAlpha: alpha must be between 0 and 1, received ${alpha}.`);
+  }
+  return formatColor({
+    ...rgba,
+    a: rgba.a * alpha
+  });
+}
+//# sourceMappingURL=parse.js.map

package/lib/commonjs/color/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_index","require","HEX_PATTERN","RGB_PATTERN","CHANNEL_MAX","parseColor","value","color","trim","hex","exec","parseHex","rgb","r","g","b","map","Number","a","some","channel","digits","full","length","split","digit","join","index","parseInt","slice","isValidColor","isOpaqueColor","argbFromColor","rgba","Error","argbFromRgb","toHexPair","Math","round","toString","padStart","toUpperCase","hexFromArgb","argb","formatColor","withAlpha","alpha","isFinite"],"sourceRoot":"../../../src","sources":["color/parse.ts"],"mappings":"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","ignoreList":[]}