@forsakringskassan/vue-lib-template 1.4.0 → 1.5.1

package/files/CODEOWNERS

@@ -3,7 +3,7 @@
 # Each line is a file pattern followed by one or more owners.
 
 # Global owner for the whole repository
-# * @username-or-team
+#* @username-or-team
 
 # Example folder-specific owner
-# /docs/ @org/doc-team
+#/docs/ @org/doc-team

package/files/docs/build.mts

@@ -61,12 +61,12 @@ docs.compileStyle("lib", styleUrl, {
     appendTo: "head",
 });
 
-docs.compileScript("mocks", "./src/bundle-mocks.mjs", {
-    appendTo: "head",
+docs.compileScript("#apimock", "./src/bundle-mocks.ts", {
+    appendTo: "none",
 });
 
 const mswUrl = new URL(import.meta.resolve("msw/mockServiceWorker.js"));
-docs.compileWorker("mock-service-worker", mswUrl);
+docs.compileWorker("#mock-service-worker", mswUrl);
 
 await docs.build([
     {

package/files/docs/components/index.md

@@ -0,0 +1,4 @@
+---
+title: Komponenter
+layout: article
+---

package/files/docs/guide/cat-info.md

@@ -0,0 +1,28 @@
+---
+title: Kattinformation
+status: Draft
+layout: component
+component: FcCatInfoComponent
+---
+
+Komponenten kan visa kattdata i visningsläge eller i ett redigerbart läge.
+Den hämtar kattdata från ett mockat backend.
+
+```import live-example
+FcCatInfoComponentLiveExample.vue
+```
+
+## Tänk på att
+
+- Detta är en exempelkomponent.
+- Den ska inte användas i produktion.
+
+## Copy
+
+- Använd tydlig och begriplig text.
+
+## API
+
+::: api
+vue:FcCatInfoComponent
+:::

package/files/docs/guide/index.md

@@ -1,29 +1,4 @@
 ---
-title: Kattinformation
-status: Draft
-layout: component
-component: FcCatInfoComponent
-visible: false
+title: Guide
+layout: article
 ---
-
-Komponenten kan visa kattdata i visningsläge eller i ett redigerbart läge.
-Den hämtar kattdata från ett mockat backend.
-
-```import live-example
-FcCatInfoComponentLiveExample.vue
-```
-
-## Tänk på att
-
-- Detta är en exempelkomponent.
-- Den ska inte användas i produktion.
-
-## Copy
-
-- Använd tydlig och begriplig text.
-
-## API
-
-::: api
-vue:FcCatInfoComponent
-:::

package/files/docs/package.json

@@ -2,6 +2,9 @@
   "name": "docs",
   "version": "0.0.0",
   "private": true,
+  "imports": {
+    "#apimock": "./src/bundle-mocks.ts"
+  },
   "scripts": {
     "build": "node build.mts",
     "start": "http-server public"
@@ -9,8 +12,8 @@
   "devDependencies": {
     "@fkui/icon-lib-default": "6.59.0",
     "@fkui/vue": "6.59.0",
-    "@forsakringskassan/apimock-express": "4.1.0",
-    "@forsakringskassan/docs-generator": "3.12.0",
+    "@forsakringskassan/apimock-express": "4.2.1",
+    "@forsakringskassan/docs-generator": "3.12.1",
     "@tsconfig/node24": "24.0.5",
     "@tsconfig/recommended": "1.0.13",
     "http-server": "14.1.1",

package/files/docs/src/bundle-mocks.ts

@@ -0,0 +1,10 @@
+import { setupWorker } from "@forsakringskassan/apimock-express/browser";
+import mocks from "../../src/mocks/index.mjs";
+
+/* this is resolved from the importmap (mapped to the bundle with the same name
+ * compiled in `docs/build.mts`) */
+const workerUrl = import.meta.resolve("#mock-service-worker");
+
+export const apimockReady = setupWorker(workerUrl, mocks, {
+    type: "module",
+});

package/files/docs/src/setup.ts

@@ -10,18 +10,22 @@ import {
 } from "@fkui/vue";
 import { type SetupOptions } from "@forsakringskassan/docs-generator";
 
+/* this is resolved from the importmap (mapped to the bundle with the same name
+ * compiled in `docs/build.mts`) */
+import { apimockReady } from "#apimock";
+
 export async function setup(options: SetupOptions): Promise<void> {
     const { rootComponent, selector } = options;
 
-    // Set in bundle-mocks.mjs, wait on mock service worker to be ready.
-    if (window.bundleMocks) {
-        await window.bundleMocks;
-    }
+    /* wait for apimock to be ready before we mount the example */
+    await apimockReady;
+
     const app = createApp({
         render() {
             return h(FErrorHandlingApp, { defaultComponent: rootComponent });
         },
     });
+
     setRunningContext(app);
     app.use(ErrorPlugin, {
         captureWarnings: true,

package/files/docs/tsconfig.json

@@ -3,6 +3,10 @@
 {
     "extends": ["@tsconfig/recommended", "@tsconfig/node24"],
     "compilerOptions": {
+        "noEmit": true,
+        "target": "esnext",
+        "module": "esnext",
+        "moduleResolution": "bundler",
         "lib": ["DOM", "DOM.Iterable", "ESNext"],
         "types": ["node"]
     },

package/files/package.json

@@ -94,11 +94,11 @@
     "@fkui/test-utils": "6.59.0",
     "@fkui/theme-default": "6.59.0",
     "@fkui/vue": "6.59.0",
-    "@forsakringskassan/apimock-express": "4.1.0",
+    "@forsakringskassan/apimock-express": "4.2.1",
     "@forsakringskassan/commitlint-config": "4.2.8",
     "@forsakringskassan/cypress-config": "1.10.0",
     "@forsakringskassan/cypress-visual-regression": "5.2.0",
-    "@forsakringskassan/docs-generator": "3.12.0",
+    "@forsakringskassan/docs-generator": "3.12.1",
     "@forsakringskassan/docs-live-example": "3.0.2",
     "@forsakringskassan/eslint-config": "15.11.0",
     "@forsakringskassan/eslint-config-cli": "15.11.0",
@@ -112,13 +112,13 @@
     "@forsakringskassan/stylelint-config": "3.5.0",
     "@forsakringskassan/vite-lib-config": "5.12.4",
     "@forsakringskassan/vitest-config-jsdom": "5.0.0",
-    "@forsakringskassan/vue-lib-template": "1.4.0",
+    "@forsakringskassan/vue-lib-template": "1.5.1",
     "@html-validate/release-scripts": "7.6.12",
     "@types/node": "24.13.6",
     "@typescript/native": "npm:typescript@7.0.2",
     "@vue/server-renderer": "3.5.43",
     "@vue/test-utils": "2.5.1",
-    "cloneman": "1.25.0",
+    "cloneman": "1.25.1",
     "core-js": "3.50.0",
     "cypress": "16.1.0",
     "html-validate": "11.16.0",

package/hooks/install.mjs

@@ -1,5 +1,15 @@
 
 
+async function enableDeployDocs(context                )                {
+    const { getParameter, replaceInFile } = context;
+    const url = getParameter("docs-repo-url");
+    if (url === "") {
+        return;
+    }
+    await replaceInFile("Jenkinsfile", /deploy:/, "false", "true");
+    await replaceInFile("Jenkinsfile", /repositoryUrl:/, "null", `"${url}"`);
+}
+
 export async function install(context                )                {
     const { getApplicationName, replaceInFile } = context;
     const scopedName = getApplicationName();
@@ -13,4 +23,7 @@ export async function install(context                )                {
     await replaceInFile("tsconfig.lib.json", placeholder, quotedName);
     await replaceInFile("tsconfig.cypress.json", placeholder, quotedName);
     await replaceInFile("tsconfig.selectors.json", placeholder, quotedName);
+
+    /* enable deployment of documentation if a documentation url is provided */
+    await enableDeployDocs(context);
 }

package/index.js

@@ -7,7 +7,7 @@
 
         const options = {
             ...packageJson.cloneman,
-            fileHash: "06d2b6a7e26a9d5b9df47375fe9fc0d856d30afd18da47362ccf24b6fa6c1468",
+            fileHash: "509a23e5489100d974625d2197bd7e65aee36d3ce87686a907623db845674b81",
             filesDir: path.join(import.meta.dirname, "files"),
             hooksDir: path.join(import.meta.dirname, "hooks"),
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forsakringskassan/vue-lib-template",
-  "version": "1.4.0",
+  "version": "1.5.1",
   "description": "Vue library template based on Cloneman",
   "keywords": [
     "template",
@@ -46,10 +46,12 @@
       "cypress/tsconfig.json",
       "cypress/types/mocha.d.ts",
       "docs/build.mts",
+      "docs/components/index.md",
+      "docs/guide/cat-info.md",
       "docs/guide/index.md",
       "docs/index.md",
       "docs/package.json",
-      "docs/src/bundle-mocks.mjs",
+      "docs/src/bundle-mocks.ts",
       "docs/src/global.d.ts",
       "docs/src/main.js",
       "docs/src/main.scss",
@@ -127,7 +129,7 @@
       "cypress/types/mocha.d.ts",
       "docs/build.mts",
       "docs/package.json",
-      "docs/src/bundle-mocks.mjs",
+      "docs/src/bundle-mocks.ts",
       "docs/src/global.d.ts",
       "docs/src/main.js",
       "docs/src/main.scss",
@@ -165,6 +167,7 @@
       "cypress/types/forced-colors.d.ts",
       "etc/vue-lib-template-selectors.api.md",
       "etc/vue-lib-template.api.md",
+      "docs/src/bundle-mocks.mjs",
       "docs/components/AwesomeComponent.md",
       "src/examples/DummyExample.vue",
       "src/AwesomeComponent.cy.ts",
@@ -182,6 +185,16 @@
       "!@fkui/tsconfig",
       "@forsakringskassan/*-api",
       "fk-icons"
+    ],
+    "parameters": [
+      {
+        "key": "docs-repo-url",
+        "description": "URL to repository to deploy documentation to",
+        "help": "Format: ssh://user@host/project/repo.git",
+        "required": false,
+        "defaultValue": "",
+        "pattern": "ssh://.*.git"
+      }
     ]
   }
 }

package/files/docs/src/bundle-mocks.mjs

@@ -1,23 +0,0 @@
-import { matchRequest } from "@forsakringskassan/apimock-express/browser";
-import { http } from "msw";
-import { setupWorker } from "msw/browser";
-import mocks from "../../src/mocks/index.mts";
-
-const handlers = [
-    http.all("/api/*", async (req) => {
-        return await matchRequest(mocks, req.request);
-    }),
-];
-const worker = setupWorker(...handlers);
-// eslint-disable-next-line no-undef -- technical debt
-const rootUrl = document.documentElement.dataset["rootUrl"];
-const url = `${rootUrl}/mock-service-worker.js`;
-
-// Used in setup.ts
-// eslint-disable-next-line unicorn/no-global-object-property-assignment, no-undef -- technical debt
-window.bundleMocks = worker.start({
-    serviceWorker: {
-        url,
-        options: { type: "module" },
-    },
-});