@sun-asterisk/sungen 2.6.10 → 2.6.12

package/dist/orchestrator/templates/ai-instructions/github-skill-sungen-selector-keys.md

@@ -115,6 +115,44 @@ gửi lời cảm ơn--3:
   name: 'Gửi lời cảm ơn'
 ```
 
+## i18n: Template Variables in Selectors
+
+For multilingual sites without `data-testid`, use `{{variable}}` in `name` or `value` fields to reference locale-dependent text from `test-data.yaml`.
+
+```yaml
+# selectors — one file for all locales
+submit:
+  type: role
+  value: button
+  name: "{{lbl_submit}}"
+
+search:
+  type: placeholder
+  value: "{{lbl_search}}"
+
+logo:
+  type: testid
+  value: app-logo            # testid is locale-independent — no variable needed
+```
+
+```yaml
+# test-data/login.yaml (base — English)
+lbl_submit: "Sign in"
+lbl_search: "Search..."
+
+# test-data/login.vi.yaml (Vietnamese)
+lbl_submit: "Đăng nhập"
+lbl_search: "Tìm kiếm..."
+```
+
+Run: `SUNGEN_ENV=vi npx playwright test`
+
+**Rules:**
+1. Prefix i18n keys with `lbl_`, `msg_`, `txt_` to separate from test data
+2. Prefer `data-testid` — only use `{{variable}}` when no stable selector exists
+3. Feature file stays identical across locales
+4. Requires runtime data mode (default, not `--inline-data`)
+
 ## Lookup Priority
 
 Resolver searches in this order:

package/dist/orchestrator/templates/ai-instructions/github-skill-sungen-tc-generation.md

@@ -352,6 +352,8 @@ Feature: <Screen> Screen
 
 **Environment-specific data**: create `<screen>.<env>.yaml` alongside the base file with only the keys that change. Users run `SUNGEN_ENV=staging npx playwright test` to merge overrides.
 
+**i18n / multilingual**: use the same `SUNGEN_ENV` overlay for locale variants — e.g., `login.vi.yaml`, `login.staging-ja.yaml`. Include `lbl_*` / `msg_*` keys for selector `{{variable}}` references (see `sungen-selector-keys` § i18n). One feature file + one selector file works across all locales.
+
 ## Flow Test Generation
 
 When generating tests for a **flow** (`qa/flows/<name>/`), adapt the strategy:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sun-asterisk/sungen",
-  "version": "2.6.10",
+  "version": "2.6.12",
   "description": "Deterministic E2E Test Compiler - Gherkin + Selectors → Playwright tests",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/cli/index.ts

@@ -21,7 +21,7 @@ async function main() {
   program
     .name('sungen')
     .description('Deterministic E2E Test Compiler — Gherkin + Selectors → Playwright')
-    .version('2.6.10');
+    .version('2.6.12');
 
   // Global options
   program