@primate/htmx 0.24.0 → 0.25.0

package/lib/private/default.d.ts

@@ -1,10 +1,11 @@
 declare const _default: (input?: import("@rcompat/type").Unpack<({
     extensions?: string[] | undefined;
-    spa?: boolean | undefined;
+    csr?: boolean | undefined;
     ssr?: boolean | undefined;
 } & {
-    htmxExtensions?: string[] | undefined;
-    templates?: ("handlebars" | "mustache" | "nunjucks" | "xslt")[] | undefined;
+    clientSideTemplates?: {
+        engine: "handlebars" | "mustache" | "nunjucks";
+    } | undefined;
 }) | undefined>) => import("@primate/core/frontend").Module;
 export default _default;
 //# sourceMappingURL=default.d.ts.map

package/lib/private/default.js

@@ -1,32 +1,51 @@
+import E from "#errors";
 import init from "#init";
 import frontend from "@primate/core/frontend";
-import is from "@rcompat/is";
 import string from "@rcompat/string";
-const htmx_esm = "htmx-esm";
+const CLIENT_SIDE_TEMPLATES = {
+    mustache: {
+        package: "mustache",
+        global: "Mustache",
+    },
+    handlebars: {
+        package: "handlebars",
+        global: "Handlebars",
+    },
+    nunjucks: {
+        package: "nunjucks",
+        global: "nunjucks",
+    },
+};
 function server(text) {
     return string.dedent `
     import render from "@primate/htmx/render";
-
     export default props => render(${JSON.stringify(text)}, props);`;
 }
