@modular-frontend/testing 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Igor Savin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+import { ModuleDescriptor, ModuleEntry, SlotMap, SlotMapOf, Store } from "@modular-frontend/core";
+
+//#region src/mock-store.d.ts
+/**
+ * Creates a store pre-populated with the given state.
+ * Convenience alias for `createStore(initialState)` with a
+ * test-oriented name.
+ *
+ * Works as a drop-in replacement for zustand's `createStore` in tests.
+ * The returned `Store<T>` is compatible with `resolveModule()` and with
+ * whichever UI-framework binding's shared-state factory and render helper
+ * the test uses (`createSharedHooks`/`createSharedComposables`, etc.).
+ *
+ * @example
+ * const authStore = createMockStore<AuthStore>({
+ *   user: { id: '1', name: 'Test User' },
+ *   token: 'mock-token',
+ *   isAuthenticated: true,
+ *   login: async () => {},
+ *   logout: () => {},
+ * })
+ */
+declare function createMockStore<T>(initialState: T): Store<T>;
+//#endregion
+//#region src/resolve-module.d.ts
+interface ResolveModuleOptions<TSharedDependencies extends Record<string, any>, TSlots extends SlotMapOf<TSlots>> {
+  /** Dependencies snapshot passed to onRegister lifecycle hook and dynamicSlots evaluation */
+  deps?: Partial<TSharedDependencies>;
+  /** Default slot values (same as registry slot defaults) */
+  defaults?: Partial<{ [K in keyof TSlots]: TSlots[K] }>;
+}
+interface ResolveModuleResult<TSlots> {
+  /** The module's resolved slot contributions (merged with defaults, including dynamic slots) */
+  slots: TSlots;
+  /** The ModuleEntry as it would appear in useModules() */
+  entry: ModuleEntry;
+  /** Whether onRegister was called */
+  onRegisterCalled: boolean;
+}
+/**
+ * Resolves a module without rendering — runs it through slot merging
+ * (static + dynamic) and lifecycle hooks, returning the resolved contributions.
+ *
+ * Use this for headless modules (no component, no routes) that can't
+ * be tested by rendering with a UI-framework binding.
+ *
+ * When the module has `dynamicSlots`, they are evaluated with the
+ * provided `deps` snapshot and merged with static slot contributions.
+ *
+ * @example
+ * const { slots, entry } = resolveModule(externalSystemsModule, {
+ *   defaults: { systems: [], commands: [] },
+ *   deps: { auth: { user: { isAdmin: true } } },
+ * })
+ * expect(slots.systems).toHaveLength(1)
+ * expect(entry.id).toBe('external-systems')
+ */
+declare function resolveModule<TSharedDependencies extends Record<string, any>, TSlots extends SlotMapOf<TSlots> = SlotMap>(module: ModuleDescriptor<TSharedDependencies, TSlots>, options?: ResolveModuleOptions<TSharedDependencies, TSlots>): ResolveModuleResult<TSlots>;
+//#endregion
+export { type ResolveModuleOptions, type ResolveModuleResult, createMockStore, resolveModule };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/mock-store.ts","../src/resolve-module.ts"],"mappings":";;;;;AAsBA;;;;;;;;;;;;;;AAA4D;;;iBAA5C,eAAA,IAAmB,YAAA,EAAc,CAAA,GAAI,KAAA,CAAM,CAAA;;;UCnB1C,oBAAA,6BACa,MAAA,8BACb,SAAA,CAAU,MAAA;;EAGzB,IAAA,GAAO,OAAA,CAAQ,mBAAA;EDcc;ECZ7B,QAAA,GAAW,OAAA,eAAsB,MAAA,GAAS,MAAA,CAAO,CAAA;AAAA;AAAA,UAGlC,mBAAA;EDSyC;ECPxD,KAAA,EAAO,MAAA;EDOwC;ECL/C,KAAA,EAAO,WAAW;EDKiC;ECHnD,gBAAA;AAAA;ADG0D;;;;ACnB5D;;;;;;;;;;;;;;ADmB4D,iBCkB5C,aAAA,6BACc,MAAA,8BACb,SAAA,CAAU,MAAA,IAAU,OAAA,EAEnC,MAAA,EAAQ,gBAAA,CAAiB,mBAAA,EAAqB,MAAA,GAC9C,OAAA,GAAU,oBAAA,CAAqB,mBAAA,EAAqB,MAAA,IACnD,mBAAA,CAAoB,MAAA"}

package/dist/index.js

