@mapsight/vite-count-aggregator-embed 0.0.0 → 0.2.0

package/README.md

@@ -1,3 +1,58 @@
 # @mapsight/vite-count-aggregator-embed
 
-Bootstrap package record for npm trusted publishing.
+Vite plugin for **count-aggregator app-shell** CMS embed production builds: rewrites asset paths, extracts a paste-ready HTML snippet from the built page, and writes an assets-only deploy tree with Apache `.htaccess`.
+
+Use with [`@mapsight/count-aggregator-ui`](https://github.com/open-mapsight/mapsight/blob/main/packages/count-aggregator-ui/README.md) and [`mapsightSnippetHtmlEntryPlugin`](https://github.com/open-mapsight/mapsight/tree/main/packages/vite-host-embed) from `@mapsight/vite-host-embed`.
+
+## Install
+
+```bash
+npm install @mapsight/vite-count-aggregator-embed @mapsight/vite-host-embed vite
+```
+
+## Usage
+
+Mark the paste-ready region in your app HTML entry:
+
+```html
+<!-- mapsight:snippet:start -->
+<div id="count-aggregator-root"></div>
+<script type="module" src="/src/main.tsx"></script>
+<!-- mapsight:snippet:end -->
+```
+
+Wire Vite plugins:
+
+```ts
+import {finalizeCountAggregatorAppShellPlugin} from "@mapsight/vite-count-aggregator-embed";
+import {mapsightSnippetHtmlEntryPlugin} from "@mapsight/vite-host-embed";
+
+export default defineConfig({
+	plugins: [
+		mapsightSnippetHtmlEntryPlugin(appRoot, {
+			entryFile: "count-aggregator/index.html",
+		}),
+		finalizeCountAggregatorAppShellPlugin(appRoot, {
+			outDir: "dist/count-aggregator",
+			snippetsDir: "dist/snippets",
+			snippetName: "count-aggregator",
+			builtHtmlRelativePath: "count-aggregator/index.html",
+			removeFromDeployRelativePath: "count-aggregator",
+			assetsRewriteBase: "/mapsight-assets",
+			htaccessBase: "/count-aggregator",
+			cacheConfig: {
+				runtimeEntry: "embed",
+				appStylesheet: "mapsight.css",
+				embedTypeEntries: {},
+			},
+		}),
+	],
+});
+```
+
+After `vite build`, deploy only `dist/count-aggregator/assets/` and `.htaccess`. Paste `dist/snippets/count-aggregator.html` into the host CMS page.
+
+## Related docs
+
+- [`@mapsight/count-aggregator-ui` README](https://github.com/open-mapsight/mapsight/blob/main/packages/count-aggregator-ui/README.md)
+- [`@mapsight/vite-host-embed` README](https://github.com/open-mapsight/mapsight/tree/main/packages/vite-host-embed)

package/dist/finalize.d.ts

@@ -0,0 +1,5 @@
+import type { Plugin } from "vite";
+import type { CountAggregatorAppShellEmbedConfig } from "./types.ts";
+/** Finalize a count-aggregator app-shell build: assets-only deploy + CMS snippet. */
+export declare function finalizeCountAggregatorAppShellPlugin(appRoot: string, config: CountAggregatorAppShellEmbedConfig): Plugin;
+//# sourceMappingURL=finalize.d.ts.map

package/dist/finalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize.d.ts","sourceRoot":"","sources":["../src/finalize.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,MAAM,CAAC;AAMjC,OAAO,KAAK,EAAC,kCAAkC,EAAC,MAAM,YAAY,CAAC;AAgBnE,qFAAqF;AACrF,wBAAgB,qCAAqC,CACpD,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,kCAAkC,GACxC,MAAM,CA+CR"}

package/dist/finalize.js

@@ -0,0 +1,43 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { buildCacheControlBlock, rewriteAbsoluteAssetPaths, } from "@mapsight/vite-host-embed";
+import { renderAppShellSnippetDocument, stripBuiltHtmlShell, } from "./snippets.js";
+function buildAppShellHtaccess(config) {
+    return `# Mapsight count-aggregator static assets under ${config.htaccessBase}/.
+# Page HTML comes from the host CMS (paste ${config.snippetsDir}/${config.snippetName}.html).
+<IfModule mod_rewrite.c>
+	RewriteEngine On
+	RewriteBase ${config.htaccessBase}/
+
+	RewriteRule ^assets/ - [L]
+</IfModule>
+
+${buildCacheControlBlock(config.cacheConfig)}
+`;
+}
+/** Finalize a count-aggregator app-shell build: assets-only deploy + CMS snippet. */
+export function finalizeCountAggregatorAppShellPlugin(appRoot, config) {
+    const outDir = path.join(appRoot, config.outDir);
+    const snippetsDir = path.join(appRoot, config.snippetsDir);
+    const builtHtmlPath = path.join(outDir, config.builtHtmlRelativePath);
+    const description = config.snippetDescription ?? "Mapsight count-aggregator CMS embed";
+    return {
+        name: "mapsight-count-aggregator-app-shell-finalize",
+        apply: "build",
+        async closeBundle() {
+            await rewriteAbsoluteAssetPaths(path.join(outDir, "assets"), config.assetsRewriteBase);
+            const html = await fs.readFile(builtHtmlPath, "utf8");
+            const bodyMarkup = stripBuiltHtmlShell(html);
+            await fs.mkdir(snippetsDir, { recursive: true });
+            await fs.writeFile(path.join(snippetsDir, `${config.snippetName}.html`), renderAppShellSnippetDocument(description, config.htaccessBase, bodyMarkup), "utf8");
+            if (config.removeFromDeployRelativePath) {
+                await fs.rm(path.join(outDir, config.removeFromDeployRelativePath), {
+                    recursive: true,
+                    force: true,
+                });
+            }
+            await fs.writeFile(path.join(outDir, ".htaccess"), buildAppShellHtaccess(config), "utf8");
+        },
+    };
+}
+//# sourceMappingURL=finalize.js.map

package/dist/finalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize.js","sourceRoot":"","sources":["../src/finalize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EACN,sBAAsB,EACtB,yBAAyB,GACzB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACN,6BAA6B,EAC7B,mBAAmB,GACnB,MAAM,eAAe,CAAC;AAGvB,SAAS,qBAAqB,CAAC,MAA0C;IACxE,OAAO,mDAAmD,MAAM,CAAC,YAAY;6CACjC,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW;;;eAGtE,MAAM,CAAC,YAAY;;;;;EAKhC,sBAAsB,CAAC,MAAM,CAAC,WAAW,CAAC;CAC3C,CAAC;AACF,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,qCAAqC,CACpD,OAAe,EACf,MAA0C;IAE1C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAC3D,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACtE,MAAM,WAAW,GAChB,MAAM,CAAC,kBAAkB,IAAI,qCAAqC,CAAC;IAEpE,OAAO;QACN,IAAI,EAAE,8CAA8C;QACpD,KAAK,EAAE,OAAO;QACd,KAAK,CAAC,WAAW;YAChB,MAAM,yBAAyB,CAC9B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC3B,MAAM,CAAC,iBAAiB,CACxB,CAAC;YAEF,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;YACtD,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;YAE7C,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC;YAC/C,MAAM,EAAE,CAAC,SAAS,CACjB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,WAAW,OAAO,CAAC,EACpD,6BAA6B,CAC5B,WAAW,EACX,MAAM,CAAC,YAAY,EACnB,UAAU,CACV,EACD,MAAM,CACN,CAAC;YAEF,IAAI,MAAM,CAAC,4BAA4B,EAAE,CAAC;gBACzC,MAAM,EAAE,CAAC,EAAE,CACV,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,4BAA4B,CAAC,EACtD;oBACC,SAAS,EAAE,IAAI;oBACf,KAAK,EAAE,IAAI;iBACX,CACD,CAAC;YACH,CAAC;YAED,MAAM,EAAE,CAAC,SAAS,CACjB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,EAC9B,qBAAqB,CAAC,MAAM,CAAC,EAC7B,MAAM,CACN,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { finalizeCountAggregatorAppShellPlugin } from "./finalize.ts";
+export { renderAppShellSnippetDocument, stripBuiltHtmlShell, } from "./snippets.ts";
+export type { CountAggregatorAppShellEmbedConfig } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,qCAAqC,EAAC,MAAM,eAAe,CAAC;AACpE,OAAO,EACN,6BAA6B,EAC7B,mBAAmB,GACnB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAC,kCAAkC,EAAC,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { finalizeCountAggregatorAppShellPlugin } from "./finalize.js";
+export { renderAppShellSnippetDocument, stripBuiltHtmlShell, } from "./snippets.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,qCAAqC,EAAC,MAAM,eAAe,CAAC;AACpE,OAAO,EACN,6BAA6B,EAC7B,mBAAmB,GACnB,MAAM,eAAe,CAAC"}

package/dist/snippets.d.ts

@@ -0,0 +1,4 @@
+/** Strip Vite HTML shell noise after a production app-shell build. */
+export declare function stripBuiltHtmlShell(html: string): string;
+export declare function renderAppShellSnippetDocument(description: string, deployBase: string, bodyMarkup: string): string;
+//# sourceMappingURL=snippets.d.ts.map

package/dist/snippets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippets.d.ts","sourceRoot":"","sources":["../src/snippets.ts"],"names":[],"mappings":"AAOA,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAwBD,wBAAgB,6BAA6B,CAC5C,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GAChB,MAAM,CAQR"}

package/dist/snippets.js

@@ -0,0 +1,35 @@
+const DOCTYPE_HTML = "<!doctype html>";
+const META_CHARSET_START = "<meta charset";
+function startsWithIgnoreCase(value, prefix) {
+    return value.slice(0, prefix.length).toLowerCase() === prefix;
+}
+/** Strip Vite HTML shell noise after a production app-shell build. */
+export function stripBuiltHtmlShell(html) {
+    return stripLeadingMetaCharset(stripLeadingDoctype(html)).trim();
+}
+function stripLeadingDoctype(html) {
+    if (!startsWithIgnoreCase(html, DOCTYPE_HTML)) {
+        return html;
+    }
+    return html.slice(DOCTYPE_HTML.length).trimStart();
+}
+function stripLeadingMetaCharset(html) {
+    if (!startsWithIgnoreCase(html, META_CHARSET_START)) {
+        return html;
+    }
+    const tagEnd = html.indexOf(">");
+    if (tagEnd === -1) {
+        return html;
+    }
+    return html.slice(tagEnd + 1).trimStart();
+}
+export function renderAppShellSnippetDocument(description, deployBase, bodyMarkup) {
+    return `<!--
+${description}
+
+Deploy app assets under ${deployBase}/. Script and stylesheet URLs below are from the latest build — regenerate after rebuild.
+Paste into a CMS page that can host a full app shell (module script + stylesheet).
+-->
+${bodyMarkup}`;
+}
+//# sourceMappingURL=snippets.js.map

package/dist/snippets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippets.js","sourceRoot":"","sources":["../src/snippets.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,iBAAiB,CAAC;AACvC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAE3C,SAAS,oBAAoB,CAAC,KAAa,EAAE,MAAc;IAC1D,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;AAC/D,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC/C,OAAO,uBAAuB,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAClE,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY;IACxC,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CAAC;AACpD,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAY;IAC5C,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,CAAC,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEjC,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC5C,WAAmB,EACnB,UAAkB,EAClB,UAAkB;IAElB,OAAO;EACN,WAAW;;0BAEa,UAAU;;;EAGlC,UAAU,EAAE,CAAC;AACf,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,22 @@
+import type { HostEmbedConfig } from "@mapsight/vite-host-embed";
+export type CountAggregatorAppShellEmbedConfig = {
+    /** Build output directory relative to the app root. */
+    outDir: string;
+    /** Snippet output directory relative to the app root. */
+    snippetsDir: string;
+    /** Snippet filename without `.html`. */
+    snippetName: string;
+    /** Built HTML path relative to `outDir`. */
+    builtHtmlRelativePath: string;
+    /** Optional deploy subtree to remove after snippet extraction. */
+    removeFromDeployRelativePath?: string;
+    /** Deploy prefix for rewritten asset URLs in built CSS/JS. */
+    assetsRewriteBase: string;
+    /** Apache rewrite base for generated `.htaccess`. */
+    htaccessBase: string;
+    /** Cache header config for stable entry files. */
+    cacheConfig: Pick<HostEmbedConfig, "runtimeEntry" | "appStylesheet" | "embedTypeEntries">;
+    /** Snippet file header description. */
+    snippetDescription?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,2BAA2B,CAAC;AAE/D,MAAM,MAAM,kCAAkC,GAAG;IAChD,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kEAAkE;IAClE,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,8DAA8D;IAC9D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,WAAW,EAAE,IAAI,CAChB,eAAe,EACf,cAAc,GAAG,eAAe,GAAG,kBAAkB,CACrD,CAAC;IACF,uCAAuC;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,10 +1,39 @@
 {
   "name": "@mapsight/vite-count-aggregator-embed",
-  "version": "0.0.0",
-  "description": "Bootstrap package record for npm trusted publishing.",
-  "license": "UNLICENSED",
+  "description": "Vite plugin for Mapsight count-aggregator app-shell CMS embed builds",
+  "version": "0.2.0",
+  "type": "module",
+  "dependencies": {
+    "@mapsight/vite-host-embed": "^1.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.2",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.14",
+    "vitest": "^4.1.6"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "vite": "^8.0.14"
+  },
   "repository": {
-    "type": "git",
-    "url": "https://github.com/open-mapsight/mapsight.git"
+    "url": "https://github.com/open-mapsight/mapsight"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "clean-build": "npm-run-all clean build",
+    "lint": "eslint",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
   }
 }