systemlink-cli 2.3.1__tar.gz → 2.4.1__tar.gz

{systemlink_cli-2.3.1 → systemlink_cli-2.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: systemlink-cli
-Version: 2.3.1
+Version: 2.4.1
 Summary: SystemLink Integrator CLI - cross-platform CLI for SystemLink workflows and templates.
 License-File: LICENSE
 Author: Fred Visser

{systemlink_cli-2.3.1 → systemlink_cli-2.4.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "systemlink-cli"
-version = "2.3.1"
+version = "2.4.1"
 description = "SystemLink Integrator CLI - cross-platform CLI for SystemLink workflows and templates."
 authors = ["Fred Visser <fred.visser@emerson.com>"]
 packages = [{ include = "slcli" }]

{systemlink_cli-2.3.1 → systemlink_cli-2.4.1}/slcli/_version.py

@@ -1,4 +1,4 @@
 """Version information for slcli."""
 
 # This file is auto-generated. Do not edit manually.
-__version__ = "2.3.1"
+__version__ = "2.4.1"

{systemlink_cli-2.3.1 → systemlink_cli-2.4.1}/slcli/webapp_bootstrap.py

@@ -357,10 +357,16 @@ def _build_webapp_routing_module(template: str, routing_mode: str) -> str:
     return "\n".join(lines)
 
 
+def _localize_typescript_literal(value: str) -> str:
+    """Return a TypeScript `$localize` template literal for a fixed message."""
+    escaped = value.replace("\\", "\\\\").replace("`", "\\`").replace("${", "\\${")
+    return f"$localize`{escaped}`"
+
+
 def _build_webapp_shell_component(template: str) -> str:
     """Render the app shell tabs for the selected template."""
     tab_lines = [
-        f"    {{ id: '{tab['id']}', label: '{tab['label']}', route: '{tab['route']}' }},"
+        f"    {{ id: '{tab['id']}', label: {_localize_typescript_literal(tab['label'])}, route: '{tab['route']}' }},"
         for tab in _webapp_template_profile(template)["tabs"]
     ]
 
@@ -463,6 +469,7 @@ def _build_webapp_app_module(enable_ok_feature: bool) -> str:
         "import { NimbleChipModule } from '@ni/nimble-angular/chip';",
         "import { NimbleLabelProviderCoreModule } from '@ni/nimble-angular/label-provider/core';",
         "import { NimbleTableModule } from '@ni/nimble-angular/table';",
+        "import { NimbleTableColumnDateTextModule } from '@ni/nimble-angular/table-column/date-text';",
         "import { NimbleTableColumnTextModule } from '@ni/nimble-angular/table-column/text';",
     ]
     if ok_imports:
@@ -515,6 +522,7 @@ def _build_webapp_app_module(enable_ok_feature: bool) -> str:
             "    NimbleTextAreaModule,",
             "    NimbleTextFieldModule,",
             "    NimbleTableModule,",
+            "    NimbleTableColumnDateTextModule,",
             "    NimbleTableColumnTextModule,",
             *ok_modules,
             "  ],",
@@ -533,6 +541,7 @@ def _build_master_detail_page_template(enable_ok_feature: bool) -> str:
             <ok-fv-master-detail-list
                 class=\"master-detail__list\"
                 placeholder=\"Filter devices...\"
+                i18n-placeholder
                 (change)=\"onSelectionChange($event)\"
             >
                 <ok-fv-master-detail-list-item
@@ -551,6 +560,7 @@ def _build_master_detail_page_template(enable_ok_feature: bool) -> str:
             <nimble-select
                 class=\"master-detail__list\"
                 aria-label=\"Devices\"
+                i18n-aria-label
                 filter-mode=\"standard\"
                 [(ngModel)]=\"selectedDeviceId\"
                 (ngModelChange)=\"onSelectedDeviceIdChange()\"
@@ -564,9 +574,9 @@ def _build_master_detail_page_template(enable_ok_feature: bool) -> str:
     return (
         """<section class=\"master-detail sl-page\">
     <header class=\"sl-page__intro\">
-        <p class=\"sl-page__eyebrow\">Starter Pattern: Master Detail</p>
-        <h2>Use this sample layout when selection and lightweight editing need to stay side by side.</h2>
-        <p>
+        <p class=\"sl-page__eyebrow\" i18n>Starter Pattern: Master Detail</p>
+        <h2 i18n>Use this sample layout when selection and lightweight editing need to stay side by side.</h2>
+        <p i18n>
             The list items, fields, and helper copy here are starter content. Replace them when the
             route is connected to the real records your app manages.
         </p>
@@ -580,7 +590,8 @@ def _build_master_detail_page_template(enable_ok_feature: bool) -> str:
                 (click)=\"isEditing ? saveChanges() : toggleEditMode()\"
                 [disabled]=\"!selectedDevice\"
             >
-                {{ isEditing ? 'Save details' : 'Edit details' }}
+                <ng-container *ngIf=\"isEditing\" i18n>Save details</ng-container>
+                <ng-container *ngIf=\"!isEditing\" i18n>Edit details</ng-container>
             </nimble-button>
         </div>
     </div>
@@ -591,9 +602,10 @@ def _build_master_detail_page_template(enable_ok_feature: bool) -> str:
                 class=\"master-detail__filter\"
                 [(ngModel)]=\"filterTerm\"
                 placeholder=\"Search devices\"
+                i18n-placeholder
                 (ngModelChange)=\"applyFilter()\"
             >
-                Filter devices
+                <ng-container i18n>Filter devices</ng-container>
             </nimble-text-field>
 
 """
@@ -612,74 +624,74 @@ def _build_master_detail_page_template(enable_ok_feature: bool) -> str:
 
             <div class=\"master-detail__detail-grid\">
                 <div>
-                    <span>Device name</span>
+                    <span i18n>Device name</span>
                     <strong>{{ device.name }}</strong>
                 </div>
                 <div>
-                    <span>Model</span>
+                    <span i18n>Model</span>
                     <strong>{{ device.model }}</strong>
                 </div>
                 <div>
-                    <span>IP address</span>
+                    <span i18n>IP address</span>
                     <strong>{{ device.ipAddress }}</strong>
                 </div>
                 <div>
-                    <span>Firmware version</span>
+                    <span i18n>Firmware version</span>
                     <strong>{{ device.firmwareVersion }}</strong>
                 </div>
             </div>
 
             <div class=\"master-detail__edit-grid\">
                 <nimble-text-field [(ngModel)]=\"device.location\" [readonly]=\"!isEditing\">
-                    Location
+                    <ng-container i18n>Location</ng-container>
                 </nimble-text-field>
                 <nimble-text-field [(ngModel)]=\"device.systemId\" [readonly]=\"!isEditing\">
-                    Device ID
+                    <ng-container i18n>Device ID</ng-container>
                 </nimble-text-field>
             </div>
 
             <nimble-text-area [(ngModel)]=\"device.notes\" [readonly]=\"!isEditing\" resize=\"vertical\">
-                Notes
+                <ng-container i18n>Notes</ng-container>
             </nimble-text-area>
 
             <nimble-switch [(ngModel)]=\"device.monitorEnabled\" [disabled]=\"!isEditing\">
-                Include in monitor roster
+                <ng-container i18n>Include in monitor roster</ng-container>
             </nimble-switch>
 
-            <nimble-banner *ngIf=\"device.statusLabel === 'Pending changes'\" [open]=\"true\" severity=\"warning\">
+            <nimble-banner *ngIf=\"device.statusCode === 'pending-changes'\" [open]=\"true\" severity=\"warning\" i18n>
                 Review the pending changes before this device returns to the connected roster.
             </nimble-banner>
 
             <dl class=\"master-detail__facts\">
                 <div>
-                    <dt>Last seen</dt>
-                    <dd>{{ device.lastSeen }}</dd>
+                    <dt i18n>Last seen</dt>
+                    <dd>{{ device.lastSeen | date:'medium' }}</dd>
                 </div>
                 <div>
-                    <dt>Calibration due</dt>
-                    <dd>{{ device.calibrationDue }}</dd>
+                    <dt i18n>Calibration due</dt>
+                    <dd>{{ device.calibrationDue | date:'mediumDate':'UTC' }}</dd>
                 </div>
             </dl>
         </section>
     </div>
 
     <ng-template #emptyState>
-        <sl-empty-state [message]=\"'Adjust the filter or add a real device query to populate this pattern.'\"></sl-empty-state>
+        <sl-empty-state [message]=\"emptyStateMessage\"></sl-empty-state>
     </ng-template>
 </section>
 """
     )
 
 
-def _quoted_typescript_list(values: List[str]) -> str:
-    """Return a comma-separated TypeScript string literal list."""
-    return ",\n        ".join(f"'{value}'" for value in values)
+def _localized_typescript_list(values: List[str]) -> str:
+    """Return a comma-separated list of localized TypeScript messages."""
+    return ",\n        ".join(_localize_typescript_literal(value) for value in values)
 
 
 def _build_webapp_home_data_service(template: str) -> str:
     """Render the home data service for the selected template."""
     profile = _webapp_template_profile(template)
-    patterns = _quoted_typescript_list(profile["patterns"])
+    patterns = _localized_typescript_list(profile["patterns"])
     return "\n".join(
         [
             "import { Injectable } from '@angular/core';",
@@ -708,21 +720,21 @@ def _build_webapp_home_data_service(template: str) -> str:
             "    return {",
             "      metrics: [",
             "        {",
-            "          label: 'Hosted origin',",
+            "          label: $localize`Hosted origin`,",
             "          value: this.context.origin,",
-            "          detail: 'Root future SDK clients and direct fetch calls here.',",
+            "          detail: $localize`Root future SDK clients and direct fetch calls here.`,",
             "          tone: 'info',",
             "        },",
             "        {",
-            "          label: 'Auth mode',",
+            "          label: $localize`Auth mode`,",
             "          value: this.context.authMode,",
-            "          detail: 'Swap with --auth when you need API-key-driven development flows.',",
+            "          detail: $localize`Swap with --auth when you need API-key-driven development flows.`,",
             "          tone: 'warning',",
             "        },",
             "        {",
-            "          label: 'Workspace',",
+            "          label: $localize`Workspace`,",
             "          value: this.context.workspaceName,",
-            "          detail: 'Publishing help text and starter docs are already aligned to this workspace.',",
+            "          detail: $localize`Publishing help text and starter docs are already aligned to this workspace.`,",
             "          tone: 'success',",
             "        },",
             "      ],",
@@ -730,11 +742,11 @@ def _build_webapp_home_data_service(template: str) -> str:
             f"        {patterns},",
             "      ],",
             "      nextSteps: [",
-            "        'Replace one sample page with a real SystemLink query before adding more routes.',",
-            "        'Use Nimble buttons for actions and Nimble anchors or route tabs for navigation.',",
-            "        'Preserve hosted query parameters if you later add cross-app breadcrumbs.',",
+            "        $localize`Replace one sample page with a real SystemLink query before adding more routes.`,",
+            "        $localize`Use Nimble buttons for actions and Nimble anchors or route tabs for navigation.`,",
+            "        $localize`Preserve hosted query parameters if you later add cross-app breadcrumbs.`,",
             "      ],",
-            f"      readinessMessage: '{profile['readiness_message']}',",
+            f"      readinessMessage: {_localize_typescript_literal(profile['readiness_message'])},",
             "    };",
             "  }",
             "}",
@@ -768,13 +780,18 @@ This app was generated by `slcli webapp new {app_name}` as a hosted Angular 20 s
 - `nimble-theme-provider` at the application root
 - `APP_BASE_HREF` provided without a `<base>` tag in `src/index.html`
 - `useHash: {'true' if routing_mode == 'hash' else 'false'}` routing for hosted navigation
-- `@angular/localize/init` configured for the build polyfill path
+- Angular `i18n` and `$localize` support with `en-US` as the source locale
+- `npm run i18n:extract` configured to write the English fallback catalog
+- Runtime localization using the active SystemLink language preference
+- Runtime translation catalogs for German, English, Spanish, French, Japanese, Korean, and Chinese
+- `@angular/localize/init` configured in the build polyfill path
 - Nimble fonts imported in `src/styles.scss`
 - modern Angular application builders configured for the hosted scaffold
 - CycloneDX npm generator for a runtime dependency SBOM
 - initial bundle warning budget tuned for the included starter shell
 - shared loading, error, and empty states
 - SystemLink context and theme sync services under `src/app/core/systemlink/`
+- `nimble-theme-provider` and live SystemLink shell theme synchronization enabled by default
 - {profile['pattern_summary']}
 
 ## Enabled Starter Routes
@@ -797,7 +814,38 @@ or creating the SBOM yet.
 
 The generated scaffold intentionally omits a default test runner setup so `npm install`
 does not pull in the deprecated Karma/Jasmine stack. Add your preferred test tooling when
-you start writing app-specific tests.
+you start writing app-specific tests. Include `@angular/localize/init` in the test
+polyfill path when you add that tooling.
+
+## Localization
+
+The source locale is `en-US`. Sample UI copy is marked with Angular `i18n` in
+templates and `$localize` in TypeScript. Run `npm run i18n:extract` after adding
+or changing user-facing text to regenerate the complete English fallback
+catalog in `src/locale/messages.en.json`. Add translated message IDs to the
+runtime catalogs in `src/locale/messages.<language>.json`; the selected locale
+catalog overrides matching English entries, while untranslated copy falls
+back to English without runtime warnings. The starter reads the SystemLink
+preference from `localStorage.language` when the iframe loads, with the legacy
+`skyline-api-languages` preference and browser language as fallbacks. It
+supports `de`, `en`, `es`, `fr`, `ja`, `ko`, and `zh`. Angular translations and
+locale data load before app modules are imported through `loadTranslations()`,
+and the resolved language sets `LOCALE_ID` and the iframe document's `lang`.
+The SystemLink shell reloads the iframe when the user changes the profile
+language, so the next bootstrap applies the new translations and date/number
+formats.
+The Home localization preview has translations for all supported non-English
+languages; other starter copy remains in English until you add translations.
+
+## Theming
+
+The app is wrapped in a root `nimble-theme-provider`. By default,
+`ThemeSyncService` observes the SystemLink shell theme and updates the app for
+`light`, `dark`, and `color` themes. Use Nimble design tokens for custom styles
+and keep theme aliases on the provider. For standalone previews, the
+`?theme=light`, `?theme=dark`, and `?theme=color` query values can select a
+theme. The `webapp new --theme-sync` option can disable automatic shell
+synchronization when needed.
 
 ## Publish To SystemLink
 
@@ -964,6 +1012,7 @@ def _customize_generated_package_json(
     package_json["scripts"] = {
         "start": "ng serve --host 0.0.0.0",
         "build": "ng build",
+        "i18n:extract": "ng extract-i18n",
         "sbom": (
             "cyclonedx-npm --omit dev --output-format JSON "
             "--output-file sbom.cdx.json --validate --output-reproducible "
@@ -1104,7 +1153,10 @@ def _emit_webapp_new_dry_run(
         + ", ".join(tab["route"].lstrip("/") or "home" for tab in profile["tabs"])
     )
     click.echo("    - APP_BASE_HREF provider with no <base> tag")
-    click.echo("    - Angular localize polyfills for build")
+    click.echo("    - Angular localize build polyfill and en-US source locale")
+    click.echo("    - i18n:extract script for the English fallback catalog")
+    click.echo("    - SystemLink runtime language detection and locale-aware bootstrap")
+    click.echo("    - root Nimble theme provider with shell synchronization enabled by default")
     click.echo("    - Nimble fonts in src/styles.scss")
     click.echo("    - @angular/build application builder with inlineCritical disabled")
     click.echo("    - hash routing enabled unless --routing path is requested")

{systemlink_cli-2.3.1 → systemlink_cli-2.4.1}/slcli/webapp_templates/angular/blank/README.md

@@ -10,13 +10,18 @@ This app was generated by `slcli webapp new {{APP_NAME}}` as a hosted Angular 20
 - `nimble-theme-provider` at the application root
 - `APP_BASE_HREF` provided without a `<base>` tag in `src/index.html`
 - `useHash: {{ROUTER_USE_HASH}}` routing for hosted navigation
-- `@angular/localize/init` configured for the build polyfill path
+- Angular `i18n` and `$localize` support with `en-US` as the source locale
+- `npm run i18n:extract` configured to write the English fallback catalog
+- Runtime localization using the active SystemLink language preference
+- Runtime translation catalogs for German, English, Spanish, French, Japanese, Korean, and Chinese
+- `@angular/localize/init` configured in the build polyfill path
 - Nimble fonts imported in `src/styles.scss`
 - modern Angular application builders configured for the hosted scaffold
 - CycloneDX npm generator for a runtime dependency SBOM
 - initial bundle warning budget tuned for the included six-route starter shell
 - shared loading, error, and empty states
 - SystemLink context and theme sync services under `src/app/core/systemlink/`
+- `nimble-theme-provider` and live SystemLink shell theme synchronization enabled by default
 - six Nimble-based layout patterns ready to replace with real SystemLink resource calls
 
 ## Project Layout
@@ -56,7 +61,41 @@ or creating the SBOM yet.
 
 The generated scaffold intentionally omits a default test runner setup so `npm install`
 does not pull in the deprecated Karma/Jasmine stack. Add your preferred test tooling when
-you start writing app-specific tests.
+you start writing app-specific tests. Include `@angular/localize/init` in the test
+polyfill path when you add that tooling.
+
+## Localization
+
+The source locale is `en-US`. Sample UI copy is marked with Angular `i18n` in
+templates and `$localize` in TypeScript. The English fallback catalog is a
+union across the `blank`, `dashboard`, `list-detail`, and `admin` profiles and
+the Nimble-only master/detail variant. After adding or changing user-facing
+text, run `npm run i18n:extract` for the affected variant and merge its IDs
+into `src/locale/messages.en.json`; do not replace the union with output from a
+single variant. Add translated message IDs to the
+runtime catalogs in `src/locale/messages.<language>.json`; the selected locale
+catalog overrides matching English entries, while untranslated copy falls
+back to English without runtime warnings. The starter reads the SystemLink
+preference from `localStorage.language` when the iframe loads, with the legacy
+`skyline-api-languages` preference and browser language as fallbacks. It
+supports `de`, `en`, `es`, `fr`, `ja`, `ko`, and `zh`. Angular translations and
+locale data load before app modules are imported through `loadTranslations()`,
+and the resolved language sets `LOCALE_ID` and the iframe document's `lang`.
+The SystemLink shell reloads the iframe when the user changes the profile
+language, so the next bootstrap applies the new translations and date/number
+formats. The Home localization preview has translations for all supported
+non-English languages; other starter copy remains in English until you add
+translations.
+
+## Theming
+
+The app is wrapped in a root `nimble-theme-provider`. By default,
+`ThemeSyncService` observes the SystemLink shell theme and updates the app for
+`light`, `dark`, and `color` themes. Use Nimble design tokens for custom styles
+and keep theme aliases on the provider. For standalone previews, the
+`?theme=light`, `?theme=dark`, and `?theme=color` query values can select a
+theme. The `webapp new --theme-sync` option can disable automatic shell
+synchronization when needed.
 
 ## Publish To SystemLink
 

{systemlink_cli-2.3.1 → systemlink_cli-2.4.1}/slcli/webapp_templates/angular/blank/angular.json

@@ -20,6 +20,9 @@
       "root": "",
       "sourceRoot": "src",
       "prefix": "app",
+      "i18n": {
+        "sourceLocale": "en-US"
+      },
       "architect": {
         "build": {
           "builder": "@angular/build:application",
@@ -82,7 +85,10 @@
         "extract-i18n": {
           "builder": "@angular/build:extract-i18n",
           "options": {
-            "buildTarget": "{{PROJECT_NAME}}:build"
+            "buildTarget": "{{PROJECT_NAME}}:build",
+            "format": "json",
+            "outFile": "messages.en.json",
+            "outputPath": "src/locale"
           }
         }
       }

{systemlink_cli-2.3.1 → systemlink_cli-2.4.1}/slcli/webapp_templates/angular/blank/package.json

@@ -6,6 +6,7 @@
   "scripts": {
     "start": "ng serve --host 0.0.0.0",
     "build": "ng build",
+    "i18n:extract": "ng extract-i18n",
     "publish:webapp": "slcli webapp publish dist/{{PROJECT_NAME}}"
   },
   "dependencies": {},

{systemlink_cli-2.3.1 → systemlink_cli-2.4.1}/slcli/webapp_templates/angular/blank/src/app/app.module.ts

@@ -21,6 +21,7 @@ import {
 import { NimbleChipModule } from '@ni/nimble-angular/chip';
 import { NimbleLabelProviderCoreModule } from '@ni/nimble-angular/label-provider/core';
 import { NimbleTableModule } from '@ni/nimble-angular/table';
+import { NimbleTableColumnDateTextModule } from '@ni/nimble-angular/table-column/date-text';
 import { NimbleTableColumnTextModule } from '@ni/nimble-angular/table-column/text';
 import { OkFvMasterDetailListItemModule } from '@ni/ok-angular/fv/master-detail-list-item';
 import { OkFvMasterDetailListModule } from '@ni/ok-angular/fv/master-detail-list';
@@ -69,6 +70,7 @@ import { LoadingStateComponent } from './shared/components/loading-state.compone
     NimbleTextAreaModule,
     NimbleTextFieldModule,
     NimbleTableModule,
+    NimbleTableColumnDateTextModule,
     NimbleTableColumnTextModule,
     OkFvMasterDetailListModule,
     OkFvMasterDetailListItemModule,

{systemlink_cli-2.3.1 → systemlink_cli-2.4.1}/slcli/webapp_templates/angular/blank/src/app/core/layout/app-shell.component.ts

@@ -25,12 +25,12 @@ interface ShellTab {
 })
 export class AppShellComponent {
   readonly tabs: readonly ShellTab[] = [
-    { id: 'overview', label: 'Overview', route: '/' },
-    { id: 'datasets', label: 'Data Table', route: '/datasets' },
-    { id: 'assets', label: 'Drawer Detail', route: '/assets' },
-    { id: 'master-detail', label: 'Master Detail', route: '/master-detail' },
-    { id: 'operations', label: 'Operations', route: '/operations' },
-    { id: 'settings', label: 'Settings', route: '/settings' },
+    { id: 'overview', label: $localize`Overview`, route: '/' },
+    { id: 'datasets', label: $localize`Data Table`, route: '/datasets' },
+    { id: 'assets', label: $localize`Drawer Detail`, route: '/assets' },
+    { id: 'master-detail', label: $localize`Master Detail`, route: '/master-detail' },
+    { id: 'operations', label: $localize`Operations`, route: '/operations' },
+    { id: 'settings', label: $localize`Settings`, route: '/settings' },
   ];
 
   activeTabId = 'overview';

systemlink_cli-2.4.1/slcli/webapp_templates/angular/blank/src/app/core/systemlink/systemlink-locale.ts

@@ -0,0 +1,48 @@
+const SYSTEMLINK_LANGUAGES = ['fr', 'de', 'ja', 'zh', 'en', 'ko', 'es'] as const;
+const SYSTEMLINK_LANGUAGE_STORAGE_KEY = 'language';
+const SYSTEMLINK_LEGACY_LANGUAGE_STORAGE_KEY = 'skyline-api-languages';
+
+export type SystemLinkLanguage = (typeof SYSTEMLINK_LANGUAGES)[number];
+
+function toLanguage(locale: string | null | undefined): string {
+  return (locale ?? '').split(/[-_]/)[0].trim().toLowerCase();
+}
+
+function isSystemLinkLanguage(language: string): language is SystemLinkLanguage {
+  return SYSTEMLINK_LANGUAGES.some((supportedLanguage: string) => supportedLanguage === language);
+}
+
+function readLocalStorage(key: string): string | null {
+  try {
+    return globalThis.localStorage?.getItem(key) ?? null;
+  } catch {
+    return null;
+  }
+}
+
+export function getSystemLinkLanguage(): SystemLinkLanguage {
+  const storedCandidates = [
+    readLocalStorage(SYSTEMLINK_LANGUAGE_STORAGE_KEY),
+    readLocalStorage(SYSTEMLINK_LEGACY_LANGUAGE_STORAGE_KEY)?.split(',')[0],
+  ];
+  for (const candidate of storedCandidates) {
+    const language = toLanguage(candidate);
+    if (isSystemLinkLanguage(language)) {
+      return language;
+    }
+  }
+
+  const browserCandidates = [
+    ...(globalThis.navigator?.languages ?? []),
+    globalThis.navigator?.language,
+    Intl.DateTimeFormat().resolvedOptions().locale,
+  ];
+  for (const candidate of browserCandidates) {
+    const language = toLanguage(candidate);
+    if (isSystemLinkLanguage(language)) {
+      return language;
+    }
+  }
+
+  return 'en';
+}

systemlink_cli-2.4.1/slcli/webapp_templates/angular/blank/src/app/core/systemlink/webapp-home-data.service.ts

@@ -0,0 +1,62 @@
+import { Injectable } from '@angular/core';
+
+import { SystemLinkContextService } from './systemlink-context.service';
+
+export interface HomeMetric {
+  label: string;
+  value: string;
+  detail: string;
+  tone: 'info' | 'success' | 'warning';
+}
+
+export interface HomePageModel {
+  metrics: HomeMetric[];
+  patterns: string[];
+  nextSteps: string[];
+  readinessMessage: string;
+}
+
+@Injectable({ providedIn: 'root' })
+export class WebappHomeDataService {
+  constructor(private readonly context: SystemLinkContextService) {}
+
+  async load(): Promise<HomePageModel> {
+    return {
+      metrics: [
+        {
+          label: $localize`Hosted origin`,
+          value: this.context.origin,
+          detail: $localize`Root future SDK clients and direct fetch calls here.`,
+          tone: 'info',
+        },
+        {
+          label: $localize`Auth mode`,
+          value: this.context.authMode,
+          detail: $localize`Swap with --auth when you need API-key-driven development flows.`,
+          tone: 'warning',
+        },
+        {
+          label: $localize`Workspace`,
+          value: this.context.workspaceName,
+          detail: $localize`Publishing help text and starter docs are already aligned to this workspace.`,
+          tone: 'success',
+        },
+      ],
+      patterns: [
+        $localize`Route-level navigation with Nimble anchor tabs`,
+        $localize`Search-first Nimble table toolbar with concise Search <items> copy`,
+        $localize`Drawer-based detail inspection from a primary dataset`,
+        $localize`Master/detail split pane with read-only detail fields until edit mode`,
+        $localize`Split operations workspace with manual refresh and a confirm dialog`,
+        $localize`Grouped settings form with theme-aware sections and readonly hosted facts`,
+      ],
+      nextSteps: [
+        $localize`Replace one sample page with a real SystemLink query before adding more routes.`,
+        $localize`Use Nimble buttons for actions and Nimble anchors or route tabs for navigation.`,
+        $localize`Preserve hosted query parameters if you later add cross-app breadcrumbs.`,
+      ],
+      readinessMessage:
+        $localize`This starter keeps hosted routing, Nimble tokens, and sample control text aligned to current Stratus guidance.`,
+    };
+  }
+}