@@ -0,0 +1,30 @@
+import { buildSlotsManifest as e, createStore as t, evaluateDynamicSlots as n } from "@modular-frontend/core";
+//#region src/mock-store.ts
+function r(e) {
+	return t(e);
+}
+//#endregion
+//#region src/resolve-module.ts
+function i(t, r) {
+	let i = e([t], r?.defaults);
+	if (t.dynamicSlots) {
+		let e = r?.deps ?? {};
+		i = n(i, [t.dynamicSlots], e);
+	}
+	let a = {
+		id: t.id,
+		version: t.version,
+		meta: t.meta,
+		component: t.component,
+		zones: t.zones
+	}, o = !1;
+	return t.lifecycle?.onRegister && (t.lifecycle.onRegister(r?.deps ?? {}), o = !0), {
+		slots: i,
+		entry: a,
+		onRegisterCalled: o
+	};
+}
+//#endregion
+export { r as createMockStore, i as resolveModule };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/mock-store.ts","../src/resolve-module.ts"],"sourcesContent":["import { createStore } from \"@modular-frontend/core\";\nimport type { Store } from \"@modular-frontend/core\";\n\n/**\n * Creates a store pre-populated with the given state.\n * Convenience alias for `createStore(initialState)` with a\n * test-oriented name.\n *\n * Works as a drop-in replacement for zustand's `createStore` in tests.\n * The returned `Store<T>` is compatible with `resolveModule()` and with\n * whichever UI-framework binding's shared-state factory and render helper\n * the test uses (`createSharedHooks`/`createSharedComposables`, etc.).\n *\n * @example\n * const authStore = createMockStore<AuthStore>({\n *   user: { id: '1', name: 'Test User' },\n *   token: 'mock-token',\n *   isAuthenticated: true,\n *   login: async () => {},\n *   logout: () => {},\n * })\n */\nexport function createMockStore<T>(initialState: T): Store<T> {\n  return createStore<T>(initialState);\n}\n","import type { ModuleDescriptor, SlotMap, SlotMapOf, ModuleEntry } from \"@modular-frontend/core\";\nimport { buildSlotsManifest, evaluateDynamicSlots } from \"@modular-frontend/core\";\n\nexport interface ResolveModuleOptions<\n  TSharedDependencies extends Record<string, any>,\n  TSlots extends SlotMapOf<TSlots>,\n> {\n  /** Dependencies snapshot passed to onRegister lifecycle hook and dynamicSlots evaluation */\n  deps?: Partial<TSharedDependencies>;\n  /** Default slot values (same as registry slot defaults) */\n  defaults?: Partial<{ [K in keyof TSlots]: TSlots[K] }>;\n}\n\nexport interface ResolveModuleResult<TSlots> {\n  /** The module's resolved slot contributions (merged with defaults, including dynamic slots) */\n  slots: TSlots;\n  /** The ModuleEntry as it would appear in useModules() */\n  entry: ModuleEntry;\n  /** Whether onRegister was called */\n  onRegisterCalled: boolean;\n}\n\n/**\n * Resolves a module without rendering — runs it through slot merging\n * (static + dynamic) and lifecycle hooks, returning the resolved contributions.\n *\n * Use this for headless modules (no component, no routes) that can't\n * be tested by rendering with a UI-framework binding.\n *\n * When the module has `dynamicSlots`, they are evaluated with the\n * provided `deps` snapshot and merged with static slot contributions.\n *\n * @example\n * const { slots, entry } = resolveModule(externalSystemsModule, {\n *   defaults: { systems: [], commands: [] },\n *   deps: { auth: { user: { isAdmin: true } } },\n * })\n * expect(slots.systems).toHaveLength(1)\n * expect(entry.id).toBe('external-systems')\n */\nexport function resolveModule<\n  TSharedDependencies extends Record<string, any>,\n  TSlots extends SlotMapOf<TSlots> = SlotMap,\n>(\n  module: ModuleDescriptor<TSharedDependencies, TSlots>,\n  options?: ResolveModuleOptions<TSharedDependencies, TSlots>,\n): ResolveModuleResult<TSlots> {\n  let slots = buildSlotsManifest<TSlots>([module], options?.defaults);\n\n  // Evaluate dynamic slots if the module has them\n  if (module.dynamicSlots) {\n    const deps = (options?.deps ?? {}) as Record<string, unknown>;\n    slots = evaluateDynamicSlots(\n      slots,\n      [\n        module.dynamicSlots as (\n          deps: Record<string, unknown>,\n        ) => Record<string, readonly unknown[]>,\n      ],\n      deps,\n    );\n  }\n\n  const entry: ModuleEntry = {\n    id: module.id,\n    version: module.version,\n    meta: module.meta,\n    component: module.component,\n    zones: module.zones,\n  };\n\n  let onRegisterCalled = false;\n  if (module.lifecycle?.onRegister) {\n    module.lifecycle.onRegister((options?.deps ?? {}) as TSharedDependencies);\n    onRegisterCalled = true;\n  }\n\n  return { slots, entry, onRegisterCalled };\n}\n"],"mappings":";;AAsBA,SAAgB,EAAmB,GAA2B;CAC5D,OAAO,EAAe,CAAY;AACpC;;;ACgBA,SAAgB,EAId,GACA,GAC6B;CAC7B,IAAI,IAAQ,EAA2B,CAAC,CAAM,GAAG,GAAS,QAAQ;CAGlE,IAAI,EAAO,cAAc;EACvB,IAAM,IAAQ,GAAS,QAAQ,CAAC;EAChC,IAAQ,EACN,GACA,CACE,EAAO,YAGT,GACA,CACF;CACF;CAEA,IAAM,IAAqB;EACzB,IAAI,EAAO;EACX,SAAS,EAAO;EAChB,MAAM,EAAO;EACb,WAAW,EAAO;EAClB,OAAO,EAAO;CAChB,GAEI,IAAmB;CAMvB,OALI,EAAO,WAAW,eACpB,EAAO,UAAU,WAAY,GAAS,QAAQ,CAAC,CAAyB,GACxE,IAAmB,KAGd;EAAE;EAAO;EAAO;CAAiB;AAC1C"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@modular-frontend/testing",
+  "version": "0.1.0",
+  "description": "Framework-neutral testing utilities for modular frontend modules: mock stores and headless module resolution over @modular-frontend/core.",
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/kibertoad/modular-react.git",
+    "directory": "packages/frontend-testing"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "oxfmt": "^0.51.0",
+    "oxlint": "^1.66.0",
+    "rolldown-plugin-dts": "^0.26.0",
+    "typescript": "^6.0.3",
+    "vite": "^8.1.3",
+    "vitest": "^4.1.10",
+    "@modular-frontend/core": "0.4.0"
+  },
+  "peerDependencies": {
+    "@modular-frontend/core": ">=0.1.0 <2.0.0"
+  },
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}