@intlayer/engine 9.5.6 → 9.5.8

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

@@ -51,19 +51,10 @@ export default content;
 ## Setup
 
 - [Angular](https://intlayer.org/doc/environment/angular.md)
+- [Angular 19](https://intlayer.org/doc/environment/angular/19.md)
+- [Analog](https://intlayer.org/doc/environment/analog.md)
 
-### Intlayer Provider
-
-To use Intlayer in your Angular application, you need to add the `provideIntlayer` provider to your application configuration.
-
-```typescript
-import { ApplicationConfig } from "@angular/core";
-import { provideIntlayer } from "angular-intlayer";
-
-export const appConfig: ApplicationConfig = {
-  providers: [provideIntlayer()],
-};
-```
+Register `provideIntlayer()` in the `providers` of your `ApplicationConfig` (see the [Angular guide](https://intlayer.org/doc/environment/angular.md)).
 
 ## useIntlayer Hook
 
@@ -90,70 +81,30 @@ export class MyComponent {
 }
 ```
 
-## Change language
-
-To change the language, use the `setLocale` function from the `useLocale` hook.
-
-```typescript
-import { Component } from "@angular/core";
-import { useLocale } from "angular-intlayer";
-import { Locales } from "intlayer";
-
-@Component({
-  selector: "app-locale-switcher",
-  standalone: true,
-  template: `
-    <button (click)="setLocale(Locales.FRENCH)">
-      Change Language to French
-    </button>
-  `,
-})
-export class LocaleSwitcherComponent {
-  Locales = Locales;
-  private localeCtx = useLocale();
-  setLocale = this.localeCtx.setLocale;
-}
-```
+## Compiler
 
-## Localized Link component
+The [Intlayer Compiler](https://intlayer.org/doc/compiler.md) can extract all your content keys from your components, using one CLI command (`npx intlayer extract`) or automatically at app build.
 
-Ensure your application's navigation respects the current locale by using a localized link. You can create a component or use a helper.
+## References
 
-```typescript
-import { Component, Input } from "@angular/core";
-import { RouterModule } from "@angular/router";
-import { useLocale } from "angular-intlayer";
-import { getLocalizedUrl } from "intlayer";
+- [Website](https://intlayer.org)
+- [Doc](https://intlayer.org/doc)
 
-@Component({
-  selector: "app-link",
-  standalone: true,
-  imports: [RouterModule],
-  template: `
-    <a [routerLink]="localizedHref()" [replaceUrl]="false">
-      <ng-content></ng-content>
-    </a>
-  `,
-})
-export class LinkComponent {
-  @Input() href: string = "";
+### Environments
 
-  private localeCtx = useLocale();
-  locale = this.localeCtx.locale;
+- [Angular](https://intlayer.org/doc/environment/angular.md)
+- [Angular 19](https://intlayer.org/doc/environment/angular/19.md)
+- [Analog](https://intlayer.org/doc/environment/analog.md)
 
-  localizedHref() {
-    return this.href.startsWith("http")
-      ? this.href
-      : getLocalizedUrl(this.href, this.locale());
-  }
-}
-```
+### Concepts
 
-## References
+- [Variants](https://intlayer.org/doc/concept/variants.md)
+- [Collections](https://intlayer.org/doc/concept/collections.md)
+- [Compiler](https://intlayer.org/doc/compiler.md)
+- [Formatters (number, currency, date, …)](https://intlayer.org/doc/formatters.md)
 
-- [Website](https://intlayer.org)
-- [Doc](https://intlayer.org/doc)
+### Packages
 
-- [Angular](https://intlayer.org/doc/environment/angular.md)
 - [Angular Intlayer Exports](https://intlayer.org/doc/packages/angular-intlayer/exports.md)
 - [Intlayer Exports](https://intlayer.org/doc/packages/intlayer/exports.md)
+- [angular-intlayer usePathname](https://intlayer.org/doc/packages/angular-intlayer/usePathname.md)

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

@@ -18,23 +18,57 @@ metadata:
 
 - [Astro](https://intlayer.org/doc/environment/astro.md)
 
+The `intlayer()` integration in `astro.config.ts` builds the dictionaries and adds a middleware that resolves the locale of every request into `Astro.locals.intlayer`.
+
 ## Server-side (Astro Components)
 
 ```astro
 ---
-import { getIntlayer } from "astro-intlayer";
-const content = await getIntlayer("my-dictionary-key");
+import { useIntlayer, useLocale } from "astro-intlayer";
+
+// Locale resolved by the middleware (e.g. /es/about -> 'es')
+const { locale } = useLocale();
+const content = useIntlayer("my-dictionary-key");
 ---
 <h1>{content.title}</h1>
 ```
 
-[Astro Documentation](https://intlayer.org/doc/environment/astro.md)
+## Framework Islands
+
+Islands use their framework package (`react-intlayer`, `vue-intlayer`, `svelte-intlayer`, `solid-intlayer`, `preact-intlayer`, `lit-intlayer`) and receive the server-detected locale as a prop.
+
+## Compiler
+
+The [Intlayer Compiler](https://intlayer.org/doc/compiler.md) can extract all your content keys from your components, using one CLI command (`npx intlayer extract`) or automatically at app build.
 
 ## References
 
 - [Website](https://intlayer.org)
-- [Doc](https://intlayer.org/doc/concept/cli.md)
+- [Doc](https://intlayer.org/doc)
+
+### Environments
 
 - [Astro](https://intlayer.org/doc/environment/astro.md)
+- [Astro and React](https://intlayer.org/doc/environment/astro/react.md)
+- [Astro and Vue](https://intlayer.org/doc/environment/astro/vue.md)
+- [Astro and Svelte](https://intlayer.org/doc/environment/astro/svelte.md)
+- [Astro and Solid](https://intlayer.org/doc/environment/astro/solid.md)
+- [Astro and Preact](https://intlayer.org/doc/environment/astro/preact.md)
+- [Astro and Lit](https://intlayer.org/doc/environment/astro/lit.md)
+
+### Concepts
+
+- [Variants](https://intlayer.org/doc/concept/variants.md)
+- [Collections](https://intlayer.org/doc/concept/collections.md)
+- [Compiler](https://intlayer.org/doc/compiler.md)
+- [Formatters (number, currency, date, …)](https://intlayer.org/doc/formatters.md)
+
+### Packages
+
 - [Intlayer Exports](https://intlayer.org/doc/packages/intlayer/exports.md)
 - [Astro Intlayer Exports](https://intlayer.org/doc/packages/astro-intlayer/exports.md)
+- [astro-intlayer intlayer](https://intlayer.org/doc/packages/astro-intlayer/intlayer.md)
+- [astro-intlayer onRequest](https://intlayer.org/doc/packages/astro-intlayer/onRequest.md)
+- [astro-intlayer useDictionary](https://intlayer.org/doc/packages/astro-intlayer/useDictionary.md)
+- [astro-intlayer useIntlayer](https://intlayer.org/doc/packages/astro-intlayer/useIntlayer.md)
+- [astro-intlayer useLocale](https://intlayer.org/doc/packages/astro-intlayer/useLocale.md)

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

@@ -0,0 +1,113 @@
+---
+name: intlayer-backend
+description: Integrates Intlayer internationalization with Node.js / Bun backends (Express, Fastify, Hono, NestJS, AdonisJS, Elysia, HTMX). Use when the user asks to "translate API responses", "setup server-side i18n", register the Intlayer middleware, or use "t" / "getIntlayer" in a route handler.
+metadata:
+  author: Intlayer
+  url: https://intlayer.org
+  license: Apache-2.0
+  mcp-server: "@intlayer/mcp"
+  category: productivity
+  tags: [i18n, backend, express, fastify, hono, nestjs, adonisjs, elysia]
+  documentation: https://intlayer.org/doc
+  support: contact@intlayer.org
+---
+
+# Intlayer Backend Usage
+
+## Core Philosophy
+
+Every backend integration works the same way:
+
+1.  A **middleware / plugin** (`intlayer()`) resolves the locale of each request (cookie, header, `Accept-Language`) and scopes it to that request.
+2.  **Helpers** (`t`, `getIntlayer`, `getDictionary`) read that request locale, so they are safe to call from services without threading a locale argument through every function.
+
+| Framework | Package            | Registration                                           |
+| --------- | ------------------ | ------------------------------------------------------ |
+| Express   | `express-intlayer` | `app.use(intlayer())`                                  |
+| NestJS    | `express-intlayer` | `consumer.apply(intlayer()).forRoutes("*")`            |
+| Fastify   | `fastify-intlayer` | `await fastify.register(intlayer)`                     |
+| Hono      | `hono-intlayer`    | `app.use("*", intlayer())`                             |
+| Elysia    | `elysia-intlayer`  | `.use(intlayer())`, helpers read from route `intlayer` |
+| AdonisJS  | `adonis-intlayer`  | Registered middleware (see the AdonisJS guide)         |
+
+### Declare Content
+
+**File:** `src/index.content.ts`
+
+```typescript
+import { t, type Dictionary } from "intlayer";
+
+const content = {
+  key: "index",
+  content: {
+    exampleOfContent: t({
+      en: "Example of returned content in English",
+      fr: "Exemple de contenu renvoyé en français",
+    }),
+  },
+} satisfies Dictionary;
+
+export default content;
+```
+
+## Usage
+
+Register the middleware / plugin from the table above **before** the routes that read content (see the [Express guide](https://intlayer.org/doc/environment/express.md)), then call the helpers in any handler:
+
+```typescript
+import { t, getIntlayer, getDictionary } from "express-intlayer";
+import dictionaryExample from "./index.content";
+
+app.get("/", (_req, res) => {
+  res.send(t({ en: "Hello", fr: "Bonjour" })); // Inline translation
+});
+
+app.get("/by-key", (_req, res) => {
+  res.send(getIntlayer("index").exampleOfContent); // Dictionary by key
+});
+
+app.get("/by-import", (_req, res) => {
+  res.send(getDictionary(dictionaryExample).exampleOfContent); // Imported dictionary
+});
+```
+
+The same helpers are exported by `fastify-intlayer`, `hono-intlayer` and `adonis-intlayer`. On Elysia, read them from the route context: `({ intlayer }) => intlayer!.getIntlayer("index")`.
+
+> For jobs, queues or emails (no incoming request), resolve content for the recipient's stored locale: `getIntlayer("index", user.locale)`.
+
+## References
+
+- [Website](https://intlayer.org)
+- [Doc](https://intlayer.org/doc)
+
+### Environments
+
+- [Express](https://intlayer.org/doc/environment/express.md)
+- [Fastify](https://intlayer.org/doc/environment/fastify.md)
+- [Hono](https://intlayer.org/doc/environment/hono.md)
+- [NestJS](https://intlayer.org/doc/environment/nest.md)
+- [AdonisJS](https://intlayer.org/doc/environment/adonisjs.md)
+- [Elysia](https://intlayer.org/doc/environment/elysia.md)
+- [HTMX](https://intlayer.org/doc/environment/htmx.md)
+
+### Concepts
+
+- [Variants](https://intlayer.org/doc/concept/variants.md)
+- [Collections](https://intlayer.org/doc/concept/collections.md)
+
+### Packages
+
+- [Intlayer Exports](https://intlayer.org/doc/packages/intlayer/exports.md)
+- [Express Intlayer Exports](https://intlayer.org/doc/packages/express-intlayer/exports.md)
+- [Fastify Intlayer Exports](https://intlayer.org/doc/packages/fastify-intlayer/exports.md)
+- [Hono Intlayer Exports](https://intlayer.org/doc/packages/hono-intlayer/exports.md)
+- [Adonis Intlayer Exports](https://intlayer.org/doc/packages/adonis-intlayer/exports.md)
+- [Elysia Intlayer Exports](https://intlayer.org/doc/packages/elysia-intlayer/exports.md)
+- [adonis-intlayer intlayer](https://intlayer.org/doc/packages/adonis-intlayer/intlayer.md)
+- [adonis-intlayer t](https://intlayer.org/doc/packages/adonis-intlayer/t.md)
+- [elysia-intlayer intlayer](https://intlayer.org/doc/packages/elysia-intlayer/intlayer.md)
+- [express-intlayer intlayer](https://intlayer.org/doc/packages/express-intlayer/intlayer.md)
+- [express-intlayer t](https://intlayer.org/doc/packages/express-intlayer/t.md)
+- [fastify-intlayer intlayer](https://intlayer.org/doc/packages/fastify-intlayer/intlayer.md)
+- [hono-intlayer intlayer](https://intlayer.org/doc/packages/hono-intlayer/intlayer.md)
+- [hono-intlayer t](https://intlayer.org/doc/packages/hono-intlayer/t.md)

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

@@ -33,36 +33,40 @@ npm install intlayer-cli
 | `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.          |
+| `npx intlayer upgrade`   | Upgrades every Intlayer package of the repo to latest.        |
 
 ## References
 
-### Concepts
+- [Website](https://intlayer.org)
+- [Doc](https://intlayer.org/doc)
+
+### Commands
 
-- [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)
+- [Build Dictionaries](https://intlayer.org/doc/concept/cli/build.md)
+- [Manage Configuration](https://intlayer.org/doc/concept/cli/configuration.md)
+- [Debug Intlayer Command](https://intlayer.org/doc/concept/cli/debug.md)
+- [Review Document](https://intlayer.org/doc/concept/cli/doc-review.md)
+- [Translate Document](https://intlayer.org/doc/concept/cli/doc-translate.md)
+- [Editor Commands](https://intlayer.org/doc/concept/cli/editor.md)
+- [Extract strings](https://intlayer.org/doc/concept/cli/extract.md)
+- [Fill Dictionaries](https://intlayer.org/doc/concept/cli/fill.md)
+- [CLI Overview](https://intlayer.org/doc/concept/cli.md)
+- [Init Infra](https://intlayer.org/doc/concept/cli/infra.md)
+- [Initialize Intlayer](https://intlayer.org/doc/concept/cli/init.md)
+- [List Content Declaration Files](https://intlayer.org/doc/concept/cli/list.md)
+- [List Intlayer Projects](https://intlayer.org/doc/concept/cli/list-projects.md)
+- [Live Sync Commands](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)
+- [Pull Dictionaries](https://intlayer.org/doc/concept/cli/pull.md)
+- [Push Dictionaries](https://intlayer.org/doc/concept/cli/push.md)
+- [Scan Website](https://intlayer.org/doc/concept/cli/scan.md)
+- [CLI SDK](https://intlayer.org/doc/concept/cli/sdk.md)
+- [Standalone Bundle](https://intlayer.org/doc/concept/cli/standalone.md)
+- [Test Missing Translations](https://intlayer.org/doc/concept/cli/test.md)
+- [Upgrade Intlayer Packages](https://intlayer.org/doc/concept/cli/upgrade.md)
+- [Check CLI Version](https://intlayer.org/doc/concept/cli/version.md)
+- [Watch Dictionaries](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)
+- [intlayer-cli Exports](https://intlayer.org/doc/packages/intlayer-cli/exports.md)

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

@@ -0,0 +1,87 @@
+---
+name: intlayer-compat
+description: Migrates an existing i18n library (i18next, react-i18next, next-intl, next-i18next, react-intl, vue-i18n, Lingui…) to Intlayer through compat adapters that keep the original API. Use when the user asks to "migrate from i18next / next-intl / vue-i18n", "keep useTranslation working", or adopt Intlayer without rewriting translation calls.
+metadata:
+  author: Intlayer
+  url: https://intlayer.org
+  license: Apache-2.0
+  mcp-server: "@intlayer/mcp"
+  category: productivity
+  tags: [i18n, migration, i18next, next-intl, react-intl, vue-i18n, lingui]
+  documentation: https://intlayer.org/doc
+  support: contact@intlayer.org
+---
+
+# Intlayer Compat Adapters
+
+Compat adapters expose the **exact same public API** as an existing i18n library, but serve translations from Intlayer dictionaries. Application code keeps calling `useTranslation`, `useTranslations`, `useIntl`, `$t`… with keys typed against the Intlayer dictionaries.
+
+## How it works
+
+1. Run `npx intlayer init --interactive`: it creates `intlayer.config.ts`, installs the adapter and can keep existing JSON catalogs as the source of truth via a sync plugin.
+2. Register the adapter's bundler plugin (`<adapter>/plugin`). It aliases the original imports to the adapter at build time, so no import is rewritten by hand.
+
+## Adapters
+
+| Existing library                | Adapter                   | Bundler plugin (`<adapter>/plugin`) |
+| ------------------------------- | ------------------------- | ----------------------------------- |
+| `i18next`                       | `@intlayer/i18next`       | `i18nextVitePlugin`                 |
+| `react-i18next`                 | `@intlayer/react-i18next` | `reactI18nextVitePlugin`            |
+| `next-i18next`                  | `@intlayer/next-i18next`  | `createNextI18nPlugin`              |
+| `next-intl`                     | `@intlayer/next-intl`     | `createNextIntlPlugin`              |
+| `use-intl`                      | `@intlayer/use-intl`      | `useIntlVitePlugin`                 |
+| `react-intl`                    | `@intlayer/react-intl`    | `reactIntlVitePlugin`               |
+| `vue-i18n`                      | `@intlayer/vue-i18n`      | `vueI18nVitePlugin`                 |
+| `@lingui/core`, `@lingui/react` | `@intlayer/lingui`        | `linguiVitePlugin`                  |
+
+> Lingui: keep the Lingui macro plugin (`@lingui/babel-plugin-lingui-macro` / `@lingui/swc-plugin`) running before the Intlayer compiler.
+
+> Features outside translation stay with the original library, e.g. `next-intl/navigation` (`Link`, `redirect`, `usePathname`). ICU messages (plural, select, `#`, formatted arguments) and rich formatting (`t.rich`, `<Trans>`) are resolved by Intlayer.
+
+Migration guides also exist for Nuxt I18n, NGX Translate, Transloco, Svelte I18n, Next Translate, Polyglot.js and i18n-js.
+
+## Keep Existing Catalogs: Sync Plugins
+
+To keep the current library **and** its message files, register a sync plugin in the `plugins` of `intlayer.config.ts` instead of (or alongside) an adapter. Intlayer then manages the catalogs (AI fill, CI tests, CMS) without changing the rendering runtime.
+
+| Catalog format | Package                      | Plugins                |
+| -------------- | ---------------------------- | ---------------------- |
+| JSON           | `@intlayer/sync-json-plugin` | `syncJSON`, `loadJSON` |
+| Gettext PO     | `@intlayer/sync-po-plugin`   | `syncPO`, `loadPO`     |
+
+- `sync*` reads **and writes back** the files, keeping them in sync with the dictionaries.
+- `load*` only loads the files into dictionaries (never writes back), e.g. for catalogs fetched from a remote source.
+- `syncJSON` accepts `format: 'intlayer' | 'icu' | 'i18next' | 'vue-i18n'` to match the message syntax of the existing library.
+- Current scope: plain text and translations; insertions, plurals/ICU and the visual editor are not supported yet for synced files.
+
+## After migrating
+
+Once the app runs on Intlayer, components can be moved progressively to the native API (`useIntlayer` + `.content` files) and the adapter removed.
+
+## References
+
+- [Website](https://intlayer.org)
+- [Doc](https://intlayer.org/doc)
+
+### Plugins
+
+- [Sync JSON](https://intlayer.org/doc/plugin/sync-json.md)
+- [Sync PO](https://intlayer.org/doc/plugin/sync-po.md)
+
+### Migration Guides
+
+- [Compat Adapters Overview](https://intlayer.org/doc/compatibility.md)
+- [i18next](https://intlayer.org/doc/compatibility/i18next.md)
+- [react-i18next](https://intlayer.org/doc/compatibility/react-i18next.md)
+- [next-i18next](https://intlayer.org/doc/compatibility/next-i18next.md)
+- [next-intl](https://intlayer.org/doc/compatibility/next-intl.md)
+- [React Intl](https://intlayer.org/doc/compatibility/react-intl.md)
+- [Vue I18n](https://intlayer.org/doc/compatibility/vue-i18n.md)
+- [Lingui](https://intlayer.org/doc/compatibility/lingui.md)
+- [NuxtJS I18n](https://intlayer.org/doc/compatibility/nuxtjs-i18n.md)
+- [NGX Translate](https://intlayer.org/doc/compatibility/ngx-translate.md)
+- [Transloco](https://intlayer.org/doc/compatibility/transloco.md)
+- [Svelte I18n](https://intlayer.org/doc/compatibility/svelte-i18n.md)
+- [Next Translate](https://intlayer.org/doc/compatibility/next-translate.md)
+- [Polyglot.js](https://intlayer.org/doc/compatibility/polyglot.md)
+- [i18n-js](https://intlayer.org/doc/compatibility/i18n-js.md)

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

@@ -22,11 +22,21 @@ The **Intlayer Compiler Skill** provides instructions on how to set up and use t
 
 ## Setup and Usage
 
-To set up the Intlayer compiler for your project, refer to the documentation for your framework:
+To set up the Intlayer compiler for your project (Vite, Next.js, Babel, Webpack), refer to the documentation:
 
-- [Vite + React Compiler Documentation](https://intlayer.org/doc/environment/vite-and-react/compiler)
-- [Next.js Compiler Documentation](https://intlayer.org/doc/environment/nextjs/compiler)
+- [Intlayer Compiler](https://intlayer.org/doc/compiler.md)
+
+- **Vite** (React, Preact, Solid, Lit, Vue, Svelte, Astro): bundled into the `intlayer()` plugin of `vite-intlayer`.
+- **Next.js**: install `@intlayer/babel`; `withIntlayer` registers the extractor loader on Turbopack and webpack.
+- **Babel / Webpack**: add `intlayerExtractBabelPlugin` from `@intlayer/babel`.
+- `.vue` and `.svelte` files additionally require `@intlayer/vue-compiler` / `@intlayer/svelte-compiler`.
+- Not using a supported bundler? Run `npx intlayer extract` instead.
 
 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).
+For more information, visit the [Intlayer Compiler Architecture Documentation](https://intlayer.org/doc/compiler.md).
+
+### Packages
+
+- [vite-intlayer intlayerCompiler](https://intlayer.org/doc/packages/vite-intlayer/intlayerCompiler.md)
+- [@intlayer/babel Exports](https://intlayer.org/doc/packages/@intlayer/babel/export.md)

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

@@ -18,7 +18,7 @@ Configure Intlayer project settings and environment variables. Check these files
 
 Supported configuration files:
 
-- `intlayer.config.{ts|js|json|json5|jsonc|cjs|mjs}`
+- `intlayer.config.{ts|js|cjs|mjs|json|json5|jsonc}`
 - `.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.
@@ -49,6 +49,20 @@ Manages how and where your translation files are handled.
 
 Settings for the visual workflow and internal plumbing.
 
+## Retrieving configuration into your app
+
+```ts
+import { defaultLocale, getConfiguration, locales } from "intlayer";
+
+console.log(locales); // ['en', 'fr', ...]
+console.log(defaultLocale); // 'en'
+
+// Other sections: internationalization, routing, editor, content, log
+const { routing } = getConfiguration();
+
+console.log(routing.mode); // 'prefix-no-default'
+```
+
 ## References
 
 - [Website](https://intlayer.org)
@@ -57,7 +71,3 @@ Settings for the visual workflow and internal plumbing.
 ### 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

@@ -34,12 +34,12 @@ const content = t({
 
 Find locales to declare in config file. Supported configuration files:
 
-- `intlayer.config.{ts|js|json|json5|jsonc|cjs|mjs}`
+- `intlayer.config.{ts|js|cjs|mjs|json|json5|jsonc|md|mdx|yml|yaml}`
 - `.intlayerrc`
 
 ## Enumeration (`enu`)
 
-Map content to specific keys, numbers, or ranges (useful for pluralization).
+Map content to custom numeric values or ranges (`<5`, `>=10`). For grammatical plural forms, use `plural` instead.
 
 [Doc](https://intlayer.org/doc/concept/content/enumeration.md)
 
@@ -54,6 +54,33 @@ const carCount = enu({
 });
 ```
 
+## Plural (`plural`)
+
+Select the grammatical plural form from a count, using the CLDR categories (`zero`, `one`, `two`, `few`, `many`, `other`) of the active locale. `other` is required and used as fallback.
+
+[Doc](https://intlayer.org/doc/concept/content/plural.md)
+
+```typescript
+import { plural, t } from "intlayer";
+
+const totalOpenings = t({
+  en: plural({
+    one: "{{count}} opening",
+    other: "{{count}} openings",
+  }),
+  ru: plural({
+    one: "{{count}} вакансия",
+    few: "{{count}} вакансии",
+    many: "{{count}} вакансий",
+    other: "{{count}} вакансий",
+  }),
+});
+
+// Usage: totalOpenings(3) or totalOpenings({ count: 3, name: "Alice" })
+```
+
+> `plural` must be the leaf: wrap it in `t()`, never put `t()` inside `plural()`.
+
 ## Condition (`cond`)
 
 Define content based on a boolean condition.
@@ -165,7 +192,37 @@ const greeting = gender({
 });
 ```
 
-### Example Directory Structure (react)
+## Select (`select`)
+
+Map any string value (status, plan, role…) to content: the equivalent of an ICU `select` or a `switch`. Without `fallback`, only the declared cases are type-accepted.
+
+[Doc](https://intlayer.org/doc/concept/content/select.md)
+
+```typescript
+import { select } from "intlayer";
+
+const publishStatus = select({
+  draft: "This post is a draft",
+  published: "This post is live",
+  fallback: "Unknown status", // Optional
+});
+
+// Usage: publishStatus(post.status)
+```
+
+> Prefer `select()` over indexing a plain object (`content[status]`): dynamic property access prevents the compiler from pruning and minifying the content.
+
+### Choosing a node by discriminant
+
+| Discriminant             | Node       |
+| ------------------------ | ---------- |
+| A count (grammar)        | `plural()` |
+| A number / custom ranges | `enu()`    |
+| A boolean                | `cond()`   |
+| A gender                 | `gender()` |
+| Any other string value   | `select()` |
+
+## Example Directory Structure (react)
 
 ```
 src/
@@ -357,14 +414,14 @@ Core Metadata
 
 Content & Localization
 
-- locale: Specifies the language of the content for (per-locale file)[https://intlayer.org/doc/concept/per-locale-file.md]
+- locale: Specifies the language of the content for a [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.
+- importMode: Defines how content is loaded (`static`, `dynamic`, or `fetch`). 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
 
@@ -373,5 +430,22 @@ Behaviorals Settings
 - [Website](https://intlayer.org)
 - [Doc](https://intlayer.org/doc)
 
-- [Content Overview](https://intlayer.org/doc/concept/content.md)
+### Content Nodes
+
+- [Content File](https://intlayer.org/doc/concept/content.md)
+- [Translation](https://intlayer.org/doc/concept/content/translation.md)
+- [Enumeration](https://intlayer.org/doc/concept/content/enumeration.md)
+- [Plural](https://intlayer.org/doc/concept/content/plural.md)
+- [Condition](https://intlayer.org/doc/concept/content/condition.md)
+- [Gender](https://intlayer.org/doc/concept/content/gender.md)
+- [Select](https://intlayer.org/doc/concept/content/select.md)
+- [Insertion](https://intlayer.org/doc/concept/content/insertion.md)
+- [Markdown](https://intlayer.org/doc/concept/content/markdown.md)
+- [HTML](https://intlayer.org/doc/concept/content/html.md)
+- [Nesting](https://intlayer.org/doc/concept/content/nesting.md)
+- [File](https://intlayer.org/doc/concept/content/file.md)
+- [Function Fetching](https://intlayer.org/doc/concept/content/function-fetching.md)
+
+### Packages
+
 - [Exports intlayer package](https://intlayer.org/doc/packages/intlayer/exports.md)