@jfdevelops/react-layout 1.6.0 → 2.0.0

package/dist/create-config/layout-name.d.cts

@@ -80,7 +80,6 @@ type NamingPartsInput<Definitions extends LayoutNamePartDefinitions, Parts exten
 type NamingPartsCallback<Definitions extends LayoutNamePartDefinitions, Parts extends LayoutNamePartValues<Definitions>> = (context: PatternNameContext) => NamingPartsInput<Definitions, Parts>;
 type ResolvedParts<Definitions extends LayoutNamePartDefinitions, Parts> = { [Key in keyof Definitions]: Key extends keyof Parts ? Parts[Key] : '' };
 type NamingPattern<Definitions extends LayoutNamePartDefinitions, Pattern extends string, Strict extends boolean = true> = (context: PatternNameContext, parts: [Strict] extends [false] ? UncheckedNamingParts<Definitions> : PatternParts<Definitions>) => Pattern;
-type NamingDefinition<Definitions extends LayoutNamePartDefinitions, Pattern extends string, Strict extends boolean> = NamingPattern<Definitions, Pattern, Strict> | LayoutNameOptions<Definitions, Pattern, Strict>;
 /**
  * Supplies optional part values while preserving their literal types in names.
  */
@@ -108,7 +107,7 @@ interface DefinedLayoutNameParts<Definitions extends LayoutNamePartDefinitions>
    * Defines the naming pattern and optional strict-checking policy.
    * Strict defaults to true; false accepts unchecked part keys and values.
    */
