@intlayer/engine 9.0.0-canary.12

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

@@ -0,0 +1,68 @@
+---
+name: intlayer-cli
+description: Manages Intlayer dictionaries and configuration via the Command Line Interface. Use when the user asks to "audit translations", "build dictionaries", "sync content", or run "intlayer" commands.
+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 CLI
+
+The `intlayer-cli` package provides a set of commands to manage Intlayer dictionaries and configuration.
+
+## Installation
+
+```bash
+npm install intlayer-cli
+```
+
+## Main CLI Commands
+
+| Command                  | Description                                                   |
+| ------------------------ | ------------------------------------------------------------- |
+| `npx intlayer build`     | Builds the Intlayer dictionaries.                             |
+| `npx intlayer audit`     | Audits the dictionaries for missing translations.             |
+| `npx intlayer live-sync` | Synchronizes dictionaries in real-time.                       |
+| `npx intlayer pull`      | Pulls dictionaries from a remote source (e.g., Intlayer CMS). |
+| `npx intlayer push`      | Pushes dictionaries to a remote source.                       |
+| `npx intlayer test`      | Runs tests on dictionaries.                                   |
+| `npx intlayer extract`   | Extract content from component to create dictionary.          |
+
+## References
+
+### Concepts
+
+- [Build](https://intlayer.org/doc/concept/cli/build.md)
+- [CI](https://intlayer.org/doc/concept/cli.md)
+- [Configuration](https://intlayer.org/doc/concept/cli/configuration.md)
+- [Debug](https://intlayer.org/doc/concept/cli/debug.md)
+- [Doc Review](https://intlayer.org/doc/concept/cli/doc-review.md)
+- [Doc Translate](https://intlayer.org/doc/concept/cli/doc-translate.md)
+- [Editor](https://intlayer.org/doc/concept/cli/editor.md)
+- [Fill](https://intlayer.org/doc/concept/cli/fill.md)
+- [Init](https://intlayer.org/doc/concept/cli/init.md)
+- [List](https://intlayer.org/doc/concept/cli/list.md)
+- [List Projects](https://intlayer.org/doc/concept/cli/list-projects.md)
+- [Live](https://intlayer.org/doc/concept/cli/live.md)
+- [Login](https://intlayer.org/doc/concept/cli/login.md)
+- [Pull](https://intlayer.org/doc/concept/cli/pull.md)
+- [Push](https://intlayer.org/doc/concept/cli/push.md)
+- [SDK](https://intlayer.org/doc/concept/cli/sdk.md)
+- [Test](https://intlayer.org/doc/concept/cli/test.md)
+- [Extract](https://intlayer.org/doc/concept/cli/extract.md)
+- [Version](https://intlayer.org/doc/concept/cli/version.md)
+- [Watch](https://intlayer.org/doc/concept/cli/watch.md)
+
+### Packages
+
+- [Website](https://intlayer.org)
+- [Doc](https://intlayer.org/doc/concept/cli.md)
+
+- [Intlayer CLI](https://intlayer.org/doc/packages/intlayer-cli/exports.md)
+- [Intlayer CLI Exports](https://intlayer.org/doc/packages/intlayer-cli/exports.md)

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

@@ -0,0 +1,32 @@
+---
+name: intlayer-compiler
+description: Intlayer Compiler setup and usage. Configures automatic content extraction for your components without the need to define .content files manually.
+metadata:
+  author: Intlayer
+  url: https://intlayer.org
+  license: Apache-2.0
+  category: productivity
+  tags: [i18n, compiler]
+  documentation: https://intlayer.org/doc/compiler
+  support: contact@intlayer.org
+---
+
+# Intlayer Compiler Skill
+
+The **Intlayer Compiler Skill** provides instructions on how to set up and use the Intlayer compiler to automatically extract content from your application.
+
+## Key Features
+
+- **Automatic Content Extraction**: All content will be extracted automatically from your components.
+- **No Manual Content Files**: Alleviates the need to manually create `.content` files.
+
+## Setup and Usage
+
+To set up the Intlayer compiler for your project, refer to the documentation for your framework:
+
+- [Vite + React Compiler Documentation](https://intlayer.org/doc/environment/vite-and-react/compiler)
+- [Next.js Compiler Documentation](https://intlayer.org/doc/environment/nextjs/compiler)
+
+Once the compiler plugins are properly configured, simply write your translatable strings inline according to the framework's specifics, and the Intlayer compiler will automatically generate the dictionaries.
+
+For more information, visit the [Intlayer Compiler Architecture Documentation](https://intlayer.org/doc/compiler).

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

@@ -0,0 +1,63 @@
+---
+name: intlayer-config
+description: Configures Intlayer project settings and environment variables. Use when the user asks to "setup intlayer.config", "configure locales", or "customize Intlayer settings".
+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 Configuration
+
+Configure Intlayer project settings and environment variables. Check these files to identify which locales are declared for the application, which helps in defining the appropriate content.
+
+Supported configuration files:
+
+- `intlayer.config.{ts|js|json|json5|jsonc|cjs|mjs}`
+- `.intlayerrc`
+
+It acts as the central brain for your application's internationalization strategy. It is divided into several specialized sections that control everything from language support to AI-powered translations.
+
+### Internationalization
+
+This section defines your language footprint.
+
+- **Locales**: Define which languages you support (e.g., English, French, Spanish).
+- **Default Locale**: Set the fallback language if a user's preference isn't found.
+
+### Routing & middleware
+
+Controls how users navigate between different languages.
+
+### AI & Automation
+
+Intlayer integrates with major AI providers (OpenAI, Anthropic, Gemini, etc.) to automate your workflow.
+
+### Content & Dictionaries
+
+Manages how and where your translation files are handled.
+
+- **Import Mode**: Choose between **Static** (faster performance), **Dynamic** (lazy loading), or **Fetch** (live updates from a CMS).
+- **Auto-Transformation**: Automatically convert Markdown or HTML strings into processed components.
+
+### Editor & System
+
+Settings for the visual workflow and internal plumbing.
+
+## References
+
+- [Website](https://intlayer.org)
+- [Doc](https://intlayer.org/doc)
+
+### Concepts
+
+- [Configuration](https://intlayer.org/doc/concept/configuration.md)
+
+### Packages
+
+- [Intlayer getConfiguration](https://intlayer.org/doc/packages/intlayer/getConfiguration.md)

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

@@ -0,0 +1,377 @@
+---
+name: intlayer-content
+description: Define rich content structures using Intlayer content nodes. Use when the user asks to "create translations", "handle pluralization", "use markdown in content", or implement "conditional 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 Content Nodes
+
+Define rich and dynamic content using Intlayer functions. Use the reference below for each node type.
+
+## Translation (`t`)
+
+Define multilingual content mapped to locales.
+
+[Doc](https://intlayer.org/doc/concept/content/translation.md)
+
+```typescript
+import { t } from "intlayer";
+
+const content = t({
+  en: "Hello",
+  fr: "Bonjour",
+  es: "Hola",
+});
+```
+
+Find locales to declare in config file. Supported configuration files:
+
+- `intlayer.config.{ts|js|json|json5|jsonc|cjs|mjs}`
+- `.intlayerrc`
+
+## Enumeration (`enu`)
+
+Map content to specific keys, numbers, or ranges (useful for pluralization).
+
+[Doc](https://intlayer.org/doc/concept/content/enumeration.md)
+
+```typescript
+import { enu } from "intlayer";
+
+const carCount = enu({
+  "0": "No cars",
+  "1": "One car",
+  ">1": "Multiple cars",
+  fallback: "Unknown amount",
+});
+```
+
+## Condition (`cond`)
+
+Define content based on a boolean condition.
+
+[Doc](https://intlayer.org/doc/concept/content/condition.md)
+
+```typescript
+import { cond } from "intlayer";
+
+const isLoggedIn = cond({
+  true: "Welcome back!",
+  false: "Please log in",
+  fallback: "Status unknown", // Optional
+});
+```
+
+## Markdown (`md`)
+
+Define rich text using Markdown syntax.
+
+[Doc](https://intlayer.org/doc/concept/content/markdown.md)
+
+```typescript
+import { md } from "intlayer";
+
+const article = md("# Title\n\nSome **bold** text.");
+```
+
+## HTML (`html`)
+
+Define HTML content, optionally with custom components.
+
+[Doc](https://intlayer.org/doc/concept/content/html.md)
+
+```typescript
+import { html } from "intlayer";
+
+const richText = html("<p>Hello <strong>World</strong></p>");
+```
+
+## Nesting (`nest`)
+
+Reuse content from another dictionary.
+
+[Doc](https://intlayer.org/doc/concept/content/nesting.md)
+
+```typescript
+import { nest } from "intlayer";
+
+// Reference entire dictionary
+const fullRef = nest("other_dictionary_key");
+
+// Reference specific path
+const partialRef = nest("other_dictionary_key", "path.to.value");
+```
+
+## Function Fetching
+
+Execute logic to generate content (synchronous or asynchronous).
+
+[Doc](https://intlayer.org/doc/concept/content/function-fetching.md)
+
+```typescript
+const computed = () => `Current time: ${new Date().toISOString()}`;
+
+const fetched = async () => {
+  const data = await fetch("/api/data").then((res) => res.json());
+  return data.message;
+};
+```
+
+## Insertion (`insert`)
+
+Define dynamic content with variables.
+
+[Doc](https://intlayer.org/doc/concept/content/insertion.md)
+
+```typescript
+import { insert } from "intlayer";
+
+const welcome = insert("Hello {{name}}!");
+```
+
+## File (`file`)
+
+Reference external files as content.
+
+[Doc](https://intlayer.org/doc/concept/content/file.md)
+
+```typescript
+import { file } from "intlayer";
+
+const myFile = file("./path/to/file.txt");
+```
+
+## Gender (`gender`)
+
+Define content based on gender ('male', 'female', etc.).
+
+[Doc](https://intlayer.org/doc/concept/content/gender.md)
+
+```typescript
+import { gender } from "intlayer";
+
+const greeting = gender({
+  male: "Welcome sir",
+  female: "Welcome madam",
+  fallback: "Welcome",
+});
+```
+
+### Example Directory Structure (react)
+
+```
+src/
+├── components/
+│   ├── MyComponent/
+│   │   ├── index.content.ts          # Content declaration
+│   │   └── index.tsx                 # Component
+│   ├── myOtherComponent.content.ts   # Content declaration
+│   └── MyOtherComponent.tsx          # Component
+```
+
+### Content Templates
+
+_TypeScript (.content.ts)_
+
+```typescript
+import { t, type Dictionary } from "intlayer";
+
+const content = {
+  key: "my-component-key",
+  content: {
+    title: "...",
+  },
+} satisfies Dictionary;
+
+export default content;
+```
+
+_TypeScript with React (.content.tsx)_
+
+```tsx
+import { t, type Dictionary } from "intlayer";
+import { ReactNode } from "react";
+
+const content = {
+  key: "my-component-key",
+  content: {
+    title: <>My React Node</>,
+  },
+} satisfies Dictionary;
+
+export default content;
+```
+
+```json
+{
+  "key": "my-component-key",
+  "content": {
+    "title": "..."
+  }
+}
+```
+
+```javascript
+import { t } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} **/
+const content = {
+  key: "my-component-key",
+  content: {
+    title: "...",
+  },
+};
+
+export default content;
+```
+
+## Content declaration combination
+
+Nodes can be imbricated for complex logic.
+
+```tsx
+import {
+  cond,
+  enu,
+  file,
+  gender,
+  insert,
+  html,
+  md,
+  nest,
+  t,
+  type Dictionary,
+} from "intlayer";
+
+const content = {
+  key: "test",
+  title: "Test component content",
+  description:
+    "Content declarations for the Test component, including examples of plurals, conditions, gender-specific messages, dynamic insertions, markdown, file-based content and nested dictionaries used for demonstration and testing purposes.",
+  content: {
+    baseContent: "Intlayer", // Content that no need to be i18n
+    welcomeMessage: t({
+      en: "Welcome to our application",
+      "en-GB": "Welcome to our application",
+      fr: "Bienvenue dans notre application",
+      es: "Bienvenido a nuestra aplicación",
+      // ... All other locales set in intlayer config file
+    }),
+    numberOfCar: enu({
+      // Check all conditions in other
+      "<-1": "Less than minus one car",
+      "-1": "Minus one car",
+      "0": "No cars",
+      "1": "One car",
+      ">19": "Many cars",
+      ">5": "Some cars", // Will never will triggered, because >5 is included between 1 and >19
+      fallback: "Fallback value", // Optional but avoid undefined type
+    }),
+    myCondition: cond({
+      true: "my content when it's true",
+      false: "my content when it's false",
+      fallback: "my content when the condition fails", // Optional but avoid undefined type
+    }),
+    myGender: gender({
+      male: "my content for male users",
+      female: "my content for female users",
+      fallback: "my content when gender is not specified", // Optional but avoid undefined type
+    }),
+    myInsertion: insert(
+      "Hello, my name is {{name}} and I am {{age}} years old!"
+    ),
+    myMultilingualInsertion: insert(
+      t({
+        ar: "مرحبا, اسمي {{name}} وأنا {{age}} سنة!",
+        de: "Hallo, mein Name ist {{name}} und ich bin {{age}} Jahre alt!",
+        en: "Hello, my name is {{name}} and I am {{age}} years old!",
+        "en-GB": "Hello, my name is {{name}} and I am {{age}} years old!",
+      })
+    ),
+    myTextFile: file("./test.txt"), // File helps to know where is located the file
+    subContent: {
+      contentNumber: 0,
+      contentString: "string",
+    },
+    fullNested: nest("code"),
+    // References a specific nested value:
+    partialNested: nest("code", "title"),
+    myMarkdown: md("## My title \n\nLorem Ipsum"),
+    myMarkdownFile: md(file("./test.md")),
+    multilingualMarkdown: t({
+      en: md("## test en"),
+      fr: md("## test fr"),
+      es: md("## test es"),
+      "en-GB": md("## test en-GB"),
+    }),
+    myHTML: html("<h2>My title</h2><p>Lorem Ipsum</p>"),
+    myHTMLFile: html(file("./test.html")),
+
+    arrayContent: ["string", "string2", "string3"],
+    arrayOfObject: [
+      {
+        name: "item1",
+        description: "description1",
+      },
+      {
+        name: "item2",
+        description: "description2",
+      },
+    ],
+    objectOfArray: {
+      array: ["item1", "item2", "item3"],
+      object: {
+        name: "object name",
+        description: "object description",
+      },
+    },
+  },
+  tags: ["test", "test page"],
+} satisfies Dictionary;
+
+export default content;
+```
+
+## Type validation of dictionary
+
+```ts
+Dictionary<{ title: string; description?: string }>; // Generic describing content type for formatted data (metadata, etc)
+```
+
+## Key Dictionary Fields for AI Management
+
+Core Metadata
+
+- key: The identifier for the dictionary (e.g., `about-page-meta`). AI can ensure consistent naming conventions.
+- title: A human-readable name for identification in the CMS or editor.
+- description: Provides context for the dictionary. AI uses this to understand the purpose and generate better translations or content.
+- tags: Categorization strings (e.g., `metadata`, `SEO`) to help organize and filter dictionaries.
+
+Content & Localization
+
+- locale: Specifies the language of the content for (per-locale file)[https://intlayer.org/doc/concept/per-locale-file.md]
+- contentAutoTransformation: A toggle to automatically convert raw strings into specialized formats like Markdown, HTML, or Insertions (variables).
+- fill: An instruction indicating whether the dictionary should be automatically populated by AI/automation tools.
+
+Behaviorals Settings
+
+- priority: A numeric value used to resolve conflicts during merge of dictionaries under a same key.
+- importMode: Defines how content is loaded (`static`, `dynamic`, or `live`). AI can recommend the best mode based on performance needs.
+- location: Controls CMS synchronization (`hybrid`, `remote`, `local`). AI can manage where the source of truth resides.
+- schema: string that use zod schema declared in config file to validate data
+
+## References
+
+- [Website](https://intlayer.org)
+- [Doc](https://intlayer.org/doc)
+
+- [Content Overview](https://intlayer.org/doc/concept/content.md)
+- [Exports intlayer package](https://intlayer.org/doc/packages/intlayer/exports.md)

package/dist/assets/installSkills/skills/next-js.md

@@ -0,0 +1,130 @@
+---
+name: intlayer-next-js
+description: Integrates Intlayer internationalization with Next.js App Router and Pages Router. Use when the user asks to "setup Next.js i18n", use "useIntlayer" in Server Components, or handle client-side translations in Next.js.
+metadata:
+  author: Intlayer
+  url: https://intlayer.org
+  license: Apache-2.0
+  mcp-server: "@intlayer/mcp"
+  category: productivity
+  tags: [i18n, nextjs]
+  documentation: https://intlayer.org/doc
+  support: contact@intlayer.org
+---
+
+# Intlayer Next.js 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 Next.js 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 Next.js component (Server or Client) 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",
+    }),
+  },
+} satisfies Dictionary;
+
+export default content;
+```
+
+## Setup
+
+- [Next.js](https://intlayer.org/doc/environment/nextjs.md)
+- [Next.js 14](https://intlayer.org/doc/environment/nextjs/14.md)
+- [Next.js 15](https://intlayer.org/doc/environment/nextjs/15.md)
+- [No Locale Path](https://intlayer.org/doc/environment/nextjs/no-locale-path.md)
+- [Page Router](https://intlayer.org/doc/environment/nextjs/next-with-page-router.md)
+
+## Server Components
+
+To use Intlayer in Server Components, use `IntlayerServerProvider` to provide the locale and `useIntlayer` from `next-intlayer/server`.
+
+```tsx
+import { IntlayerServerProvider, useIntlayer } from "next-intlayer/server";
+
+const MyServerComponent = () => {
+  const content = useIntlayer("my-component");
+  return (
+    <div>
+      <h1>{content.text}</h1>
+    </div>
+  );
+};
+
+const Page = async ({ params }) => {
+  const { locale } = await params;
+  return (
+    <IntlayerServerProvider locale={locale}>
+      <MyServerComponent />
+    </IntlayerServerProvider>
+  );
+};
+
+export default Page;
+```
+
+## Client Components
+
+For Client Components, add the `"use client"` directive and use `useIntlayer` from `next-intlayer`. Ensure the component is wrapped in an `IntlayerClientProvider`.
+
+```tsx
+"use client";
+
+import { useIntlayer } from "next-intlayer";
+
+export const MyClientComponent = () => {
+  const content = useIntlayer("my-component");
+
+  return (
+    <div>
+      <h1>{content.text}</h1>
+    </div>
+  );
+};
+```
+
+[Next.js package Documentation](https://intlayer.org/doc/packages/next-intlayer/exports.md)
+
+## References
+
+- [Website](https://intlayer.org)
+- [Doc](https://intlayer.org/doc)
+
+### Environments
+
+- [Next.js](https://intlayer.org/doc/environment/nextjs.md)
+- [Next.js 14](https://intlayer.org/doc/environment/nextjs/14.md)
+- [Next.js 15](https://intlayer.org/doc/environment/nextjs/15.md)
+- [Next.js No Locale Path](https://intlayer.org/doc/environment/nextjs/no-locale-path.md)
+- [Next.js with Page Router](https://intlayer.org/doc/environment/nextjs/next-with-page-router.md)
+
+### Packages
+
+- [Intlayer Exports](https://intlayer.org/doc/packages/intlayer/exports.md)
+- [Next Intlayer Exports](https://intlayer.org/doc/packages/next-intlayer/exports.md)
+- [Next Intlayer Middleware](https://intlayer.org/doc/packages/next-intlayer/intlayerMiddleware.md)
+- [Next Intlayer T](https://intlayer.org/doc/packages/next-intlayer/t.md)
+- [Next Intlayer useDictionary](https://intlayer.org/doc/packages/next-intlayer/useDictionary.md)
+- [Next Intlayer useIntlayer](https://intlayer.org/doc/packages/next-intlayer/useIntlayer.md)
+- [Next Intlayer useLocale](https://intlayer.org/doc/packages/next-intlayer/useLocale.md)