@equinor/fusion-framework-cli 13.3.18 → 14.0.0

package/dist/esm/lib/app/app-manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-manifest.js","sourceRoot":"","sources":["../../../../src/lib/app/app-manifest.ts"],"names":[],"mappings":"AA6BA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,EAAiB,EAAE,EAAE,CAAC,EAAE,CAAC"}
+{"version":3,"file":"app-manifest.js","sourceRoot":"","sources":["../../../../src/lib/app/app-manifest.ts"],"names":[],"mappings":"AA+BA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,EAAiB,EAAE,EAAE,CAAC,EAAE,CAAC"}

package/dist/esm/lib/app/index.js

@@ -1,4 +1,12 @@
-export { defineAppManifest } from './app-manifest.js';
+/**
+ * Application manifest and configuration utilities for `@equinor/fusion-framework-cli/app`.
+ *
+ * Provides helpers for defining, loading, merging, and validating Fusion application
+ * manifests and configurations.
+ *
+ * @packageDocumentation
+ */
+export { defineAppManifest, } from './app-manifest.js';
 export { createAppManifestFromPackage } from './create-app-manifest.js';
 export { mergeAppManifests } from './merge-app-manifest.js';
 export { loadAppManifest } from './load-app-manifest.js';

package/dist/esm/lib/app/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/app/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAwC,MAAM,mBAAmB,CAAC;AAC5F,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAA0B,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAoC,MAAM,iBAAiB,CAAC;AACpF,OAAO,EAAE,aAAa,EAAwB,MAAM,sBAAsB,CAAC;AAE3E,OAAO,EAAE,kBAAkB,EAAqB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/app/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,iBAAiB,GAGlB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAA0B,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAoC,MAAM,iBAAiB,CAAC;AACpF,OAAO,EAAE,aAAa,EAAwB,MAAM,sBAAsB,CAAC;AAE3E,OAAO,EAAE,kBAAkB,EAAqB,MAAM,cAAc,CAAC"}

package/dist/esm/lib/app/load-app-manifest.js

@@ -43,10 +43,11 @@ export const loadAppManifest = async (env, options) => {
                 // If the module's default export is a function, invoke it with the environment and base manifest
                 if (typeof module.default === 'function') {
                     const result = await module.default(env, { base });
-                    return mergeAppManifests(base, result ?? {}); // Merge and cast to Record<string, unknown>
+                    // Cast result to RecursivePartial<AppManifest> to handle RouteNode routes that will be serialized later
+                    return mergeAppManifests(base, (result ?? {}));
                 }
                 // If the module's default export is not a function, treat it as a manifest object
-                return mergeAppManifests(base, module.default ?? {});
+                return mergeAppManifests(base, (module.default ?? {}));
             },
         },
     });

