@_linked/cli 1.8.1 → 1.8.2

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 1.8.2
+
+### Patch Changes
+
+- [#57](https://github.com/linked-cm/cli/pull/57) [`e8385bd`](https://github.com/linked-cm/cli/commit/e8385bd4d4287afd85fbb86d6d4d20b1ea7152a7) Thanks [@flyon](https://github.com/flyon)! - CLI sub-template imports updated to use `@_linked/core` instead of legacy
+  `lincd/...`:
+
+  - `defaults/shape.ts` — `Shape` + `NamedNode` from `@_linked/core`
+  - `defaults/package/src/package.ts` — `linkedPackage` from `@_linked/core/utils/Package` (clean 1:1 swap; `@_linked/core` exports it identically)
+  - `defaults/package/src/ontologies/example-ontology.ts` — `NamedNode` + `createNameSpace` from `@_linked/core` (unused `lincd-jsonld` import dropped)
+
+  **Important caveat — TODO comments inline in the template files explain**:
+  the `package.ts` template is a clean working swap. The `shape.ts` and
+  `ontologies/example-ontology.ts` templates' generated output **will fail
+  to compile** because `@_linked/core` doesn't export `NamedNode` or
+  `Literal` as runtime classes — the new framework architecture moved past
+  direct node construction. Templates need a rewrite to emit the modern
+  getter-only `@_linked/*` shape pattern (see `@_linked/schema/shapes/Person.ts`).
+  The import-path change is a deliberate signal-of-intent that lands
+  incomplete; the actual template rewrite is tracked as downstream
+  Shape-Builder / Ontology-Manager review work.
+
+  Users of `linked create shape Foo` and `linked create package Bar`: if you
+  hit "Cannot find name NamedNode" or "Cannot find name Literal" errors
+  in scaffolded files, you've hit the documented gap. The fix path is the
+  template rewrite, not reverting to legacy lincd.
+
+  Context: see create-now plan-011 report (docs/reports/009-legacy-lincd-eradication.md).
+
 ## 1.8.1
 
 ### Patch Changes

package/defaults/app-with-backend/.env.example

@@ -0,0 +1,20 @@
+# App environment. Copy this file to `.env` and adjust for local dev.
+# `linked start` loads `.env` automatically (Node 20.12+ process.loadEnvFile).
+#
+# When CN hosts this app, CN INJECTS the dynamic per-(project, branch) vars below
+# at spawn time (PORT, FUSEKI_DATASET, the admin secret, the EG gateway) — those
+# take precedence over anything in this file. Vars in the "app config" section are
+# yours to own (CN may also write them here when it manages the app).
+
+# --- Data store (CN injects per branch; these are standalone-dev defaults) ------
+FUSEKI_BASE_URL=http://localhost:3030
+FUSEKI_DATASET=my-app-main
+FUSEKI_USER=admin
+FUSEKI_PASSWORD=admin
+
+# --- Runtime (CN injects PORT + CN_APP_ADMIN_SECRET when it spawns the app) -----
+PORT=4000
+# NODE_ENV=development
+
+# --- App config (yours — e.g. your public site root / production domain) --------
+SITE_ROOT=http://localhost:4000

package/defaults/app-with-backend/gitignore.template

@@ -22,4 +22,6 @@ packages/**/.yarn/*
 !packages/**/.yarn/versions
 .idea
 android/app/build
-ios/App/App/public
+ios/App/App/public
+# Local env (copied from .env.example)
+.env

package/defaults/app-with-backend/linked.config.js

@@ -1,5 +1,7 @@
 export default {
   cssMode: 'tailwind',
+  // Materialize this app's registered shapes into its data store on boot (default).
+  syncShapesOnBoot: true,
   cacheWebpack: true,
   analyse: false,
 };

package/defaults/app-with-backend/package.json

@@ -12,14 +12,20 @@
     "email": ""
   },
   "engines": {
-    "node": ">=20.6.0"
+    "node": ">=20.12.0"
   },
   "main": "scripts/start-server.js",
