@intlayer/chokidar 8.1.1 → 8.1.2

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

@@ -1,49 +1,156 @@
 ---
-name: Angular
-description: Angular-specific syntax and Injectable Function usage
+name: intlayer-angular
+description: Integrates Intlayer internationalization with Angular applications. Use when the user asks to "setup Angular i18n", create a new translated component, use the "useIntlayer" composable, or configure providers.
+metadata:
+  author: Intlayer
+  url: https://intlayer.org
+  license: Apache-2.0
+  mcp-server: "@intlayer/mcp"
+  category: productivity
+  tags: [i18n, angular]
+  documentation: https://intlayer.org/doc
+  support: contact@intlayer.org
 ---
 
 # Intlayer Angular 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 Angular components that use them.
+
+## Workflow
+
+To create a translated component, you need two files:
+
+1.  **Declaration:** A content file (e.g., `my-component.content.ts`) defining the dictionary.
+2.  **Implementation:** An Angular component (e.g., `my-component.component.ts`) using the `useIntlayer` signal.
+
+### 1. Declare Content
+
+Create a content file using `t()` for translations.
+**File:** `src/app/my-component/my-component.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
 
 - [Angular](https://intlayer.org/doc/environment/angular.md)
 
-## useIntlayer Composable
+### 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()],
+};
+```
+
+## useIntlayer Hook
+
+In Angular, `useIntlayer` returns a **Signal**. You must call it as a function to access the value.
 
 ```typescript
 import { Component } from "@angular/core";
-import { useIntlayer, ContentSelectorWrapperComponent } from "angular-intlayer";
+import { useIntlayer } from "angular-intlayer";
 
 @Component({
-  selector: "app-example",
+  selector: "app-my-component",
   standalone: true,
-  imports: [ContentSelectorWrapperComponent],
   template: `
     <div>
       <h1>
-        <!-- Render the visual editor -->
-        <app-content-selector-wrapper
-          [dictionaryKey]="content().title.dictionaryKey"
-          [keyPath]="content().title.keyPath"
-        >
-          {{ content().title }}
-        </app-content-selector-wrapper>
+        {{ content().text }}
       </h1>
-      <h1>
-        <!-- Render as string -->
-        {{ content().title }}
-      </h1>
-      <img
-        [src]="content().image.src.value"
-        [alt]="content().image.alt.value"
-      />
+      <img [src]="content().text.value" [alt]="content().text.value" />
     </div>
   `,
 })
-export class ExampleComponent {
-  content = useIntlayer("my-dictionary-key");
+export class MyComponent {
+  content = useIntlayer("my-component");
+}
+```
+
+## 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;
 }
 ```
 
-[Angular Documentation](https://intlayer.org/doc/packages/angular-intlayer.md)
+## Localized Link component
+
+Ensure your application's navigation respects the current locale by using a localized link. You can create a component or use a helper.
+
+```typescript
+import { Component, Input } from "@angular/core";
+import { RouterModule } from "@angular/router";
+import { useLocale } from "angular-intlayer";
+import { getLocalizedUrl } from "intlayer";
+
+@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 = "";
+
+  private localeCtx = useLocale();
+  locale = this.localeCtx.locale;
+
+  localizedHref() {
+    return this.href.startsWith("http")
+      ? this.href
+      : getLocalizedUrl(this.href, this.locale());
+  }
+}
+```
+
+## References
+
+- [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)

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

@@ -1,6 +1,15 @@
 ---
-name: Astro
-description: Astro-specific usage and getIntlayer
+name: intlayer-astro
+description: Integrates Intlayer internationalization with Astro applications. Use when the user asks to "setup Astro i18n", use "getIntlayer" in Astro components, or manage server-side content in Astro.
+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 Astro Usage
@@ -20,3 +29,9 @@ const content = await getIntlayer("my-dictionary-key");
 ```
 
 [Astro Documentation](https://intlayer.org/doc/packages/astro-intlayer.md)
+
+## References
+
+- [Astro](https://intlayer.org/doc/environment/astro.md)
+- [Intlayer Exports](https://intlayer.org/doc/packages/intlayer/exports.md)
+- [Astro Intlayer Exports](https://intlayer.org/doc/packages/astro-intlayer/exports.md)

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

@@ -1,6 +1,15 @@
 ---
-name: CLI
-description: Intlayer CLI commands and usage
+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
@@ -13,7 +22,7 @@ The `intlayer-cli` package provides a set of commands to manage Intlayer diction
 npm install intlayer-cli
 ```
 
-## CLI Commands
+## Main CLI Commands
 
 | Command                  | Description                                                   |
 | ------------------------ | ------------------------------------------------------------- |
@@ -25,4 +34,33 @@ npm install intlayer-cli
 | `npx intlayer test`      | Runs tests on dictionaries.                                   |
 | `npx intlayer transform` | Transforms dictionaries between formats.                      |
 
-[CLI Documentation](https://intlayer.org/doc/packages/intlayer-cli.md)
+## References
+
+### Concepts
+
+- [Build](https://intlayer.org/doc/concept/cli/build.md)
+- [CI](https://intlayer.org/doc/concept/cli/ci.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)
+- [Overview](https://intlayer.org/doc/concept/cli/overview.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)
+- [Transform](https://intlayer.org/doc/concept/cli/transform.md)
+- [Version](https://intlayer.org/doc/concept/cli/version.md)
+- [Watch](https://intlayer.org/doc/concept/cli/watch.md)
+
+### Packages
+
+- [Intlayer CLI](https://intlayer.org/doc/packages/intlayer-cli.md)
+- [Intlayer CLI Exports](https://intlayer.org/doc/packages/intlayer-cli/exports.md)

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

@@ -1,10 +1,60 @@
 ---
-name: Config
-description: Intlayer configuration documentation
+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
 
-Understand how to configure Intlayer:
+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
+
+### 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

@@ -1,11 +1,20 @@
 ---
-name: Content
-description: Reference for all Intlayer content node types (t, enu, etc.)
+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
 
-Intlayer provides various functions to define rich and dynamic content. Below is a reference for each node type.
+Define rich and dynamic content using Intlayer functions. Use the reference below for each node type.
 
 ## Translation (`t`)
 
@@ -23,6 +32,11 @@ const content = t({
 });
 ```
 
+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).
@@ -111,6 +125,30 @@ const fetched = async () => {
 };
 ```
 
+## 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.).
@@ -127,6 +165,210 @@ const greeting = gender({
 });
 ```
 
----
+### 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
 
-[Content Overview](https://intlayer.org/doc/concept/content.md)
+- [Content Overview](https://intlayer.org/doc/concept/content.md)
+- [Exports intlayer package](https://intlayer.org/doc/packages/intlayer/exports.md)