@swoff/cli 0.1.0 → 0.2.0

package/dist/lib/config/validator.js

@@ -0,0 +1,102 @@
+/**
+ * Config validator - checks swoff.config.json for correctness.
+ * Returns an array of error strings (empty if valid).
+ */
+import { KNOWN_FEATURES, VALID_STRATEGIES } from "../shared/config-types.js";
+export function validateConfig(config) {
+    const errors = [];
+    // Required fields
+    const requiredFields = ["enabled", "version", "serviceWorker", "features", "build"];
+    const missingFields = requiredFields.filter((field) => config[field] === undefined || config[field] === null);
+    if (missingFields.length > 0) {
+        errors.push(`Missing required fields: ${missingFields.join(", ")}`);
+    }
+    // serviceWorker
+    if (config.serviceWorker) {
+        const sw = config.serviceWorker;
+        if (sw.autoRegister !== undefined && typeof sw.autoRegister !== "boolean") {
+            errors.push("serviceWorker.autoRegister must be a boolean");
+        }
+        if (sw.autoUpdate !== undefined && typeof sw.autoUpdate !== "boolean") {
+            errors.push("serviceWorker.autoUpdate must be a boolean");
+        }
+        if (sw.defaultStrategy && !VALID_STRATEGIES.includes(sw.defaultStrategy)) {
+            errors.push(`Invalid defaultStrategy "${sw.defaultStrategy}". Must be one of: ${VALID_STRATEGIES.join(", ")}`);
+        }
+        if (sw.strategies && typeof sw.strategies === "object") {
+            const strategies = sw.strategies;
+            for (const [pattern, strategy] of Object.entries(strategies)) {
+                if (!VALID_STRATEGIES.includes(strategy)) {
+                    errors.push(`Invalid strategy "${strategy}" for pattern "${pattern}". Must be one of: ${VALID_STRATEGIES.join(", ")}`);
+                }
+            }
+        }
+    }
+    // features
+    if (config.features) {
+        const features = config.features;
+        for (const [key, value] of Object.entries(features)) {
+            if (!KNOWN_FEATURES.includes(key)) {
+                errors.push(`Unknown feature "${key}"`);
+            }
+            if (typeof value !== "boolean") {
+                errors.push(`Feature "${key}" must be a boolean, got ${typeof value}`);
+            }
+        }
+    }
+    // version
+    if (config.version && typeof config.version === "string" && config.version !== "from-package") {
+        if (!/^\d+\.\d+\.\d+$/.test(config.version)) {
+            errors.push(`Invalid version "${config.version}". Must be "from-package" or semver (e.g., "1.0.0")`);
+        }
+    }
+    // minSupportedVersion
+    if (config.minSupportedVersion && typeof config.minSupportedVersion === "string") {
+        if (!/^\d+\.\d+\.\d+$/.test(config.minSupportedVersion)) {
+            errors.push(`Invalid minSupportedVersion "${config.minSupportedVersion}". Must be semver (e.g., "1.0.0")`);
+        }
+    }
+    // build
+    if (config.build) {
+        const build = config.build;
+        if (build.outputDir && typeof build.outputDir !== "string") {
+            errors.push("build.outputDir must be a string");
+        }
+        if (build.swFilename && typeof build.swFilename !== "string") {
+            errors.push("build.swFilename must be a string");
+        }
+    }
+    // pwa
+    if (config.pwa) {
+        const pwa = config.pwa;
+        if (pwa.preventDefaultInstall !== undefined && typeof pwa.preventDefaultInstall !== "boolean") {
+            errors.push("pwa.preventDefaultInstall must be a boolean");
+        }
+    }
+    // database
+    if (config.database) {
+        const db = config.database;
+        if (db.name && typeof db.name !== "string") {
+            errors.push("database.name must be a string");
+        }
+        if (db.name && typeof db.name === "string" && !/^[a-zA-Z0-9-_]+$/.test(db.name)) {
+            errors.push(`database.name "${db.name}" must match pattern ^[a-zA-Z0-9-_]+$`);
+        }
+        if (db.stores && !Array.isArray(db.stores)) {
+            errors.push("database.stores must be an array");
+        }
+        if (db.stores && Array.isArray(db.stores)) {
+            for (const store of db.stores) {
+                if (typeof store !== "string") {
+                    errors.push("database.stores must contain only strings");
+                    break;
+                }
+                if (!/^[a-zA-Z0-9-_]+$/.test(store)) {
+                    errors.push(`database.store "${store}" must match pattern ^[a-zA-Z0-9-_]+$`);
+                }
+            }
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=validator.js.map

package/dist/lib/config/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../../src/lib/config/validator.ts"],"names":[],"mappings":"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"}

package/dist/lib/generators/file-generators/background-sync.js

@@ -0,0 +1,59 @@
+/**
+ * Generates background-sync.js - Background Sync API registration.
+ */
+import { writeFile } from "./context.js";
+export function generateBackgroundSync(ctx) {
+    const code = `/**
+ * Swoff Background Sync
+ * Register sync events for processing mutation queue after tab close.
+ * Falls back to online event listener in unsupported browsers.
+ *
+ * Usage:
+ *   import { syncWhenPossible } from './swoff/background-sync.js';
+ *
+ *   await syncWhenPossible({
+ *     method: "POST",
+ *     url: "/api/todos",
+ *     body: { title: "Grocery" },
+ *     tags: ["todos"],
+ *     storeName: "todos",
+ *     tempId: "temp_abc123",
+ *   });
+ */
+
+import { queueMutation, processMutationQueue, getPendingCount } from "./mutation-queue.js";
+
+const SYNC_TAG = "sync-mutations";
+
+async function registerSync() {
+  if (!("serviceWorker" in navigator) || !("SyncManager" in window)) {
+    window.addEventListener("online", processMutationQueue, { once: true });
+    return;
+  }
+
+  try {
+    const registration = await navigator.serviceWorker.ready;
+    await registration.sync.register(SYNC_TAG);
+  } catch {
+    window.addEventListener("online", processMutationQueue, { once: true });
+  }
+}
+
+export async function syncWhenPossible(mutation) {
+  await queueMutation(mutation);
+  await registerSync();
+}
+
+export async function retrySync() {
+  if (!("serviceWorker" in navigator) || !("SyncManager" in window)) return;
+  const count = await getPendingCount();
+  if (count > 0) {
+    await registerSync();
+  }
+}
+
+window.addEventListener("mutation-sync-complete", retrySync);
+`;
+    writeFile(ctx, "background-sync.js", code);
+}
+//# sourceMappingURL=background-sync.js.map

package/dist/lib/generators/file-generators/background-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-sync.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/background-sync.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,sBAAsB,CAAC,GAAqB;IAC1D,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDd,CAAC;IAEA,SAAS,CAAC,GAAG,EAAE,oBAAoB,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC"}

package/dist/lib/generators/file-generators/cache.js

@@ -0,0 +1,55 @@
+/**
+ * Generates cache.js - cache tag invalidation and cross-tab sync.
+ */
+import { writeFile } from "./context.js";
+export function generateCache(ctx) {
+    const code = `/**
+ * Swoff Cache Invalidation & Cross-Tab Sync
+ * Framework-agnostic cache tag invalidation and cross-tab synchronization.
+ *
+ * Usage:
+ *   import { invalidateByTag, initCrossTabSync } from './swoff/cache.js';
+ *
+ *   // Call once during app init
+ *   initCrossTabSync();
+ *
+ *   // After a mutation, invalidate related cache
+ *   await invalidateByTag("todos");
+ */
+
+export async function invalidateByTag(tag) {
+  if (!navigator.serviceWorker?.controller) return;
+
+  navigator.serviceWorker.controller.postMessage({
+    type: "INVALIDATE_TAG",
+    tag,
+  });
+
+  window.dispatchEvent(
+    new CustomEvent("cache-invalidated", { detail: { tags: [tag] } })
+  );
+}
+
+export async function invalidateByTags(tags) {
+  for (const tag of tags) {
+    await invalidateByTag(tag);
+  }
+}
+
+export function initCrossTabSync() {
+  if (!navigator.serviceWorker) return;
+
+  navigator.serviceWorker.addEventListener("message", (event) => {
+    if (event.data.type === "TAG_INVALIDATED" && event.data.tag) {
+      window.dispatchEvent(
+        new CustomEvent("cache-invalidated", {
+          detail: { tags: [event.data.tag] },
+        })
+      );
+    }
+  });
+}
+`;
+    writeFile(ctx, "cache.js", code);
+}
+//# sourceMappingURL=cache.js.map

package/dist/lib/generators/file-generators/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,aAAa,CAAC,GAAqB;IACjD,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8Cd,CAAC;IAEA,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC"}

package/dist/lib/generators/file-generators/context.js

@@ -0,0 +1,16 @@
+/**
+ * Shared context for file generators.
+ * Contains config, paths, and the generated files tracker.
+ */
+import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { join } from "path";
+export function ensureSwoffDir(ctx) {
+    if (!existsSync(ctx.swoffDir))
+        mkdirSync(ctx.swoffDir, { recursive: true });
+}
+export function writeFile(ctx, filename, code) {
+    ensureSwoffDir(ctx);
+    writeFileSync(join(ctx.swoffDir, filename), code);
+    ctx.generatedFiles.push(`swoff/${filename}`);
+}
+//# sourceMappingURL=context.js.map

package/dist/lib/generators/file-generators/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAW5B,MAAM,UAAU,cAAc,CAAC,GAAqB;IAClD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAqB,EAAE,QAAgB,EAAE,IAAY;IAC7E,cAAc,CAAC,GAAG,CAAC,CAAC;IACpB,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC;IAClD,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAC;AAC/C,CAAC"}

package/dist/lib/generators/file-generators/fetch-wrapper.js

@@ -0,0 +1,80 @@
+/**
+ * Generates fetch-wrapper.js - fetch with cache strategy headers and deduplication.
+ */
+import { writeFile } from "./context.js";
+export function generateFetchWrapper(ctx) {
+    const code = `/**
+ * Swoff Fetch Wrapper
+ * Framework-agnostic fetch with cache strategy, tags, and query deduplication.
+ *
+ * Usage:
+ *   import { fetchWithCache } from './swoff/fetch-wrapper.js';
+ *
+ *   // GET - cached with tag
+ *   const todos = await fetchWithCache("/api/todos", { tags: ["todos"] }).then(r => r.json());
+ *
+ *   // POST - mutation (passes through to server)
+ *   await fetchWithCache("/api/todos", {
+ *     method: "POST",
+ *     body: JSON.stringify({ title: "New task" }),
+ *   });
+ *
+ *   // Stale-while-revalidate
+ *   const data = await fetchWithCache("/api/data", {
+ *     tags: ["data"],
+ *     staleWhileRevalidate: true,
+ *   }).then(r => r.json());
+ */
+
+const inFlightRequests = new Map();
+
+export async function fetchWithCache(input, options = {}) {
+  const headers = new Headers(options.headers);
+  const method = options.method || "GET";
+
+  if (!headers.has("X-SW-Cache-Strategy")) {
+    headers.set(
+      "X-SW-Cache-Strategy",
+      method === "GET" || method === "HEAD" ? "read" : "mutation"
+    );
+  }
+
+  if (options.staleWhileRevalidate) {
+    headers.set("X-SW-Stale", "true");
+  }
+
+  if (options.tags && options.tags.length > 0) {
+    headers.set("X-SW-Cache-Tags", options.tags.join(","));
+  }
+
+  if (method === "GET" || method === "HEAD") {
+    const url = typeof input === "string" ? input : input.url;
+    if (inFlightRequests.has(url)) {
+      return inFlightRequests.get(url).then((r) => r.clone());
+    }
+    const promise = fetch(input, { ...options, headers }).finally(() => {
+      inFlightRequests.delete(url);
+    });
+    inFlightRequests.set(url, promise);
+    return promise;
+  }
+
+  return fetch(input, { ...options, headers });
+}
+
+export async function fetchWithCacheOrQueue(input, options = {}) {
+  if (!navigator.onLine) {
+    if (options.method === "GET" || options.method === "HEAD") {
+      const cached = await caches.match(input);
+      if (cached) return cached;
+      throw new Error("Offline: no cached data");
+    } else {
+      throw new Error("Offline: mutation queued");
+    }
+  }
+  return fetchWithCache(input, options);
+}
+`;
+    writeFile(ctx, "fetch-wrapper.js", code);
+}
+//# sourceMappingURL=fetch-wrapper.js.map

package/dist/lib/generators/file-generators/fetch-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-wrapper.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/fetch-wrapper.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,oBAAoB,CAAC,GAAqB;IACxD,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuEd,CAAC;IAEA,SAAS,CAAC,GAAG,EAAE,kBAAkB,EAAE,IAAI,CAAC,CAAC;AAC3C,CAAC"}

package/dist/lib/generators/file-generators/indexeddb.js

@@ -0,0 +1,73 @@
+/**
+ * Generates indexeddb.js - DB initialization with schema migrations.
+ */
+import { writeFile } from "./context.js";
+export function generateIndexedDB(ctx) {
+    const dbName = ctx.config.database?.name || "app-db";
+    const stores = ctx.config.database?.stores || [];
+    const storesCode = stores.length > 0
+        ? stores
+            .map((store, i) => `      if (oldVersion < ${i + 1}) {\n        db.createObjectStore("${store}", { keyPath: "id" });\n      }`)
+            .join("\n\n")
+        : `      // Create your object stores here:
+      // if (oldVersion < 1) {
+      //   const todos = db.createObjectStore("todos", { keyPath: "id" });
+      //   todos.createIndex("by-date", "date");
+      // }`;
+    const code = `/**
+ * Swoff IndexedDB Setup
+ * Database initialization with schema migrations.
+ *
+ * Usage:
+ *   import { openDB } from './swoff/indexeddb.js';
+ *
+ *   const db = await openDB();
+ */
+
+const DB_NAME = "${dbName}";
+const DB_VERSION = 1;
+
+export function openDB() {
+  return new Promise((resolve, reject) => {
+    const request = indexedDB.open(DB_NAME, DB_VERSION);
+
+    request.onupgradeneeded = (e) => {
+      const db = e.target.result;
+      const oldVersion = e.oldVersion;
+
+${storesCode}
+    };
+
+    request.onsuccess = (e) => resolve(e.target.result);
+    request.onerror = (e) => reject(e.target.error);
+  });
+}
+
+export async function requestPersistentStorage() {
+  if (!navigator.storage?.persist) return false;
+
+  const isPersisted = await navigator.storage.persisted();
+  if (isPersisted) return true;
+
+  try {
+    return await navigator.storage.persist();
+  } catch {
+    return false;
+  }
+}
+
+export async function monitorStorage() {
+  const estimate = await navigator.storage.estimate();
+  const ratio = estimate.usage / estimate.quota;
+
+  return {
+    usage: estimate.usage,
+    quota: estimate.quota,
+    ratio,
+    status: ratio >= 0.95 ? "critical" : ratio >= 0.8 ? "warning" : "ok",
+  };
+}
+`;
+    writeFile(ctx, "indexeddb.js", code);
+}
+//# sourceMappingURL=indexeddb.js.map

package/dist/lib/generators/file-generators/indexeddb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexeddb.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/indexeddb.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,iBAAiB,CAAC,GAAqB;IACrD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,IAAI,QAAQ,CAAC;IACrD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,CAAC;IAEjD,MAAM,UAAU,GACd,MAAM,CAAC,MAAM,GAAG,CAAC;QACf,CAAC,CAAC,MAAM;aACH,GAAG,CACF,CAAC,KAAa,EAAE,CAAS,EAAE,EAAE,CAC3B,0BAA0B,CAAC,GAAG,CAAC,sCAAsC,KAAK,iCAAiC,CAC9G;aACA,IAAI,CAAC,MAAM,CAAC;QACjB,CAAC,CAAC;;;;WAIG,CAAC;IAEV,MAAM,IAAI,GAAG;;;;;;;;;;mBAUI,MAAM;;;;;;;;;;;EAWvB,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCX,CAAC;IAEA,SAAS,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC"}

package/dist/lib/generators/file-generators/invalidation-tags.js

@@ -0,0 +1,91 @@
+/**
+ * Generates invalidation-tags.js - URL-based tag generation helper.
+ */
+import { writeFile } from "./context.js";
+export function generateInvalidationTags(ctx) {
+    const code = `/**
+ * Swoff Invalidation Tags Helper
+ * URL-based tag generation from REST endpoints for automatic cache invalidation.
+ *
+ * Usage:
+ *   import { generateTags, invalidateUrl } from './swoff/invalidation-tags.js';
+ *
+ *   // Generate tags from URL
+ *   generateTags("/api/todos");          // ["todos"]
+ *   generateTags("/api/todos/42");       // ["todos", "todo:42"]
+ *   generateTags("/api/todos/42/comments"); // ["todos", "todo:42", "comments"]
+ *
+ *   // Use with fetch wrapper
+ *   const data = await fetchWithCache("/api/todos", {
+ *     tags: generateTags("/api/todos"),
+ *   });
+ *
+ *   // Invalidate after mutation
+ *   await invalidateUrl("/api/todos/42");
+ */
+
+import { invalidateByTag, invalidateByTags } from "./cache.js";
+
+export function generateTags(url) {
+  const parsed = typeof url === "string" ? new URL(url, window.location.origin) : url;
+  const segments = parsed.pathname.split("/").filter(Boolean);
+
+  if (segments.length === 0) return ["root"];
+
+  // Skip common API prefixes
+  const skipPrefixes = ["api", "v1", "v2", "v3", "rest", "graphql", "gql"];
+  let startIdx = 0;
+  while (startIdx < segments.length && skipPrefixes.includes(segments[startIdx])) {
+    startIdx++;
+  }
+
+  const resourceSegments = segments.slice(startIdx);
+  if (resourceSegments.length === 0) return ["root"];
+
+  const tags = [];
+
+  // Collection tag: /api/todos -> "todos"
+  tags.push(resourceSegments[0]);
+
+  // Resource tag: /api/todos/42 -> "todo:42"
+  if (resourceSegments.length >= 2 && !isNaN(Number(resourceSegments[1]))) {
+    const collection = resourceSegments[0];
+    const id = resourceSegments[1];
+    const singular = collection.replace(/s$/, "");
+    tags.push(\`\${singular}:\${id}\`);
+  }
+
+  // Sub-resource tags: /api/todos/42/comments -> "comments"
+  for (let i = 2; i < resourceSegments.length; i++) {
+    if (isNaN(Number(resourceSegments[i]))) {
+      tags.push(resourceSegments[i]);
+    }
+  }
+
+  return tags;
+}
+
+export function generateTagsFromMethod(method, url) {
+  const tags = generateTags(url);
+
+  if (method === "GET" || method === "HEAD") {
+    return tags;
+  }
+
+  // For mutations, add method prefix
+  return tags.map((tag) => \`\${method.toLowerCase()}-\${tag}\`);
+}
+
+export async function invalidateUrl(url) {
+  const tags = generateTags(url);
+  await invalidateByTags(tags);
+}
+
+export async function invalidateByMethod(method, url) {
+  const tags = generateTagsFromMethod(method, url);
+  await invalidateByTags(tags);
+}
+`;
+    writeFile(ctx, "invalidation-tags.js", code);
+}
+//# sourceMappingURL=invalidation-tags.js.map

package/dist/lib/generators/file-generators/invalidation-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalidation-tags.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/invalidation-tags.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,wBAAwB,CAAC,GAAqB;IAC5D,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkFd,CAAC;IAEA,SAAS,CAAC,GAAG,EAAE,sBAAsB,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC"}

package/dist/lib/generators/file-generators/manifest.js

@@ -0,0 +1,26 @@
+/**
+ * Generates manifest.json - PWA web app manifest.
+ */
+import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { join } from "path";
+export function generateManifest(ctx) {
+    const outputDir = join(ctx.projectRoot, "public");
+    if (!existsSync(outputDir))
+        mkdirSync(outputDir, { recursive: true });
+    const manifest = {
+        name: "Swoff App",
+        short_name: "Swoff",
+        description: "Offline-first web application",
+        start_url: "/",
+        display: "standalone",
+        background_color: "#ffffff",
+        theme_color: "#000000",
+        icons: [
+            { src: "/icon-192.png", sizes: "192x192", type: "image/png" },
+            { src: "/icon-512.png", sizes: "512x512", type: "image/png" },
+        ],
+    };
+    writeFileSync(join(outputDir, "manifest.json"), JSON.stringify(manifest, null, 2));
+    ctx.generatedFiles.push("public/manifest.json");
+}
+//# sourceMappingURL=manifest.js.map

package/dist/lib/generators/file-generators/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/manifest.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,MAAM,UAAU,gBAAgB,CAAC,GAAqB;IACpD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtE,MAAM,QAAQ,GAAG;QACf,IAAI,EAAE,WAAW;QACjB,UAAU,EAAE,OAAO;QACnB,WAAW,EAAE,+BAA+B;QAC5C,SAAS,EAAE,GAAG;QACd,OAAO,EAAE,YAAY;QACrB,gBAAgB,EAAE,SAAS;QAC3B,WAAW,EAAE,SAAS;QACtB,KAAK,EAAE;YACL,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE;YAC7D,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE;SAC9D;KACF,CAAC;IAEF,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACnF,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;AAClD,CAAC"}