package/dist/esm/lib/app/load-app-manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-app-manifest.js","sourceRoot":"","sources":["../../../../src/lib/app/load-app-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAMvD,OAAO,iBAAiB,MAAM,yBAAyB,CAAC;AAyCxD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAClC,GAAe,EACf,OAAgC,EACA,EAAE;IAClC,gDAAgD;IAChD,MAAM,WAAW,GAAG,OAAO,EAAE,IAAI,IAAI;QACnC,gBAAgB,GAAG,CAAC,WAAW,EAAE;QACjC,cAAc;QACd,qBAAqB;KACtB,CAAC;IACF,kEAAkE;IAClE,MAAM,YAAY,GAAG,MAAM,YAAY,CACrC,WAAW,EACX;QACE,OAAO,EAAE,GAAG,CAAC,IAAI;QACjB,UAAU,EAAE,OAAO,EAAE,UAAU;QAC/B,MAAM,EAAE;YACN;;;;;;;;;eASG;YACH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACxB,MAAM,IAAI,GAAgB,OAAO,EAAE,IAAI,IAAK,EAAkB,CAAC,CAAC,gDAAgD;gBAChH,iGAAiG;gBACjG,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;oBACzC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;oBACnD,OAAO,iBAAiB,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,4CAA4C;gBAC5F,CAAC;gBACD,kFAAkF;gBAClF,OAAO,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YACvD,CAAC;SACF;KACF,CACF,CAAC;IACF,uEAAuE;IACvE,6GAA6G;IAC7G,OAAO;QACL,QAAQ,EAAE,YAAY,CAAC,MAAM;QAC7B,IAAI,EAAE,YAAY,CAAC,IAAI;QACvB,SAAS,EAAE,YAAY,CAAC,SAAS;KAClC,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"load-app-manifest.js","sourceRoot":"","sources":["../../../../src/lib/app/load-app-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAOvD,OAAO,iBAAiB,MAAM,yBAAyB,CAAC;AAyCxD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAClC,GAAe,EACf,OAAgC,EACA,EAAE;IAClC,gDAAgD;IAChD,MAAM,WAAW,GAAG,OAAO,EAAE,IAAI,IAAI;QACnC,gBAAgB,GAAG,CAAC,WAAW,EAAE;QACjC,cAAc;QACd,qBAAqB;KACtB,CAAC;IACF,kEAAkE;IAClE,MAAM,YAAY,GAAG,MAAM,YAAY,CACrC,WAAW,EACX;QACE,OAAO,EAAE,GAAG,CAAC,IAAI;QACjB,UAAU,EAAE,OAAO,EAAE,UAAU;QAC/B,MAAM,EAAE;YACN;;;;;;;;;eASG;YACH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACxB,MAAM,IAAI,GAAgB,OAAO,EAAE,IAAI,IAAK,EAAkB,CAAC,CAAC,gDAAgD;gBAChH,iGAAiG;gBACjG,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;oBACzC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;oBACnD,wGAAwG;oBACxG,OAAO,iBAAiB,CAAC,IAAI,EAAE,CAAC,MAAM,IAAI,EAAE,CAAkC,CAAC,CAAC;gBAClF,CAAC;gBACD,kFAAkF;gBAClF,OAAO,iBAAiB,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAkC,CAAC,CAAC;YAC1F,CAAC;SACF;KACF,CACF,CAAC;IACF,uEAAuE;IACvE,6GAA6G;IAC7G,OAAO;QACL,QAAQ,EAAE,YAAY,CAAC,MAAM;QAC7B,IAAI,EAAE,YAAY,CAAC,IAAI;QACvB,SAAS,EAAE,YAAY,CAAC,SAAS;KAClC,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/lib/dev-server.js

@@ -1,3 +1,11 @@
+/**
+ * Dev-server re-exports for `@equinor/fusion-framework-cli/dev-server`.
+ *
+ * Aggregates service processing, configuration loading/merging, and type
+ * definitions used when working with the Fusion dev server.
+ *
+ * @packageDocumentation
+ */
 export { processServices } from '@equinor/fusion-framework-dev-server';
 export { loadDevServerConfig, defineDevServerConfig, } from './load-dev-server-config.js';
 export { mergeDevServerConfig } from './merge-dev-server-config.js';

package/dist/esm/lib/dev-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev-server.js","sourceRoot":"","sources":["../../../src/lib/dev-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EACL,mBAAmB,EACnB,qBAAqB,GAGtB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"dev-server.js","sourceRoot":"","sources":["../../../src/lib/dev-server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EACL,mBAAmB,EACnB,qBAAqB,GAGtB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/esm/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAwB,MAAM,4BAA4B,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,OAAO,EACL,mBAAmB,EACnB,qBAAqB,GAGtB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,eAAe,GAIhB,MAAM,wBAAwB,CAAC;AAEhC,mEAAmE;AACnE,kDAAkD;AAClD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,cAAc,EAAwB,MAAM,4BAA4B,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,OAAO,EACL,mBAAmB,EACnB,qBAAqB,GAGtB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,eAAe,GAIhB,MAAM,wBAAwB,CAAC;AAEhC,mEAAmE;AACnE,kDAAkD;AAClD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/esm/lib/portal/index.js

@@ -1,3 +1,11 @@
+/**
+ * Portal manifest, configuration, and schema utilities for `@equinor/fusion-framework-cli/portal`.
+ *
+ * Provides helpers for defining, loading, merging, and validating Fusion portal
+ * manifests, configurations, and schemas.
+ *
+ * @packageDocumentation
+ */
 export { createPortalManifestFromPackage, definePortalManifest, loadPortalManifest, validatePortalManifest, } from './portal-manifest.js';
 export { loadPortalSchema, definePortalSchema, } from './load-portal-schema.js';
 export { definePortalConfig, } from './portal-config.js';

package/dist/esm/lib/portal/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/portal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,GAIvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,GAInB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,kBAAkB,GAGnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,GAEjB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/portal/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,+BAA+B,EAC/B,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,GAIvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,GAInB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,kBAAkB,GAGnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,GAEjB,MAAM,yBAAyB,CAAC"}

package/dist/esm/lib/portal/portal-manifest.js

@@ -2,7 +2,26 @@ import { PortalManifestSchema } from './portal-manifest.schema.js';
 // Re-export relevant manifest utilities and types for external use
 export { loadPortalManifest, } from './load-portal-manifest.js';
 export { createPortalManifestFromPackage } from './create-portal-manifest.js';
-// Helper to define a typed portal manifest function
+/**
+ * Utility to define a portal manifest function with proper typing.
+ *
+ * This is a no-op at runtime — it returns the provided function unchanged.
+ * It exists to provide type safety and editor support when authoring portal manifest files.
+ *
+ * @template T - The portal manifest type, extending `PortalManifestSchemaType`.
+ * @param fn - A function that receives the runtime environment and base manifest, and returns manifest overrides.
+ * @returns The provided function, unchanged.
+ *
+ * @example
+ * ```ts
+ * import { definePortalManifest } from '@equinor/fusion-framework-cli/portal';
+ *
+ * export default definePortalManifest((env, { base }) => ({
+ *   ...base,
+ *   name: 'my-portal',
+ * }));
+ * ```
+ */
 export const definePortalManifest = (fn) => fn;
 export { PortalManifestSchema, PortalManifestBuildSchema, } from './portal-manifest.schema.js';
 /**

package/dist/esm/lib/portal/portal-manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"portal-manifest.js","sourceRoot":"","sources":["../../../../src/lib/portal/portal-manifest.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,mEAAmE;AACnE,OAAO,EACL,kBAAkB,GAGnB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAE9E,oDAAoD;AACpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAqC,EAAuB,EAAE,EAAE,CAClG,EAAE,CAAC;AAEL,OAAO,EACL,oBAAoB,EACpB,yBAAyB,GAG1B,MAAM,6BAA6B,CAAC;AAErC;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAiB;IACtD,8DAA8D;IAC9D,OAAO,oBAAoB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"portal-manifest.js","sourceRoot":"","sources":["../../../../src/lib/portal/portal-manifest.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,mEAAmE;AACnE,OAAO,EACL,kBAAkB,GAGnB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAqC,EAAuB,EAAE,EAAE,CAClG,EAAE,CAAC;AAEL,OAAO,EACL,oBAAoB,EACpB,yBAAyB,GAG1B,MAAM,6BAA6B,CAAC;AAErC;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAiB;IACtD,8DAA8D;IAC9D,OAAO,oBAAoB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAC9C,CAAC"}

package/dist/esm/lib/utils/expect.js

@@ -1,4 +1,20 @@
 import assert from 'node:assert';
+/**
+ * Lightweight assertion helper that provides a fluent API for value checks.
+ *
+ * Returns an object with `toBe` and `toBeInstanceOf` methods for asserting
+ * equality and type, respectively. Intended for internal CLI validation logic.
+ *
+ * @template T - The type of the value being asserted.
+ * @param value - The value to assert against.
+ * @returns An object with `toBe` and `toBeInstanceOf` assertion methods.
+ *
+ * @example
+ * ```ts
+ * expect(status).toBe(200, 'expected HTTP 200');
+ * expect(result).toBeInstanceOf('object', 'expected an object');
+ * ```
+ */
 export const expect = (value) => {
     return {
         toBe: (expected, message) => {
@@ -9,7 +25,6 @@ export const expect = (value) => {
                     value,
                 },
             }));
-            return this;
         },
         toBeInstanceOf: (expected, message) => {
             const actual = typeof value;
@@ -20,7 +35,6 @@ export const expect = (value) => {
                     value: value === undefined ? 'undefined' : value,
                 },
             }));
