react-intlayer 8.0.0-canary.3 → 8.0.0-canary.4

package/dist/types/plugins.d.ts

@@ -1,6 +1,6 @@
 import { IntlayerNode } from "./IntlayerNode.js";
-import { ReactHTMLComponentMap } from "./html/types.js";
-import { DeepTransformContent as DeepTransformContent$1, HTMLCond, IInterpreterPluginState as IInterpreterPluginState$1, Plugins } from "@intlayer/core";
+import { HTMLComponents } from "./utils/HTMLComponentTypes.js";
+import { DeepTransformContent as DeepTransformContent$1, IInterpreterPluginState as IInterpreterPluginState$1, Plugins } from "@intlayer/core";
 import { ReactNode } from "react";
 import { DeclaredLocales, LocalesValues, NodeType } from "@intlayer/types";
 
@@ -23,7 +23,7 @@ declare const reactNodePlugins: Plugins;
 /** ---------------------------------------------
  *  INSERTION PLUGIN
  *  --------------------------------------------- */
-type InsertionCond<T, S, L> = T extends {
+type InsertionCond<T> = T extends {
   nodeType: NodeType | string;
   [NodeType.Insertion]: string;
   fields: readonly string[];
@@ -35,35 +35,50 @@ declare const insertionPlugin: Plugins;
  */
 type MarkdownStringCond<T> = T extends string ? IntlayerNode<string, {
   metadata: DeepTransformContent<string>;
-  use: (components: ReactHTMLComponentMap) => ReactNode;
+  use: (components: HTMLComponents<'permissive', {}>) => ReactNode;
 }> : never;
 /** Markdown string plugin. Replaces string node with a component that render the markdown. */
 declare const markdownStringPlugin: Plugins;
-type MarkdownCond<T, S, L extends LocalesValues> = T extends {
+type MarkdownCond<T> = T extends {
   nodeType: NodeType | string;
   [NodeType.Markdown]: infer M;
   metadata?: infer U;
+  tags?: infer U;
 } ? {
-  use: (components?: ReactHTMLComponentMap) => ReactNode;
-  metadata: DeepTransformContent<U, L>;
-} & any : never;
+  use: (components?: HTMLComponents<'permissive', U>) => IntlayerNode<M>;
+  metadata: DeepTransformContent<U>;
+} : never;
 declare const markdownPlugin: Plugins;
 /** ---------------------------------------------
  *  HTML PLUGIN
  *  --------------------------------------------- */
-type HTMLPluginCond<T, S, L> = HTMLCond<T, S, L, ReactNode, ReactNode>;
+/**
+ * HTML conditional type that enforces:
+ * - All components (Standard or Custom) are OPTIONAL in the `use()` method.
+ * - Custom components props are strictly inferred from the dictionary definition.
+ *
+ * This ensures type safety:
+ * - `html('<div>Hello <CustomComponent /></div>').use({ CustomComponent: ... })` - optional but typed
+ */
+type HTMLPluginCond<T> = T extends {
+  nodeType: NodeType | string;
+  [NodeType.HTML]: infer I;
+  tags?: infer U;
+} ? {
+  use: (components?: HTMLComponents<'permissive', U>) => IntlayerNode<I>;
+} : never;
 /** HTML plugin. Replaces node with a function that takes components => ReactNode. */
 declare const htmlPlugin: Plugins;
 /** ---------------------------------------------
  *  PLUGINS RESULT
  *  --------------------------------------------- */
-interface IInterpreterPluginReact<T, S, L extends LocalesValues> {
+type IInterpreterPluginReact<T, _S, _L extends LocalesValues> = {
   reactNode: ReactNodeCond<T>;
   reactIntlayerNode: IntlayerNodeCond<T>;
-  reactInsertion: InsertionCond<T, S, L>;
-  reactMarkdown: MarkdownCond<T, S, L>;
-  reactHtml: HTMLPluginCond<T, S, L>;
-}
+  reactInsertion: InsertionCond<T>;
+  reactMarkdown: MarkdownCond<T>;
+  reactHtml: HTMLPluginCond<T>;
+};
 /**
  * Insert this type as param of `DeepTransformContent` to avoid `intlayer` package pollution.
  *

package/dist/types/plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.d.ts","names":[],"sources":["../../src/plugins.tsx"],"mappings":";;;;;;;;;AAsCA;KAAY,gBAAA,MAAsB,CAAA,2BAC9B,YAAA,CAAa,CAAA;;cAIJ,mBAAA,EAAqB,OAAA;;;;KA0BtB,aAAA,MAAmB,CAAA;EAC7B,KAAA;EACA,GAAA;AAAA,IAEE,SAAA;;cAIS,gBAAA,EAAkB,OAAA;;AAlC/B;;KA+DY,aAAA,YAAyB,CAAA;EACnC,QAAA,EAAU,QAAA;EAAA,CACT,QAAA,CAAS,SAAA;EACV,MAAA;AAAA,KAGI,MAAA,UACQ,CAAA,qBAAsB,SAAA,OAE3B,SAAA;;cA4BI,eAAA,EAAiB,OAAA;;;;KA6DlB,kBAAA,MAAwB,CAAA,kBAChC,YAAA;EAGI,QAAA,EAAU,oBAAA;EACV,GAAA,GAAM,UAAA,EAAY,qBAAA,KAA0B,SAAA;AAAA;;cAMvC,oBAAA,EAAsB,OAAA;AAAA,KA+EvB,YAAA,iBAA6B,aAAA,IAAiB,CAAA;EACxD,QAAA,EAAU,QAAA;EAAA,CACT,QAAA,CAAS,QAAA;EACV,QAAA;AAAA;EAGI,GAAA,GAAM,UAAA,GAAa,qBAAA,KAA0B,SAAA;EAC7C,QAAA,EAAU,oBAAA,CAAqB,CAAA,EAAG,CAAA;AAAA;AAAA,cAI3B,cAAA,EAAgB,OAAA;;;;KA2BjB,cAAA,YAA0B,QAAA,CAAS,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,SAAA,EAAW,SAAA;;cAGtD,UAAA,EAAY,OAAA;;;;UAiDR,uBAAA,iBAAwC,aAAA;EACvD,SAAA,EAAW,aAAA,CAAc,CAAA;EACzB,iBAAA,EAAmB,gBAAA,CAAiB,CAAA;EACpC,cAAA,EAAgB,aAAA,CAAc,CAAA,EAAG,CAAA,EAAG,CAAA;EACpC,aAAA,EAAe,YAAA,CAAa,CAAA,EAAG,CAAA,EAAG,CAAA;EAClC,SAAA,EAAW,cAAA,CAAe,CAAA,EAAG,CAAA,EAAG,CAAA;AAAA;;;;;AAtPlC;KA8PY,uBAAA,GAA0B,yBAAA;EACpC,SAAA;EACA,iBAAA;EACA,cAAA;EACA,aAAA;EACA,SAAA;AAAA;AAAA,KAGU,oBAAA,cAEA,aAAA,GAAgB,eAAA,IACxB,sBAAA,CAAyB,CAAA,EAAG,uBAAA,EAAyB,CAAA"}
+{"version":3,"file":"plugins.d.ts","names":[],"sources":["../../src/plugins.tsx"],"mappings":";;;;;;;;;AAkCA;KAAY,gBAAA,MAAsB,CAAA,2BAC9B,YAAA,CAAa,CAAA;;cAIJ,mBAAA,EAAqB,OAAA;;;;KA0BtB,aAAA,MAAmB,CAAA;EAC7B,KAAA;EACA,GAAA;AAAA,IAEE,SAAA;;cAIS,gBAAA,EAAkB,OAAA;;AAlC/B;;KA+DY,aAAA,MAAmB,CAAA;EAC7B,QAAA,EAAU,QAAA;EAAA,CACT,QAAA,CAAS,SAAA;EACV,MAAA;AAAA,KAGI,MAAA,UACQ,CAAA,qBAAsB,SAAA,OAE3B,SAAA;;cA4BI,eAAA,EAAiB,OAAA;;;;KA6DlB,kBAAA,MAAwB,CAAA,kBAChC,YAAA;EAGI,QAAA,EAAU,oBAAA;EACV,GAAA,GAAM,UAAA,EAAY,cAAA,uBAAqC,SAAA;AAAA;;cAMlD,oBAAA,EAAsB,OAAA;AAAA,KA+EvB,YAAA,MAAkB,CAAA;EAC5B,QAAA,EAAU,QAAA;EAAA,CACT,QAAA,CAAS,QAAA;EACV,QAAA;EACA,IAAA;AAAA;EAGI,GAAA,GAAM,UAAA,GAAa,cAAA,eAA6B,CAAA,MAAO,YAAA,CAAa,CAAA;EACpE,QAAA,EAAU,oBAAA,CAAqB,CAAA;AAAA;AAAA,cAIxB,cAAA,EAAgB,OAAA;;;;;;;;;;;;KAmCjB,cAAA,MAAoB,CAAA;EAC9B,QAAA,EAAU,QAAA;EAAA,CACT,QAAA,CAAS,IAAA;EACV,IAAA;AAAA;EAGI,GAAA,GAAM,UAAA,GAAa,cAAA,eAA6B,CAAA,MAAO,YAAA,CAAa,CAAA;AAAA;;cAK7D,UAAA,EAAY,OAAA;;;AApJzB;KAwLY,uBAAA,mBAA0C,aAAA;EACpD,SAAA,EAAW,aAAA,CAAc,CAAA;EACzB,iBAAA,EAAmB,gBAAA,CAAiB,CAAA;EACpC,cAAA,EAAgB,aAAA,CAAc,CAAA;EAC9B,aAAA,EAAe,YAAA,CAAa,CAAA;EAC5B,SAAA,EAAW,cAAA,CAAe,CAAA;AAAA;;;;;;KAQhB,uBAAA,GAA0B,yBAAA;EACpC,SAAA;EACA,iBAAA;EACA,cAAA;EACA,aAAA;EACA,SAAA;AAAA;AAAA,KAGU,oBAAA,cAEA,aAAA,GAAgB,eAAA,IACxB,sBAAA,CAAyB,CAAA,EAAG,uBAAA,EAAyB,CAAA"}

package/dist/types/server/IntlayerServerProvider.d.ts

@@ -1,4 +1,4 @@
-import * as react0 from "react";
+import * as react200 from "react";
 import { FC, PropsWithChildren } from "react";
 import { LocalesValues } from "@intlayer/types";
 
@@ -13,7 +13,7 @@ declare const IntlayerServerContext: FC<PropsWithChildren<{
     value?: LocalesValues;
   }>>;
   Consumer: FC<PropsWithChildren<{
-    children: (context: LocalesValues) => react0.ReactNode;
+    children: (context: LocalesValues) => react200.ReactNode;
   }>>;
   _storage: () => {
     value: LocalesValues;

package/dist/types/server/useDictionary.d.ts

@@ -1,5 +1,5 @@
 import { IInterpreterPluginState as IInterpreterPluginState$1 } from "../plugins.js";
-import * as _intlayer_core0 from "@intlayer/core";
+import * as _intlayer_core4 from "@intlayer/core";
 import { DeclaredLocales, Dictionary, LocalesValues } from "@intlayer/types";
 
 //#region src/server/useDictionary.d.ts
@@ -8,7 +8,7 @@ import { DeclaredLocales, Dictionary, LocalesValues } from "@intlayer/types";
  *
  * If the locale is not provided, it will use the locale from the server context
  */
-declare const useDictionary: <T extends Dictionary, L extends LocalesValues = DeclaredLocales>(dictionary: T, locale?: L) => _intlayer_core0.DeepTransformContent<T["content"], IInterpreterPluginState$1, L>;
+declare const useDictionary: <T extends Dictionary, L extends LocalesValues = DeclaredLocales>(dictionary: T, locale?: L) => _intlayer_core4.DeepTransformContent<T["content"], IInterpreterPluginState$1, L>;
 //#endregion
 export { useDictionary };
 //# sourceMappingURL=useDictionary.d.ts.map

package/dist/types/server/useDictionaryAsync.d.ts

@@ -1,5 +1,5 @@
 import { IInterpreterPluginState as IInterpreterPluginState$1 } from "../plugins.js";
-import * as _intlayer_core1 from "@intlayer/core";
+import * as _intlayer_core2 from "@intlayer/core";
 import { DeclaredLocales, Dictionary, LocalesValues, StrictModeLocaleMap } from "@intlayer/types";
 
 //#region src/server/useDictionaryAsync.d.ts
@@ -8,7 +8,7 @@ import { DeclaredLocales, Dictionary, LocalesValues, StrictModeLocaleMap } from
  *
  * If the locale is not provided, it will use the locale from the server context
  */
-declare const useDictionaryAsync: <T extends Dictionary, L extends LocalesValues = DeclaredLocales>(dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>, locale?: L) => Promise<_intlayer_core1.DeepTransformContent<T["content"], IInterpreterPluginState$1, L>>;
+declare const useDictionaryAsync: <T extends Dictionary, L extends LocalesValues = DeclaredLocales>(dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>, locale?: L) => Promise<_intlayer_core2.DeepTransformContent<T["content"], IInterpreterPluginState$1, L>>;
 //#endregion
 export { useDictionaryAsync };
 //# sourceMappingURL=useDictionaryAsync.d.ts.map

package/dist/types/server/useIntlayer.d.ts

@@ -1,5 +1,5 @@
 import { IInterpreterPluginState as IInterpreterPluginState$1 } from "../plugins.js";
-import * as _intlayer_core2 from "@intlayer/core";
+import * as _intlayer_core5 from "@intlayer/core";
 import * as _intlayer_types8 from "@intlayer/types";
 import { DictionaryKeys, LocalesValues } from "@intlayer/types";
 
@@ -9,7 +9,7 @@ import { DictionaryKeys, LocalesValues } from "@intlayer/types";
  *
  * If the locale is not provided, it will use the locale from the server context
  */
-declare const useIntlayer: <T extends DictionaryKeys, L extends LocalesValues>(key: T, locale?: L) => _intlayer_core2.DeepTransformContent<_intlayer_types8.DictionaryRegistryContent<T>, IInterpreterPluginState$1, L>;
+declare const useIntlayer: <T extends DictionaryKeys, L extends LocalesValues>(key: T, locale?: L) => _intlayer_core5.DeepTransformContent<_intlayer_types8.DictionaryRegistryContent<T>, IInterpreterPluginState$1, L>;
 //#endregion
 export { useIntlayer };
 //# sourceMappingURL=useIntlayer.d.ts.map

package/dist/types/utils/HTMLComponentTypes.d.ts

@@ -0,0 +1,38 @@
+import { HTMLTagsType } from "@intlayer/core";
+import { ComponentProps, FC, HTMLAttributes, JSX } from "react";
+
+//#region src/utils/HTMLComponentTypes.d.ts
+/**
+ * Helper to extract specific props from the configuration value.
+ */
+type PropsFromConfig<Value> = Value extends true ? {} : Value extends object ? Value : {};
+/**
+ * Smart Type to resolve props based on the key K.
+ */
+type ElementProps<K> = K extends keyof JSX.IntrinsicElements ? ComponentProps<K> : HTMLAttributes<HTMLElement>;
+/**
+ * Helper: Defines the mapping for the explicitly listed keys in T.
+ * Handles whether they are Required or Optional.
+ */
+type DefinedComponents<T, IsRequired extends boolean> = IsRequired extends true ? { [K in keyof T]: FC<ElementProps<K> & PropsFromConfig<T[K]>> } : { [K in keyof T]?: FC<ElementProps<K> & PropsFromConfig<T[K]>> };
+/**
+ * Helper: Defines the standard HTML tags NOT listed in T.
+ * These are always optional when included.
+ */
+type RestHTMLComponents<T> = { [K in Exclude<keyof HTMLTagsType, keyof T>]?: FC<K extends keyof JSX.IntrinsicElements ? ComponentProps<K> : HTMLAttributes<HTMLElement>> };
+/**
+ * The supported modes for the HTMLComponents type.
+ */
+type HTMLComponentMode = 'permissive' | 'optional' | 'inclusive' | 'strict';
+/**
+ * The main component definition with Mode support.
+ */
+type HTMLComponents<Mode extends HTMLComponentMode = 'optional', T = {}> = Mode extends 'strict' ? DefinedComponents<T, true> : Mode extends 'inclusive' ? // Inclusive: Keys in T are required. Rest of HTML is optional.
+DefinedComponents<T, true> & RestHTMLComponents<T> : Mode extends 'permissive' ? // Permissive: Keys in T optional. Rest of HTML optional. Any other string allowed.
+DefinedComponents<T, false> & RestHTMLComponents<T> & {
+  [key: string]: FC<HTMLAttributes<HTMLElement>>;
+} : // Optional (Default): Keys in T optional. Rest of HTML optional.
+DefinedComponents<T, false> & RestHTMLComponents<T>;
+//#endregion
+export { HTMLComponentMode, HTMLComponents };
+//# sourceMappingURL=HTMLComponentTypes.d.ts.map

package/dist/types/utils/HTMLComponentTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HTMLComponentTypes.d.ts","names":[],"sources":["../../../src/utils/HTMLComponentTypes.tsx"],"mappings":";;;;;;AACqE;KAKhE,eAAA,UAAyB,KAAA,qBAE1B,KAAA,kBACE,KAAA;;;;KAMD,YAAA,MAAkB,CAAA,eAAgB,GAAA,CAAI,iBAAA,GACvC,cAAA,CAAe,CAAA,IACf,cAAA,CAAe,WAAA;;;;;KAMd,iBAAA,kCAAmD,UAAA,8BAGtC,CAAA,GAAI,EAAA,CAAG,YAAA,CAAa,CAAA,IAAK,eAAA,CAAgB,CAAA,CAAE,CAAA,sBAI3C,CAAA,IAAK,EAAA,CAAG,YAAA,CAAa,CAAA,IAAK,eAAA,CAAgB,CAAA,CAAE,CAAA;;;;;KAOzD,kBAAA,cACG,OAAA,OAAc,YAAA,QAAoB,CAAA,KAAM,EAAA,CAC5C,CAAA,eAAgB,GAAA,CAAI,iBAAA,GAChB,cAAA,CAAe,CAAA,IACf,cAAA,CAAe,WAAA;;;;KAOX,iBAAA;;;;KASA,cAAA,cACG,iBAAA,yBAEX,IAAA,oBAEA,iBAAA,CAAkB,CAAA,UAClB,IAAA;AAEE,iBAAA,CAAkB,CAAA,UAAW,kBAAA,CAAmB,CAAA,IAChD,IAAA;AAEE,iBAAA,CAAkB,CAAA,WAChB,kBAAA,CAAmB,CAAA;EAAA,CAEhB,GAAA,WAAc,EAAA,CAAG,cAAA,CAAe,WAAA;AAAA;AAGrC,iBAAA,CAAkB,CAAA,WAAY,kBAAA,CAAmB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-intlayer",
-  "version": "8.0.0-canary.3",
+  "version": "8.0.0-canary.4",
   "private": false,
   "description": "Easily internationalize i18n your React applications with type-safe multilingual content management.",
   "keywords": [
@@ -116,14 +116,14 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/api": "8.0.0-canary.3",
-    "@intlayer/config": "8.0.0-canary.3",
-    "@intlayer/core": "8.0.0-canary.3",
-    "@intlayer/dictionaries-entry": "8.0.0-canary.3",
-    "@intlayer/editor-react": "8.0.0-canary.3",
-    "@intlayer/types": "8.0.0-canary.3",
-    "@intlayer/unmerged-dictionaries-entry": "8.0.0-canary.3",
-    "intlayer": "8.0.0-canary.3"
+    "@intlayer/api": "8.0.0-canary.4",
+    "@intlayer/config": "8.0.0-canary.4",
+    "@intlayer/core": "8.0.0-canary.4",
+    "@intlayer/dictionaries-entry": "8.0.0-canary.4",
+    "@intlayer/editor-react": "8.0.0-canary.4",
+    "@intlayer/types": "8.0.0-canary.4",
+    "@intlayer/unmerged-dictionaries-entry": "8.0.0-canary.4",
+    "intlayer": "8.0.0-canary.4"
   },
   "devDependencies": {
     "@craco/types": "7.1.0",

package/dist/types/html/types.d.ts

@@ -1,26 +0,0 @@
-import { BaseHTMLProps, ExtractTags } from "@intlayer/core";
-import { ReactNode } from "react";
-
-//#region src/html/types.d.ts
-/**
- * Props for React HTML components
- * Extends base HTML props with ReactNode children
- */
-interface ReactComponentProps extends BaseHTMLProps {
-  children?: ReactNode;
-}
-/**
- * React HTML component function type
- */
-type ReactHTMLComponent = (props: ReactComponentProps) => ReactNode;
-/**
- * Component map type for React
- * - Standard HTML tags are optional (Partial)
- * - Custom components are required
- */
-type ReactHTMLComponentMap<T = never> = (T extends Record<string, any> ? { [K in keyof T]: (props: T[K] & {
-  children?: ReactNode;
-}) => ReactNode } : T extends string ? { [K in T]: ReactHTMLComponent } : {}) & Partial<Record<string, ReactHTMLComponent>>;
-//#endregion
-export { type ExtractTags, ReactComponentProps, ReactHTMLComponent, ReactHTMLComponentMap };
-//# sourceMappingURL=types.d.ts.map

package/dist/types/html/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/html/types.ts"],"mappings":";;;;;;AAOA;;UAAiB,mBAAA,SAA4B,aAAA;EAC3C,QAAA,GAAW,SAAA;AAAA;;;;KAMD,kBAAA,IAAsB,KAAA,EAAO,mBAAA,KAAwB,SAAA;AAAjE;;;;;AAAA,KAOY,qBAAA,eAAoC,CAAA,SAAU,MAAA,8BACxC,CAAA,IAAK,KAAA,EAAO,CAAA,CAAE,CAAA;EAAO,QAAA,GAAW,SAAA;AAAA,MAAgB,SAAA,KAC9D,CAAA,0BACU,CAAA,GAAI,kBAAA,WAEhB,OAAA,CAAQ,MAAA,SAAe,kBAAA"}