@intlayer/engine 9.0.0-canary.12

package/dist/assets/installSkills/skills/preact.md

@@ -0,0 +1,83 @@
+---
+name: intlayer-preact
+description: Integrates Intlayer internationalization with Preact applications. Use when the user asks to "setup Preact i18n", create a new translated component, use the "useIntlayer" hook in Preact, or configure providers.
+metadata:
+  author: Intlayer
+  url: https://intlayer.org
+  license: Apache-2.0
+  mcp-server: "@intlayer/mcp"
+  category: productivity
+  tags: [i18n, preact, vite]
+  documentation: https://intlayer.org/doc
+  support: contact@intlayer.org
+---
+
+# Intlayer Preact Usage
+
+## Core Philosophy
+
+Intlayer promotes **Component-Level Content Declaration**. Instead of a massive global translation file, content is declared in `*.content.ts` files adjacent to the Preact components that use them.
+
+## Workflow
+
+To create a translated component, you need two files:
+
+1.  **Declaration:** A content file (e.g., `myComponent.content.ts`) defining the dictionary.
+2.  **Implementation:** A Preact component (e.g., `MyComponent.tsx`) using the `useIntlayer` hook.
+
+### Declare Content
+
+Create a content file using `t()` for translations.
+**File:** `src/components/MyComponent/myComponent.content.ts`
+
+```typescript
+import { t, type Dictionary } from "intlayer";
+
+const content = {
+  // The 'key' must be unique and matches what you pass to useIntlayer()
+  key: "my-component",
+  content: {
+    text: t({
+      en: "Welcome",
+      fr: "Bienvenue",
+      es: "Hola",
+    }),
+  },
+} satisfies Dictionary;
+
+export default content;
+```
+
+## Setup
+
+- [Vite and Preact](https://intlayer.org/doc/environment/vite-and-preact.md)
+
+## useIntlayer Hook
+
+```tsx
+import { useIntlayer } from "preact-intlayer";
+
+const MyComponent = () => {
+  const content = useIntlayer("my-component");
+
+  return (
+    <div>
+      <h1>
+        {/* Return content */}
+        {content.text}
+      </h1>
+      {/* Return string (.value) */}
+      <img src={content.text.value} alt={content.text.value} />
+    </div>
+  );
+};
+```
+
+## References
+
+- [Website](https://intlayer.org)
+- [Doc](https://intlayer.org/doc)
+
+- [Vite and Preact](https://intlayer.org/doc/environment/vite-and-preact.md)
+- [Intlayer Exports](https://intlayer.org/doc/packages/intlayer/exports.md)
+- [Preact Intlayer Exports](https://intlayer.org/doc/packages/preact-intlayer/exports.md)

package/dist/assets/installSkills/skills/react.md

@@ -0,0 +1,105 @@
+---
+name: intlayer-react
+description: Integrates Intlayer internationalization with React component. Use when the user asks to "setup React i18n", create a new translated component, use the "useIntlayer" hook, or configure providers.
+metadata:
+  author: Intlayer
+  url: https://intlayer.org
+  license: Apache-2.0
+  mcp-server: "@intlayer/mcp"
+  category: productivity
+  tags: [i18n, react, vite]
+  documentation: https://intlayer.org/doc
+  support: contact@intlayer.org
+---
+
+# Intlayer React Usage
+
+## Core Philosophy
+
+Intlayer promotes **Component-Level Content Declaration**. Instead of a massive global translation file, content is declared in `*.content.ts` files adjacent to the React components that use them.
+
+## Workflow
+
+To create a translated component, you need two files:
+
+1.  **Declaration:** A content file (e.g., `myComponent.content.ts`) defining the dictionary.
+2.  **Implementation:** A React component (e.g., `MyComponent.tsx`) using the `useIntlayer` hook.
+
+### 1. Declare Content
+
+Create a content file using `t()` for translations.
+**File:** `src/components/MyComponent/myComponent.content.ts`
+
+```typescript
+import { t, type Dictionary } from "intlayer";
+
+const content = {
+  // The 'key' must be unique and matches what you pass to useIntlayer()
+  key: "my-component",
+  content: {
+    text: t({
+      en: "Welcome",
+      fr: "Bienvenue",
+      es: "Hola",
+      // ... All other locales set in intlayer config file
+    }),
+  },
+} satisfies Dictionary;
+
+export default content;
+```
+
+# Intlayer React Usage
+
+## Setup
+
+- [Vite and React](https://intlayer.org/doc/environment/vite-and-react.md)
+- [Create React App](https://intlayer.org/doc/environment/create-react-app.md)
+- [React Router v7](https://intlayer.org/doc/environment/vite-and-react/react-router-v7.md)
+- [React Router v7 (fs routes)](https://intlayer.org/doc/environment/vite-and-react/react-router-v7-fs-routes.md)
+- [Tanstack Start](https://intlayer.org/doc/environment/tanstack-start.md)
+- [React Native and Expo](https://intlayer.org/doc/environment/react-native-and-expo.md)
+- [Lynx and React](https://intlayer.org/doc/environment/lynx-and-react.md)
+
+## useIntlayer Hook
+
+```tsx
+import { useIntlayer } from "react-intlayer";
+const MyComponent = () => {
+  const content = useIntlayer("my-dictionary-key");
+  return (
+    <div>
+      <h1>
+        {/* Return react node */}
+        {content.text}
+      </h1>
+      {/* Return string (.value) */}
+      <img src={content.text.value} alt={content.text.value} />
+    </div>
+  );
+};
+```
+
+## References
+
+- [Website](https://intlayer.org)
+- [Doc](https://intlayer.org/doc)
+
+### Environments
+
+- [Vite and React](https://intlayer.org/doc/environment/vite-and-react.md)
+- [Create React App](https://intlayer.org/doc/environment/create-react-app.md)
+- [Vite and React (React Router v7)](https://intlayer.org/doc/environment/vite-and-react/react-router-v7.md)
+- [Vite and React (React Router v7 FS Routes)](https://intlayer.org/doc/environment/vite-and-react/react-router-v7-fs-routes.md)
+
+### Packages
+
+- [Intlayer Exports](https://intlayer.org/doc/packages/intlayer/exports.md)
+- [React Intlayer Provider](https://intlayer.org/doc/packages/react-intlayer/IntlayerProvider.md)
+- [React Intlayer MarkdownRenderer](https://intlayer.org/doc/packages/react-intlayer/MarkdownRenderer.md)
+- [React Intlayer Exports](https://intlayer.org/doc/packages/react-intlayer/exports.md)
+- [React Intlayer T](https://intlayer.org/doc/packages/react-intlayer/t.md)
+- [React Intlayer useDictionary](https://intlayer.org/doc/packages/react-intlayer/useDictionary.md)
+- [React Intlayer useI18n](https://intlayer.org/doc/packages/react-intlayer/useI18n.md)
+- [React Intlayer useIntlayer](https://intlayer.org/doc/packages/react-intlayer/useIntlayer.md)
+- [React Intlayer useLocale](https://intlayer.org/doc/packages/react-intlayer/useLocale.md)

package/dist/assets/installSkills/skills/remote-content.md

@@ -0,0 +1,31 @@
+---
+name: intlayer-cms
+description: Manages remote content and server-side dictionaries using the Intlayer CMS. Use when the user asks to "fetch remote translations", "use Intlayer CMS", or "handle server-side content".
+metadata:
+  author: Intlayer
+  url: https://intlayer.org
+  license: Apache-2.0
+  mcp-server: "@intlayer/mcp"
+  category: productivity
+  tags: [i18n]
+  documentation: https://intlayer.org/doc
+  support: contact@intlayer.org
+---
+
+# Intlayer Server Content & CMS
+
+For managing server-side content and using the Intlayer CMS:
+
+- [Intlayer CMS Documentation](https://intlayer.org/cms.md)
+
+## References
+
+### Concepts
+
+- [CMS Concept](https://intlayer.org/doc/concept/cms.md)
+- [Editor Concept](https://intlayer.org/doc/concept/editor.md)
+
+### Links
+
+- [CMS](https://intlayer.org/cms)
+- [TMS](https://intlayer.org/tms)

package/dist/assets/installSkills/skills/solid.md

@@ -0,0 +1,90 @@
+---
+name: intlayer-solid-js
+description: Integrates Intlayer internationalization with SolidJS components. Use when the user asks to "setup SolidJS i18n", create a new translated component, use the "useIntlayer" hook in Solid, or configure providers.
+metadata:
+  author: Intlayer
+  url: https://intlayer.org
+  license: Apache-2.0
+  mcp-server: "@intlayer/mcp"
+  category: productivity
+  tags: [i18n, solid, vite]
+  documentation: https://intlayer.org/doc
+  support: contact@intlayer.org
+---
+
+# Intlayer Solid Usage
+
+## Core Philosophy
+
+Intlayer promotes **Component-Level Content Declaration**. Instead of a massive global translation file, content is declared in `*.content.ts` files adjacent to the Solid components that use them.
+
+## Workflow
+
+To create a translated component, you need two files:
+
+1.  **Declaration:** A content file (e.g., `myComponent.content.ts`) defining the dictionary.
+2.  **Implementation:** A Solid component (e.g., `MyComponent.tsx`) using the `useIntlayer` hook.
+
+### Declare Content
+
+Create a content file using `t()` for translations.
+**File:** `src/components/MyComponent/myComponent.content.ts`
+
+```typescript
+import { t, type Dictionary } from "intlayer";
+
+const content = {
+  // The 'key' must be unique and matches what you pass to useIntlayer()
+  key: "my-component",
+  content: {
+    text: t({
+      en: "Welcome",
+      fr: "Bienvenue",
+      es: "Hola",
+    }),
+  },
+} satisfies Dictionary;
+
+export default content;
+```
+
+## Setup
+
+- [Vite and Solid](https://intlayer.org/doc/environment/vite-and-solid.md)
+
+## useIntlayer Hook
+
+> [!IMPORTANT]
+> In Solid, `useIntlayer` returns reactive content (e.g., `content`). You can access its properties directly.
+
+```tsx
+import { useIntlayer } from "solid-intlayer";
+
+const MyComponent = () => {
+  const content = useIntlayer("my-component");
+
+  return (
+    <div>
+      <h1>
+        {/* Return content */}
+        {content.text}
+      </h1>
+      {/* Return string (.value) */}
+      <img src={content.text.value} alt={content.text.value} />
+    </div>
+  );
+};
+```
+
+## References
+
+- [Website](https://intlayer.org)
+- [Doc](https://intlayer.org/doc)
+
+### Environments
+
+- [Vite and Solid](https://intlayer.org/doc/environment/vite-and-solid.md)
+
+### Packages
+
+- [Solid Intlayer Exports](https://intlayer.org/doc/packages/solid-intlayer/exports.md)

package/dist/assets/installSkills/skills/svelte.md

@@ -0,0 +1,84 @@
+---
+name: intlayer-svelte
+description: Integrates Intlayer internationalization with Svelte and SvelteKit applications. Use when the user asks to "setup Svelte i18n", create a new translated component, use the "useIntlayer" store, or configure providers.
+metadata:
+  author: Intlayer
+  url: https://intlayer.org
+  license: Apache-2.0
+  mcp-server: "@intlayer/mcp"
+  category: productivity
+  tags: [i18n, svelte, vite]
+  documentation: https://intlayer.org/doc
+  support: contact@intlayer.org
+---
+
+# Intlayer Svelte Usage
+
+## Core Philosophy
+
+Intlayer promotes **Component-Level Content Declaration**. Instead of a massive global translation file, content is declared in `*.content.ts` files adjacent to the Svelte components that use them.
+
+## Workflow
+
+To create a translated component, you need two files:
+
+1.  **Declaration:** A content file (e.g., `myComponent.content.ts`) defining the dictionary.
+2.  **Implementation:** A Svelte component (e.g., `MyComponent.svelte`) using the `useIntlayer` store.
+
+### 1. Declare Content
+
+Create a content file using `t()` for translations.
+**File:** `src/components/MyComponent/myComponent.content.ts`
+
+```typescript
+import { t, type Dictionary } from "intlayer";
+
+const content = {
+  // The 'key' must be unique and matches what you pass to useIntlayer()
+  key: "my-component",
+  content: {
+    text: t({
+      en: "Welcome",
+      fr: "Bienvenue",
+      es: "Hola",
+    }),
+  },
+} satisfies Dictionary;
+
+export default content;
+```
+
+## Setup
+
+- [SvelteKit](https://intlayer.org/doc/environment/sveltekit.md)
+- [Vite and Svelte](https://intlayer.org/doc/environment/vite-and-svelte.md)
+
+## useIntlayer Hook
+
+In Svelte, `useIntlayer` returns a **store**. You must use the `$` prefix to access its value.
+
+```svelte
+<script>
+  import { useIntlayer } from "svelte-intlayer";
+  const content = useIntlayer("my-component");
+</script>
+
+<div>
+  <h1>
+    {/* Return content */}
+    {$content.text}
+  </h1>
+  {/* Return string (.value) */}
+  <div aria-label={$content.text.value}></div>
+</div>
+```
+
+## References
+
+- [Website](https://intlayer.org)
+- [Doc](https://intlayer.org/doc)
+
+- [Intlayer Exports](https://intlayer.org/doc/packages/intlayer/exports.md)
+- [Vite and Svelte](https://intlayer.org/doc/environment/vite-and-svelte.md)
+- [SvelteKit](https://intlayer.org/doc/environment/sveltekit.md)
+- [Svelte Intlayer Exports](https://intlayer.org/doc/packages/svelte-intlayer/exports.md)

package/dist/assets/installSkills/skills/usage.md

@@ -0,0 +1,44 @@
+---
+name: intlayer-usage
+description: Provides general guidelines for using Intlayer in any project. Use when the user asks to "get started with Intlayer", "declare content files", or understand the "project structure" for internationalization.
+metadata:
+  author: Intlayer
+  url: https://intlayer.org
+  license: Apache-2.0
+  mcp-server: "@intlayer/mcp"
+  category: productivity
+  tags: [i18n]
+  documentation: https://intlayer.org/doc
+  support: contact@intlayer.org
+---
+
+# Intlayer Usage
+
+To use Intlayer effectively:
+
+1.  **Retrieve Locales**: Check `intlayer.config.{ts,js,json,json5,jsonc,cjs,mjs}`, `.intlayerrc` to see the configured locales.
+
+2.  **Declare Content**:
+    We recommend creating one content declaration file per component, located alongside the component file. This keeps translations close to the code.
+
+3.  **Consume Content**: Use the provided hooks and functions to access your content.
+    - [Intlayer Exports](https://intlayer.org/doc/packages/intlayer/exports.md)
+    - [React Intlayer Exports](https://intlayer.org/doc/packages/react-intlayer/exports.md)
+
+    **Common Packages:**
+    - `intlayer`: Core package for content declaration and utility functions.
+    - `react-intlayer`: React components and hooks (e.g., `useIntlayer`).
+    - `vite-intlayer`: Vite plugin for integration.
+
+4.  **CLI Commands**:
+    Useful commands for managing your content:
+    - `npx intlayer build`: Build the dictionaries from your content declarations.
+
+## References
+
+- [Get Started](https://intlayer.org/doc/get-started.md)
+- [How Intlayer Works](https://intlayer.org/doc/concept/how-works-intlayer.md)
+- [Why Intlayer](https://intlayer.org/doc/why.md)
+- [Per-locale File](https://intlayer.org/doc/concept/per-locale-file.md)
+- [Website](https://intlayer.org)
+- [Doc](https://intlayer.org/doc)

package/dist/assets/installSkills/skills/vue.md

@@ -0,0 +1,56 @@
+---
+name: intlayer-vue
+description: Integrates Intlayer internationalization with Vue.js and Nuxt applications. Use when the user asks to "setup Vue i18n", use the "useIntlayer" composable, or manage translations in Vue components.
+metadata:
+  author: Intlayer
+  url: https://intlayer.org
+  license: Apache-2.0
+  mcp-server: "@intlayer/mcp"
+  category: productivity
+  tags: [i18n]
+  documentation: https://intlayer.org/doc
+  support: contact@intlayer.org
+---
+
+# Intlayer Vue Usage
+
+## Setup
+
+- [Vite and Vue](https://intlayer.org/doc/environment/vite-and-vue.md)
+- [Nuxt and Vue](https://intlayer.org/doc/environment/nuxt-and-vue.md)
+
+## useIntlayer Composable
+
+```vue
+<script setup>
+import { useIntlayer } from "vue-intlayer";
+const content = useIntlayer("my-dictionary-key");
+
+console.log(content.title.raw); // Render as raw
+</script>
+<template>
+  <div>
+    <h1>
+      <!-- Render the visual editor -->
+      <content.title />
+    </h1>
+    <h1>
+      <!-- Render as string -->
+      {{ content.title }}
+    </h1>
+    <img :src="content.image.src" :alt="content.image.alt" />
+  </div>
+</template>
+```
+
+[Vue Documentation](https://intlayer.org/doc/packages/vue-intlayer/exports.md)
+
+## References
+
+- [Website](https://intlayer.org)
+- [Doc](https://intlayer.org/doc)
+
+- [Vite and Vue](https://intlayer.org/doc/environment/vite-and-vue.md)
+- [Nuxt and Vue](https://intlayer.org/doc/environment/nuxt-and-vue.md)
+- [Vue Intlayer Exports](https://intlayer.org/doc/packages/vue-intlayer/exports.md)
+- [Intlayer Exports](https://intlayer.org/doc/packages/intlayer/exports.md)

package/dist/cjs/_virtual/_rolldown/runtime.cjs

@@ -0,0 +1,29 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+exports.__toESM = __toESM;

package/dist/cjs/_virtual/_utils_asset.cjs

@@ -0,0 +1,98 @@
+const require_runtime = require('./_rolldown/runtime.cjs');
+let node_path = require("node:path");
+let node_fs = require("node:fs");
+let node_url = require("node:url");
+
+//#region \0utils:asset
+const hereDirname = () => {
+	try {
+		return (0, node_path.dirname)((0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href));
+	} catch {
+		return typeof __dirname !== "undefined" ? __dirname : process.cwd();
+	}
+};
+const findDistRoot = (startDir) => {
+	let dir = startDir;
+	for (let i = 0; i < 12; i++) {
+		if ((0, node_path.basename)(dir) === "dist") return dir;
+		const parent = (0, node_path.resolve)(dir, "..");
+		if (parent === dir) break;
+		dir = parent;
+	}
+	return null;
+};
+const normalizeFrameFile = (file) => {
+	if (!file) return null;
+	try {
+		if (file.startsWith("file://")) return (0, node_url.fileURLToPath)(file);
+	} catch {}
+	return file;
+};
+/**
+* Returns the directory of the *caller* module that invoked readAsset.
+* Prefers non-virtual frames; falls back to the first real frame.
+*/
+const getCallerDir = () => {
+	const prev = Error.prepareStackTrace;
+	try {
+		Error.prepareStackTrace = (_, structured) => structured;
+		const err = /* @__PURE__ */ new Error();
+		Error.captureStackTrace(err, getCallerDir);
+		/** @type {import('node:vm').CallSite[]} */
+		const frames = err.stack || [];
+		const isVirtualPath = (p) => p.includes(`${node_path.sep}_virtual${node_path.sep}`) || p.includes("/_virtual/");
+		for (const frame of frames) {
+			const file = normalizeFrameFile(typeof frame.getFileName === "function" ? frame.getFileName() : null);
+			if (!file) continue;
+			if (file.includes("node:internal") || file.includes(`${node_path.sep}internal${node_path.sep}modules${node_path.sep}`)) continue;
+			if (!isVirtualPath(file)) return (0, node_path.dirname)(file);
+		}
+		for (const frame of frames) {
+			const file = normalizeFrameFile(typeof frame.getFileName === "function" ? frame.getFileName() : null);
+			if (file) return (0, node_path.dirname)(file);
+		}
+	} catch {} finally {
+		Error.prepareStackTrace = prev;
+	}
+	return hereDirname();
+};
+/**
+* Read an asset copied from src/** to dist/assets/**.
+* - './' or '../' is resolved relative to the *caller module's* emitted directory.
+* - otherwise, treat as src-relative.
+*
+* @param {string} relPath - e.g. './PROMPT.md' or 'utils/AI/askDocQuestion/embeddings/<fileKey>.json'
+* @param {BufferEncoding} [encoding='utf8']
+*/
+const readAsset = (relPath, encoding = "utf8") => {
+	const here = hereDirname();
+	const distRoot = findDistRoot(here) ?? (0, node_path.resolve)(here, "..", "..", "dist");
+	const assetsRoot = (0, node_path.join)(distRoot, "assets");
+	const tried = [];
+	/**
+	* Transform dist/(esm|cjs)/... and _virtual/ prefix to clean subpath (Windows-safe)
+	*/
+	const callerSubpath = (0, node_path.relative)(distRoot, getCallerDir()).split("\\").join("/").replace(/^(?:dist\/)?(?:esm|cjs)\//, "").replace(/^_virtual\//, "");
+	if (relPath.startsWith("./") || relPath.startsWith("../")) {
+		const fromCallerAbs = (0, node_path.resolve)(assetsRoot, callerSubpath, relPath);
+		tried.push(fromCallerAbs);
+		if ((0, node_fs.existsSync)(fromCallerAbs)) return (0, node_fs.readFileSync)(fromCallerAbs, encoding);
+	}
+	const directPath = (0, node_path.join)(assetsRoot, relPath);
+	tried.push(directPath);
+	if ((0, node_fs.existsSync)(directPath)) return (0, node_fs.readFileSync)(directPath, encoding);
+	if (callerSubpath) {
+		const nested = (0, node_path.join)(assetsRoot, callerSubpath, relPath);
+		tried.push(nested);
+		if ((0, node_fs.existsSync)(nested)) return (0, node_fs.readFileSync)(nested, encoding);
+	}
+	const msg = [
+		"readAsset: file not found.",
+		"Searched:",
+		...tried.map((p) => `- ${p}`)
+	].join("\n");
+	throw new Error(msg);
+};
+
+//#endregion
+exports.readAsset = readAsset;