-            return this;
         },
     };
 };

package/dist/esm/lib/utils/expect.js.map

@@ -1 +1 @@
-{"version":3,"file":"expect.js","sourceRoot":"","sources":["../../../../src/lib/utils/expect.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAI,KAAQ,EAAE,EAAE;IACpC,OAAO;QACL,IAAI,EAAE,CAAC,QAAW,EAAE,OAAe,EAAoB,EAAE;YACvD,MAAM,CACJ,KAAK,KAAK,QAAQ,EAClB,KAAK,CAAC,OAAO,EAAE;gBACb,KAAK,EAAE;oBACL,QAAQ;oBACR,MAAM,EAAE,KAAK;oBACb,KAAK;iBACN;aACF,CAAC,CACH,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,cAAc,EAAE,CAAC,QAAsB,EAAE,OAAe,EAAoB,EAAE;YAC5E,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC;YAC5B,MAAM,CACJ,MAAM,KAAK,QAAQ,EACnB,KAAK,CAAC,OAAO,EAAE;gBACb,KAAK,EAAE;oBACL,QAAQ;oBACR,MAAM;oBACN,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK;iBACjD;aACF,CAAC,CACH,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"expect.js","sourceRoot":"","sources":["../../../../src/lib/utils/expect.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAI,KAAQ,EAAE,EAAE;IACpC,OAAO;QACL,IAAI,EAAE,CAAC,QAAW,EAAE,OAAe,EAAQ,EAAE;YAC3C,MAAM,CACJ,KAAK,KAAK,QAAQ,EAClB,KAAK,CAAC,OAAO,EAAE;gBACb,KAAK,EAAE;oBACL,QAAQ;oBACR,MAAM,EAAE,KAAK;oBACb,KAAK;iBACN;aACF,CAAC,CACH,CAAC;QACJ,CAAC;QACD,cAAc,EAAE,CAAC,QAAsB,EAAE,OAAe,EAAQ,EAAE;YAChE,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC;YAC5B,MAAM,CACJ,MAAM,KAAK,QAAQ,EACnB,KAAK,CAAC,OAAO,EAAE;gBACb,KAAK,EAAE;oBACL,QAAQ;oBACR,MAAM;oBACN,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK;iBACjD;aACF,CAAC,CACH,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/lib/utils/file-exists.js

@@ -1,5 +1,19 @@
 import { accessSync, constants } from 'node:fs';
 import { access } from 'node:fs/promises';
+/**
+ * Synchronously checks whether a file exists at the given path.
+ *
+ * @param file - Absolute or relative file path to check.
+ * @param options - When `assert` is true, the underlying `ENOENT` error is re-thrown instead of returning `false`.
+ * @returns `true` if the file is accessible, `false` otherwise (unless `assert` is set).
+ *
+ * @example
+ * ```ts
+ * if (fileExistsSync('tsconfig.json')) {
+ *   // file is present
+ * }
+ * ```
+ */
 export const fileExistsSync = (file, options) => {
     try {
         accessSync(file, constants.F_OK);
@@ -12,6 +26,20 @@ export const fileExistsSync = (file, options) => {
         return false;
     }
 };
+/**
+ * Asynchronously checks whether a file exists at the given path.
+ *
+ * @param file - Absolute or relative file path to check.
+ * @param options - When `assert` is true, the underlying `ENOENT` error is re-thrown instead of resolving to `false`.
+ * @returns A promise that resolves to `true` if the file is accessible, `false` otherwise (unless `assert` is set).
+ *
+ * @example
+ * ```ts
+ * if (await fileExists('app.manifest.ts')) {
+ *   // file is present
+ * }
+ * ```
+ */
 export const fileExists = async (file, options) => {
     try {
         await access(file, constants.F_OK);

package/dist/esm/lib/utils/file-exists.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-exists.js","sourceRoot":"","sources":["../../../../src/lib/utils/file-exists.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAI1C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,OAAiB,EAAE,EAAE;IAChE,IAAI,CAAC;QACH,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAE,IAAY,EAAE,OAAiB,EAAoB,EAAE;IACpF,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"file-exists.js","sourceRoot":"","sources":["../../../../src/lib/utils/file-exists.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAQ1C;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,OAAiB,EAAE,EAAE;IAChE,IAAI,CAAC;QACH,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAE,IAAY,EAAE,OAAiB,EAAoB,EAAE;IACpF,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC"}

package/dist/esm/lib/utils/index.js

@@ -1,3 +1,11 @@
+/**
+ * Shared utility functions for the Fusion Framework CLI.
+ *
+ * Includes assertion helpers, file-system utilities, package resolution,
+ * annotation resolvers, and snapshot version generation.
+ *
+ * @packageDocumentation
+ */
 export { assert } from './assert.js';
 export { resolveEntryPoint } from './resolve-source-entry-point.js';
 export { resolvePackage } from './resolve-package.js';

package/dist/esm/lib/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAwB,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAwB,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC"}

package/dist/esm/version.js

@@ -1,3 +1,3 @@
 // Generated by genversion.
-export const version = '13.3.18';
+export const version = '14.0.0';
 //# sourceMappingURL=version.js.map

package/dist/types/bin/app-config-publish.d.ts

@@ -1,6 +1,15 @@
 import type { FusionFramework } from './framework.node.js';
 import { type ConsoleLogger } from './utils/index.js';
 import type { ApiAppConfig } from '../lib/app/schemas.js';
+/**
+ * Options for publishing an application configuration to the app service.
+ *
+ * @property config - The validated application configuration object to publish.
+ * @property appKey - The unique key identifying the application in the app store.
+ * @property buildVersion - The build version to associate the config with.
+ * @property framework - The initialized FusionFramework instance for service discovery.
+ * @property log - Optional logger for outputting progress and debug information.
+ */
 type AppConfigPublishOptions = {
     config: ApiAppConfig;
     appKey: string;

package/dist/types/bin/app-serve.d.ts

@@ -0,0 +1,49 @@
+import type { ConsoleLogger } from './utils/index.js';
+/**
+ * Options for serving a built application.
+ * @public
+ */
+export interface ServeApplicationOptions {
+    /**
+     * Path to the application manifest file.
+     */
+    manifest?: string;
+    /**
+     * Path to the application config file.
+     */
+    config?: string;
+    /**
+     * Directory to serve (optional, will detect from build config if not provided).
+     */
+    dir?: string;
+    /**
+     * Port for the preview server (optional, defaults to 4173).
+     */
+    port?: number;
+    /**
+     * Host for the preview server (optional, defaults to 'localhost').
+     */
+    host?: string;
+    /**
+     * Logger instance for outputting progress and debug information (optional).
+     */
+    log?: ConsoleLogger | null;
+    /**
+     * Enable debug mode for verbose logging.
+     */
+    debug?: boolean;
+}
+/**
+ * Serves a built application using the dev-portal.
+ *
+ * This function loads the application manifest and Vite configuration to determine
+ * the build output directory, then starts a dev server with the portal to serve
+ * the built files in a production-like environment.
+ *
+ * @param options - Options for serving the application including port, host, and logger.
+ * @returns A promise that resolves when the preview server has started.
+ * @throws Will throw if the build directory doesn't exist or if serving fails.
+ * @public
+ */
+export declare const serveApplication: (options?: ServeApplicationOptions) => Promise<import("vite").ViteDevServer>;
+export default serveApplication;

package/dist/types/bin/index.d.ts

@@ -1,8 +1,19 @@
+/**
+ * Binary / command-handler API for `@equinor/fusion-framework-cli/bin`.
+ *
+ * Exports the programmatic entry points for every CLI operation —
+ * build, pack, upload, publish, tag, dev-server, and framework
+ * initialisation — so they can be consumed by both the CLI and
+ * third-party automation scripts.
+ *
+ * @packageDocumentation
+ */
 export { buildApplication } from './app-build.js';
 export { bundleApp } from './app-pack.js';
 export { generateApplicationConfig } from './app-config.js';
 export { publishAppConfig } from './app-config-publish.js';
 export { startAppDevServer } from './app-dev.js';
+export { serveApplication, type ServeApplicationOptions } from './app-serve.js';
 export { checkApp } from './app-check.js';
 export { loadAppManifest } from './app-manifest.js';
 export { uploadApplication } from './app-upload.js';

package/dist/types/bin/portal-config-publish.d.ts

@@ -1,5 +1,15 @@
 import { type FusionEnv, type FusionFrameworkSettings } from './framework.node.js';
 import { type ConsoleLogger } from './utils/index.js';
+/**
+ * Options for publishing a portal configuration to the portal service.
+ *
+ * @property config - Optional path to a custom portal config file.
+ * @property portal - Portal identification with name and version.
+ * @property environment - The target Fusion environment (excludes Development).
+ * @property auth - Authentication settings for the Fusion Framework.
+ * @property debug - Enable debug mode for verbose logging.
+ * @property log - Optional logger for outputting progress and debug information.
+ */
 type PortalConfigPublishOptions = {
     config?: string;
     portal: {

package/dist/types/bin/utils/index.d.ts

@@ -1,3 +1,12 @@
+/**
+ * Shared CLI display and server utilities.
+ *
+ * Provides formatting helpers, spinner/logger abstractions,
+ * dev-server factory functions, and default HTTP headers used
+ * across all Fusion CLI commands.
+ *
+ * @packageDocumentation
+ */
 export { formatPath, formatByteSize, chalk } from './format.js';
 export { Spinner } from './spinner.js';
 export { ConsoleLogger } from './ConsoleLogger.js';

package/dist/types/cli/commands/app/serve.d.ts

@@ -0,0 +1,34 @@
+/**
+ * CLI command: `serve`
+ *
+ * Serves a built application using the dev-portal.
+ *
+ * Features:
+ * - Serves the built application through the dev-portal (similar to dev command).
+ * - Automatically detects the build directory from Vite configuration.
+ * - Supports custom port, host, directory, manifest, and config options.
+ * - Provides a debug mode for verbose logging.
+ *
+ * Usage:
+ *   $ ffc app serve
+ *   $ ffc app serve --port 5000
+ *   $ ffc app serve --dir ./dist --host 0.0.0.0
+ *
+ * Options:
+ *   --port <port>        Port for the preview server (default: 4173)
+ *   --host <host>        Host for the preview server (default: localhost)
+ *   --dir <directory>    Directory to serve (default: detected from build config)
+ *   --manifest <path>    Path to the app manifest file
+ *   --config <path>      Path to the app config file
+ *   -d, --debug          Enable debug mode for verbose logging
+ *
+ * Example:
+ *   $ ffc app serve
+ *   $ ffc app serve --port 5000 --host 0.0.0.0
+ *   $ ffc app serve --dir ./dist
+ *   $ ffc app serve --manifest app.manifest.prod.ts --config app.config.prod.ts
+ *
+ * @see serveApplication for implementation details
+ */
+export declare const command: import("commander").Command;
+export default command;

package/dist/types/cli/commands/index.d.ts

@@ -1,3 +1,12 @@
 import type { Command } from 'commander';
+/**
+ * Registers all built-in CLI commands and optional plugins on the Commander program.
+ *
+ * Built-in command groups: `app`, `auth`, `create`, `disco`, `portal`.
+ * After registering built-in commands, loads any plugins declared in the
+ * project's `fusion-cli.config` file.
+ *
+ * @param program - The Commander program instance to register commands on.
+ */
 declare const _default: (program: Command) => Promise<void>;
 export default _default;

package/dist/types/lib/app/app-manifest.d.ts

@@ -1,5 +1,6 @@
 import type { AppManifest } from '@equinor/fusion-framework-module-app';
 import type { RuntimeEnv } from '@equinor/fusion-framework-cli/lib';
+import type { RecursivePartial } from '../utils/types.js';
 /**
  * Type representing the application manifest structure used by the Fusion Framework.
  * Imported from the '@equinor/fusion-framework-module-app' package for consistency across modules.
@@ -8,21 +9,22 @@ export type { AppManifest } from '@equinor/fusion-framework-module-app';
 /**
  * Function type for loading or modifying an application manifest.
  *
- * @template T - A type extending Partial<AppManifest>, defaults to Partial<AppManifest>.
+ * @template T - A type extending AppManifest.
  * @param env - The runtime environment (see '../types').
  * @param args - Object containing the base manifest (`base`) of type T.
- * @returns The modified manifest of type T, a promise resolving to T, or void if no changes are made.
+ * @returns A partial manifest that will be merged with the base, void if no changes, or a promise resolving to either.
  *
  * Usage: Implement this type to create functions that dynamically adjust the manifest based on environment or other factors.
  *
  * Inline notes:
- * - This type is generic to allow for partial or full manifest overrides.
+ * - This type accepts partial manifests that will be merged with the base manifest.
  * - Returning void allows for side-effect-only functions, but returning the manifest is preferred for clarity.
+ * - Routes can be RouteNode | RouteNode[] (from router package) or RouteSchemaEntry[] (serialized format).
  */
 export type AppManifestFn<T extends AppManifest = AppManifest> = (env: RuntimeEnv, // The runtime environment, e.g., 'development', 'production', etc.
 args: {
     base: T;
-}) => T | void | Promise<T | void>;
+}) => RecursivePartial<T> | undefined | Promise<RecursivePartial<T> | undefined>;
 /**
  * Utility to define an application manifest in a type-safe and organized manner.
  *

package/dist/types/lib/app/index.d.ts

@@ -1,4 +1,13 @@
-export { defineAppManifest, type AppManifestFn, type AppManifest } from './app-manifest.js';
+/**
+ * Application manifest and configuration utilities for `@equinor/fusion-framework-cli/app`.
+ *
+ * Provides helpers for defining, loading, merging, and validating Fusion application
+ * manifests and configurations.
+ *
+ * @packageDocumentation
+ */
+export { defineAppManifest, type AppManifestFn, type AppManifest, } from './app-manifest.js';
+export type { RouteSchemaEntry } from '@equinor/fusion-framework-module-app';
 export { createAppManifestFromPackage } from './create-app-manifest.js';
 export { mergeAppManifests } from './merge-app-manifest.js';
 export { loadAppManifest, type AppManifestExport } from './load-app-manifest.js';

package/dist/types/lib/dev-server.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Dev-server re-exports for `@equinor/fusion-framework-cli/dev-server`.
+ *
+ * Aggregates service processing, configuration loading/merging, and type
+ * definitions used when working with the Fusion dev server.
+ *
+ * @packageDocumentation
+ */
 export { processServices } from '@equinor/fusion-framework-dev-server';
 export { loadDevServerConfig, defineDevServerConfig, type DevServerConfigFn, type DevServerConfigExport, } from './load-dev-server-config.js';
 export { mergeDevServerConfig } from './merge-dev-server-config.js';

package/dist/types/lib/index.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Public library API for `@equinor/fusion-framework-cli`.
+ *
+ * Re-exports configuration helpers, dev-server utilities, and package resolution
+ * functions used by consumers to configure Fusion CLI projects.
+ *
+ * @packageDocumentation
+ */
 export type { RuntimeEnv } from './types.js';
 export { resolvePackage, type ResolvedPackage } from './utils/resolve-package.js';
 export { resolveEntryPoint } from './utils/resolve-source-entry-point.js';

package/dist/types/lib/portal/index.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Portal manifest, configuration, and schema utilities for `@equinor/fusion-framework-cli/portal`.
+ *
+ * Provides helpers for defining, loading, merging, and validating Fusion portal
+ * manifests, configurations, and schemas.
+ *
+ * @packageDocumentation
+ */
 export { createPortalManifestFromPackage, definePortalManifest, loadPortalManifest, validatePortalManifest, type PortalManifest, type PortalManifestExport, type PortalManifestFn, } from './portal-manifest.js';
 export { loadPortalSchema, definePortalSchema, type PortalSchema, type PortalSchemaExport, type PortalSchemaFn, } from './load-portal-schema.js';
 export { definePortalConfig, type PortalConfig, type PortalConfigFn, } from './portal-config.js';

package/dist/types/lib/portal/portal-manifest.d.ts

@@ -2,6 +2,26 @@ import type { PortalManifestFn } from './load-portal-manifest.js';
 import type { PortalManifestSchemaType } from './portal-manifest.schema.js';
 export { loadPortalManifest, type PortalManifestExport, type PortalManifestFn, } from './load-portal-manifest.js';
 export { createPortalManifestFromPackage } from './create-portal-manifest.js';
+/**
+ * Utility to define a portal manifest function with proper typing.
+ *
+ * This is a no-op at runtime — it returns the provided function unchanged.
+ * It exists to provide type safety and editor support when authoring portal manifest files.
+ *
+ * @template T - The portal manifest type, extending `PortalManifestSchemaType`.
+ * @param fn - A function that receives the runtime environment and base manifest, and returns manifest overrides.
+ * @returns The provided function, unchanged.
+ *
+ * @example
+ * ```ts
+ * import { definePortalManifest } from '@equinor/fusion-framework-cli/portal';
+ *
+ * export default definePortalManifest((env, { base }) => ({
+ *   ...base,
+ *   name: 'my-portal',
+ * }));
+ * ```
+ */
 export declare const definePortalManifest: <T extends PortalManifestSchemaType>(fn: PortalManifestFn<T>) => PortalManifestFn<T>;
 export { PortalManifestSchema, PortalManifestBuildSchema, PortalManifestSchemaType as PortalManifest, type PortalManifestBuildSchemaType as PortalManifestBuild, } from './portal-manifest.schema.js';
 /**

package/dist/types/lib/utils/expect.d.ts

@@ -1,4 +1,20 @@
+/**
+ * Lightweight assertion helper that provides a fluent API for value checks.
+ *
+ * Returns an object with `toBe` and `toBeInstanceOf` methods for asserting
+ * equality and type, respectively. Intended for internal CLI validation logic.
+ *
+ * @template T - The type of the value being asserted.
+ * @param value - The value to assert against.
+ * @returns An object with `toBe` and `toBeInstanceOf` assertion methods.
+ *
+ * @example
+ * ```ts
+ * expect(status).toBe(200, 'expected HTTP 200');
+ * expect(result).toBeInstanceOf('object', 'expected an object');
+ * ```
+ */
 export declare const expect: <T>(value: T) => {
-    toBe: (expected: T, message: string) => asserts expected;
-    toBeInstanceOf: (expected: typeof value, message: string) => asserts expected;
+    toBe: (expected: T, message: string) => void;
+    toBeInstanceOf: (expected: typeof value, message: string) => void;
 };

package/dist/types/lib/utils/file-exists.d.ts

@@ -1,6 +1,36 @@
+/** Options for file existence checks. */
 type Options = {
+    /** If true, throws the underlying error instead of returning false. */
     assert?: boolean;
 };
+/**
+ * Synchronously checks whether a file exists at the given path.
+ *
+ * @param file - Absolute or relative file path to check.
+ * @param options - When `assert` is true, the underlying `ENOENT` error is re-thrown instead of returning `false`.
+ * @returns `true` if the file is accessible, `false` otherwise (unless `assert` is set).
+ *
+ * @example
+ * ```ts
+ * if (fileExistsSync('tsconfig.json')) {
+ *   // file is present
+ * }
+ * ```
+ */
 export declare const fileExistsSync: (file: string, options?: Options) => boolean;
+/**
+ * Asynchronously checks whether a file exists at the given path.
+ *
+ * @param file - Absolute or relative file path to check.
+ * @param options - When `assert` is true, the underlying `ENOENT` error is re-thrown instead of resolving to `false`.
+ * @returns A promise that resolves to `true` if the file is accessible, `false` otherwise (unless `assert` is set).
+ *
+ * @example
+ * ```ts
+ * if (await fileExists('app.manifest.ts')) {
+ *   // file is present
+ * }
+ * ```
+ */
 export declare const fileExists: (file: string, options?: Options) => Promise<boolean>;
 export {};

package/dist/types/lib/utils/index.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Shared utility functions for the Fusion Framework CLI.
+ *
+ * Includes assertion helpers, file-system utilities, package resolution,
+ * annotation resolvers, and snapshot version generation.
+ *
+ * @packageDocumentation
+ */
 export { assert } from './assert.js';
 export { resolveEntryPoint } from './resolve-source-entry-point.js';
 export { resolvePackage, type ResolvedPackage } from './resolve-package.js';

package/dist/types/version.d.ts

@@ -1 +1 @@
-export declare const version = "13.3.18";
+export declare const version = "14.0.0";