+  "exports": {
+    "./backend": {
+      "development": "./src/backend.ts",
+      "default": "./src/backend.ts"
+    }
+  },
   "license": "MIT",
   "scripts": {
-    "start": "linked start --env development",
+    "start": "linked start",
     "build": "linked build-app --env production",
-    "server:prod": "linked start --env production",
+    "server:prod": "NODE_ENV=production linked start",
     "lint": "eslint \"src/**/*.{js,jsx,ts,tsx}\"",
     "lint:fix": "npm run lint -- --fix",
     "prettier": "prettier \"src/**/*.{js,jsx,ts,tsx,css,scss}\" --check",
@@ -36,11 +42,11 @@
     "web3"
   ],
   "dependencies": {
-    "@_linked/core": "^2.6",
+    "@_linked/core": "^2.10",
     "@_linked/server": "^2.0",
     "@_linked/server-utils": "^1.0.6",
     "@_linked/schema": "^1.0.6",
-    "@_linked/fuseki": "^2.0.1",
+    "@_linked/fuseki": "^1.0",
     "@_linked/primitives": "^1.0.6",
     "@_linked/react": "^1.3",
     "react": "^18.2",
@@ -49,13 +55,12 @@
     "react-router-dom": "^6.3.0"
   },
   "devDependencies": {
-    "@_linked/cli": "^1.4",
+    "@_linked/cli": "^1.8",
     "@types/node": "^20.12.7",
     "@types/react": "^18.0.17",
     "@types/react-dom": "^18.0.6",
     "@typescript-eslint/eslint-plugin": "latest",
     "@typescript-eslint/parser": "latest",
-    "env-cmd": "^10.1.0",
     "eslint": "latest",
     "eslint-config-prettier": "^8.9.0",
     "eslint-import-resolver-typescript": "^3.5.5",

package/defaults/app-with-backend/vite.config.ts

@@ -0,0 +1,13 @@
+// Vite config for new linked apps. Uses the shared createViteConfig
+// helper from @_linked/cli/vite-config so future Vite upgrades propagate
+// to every linked app via a cli bump.
+//
+// Run with:
+//   yarn start          (Vite dev — plan-010 default once stable)
+//   yarn start:webpack  (legacy webpack path — migration escape hatch)
+import {createViteConfig} from '@_linked/cli/vite-config';
+
+export default createViteConfig({
+  port: 4040,
+  cssMode: 'tailwind',
+});

package/defaults/setup-publish/dual-branch/github/workflows/publish.yml

@@ -51,6 +51,9 @@ jobs:
           publish: npx changeset publish
           title: "chore: release"
           commit: "chore: release"
+        # npm auth uses the npm token below. Do NOT switch to OIDC trusted publishing
+        # (id-token: write + publishConfig.provenance) unless you FIRST register this package's
+        # trusted publisher on npmjs.com — otherwise publishes fail with 404 / permission errors.
         env:
           GITHUB_TOKEN: ${{ steps.app-token.outputs.token }}
           NODE_AUTH_TOKEN: ${{ secrets.{{NPM_SECRET_NAME}} }}

package/defaults/setup-publish/github/workflows/publish.yml

@@ -48,6 +48,9 @@ jobs:
           publish: npx changeset publish
           title: 'chore: release'
           commit: 'chore: release'
+        # npm auth uses the npm token below. Do NOT switch to OIDC trusted publishing
+        # (id-token: write + publishConfig.provenance) unless you FIRST register this package's
+        # trusted publisher on npmjs.com — otherwise publishes fail with 404 / permission errors.
         env:
           GITHUB_TOKEN: ${{ steps.app-token.outputs.token }}
           NODE_AUTH_TOKEN: ${{ secrets.{{NPM_SECRET_NAME}} }}

package/defaults/shape.ts

@@ -1,5 +1,11 @@
-import {Shape} from 'lincd/shapes/Shape';
-import {NamedNode} from 'lincd/models';
+// TODO(plan-1.5 / Phase 3 — Shape Builder review): @_linked/core does
+// not export NamedNode as a class. The template needs to be rewritten to
+// match the modern @_linked/* shape pattern — see packages/schema/src/
+// shapes/Person.ts (getter-only, no NamedNode annotation). Import paths
+// updated to @_linked/core to flag intent; current generated output
+// won't compile until the template + downstream tooling are updated.
+import {Shape} from '@_linked/core/shapes/Shape';
+import {NamedNode} from '@_linked/core';
 import {linkedShape} from '../package.js';
 
 @linkedShape

package/lib/cjs/cli-methods.d.ts

@@ -1,4 +1,13 @@
-import { PackageDetails } from './interfaces';
+import type { PackageDetails } from './interfaces.js';
+/**
+ * Dynamically import the app's backend storage configuration. Tries the
+ * canonical `linked.backend.storage.{ts,js}` at app root first, then the
+ * earlier `backend-storage-config.{ts,js}` (Iter3), then the legacy
+ * `scripts/storage-config.js` (pre-rename). The fallback chain lets older
+ * app clones keep booting through the rename.
+ */
+import { ensureEnvironmentLoaded, loadBackendStorageConfig, getLincdPackages } from './lifecycle.js';
+export { ensureEnvironmentLoaded, loadBackendStorageConfig, getLincdPackages };
 export declare const createApp: (name: any, basePath?: string, options?: {
     appName?: string;
     appPrefix?: string;
@@ -10,8 +19,8 @@ export declare function logError(...errors: any[]): void;
 export declare function developPackage(target: any, mode: any): void;
 export declare function runOnPackagesGroupedByDependencies(lincdPackages: any, onBuildStack: (packageGroup: any, dependencies: any) => (pkg: PackageDetails) => Promise<any>, onStackEnd: any, sync?: boolean): Promise<void>;
 export declare function buildAll(options: any): void;
-export declare function getLincdPackages(rootPath?: string): PackageDetails[];
 export declare const createOntology: (prefix: any, uriBase?: any, basePath?: string) => Promise<void>;
+export declare const addLineToIndex: (line: any, insertMatchString: string, root?: string, insertAtStart?: boolean) => string;
 export declare const setNameVariables: (name: any) => {
     hyphenName: any;
     camelCaseName: any;
@@ -32,7 +41,6 @@ invalidImports?: Map<string, {
 }[]>) => Promise<boolean>;
 export declare const depCheckStaged: () => Promise<void>;
 export declare const depCheck: (packagePath?: string) => Promise<unknown>;
-export declare const ensureEnvironmentLoaded: () => Promise<void>;
 export declare const runScript: (scriptName: string, options: {
     spawn: boolean;
 }) => Promise<never>;

package/lib/cjs/cli-methods.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-methods.d.ts","sourceRoot":"","sources":["../../src/cli-methods.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli-methods.d.ts","sourceRoot":"","sources":["../../src/cli-methods.ts"],"names":[],"mappings":"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"}

package/lib/cjs/cli-methods.js

@@ -36,13 +36,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.removeOldFiles = exports.executeCommandForPackage = exports.addCapacitor = exports.addLinesToFile = exports.executeCommandForEachPackage = exports.buildUpdated = exports.publishPackage = exports.publishUpdated = exports.compilePackageCJS = exports.compilePackageESM = exports.compilePackage = exports.buildPackage = exports.register = exports.createPackage = exports.upgradePackages = exports.buildBackend = exports.buildFrontend = exports.buildApp = exports.startServer = exports.runMethod = exports.runScript = exports.ensureEnvironmentLoaded = exports.depCheck = exports.depCheckStaged = exports.checkImports = exports.createComponent = exports.createSetComponent = exports.createShape = exports.getScriptDir = exports.setNameVariables = exports.createOntology = exports.createApp = void 0;
+exports.removeOldFiles = exports.executeCommandForPackage = exports.addCapacitor = exports.addLinesToFile = exports.executeCommandForEachPackage = exports.buildUpdated = exports.publishPackage = exports.publishUpdated = exports.compilePackageCJS = exports.compilePackageESM = exports.compilePackage = exports.buildPackage = exports.register = exports.createPackage = exports.upgradePackages = exports.buildBackend = exports.buildFrontend = exports.buildApp = exports.startServer = exports.runMethod = exports.runScript = exports.depCheck = exports.depCheckStaged = exports.checkImports = exports.createComponent = exports.createSetComponent = exports.createShape = exports.getScriptDir = exports.setNameVariables = exports.addLineToIndex = exports.createOntology = exports.createApp = exports.getLincdPackages = exports.loadBackendStorageConfig = exports.ensureEnvironmentLoaded = void 0;
 exports.warn = warn;
 exports.logError = logError;
 exports.developPackage = developPackage;
 exports.runOnPackagesGroupedByDependencies = runOnPackagesGroupedByDependencies;
 exports.buildAll = buildAll;
-exports.getLincdPackages = getLincdPackages;
 const chalk_1 = __importDefault(require("chalk"));
 const child_process_1 = require("child_process");
 const depcheck_1 = __importDefault(require("depcheck"));
@@ -73,28 +72,14 @@ let dirname__ = typeof __dirname !== 'undefined'
  * `scripts/storage-config.js` (pre-rename). The fallback chain lets older
  * app clones keep booting through the rename.
  */
-async function loadBackendStorageConfig() {
-    const cwd = process.cwd();
-    const candidates = [
-        // Iter4 canonical:
-        path_1.default.join(cwd, 'linked.backend.storage.ts'),
-        path_1.default.join(cwd, 'linked.backend.storage.js'),
-        // Iter3:
-        path_1.default.join(cwd, 'backend-storage-config.ts'),
-        path_1.default.join(cwd, 'backend-storage-config.js'),
-        path_1.default.join(cwd, 'scripts', 'backend-storage-config.js'),
-        path_1.default.join(cwd, 'scripts', 'backend-storage-config.ts'),
-        // legacy pre-rename:
-        path_1.default.join(cwd, 'scripts', 'storage-config.js'),
-    ];
-    for (const candidate of candidates) {
-        if (fs_extra_1.default.existsSync(candidate)) {
-            return Promise.resolve(`${candidate}`).then(s => __importStar(require(s)));
-        }
-    }
-    console.warn(chalk_1.default.yellow('[linked.backend.storage] no linked.backend.storage.{ts,js} found at app root.'));
-    return undefined;
-}
+// Plan-011: extracted to ./lifecycle.ts so the Vite SSR loader doesn't
+// have to graph-walk the rest of cli-methods.ts (which contains many
+// dynamic imports Vite can't analyze). We import for internal callers
+// AND re-export so external consumers can keep importing from here.
+const lifecycle_js_1 = require("./lifecycle.js");
+Object.defineProperty(exports, "ensureEnvironmentLoaded", { enumerable: true, get: function () { return lifecycle_js_1.ensureEnvironmentLoaded; } });
+Object.defineProperty(exports, "loadBackendStorageConfig", { enumerable: true, get: function () { return lifecycle_js_1.loadBackendStorageConfig; } });
+Object.defineProperty(exports, "getLincdPackages", { enumerable: true, get: function () { return lifecycle_js_1.getLincdPackages; } });
 var variables = {};
 /**
  * Prompt user for input
@@ -864,7 +849,7 @@ function getDependentPackages(dependencies, pkg) {
  */
 function getLocalLincdPackageMap(rootPath = './') {
     let map = new Map();
-    getLincdPackages(rootPath).forEach((pkg) => {
+    (0, lifecycle_js_1.getLincdPackages)(rootPath).forEach((pkg) => {
         if (pkg.path.indexOf('../') === -1 && pkg.path.indexOf('..\\') === -1) {
             // console.log(package.path);
             map.set(pkg.packageName, pkg);
@@ -873,33 +858,11 @@ function getLocalLincdPackageMap(rootPath = './') {
     return map;
 }
 function getLocalLincdModules(rootPath = './') {
-    return getLincdPackages(rootPath).filter((pkg) => {
+    return (0, lifecycle_js_1.getLincdPackages)(rootPath).filter((pkg) => {
         return pkg.path.indexOf('..\\') === -1;
     });
 }
-function getLincdPackages(rootPath = process.cwd()) {
-    let pack = (0, utils_js_1.getPackageJSON)(rootPath);
-    if (!pack || !pack.workspaces) {
-        const originalRoot = rootPath;
-        for (let i = 0; i <= 3; i++) {
-            rootPath = path_1.default.join(originalRoot, ...Array(i).fill('..'));
-            pack = (0, utils_js_1.getPackageJSON)(rootPath);
-            if (pack && pack.workspaces) {
-                // log('Found workspace at '+packagePath);
-                break;
-            }
-        }
-    }
-    if (!pack || !pack.workspaces) {
-        // Standalone apps (scaffolded with `linked create-app`) don't have
-        // workspaces — that's expected, just no local packages to scan.
-        return [];
-    }
-    // console.log(pack.workspaces);
-    let res = [];
-    checkWorkspaces(rootPath, pack.workspaces, res);
-    return res;
-}
+// getLincdPackages moved to ./lifecycle.ts and re-exported above.
 function setVariable(name, replacement) {
     //prepare name for regexp
     name = name.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, '\\$&');
@@ -958,11 +921,13 @@ const createOntology = async (prefix, uriBase, basePath = process.cwd()) => {
     //if this is not a lincd app (but a lincd package instead)
     if (!sourceFolder.includes('frontend')) {
         //then also add an import to index
-        let indexPath = addLineToIndex(`import './ontologies/${hyphenName}.js';`, 'ontologies');
+        let indexPath = (0, exports.addLineToIndex)(`import './ontologies/${hyphenName}.js';`, 'ontologies');
         log(`Added an import of this file from ${chalk_1.default.magenta(indexPath)}`);
     }
 };
 exports.createOntology = createOntology;
+// Exported for Shape-Builder reuse (plan-010 T1d.4): CodeShapeSyncService adds
+// the `import './shapes/<Shape>.js';` line to a generated app package's index.
 const addLineToIndex = function (line, insertMatchString, root = process.cwd(), insertAtStart = false) {
     //import ontology in index
     let indexPath = ['index.ts', 'index.tsx']
@@ -972,6 +937,11 @@ const addLineToIndex = function (line, insertMatchString, root = process.cwd(),
     });
     if (indexPath) {
         let indexContents = fs_extra_1.default.readFileSync(indexPath, 'utf-8');
+        // Idempotent: if the exact line is already present, do nothing (re-running
+        // a shape edit must not append a duplicate import).
+        if (indexContents.split(/\n/g).some((l) => l.trim() === line.trim())) {
+            return indexPath;
+        }
         let lines = indexContents.split(/\n/g);
         let newContents;
         for (var key in lines) {
@@ -997,6 +967,7 @@ const addLineToIndex = function (line, insertMatchString, root = process.cwd(),
     }
     return indexPath;
 };
+exports.addLineToIndex = addLineToIndex;
 const replaceVariablesInFiles = function (...files) {
     return Promise.all(files.map((file) => {
         return replaceVariablesInFile(file);
@@ -1137,7 +1108,7 @@ const createShape = async (name, basePath = process.cwd()) => {
     //if this is NOT a lincd app (but a lincd package)
     let indexPath;
     if (!sourceFolder.includes('frontend')) {
-        indexPath = addLineToIndex(`import './shapes/${hyphenName}.js';`, 'shapes');
+        indexPath = (0, exports.addLineToIndex)(`import './shapes/${hyphenName}.js';`, 'shapes');
         log(`Added an import of this file from ${chalk_1.default.magenta(indexPath)}`);
     }
 };
@@ -1153,7 +1124,7 @@ const createSetComponent = async (name, basePath = process.cwd()) => {
     fs_extra_1.default.copySync(path_1.default.join((0, exports.getScriptDir)(), '..', '..', 'defaults', 'component.scss'), targetFile2);
     //replace variables in some of the copied files
     await replaceVariablesInFiles(targetFile, targetFile2);
-    let indexPath = addLineToIndex(`import './components/${hyphenName}.js';`, 'components');
+    let indexPath = (0, exports.addLineToIndex)(`import './components/${hyphenName}.js';`, 'components');
     log(`Created a new set component in ${chalk_1.default.magenta(targetFile.replace(basePath, ''))}`, `Created a new stylesheet in ${chalk_1.default.magenta(targetFile2.replace(basePath, ''))}`, `Added an import of this file from ${chalk_1.default.magenta(indexPath)}`);
 };
 exports.createSetComponent = createSetComponent;
@@ -1173,7 +1144,7 @@ const createComponent = async (name, basePath = process.cwd()) => {
     //if this is not a lincd app (but a lincd package instead)
     if (!sourceFolder.includes('frontend')) {
         //then also add an import to index
-        let indexPath = addLineToIndex(`import './components/${hyphenName}.js';`, 'components');
+        let indexPath = (0, exports.addLineToIndex)(`import './components/${hyphenName}.js';`, 'components');
         log(`Added an import of this file from ${chalk_1.default.magenta(indexPath)}`);
     }
 };
@@ -1191,6 +1162,17 @@ invalidImports = new Map()) => {
     // Start checking each file in the source folder
     for (const file of dir) {
         const filename = path_1.default.join(sourceFolder, file);
+        // plan-011 §P7 — skip test sources. Test files (and their helpers/probes)
+        // are not part of the shipped ESM contract, so the missing-extension rule
+        // isn't load-bearing for them; enforcing it only blocks `linked build`
+        // (the real ESM-output gate stays in force for shipped source). This is
+        // what makes `linked build` green for packages whose tests use
+        // extensionless imports (e.g. @_linked/core).
+        if (/(?:^|[\\/])(?:tests?|__tests__|test-helpers)(?:[\\/]|$)/.test(filename) ||
+            /\.(?:test|spec)\.tsx?$/.test(file) ||
+            /^type-probe.*\.tsx?$/.test(file)) {
+            continue;
+        }
         // File is either a directory, or not a .ts(x)
         // INFO: For future use - if this part fails, it could be due to user permissions
         //  i.e. the program not having access to check the file metadata
@@ -1343,60 +1325,11 @@ const depCheck = async (packagePath = process.cwd()) => {
     });
 };
 exports.depCheck = depCheck;
-const ensureEnvironmentLoaded = async () => {
-    if (!process.env.ENV_VARS_LOADED) {
-        //load env-cmd for development environment
-        let { GetEnvVars } = await Promise.resolve().then(() => __importStar(require('env-cmd')));
-        let envCmdrcPath = path_1.default.join(process.cwd(), '.env-cmdrc.json');
-        if (!fs_extra_1.default.existsSync(envCmdrcPath)) {
-            console.warn('No .env-cmdrc.json found in this folder. Are you running this command from the root of a LINCD app?');
-            process.exit();
-        }
-        let vars = await GetEnvVars({
-            envFile: {
-                filePath: envCmdrcPath,
-            },
-        });
-        let environments = Object.keys(vars);
-        // Snapshot the original shell environment so it always takes highest priority
-        let shellEnv = { ...process.env };
-        //if _main is present, load it first
-        if (environments.includes('_main')) {
-            process.env = { ...process.env, ...vars._main };
-        }
-        //if --env is passed, load that environment
-        let args = process.argv.splice(2);
-        if (args.includes('--env')) {
-            let envIndex = args.indexOf('--env');
-            let env = args[envIndex + 1];
-            env.split(',').forEach((singleEnvironment) => {
-                if (environments.includes(singleEnvironment)) {
-                    console.log('Environment: ' + singleEnvironment);
-                    process.env = { ...process.env, ...vars[singleEnvironment] };
-                }
-                else {
-                    console.warn('Environment ' +
-                        singleEnvironment +
-                        ' not found in .env-cmdrc.json. Available environments: ' +
-                        environments.join(', '));
-                }
-            });
-        }
-        else {
-            //chose development by default
-            process.env = { ...process.env, ...vars.development };
-            console.log('No environment specified, using development');
-        }
-        // Re-apply original shell env vars so they always win over .env-cmdrc.json
-        process.env = { ...process.env, ...shellEnv };
-        process.env.ENV_VARS_LOADED = 'true';
-    }
-};
-exports.ensureEnvironmentLoaded = ensureEnvironmentLoaded;
+// ensureEnvironmentLoaded moved to ./lifecycle.ts and re-exported above.
 const runScript = async (scriptName, options) => {
     //if spawn is not defined, default to true
     const spawn = options.spawn !== undefined ? options.spawn : true;
-    await (0, exports.ensureEnvironmentLoaded)();
+    await (0, lifecycle_js_1.ensureEnvironmentLoaded)();
     if (spawn) {
         await (0, exports.startServer)(true);
     }
@@ -1413,7 +1346,7 @@ const runScript = async (scriptName, options) => {
 };
 exports.runScript = runScript;
 const runMethod = async (packageName, method, options) => {
-    await (0, exports.ensureEnvironmentLoaded)();
+    await (0, lifecycle_js_1.ensureEnvironmentLoaded)();
     if (options.spawn) {
         let linkedConfig = (await Promise.resolve(`${path_1.default.join(process.cwd(), 'linked.config.js')}`).then(s => __importStar(require(s)))).default;
         // Set default loadAppComponent if not provided
@@ -1428,9 +1361,9 @@ const runMethod = async (packageName, method, options) => {
             linkedConfig.server.loadRoutes = async () => await Promise.resolve(`${path_1.default.join(process.cwd(), 'src', 'routes.tsx')}`).then(s => __importStar(require(s)));
         }
         //@ts-ignore
-        const ServerClass = (await Promise.resolve().then(() => __importStar(require('@_linked/server/shapes/LincdServer'))))
-            .LincdServer;
-        await loadBackendStorageConfig();
+        const ServerClass = (await Promise.resolve().then(() => __importStar(require('@_linked/server/shapes/LinkedServer'))))
+            .LinkedServer;
+        await (0, lifecycle_js_1.loadBackendStorageConfig)();
         let server = new ServerClass(linkedConfig);
         //init the server
         console.log('Initializing server...');
@@ -1468,7 +1401,7 @@ const runMethod = async (packageName, method, options) => {
         });
     }
     else {
-        //reuse the existing running LincdServer instance.
+        //reuse the existing running LinkedServer instance.
         //make a HTTP call
         //'/call/:pkg/:method',
         fetch(process.env.SITE_ROOT + '/call/' + packageName + '/' + method, {
@@ -1503,7 +1436,7 @@ const runMethod = async (packageName, method, options) => {
 };
 exports.runMethod = runMethod;
 const startServer = async (initOnly = false, ServerClass = null) => {
-    await (0, exports.ensureEnvironmentLoaded)();
+    await (0, lifecycle_js_1.ensureEnvironmentLoaded)();
     let linkedConfig = (await Promise.resolve(`${path_1.default.join(process.cwd(), 'linked.config.js')}`).then(s => __importStar(require(s))))
         .default;
     // function scssLoadcall(source, filename) {
@@ -1518,9 +1451,9 @@ const startServer = async (initOnly = false, ServerClass = null) => {
     // hook.hook('.module.css', scssLoadcall);
     if (!ServerClass) {
         //@ts-ignore
-        ServerClass = (await Promise.resolve().then(() => __importStar(require('@_linked/server/shapes/LincdServer')))).LincdServer;
+        ServerClass = (await Promise.resolve().then(() => __importStar(require('@_linked/server/shapes/LinkedServer')))).LinkedServer;
     }
-    await loadBackendStorageConfig();
+    await (0, lifecycle_js_1.loadBackendStorageConfig)();
     // Set default loadAppComponent if not provided
     if (!linkedConfig.server) {
         linkedConfig.server = {};
@@ -1570,8 +1503,12 @@ const buildApp = async () => {
 };
 exports.buildApp = buildApp;
 const buildFrontend = async () => {
-    await (0, exports.ensureEnvironmentLoaded)();
-    const webpackAppConfig = await (await Promise.resolve().then(() => __importStar(require('./config-webpack-app.js')))).getWebpackAppConfig();
+    await (0, lifecycle_js_1.ensureEnvironmentLoaded)();
+    // @vite-ignore — the webpack build path is legacy code, only reached
+    // by `linked build-frontend` which is not part of the Vite dev/SSR
+    // flow. Tell Vite not to graph-walk into it so we don't emit
+    // import-analysis warnings for a file we never load via SSR.
+    const webpackAppConfig = await (await Promise.resolve().then(() => __importStar(require(/* @vite-ignore */ './config-webpack-app.js')))).getWebpackAppConfig();
     console.log(chalk_1.default.magenta(`🛠 Building ${process.env.NODE_ENV} frontend bundles`));
     await new Promise((resolve, reject) => {
         (0, webpack_1.default)(webpackAppConfig, async (err, stats) => {
@@ -1621,7 +1558,7 @@ const buildFrontend = async () => {
             // process.exit();
         }
         // load the storage config
-        const storageConfig = await loadBackendStorageConfig();
+        const storageConfig = await (0, lifecycle_js_1.loadBackendStorageConfig)();
         // check if LincdFileStorage has a default FileStore
         // if yes: copy all the files in the build folder over with LincdFileStorage
         if (LinkedFileStorage_1.LinkedFileStorage.getDefaultDataset()) {
@@ -1662,7 +1599,7 @@ exports.buildFrontend = buildFrontend;
 const buildBackend = async () => {
     console.log(chalk_1.default.magenta(`🛠 Preparing ${process.env.NODE_ENV} backend`));
     //run tsc in the backend folder
-    await (0, exports.ensureEnvironmentLoaded)();
+    await (0, lifecycle_js_1.ensureEnvironmentLoaded)();
     const sourceFolder = path_1.default.join(process.cwd(), 'src');
     const targetFolder = path_1.default.join(process.cwd(), 'lib');
     // Step 1: Clear lib folder
@@ -1721,7 +1658,7 @@ const buildBackend = async () => {
 };
 exports.buildBackend = buildBackend;
 const upgradePackages = async () => {
-    await (0, exports.ensureEnvironmentLoaded)();
+    await (0, lifecycle_js_1.ensureEnvironmentLoaded)();
     // let packages = getLincdPackages();
     // let packages = getLocalLincdModules();
     let packages = getLocalLincdPackageMap();
@@ -2662,7 +2599,7 @@ var addCapacitor = async function (basePath = process.cwd()) {
 };
 exports.addCapacitor = addCapacitor;
 var executeCommandForPackage = function (packageName, command) {
-    let packageDetails = getLincdPackages().find((modDetails) => modDetails.packageName.indexOf(packageName) !== -1 ||
+    let packageDetails = (0, lifecycle_js_1.getLincdPackages)().find((modDetails) => modDetails.packageName.indexOf(packageName) !== -1 ||
         modDetails.packageName.indexOf(packageName) !== -1);
     if (packageDetails) {
         log("Executing 'cd " +