@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.
- package/dist/assets/installSkills/skills/angular.md +19 -68
- package/dist/assets/installSkills/skills/astro.md +38 -4
- package/dist/assets/installSkills/skills/backend.md +113 -0
- package/dist/assets/installSkills/skills/cli.md +29 -25
- package/dist/assets/installSkills/skills/compat.md +87 -0
- package/dist/assets/installSkills/skills/compiler.md +14 -4
- package/dist/assets/installSkills/skills/config.md +15 -5
- package/dist/assets/installSkills/skills/content.md +80 -6
- package/dist/assets/installSkills/skills/dev-tools.md +82 -0
- package/dist/assets/installSkills/skills/lit.md +115 -0
- package/dist/assets/installSkills/skills/markdown.md +96 -0
- package/dist/assets/installSkills/skills/next-js.md +21 -38
- package/dist/assets/installSkills/skills/preact.md +18 -0
- package/dist/assets/installSkills/skills/react.md +21 -4
- package/dist/assets/installSkills/skills/remix.md +95 -0
- package/dist/assets/installSkills/skills/remote-content.md +1 -1
- package/dist/assets/installSkills/skills/solid.md +21 -1
- package/dist/assets/installSkills/skills/svelte.md +22 -1
- package/dist/assets/installSkills/skills/usage.md +28 -0
- package/dist/assets/installSkills/skills/vanilla.md +108 -0
- package/dist/assets/installSkills/skills/vue.md +22 -0
- package/dist/cjs/cli.cjs +2 -0
- package/dist/cjs/init/index.cjs +305 -300
- package/dist/cjs/init/index.cjs.map +1 -1
- package/dist/cjs/init/upgradeIntlayerPackages.cjs +60 -0
- package/dist/cjs/init/upgradeIntlayerPackages.cjs.map +1 -0
- package/dist/cjs/init/utils/index.cjs +13 -4
- package/dist/cjs/init/utils/intlayerDependencies.cjs +119 -0
- package/dist/cjs/init/utils/intlayerDependencies.cjs.map +1 -0
- package/dist/cjs/init/utils/packageManager.cjs +145 -94
- package/dist/cjs/init/utils/packageManager.cjs.map +1 -1
- package/dist/cjs/installSkills/index.cjs +110 -19
- package/dist/cjs/installSkills/index.cjs.map +1 -1
- package/dist/cjs/utils/runOnce.cjs +66 -15
- package/dist/cjs/utils/runOnce.cjs.map +1 -1
- package/dist/esm/cli.mjs +2 -1
- package/dist/esm/init/index.mjs +306 -301
- package/dist/esm/init/index.mjs.map +1 -1
- package/dist/esm/init/upgradeIntlayerPackages.mjs +57 -0
- package/dist/esm/init/upgradeIntlayerPackages.mjs.map +1 -0
- package/dist/esm/init/utils/index.mjs +3 -2
- package/dist/esm/init/utils/intlayerDependencies.mjs +110 -0
- package/dist/esm/init/utils/intlayerDependencies.mjs.map +1 -0
- package/dist/esm/init/utils/packageManager.mjs +143 -93
- package/dist/esm/init/utils/packageManager.mjs.map +1 -1
- package/dist/esm/installSkills/index.mjs +110 -19
- package/dist/esm/installSkills/index.mjs.map +1 -1
- package/dist/esm/utils/runOnce.mjs +67 -16
- package/dist/esm/utils/runOnce.mjs.map +1 -1
- package/dist/types/cli.d.ts +2 -1
- package/dist/types/init/index.d.ts +9 -6
- package/dist/types/init/index.d.ts.map +1 -1
- package/dist/types/init/upgradeIntlayerPackages.d.ts +26 -0
- package/dist/types/init/upgradeIntlayerPackages.d.ts.map +1 -0
- package/dist/types/init/utils/index.d.ts +3 -2
- package/dist/types/init/utils/intlayerDependencies.d.ts +66 -0
- package/dist/types/init/utils/intlayerDependencies.d.ts.map +1 -0
- package/dist/types/init/utils/packageManager.d.ts +44 -19
- package/dist/types/init/utils/packageManager.d.ts.map +1 -1
- package/dist/types/installSkills/index.d.ts +16 -3
- package/dist/types/installSkills/index.d.ts.map +1 -1
- package/dist/types/utils/runOnce.d.ts.map +1 -1
- 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;
|