@chipmobilesdk/rn-theme 1.0.0 → 1.0.1

package/CHANGELOG.md

@@ -1,4 +1,13 @@
-# Changelog
+# @chipmobilesdk/rn-theme
+
+## 1.0.1
+
+### Patch Changes
+
+- Documentation and packaging only; no code change. The README no longer writes a
+  version into its header (the changelog is the one place a version lives), the agent
+  skill no longer carries one (the consuming app's skill sync stamps the installed
+  version), and the changelog goes straight from its title to its releases. ([#15](https://github.com/operationd8979/chip-mobile-sdk/pull/15))
 
 ## 1.0.0 - 2026-10-17
 

package/README.md

@@ -7,7 +7,7 @@ Native apps, configured for `react-native-unistyles` 3.
 > applications; no open-source license is granted. Includes Apache-2.0 code from
 > material-color-utilities — see `NOTICE`.
 
-- **Version**: `1.0.0`
+- **Version**: see [CHANGELOG](CHANGELOG.md)
 - **Entrypoint**: `@chipmobilesdk/rn-theme`
 - **Demo**: `src/screens/ExampleScreen.tsx`
 
@@ -291,7 +291,7 @@ spreads and casts into `extend`.
 ## Release Validation
 
 ```bash
-npm run validate:theme
+npm run validate
 ```
 
 ## Semver and Migration

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@chipmobilesdk/rn-theme",
-	"version": "1.0.0",
+	"version": "1.0.1",
 	"private": false,
 	"license": "UNLICENSED",
 	"main": "src/index.ts",
@@ -30,7 +30,7 @@
 	"sideEffects": false,
 	"scripts": {
 		"typecheck": "tsc -p tsconfig.json --noEmit",
-		"pack:dry-run": "npm pack --dry-run"
+		"pack:check": "npm pack --dry-run"
 	},
 	"peerDependencies": {
 		"react": ">=19",

package/skills/sdk-rn-theme/SKILL.md

@@ -3,7 +3,6 @@ name: sdk-rn-theme
 description: "Theming for @chipmobilesdk/rn-theme: accessible brand palettes, Unistyles config, colour/typography/spacing tokens, tones and byTone variants, layout and text presets, app token extension, dark mode and theme mode. Use when setting up theming, writing or shortening a stylesheet, adding a design token, wiring light/dark, or debugging Unistyles setup, stale styles or type errors."
 metadata:
   package: "@chipmobilesdk/rn-theme"
-  packageVersion: "1.0.0"
 user-invocable: true
 disable-model-invocation: false
 ---
@@ -46,7 +45,7 @@ Unistyles 3. Single source of truth for visual tokens; app tokens join through `
   package) augments `UnistylesThemes` / `UnistylesBreakpoints` from `typeof config`.
 - Merge Unistyles styles with arrays, never object spread of Unistyles entries.
 
-## Public API (v1.0.0)
+## Public API
 
 Runtime: `createUnistylesConfig`, `buildThemes`, `applyThemeMode`, `byTone`, `layout`,
 `presets`, `auditTheme`, `contrastRatio`, `withAlpha`, `toNavigationTheme`,

package/src/color/contrast.ts

@@ -107,7 +107,11 @@ function guaranteedPairs(theme: object): ContrastPair[] {
 			const tone = `tone.${name}`;
 			pairs.push(
 				...onBase(`${tone}.fg`),
-				{ foreground: `${tone}.onContainer`, background: `${tone}.container`, target: TEXT_CONTRAST },
+				{
+					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 },
 			);
@@ -161,11 +165,7 @@ function channelLuminance(channel: number): number {
 }
 
 function relativeLuminance({ r, g, b }: Rgba): number {
-	return (
-		0.2126 * channelLuminance(r) +
-		0.7152 * channelLuminance(g) +
-		0.0722 * channelLuminance(b)
-	);
+	return 0.2126 * channelLuminance(r) + 0.7152 * channelLuminance(g) + 0.0722 * channelLuminance(b);
 }
 
 function composite(top: Rgba, bottom: Rgba): Rgba {
@@ -190,7 +190,10 @@ export function contrastRatio(foreground: string, background: string, base?: str
 
 	const opaqueBackground = composite(bg, composite(baseColor, WHITE));
 	const opaqueForeground = composite(fg, opaqueBackground);
-	const lighter = Math.max(relativeLuminance(opaqueForeground), relativeLuminance(opaqueBackground));
+	const lighter = Math.max(
+		relativeLuminance(opaqueForeground),
+		relativeLuminance(opaqueBackground),
+	);
 	const darker = Math.min(relativeLuminance(opaqueForeground), relativeLuminance(opaqueBackground));
 
 	return (lighter + LUMINANCE_OFFSET) / (darker + LUMINANCE_OFFSET);

package/src/color/parse.ts

@@ -50,12 +50,11 @@ function parseHex(digits: string): Rgba {
 	const full =
 		digits.length <= 4
 			? digits
-				.split('')
-				.map(digit => digit + digit)
-				.join('')
+					.split('')
+					.map(digit => digit + digit)
+					.join('')
 			: digits;
-	const channel = (index: number) =>
-		parseInt(full.slice(index * 2, index * 2 + 2), 16);
+	const channel = (index: number) => parseInt(full.slice(index * 2, index * 2 + 2), 16);
 
 	return {
 		r: channel(0),

package/src/index.ts

@@ -5,10 +5,7 @@ export { ThemeConfigError, ThemeContrastError } from './theme/errors';
 
 // ─── Unistyles ──────────────────────────────────────────────────────────────
 export { createUnistylesConfig } from './unistyles/createUnistylesConfig';
-export type {
-	UnistylesConfig,
-	UnistylesConfigOptions,
-} from './unistyles/createUnistylesConfig';
+export type { UnistylesConfig, UnistylesConfigOptions } from './unistyles/createUnistylesConfig';
 export { applyThemeMode } from './unistyles/themeMode';
 export type { ThemeMode, ThemeModeRuntime } from './unistyles/themeMode';
 export { DEFAULT_BREAKPOINTS } from './tokens/defaults';

package/src/theme/buildThemes.ts

@@ -143,7 +143,10 @@ export function buildThemes<
 	TExt extends object = EmptyExtension,
 	TTone extends string = never,
 	TName extends string = never,
->(config: ThemeConfig<TExt, TTone, TName>, options?: BuildThemesOptions): Themes<TExt, TTone, TName> {
+>(
+	config: ThemeConfig<TExt, TTone, TName>,
+	options?: BuildThemesOptions,
+): Themes<TExt, TTone, TName> {
 	validateThemeConfig(config);
 
 	const loose = config as unknown as ThemeConfig<object, string, string>;
@@ -161,7 +164,12 @@ export function buildThemes<
 				tones: { ...loose.tones, ...named.tones } as Record<string, string>,
 			};
 
-			return { name, scheme: named.scheme, config: namedConfig, palettes: buildPalettes(namedConfig) };
+			return {
+				name,
+				scheme: named.scheme,
+				config: namedConfig,
+				palettes: buildPalettes(namedConfig),
+			};
 		}),
 	];
 	const themes: Record<string, object> = {};

package/src/theme/overrides.ts

@@ -85,7 +85,12 @@ function mergeEntry(entry: Entry): unknown {
  * keys must exist in `base`, colours must parse, numbers must be finite.
  * Arrays are replaced whole. `base` itself is never mutated.
  */
-export function mergeOverrides<T>(base: T, overrides: unknown, path: string, segments: string[] = []): T {
+export function mergeOverrides<T>(
+	base: T,
+	overrides: unknown,
+	path: string,
+	segments: string[] = [],
+): T {
 	if (overrides == null) {
 		return base;
 	}

package/src/theme/validateThemeConfig.ts

@@ -70,7 +70,10 @@ function validateFontMap(value: unknown, path: string): void {
 
 	for (const [weight, family] of Object.entries(value)) {
 		if (!FONT_WEIGHT_NAMES.includes(weight as FontWeightName)) {
-			throw new ThemeConfigError(`${path}.${weight}`, `is not one of ${FONT_WEIGHT_NAMES.join(', ')}.`);
+			throw new ThemeConfigError(
+				`${path}.${weight}`,
+				`is not one of ${FONT_WEIGHT_NAMES.join(', ')}.`,
+			);
 		}
 		assertNonEmptyString(family, `${path}.${weight}`);
 	}
@@ -114,7 +117,10 @@ function validateNamedThemes(value: unknown): void {
 		const path = `themes.${name}`;
 
 		if (RESERVED_THEME_NAMES.has(name)) {
-			throw new ThemeConfigError(path, 'light and dark are built in; customise them with overrides.');
+			throw new ThemeConfigError(
+				path,
+				'light and dark are built in; customise them with overrides.',
+			);
 		}
 
 		assertObject(theme, path);

package/src/tokens/typography.ts

@@ -84,7 +84,9 @@ export function buildFonts(config: TypographyConfig | undefined, platform: Platf
 		// iOS picks weights inside one family, so a partial iOS map only renames
 		// the weights it lists; Android needs a file per weight, hence nearest.
 		const nearest =
-			platform === 'ios' ? (perWeight?.[weight] && weight) : perWeight && nearestWeight(weight, perWeight);
+			platform === 'ios'
+				? perWeight?.[weight] && weight
+				: perWeight && nearestWeight(weight, perWeight);
 
 		if (!perWeight || !nearest) {
 			return { fontFamily: family, fontWeight: FONT_WEIGHTS[weight] };
@@ -117,7 +119,8 @@ export function buildTypography(
 	font: Record<FontWeightName, FontToken>,
 	family: string,
 ): Typography {
-	const scale = ((config?.baseFontSize ?? DEFAULT_BODY_SIZE) / DEFAULT_BODY_SIZE) * (config?.fontScale ?? 1);
+	const scale =
+		((config?.baseFontSize ?? DEFAULT_BODY_SIZE) / DEFAULT_BODY_SIZE) * (config?.fontScale ?? 1);
 	const typography = { fontFamily: family } as Typography;
 
 	for (const role of Object.keys(SCALE) as TypographyRole[]) {

package/src/types/colors.ts

@@ -2,13 +2,7 @@ export type ColorScheme = 'light' | 'dark';
 
 /** Colours whose roles come in sets of four: X, onX, XContainer, onXContainer. */
 export type AccentRoleName =
-	| 'primary'
-	| 'secondary'
-	| 'tertiary'
-	| 'error'
-	| 'success'
-	| 'warning'
-	| 'info';
+	'primary' | 'secondary' | 'tertiary' | 'error' | 'success' | 'warning' | 'info';
 
 export interface ColorRoles {
 	primary: string;
@@ -69,13 +63,7 @@ export interface ColorRoles {
 	disabled: string;
 }
 
-export type StandardToneName =
-	| 'neutral'
-	| 'primary'
-	| 'info'
-	| 'success'
-	| 'warning'
-	| 'error';
+export type StandardToneName = 'neutral' | 'primary' | 'info' | 'success' | 'warning' | 'error';
 
 /** A matched colour set for one tone, for use with `byTone`. */
 export interface ToneColors {

package/src/types/theme.ts

@@ -114,8 +114,10 @@ export interface BaseTheme<TTone extends string = never> {
 
 export type EmptyExtension = Record<never, never>;
 
-export type Theme<TExt extends object = EmptyExtension, TTone extends string = never> = BaseTheme<TTone> &
-	TExt;
+export type Theme<
+	TExt extends object = EmptyExtension,
+	TTone extends string = never,
+> = BaseTheme<TTone> & TExt;
 
 export type ThemeName<TName extends string = never> = 'light' | 'dark' | TName;
 

package/src/types/typography.ts

@@ -32,9 +32,7 @@ export interface TypographyConfig {
 export type TypographyRole = 'display' | 'headline' | 'title' | 'body' | 'label' | 'caption';
 
 export type TypographyStyleName =
-	| TypographyRole
-	| `${TypographyRole}Small`
-	| `${TypographyRole}Large`;
+	TypographyRole | `${TypographyRole}Small` | `${TypographyRole}Large`;
 
 export interface TypographyToken {
 	fontSize: number;

package/src/unistyles/createUnistylesConfig.ts

@@ -21,15 +21,15 @@ export type UnistylesConfigOptions<
 		breakpoints?: TBreakpoints;
 	} & (
 		| {
-			/** Theme active on first launch. Defaults to 'light'. */
-			initialTheme?: ThemeName<TName> | (() => ThemeName<TName>);
-			adaptiveThemes?: false;
-		}
+				/** Theme active on first launch. Defaults to 'light'. */
+				initialTheme?: ThemeName<TName> | (() => ThemeName<TName>);
+				adaptiveThemes?: false;
+		  }
 		| {
-			/** Follow the system colour scheme between light and dark. */
-			adaptiveThemes: boolean;
-			initialTheme?: never;
-		}
+				/** Follow the system colour scheme between light and dark. */
+				adaptiveThemes: boolean;
+				initialTheme?: never;
+		  }
 	);
 
 type UnistylesSettings<TName extends string> = UnistylesBaseSettings &
@@ -103,7 +103,11 @@ function validateOptions(options: unknown, themeNames: string[]): void {
 		throw new ThemeConfigError('options.CSSVars', 'must be a boolean.');
 	}
 
-	if (nativeBreakpointsMode != null && nativeBreakpointsMode !== 'pixels' && nativeBreakpointsMode !== 'points') {
+	if (
+		nativeBreakpointsMode != null &&
+		nativeBreakpointsMode !== 'pixels' &&
+		nativeBreakpointsMode !== 'points'
+	) {
 		throw new ThemeConfigError('options.nativeBreakpointsMode', "must be 'pixels' or 'points'.");
 	}