@next-box/appsettings 0.0.6 → 0.0.8

package/README.md

@@ -80,9 +80,9 @@ export default async function RootLayout({ children }: { children: React.ReactNo
 
   return (
     <html lang="en">
-      <body>
-        <AppSettingsProvider settings={settings}>{children}</AppSettingsProvider>
-      </body>
+    <body>
+    <AppSettingsProvider settings={settings}>{children}</AppSettingsProvider>
+    </body>
     </html>
   );
 }
@@ -132,35 +132,80 @@ Each later source overrides earlier values according to the merge rules describe
 
 ### Read settings
 
-Paths use dot notation. `useAppSetting` reads a leaf value and `useAppSettings` reads an object section:
+Paths use dot notation. The library provides two hook factories:
+
+- `createUseSetting` creates a hook for reading individual setting values.
+- `createUseAppSettings` creates a hook for reading object sections.
+
+Both factories accept your application's settings type and return a fully typed React hook.
+
+#### Create typed hooks
+
+Create the hooks once, outside your React components:
+
+```ts
+// ./src/hooks/appSettings.ts
+'use client';
+
+import {
+  createUseAppSettings,
+  createUseSetting,
+} from '@next-box/appsettings';
+
+import type { AppSettingsConfig } from '../appSettings.schema';
+
+export const useSetting = createUseSetting<AppSettingsConfig>();
+
+export const useAppSettings = createUseAppSettings<AppSettingsConfig>();
+```
+
+#### Use the hooks in components
 
 ```tsx
 // ./src/ApiTimeout.tsx
 'use client';
 
-import { useAppSetting, useAppSettings } from '@next-box/appsettings';
+import { useAppSettings, useSetting } from './hooks/appSettings';
 
 export const ApiTimeout = () => {
-  const timeout = useAppSetting('Api.Timeout');
+  const timeout = useSetting('Api.Timeout');
+  const api = useAppSettings('Api');
   const features = useAppSettings('Features');
 
-  return <span>{features?.DarkMode ? timeout : 'Disabled'}</span>;
+  return (
+    <span>
+      {features?.DarkMode ? `${api?.BaseUrl} (${timeout}ms)` : 'Disabled'}
+    </span>
+  );
 };
 ```
 
-The settings snapshot is read-only. Configuration is loaded and validated before it reaches the provider; there are no client-side mutation or reload methods.
+#### Type inference
+
+Given the `AppSettingsConfig` schema defined above:
 
-Leaf paths and their values are checked against the inferred schema. The reader uses bounded nested path types and `type-fest`'s `Get<T, P>` for path value types.
+```ts
+const timeout = useSetting('Api.Timeout');
+// number | undefined
 
-React context cannot infer the settings type from a provider at a separate hook call site. Generate a module augmentation from the exported schema type:
+const baseUrl = useSetting('Api.BaseUrl');
+// string | undefined
 
-```shell
-pnpm exec appsettings generate-types ./src/appSettings.schema.ts ./src/appSettings.generated.d.ts --type AppSettingsConfig
+const api = useAppSettings('Api');
+// { BaseUrl: string; Timeout: number } | undefined
+
+const features = useAppSettings('Features');
+// { DarkMode: boolean; NewDashboard: boolean } | undefined
+
+useSetting('Api.InvalidProperty');
+// TypeScript error
 ```
 
-The command writes a declaration that imports `AppSettingsConfig` and augments the package's `AppSettingsSchema`. TypeScript then infers each hook result from the value type at the end of its path. Zod enums and literals stay precise, while `z.string()` and `z.number()` remain broad types. The declaration only provides types; configuration still loads and validates on the server.
+Both hooks return `undefined` when the requested path does not exist.
+
+The settings snapshot is read-only. Configuration is loaded and validated before it reaches the provider; there are no client-side mutation or reload methods.
 
-Run the command after changing the schema, or add it to the consuming application's `predev`, `prebuild`, and type-check scripts so the declaration stays current. The generated file must be included by the application's `tsconfig.json`.
+No module augmentation or generated declaration files are required. Each application supplies its settings type explicitly when creating its hooks.
 
 ### Conditionally render with `Setting`
 

package/dist/cjs/hooks/createUseAppSettings.cjs

@@ -0,0 +1,2 @@
+"use strict";var e=require("./useAppSettingsContext.cjs");exports.createUseAppSettings=()=>t=>e.useAppSettingsContext().read(t);
+//# sourceMappingURL=createUseAppSettings.cjs.map

package/dist/cjs/hooks/createUseAppSettings.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUseAppSettings.cjs","sources":["../../../src/hooks/createUseAppSettings.ts"],"sourcesContent":["import { type Get } from 'type-fest';\nimport { type SettingSectionPath } from '#types/Config.types.ts';\nimport { useAppSettingsContext } from './useAppSettingsContext.ts';\n\nexport const createUseAppSettings = <T extends object>() => {\n  return <P extends SettingSectionPath<T>>(path: P): Get<T, P> | undefined => {\n    const settings = useAppSettingsContext();\n    // Assert the resolved settings type based on the caller-provided schema and path.\n    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions\n    return settings.read(path) as Get<T, P> | undefined;\n  };\n};\n"],"names":["path","useAppSettingsContext","read"],"mappings":"uFAIoC,IACOA,GACtBC,EAAAA,wBAGDC,KAAKF"}

package/dist/cjs/hooks/createUseSetting.cjs

@@ -0,0 +1,2 @@
+"use strict";var e=require("./useAppSettingsContext.cjs");exports.createUseSetting=()=>t=>e.useAppSettingsContext().read(t);
+//# sourceMappingURL=createUseSetting.cjs.map

package/dist/cjs/hooks/createUseSetting.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUseSetting.cjs","sources":["../../../src/hooks/createUseSetting.ts"],"sourcesContent":["import { type Get } from 'type-fest';\nimport { useAppSettingsContext } from '#hooks/useAppSettingsContext.ts';\nimport { type SettingPath } from '#types/Config.types.ts';\n\nexport const createUseSetting = <T extends object>() => {\n  return <P extends SettingPath<T>>(path: P): Get<T, P> | undefined => {\n    const settings = useAppSettingsContext();\n    // Assert the resolved setting type based on the caller-provided schema and path.\n    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions\n    return settings.read(path) as Get<T, P> | undefined;\n  };\n};\n"],"names":["path","useAppSettingsContext","read"],"mappings":"mFAIgC,IACIA,GACfC,EAAAA,wBAGDC,KAAKF"}

package/dist/cjs/index.cjs

@@ -1,2 +1,2 @@
-"use strict";var e=require("./components/AppSettingsProvider.cjs"),t=require("./components/Setting.cjs"),s=require("./hooks/useAppSetting.cjs"),p=require("./hooks/useAppSettings.cjs"),i=require("./hooks/useAppSettingsContext.cjs");exports.AppSettingsProvider=e.AppSettingsProvider,exports.Setting=t.Setting,exports.useAppSetting=s.useAppSetting,exports.useAppSettings=p.useAppSettings,exports.useAppSettingsContext=i.useAppSettingsContext;
+"use strict";var e=require("./components/AppSettingsProvider.cjs"),t=require("./components/Setting.cjs"),s=require("./hooks/createUseSetting.cjs"),r=require("./hooks/createUseAppSettings.cjs"),p=require("./hooks/useAppSettingsContext.cjs");exports.AppSettingsProvider=e.AppSettingsProvider,exports.Setting=t.Setting,exports.createUseSetting=s.createUseSetting,exports.createUseAppSettings=r.createUseAppSettings,exports.useAppSettingsContext=p.useAppSettingsContext;
 //# sourceMappingURL=index.cjs.map

package/dist/esm/hooks/createUseAppSettings.mjs

@@ -0,0 +1,2 @@
+import{useAppSettingsContext as t}from"./useAppSettingsContext.mjs";const e=()=>e=>t().read(e);export{e as createUseAppSettings};
+//# sourceMappingURL=createUseAppSettings.mjs.map

package/dist/esm/hooks/createUseAppSettings.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUseAppSettings.mjs","sources":["../../../src/hooks/createUseAppSettings.ts"],"sourcesContent":["import { type Get } from 'type-fest';\nimport { type SettingSectionPath } from '#types/Config.types.ts';\nimport { useAppSettingsContext } from './useAppSettingsContext.ts';\n\nexport const createUseAppSettings = <T extends object>() => {\n  return <P extends SettingSectionPath<T>>(path: P): Get<T, P> | undefined => {\n    const settings = useAppSettingsContext();\n    // Assert the resolved settings type based on the caller-provided schema and path.\n    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions\n    return settings.read(path) as Get<T, P> | undefined;\n  };\n};\n"],"names":["createUseAppSettings","path","useAppSettingsContext","read"],"mappings":"0EAIaA,EAAuB,IACOC,GACtBC,IAGDC,KAAKF"}

package/dist/esm/hooks/createUseSetting.mjs

@@ -0,0 +1,2 @@
+import{useAppSettingsContext as t}from"./useAppSettingsContext.mjs";const e=()=>e=>t().read(e);export{e as createUseSetting};
+//# sourceMappingURL=createUseSetting.mjs.map

package/dist/esm/hooks/createUseSetting.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUseSetting.mjs","sources":["../../../src/hooks/createUseSetting.ts"],"sourcesContent":["import { type Get } from 'type-fest';\nimport { useAppSettingsContext } from '#hooks/useAppSettingsContext.ts';\nimport { type SettingPath } from '#types/Config.types.ts';\n\nexport const createUseSetting = <T extends object>() => {\n  return <P extends SettingPath<T>>(path: P): Get<T, P> | undefined => {\n    const settings = useAppSettingsContext();\n    // Assert the resolved setting type based on the caller-provided schema and path.\n    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions\n    return settings.read(path) as Get<T, P> | undefined;\n  };\n};\n"],"names":["createUseSetting","path","useAppSettingsContext","read"],"mappings":"0EAIaA,EAAmB,IACIC,GACfC,IAGDC,KAAKF"}

package/dist/esm/index.mjs

@@ -1,2 +1,2 @@
-export{AppSettingsProvider}from"./components/AppSettingsProvider.mjs";export{Setting}from"./components/Setting.mjs";export{useAppSetting}from"./hooks/useAppSetting.mjs";export{useAppSettings}from"./hooks/useAppSettings.mjs";export{useAppSettingsContext}from"./hooks/useAppSettingsContext.mjs";
+export{AppSettingsProvider}from"./components/AppSettingsProvider.mjs";export{Setting}from"./components/Setting.mjs";export{createUseSetting}from"./hooks/createUseSetting.mjs";export{createUseAppSettings}from"./hooks/createUseAppSettings.mjs";export{useAppSettingsContext}from"./hooks/useAppSettingsContext.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/types/cjs/hooks/createUseAppSettings.d.cts

@@ -0,0 +1,4 @@
+import { type Get } from 'type-fest';
+import { type SettingSectionPath } from '#types/Config.types.cts';
+export declare const createUseAppSettings: <T extends object>() => <P extends SettingSectionPath<T>>(path: P) => Get<T, P> | undefined;
+//# sourceMappingURL=createUseAppSettings.d.cts.map

package/dist/types/cjs/hooks/createUseAppSettings.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUseAppSettings.d.cts","sourceRoot":"","sources":["../../../../src/hooks/createUseAppSettings.cts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGjE,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,MAAM,QAC3C,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAMhE,CAAC"}

package/dist/types/cjs/hooks/createUseSetting.d.cts

@@ -0,0 +1,4 @@
+import { type Get } from 'type-fest';
+import { type SettingPath } from '#types/Config.types.cts';
+export declare const createUseSetting: <T extends object>() => <P extends SettingPath<T>>(path: P) => Get<T, P> | undefined;
+//# sourceMappingURL=createUseSetting.d.cts.map

package/dist/types/cjs/hooks/createUseSetting.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUseSetting.d.cts","sourceRoot":"","sources":["../../../../src/hooks/createUseSetting.cts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,MAAM,QACvC,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAMzD,CAAC"}

package/dist/types/cjs/index.d.cts

@@ -1,11 +1,8 @@
 export { AppSettingsProvider } from '#components/AppSettingsProvider.ctsx';
 export { Setting } from '#components/Setting.ctsx';
-export { useAppSetting } from '#hooks/useAppSetting.cts';
-export { useAppSettings } from '#hooks/useAppSettings.cts';
+export { createUseSetting } from '#hooks/createUseSetting.cts';
+export { createUseAppSettings } from '#hooks/createUseAppSettings.cts';
 export { useAppSettingsContext } from '#hooks/useAppSettingsContext.cts';
 export type { AppSettings, ScopedSettings } from '#types/AppSettings.types.cts';
 export type { SettingPath, SettingSectionPath, SettingValue } from '#types/Config.types.cts';
-export interface AppSettingsSchema {
-    readonly __appSettingsSchema?: never;
-}
 //# sourceMappingURL=index.d.cts.map

package/dist/types/cjs/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../src/index.cts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC/E,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG5F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,KAAK,CAAC;CACtC"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../src/index.cts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC/E,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/types/cjs/types/Config.types.d.cts

@@ -5,8 +5,8 @@ export type SettingPath<T extends object, Depth extends number = 5> = Depth exte
     [K in Extract<keyof T, string>]: T[K] extends Primitive | readonly Primitive[] ? K : T[K] extends object ? `${K}.${SettingPath<T[K], PreviousDepth[Depth]>}` : K;
 }[Extract<keyof T, string>];
 export type SettingSectionPath<T extends object, Depth extends number = 5> = Depth extends 0 ? never : {
-    [K in Exclude<Extract<keyof T, string>, '__appSettingsSchema'>]: NonNullable<T[K]> extends Primitive | readonly Primitive[] ? never : NonNullable<T[K]> extends object ? K | `${K}.${SettingSectionPath<NonNullable<T[K]>, PreviousDepth[Depth]>}` : never;
-}[Exclude<Extract<keyof T, string>, '__appSettingsSchema'>];
+    [K in Extract<keyof T, string>]: NonNullable<T[K]> extends Primitive | readonly Primitive[] ? never : NonNullable<T[K]> extends object ? K | `${K}.${SettingSectionPath<NonNullable<T[K]>, PreviousDepth[Depth]>}` : never;
+}[Extract<keyof T, string>];
 export type SettingValue<T extends object, P extends SettingPath<T>> = Get<T, P>;
 export {};
 //# sourceMappingURL=Config.types.d.cts.map

package/dist/types/cjs/types/Config.types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"Config.types.d.cts","sourceRoot":"","sources":["../../../../src/types/Config.types.cts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAEhF,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAE/C,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,SAAS,MAAM,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,GACjF,KAAK,GACL;KACG,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,SAAS,EAAE,GAC1E,CAAC,GACD,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACjB,GAAG,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,GACjD,CAAC;CACR,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhC,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,SAAS,MAAM,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,GACxF,KAAK,GACL;KACG,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,qBAAqB,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAChF,SAAS,GAAG,SAAS,SAAS,EAAE,GAC9B,KAAK,GACL,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAC9B,CAAC,GAAG,GAAG,CAAC,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,GACzE,KAAK;CACZ,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC;AAEhE,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"Config.types.d.cts","sourceRoot":"","sources":["../../../../src/types/Config.types.cts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAEhF,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAE/C,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,SAAS,MAAM,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,GACjF,KAAK,GACL;KACG,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,SAAS,EAAE,GAC1E,CAAC,GACD,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACjB,GAAG,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,GACjD,CAAC;CACR,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhC,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,SAAS,MAAM,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,GACxF,KAAK,GACL;KACG,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,SAAS,EAAE,GACvF,KAAK,GACL,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAC9B,CAAC,GAAG,GAAG,CAAC,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,GACzE,KAAK;CACZ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhC,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/dist/types/esm/hooks/createUseAppSettings.d.ts

@@ -0,0 +1,4 @@
+import { type Get } from 'type-fest';
+import { type SettingSectionPath } from '#types/Config.types.ts';
+export declare const createUseAppSettings: <T extends object>() => <P extends SettingSectionPath<T>>(path: P) => Get<T, P> | undefined;
+//# sourceMappingURL=createUseAppSettings.d.ts.map

package/dist/types/esm/hooks/createUseAppSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUseAppSettings.d.ts","sourceRoot":"","sources":["../../../../src/hooks/createUseAppSettings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGjE,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,MAAM,QAC3C,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAMhE,CAAC"}

package/dist/types/esm/hooks/createUseSetting.d.ts

@@ -0,0 +1,4 @@
+import { type Get } from 'type-fest';
+import { type SettingPath } from '#types/Config.types.ts';
+export declare const createUseSetting: <T extends object>() => <P extends SettingPath<T>>(path: P) => Get<T, P> | undefined;
+//# sourceMappingURL=createUseSetting.d.ts.map

package/dist/types/esm/hooks/createUseSetting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUseSetting.d.ts","sourceRoot":"","sources":["../../../../src/hooks/createUseSetting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,MAAM,QACvC,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAMzD,CAAC"}

package/dist/types/esm/index.d.ts

@@ -1,11 +1,8 @@
 export { AppSettingsProvider } from '#components/AppSettingsProvider.tsx';
 export { Setting } from '#components/Setting.tsx';
-export { useAppSetting } from '#hooks/useAppSetting.ts';
-export { useAppSettings } from '#hooks/useAppSettings.ts';
+export { createUseSetting } from '#hooks/createUseSetting.ts';
+export { createUseAppSettings } from '#hooks/createUseAppSettings.ts';
 export { useAppSettingsContext } from '#hooks/useAppSettingsContext.ts';
 export type { AppSettings, ScopedSettings } from '#types/AppSettings.types.ts';
 export type { SettingPath, SettingSectionPath, SettingValue } from '#types/Config.types.ts';
-export interface AppSettingsSchema {
-    readonly __appSettingsSchema?: never;
-}
 //# sourceMappingURL=index.d.ts.map

package/dist/types/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC/E,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG5F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,KAAK,CAAC;CACtC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC/E,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/types/esm/types/Config.types.d.ts

@@ -5,8 +5,8 @@ export type SettingPath<T extends object, Depth extends number = 5> = Depth exte
     [K in Extract<keyof T, string>]: T[K] extends Primitive | readonly Primitive[] ? K : T[K] extends object ? `${K}.${SettingPath<T[K], PreviousDepth[Depth]>}` : K;
 }[Extract<keyof T, string>];
 export type SettingSectionPath<T extends object, Depth extends number = 5> = Depth extends 0 ? never : {
-    [K in Exclude<Extract<keyof T, string>, '__appSettingsSchema'>]: NonNullable<T[K]> extends Primitive | readonly Primitive[] ? never : NonNullable<T[K]> extends object ? K | `${K}.${SettingSectionPath<NonNullable<T[K]>, PreviousDepth[Depth]>}` : never;
-}[Exclude<Extract<keyof T, string>, '__appSettingsSchema'>];
+    [K in Extract<keyof T, string>]: NonNullable<T[K]> extends Primitive | readonly Primitive[] ? never : NonNullable<T[K]> extends object ? K | `${K}.${SettingSectionPath<NonNullable<T[K]>, PreviousDepth[Depth]>}` : never;
+}[Extract<keyof T, string>];
 export type SettingValue<T extends object, P extends SettingPath<T>> = Get<T, P>;
 export {};
 //# sourceMappingURL=Config.types.d.ts.map

package/dist/types/esm/types/Config.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Config.types.d.ts","sourceRoot":"","sources":["../../../../src/types/Config.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAEhF,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAE/C,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,SAAS,MAAM,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,GACjF,KAAK,GACL;KACG,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,SAAS,EAAE,GAC1E,CAAC,GACD,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACjB,GAAG,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,GACjD,CAAC;CACR,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhC,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,SAAS,MAAM,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,GACxF,KAAK,GACL;KACG,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,qBAAqB,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAChF,SAAS,GAAG,SAAS,SAAS,EAAE,GAC9B,KAAK,GACL,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAC9B,CAAC,GAAG,GAAG,CAAC,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,GACzE,KAAK;CACZ,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC;AAEhE,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"Config.types.d.ts","sourceRoot":"","sources":["../../../../src/types/Config.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAEhF,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAE/C,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,SAAS,MAAM,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,GACjF,KAAK,GACL;KACG,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,SAAS,EAAE,GAC1E,CAAC,GACD,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACjB,GAAG,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,GACjD,CAAC;CACR,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhC,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,SAAS,MAAM,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,GACxF,KAAK,GACL;KACG,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,SAAS,EAAE,GACvF,KAAK,GACL,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAC9B,CAAC,GAAG,GAAG,CAAC,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,GACzE,KAAK;CACZ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhC,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}