+async function has(specifier, from) {
+    return from.join("node_modules", specifier).exists();
+}
+async function ensure(specifier, from, error) {
+    if (!await has(specifier, from))
+        throw error();
+}
 export default frontend({
     ...init,
-    onBuild(app, { htmxExtensions, templates }) {
-        app.entrypoint(`export { default as htmx } from "${htmx_esm}";`);
-        htmxExtensions.forEach(extension => {
-            app.entrypoint(`
-        export * from "${htmx_esm}/${extension}";
-      `);
-        });
-        const has_templates = htmxExtensions.includes("client-side-templates")
-            && !is.empty(templates);
-        if (has_templates) {
-            templates
-                .filter(template => template !== "xslt")
-                .forEach(template => {
-                app.entrypoint(`export * from "${htmx_esm}/templates/${template}";`);
+    async onBuild(app, options) {
+        await ensure("htmx.org", app.root, () => E.htmx_package_required());
+        const templates = options.clientSideTemplates;
+        const lines = [
+            `import htmx from "htmx.org";`,
+            "globalThis.htmx = htmx;",
+        ];
+        if (templates !== undefined) {
+            await ensure("htmx-ext-client-side-templates", app.root, () => E.client_side_templates_required());
+            const engine = CLIENT_SIDE_TEMPLATES[templates.engine];
+            await ensure(engine.package, app.root, () => {
+                throw E.template_engine_required(templates.engine, engine.package);
             });
+            lines.push(`import ${engine.global} from "${engine.package}";`, `globalThis.${engine.global} = ${engine.global};`, `import "htmx-ext-client-side-templates";`);
         }
+        app.entrypoint(lines.join("\n"));
     },
     compile: {
         server,

package/lib/private/errors.d.ts

@@ -0,0 +1,21 @@
+declare const peer_deps: {
+    handlebars: string;
+    "htmx-ext-client-side-templates": string;
+    "htmx.org": string;
+    mustache: string;
+    nunjucks: string;
+    primate: string;
+};
+type PeerDep = keyof typeof peer_deps;
+declare function could_not_find_app_js_in_assets(): import("@rcompat/error").TemplateError;
+declare function client_side_templates_required(): import("@rcompat/error").TemplateError;
+declare function htmx_package_required(): import("@rcompat/error").TemplateError;
+declare function template_engine_required(engine: string, pkg: PeerDep): import("@rcompat/error").TemplateError;
+declare const errors: {
+    could_not_find_app_js_in_assets: typeof could_not_find_app_js_in_assets;
+    template_engine_required: typeof template_engine_required;
+    client_side_templates_required: typeof client_side_templates_required;
+    htmx_package_required: typeof htmx_package_required;
+};
+export default errors;
+//# sourceMappingURL=errors.d.ts.map

package/lib/private/errors.js

@@ -0,0 +1,33 @@
+import pkg_json from "#pkg-json" with { type: "json" };
+import assert from "@rcompat/assert";
+import error from "@rcompat/error";
+const peer_deps = assert.dict(pkg_json.peerDependencies);
+const t = error.template;
+function version(pkg) {
+    return `${pkg}@${peer_deps[pkg]}`;
+}
+function could_not_find_app_js_in_assets() {
+    return t `could not find app.js in assets`;
+}
+function client_side_templates_required() {
+    const option = "clientSideTemplates";
+    const pkg = "htmx-ext-client-side-templates";
+    return t `${option} requires ${version(pkg)} to be installed`;
+}
+;
+function htmx_package_required() {
+    return t `${version("htmx.org")} must be installed`;
+}
+;
+function template_engine_required(engine, pkg) {
+    const option = "clientSideTemplates.engine";
+    return t `${option} is set to ${engine}, but ${version(pkg)} is not installed`;
+}
+const errors = error.coded({
+    could_not_find_app_js_in_assets,
+    template_engine_required,
+    client_side_templates_required,
+    htmx_package_required,
+});
+export default errors;
+//# sourceMappingURL=errors.js.map

package/lib/private/init.d.ts

@@ -1,10 +1,14 @@
 import type { Init } from "@primate/core/frontend";
 declare const schema: import("pema").ObjectType<import("pema").NormalizeSchemaObject<{
-    readonly htmxExtensions: import("pema").DefaultType<import("pema").ArrayType<import("pema").StringType>, string[]>;
-    readonly templates: import("pema").DefaultType<import("pema").ArrayType<import("pema").EnumType<readonly ["handlebars", "mustache", "nunjucks", "xslt"]>>, ("handlebars" | "mustache" | "nunjucks" | "xslt")[]>;
+    readonly clientSideTemplates: import("pema").OptionalType<import("pema").ObjectType<import("pema").NormalizeSchemaObject<{
+        readonly engine: import("pema").EnumType<readonly ["mustache", "handlebars", "nunjucks"]>;
+    }>, {
+        engine: "handlebars" | "mustache" | "nunjucks";
+    }>>;
 }>, {
-    htmxExtensions: string[];
-    templates: ("handlebars" | "mustache" | "nunjucks" | "xslt")[];
+    clientSideTemplates: {
+        engine: "handlebars" | "mustache" | "nunjucks";
+    } | undefined;
 }>;
 declare const init: Init<any, typeof schema>;
 export default init;

package/lib/private/init.js

@@ -1,16 +1,15 @@
+import E from "#errors";
 import transform_html from "@primate/html/transform";
-import error from "@rcompat/error";
 import p from "pema";
-function could_not_find_app_js_in_assets() {
-    return error.template `could not find app.js in assets`;
-}
-const errors = error.coded({
-    could_not_find_app_js_in_assets,
-});
-const TEMPLATES = ["handlebars", "mustache", "nunjucks", "xslt"];
+const CLIENT_SIDE_TEMPLATE_ENGINES = [
+    "mustache",
+    "handlebars",
+    "nunjucks",
+];
 const schema = p({
-    htmxExtensions: p.array(p.string).default([]),
-    templates: p.array(p.enum(TEMPLATES)).unique().default([]),
+    clientSideTemplates: p({
+        engine: p.enum(CLIENT_SIDE_TEMPLATE_ENGINES),
+    }).optional(),
 });
 const init = {
     name: "htmx",
@@ -30,7 +29,7 @@ const init = {
         });
         const app_js = app.assets.find(({ src }) => src !== undefined && src.includes("app") && src.endsWith(".js"));
         if (app_js === undefined)
-            throw errors.could_not_find_app_js_in_assets();
+            throw E.could_not_find_app_js_in_assets();
         const script = `<script type="module" src="${app_js.src}"></script>`;
         return {
             body: base.body,

package/lib/private/runtime.d.ts

@@ -1,10 +1,11 @@
 declare const _default: (input?: import("@rcompat/type").Unpack<({
     extensions?: string[] | undefined;
-    spa?: boolean | undefined;
+    csr?: boolean | undefined;
     ssr?: boolean | undefined;
 } & {
-    htmxExtensions?: string[] | undefined;
-    templates?: ("handlebars" | "mustache" | "nunjucks" | "xslt")[] | undefined;
+    clientSideTemplates?: {
+        engine: "handlebars" | "mustache" | "nunjucks";
+    } | undefined;
 }) | undefined>) => import("@primate/core/frontend").Module;
 export default _default;
 //# sourceMappingURL=runtime.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primate/htmx",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "HTMX for Primate",
   "homepage": "https://primate.run/docs/frontend/htmx",
   "bugs": "https://github.com/primate-run/primate/issues",
@@ -17,25 +17,44 @@
     "!/**/*.spec.*"
   ],
   "dependencies": {
-    "@rcompat/error": "^0.3.1",
-    "@rcompat/is": "^0.6.1",
-    "@rcompat/string": "^0.16.1",
-    "htmx-esm": "^0.2.1910",
-    "@primate/core": "^0.6.0",
-    "pema": "^0.6.0",
-    "@primate/html": "^0.17.0"
-  },
-  "devDependencies": {
-    "@primate/test": "^0.0.0"
+    "@rcompat/assert": "^0.13.0",
+    "@rcompat/error": "^0.8.0",
+    "@rcompat/fs": "^0.33.2",
+    "@rcompat/is": "^0.11.0",
+    "@rcompat/runtime": "^0.16.0",
+    "@rcompat/string": "^0.21.0",
+    "@primate/core": "^0.7.0",
+    "@primate/html": "^0.18.0",
+    "pema": "^0.7.0"
   },
   "peerDependencies": {
-    "primate": "^0.37.0"
+    "handlebars": "4",
+    "htmx-ext-client-side-templates": "2",
+    "htmx.org": "2",
+    "mustache": "4",
+    "nunjucks": "3",
+    "primate": "^0.38.0"
+  },
+  "peerDependenciesMeta": {
+    "htmx-ext-client-side-templates": {
+      "optional": true
+    },
+    "mustache": {
+      "optional": true
+    },
+    "handlebars": {
+      "optional": true
+    },
+    "nunjucks": {
+      "optional": true
+    }
   },
   "imports": {
     "#*": {
       "@primate/source": "./src/private/*.ts",
       "default": "./lib/private/*.js"
-    }
+    },
+    "#pkg-json": "./package.json"
   },
   "exports": {
     ".": {
@@ -52,7 +71,6 @@
   "scripts": {
     "build": "npm run clean && tsc",
     "clean": "rm -rf ./lib",
-    "lint": "eslint .",
-    "test": "npx proby"
+    "lint": "eslint ."
   }
 }