@wocart/theme 1.1.0 → 1.1.1

package/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to `@wocart/theme` are recorded here. The package follows
 major version, and an export is marked `@deprecated` for at least one minor
 release before a major removes it.
 
+## 1.1.1 — 2026-10-17
+
+### Fixed
+
+- `resolveThemeSettings` returns its values typed from the theme's
+  declaration (`InferSettings<typeof theme>`) instead of
+  `Record<string, unknown>`, as the README promised: a setting with a default
+  is a value, any other may be absent. `ThemeSettingsResult` takes the values'
+  type as an optional parameter. No runtime change.
+
 ## 1.1.0 — 2026-10-17
 
 ### Added

package/README.md

@@ -329,7 +329,7 @@ export const theme = defineTheme({
 });
 
 const { values, issues } = resolveThemeSettings(theme, config?.themeSettings, { locales: [locale] });
-values.headerMenu; // "main-menu" — typed: InferSettings<typeof theme>
+values.headerMenu; // "main-menu" — values: InferSettings<typeof theme>, from 1.1.1
 ```
 
 - **Reading never fails.** Each setting takes the merchant's value when the

package/dist/settings.d.ts

@@ -1,12 +1,14 @@
-import type { ResolutionScope, ThemeDefinition, ThemeSettingsIssue, ThemeSettingsResult } from "./types.js";
+import type { InferSettings, ResolutionScope, ThemeDefinition, ThemeSettingsIssue, ThemeSettingsResult } from "./types.js";
 /**
  * The effective settings for rendering: every declared setting, from the
  * store's value when the declaration accepts it, else from the theme's
  * default. `stored` is the persisted object as it arrived (anything else —
  * null, an array — reads as no values and is reported). Translated text uses
- * `scope.locales`; text settings may default from `scope.content`.
+ * `scope.locales`; text settings may default from `scope.content`. The
+ * values are typed from the declaration (`InferSettings<typeof theme>`): a
+ * setting with a default is always there, any other may be absent.
  */
-export declare function resolveThemeSettings(theme: ThemeDefinition, stored: unknown, scope?: ResolutionScope): ThemeSettingsResult;
+export declare function resolveThemeSettings<T extends ThemeDefinition>(theme: T, stored: unknown, scope?: ResolutionScope): ThemeSettingsResult<InferSettings<T>>;
 /**
  * What a writer must check before saving a store's settings for a theme:
  * every key declared, every value accepted by its setting — in every language

package/dist/settings.js

@@ -29,7 +29,9 @@ const PAGE_TO_SETTINGS = {
  * store's value when the declaration accepts it, else from the theme's
  * default. `stored` is the persisted object as it arrived (anything else —
  * null, an array — reads as no values and is reported). Translated text uses
- * `scope.locales`; text settings may default from `scope.content`.
+ * `scope.locales`; text settings may default from `scope.content`. The
+ * values are typed from the declaration (`InferSettings<typeof theme>`): a
+ * setting with a default is always there, any other may be absent.
  */
 export function resolveThemeSettings(theme, stored, scope = {}) {
     const issues = [];

package/dist/types.d.ts

@@ -449,8 +449,8 @@ export interface ThemeSettingsIssue {
     message: string;
 }
 /** The effective settings: every value checked, the rest from the theme's defaults. */
-export interface ThemeSettingsResult {
-    values: Record<string, unknown>;
+export interface ThemeSettingsResult<V = Record<string, unknown>> {
+    values: V;
     issues: ThemeSettingsIssue[];
 }
 type SettingsFieldsOf<T> = T extends {
@@ -463,8 +463,7 @@ type SettingsFieldsOf<T> = T extends {
  * with a `default` is always present, any other may be absent.
  *
  * ```ts
- * const { values } = resolveThemeSettings(theme, stored);
- * const settings = values as InferSettings<typeof theme>;
+ * const { values } = resolveThemeSettings(theme, stored); // values: InferSettings<typeof theme>
  * ```
  */
 export type InferSettings<T extends ThemeDefinition> = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wocart/theme",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "The Wocart theme contract: code-owned component definitions, JSON page documents, validation and resolution, and a reference Astro renderer.",
   "keywords": [
     "wocart",