@intlayer/engine 9.5.6 → 9.5.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. package/dist/assets/installSkills/skills/angular.md +19 -68
  2. package/dist/assets/installSkills/skills/astro.md +38 -4
  3. package/dist/assets/installSkills/skills/backend.md +113 -0
  4. package/dist/assets/installSkills/skills/cli.md +29 -25
  5. package/dist/assets/installSkills/skills/compat.md +87 -0
  6. package/dist/assets/installSkills/skills/compiler.md +14 -4
  7. package/dist/assets/installSkills/skills/config.md +15 -5
  8. package/dist/assets/installSkills/skills/content.md +80 -6
  9. package/dist/assets/installSkills/skills/dev-tools.md +82 -0
  10. package/dist/assets/installSkills/skills/lit.md +115 -0
  11. package/dist/assets/installSkills/skills/markdown.md +96 -0
  12. package/dist/assets/installSkills/skills/next-js.md +21 -38
  13. package/dist/assets/installSkills/skills/preact.md +18 -0
  14. package/dist/assets/installSkills/skills/react.md +21 -4
  15. package/dist/assets/installSkills/skills/remix.md +95 -0
  16. package/dist/assets/installSkills/skills/remote-content.md +1 -1
  17. package/dist/assets/installSkills/skills/solid.md +21 -1
  18. package/dist/assets/installSkills/skills/svelte.md +22 -1
  19. package/dist/assets/installSkills/skills/usage.md +28 -0
  20. package/dist/assets/installSkills/skills/vanilla.md +108 -0
  21. package/dist/assets/installSkills/skills/vue.md +22 -0
  22. package/dist/cjs/cli.cjs +2 -0
  23. package/dist/cjs/init/index.cjs +305 -300
  24. package/dist/cjs/init/index.cjs.map +1 -1
  25. package/dist/cjs/init/upgradeIntlayerPackages.cjs +60 -0
  26. package/dist/cjs/init/upgradeIntlayerPackages.cjs.map +1 -0
  27. package/dist/cjs/init/utils/index.cjs +13 -4
  28. package/dist/cjs/init/utils/intlayerDependencies.cjs +119 -0
  29. package/dist/cjs/init/utils/intlayerDependencies.cjs.map +1 -0
  30. package/dist/cjs/init/utils/packageManager.cjs +145 -94
  31. package/dist/cjs/init/utils/packageManager.cjs.map +1 -1
  32. package/dist/cjs/installSkills/index.cjs +110 -19
  33. package/dist/cjs/installSkills/index.cjs.map +1 -1
  34. package/dist/cjs/utils/runOnce.cjs +66 -15
  35. package/dist/cjs/utils/runOnce.cjs.map +1 -1
  36. package/dist/esm/cli.mjs +2 -1
  37. package/dist/esm/init/index.mjs +306 -301
  38. package/dist/esm/init/index.mjs.map +1 -1
  39. package/dist/esm/init/upgradeIntlayerPackages.mjs +57 -0
  40. package/dist/esm/init/upgradeIntlayerPackages.mjs.map +1 -0
  41. package/dist/esm/init/utils/index.mjs +3 -2
  42. package/dist/esm/init/utils/intlayerDependencies.mjs +110 -0
  43. package/dist/esm/init/utils/intlayerDependencies.mjs.map +1 -0
  44. package/dist/esm/init/utils/packageManager.mjs +143 -93
  45. package/dist/esm/init/utils/packageManager.mjs.map +1 -1
  46. package/dist/esm/installSkills/index.mjs +110 -19
  47. package/dist/esm/installSkills/index.mjs.map +1 -1
  48. package/dist/esm/utils/runOnce.mjs +67 -16
  49. package/dist/esm/utils/runOnce.mjs.map +1 -1
  50. package/dist/types/cli.d.ts +2 -1
  51. package/dist/types/init/index.d.ts +9 -6
  52. package/dist/types/init/index.d.ts.map +1 -1
  53. package/dist/types/init/upgradeIntlayerPackages.d.ts +26 -0
  54. package/dist/types/init/upgradeIntlayerPackages.d.ts.map +1 -0
  55. package/dist/types/init/utils/index.d.ts +3 -2
  56. package/dist/types/init/utils/intlayerDependencies.d.ts +66 -0
  57. package/dist/types/init/utils/intlayerDependencies.d.ts.map +1 -0
  58. package/dist/types/init/utils/packageManager.d.ts +44 -19
  59. package/dist/types/init/utils/packageManager.d.ts.map +1 -1
  60. package/dist/types/installSkills/index.d.ts +16 -3
  61. package/dist/types/installSkills/index.d.ts.map +1 -1
  62. package/dist/types/utils/runOnce.d.ts.map +1 -1
  63. package/package.json +7 -7