-  namingFn<const Pattern extends string, const Strict extends boolean = true>(definition: NamingDefinition<Definitions, Pattern, Strict>): LayoutNameFactory<Definitions, Pattern, Strict>;
+  namingFn<const Pattern extends string, const Strict extends boolean = true>(definition: LayoutNameOptions<Definitions, Pattern, Strict>): LayoutNameFactory<Definitions, Pattern, Strict>;
 }
 declare const defaultPartDefinitions: {
   prefix: "string";
@@ -126,11 +125,11 @@ declare const defaultPartDefinitions: {
  *
  * Choose the form that matches the values your convention needs:
  *
- * - `defineLayoutName(pattern)` provides the string parts `prefix`,
+ * - `defineLayoutName({ pattern })` provides the string parts `prefix`,
  *   `beforeSuffix`, and `append` for common naming variations.
- * - `defineLayoutName.defineParts(...names).namingFn(pattern)` provides custom
+ * - `defineLayoutName.defineParts(...names).namingFn({ pattern })` provides custom
  *   string parts when domain-specific names make the pattern clearer.
- * - `defineLayoutName.defineParts(schema).namingFn(pattern)` declares each
+ * - `defineLayoutName.defineParts(schema).namingFn({ pattern })` declares each
  *   part as `'string'` or `'number'` when supplied values need different types.
  *
  * The pattern controls where parts appear; their names do not impose an order.
@@ -147,29 +146,32 @@ declare const defaultPartDefinitions: {
  * in namingFn to accept unchecked part keys and values in both TypeScript
  * and runtime calls. Unchecked conventions return string names.
  *
- * @param definition - A pattern callback, or an object containing the pattern
- * and optional strict-checking policy.
+ * @param definition - An object containing the naming pattern and optional
+ * strict-checking policy.
  * @returns A function accepting optional part values or a context callback.
  * Calling it with no arguments leaves every declared part empty.
  *
  * @example
  * Use the default string parts for a shared convention with occasional variants.
  * ```tsx
- * const layoutName = defineLayoutName(({ resource, capitalize }, parts) =>
- *   `${parts.prefix}${capitalize(resource)}${parts.beforeSuffix}Layout${parts.append}`,
- * );
+ * const layoutName = defineLayoutName({
+ *   pattern: ({ resource, capitalize }, parts) =>
+ *     `${parts.prefix}${capitalize(resource)}${parts.beforeSuffix}Layout${
+ *       parts.append
+ *     }`
+ * });
  * const factory = createDefinedResourceLayout({
  *   resources: ['users'],
- *   name: layoutName(),
+ *   name: layoutName()
  * });
  * const { createResourceLayout } = factory.defineResourceLayout({
- *   render: () => <div />,
+ *   render: () => <div />
  * });
  * const Users = createResourceLayout({ resource: 'users' });
  * // Users.displayName is typed as 'UsersLayout'.
  * const AdminUsers = createResourceLayout({
  *   resource: 'users',
- *   name: layoutName({ prefix: 'Admin', beforeSuffix: 'Detail' }),
+ *   name: layoutName({ prefix: 'Admin', beforeSuffix: 'Detail' })
  * });
  * // AdminUsers.displayName is typed as 'AdminUsersDetailLayout'.
  * ```
@@ -180,13 +182,14 @@ declare const defaultPartDefinitions: {
  * ```ts
  * const pageName = defineLayoutName
  *   .defineParts('section', 'variant')
- *   .namingFn(({ resource, capitalize }, parts) =>
- *     `${parts.section}${capitalize(resource)}${parts.variant}Page`,
- *   );
+ *   .namingFn({
+ *     pattern: ({ resource, capitalize }, parts) =>
+ *       `${parts.section}${capitalize(resource)}${parts.variant}Page`
+ *   });
  * const adminPage = pageName({ section: 'Admin', variant: 'Detail' });
  * // Used for 'users', this produces 'AdminUsersDetailPage'.
  * const resourcePage = pageName(({ resource }) => ({
- *   section: resource === 'users' ? 'Admin' : 'Public',
+ *   section: resource === 'users' ? 'Admin' : 'Public'
  * }));
  * // Used for 'users', this produces 'AdminUsersPage'.
  * // Other resources receive the 'Public' section instead.
@@ -198,9 +201,10 @@ declare const defaultPartDefinitions: {
  * ```ts
  * const versionedName = defineLayoutName
  *   .defineParts({ section: 'string', version: 'number' })
- *   .namingFn(({ resource, capitalize }, parts) =>
- *     `${parts.section}${capitalize(resource)}V${parts.version}`,
- *   );
+ *   .namingFn({
+ *     pattern: ({ resource, capitalize }, parts) =>
+ *       `${parts.section}${capitalize(resource)}V${parts.version}`
+ *   });
  * const adminV2 = versionedName({ section: 'Admin', version: 2 });
  * // Used for 'users', this produces 'AdminUsersV2'.
  * // versionedName({ version: '2' }) is rejected: version must be a number.
@@ -212,11 +216,12 @@ declare const defaultPartDefinitions: {
  * ```ts
  * const formattedName = defineLayoutName
  *   .defineParts({ version: 'number' })
- *   .namingFn(({ resource, capitalize }, parts) => {
- *     const version = typeof parts.version === 'number'
- *       ? parts.version.toFixed(0)
- *       : '';
- *     return `${capitalize(resource)}V${version}`;
+ *   .namingFn({
+ *     pattern: ({ resource, capitalize }, parts) => {
+ *       const version =
+ *         typeof parts.version === 'number' ? parts.version.toFixed(0) : '';
+ *       return `${capitalize(resource)}V${version}`;
+ *     }
  *   });
  * ```
  *
@@ -227,13 +232,14 @@ declare const defaultPartDefinitions: {
  * const externalName = defineLayoutName
  *   .defineParts({ version: 'number' })
  *   .namingFn({
- *     pattern: ({ resource }, parts) => `${resource}${parts.version}${parts.extra}`,
- *     strict: false,
+ *     pattern: ({ resource }, parts) =>
+ *       `${resource}${parts.version}${parts.extra}`,
+ *     strict: false
  *   });
  * const legacy = externalName({ version: 'legacy', extra: true });
  * ```
  */
-declare function defineLayoutName<const Pattern extends string, const Strict extends boolean = true>(definition: NamingDefinition<typeof defaultPartDefinitions, Pattern, Strict>): LayoutNameFactory<typeof defaultPartDefinitions, Pattern, Strict>;
+declare function defineLayoutName<const Pattern extends string, const Strict extends boolean = true>(definition: LayoutNameOptions<typeof defaultPartDefinitions, Pattern, Strict>): LayoutNameFactory<typeof defaultPartDefinitions, Pattern, Strict>;
 declare namespace defineLayoutName {
   var defineParts: {
     <const Keys extends readonly string[]>(...keys: Keys): DefinedLayoutNameParts<{ [Key in Keys[number]]: "string" }>;

package/dist/create-config/layout-name.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"layout-name.d.cts","names":[],"sources":["../../src/create-config/layout-name.ts"],"mappings":"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"}
+{"version":3,"file":"layout-name.d.cts","names":[],"sources":["../../src/create-config/layout-name.ts"],"mappings":";;;;;AAAiD;cASnC,qBAAA;AAAA,KACT,eAAA,+DAGD,KAAA;EAAA,UACQ,qBAAA,GAAwB,GAAA;AAAA;AAAA,KAE/B,kBAAA,GAAqB,IAAA,CACxB,iBAAA,CAAkB,eAAA;EAGlB,UAAA,qBACE,KAAA,EAAO,CAAA,KACJ,CAAA,SAAU,eAAA,eACX,eAAA,0BACA,UAAA,CAAW,CAAA;AAAA;AAAA,UAEA,iBAAA;EAIf,QAAA,EAAU,QAAA;EACV,MAAA,WAAiB,KAAA;EACjB,UAAA,SAAmB,UAAA;AAAA;AAAA,UAEJ,eAAA;EACf,MAAA;EACA,YAAA;EACA,MAAA;AAAA;;AAvBqC;AAAA;KA4B3B,kBAAA;;;;KAKA,yBAAA,GAA4B,QAAA,CACtC,MAAA,SAAe,kBAAA;;;;UAMA,iBAAA,qBACK,yBAAA;EA/BL;;;EAsCf,OAAA,EAAS,aAAA,CAAc,WAAA,EAAa,OAAA,EAAS,MAAA;EA9CrB;;;EAkDxB,MAAA,GAAS,MAAA;AAAA;;;;KAMN,oBAAA,qBAAyC,yBAAA,oBAE5B,WAAA,YACZ,MAAA;AAAA,KAED,SAAA,cAAuB,kBAAA,IAAsB,IAAI;;AArDpC;AAElB;KA0DY,oBAAA,qBACU,yBAAA,oBAEN,WAAA,IAAe,SAAA,CAAU,WAAA,CAAY,GAAA;AAAA,KAGhD,YAAA,qBAAiC,yBAAA,oBACtB,WAAA,YAAuB,eAAA,SAC3B,GAAA,IACR,SAAA,CAAU,WAAA,CAAY,GAAA;AAAA,KAGrB,QAAA,UAAkB,KAAA,8BAAmC,KAAK;AAAA,KAC1D,IAAA,0BAA8B,KAAA,IAAS,QAAA,CAAS,KAAA,CAAM,GAAA;AAAA,KACtD,yBAAA;EACH,QAAA,EAAU,QAAA;EACV,mBAAA,EAAqB,UAAA,CAAW,QAAA;AAAA;AAAA,KAE7B,iBAAA,mCAGD,yBAAA,CAA0B,QAAA,oBACd,KAAA,qBAA0B,GAAA,KAAQ,cAAA,CAC9C,IAAA,CAAK,KAAA,EAAO,GAAA,GACZ,yBAAA,CAA0B,QAAA;AAAA,KAGzB,gBAAA,mDACW,MAAA,YAAkB,OAAA,SAC5B,eAAA,CAAgB,GAAA,OACb,eAAA,CAAgB,GAAA,SAChB,eAAA,CAAgB,GAAA,eAClB,OAAA,CAAQ,MAAA,CAAO,GAAA,kBAChB,OAAA,YAAmB,eAAA,CAAgB,GAAA,oBAClC,OAAA,CAAQ,MAAA,CAAO,GAAA,YAAe,IAAA,IAC/B,OAAA,YAAmB,eAAA,CAAgB,GAAA,4BAClC,OAAA,CAAQ,MAAA,CAAO,GAAA,YAAe,IAAA,kBAE7B,MAAA;AAAA,KACH,cAAA,gEAIA,gBAAA,CAAiB,OAAA,EAAS,MAAA,qBAC3B,OAAA,yCACE,cAAA,CAAe,IAAA,EAAM,MAAA,KAAW,MAAA,GAAS,KAAA,SACtC,MAAA,GAAS,OAAA,KACd,gBAAA,CAAiB,OAAA,EAAS,MAAA,oEAI1B,cAAA,CAAe,IAAA,EAAM,MAAA,KAAW,MAAA,GAAS,KAAA;AAAA,KAEjC,kBAAA,gEAIR,cAAA,CAAe,OAAA,EAAS,iBAAA,CAAkB,QAAA,EAAU,KAAA;AAAA,cAC3C,iBAAA;AAAA,UAGI,kBAAA;EAAA,CAId,OAAA,EAAS,iBAAA;EAAA,UACA,iBAAA;IAAsB,OAAA,EAAS,OAAA;IAAS,KAAA,EAAO,KAAA;EAAA;AAAA;AAvG3D;;;AAAA,KA4GY,kBAAA,oGAIP,OAAA,EAAS,iBAAA,CAAkB,QAAA,EAAU,MAAA,MAAY,IAAA;AAAA,KAE1C,eAAA,mGAIR,IAAA,GAAO,kBAAA,CAAmB,QAAA,EAAU,MAAA,EAAQ,IAAA;AAAA,KACpC,kBAAA,qCACV,MAAA,2BAEK,UAAA,CAAW,QAAA,YACd,MAAA,SAAe,kBAAA,+BACf,kBAAA,CAAmB,OAAA,EAAS,QAAA,EAAU,KAAA,IACtC,MAAA,cAAmB,IAAA,4BACnB,OAAA,CAAQ,MAAA,YACR,MAAA,kBACA,MAAA,MACG,UAAA,CAAW,QAAA;AAAA,KACb,gBAAA,qBACiB,yBAAA,gBACN,oBAAA,CAAqB,WAAA,sBAEpB,oBAAA,CAAqB,WAAA,IAClC,KAAA,IAAS,GAAA,eAAkB,WAAA,IACxB,oBAAA,CAAqB,WAAA,IAAe,KAAA,EAAO,GAAA;AAAA,KAI7C,mBAAA,qBACiB,yBAAA,gBACN,oBAAA,CAAqB,WAAA,MAChC,OAAA,EAAS,kBAAA,KAAuB,gBAAA,CAAiB,WAAA,EAAa,KAAA;AAAA,KAE9D,aAAA,qBACiB,yBAAA,2BAGN,WAAA,GAAc,GAAA,eAAkB,KAAA,GAAQ,KAAA,CAAM,GAAA;AAAA,KAGzD,aAAA,qBACiB,yBAAA,4DAIpB,OAAA,EAAS,kBAAA,EACT,KAAA,GAAQ,MAAA,oBACJ,oBAAA,CAAqB,WAAA,IACrB,YAAA,CAAa,WAAA,MACd,OAAA;;;;UAKK,wBAAA,qBACY,yBAAA;EAxJX;;;;;;;;EAAA,qBAmKY,oBAAA,CAAqB,WAAA,QACxC,KAAA,GACI,gBAAA,CAAiB,WAAA,EAAa,KAAA,IAC9B,mBAAA,CAAoB,WAAA,EAAa,KAAA,IACpC,kBAAA,CAAmB,OAAA,EAAS,aAAA,CAAc,WAAA,EAAa,KAAA;AAAA;AAAA,UAGlD,0BAAA,qBACY,yBAAA;EAAA,CAGlB,KAAA,GACI,oBAAA,CAAqB,WAAA,MAEnB,OAAA,EAAS,kBAAA,KACN,oBAAA,CAAqB,WAAA,KAC7B,kBAAA;AAAA;;;;AA/KY;KAsLL,iBAAA,qBACU,yBAAA,4DAGjB,MAAA,oBACD,0BAAA,CAA2B,WAAA,IAC3B,wBAAA,CAAyB,WAAA,EAAa,OAAA;AAAA,UAEhC,sBAAA,qBACY,yBAAA;EAzLG;;;;EA+LvB,QAAA,oEAIE,UAAA,EAAY,iBAAA,CAAkB,WAAA,EAAa,OAAA,EAAS,MAAA,IACnD,iBAAA,CAAkB,WAAA,EAAa,OAAA,EAAS,MAAA;AAAA;AAAA,cAGvC,sBAAA;;;;;;AApMM;AAAA;;;;;;;;AAE0C;AAOtD;;;;;;;;;;;;;;;;;;AAGwD;AACtD;;;;;;;;;;;;;;;;;;;;;;AAK2B;AAAA;;;;;;;;AAGkC;AAAA;;;;;;;;;;;;;;;;AACD;AAAA;;;;;;;;;;;;;;;AAGpB;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQJ;iBAoZtB,gBAAA,oEAId,UAAA,EAAY,iBAAA,QACH,sBAAA,EACP,OAAA,EACA,MAAA,IAED,iBAAA,QAAyB,sBAAA,EAAwB,OAAA,EAAS,MAAA;AAAA,kBAT7C,gBAAA;EAAA;8CAiByC,IAAA,EAC9C,IAAA,GACR,sBAAA,WAAiC,IAAA;IAAA,2BAKW,yBAAA,EAAyB,WAAA,EACzD,WAAA,GACZ,sBAAA,CAAuB,WAAA;EAAA;AAAA"}

package/dist/create-config/layout-name.d.mts

@@ -80,7 +80,6 @@ type NamingPartsInput<Definitions extends LayoutNamePartDefinitions, Parts exten
 type NamingPartsCallback<Definitions extends LayoutNamePartDefinitions, Parts extends LayoutNamePartValues<Definitions>> = (context: PatternNameContext) => NamingPartsInput<Definitions, Parts>;
 type ResolvedParts<Definitions extends LayoutNamePartDefinitions, Parts> = { [Key in keyof Definitions]: Key extends keyof Parts ? Parts[Key] : '' };
 type NamingPattern<Definitions extends LayoutNamePartDefinitions, Pattern extends string, Strict extends boolean = true> = (context: PatternNameContext, parts: [Strict] extends [false] ? UncheckedNamingParts<Definitions> : PatternParts<Definitions>) => Pattern;
-type NamingDefinition<Definitions extends LayoutNamePartDefinitions, Pattern extends string, Strict extends boolean> = NamingPattern<Definitions, Pattern, Strict> | LayoutNameOptions<Definitions, Pattern, Strict>;
 /**
  * Supplies optional part values while preserving their literal types in names.
  */
@@ -108,7 +107,7 @@ interface DefinedLayoutNameParts<Definitions extends LayoutNamePartDefinitions>
    * Defines the naming pattern and optional strict-checking policy.
    * Strict defaults to true; false accepts unchecked part keys and values.
    */
-  namingFn<const Pattern extends string, const Strict extends boolean = true>(definition: NamingDefinition<Definitions, Pattern, Strict>): LayoutNameFactory<Definitions, Pattern, Strict>;
+  namingFn<const Pattern extends string, const Strict extends boolean = true>(definition: LayoutNameOptions<Definitions, Pattern, Strict>): LayoutNameFactory<Definitions, Pattern, Strict>;
 }
 declare const defaultPartDefinitions: {
   prefix: "string";
@@ -126,11 +125,11 @@ declare const defaultPartDefinitions: {
  *
  * Choose the form that matches the values your convention needs:
  *
- * - `defineLayoutName(pattern)` provides the string parts `prefix`,
+ * - `defineLayoutName({ pattern })` provides the string parts `prefix`,
  *   `beforeSuffix`, and `append` for common naming variations.
- * - `defineLayoutName.defineParts(...names).namingFn(pattern)` provides custom
+ * - `defineLayoutName.defineParts(...names).namingFn({ pattern })` provides custom
  *   string parts when domain-specific names make the pattern clearer.
- * - `defineLayoutName.defineParts(schema).namingFn(pattern)` declares each
+ * - `defineLayoutName.defineParts(schema).namingFn({ pattern })` declares each
  *   part as `'string'` or `'number'` when supplied values need different types.
  *
  * The pattern controls where parts appear; their names do not impose an order.
@@ -147,29 +146,32 @@ declare const defaultPartDefinitions: {
  * in namingFn to accept unchecked part keys and values in both TypeScript
  * and runtime calls. Unchecked conventions return string names.
  *
- * @param definition - A pattern callback, or an object containing the pattern
- * and optional strict-checking policy.
+ * @param definition - An object containing the naming pattern and optional
+ * strict-checking policy.
  * @returns A function accepting optional part values or a context callback.
  * Calling it with no arguments leaves every declared part empty.
  *
  * @example
  * Use the default string parts for a shared convention with occasional variants.
  * ```tsx
- * const layoutName = defineLayoutName(({ resource, capitalize }, parts) =>
- *   `${parts.prefix}${capitalize(resource)}${parts.beforeSuffix}Layout${parts.append}`,
- * );
+ * const layoutName = defineLayoutName({
+ *   pattern: ({ resource, capitalize }, parts) =>
+ *     `${parts.prefix}${capitalize(resource)}${parts.beforeSuffix}Layout${
+ *       parts.append
+ *     }`
+ * });
  * const factory = createDefinedResourceLayout({
  *   resources: ['users'],
- *   name: layoutName(),
+ *   name: layoutName()
  * });
  * const { createResourceLayout } = factory.defineResourceLayout({
- *   render: () => <div />,
+ *   render: () => <div />
  * });
  * const Users = createResourceLayout({ resource: 'users' });
  * // Users.displayName is typed as 'UsersLayout'.
  * const AdminUsers = createResourceLayout({
  *   resource: 'users',
- *   name: layoutName({ prefix: 'Admin', beforeSuffix: 'Detail' }),
+ *   name: layoutName({ prefix: 'Admin', beforeSuffix: 'Detail' })
  * });
  * // AdminUsers.displayName is typed as 'AdminUsersDetailLayout'.
  * ```
@@ -180,13 +182,14 @@ declare const defaultPartDefinitions: {
  * ```ts
  * const pageName = defineLayoutName
  *   .defineParts('section', 'variant')
- *   .namingFn(({ resource, capitalize }, parts) =>
- *     `${parts.section}${capitalize(resource)}${parts.variant}Page`,
- *   );
+ *   .namingFn({
+ *     pattern: ({ resource, capitalize }, parts) =>
+ *       `${parts.section}${capitalize(resource)}${parts.variant}Page`
+ *   });
  * const adminPage = pageName({ section: 'Admin', variant: 'Detail' });
  * // Used for 'users', this produces 'AdminUsersDetailPage'.
  * const resourcePage = pageName(({ resource }) => ({
- *   section: resource === 'users' ? 'Admin' : 'Public',
+ *   section: resource === 'users' ? 'Admin' : 'Public'
  * }));
  * // Used for 'users', this produces 'AdminUsersPage'.
  * // Other resources receive the 'Public' section instead.
@@ -198,9 +201,10 @@ declare const defaultPartDefinitions: {
  * ```ts
  * const versionedName = defineLayoutName
  *   .defineParts({ section: 'string', version: 'number' })
- *   .namingFn(({ resource, capitalize }, parts) =>
- *     `${parts.section}${capitalize(resource)}V${parts.version}`,
- *   );
+ *   .namingFn({
+ *     pattern: ({ resource, capitalize }, parts) =>
+ *       `${parts.section}${capitalize(resource)}V${parts.version}`
+ *   });
  * const adminV2 = versionedName({ section: 'Admin', version: 2 });
  * // Used for 'users', this produces 'AdminUsersV2'.
  * // versionedName({ version: '2' }) is rejected: version must be a number.
@@ -212,11 +216,12 @@ declare const defaultPartDefinitions: {
  * ```ts
  * const formattedName = defineLayoutName
  *   .defineParts({ version: 'number' })
- *   .namingFn(({ resource, capitalize }, parts) => {
- *     const version = typeof parts.version === 'number'
- *       ? parts.version.toFixed(0)
- *       : '';
- *     return `${capitalize(resource)}V${version}`;
+ *   .namingFn({
+ *     pattern: ({ resource, capitalize }, parts) => {
+ *       const version =
+ *         typeof parts.version === 'number' ? parts.version.toFixed(0) : '';
+ *       return `${capitalize(resource)}V${version}`;
+ *     }
  *   });
  * ```
  *
@@ -227,13 +232,14 @@ declare const defaultPartDefinitions: {
  * const externalName = defineLayoutName
  *   .defineParts({ version: 'number' })
  *   .namingFn({
- *     pattern: ({ resource }, parts) => `${resource}${parts.version}${parts.extra}`,
- *     strict: false,
+ *     pattern: ({ resource }, parts) =>
+ *       `${resource}${parts.version}${parts.extra}`,
+ *     strict: false
  *   });
  * const legacy = externalName({ version: 'legacy', extra: true });
  * ```
  */
-declare function defineLayoutName<const Pattern extends string, const Strict extends boolean = true>(definition: NamingDefinition<typeof defaultPartDefinitions, Pattern, Strict>): LayoutNameFactory<typeof defaultPartDefinitions, Pattern, Strict>;
+declare function defineLayoutName<const Pattern extends string, const Strict extends boolean = true>(definition: LayoutNameOptions<typeof defaultPartDefinitions, Pattern, Strict>): LayoutNameFactory<typeof defaultPartDefinitions, Pattern, Strict>;
 declare namespace defineLayoutName {
   var defineParts: {
     <const Keys extends readonly string[]>(...keys: Keys): DefinedLayoutNameParts<{ [Key in Keys[number]]: "string" }>;

package/dist/create-config/layout-name.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"layout-name.d.mts","names":[],"sources":["../../src/create-config/layout-name.ts"],"mappings":";;;;;AAAiD;cASnC,qBAAA;AAAA,KACT,eAAA,+DAGD,KAAA;EAAA,UACQ,qBAAA,GAAwB,GAAA;AAAA;AAAA,KAE/B,kBAAA,GAAqB,IAAA,CACxB,iBAAA,CAAkB,eAAA;EAGlB,UAAA,qBACE,KAAA,EAAO,CAAA,KACJ,CAAA,SAAU,eAAA,eACX,eAAA,0BACA,UAAA,CAAW,CAAA;AAAA;AAAA,UAEA,iBAAA;EAIf,QAAA,EAAU,QAAA;EACV,MAAA,WAAiB,KAAA;EACjB,UAAA,SAAmB,UAAA;AAAA;AAAA,UAEJ,eAAA;EACf,MAAA;EACA,YAAA;EACA,MAAA;AAAA;;AAvBqC;AAAA;KA4B3B,kBAAA;;;;KAKA,yBAAA,GAA4B,QAAA,CACtC,MAAA,SAAe,kBAAA;;;;UAMA,iBAAA,qBACK,yBAAA;EA/BL;;;EAsCf,OAAA,EAAS,aAAA,CAAc,WAAA,EAAa,OAAA,EAAS,MAAA;EA9CrB;;;EAkDxB,MAAA,GAAS,MAAA;AAAA;;;;KAMN,oBAAA,qBAAyC,yBAAA,oBAE5B,WAAA,YACZ,MAAA;AAAA,KAED,SAAA,cAAuB,kBAAA,IAAsB,IAAI;;AArDpC;AAElB;KA0DY,oBAAA,qBACU,yBAAA,oBAEN,WAAA,IAAe,SAAA,CAAU,WAAA,CAAY,GAAA;AAAA,KAGhD,YAAA,qBAAiC,yBAAA,oBACtB,WAAA,YAAuB,eAAA,SAC3B,GAAA,IACR,SAAA,CAAU,WAAA,CAAY,GAAA;AAAA,KAGrB,QAAA,UAAkB,KAAA,8BAAmC,KAAK;AAAA,KAC1D,IAAA,0BAA8B,KAAA,IAAS,QAAA,CAAS,KAAA,CAAM,GAAA;AAAA,KACtD,yBAAA;EACH,QAAA,EAAU,QAAA;EACV,mBAAA,EAAqB,UAAA,CAAW,QAAA;AAAA;AAAA,KAE7B,iBAAA,mCAGD,yBAAA,CAA0B,QAAA,oBACd,KAAA,qBAA0B,GAAA,KAAQ,cAAA,CAC9C,IAAA,CAAK,KAAA,EAAO,GAAA,GACZ,yBAAA,CAA0B,QAAA;AAAA,KAGzB,gBAAA,mDACW,MAAA,YAAkB,OAAA,SAC5B,eAAA,CAAgB,GAAA,OACb,eAAA,CAAgB,GAAA,SAChB,eAAA,CAAgB,GAAA,eAClB,OAAA,CAAQ,MAAA,CAAO,GAAA,kBAChB,OAAA,YAAmB,eAAA,CAAgB,GAAA,oBAClC,OAAA,CAAQ,MAAA,CAAO,GAAA,YAAe,IAAA,IAC/B,OAAA,YAAmB,eAAA,CAAgB,GAAA,4BAClC,OAAA,CAAQ,MAAA,CAAO,GAAA,YAAe,IAAA,kBAE7B,MAAA;AAAA,KACH,cAAA,gEAIA,gBAAA,CAAiB,OAAA,EAAS,MAAA,qBAC3B,OAAA,yCACE,cAAA,CAAe,IAAA,EAAM,MAAA,KAAW,MAAA,GAAS,KAAA,SACtC,MAAA,GAAS,OAAA,KACd,gBAAA,CAAiB,OAAA,EAAS,MAAA,oEAI1B,cAAA,CAAe,IAAA,EAAM,MAAA,KAAW,MAAA,GAAS,KAAA;AAAA,KAEjC,kBAAA,gEAIR,cAAA,CAAe,OAAA,EAAS,iBAAA,CAAkB,QAAA,EAAU,KAAA;AAAA,cAC3C,iBAAA;AAAA,UAGI,kBAAA;EAAA,CAId,OAAA,EAAS,iBAAA;EAAA,UACA,iBAAA;IAAsB,OAAA,EAAS,OAAA;IAAS,KAAA,EAAO,KAAA;EAAA;AAAA;AAvG3D;;;AAAA,KA4GY,kBAAA,oGAIP,OAAA,EAAS,iBAAA,CAAkB,QAAA,EAAU,MAAA,MAAY,IAAA;AAAA,KAE1C,eAAA,mGAIR,IAAA,GAAO,kBAAA,CAAmB,QAAA,EAAU,MAAA,EAAQ,IAAA;AAAA,KACpC,kBAAA,qCACV,MAAA,2BAEK,UAAA,CAAW,QAAA,YACd,MAAA,SAAe,kBAAA,+BACf,kBAAA,CAAmB,OAAA,EAAS,QAAA,EAAU,KAAA,IACtC,MAAA,cAAmB,IAAA,4BACnB,OAAA,CAAQ,MAAA,YACR,MAAA,kBACA,MAAA,MACG,UAAA,CAAW,QAAA;AAAA,KACb,gBAAA,qBACiB,yBAAA,gBACN,oBAAA,CAAqB,WAAA,sBAEpB,oBAAA,CAAqB,WAAA,IAClC,KAAA,IAAS,GAAA,eAAkB,WAAA,IACxB,oBAAA,CAAqB,WAAA,IAAe,KAAA,EAAO,GAAA;AAAA,KAI7C,mBAAA,qBACiB,yBAAA,gBACN,oBAAA,CAAqB,WAAA,MAChC,OAAA,EAAS,kBAAA,KAAuB,gBAAA,CAAiB,WAAA,EAAa,KAAA;AAAA,KAE9D,aAAA,qBACiB,yBAAA,2BAGN,WAAA,GAAc,GAAA,eAAkB,KAAA,GAAQ,KAAA,CAAM,GAAA;AAAA,KAGzD,aAAA,qBACiB,yBAAA,4DAIpB,OAAA,EAAS,kBAAA,EACT,KAAA,GAAQ,MAAA,oBACJ,oBAAA,CAAqB,WAAA,IACrB,YAAA,CAAa,WAAA,MACd,OAAA;AAAA,KAEA,gBAAA,qBACiB,yBAAA,oDAIlB,aAAA,CAAc,WAAA,EAAa,OAAA,EAAS,MAAA,IACpC,iBAAA,CAAkB,WAAA,EAAa,OAAA,EAAS,MAAA;;;;UAKlC,wBAAA,qBACY,yBAAA;EA5JX;;;;;;;;EAAA,qBAuKY,oBAAA,CAAqB,WAAA,QACxC,KAAA,GACI,gBAAA,CAAiB,WAAA,EAAa,KAAA,IAC9B,mBAAA,CAAoB,WAAA,EAAa,KAAA,IACpC,kBAAA,CAAmB,OAAA,EAAS,aAAA,CAAc,WAAA,EAAa,KAAA;AAAA;AAAA,UAGlD,0BAAA,qBACY,yBAAA;EAAA,CAGlB,KAAA,GACI,oBAAA,CAAqB,WAAA,MAEnB,OAAA,EAAS,kBAAA,KACN,oBAAA,CAAqB,WAAA,KAC7B,kBAAA;AAAA;;;AAvLY;AAChB;KA6LW,iBAAA,qBACU,yBAAA,4DAGjB,MAAA,oBACD,0BAAA,CAA2B,WAAA,IAC3B,wBAAA,CAAyB,WAAA,EAAa,OAAA;AAAA,UAEhC,sBAAA,qBACY,yBAAA;EAjMwB;;;;EAuM5C,QAAA,oEAIE,UAAA,EAAY,gBAAA,CAAiB,WAAA,EAAa,OAAA,EAAS,MAAA,IAClD,iBAAA,CAAkB,WAAA,EAAa,OAAA,EAAS,MAAA;AAAA;AAAA,cAGvC,sBAAA;;;;;AA5MM;AAAA;;;;;;;;AAE0C;AAOtD;;;;;;;;;;;;;;;;;;AAGwD;AACtD;;;;;;;;;;;;;;;;;;;;;;AAK2B;AAAA;;;;;;;;AAGkC;AAAA;;;;;;;;;;;;;;;;AACD;AAAA;;;;;;;;;;;;;;;AAGpB;AAAA;;;;;;;;;;;;;;;;;;;;;;;;AAzB9B,iBA+aI,gBAAA,oEAId,UAAA,EAAY,gBAAA,QACH,sBAAA,EACP,OAAA,EACA,MAAA,IAED,iBAAA,QAAyB,sBAAA,EAAwB,OAAA,EAAS,MAAA;AAAA,kBAT7C,gBAAA;EAAA;8CAiByC,IAAA,EAC9C,IAAA,GACR,sBAAA,WAAiC,IAAA;IAAA,2BAKW,yBAAA,EAAyB,WAAA,EACzD,WAAA,GACZ,sBAAA,CAAuB,WAAA;EAAA;AAAA"}
+{"version":3,"file":"layout-name.d.mts","names":[],"sources":["../../src/create-config/layout-name.ts"],"mappings":"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"}

package/dist/create-config/layout-name.mjs

@@ -1,6 +1,6 @@
+import { LayoutConfigurationError } from "../errors/layout-configuration-error.mjs";
 import { InvalidPartError } from "../errors/invalid-part.mjs";
 import { InvalidPartTypeError } from "../errors/invalid-part-type.mjs";
-import { LayoutConfigurationError } from "../errors/layout-configuration-error.mjs";
 
 //#region src/create-config/layout-name.ts
 const layoutNamePattern = Symbol("layoutNamePattern");
@@ -31,8 +31,9 @@ function validatePartValues(definitions, values) {
 	return Object.fromEntries(supplied);
 }
 function createNamingFactory(definitions, definition) {
-	const pattern = typeof definition === "function" ? definition : definition.pattern;
-	const strict = typeof definition === "function" || definition.strict !== false;
+	if (definition === null || typeof definition !== "object" || typeof definition.pattern !== "function") throw new LayoutConfigurationError("Naming configuration must be an object containing a pattern function.");
+	const { pattern } = definition;
+	const strict = definition.strict !== false;
 	const defaults = Object.fromEntries(Object.keys(definitions).map((key) => [key, ""]));
 	function name(parts) {
 		if (strict && typeof parts !== "function") validatePartValues(definitions, parts);
@@ -60,11 +61,11 @@ function createNamingFactory(definitions, definition) {
 *
 * Choose the form that matches the values your convention needs:
 *
-* - `defineLayoutName(pattern)` provides the string parts `prefix`,
+* - `defineLayoutName({ pattern })` provides the string parts `prefix`,
 *   `beforeSuffix`, and `append` for common naming variations.
-* - `defineLayoutName.defineParts(...names).namingFn(pattern)` provides custom
+* - `defineLayoutName.defineParts(...names).namingFn({ pattern })` provides custom
 *   string parts when domain-specific names make the pattern clearer.
-* - `defineLayoutName.defineParts(schema).namingFn(pattern)` declares each
+* - `defineLayoutName.defineParts(schema).namingFn({ pattern })` declares each
 *   part as `'string'` or `'number'` when supplied values need different types.
 *
 * The pattern controls where parts appear; their names do not impose an order.
@@ -81,29 +82,32 @@ function createNamingFactory(definitions, definition) {
 * in namingFn to accept unchecked part keys and values in both TypeScript
 * and runtime calls. Unchecked conventions return string names.
 *
-* @param definition - A pattern callback, or an object containing the pattern
-* and optional strict-checking policy.
+* @param definition - An object containing the naming pattern and optional
+* strict-checking policy.
 * @returns A function accepting optional part values or a context callback.
 * Calling it with no arguments leaves every declared part empty.
 *
 * @example
 * Use the default string parts for a shared convention with occasional variants.
 * ```tsx
-* const layoutName = defineLayoutName(({ resource, capitalize }, parts) =>
-*   `${parts.prefix}${capitalize(resource)}${parts.beforeSuffix}Layout${parts.append}`,
-* );
+* const layoutName = defineLayoutName({
+*   pattern: ({ resource, capitalize }, parts) =>
+*     `${parts.prefix}${capitalize(resource)}${parts.beforeSuffix}Layout${
+*       parts.append
+*     }`
+* });
 * const factory = createDefinedResourceLayout({
 *   resources: ['users'],
-*   name: layoutName(),
+*   name: layoutName()
 * });
 * const { createResourceLayout } = factory.defineResourceLayout({
-*   render: () => <div />,
+*   render: () => <div />
 * });
 * const Users = createResourceLayout({ resource: 'users' });
 * // Users.displayName is typed as 'UsersLayout'.
 * const AdminUsers = createResourceLayout({
 *   resource: 'users',
-*   name: layoutName({ prefix: 'Admin', beforeSuffix: 'Detail' }),
+*   name: layoutName({ prefix: 'Admin', beforeSuffix: 'Detail' })
 * });
 * // AdminUsers.displayName is typed as 'AdminUsersDetailLayout'.
 * ```
@@ -114,13 +118,14 @@ function createNamingFactory(definitions, definition) {
 * ```ts
 * const pageName = defineLayoutName
 *   .defineParts('section', 'variant')
-*   .namingFn(({ resource, capitalize }, parts) =>
-*     `${parts.section}${capitalize(resource)}${parts.variant}Page`,
-*   );
+*   .namingFn({
+*     pattern: ({ resource, capitalize }, parts) =>
+*       `${parts.section}${capitalize(resource)}${parts.variant}Page`
+*   });
 * const adminPage = pageName({ section: 'Admin', variant: 'Detail' });
 * // Used for 'users', this produces 'AdminUsersDetailPage'.
 * const resourcePage = pageName(({ resource }) => ({
-*   section: resource === 'users' ? 'Admin' : 'Public',
+*   section: resource === 'users' ? 'Admin' : 'Public'
 * }));
 * // Used for 'users', this produces 'AdminUsersPage'.
 * // Other resources receive the 'Public' section instead.
@@ -132,9 +137,10 @@ function createNamingFactory(definitions, definition) {
 * ```ts
 * const versionedName = defineLayoutName
 *   .defineParts({ section: 'string', version: 'number' })
-*   .namingFn(({ resource, capitalize }, parts) =>
-*     `${parts.section}${capitalize(resource)}V${parts.version}`,
-*   );
+*   .namingFn({
+*     pattern: ({ resource, capitalize }, parts) =>
+*       `${parts.section}${capitalize(resource)}V${parts.version}`
+*   });
 * const adminV2 = versionedName({ section: 'Admin', version: 2 });
 * // Used for 'users', this produces 'AdminUsersV2'.
 * // versionedName({ version: '2' }) is rejected: version must be a number.
@@ -146,11 +152,12 @@ function createNamingFactory(definitions, definition) {
 * ```ts
 * const formattedName = defineLayoutName
 *   .defineParts({ version: 'number' })
-*   .namingFn(({ resource, capitalize }, parts) => {
-*     const version = typeof parts.version === 'number'
-*       ? parts.version.toFixed(0)
-*       : '';
-*     return `${capitalize(resource)}V${version}`;
+*   .namingFn({
+*     pattern: ({ resource, capitalize }, parts) => {
+*       const version =
+*         typeof parts.version === 'number' ? parts.version.toFixed(0) : '';
+*       return `${capitalize(resource)}V${version}`;
+*     }
 *   });
 * ```
 *
@@ -161,8 +168,9 @@ function createNamingFactory(definitions, definition) {
 * const externalName = defineLayoutName
 *   .defineParts({ version: 'number' })
 *   .namingFn({
-*     pattern: ({ resource }, parts) => `${resource}${parts.version}${parts.extra}`,
-*     strict: false,
+*     pattern: ({ resource }, parts) =>
+*       `${resource}${parts.version}${parts.extra}`,
+*     strict: false
 *   });
 * const legacy = externalName({ version: 'legacy', extra: true });
 * ```

package/dist/create-config/layout-name.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"layout-name.mjs","names":[],"sources":["../../src/create-config/layout-name.ts"],"sourcesContent":["import { capitalize } from '../utils/capitalize';\nimport {\n  InvalidPartError,\n  InvalidPartTypeError,\n  LayoutConfigurationError\n} from '../errors';\n/**\n * Each slot has a distinct type identity, so ordinary text cannot become a slot.\n */\ndeclare const layoutNamePlaceholder: unique symbol;\ntype NamePlaceholder<\n  Key extends string,\n  Value extends string | number = string\n> = Value & {\n  readonly [layoutNamePlaceholder]: Key;\n};\ntype PatternNameContext = Omit<\n  LayoutNameContext<NamePlaceholder<'resource'>>,\n  'capitalize'\n> & {\n  capitalize: <T extends string>(\n    value: T\n  ) => T extends NamePlaceholder<'resource'>\n    ? NamePlaceholder<'capitalizedResource'>\n    : Capitalize<T>;\n};\nexport interface LayoutNameContext<\n  Resource extends string = string,\n  State extends string = string\n> {\n  resource: Resource;\n  states: readonly State[];\n  capitalize: typeof capitalize;\n}\nexport interface LayoutNameParts {\n  prefix?: string;\n  beforeSuffix?: string;\n  append?: string;\n}\n/**\n * Value kinds accepted by a declared naming part.\n */\nexport type LayoutNamePartType = 'string' | 'number';\n\n/**\n * Declares each naming part and the value kind accepted at call sites.\n */\nexport type LayoutNamePartDefinitions = Readonly<\n  Record<string, LayoutNamePartType>\n>;\n\n/**\n * Defines the naming pattern and strict-checking policy. Strict defaults to true.\n */\nexport interface LayoutNameOptions<\n  Definitions extends LayoutNamePartDefinitions,\n  Pattern extends string,\n  Strict extends boolean = true\n> {\n  /**\n   * Combines the naming context and part placeholders into a name.\n   */\n  pattern: NamingPattern<Definitions, Pattern, Strict>;\n  /**\n   * Set to false to skip part type checking and runtime validation.\n   */\n  strict?: Strict;\n}\n\n/**\n * Part values are intentionally unchecked when strict is false.\n */\ntype UncheckedNamingParts<Definitions extends LayoutNamePartDefinitions> =\n  {\n    [Key in keyof Definitions]?: any;\n  } & Record<string, any>;\n\ntype PartValue<Type extends LayoutNamePartType> = Type extends 'number'\n  ? number\n  : string;\n\n/**\n * Optional values for declared naming parts. Omitted slots render as empty text.\n */\nexport type LayoutNamePartValues<\n  Definitions extends LayoutNamePartDefinitions\n> = {\n  [Key in keyof Definitions]?: PartValue<Definitions[Key]>;\n};\n\ntype PatternParts<Definitions extends LayoutNamePartDefinitions> = {\n  [Key in keyof Definitions & string]: NamePlaceholder<\n    `part:${Key}`,\n    PartValue<Definitions[Key]> | ''\n  >;\n};\ntype PartText<Value> = Value extends string | number ? `${Value}` : '';\ntype Part<Parts, Key extends keyof Parts> = PartText<Parts[Key]>;\ntype ResourcePlaceholderValues<Resource extends string> = {\n  resource: Resource;\n  capitalizedResource: Capitalize<Resource>;\n};\ntype PlaceholderValues<\n  Resource extends string,\n  Parts\n> = ResourcePlaceholderValues<Resource> & {\n  [Key in keyof Parts & string as `part:${Key}`]: ResolvePattern<\n    Part<Parts, Key>,\n    ResourcePlaceholderValues<Resource>\n  >;\n};\ntype MatchPlaceholder<Pattern extends string, Values> = {\n  [Key in keyof Values & string]: Pattern extends\n    | NamePlaceholder<Key>\n    | `${NamePlaceholder<Key>}`\n    | `${NamePlaceholder<Key, number>}`\n    ? [Extract<Values[Key], string>, '']\n    : Pattern extends `${NamePlaceholder<Key>}${infer Rest}`\n    ? [Extract<Values[Key], string>, Rest]\n    : Pattern extends `${NamePlaceholder<Key, number>}${infer Rest}`\n    ? [Extract<Values[Key], string>, Rest]\n    : never;\n}[keyof Values & string];\ntype ResolvePattern<\n  Pattern extends string,\n  Values,\n  Result extends string = ''\n> = [MatchPlaceholder<Pattern, Values>] extends [never]\n  ? Pattern extends `${infer First}${infer Rest}`\n    ? ResolvePattern<Rest, Values, `${Result}${First}`>\n    : `${Result}${Pattern}`\n  : MatchPlaceholder<Pattern, Values> extends [\n      infer Value extends string,\n      infer Rest extends string\n    ]\n  ? ResolvePattern<Rest, Values, `${Result}${Value}`>\n  : never;\nexport type ResolveNamePattern<\n  Pattern extends string,\n  Resource extends string,\n  Parts = {}\n> = ResolvePattern<Pattern, PlaceholderValues<Resource, Parts>>;\nexport const layoutNamePattern: unique symbol = Symbol(\n  'layoutNamePattern'\n);\nexport interface LayoutNameResolver<\n  Pattern extends string = string,\n  Parts = {}\n> {\n  (context: LayoutNameContext): string;\n  readonly [layoutNamePattern]: { pattern: Pattern; parts: Parts };\n}\n/**\n * Computes a layout name from its resource and available render states.\n */\nexport type LayoutNameCallback<\n  Resource extends string = string,\n  States extends string = string,\n  Name extends string = string\n> = (context: LayoutNameContext<Resource, States>) => Name;\n\nexport type LayoutNameInput<\n  Resource extends string = string,\n  States extends string = string,\n  Name extends string = string\n> = Name | LayoutNameCallback<Resource, States, Name>;\nexport type ResolvedLayoutName<Naming, Resource extends string> = [\n  Naming\n] extends [undefined]\n  ? `${Capitalize<Resource>}Layout`\n  : Naming extends LayoutNameResolver<infer Pattern, infer Parts>\n  ? ResolveNamePattern<Pattern, Resource, Parts>\n  : Naming extends (...args: any[]) => infer Result\n  ? Extract<Result, string>\n  : Naming extends string\n  ? Naming\n  : `${Capitalize<Resource>}Layout`;\ntype NamingPartsInput<\n  Definitions extends LayoutNamePartDefinitions,\n  Parts extends LayoutNamePartValues<Definitions>\n> = {\n  [Key in keyof (LayoutNamePartValues<Definitions> &\n    Parts)]: Key extends keyof Definitions\n    ? (LayoutNamePartValues<Definitions> & Parts)[Key]\n    : never;\n};\n\ntype NamingPartsCallback<\n  Definitions extends LayoutNamePartDefinitions,\n  Parts extends LayoutNamePartValues<Definitions>\n> = (context: PatternNameContext) => NamingPartsInput<Definitions, Parts>;\n\ntype ResolvedParts<\n  Definitions extends LayoutNamePartDefinitions,\n  Parts\n> = {\n  [Key in keyof Definitions]: Key extends keyof Parts ? Parts[Key] : '';\n};\n\ntype NamingPattern<\n  Definitions extends LayoutNamePartDefinitions,\n  Pattern extends string,\n  Strict extends boolean = true\n> = (\n  context: PatternNameContext,\n  parts: [Strict] extends [false]\n    ? UncheckedNamingParts<Definitions>\n    : PatternParts<Definitions>\n) => Pattern;\n\ntype NamingDefinition<\n  Definitions extends LayoutNamePartDefinitions,\n  Pattern extends string,\n  Strict extends boolean\n> =\n  | NamingPattern<Definitions, Pattern, Strict>\n  | LayoutNameOptions<Definitions, Pattern, Strict>;\n\n/**\n * Supplies optional part values while preserving their literal types in names.\n */\ninterface CheckedLayoutNameFactory<\n  Definitions extends LayoutNamePartDefinitions,\n  Pattern extends string\n> {\n  /**\n   * Supplies values for declared parts without coercing their types.\n   * Fixed values are checked immediately; callback results are checked when\n   * the layout name is resolved for a resource.\n   *\n   * @throws {InvalidPartError} A supplied part has not been declared.\n   * @throws {InvalidPartTypeError} A supplied value has the wrong kind.\n   */\n  <const Parts extends LayoutNamePartValues<Definitions> = {}>(\n    parts?:\n      | NamingPartsInput<Definitions, Parts>\n      | NamingPartsCallback<Definitions, Parts>\n  ): LayoutNameResolver<Pattern, ResolvedParts<Definitions, Parts>>;\n}\n\ninterface UncheckedLayoutNameFactory<\n  Definitions extends LayoutNamePartDefinitions\n> {\n  (\n    parts?:\n      | UncheckedNamingParts<Definitions>\n      | ((\n          context: PatternNameContext\n        ) => UncheckedNamingParts<Definitions>)\n  ): LayoutNameResolver<string>;\n}\n\n/**\n * Supplies optional naming parts. Strict conventions preserve literal names;\n * unchecked conventions accept arbitrary keys and values and return string names.\n */\nexport type LayoutNameFactory<\n  Definitions extends LayoutNamePartDefinitions,\n  Pattern extends string,\n  Strict extends boolean = true\n> = [Strict] extends [false]\n  ? UncheckedLayoutNameFactory<Definitions>\n  : CheckedLayoutNameFactory<Definitions, Pattern>;\n\ninterface DefinedLayoutNameParts<\n  Definitions extends LayoutNamePartDefinitions\n> {\n  /**\n   * Defines the naming pattern and optional strict-checking policy.\n   * Strict defaults to true; false accepts unchecked part keys and values.\n   */\n  namingFn<\n    const Pattern extends string,\n    const Strict extends boolean = true\n  >(\n    definition: NamingDefinition<Definitions, Pattern, Strict>\n  ): LayoutNameFactory<Definitions, Pattern, Strict>;\n}\n\nconst defaultPartDefinitions = {\n  prefix: 'string',\n  beforeSuffix: 'string',\n  append: 'string'\n} satisfies { [Key in keyof LayoutNameParts]-?: 'string' };\n\nfunction validatePartValues(\n  definitions: LayoutNamePartDefinitions,\n  values: unknown\n): Record<string, string | number> {\n  if (values === undefined) return {};\n  if (\n    values === null ||\n    typeof values !== 'object' ||\n    Array.isArray(values)\n  ) {\n    throw new LayoutConfigurationError(\n      'Naming part values must be an object.'\n    );\n  }\n\n  const supplied: Array<[string, string | number]> = [];\n  for (const part of Reflect.ownKeys(values)) {\n    if (typeof part !== 'string' || !Object.hasOwn(definitions, part)) {\n      throw new InvalidPartError({\n        part: String(part),\n        validParts: Object.keys(definitions)\n      });\n    }\n    const value: unknown = Reflect.get(values, part);\n    if (value === undefined) continue;\n\n    const expectedType = definitions[part];\n    if (\n      (expectedType === 'string' && typeof value === 'string') ||\n      (expectedType === 'number' && typeof value === 'number')\n    ) {\n      supplied.push([part, value]);\n    } else {\n      throw new InvalidPartTypeError({\n        part,\n        expectedType,\n        receivedType:\n          value === null\n            ? 'null'\n            : Array.isArray(value)\n            ? 'array'\n            : typeof value\n      });\n    }\n  }\n  return Object.fromEntries(supplied);\n}\n\nfunction createNamingFactory<\n  Definitions extends LayoutNamePartDefinitions,\n  const Pattern extends string,\n  Strict extends boolean = true\n>(\n  definitions: Definitions,\n  definition: NamingDefinition<Definitions, Pattern, Strict>\n): LayoutNameFactory<Definitions, Pattern, Strict> {\n  const pattern =\n    typeof definition === 'function' ? definition : definition.pattern;\n  const strict =\n    typeof definition === 'function' || definition.strict !== false;\n  const defaults = Object.fromEntries(\n    Object.keys(definitions).map((key) => [key, ''])\n  );\n  function name<\n    const Parts extends LayoutNamePartValues<Definitions> = {}\n  >(\n    parts?:\n      | NamingPartsInput<Definitions, Parts>\n      | NamingPartsCallback<Definitions, Parts>\n  ): LayoutNameResolver<Pattern, ResolvedParts<Definitions, Parts>> {\n    if (strict && typeof parts !== 'function')\n      validatePartValues(definitions, parts);\n    const resolver = ((context: LayoutNameContext) => {\n      const values =\n        typeof parts === 'function'\n          ? parts(context as unknown as PatternNameContext)\n          : parts;\n      const supplied = strict\n        ? validatePartValues(definitions, values)\n        : Object.fromEntries(\n            Object.entries(values ?? {}).filter(\n              ([, value]) => value !== undefined\n            )\n          );\n      return pattern(\n        context as unknown as PatternNameContext,\n        {\n          ...defaults,\n          ...supplied\n        } as [Strict] extends [false]\n          ? UncheckedNamingParts<Definitions>\n          : PatternParts<Definitions>\n      );\n    }) as unknown as LayoutNameResolver<\n      Pattern,\n      ResolvedParts<Definitions, Parts>\n    >;\n    Object.defineProperty(resolver, layoutNamePattern, { value: {} });\n    return resolver;\n  }\n  return name as LayoutNameFactory<Definitions, Pattern, Strict>;\n}\n\n/**\n * Defines a reusable layout naming convention that preserves resource-specific\n * literal names in TypeScript. Define the pattern once, then supply optional\n * part values wherever the convention is used.\n *\n * Omit `name` entirely when the generated name, such as `UsersLayout`, is enough.\n * Use this helper when several layouts share a naming rule or need variations\n * while retaining exact component `displayName` types.\n *\n * Choose the form that matches the values your convention needs:\n *\n * - `defineLayoutName(pattern)` provides the string parts `prefix`,\n *   `beforeSuffix`, and `append` for common naming variations.\n * - `defineLayoutName.defineParts(...names).namingFn(pattern)` provides custom\n *   string parts when domain-specific names make the pattern clearer.\n * - `defineLayoutName.defineParts(schema).namingFn(pattern)` declares each\n *   part as `'string'` or `'number'` when supplied values need different types.\n *\n * The pattern controls where parts appear; their names do not impose an order.\n * Part values are optional and omitted values render as empty text. Supply an\n * object for fixed values, or a callback when values depend on the resource.\n * Numeric placeholders can also be empty text inside the pattern. Narrow them\n * with `typeof value === 'number'` before using number-only methods.\n * Supplied keys and value kinds are also validated at runtime. Unknown parts\n * throw InvalidPartError; incorrect value kinds throw InvalidPartTypeError.\n * Each returned naming resolver can be passed to a factory, definition, or\n * component creation call through its `name` option.\n *\n * Strict checking defaults to true. Use `{ pattern, strict: false }` here or\n * in namingFn to accept unchecked part keys and values in both TypeScript\n * and runtime calls. Unchecked conventions return string names.\n *\n * @param definition - A pattern callback, or an object containing the pattern\n * and optional strict-checking policy.\n * @returns A function accepting optional part values or a context callback.\n * Calling it with no arguments leaves every declared part empty.\n *\n * @example\n * Use the default string parts for a shared convention with occasional variants.\n * ```tsx\n * const layoutName = defineLayoutName(({ resource, capitalize }, parts) =>\n *   `${parts.prefix}${capitalize(resource)}${parts.beforeSuffix}Layout${parts.append}`,\n * );\n * const factory = createDefinedResourceLayout({\n *   resources: ['users'],\n *   name: layoutName(),\n * });\n * const { createResourceLayout } = factory.defineResourceLayout({\n *   render: () => <div />,\n * });\n * const Users = createResourceLayout({ resource: 'users' });\n * // Users.displayName is typed as 'UsersLayout'.\n * const AdminUsers = createResourceLayout({\n *   resource: 'users',\n *   name: layoutName({ prefix: 'Admin', beforeSuffix: 'Detail' }),\n * });\n * // AdminUsers.displayName is typed as 'AdminUsersDetailLayout'.\n * ```\n *\n * @example\n * Declare custom string parts when their names describe your application's\n * conventions more clearly than prefix, beforeSuffix, and append.\n * ```ts\n * const pageName = defineLayoutName\n *   .defineParts('section', 'variant')\n *   .namingFn(({ resource, capitalize }, parts) =>\n *     `${parts.section}${capitalize(resource)}${parts.variant}Page`,\n *   );\n * const adminPage = pageName({ section: 'Admin', variant: 'Detail' });\n * // Used for 'users', this produces 'AdminUsersDetailPage'.\n * const resourcePage = pageName(({ resource }) => ({\n *   section: resource === 'users' ? 'Admin' : 'Public',\n * }));\n * // Used for 'users', this produces 'AdminUsersPage'.\n * // Other resources receive the 'Public' section instead.\n * ```\n *\n * @example\n * Use a schema when a part should accept a number instead of a string.\n * Supplied keys are suggested by the editor and checked against the schema.\n * ```ts\n * const versionedName = defineLayoutName\n *   .defineParts({ section: 'string', version: 'number' })\n *   .namingFn(({ resource, capitalize }, parts) =>\n *     `${parts.section}${capitalize(resource)}V${parts.version}`,\n *   );\n * const adminV2 = versionedName({ section: 'Admin', version: 2 });\n * // Used for 'users', this produces 'AdminUsersV2'.\n * // versionedName({ version: '2' }) is rejected: version must be a number.\n * ```\n *\n * @example\n * Guard optional numeric values before formatting them with number methods.\n * Plain interpolation, as above, already handles empty values.\n * ```ts\n * const formattedName = defineLayoutName\n *   .defineParts({ version: 'number' })\n *   .namingFn(({ resource, capitalize }, parts) => {\n *     const version = typeof parts.version === 'number'\n *       ? parts.version.toFixed(0)\n *       : '';\n *     return `${capitalize(resource)}V${version}`;\n *   });\n * ```\n *\n * @example\n * Opt out of part checking when a convention intentionally accepts external\n * keys and mixed value types. The resulting displayName is typed as string.\n * ```ts\n * const externalName = defineLayoutName\n *   .defineParts({ version: 'number' })\n *   .namingFn({\n *     pattern: ({ resource }, parts) => `${resource}${parts.version}${parts.extra}`,\n *     strict: false,\n *   });\n * const legacy = externalName({ version: 'legacy', extra: true });\n * ```\n */\nexport function defineLayoutName<\n  const Pattern extends string,\n  const Strict extends boolean = true\n>(\n  definition: NamingDefinition<\n    typeof defaultPartDefinitions,\n    Pattern,\n    Strict\n  >\n): LayoutNameFactory<typeof defaultPartDefinitions, Pattern, Strict> {\n  return createNamingFactory(defaultPartDefinitions, definition);\n}\n\n/**\n * Declares string placeholders from their names.\n * Call namingFn on the result to define how those slots form a layout name.\n */\nfunction defineParts<const Keys extends readonly string[]>(\n  ...keys: Keys\n): DefinedLayoutNameParts<{ [Key in Keys[number]]: 'string' }>;\n/**\n * Declares placeholders with string or number values from a part schema.\n * Call namingFn on the result to define how those slots form a layout name.\n */\nfunction defineParts<const Definitions extends LayoutNamePartDefinitions>(\n  definitions: Definitions\n): DefinedLayoutNameParts<Definitions>;\nfunction defineParts(\n  ...input: string[] | [LayoutNamePartDefinitions]\n): DefinedLayoutNameParts<LayoutNamePartDefinitions> {\n  const definitions =\n    typeof input[0] === 'object'\n      ? input[0]\n      : Object.fromEntries(input.map((key) => [key, 'string']));\n  return {\n    namingFn(definition) {\n      return createNamingFactory(definitions, definition);\n    }\n  };\n}\n\ndefineLayoutName.defineParts = defineParts;\n"],"mappings":";;;;;AA8IA,MAAa,oBAAmC,OAC9C,mBACF;AAuIA,MAAM,yBAAyB;CAC7B,QAAQ;CACR,cAAc;CACd,QAAQ;AACV;AAEA,SAAS,mBACP,aACA,QACiC;CACjC,IAAI,WAAW,QAAW,OAAO,CAAC;CAClC,IACE,WAAW,QACX,OAAO,WAAW,YAClB,MAAM,QAAQ,MAAM,GAEpB,MAAM,IAAI,yBACR,uCACF;CAGF,MAAM,WAA6C,CAAC;CACpD,KAAK,MAAM,QAAQ,QAAQ,QAAQ,MAAM,GAAG;EAC1C,IAAI,OAAO,SAAS,YAAY,CAAC,OAAO,OAAO,aAAa,IAAI,GAC9D,MAAM,IAAI,iBAAiB;GACzB,MAAM,OAAO,IAAI;GACjB,YAAY,OAAO,KAAK,WAAW;EACrC,CAAC;EAEH,MAAM,QAAiB,QAAQ,IAAI,QAAQ,IAAI;EAC/C,IAAI,UAAU,QAAW;EAEzB,MAAM,eAAe,YAAY;EACjC,IACG,iBAAiB,YAAY,OAAO,UAAU,YAC9C,iBAAiB,YAAY,OAAO,UAAU,UAE/C,SAAS,KAAK,CAAC,MAAM,KAAK,CAAC;OAE3B,MAAM,IAAI,qBAAqB;GAC7B;GACA;GACA,cACE,UAAU,OACN,SACA,MAAM,QAAQ,KAAK,IACnB,UACA,OAAO;EACf,CAAC;CAEL;CACA,OAAO,OAAO,YAAY,QAAQ;AACpC;AAEA,SAAS,oBAKP,aACA,YACiD;CACjD,MAAM,UACJ,OAAO,eAAe,aAAa,aAAa,WAAW;CAC7D,MAAM,SACJ,OAAO,eAAe,cAAc,WAAW,WAAW;CAC5D,MAAM,WAAW,OAAO,YACtB,OAAO,KAAK,WAAW,EAAE,KAAK,QAAQ,CAAC,KAAK,EAAE,CAAC,CACjD;CACA,SAAS,KAGP,OAGgE;EAChE,IAAI,UAAU,OAAO,UAAU,YAC7B,mBAAmB,aAAa,KAAK;EACvC,MAAM,aAAa,YAA+B;GAChD,MAAM,SACJ,OAAO,UAAU,aACb,MAAM,OAAwC,IAC9C;GACN,MAAM,WAAW,SACb,mBAAmB,aAAa,MAAM,IACtC,OAAO,YACL,OAAO,QAAQ,UAAU,CAAC,CAAC,EAAE,QAC1B,GAAG,WAAW,UAAU,MAC3B,CACF;GACJ,OAAO,QACL,SACA;IACE,GAAG;IACH,GAAG;GACL,CAGF;EACF;EAIA,OAAO,eAAe,UAAU,mBAAmB,EAAE,OAAO,CAAC,EAAE,CAAC;EAChE,OAAO;CACT;CACA,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwHA,SAAgB,iBAId,YAKmE;CACnE,OAAO,oBAAoB,wBAAwB,UAAU;AAC/D;AAgBA,SAAS,YACP,GAAG,OACgD;CACnD,MAAM,cACJ,OAAO,MAAM,OAAO,WAChB,MAAM,KACN,OAAO,YAAY,MAAM,KAAK,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC;CAC5D,OAAO,EACL,SAAS,YAAY;EACnB,OAAO,oBAAoB,aAAa,UAAU;CACpD,EACF;AACF;AAEA,iBAAiB,cAAc"}
+{"version":3,"file":"layout-name.mjs","names":[],"sources":["../../src/create-config/layout-name.ts"],"sourcesContent":["import { capitalize } from '../utils/capitalize';\nimport {\n  InvalidPartError,\n  InvalidPartTypeError,\n  LayoutConfigurationError\n} from '../errors';\n/**\n * Each slot has a distinct type identity, so ordinary text cannot become a slot.\n */\ndeclare const layoutNamePlaceholder: unique symbol;\ntype NamePlaceholder<\n  Key extends string,\n  Value extends string | number = string\n> = Value & {\n  readonly [layoutNamePlaceholder]: Key;\n};\ntype PatternNameContext = Omit<\n  LayoutNameContext<NamePlaceholder<'resource'>>,\n  'capitalize'\n> & {\n  capitalize: <T extends string>(\n    value: T\n  ) => T extends NamePlaceholder<'resource'>\n    ? NamePlaceholder<'capitalizedResource'>\n    : Capitalize<T>;\n};\nexport interface LayoutNameContext<\n  Resource extends string = string,\n  State extends string = string\n> {\n  resource: Resource;\n  states: readonly State[];\n  capitalize: typeof capitalize;\n}\nexport interface LayoutNameParts {\n  prefix?: string;\n  beforeSuffix?: string;\n  append?: string;\n}\n/**\n * Value kinds accepted by a declared naming part.\n */\nexport type LayoutNamePartType = 'string' | 'number';\n\n/**\n * Declares each naming part and the value kind accepted at call sites.\n */\nexport type LayoutNamePartDefinitions = Readonly<\n  Record<string, LayoutNamePartType>\n>;\n\n/**\n * Defines the naming pattern and strict-checking policy. Strict defaults to true.\n */\nexport interface LayoutNameOptions<\n  Definitions extends LayoutNamePartDefinitions,\n  Pattern extends string,\n  Strict extends boolean = true\n> {\n  /**\n   * Combines the naming context and part placeholders into a name.\n   */\n  pattern: NamingPattern<Definitions, Pattern, Strict>;\n  /**\n   * Set to false to skip part type checking and runtime validation.\n   */\n  strict?: Strict;\n}\n\n/**\n * Part values are intentionally unchecked when strict is false.\n */\ntype UncheckedNamingParts<Definitions extends LayoutNamePartDefinitions> =\n  {\n    [Key in keyof Definitions]?: any;\n  } & Record<string, any>;\n\ntype PartValue<Type extends LayoutNamePartType> = Type extends 'number'\n  ? number\n  : string;\n\n/**\n * Optional values for declared naming parts. Omitted slots render as empty text.\n */\nexport type LayoutNamePartValues<\n  Definitions extends LayoutNamePartDefinitions\n> = {\n  [Key in keyof Definitions]?: PartValue<Definitions[Key]>;\n};\n\ntype PatternParts<Definitions extends LayoutNamePartDefinitions> = {\n  [Key in keyof Definitions & string]: NamePlaceholder<\n    `part:${Key}`,\n    PartValue<Definitions[Key]> | ''\n  >;\n};\ntype PartText<Value> = Value extends string | number ? `${Value}` : '';\ntype Part<Parts, Key extends keyof Parts> = PartText<Parts[Key]>;\ntype ResourcePlaceholderValues<Resource extends string> = {\n  resource: Resource;\n  capitalizedResource: Capitalize<Resource>;\n};\ntype PlaceholderValues<\n  Resource extends string,\n  Parts\n> = ResourcePlaceholderValues<Resource> & {\n  [Key in keyof Parts & string as `part:${Key}`]: ResolvePattern<\n    Part<Parts, Key>,\n    ResourcePlaceholderValues<Resource>\n  >;\n};\ntype MatchPlaceholder<Pattern extends string, Values> = {\n  [Key in keyof Values & string]: Pattern extends\n    | NamePlaceholder<Key>\n    | `${NamePlaceholder<Key>}`\n    | `${NamePlaceholder<Key, number>}`\n    ? [Extract<Values[Key], string>, '']\n    : Pattern extends `${NamePlaceholder<Key>}${infer Rest}`\n    ? [Extract<Values[Key], string>, Rest]\n    : Pattern extends `${NamePlaceholder<Key, number>}${infer Rest}`\n    ? [Extract<Values[Key], string>, Rest]\n    : never;\n}[keyof Values & string];\ntype ResolvePattern<\n  Pattern extends string,\n  Values,\n  Result extends string = ''\n> = [MatchPlaceholder<Pattern, Values>] extends [never]\n  ? Pattern extends `${infer First}${infer Rest}`\n    ? ResolvePattern<Rest, Values, `${Result}${First}`>\n    : `${Result}${Pattern}`\n  : MatchPlaceholder<Pattern, Values> extends [\n      infer Value extends string,\n      infer Rest extends string\n    ]\n  ? ResolvePattern<Rest, Values, `${Result}${Value}`>\n  : never;\nexport type ResolveNamePattern<\n  Pattern extends string,\n  Resource extends string,\n  Parts = {}\n> = ResolvePattern<Pattern, PlaceholderValues<Resource, Parts>>;\nexport const layoutNamePattern: unique symbol = Symbol(\n  'layoutNamePattern'\n);\nexport interface LayoutNameResolver<\n  Pattern extends string = string,\n  Parts = {}\n> {\n  (context: LayoutNameContext): string;\n  readonly [layoutNamePattern]: { pattern: Pattern; parts: Parts };\n}\n/**\n * Computes a layout name from its resource and available render states.\n */\nexport type LayoutNameCallback<\n  Resource extends string = string,\n  States extends string = string,\n  Name extends string = string\n> = (context: LayoutNameContext<Resource, States>) => Name;\n\nexport type LayoutNameInput<\n  Resource extends string = string,\n  States extends string = string,\n  Name extends string = string\n> = Name | LayoutNameCallback<Resource, States, Name>;\nexport type ResolvedLayoutName<Naming, Resource extends string> = [\n  Naming\n] extends [undefined]\n  ? `${Capitalize<Resource>}Layout`\n  : Naming extends LayoutNameResolver<infer Pattern, infer Parts>\n  ? ResolveNamePattern<Pattern, Resource, Parts>\n  : Naming extends (...args: any[]) => infer Result\n  ? Extract<Result, string>\n  : Naming extends string\n  ? Naming\n  : `${Capitalize<Resource>}Layout`;\ntype NamingPartsInput<\n  Definitions extends LayoutNamePartDefinitions,\n  Parts extends LayoutNamePartValues<Definitions>\n> = {\n  [Key in keyof (LayoutNamePartValues<Definitions> &\n    Parts)]: Key extends keyof Definitions\n    ? (LayoutNamePartValues<Definitions> & Parts)[Key]\n    : never;\n};\n\ntype NamingPartsCallback<\n  Definitions extends LayoutNamePartDefinitions,\n  Parts extends LayoutNamePartValues<Definitions>\n> = (context: PatternNameContext) => NamingPartsInput<Definitions, Parts>;\n\ntype ResolvedParts<\n  Definitions extends LayoutNamePartDefinitions,\n  Parts\n> = {\n  [Key in keyof Definitions]: Key extends keyof Parts ? Parts[Key] : '';\n};\n\ntype NamingPattern<\n  Definitions extends LayoutNamePartDefinitions,\n  Pattern extends string,\n  Strict extends boolean = true\n> = (\n  context: PatternNameContext,\n  parts: [Strict] extends [false]\n    ? UncheckedNamingParts<Definitions>\n    : PatternParts<Definitions>\n) => Pattern;\n\n/**\n * Supplies optional part values while preserving their literal types in names.\n */\ninterface CheckedLayoutNameFactory<\n  Definitions extends LayoutNamePartDefinitions,\n  Pattern extends string\n> {\n  /**\n   * Supplies values for declared parts without coercing their types.\n   * Fixed values are checked immediately; callback results are checked when\n   * the layout name is resolved for a resource.\n   *\n   * @throws {InvalidPartError} A supplied part has not been declared.\n   * @throws {InvalidPartTypeError} A supplied value has the wrong kind.\n   */\n  <const Parts extends LayoutNamePartValues<Definitions> = {}>(\n    parts?:\n      | NamingPartsInput<Definitions, Parts>\n      | NamingPartsCallback<Definitions, Parts>\n  ): LayoutNameResolver<Pattern, ResolvedParts<Definitions, Parts>>;\n}\n\ninterface UncheckedLayoutNameFactory<\n  Definitions extends LayoutNamePartDefinitions\n> {\n  (\n    parts?:\n      | UncheckedNamingParts<Definitions>\n      | ((\n          context: PatternNameContext\n        ) => UncheckedNamingParts<Definitions>)\n  ): LayoutNameResolver<string>;\n}\n\n/**\n * Supplies optional naming parts. Strict conventions preserve literal names;\n * unchecked conventions accept arbitrary keys and values and return string names.\n */\nexport type LayoutNameFactory<\n  Definitions extends LayoutNamePartDefinitions,\n  Pattern extends string,\n  Strict extends boolean = true\n> = [Strict] extends [false]\n  ? UncheckedLayoutNameFactory<Definitions>\n  : CheckedLayoutNameFactory<Definitions, Pattern>;\n\ninterface DefinedLayoutNameParts<\n  Definitions extends LayoutNamePartDefinitions\n> {\n  /**\n   * Defines the naming pattern and optional strict-checking policy.\n   * Strict defaults to true; false accepts unchecked part keys and values.\n   */\n  namingFn<\n    const Pattern extends string,\n    const Strict extends boolean = true\n  >(\n    definition: LayoutNameOptions<Definitions, Pattern, Strict>\n  ): LayoutNameFactory<Definitions, Pattern, Strict>;\n}\n\nconst defaultPartDefinitions = {\n  prefix: 'string',\n  beforeSuffix: 'string',\n  append: 'string'\n} satisfies { [Key in keyof LayoutNameParts]-?: 'string' };\n\nfunction validatePartValues(\n  definitions: LayoutNamePartDefinitions,\n  values: unknown\n): Record<string, string | number> {\n  if (values === undefined) return {};\n  if (\n    values === null ||\n    typeof values !== 'object' ||\n    Array.isArray(values)\n  ) {\n    throw new LayoutConfigurationError(\n      'Naming part values must be an object.'\n    );\n  }\n\n  const supplied: Array<[string, string | number]> = [];\n  for (const part of Reflect.ownKeys(values)) {\n    if (typeof part !== 'string' || !Object.hasOwn(definitions, part)) {\n      throw new InvalidPartError({\n        part: String(part),\n        validParts: Object.keys(definitions)\n      });\n    }\n    const value: unknown = Reflect.get(values, part);\n    if (value === undefined) continue;\n\n    const expectedType = definitions[part];\n    if (\n      (expectedType === 'string' && typeof value === 'string') ||\n      (expectedType === 'number' && typeof value === 'number')\n    ) {\n      supplied.push([part, value]);\n    } else {\n      throw new InvalidPartTypeError({\n        part,\n        expectedType,\n        receivedType:\n          value === null\n            ? 'null'\n            : Array.isArray(value)\n            ? 'array'\n            : typeof value\n      });\n    }\n  }\n  return Object.fromEntries(supplied);\n}\n\nfunction createNamingFactory<\n  Definitions extends LayoutNamePartDefinitions,\n  const Pattern extends string,\n  Strict extends boolean = true\n>(\n  definitions: Definitions,\n  definition: LayoutNameOptions<Definitions, Pattern, Strict>\n): LayoutNameFactory<Definitions, Pattern, Strict> {\n  if (\n    definition === null ||\n    typeof definition !== 'object' ||\n    typeof definition.pattern !== 'function'\n  ) {\n    throw new LayoutConfigurationError(\n      'Naming configuration must be an object containing a pattern function.'\n    );\n  }\n  const { pattern } = definition;\n  const strict = definition.strict !== false;\n  const defaults = Object.fromEntries(\n    Object.keys(definitions).map((key) => [key, ''])\n  );\n  function name<\n    const Parts extends LayoutNamePartValues<Definitions> = {}\n  >(\n    parts?:\n      | NamingPartsInput<Definitions, Parts>\n      | NamingPartsCallback<Definitions, Parts>\n  ): LayoutNameResolver<Pattern, ResolvedParts<Definitions, Parts>> {\n    if (strict && typeof parts !== 'function')\n      validatePartValues(definitions, parts);\n    const resolver = ((context: LayoutNameContext) => {\n      const values =\n        typeof parts === 'function'\n          ? parts(context as unknown as PatternNameContext)\n          : parts;\n      const supplied = strict\n        ? validatePartValues(definitions, values)\n        : Object.fromEntries(\n            Object.entries(values ?? {}).filter(\n              ([, value]) => value !== undefined\n            )\n          );\n      return pattern(\n        context as unknown as PatternNameContext,\n        {\n          ...defaults,\n          ...supplied\n        } as [Strict] extends [false]\n          ? UncheckedNamingParts<Definitions>\n          : PatternParts<Definitions>\n      );\n    }) as unknown as LayoutNameResolver<\n      Pattern,\n      ResolvedParts<Definitions, Parts>\n    >;\n    Object.defineProperty(resolver, layoutNamePattern, { value: {} });\n    return resolver;\n  }\n  return name as LayoutNameFactory<Definitions, Pattern, Strict>;\n}\n\n/**\n * Defines a reusable layout naming convention that preserves resource-specific\n * literal names in TypeScript. Define the pattern once, then supply optional\n * part values wherever the convention is used.\n *\n * Omit `name` entirely when the generated name, such as `UsersLayout`, is enough.\n * Use this helper when several layouts share a naming rule or need variations\n * while retaining exact component `displayName` types.\n *\n * Choose the form that matches the values your convention needs:\n *\n * - `defineLayoutName({ pattern })` provides the string parts `prefix`,\n *   `beforeSuffix`, and `append` for common naming variations.\n * - `defineLayoutName.defineParts(...names).namingFn({ pattern })` provides custom\n *   string parts when domain-specific names make the pattern clearer.\n * - `defineLayoutName.defineParts(schema).namingFn({ pattern })` declares each\n *   part as `'string'` or `'number'` when supplied values need different types.\n *\n * The pattern controls where parts appear; their names do not impose an order.\n * Part values are optional and omitted values render as empty text. Supply an\n * object for fixed values, or a callback when values depend on the resource.\n * Numeric placeholders can also be empty text inside the pattern. Narrow them\n * with `typeof value === 'number'` before using number-only methods.\n * Supplied keys and value kinds are also validated at runtime. Unknown parts\n * throw InvalidPartError; incorrect value kinds throw InvalidPartTypeError.\n * Each returned naming resolver can be passed to a factory, definition, or\n * component creation call through its `name` option.\n *\n * Strict checking defaults to true. Use `{ pattern, strict: false }` here or\n * in namingFn to accept unchecked part keys and values in both TypeScript\n * and runtime calls. Unchecked conventions return string names.\n *\n * @param definition - An object containing the naming pattern and optional\n * strict-checking policy.\n * @returns A function accepting optional part values or a context callback.\n * Calling it with no arguments leaves every declared part empty.\n *\n * @example\n * Use the default string parts for a shared convention with occasional variants.\n * ```tsx\n * const layoutName = defineLayoutName({\n *   pattern: ({ resource, capitalize }, parts) =>\n *     `${parts.prefix}${capitalize(resource)}${parts.beforeSuffix}Layout${\n *       parts.append\n *     }`\n * });\n * const factory = createDefinedResourceLayout({\n *   resources: ['users'],\n *   name: layoutName()\n * });\n * const { createResourceLayout } = factory.defineResourceLayout({\n *   render: () => <div />\n * });\n * const Users = createResourceLayout({ resource: 'users' });\n * // Users.displayName is typed as 'UsersLayout'.\n * const AdminUsers = createResourceLayout({\n *   resource: 'users',\n *   name: layoutName({ prefix: 'Admin', beforeSuffix: 'Detail' })\n * });\n * // AdminUsers.displayName is typed as 'AdminUsersDetailLayout'.\n * ```\n *\n * @example\n * Declare custom string parts when their names describe your application's\n * conventions more clearly than prefix, beforeSuffix, and append.\n * ```ts\n * const pageName = defineLayoutName\n *   .defineParts('section', 'variant')\n *   .namingFn({\n *     pattern: ({ resource, capitalize }, parts) =>\n *       `${parts.section}${capitalize(resource)}${parts.variant}Page`\n *   });\n * const adminPage = pageName({ section: 'Admin', variant: 'Detail' });\n * // Used for 'users', this produces 'AdminUsersDetailPage'.\n * const resourcePage = pageName(({ resource }) => ({\n *   section: resource === 'users' ? 'Admin' : 'Public'\n * }));\n * // Used for 'users', this produces 'AdminUsersPage'.\n * // Other resources receive the 'Public' section instead.\n * ```\n *\n * @example\n * Use a schema when a part should accept a number instead of a string.\n * Supplied keys are suggested by the editor and checked against the schema.\n * ```ts\n * const versionedName = defineLayoutName\n *   .defineParts({ section: 'string', version: 'number' })\n *   .namingFn({\n *     pattern: ({ resource, capitalize }, parts) =>\n *       `${parts.section}${capitalize(resource)}V${parts.version}`\n *   });\n * const adminV2 = versionedName({ section: 'Admin', version: 2 });\n * // Used for 'users', this produces 'AdminUsersV2'.\n * // versionedName({ version: '2' }) is rejected: version must be a number.\n * ```\n *\n * @example\n * Guard optional numeric values before formatting them with number methods.\n * Plain interpolation, as above, already handles empty values.\n * ```ts\n * const formattedName = defineLayoutName\n *   .defineParts({ version: 'number' })\n *   .namingFn({\n *     pattern: ({ resource, capitalize }, parts) => {\n *       const version =\n *         typeof parts.version === 'number' ? parts.version.toFixed(0) : '';\n *       return `${capitalize(resource)}V${version}`;\n *     }\n *   });\n * ```\n *\n * @example\n * Opt out of part checking when a convention intentionally accepts external\n * keys and mixed value types. The resulting displayName is typed as string.\n * ```ts\n * const externalName = defineLayoutName\n *   .defineParts({ version: 'number' })\n *   .namingFn({\n *     pattern: ({ resource }, parts) =>\n *       `${resource}${parts.version}${parts.extra}`,\n *     strict: false\n *   });\n * const legacy = externalName({ version: 'legacy', extra: true });\n * ```\n */\nexport function defineLayoutName<\n  const Pattern extends string,\n  const Strict extends boolean = true\n>(\n  definition: LayoutNameOptions<\n    typeof defaultPartDefinitions,\n    Pattern,\n    Strict\n  >\n): LayoutNameFactory<typeof defaultPartDefinitions, Pattern, Strict> {\n  return createNamingFactory(defaultPartDefinitions, definition);\n}\n\n/**\n * Declares string placeholders from their names.\n * Call namingFn on the result to define how those slots form a layout name.\n */\nfunction defineParts<const Keys extends readonly string[]>(\n  ...keys: Keys\n): DefinedLayoutNameParts<{ [Key in Keys[number]]: 'string' }>;\n/**\n * Declares placeholders with string or number values from a part schema.\n * Call namingFn on the result to define how those slots form a layout name.\n */\nfunction defineParts<const Definitions extends LayoutNamePartDefinitions>(\n  definitions: Definitions\n): DefinedLayoutNameParts<Definitions>;\nfunction defineParts(\n  ...input: string[] | [LayoutNamePartDefinitions]\n): DefinedLayoutNameParts<LayoutNamePartDefinitions> {\n  const definitions =\n    typeof input[0] === 'object'\n      ? input[0]\n      : Object.fromEntries(input.map((key) => [key, 'string']));\n  return {\n    namingFn(definition) {\n      return createNamingFactory(definitions, definition);\n    }\n  };\n}\n\ndefineLayoutName.defineParts = defineParts;\n"],"mappings":";;;;;AA8IA,MAAa,oBAAmC,OAC9C,mBACF;AA+HA,MAAM,yBAAyB;CAC7B,QAAQ;CACR,cAAc;CACd,QAAQ;AACV;AAEA,SAAS,mBACP,aACA,QACiC;CACjC,IAAI,WAAW,QAAW,OAAO,CAAC;CAClC,IACE,WAAW,QACX,OAAO,WAAW,YAClB,MAAM,QAAQ,MAAM,GAEpB,MAAM,IAAI,yBACR,uCACF;CAGF,MAAM,WAA6C,CAAC;CACpD,KAAK,MAAM,QAAQ,QAAQ,QAAQ,MAAM,GAAG;EAC1C,IAAI,OAAO,SAAS,YAAY,CAAC,OAAO,OAAO,aAAa,IAAI,GAC9D,MAAM,IAAI,iBAAiB;GACzB,MAAM,OAAO,IAAI;GACjB,YAAY,OAAO,KAAK,WAAW;EACrC,CAAC;EAEH,MAAM,QAAiB,QAAQ,IAAI,QAAQ,IAAI;EAC/C,IAAI,UAAU,QAAW;EAEzB,MAAM,eAAe,YAAY;EACjC,IACG,iBAAiB,YAAY,OAAO,UAAU,YAC9C,iBAAiB,YAAY,OAAO,UAAU,UAE/C,SAAS,KAAK,CAAC,MAAM,KAAK,CAAC;OAE3B,MAAM,IAAI,qBAAqB;GAC7B;GACA;GACA,cACE,UAAU,OACN,SACA,MAAM,QAAQ,KAAK,IACnB,UACA,OAAO;EACf,CAAC;CAEL;CACA,OAAO,OAAO,YAAY,QAAQ;AACpC;AAEA,SAAS,oBAKP,aACA,YACiD;CACjD,IACE,eAAe,QACf,OAAO,eAAe,YACtB,OAAO,WAAW,YAAY,YAE9B,MAAM,IAAI,yBACR,uEACF;CAEF,MAAM,EAAE,YAAY;CACpB,MAAM,SAAS,WAAW,WAAW;CACrC,MAAM,WAAW,OAAO,YACtB,OAAO,KAAK,WAAW,EAAE,KAAK,QAAQ,CAAC,KAAK,EAAE,CAAC,CACjD;CACA,SAAS,KAGP,OAGgE;EAChE,IAAI,UAAU,OAAO,UAAU,YAC7B,mBAAmB,aAAa,KAAK;EACvC,MAAM,aAAa,YAA+B;GAChD,MAAM,SACJ,OAAO,UAAU,aACb,MAAM,OAAwC,IAC9C;GACN,MAAM,WAAW,SACb,mBAAmB,aAAa,MAAM,IACtC,OAAO,YACL,OAAO,QAAQ,UAAU,CAAC,CAAC,EAAE,QAC1B,GAAG,WAAW,UAAU,MAC3B,CACF;GACJ,OAAO,QACL,SACA;IACE,GAAG;IACH,GAAG;GACL,CAGF;EACF;EAIA,OAAO,eAAe,UAAU,mBAAmB,EAAE,OAAO,CAAC,EAAE,CAAC;EAChE,OAAO;CACT;CACA,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+HA,SAAgB,iBAId,YAKmE;CACnE,OAAO,oBAAoB,wBAAwB,UAAU;AAC/D;AAgBA,SAAS,YACP,GAAG,OACgD;CACnD,MAAM,cACJ,OAAO,MAAM,OAAO,WAChB,MAAM,KACN,OAAO,YAAY,MAAM,KAAK,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC;CAC5D,OAAO,EACL,SAAS,YAAY;EACnB,OAAO,oBAAoB,aAAa,UAAU;CACpD,EACF;AACF;AAEA,iBAAiB,cAAc"}