@@ -42,3 +42,31 @@ To use Intlayer effectively:
42
42
  - [Per-locale File](https://intlayer.org/doc/concept/per-locale-file.md)
43
43
  - [Website](https://intlayer.org)
44
44
  - [Doc](https://intlayer.org/doc)
45
+
46
+ ### Packages
47
+
48
+ - [intlayer comparePaths](https://intlayer.org/doc/packages/intlayer/comparePaths.md)
49
+ - [intlayer getCanonicalPath](https://intlayer.org/doc/packages/intlayer/getCanonicalPath.md)
50
+ - [intlayer getConfiguration](https://intlayer.org/doc/packages/intlayer/getConfiguration.md)
51
+ - [intlayer getDictionary](https://intlayer.org/doc/packages/intlayer/getDictionary.md)
52
+ - [intlayer getDictionaryAsync](https://intlayer.org/doc/packages/intlayer/getDictionaryAsync.md)
53
+ - [intlayer getEnumeration](https://intlayer.org/doc/packages/intlayer/getEnumeration.md)
54
+ - [intlayer getHTMLTextDir](https://intlayer.org/doc/packages/intlayer/getHTMLTextDir.md)
55
+ - [intlayer getIntlayer](https://intlayer.org/doc/packages/intlayer/getIntlayer.md)
56
+ - [intlayer getIntlayerAsync](https://intlayer.org/doc/packages/intlayer/getIntlayerAsync.md)
57
+ - [intlayer getLocale](https://intlayer.org/doc/packages/intlayer/getLocale.md)
58
+ - [intlayer getLocaleLang](https://intlayer.org/doc/packages/intlayer/getLocaleLang.md)
59
+ - [intlayer getLocaleName](https://intlayer.org/doc/packages/intlayer/getLocaleName.md)
60
+ - [intlayer getLocalizedPath](https://intlayer.org/doc/packages/intlayer/getLocalizedPath.md)
61
+ - [intlayer getLocalizedUrl](https://intlayer.org/doc/packages/intlayer/getLocalizedUrl.md)
62
+ - [intlayer getMultilingualUrls](https://intlayer.org/doc/packages/intlayer/getMultilingualUrls.md)
63
+ - [intlayer getPathWithoutLocale](https://intlayer.org/doc/packages/intlayer/getPathWithoutLocale.md)
64
+ - [intlayer getPrefix](https://intlayer.org/doc/packages/intlayer/getPrefix.md)
65
+ - [intlayer getTranslation](https://intlayer.org/doc/packages/intlayer/getTranslation.md)
66
+ - [intlayer validatePrefix](https://intlayer.org/doc/packages/intlayer/validatePrefix.md)
67
+ - [vite-intlayer Exports](https://intlayer.org/doc/packages/vite-intlayer/exports.md)
68
+ - [vite-intlayer intlayer](https://intlayer.org/doc/packages/vite-intlayer/intlayer.md)
69
+ - [vite-intlayer intlayerCompiler](https://intlayer.org/doc/packages/vite-intlayer/intlayerCompiler.md)
70
+ - [vite-intlayer intlayerMinify](https://intlayer.org/doc/packages/vite-intlayer/intlayerMinify.md)
71
+ - [vite-intlayer intlayerProxy](https://intlayer.org/doc/packages/vite-intlayer/intlayerProxy.md)
72
+ - [vite-intlayer intlayerPrune](https://intlayer.org/doc/packages/vite-intlayer/intlayerPrune.md)
@@ -0,0 +1,108 @@
1
+ ---
2
+ name: intlayer-vanilla
3
+ description: Integrates Intlayer internationalization with plain JavaScript / TypeScript (no UI framework). Use when the user asks to "setup Vanilla JS i18n", translate a static HTML page, use "useIntlayer" without a framework, or switch locale in a vanilla application.
4
+ metadata:
5
+ author: Intlayer
6
+ url: https://intlayer.org
7
+ license: Apache-2.0
8
+ mcp-server: "@intlayer/mcp"
9
+ category: productivity
10
+ tags: [i18n, vanilla, javascript, vite]
11
+ documentation: https://intlayer.org/doc
12
+ support: contact@intlayer.org
13
+ ---
14
+
15
+ # Intlayer Vanilla JS Usage
16
+
17
+ ## Core Philosophy
18
+
19
+ Intlayer promotes **Component-Level Content Declaration**. Instead of a massive global translation file, content is declared in `*.content.ts` files adjacent to the scripts that use them.
20
+
21
+ `vanilla-intlayer` mirrors the `react-intlayer` API without depending on a UI framework: a pub/sub singleton plus callback-based helpers.
22
+
23
+ ### Declare Content
24
+
25
+ **File:** `src/app.content.ts`
26
+
27
+ ```typescript
28
+ import { t, type Dictionary } from "intlayer";
29
+
30
+ const content = {
31
+ key: "app",
32
+ content: {
33
+ title: t({
34
+ en: "Welcome",
35
+ fr: "Bienvenue",
36
+ es: "Hola",
37
+ }),
38
+ },
39
+ } satisfies Dictionary;
40
+
41
+ export default content;
42
+ ```
43
+
44
+ ## Setup
45
+
46
+ - [Vite and Vanilla JS](https://intlayer.org/doc/environment/vite-and-vanilla.md) (bundled app)
47
+ - [Vanilla JS](https://intlayer.org/doc/environment/vanilla.md) (no bundler, standalone script generated by `intlayer standalone`)
48
+
49
+ Call `installIntlayer()` **before** any content is rendered.
50
+
51
+ ## useIntlayer
52
+
53
+ `useIntlayer(key, locale?)` returns the content directly. Chain `.onChange()` to re-render when the locale changes.
54
+
55
+ ```typescript
56
+ import { useIntlayer } from "vanilla-intlayer";
57
+
58
+ const title = document.querySelector("h1")!;
59
+
60
+ const content = useIntlayer("app").onChange((newContent) => {
61
+ title.textContent = String(newContent.title);
62
+ });
63
+
64
+ title.textContent = String(content.title);
65
+ // Native attributes: use `.value`
66
+ // image.alt = content.title.value;
67
+ ```
68
+
69
+ > Without a bundler, read the same helpers from the globals of the standalone bundle: `window.VanillaIntlayer` and `window.Intlayer`.
70
+
71
+ ## useLocale
72
+
73
+ ```typescript
74
+ import { useLocale } from "vanilla-intlayer";
75
+
76
+ const { locale, availableLocales, setLocale, subscribe } = useLocale();
77
+
78
+ const unsubscribe = subscribe((newLocale) => {
79
+ document.documentElement.lang = newLocale;
80
+ });
81
+
82
+ setLocale("fr");
83
+ ```
84
+
85
+ ## Compiler
86
+
87
+ 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.
88
+
89
+ ## References
90
+
91
+ - [Website](https://intlayer.org)
92
+ - [Doc](https://intlayer.org/doc)
93
+
94
+ ### Environments
95
+
96
+ - [Vite and Vanilla JS](https://intlayer.org/doc/environment/vite-and-vanilla.md)
97
+ - [Vanilla JS](https://intlayer.org/doc/environment/vanilla.md)
98
+
99
+ ### Concepts
100
+
101
+ - [Variants](https://intlayer.org/doc/concept/variants.md)
102
+ - [Collections](https://intlayer.org/doc/concept/collections.md)
103
+ - [Compiler](https://intlayer.org/doc/compiler.md)
104
+ - [Formatters (number, currency, date, …)](https://intlayer.org/doc/formatters.md)
105
+
106
+ ### Packages
107
+
108
+ - [Intlayer Exports](https://intlayer.org/doc/packages/intlayer/exports.md)
@@ -45,12 +45,34 @@ console.log(content.title.raw); // Render as raw
45
45
 
46
46
  [Vue Documentation](https://intlayer.org/doc/packages/vue-intlayer/exports.md)
47
47
 
48
+ ## Compiler
49
+
50
+ 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.
51
+
52
+ It activates once `compiler.enabled` and `compiler.output` are set: `.svelte` files additionally require `@intlayer/vue-compiler`.
53
+
48
54
  ## References
49
55
 
50
56
  - [Website](https://intlayer.org)
51
57
  - [Doc](https://intlayer.org/doc)
52
58
 
59
+ ### Environments
60
+
53
61
  - [Vite and Vue](https://intlayer.org/doc/environment/vite-and-vue.md)
54
62
  - [Nuxt and Vue](https://intlayer.org/doc/environment/nuxt-and-vue.md)
63
+ - [Astro and Vue](https://intlayer.org/doc/environment/astro/vue.md)
64
+
65
+ ### Concepts
66
+
67
+ - [Variants](https://intlayer.org/doc/concept/variants.md)
68
+ - [Collections](https://intlayer.org/doc/concept/collections.md)
69
+ - [Compiler](https://intlayer.org/doc/compiler.md)
70
+ - [Formatters (number, currency, date, …)](https://intlayer.org/doc/formatters.md)
71
+
72
+ ### Packages
73
+
55
74
  - [Vue Intlayer Exports](https://intlayer.org/doc/packages/vue-intlayer/exports.md)
56
75
  - [Intlayer Exports](https://intlayer.org/doc/packages/intlayer/exports.md)
76
+ - [nuxt-intlayer Exports](https://intlayer.org/doc/packages/nuxt-intlayer/exports.md)
77
+ - [vue-intlayer usePathname](https://intlayer.org/doc/packages/vue-intlayer/usePathname.md)
78
+ - [vue-intlayer useRewriteURL](https://intlayer.org/doc/packages/vue-intlayer/useRewriteURL.md)
package/dist/cjs/cli.cjs CHANGED
@@ -12,6 +12,7 @@ const require_listProjects = require('./listProjects.cjs');
12
12
  const require_init_cms = require('./init/cms.cjs');
13
13
  const require_init_utils_packageManager = require('./init/utils/packageManager.cjs');
14
14
  const require_init_utils_nextCompilerBabel = require('./init/utils/nextCompilerBabel.cjs');
15
+ const require_init_upgradeIntlayerPackages = require('./init/upgradeIntlayerPackages.cjs');
15
16
  const require_init_index = require('./init/index.cjs');
16
17
  const require_installSkills_index = require('./installSkills/index.cjs');
17
18
  const require_installMCP_installMCP = require('./installMCP/installMCP.cjs');
@@ -47,6 +48,7 @@ exports.logConfigDetails = require_logConfigDetails.logConfigDetails;
47
48
  exports.prepareIntlayer = require_prepareIntlayer.prepareIntlayer;
48
49
  exports.setupCmsCredentials = require_init_cms.setupCmsCredentials;
49
50
  exports.transformJSFile = require_writeContentDeclaration_transformJSFile.transformJSFile;
51
+ exports.upgradeIntlayerPackages = require_init_upgradeIntlayerPackages.upgradeIntlayerPackages;
50
52
  exports.writeCmsCredentialsToEnv = require_init_cms.writeCmsCredentialsToEnv;
51
53
  exports.writeContentDeclaration = require_writeContentDeclaration_writeContentDeclaration.writeContentDeclaration;
52
54
  exports.writeJSFile = require_writeContentDeclaration_writeJSFile.writeJSFile;