@veryfront/ext-css-tailwind 0.1.1186 → 0.1.1189

package/esm/deno.d.ts

@@ -0,0 +1,38 @@
+declare namespace _default {
+    let name: string;
+    let version: string;
+    let exports: string;
+    namespace veryfront {
+        let extension: boolean;
+        let activation: string;
+        namespace contracts {
+            let provides: string[];
+        }
+        namespace npm {
+            let runtimeVersionFromManifest: boolean;
+        }
+        let capabilities: {
+            type: string;
+        }[];
+    }
+    let imports: {
+        "@tailwindcss/forms": string;
+        "@tailwindcss/typography": string;
+        daisyui: string;
+        "tailwind-scrollbar-hide": string;
+        tailwindcss: string;
+        "tailwindcss-animate": string;
+        "tailwindcss/index.css": string;
+        "tailwindcss/package.json": string;
+        "@std/assert": string;
+        "@std/testing/bdd": string;
+        "veryfront/extensions": string;
+        "veryfront/extensions/css": string;
+        "veryfront/errors": string;
+    };
+    namespace tasks {
+        let test: string;
+    }
+}
+export default _default;
+//# sourceMappingURL=deno.d.ts.map

package/esm/deno.d.ts.map

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

package/esm/deno.js

@@ -0,0 +1,34 @@
+export default {
+    "name": "@veryfront/ext-css-tailwind",
+    "version": "0.1.0",
+    "exports": "./src/index.ts",
+    "veryfront": {
+        "extension": true,
+        "activation": "explicit",
+        "contracts": {
+            "provides": ["CSSProcessor"]
+        },
+        "npm": {
+            "runtimeVersionFromManifest": true
+        },
+        "capabilities": [{ "type": "fs:read" }]
+    },
+    "imports": {
+        "@tailwindcss/forms": "npm:@tailwindcss/forms@0.5.11",
+        "@tailwindcss/typography": "npm:@tailwindcss/typography@0.5.19",
+        "daisyui": "npm:daisyui@5.5.14",
+        "tailwind-scrollbar-hide": "npm:tailwind-scrollbar-hide@2.0.0",
+        "tailwindcss": "npm:tailwindcss@4.2.2",
+        "tailwindcss-animate": "npm:tailwindcss-animate@1.0.7",
+        "tailwindcss/index.css": "npm:tailwindcss@4.2.2/index.css",
+        "tailwindcss/package.json": "npm:tailwindcss@4.2.2/package.json",
+        "@std/assert": "jsr:@std/assert@1.0.19",
+        "@std/testing/bdd": "jsr:@std/testing@1.0.17/bdd",
+        "veryfront/extensions": "../../src/extensions/index.ts",
+        "veryfront/extensions/css": "../../src/extensions/css/index.ts",
+        "veryfront/errors": "../../src/errors/index.ts"
+    },
+    "tasks": {
+        "test": "deno test --frozen --allow-read src/"
+    }
+};

package/esm/src/index.d.ts

@@ -0,0 +1,14 @@
+/** Tailwind CSS implementation of the provider-neutral CSSProcessor contract. */
+import "../_dnt.polyfills.js";
+import type { ExtensionFactory } from "veryfront/extensions";
+import { type CSSCompiler, type CSSProcessor } from "veryfront/extensions/css";
+export declare const TAILWIND_DEFAULT_STYLESHEET = "@import \"tailwindcss\";\n@plugin \"@tailwindcss/typography\";\n@custom-variant dark (&:is(.dark, [data-theme=\"dark\"]) *, &:is(.dark, [data-theme=\"dark\"]));";
+export declare class TailwindCSSProcessor implements CSSProcessor {
+    readonly cacheIdentity: string;
+    readonly defaultStylesheet = "@import \"tailwindcss\";\n@plugin \"@tailwindcss/typography\";\n@custom-variant dark (&:is(.dark, [data-theme=\"dark\"]) *, &:is(.dark, [data-theme=\"dark\"]));";
+    constructor();
+    compile(stylesheet: string): Promise<CSSCompiler>;
+}
+declare const extTailwind: ExtensionFactory;
+export default extTailwind;
+//# sourceMappingURL=index.d.ts.map

package/esm/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/src/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,sBAAsB,CAAC;AAO9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAoB,MAAM,0BAA0B,CAAC;AAoBjG,eAAO,MAAM,2BAA2B,qKAEqD,CAAC;AAqD9F,qBAAa,oBAAqB,YAAW,YAAY;IACvD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,sKAA+B;;IAenD,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CA2CxD;AAKD,QAAA,MAAM,WAAW,EAAE,gBAYlB,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/esm/src/index.js

@@ -0,0 +1,150 @@
+/** Tailwind CSS implementation of the provider-neutral CSSProcessor contract. */
+import "../_dnt.polyfills.js";
+import { createHash } from "node:crypto";
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { isProxy as isProxyWithoutHooks } from "node:util/types";
+import { CSSProcessorName } from "veryfront/extensions/css";
+import { IMPORT_RESOLUTION_ERROR } from "veryfront/errors";
+import { compile } from "tailwindcss";
+import extensionPackage from "../deno.js";
+import { exactTailwindVersion } from "./manifest-dependency.js";
+import { loadPlugin } from "./plugin-loader.js";
+import { TAILWIND_PLUGIN_POLICY_IDENTITY } from "./plugin-policy.js";
+const ENGINE_SEMANTICS_VERSION = "veryfront.css-tailwind.v4";
+const apply = Reflect.apply;
+const arrayJoin = Array.prototype.join;
+const freeze = Object.freeze;
+const getOwnPropertyDescriptor = Object.getOwnPropertyDescriptor;
+const getOwnPropertyDescriptors = Object.getOwnPropertyDescriptors;
+const getPrototypeOf = Object.getPrototypeOf;
+const isArray = Array.isArray;
+const objectPrototype = Object.prototype;
+const ownKeys = Reflect.ownKeys;
+const requireFromExtension = createRequire(globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).url);
+const tailwindVersion = exactTailwindVersion(extensionPackage.imports.tailwindcss);
+export const TAILWIND_DEFAULT_STYLESHEET = `@import "tailwindcss";
+@plugin "@tailwindcss/typography";
+@custom-variant dark (&:is(.dark, [data-theme="dark"]) *, &:is(.dark, [data-theme="dark"]));`;
+function sha256(value) {
+    return createHash("sha256").update(value, "utf8").digest("hex");
+}
+function loadTailwindBaseStylesheet() {
+    let resolved;
+    try {
+        resolved = requireFromExtension.resolve("tailwindcss/index.css");
+    }
+    catch (cause) {
+        throw IMPORT_RESOLUTION_ERROR.create({
+            detail: "ext-css-tailwind could not resolve its pinned base stylesheet",
+            cause,
+        });
+    }
+    try {
+        return readFileSync(resolved, "utf8");
+    }
+    catch (cause) {
+        throw IMPORT_RESOLUTION_ERROR.create({
+            detail: `ext-css-tailwind could not read its pinned base stylesheet: ${resolved}`,
+            cause,
+        });
+    }
+}
+const tailwindBaseStylesheet = loadTailwindBaseStylesheet();
+function assertEmptyConfig(value) {
+    if (value === undefined)
+        return;
+    if (typeof value !== "object" ||
+        value === null ||
+        isArray(value) ||
+        isProxyWithoutHooks(value)) {
+        throw new TypeError("ext-css-tailwind config must be an object");
+    }
+    let prototype;
+    let keys;
+    try {
+        prototype = getPrototypeOf(value);
+        keys = ownKeys(getOwnPropertyDescriptors(value));
+    }
+    catch (cause) {
+        throw new TypeError("ext-css-tailwind config could not be inspected", { cause });
+    }
+    if (prototype !== objectPrototype && prototype !== null) {
+        throw new TypeError("ext-css-tailwind config must not inherit configuration");
+    }
+    if (keys.length !== 0) {
+        throw new TypeError("ext-css-tailwind does not accept configuration properties");
+    }
+}
+export class TailwindCSSProcessor {
+    cacheIdentity;
+    defaultStylesheet = TAILWIND_DEFAULT_STYLESHEET;
+    constructor() {
+        const identityParts = [
+            ENGINE_SEMANTICS_VERSION,
+            `ext-css-tailwind@${extensionPackage.version}`,
+            `tailwindcss@${tailwindVersion}`,
+            `base=${sha256(tailwindBaseStylesheet)}`,
+            `default=${sha256(this.defaultStylesheet)}`,
+            `plugins=${sha256(TAILWIND_PLUGIN_POLICY_IDENTITY)}`,
+        ];
+        this.cacheIdentity = apply(arrayJoin, identityParts, [";"]);
+        freeze(this);
+    }
+    async compile(stylesheet) {
+        if (typeof stylesheet !== "string") {
+            throw new TypeError("ext-css-tailwind stylesheet must be a string");
+        }
+        const native = await compile(stylesheet, {
+            base: "/",
+            loadStylesheet: (id) => {
+                if (id !== "tailwindcss") {
+                    throw IMPORT_RESOLUTION_ERROR.create({
+                        detail: `ext-css-tailwind cannot resolve stylesheet import "${id}"`,
+                    });
+                }
+                return Promise.resolve({
+                    content: tailwindBaseStylesheet,
+                    base: "/",
+                    path: "/tailwindcss/index.css",
+                });
+            },
+            loadModule: (id) => Promise.resolve({
+                // deno-lint-ignore no-explicit-any -- Tailwind's vendor API accepts opaque plugin modules.
+                module: loadPlugin(id),
+                base: "/",
+                path: "/",
+            }),
+        });
+        const buildDescriptor = getOwnPropertyDescriptor(native, "build");
+        if (buildDescriptor === undefined ||
+            !("value" in buildDescriptor) ||
+            typeof buildDescriptor.value !== "function") {
+            throw IMPORT_RESOLUTION_ERROR.create({
+                detail: "ext-css-tailwind compiler did not expose a stable build method",
+            });
+        }
+        const nativeBuild = buildDescriptor.value;
+        return freeze({
+            build(candidates) {
+                return apply(nativeBuild, native, [candidates]);
+            },
+        });
+    }
+}
+freeze(TailwindCSSProcessor.prototype);
+freeze(TailwindCSSProcessor);
+const extTailwind = (config) => {
+    assertEmptyConfig(config);
+    return {
+        name: "ext-css-tailwind",
+        version: extensionPackage.version,
+        contracts: { provides: [CSSProcessorName] },
+        capabilities: [{ type: "fs:read" }],
+        setup(ctx) {
+            ctx.provide(CSSProcessorName, new TailwindCSSProcessor());
+            ctx.logger.debug(`[ext-css-tailwind] ${CSSProcessorName} registered`);
+        },
+    };
+};
+export default extTailwind;

package/esm/src/manifest-dependency.d.ts

@@ -0,0 +1,3 @@
+/** Resolve Tailwind's exact version from this extension's checked-in manifest. */
+export declare function exactTailwindVersion(specifier: unknown): string;
+//# sourceMappingURL=manifest-dependency.d.ts.map

package/esm/src/manifest-dependency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-dependency.d.ts","sourceRoot":"","sources":["../../src/src/manifest-dependency.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAMlF,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAc/D"}

package/esm/src/manifest-dependency.js

@@ -0,0 +1,13 @@
+/** Resolve Tailwind's exact version from this extension's checked-in manifest. */
+const TAILWIND_NPM_PREFIX = "npm:tailwindcss@";
+const EXACT_SEMVER_PATTERN = /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-(?:(?:0|[1-9]\d*)|\d*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:(?:0|[1-9]\d*)|\d*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
+export function exactTailwindVersion(specifier) {
+    if (typeof specifier !== "string" || !specifier.startsWith(TAILWIND_NPM_PREFIX)) {
+        throw new TypeError("ext-css-tailwind imports.tailwindcss must target npm:tailwindcss at an exact semantic version");
+    }
+    const version = specifier.slice(TAILWIND_NPM_PREFIX.length);
+    if (!EXACT_SEMVER_PATTERN.test(version)) {
+        throw new TypeError("ext-css-tailwind imports.tailwindcss must use an exact semantic version without a range or subpath");
+    }
+    return version;
+}

package/esm/src/plugin-loader.d.ts

@@ -0,0 +1,7 @@
+/** Static plugin loading owned entirely by ext-css-tailwind. */
+/**
+ * Resolve an audited plugin from the extension's immutable local registry.
+ * Unknown packages and version overrides fail before Tailwind receives a value.
+ */
+export declare function loadPlugin(id: string): unknown;
+//# sourceMappingURL=plugin-loader.d.ts.map

package/esm/src/plugin-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../../src/src/plugin-loader.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAsEhE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAK9C"}

package/esm/src/plugin-loader.js

@@ -0,0 +1,68 @@
+/** Static plugin loading owned entirely by ext-css-tailwind. */
+import forms from "@tailwindcss/forms";
+import typography from "@tailwindcss/typography";
+import daisyui from "daisyui";
+import scrollbarHide from "tailwind-scrollbar-hide";
+import tailwindcssAnimate from "tailwindcss-animate";
+import { IMPORT_RESOLUTION_ERROR, SECURITY_VIOLATION } from "veryfront/errors";
+import { bareName, resolveTailwindPluginPolicy, TAILWIND_PLUGIN_ALLOWLIST, } from "./plugin-policy.js";
+function getStaticPlugin(name) {
+    switch (name) {
+        case "@tailwindcss/forms":
+            return forms;
+        case "@tailwindcss/typography":
+            return typography;
+        case "daisyui":
+            return daisyui;
+        case "tailwind-scrollbar-hide":
+            return scrollbarHide;
+        case "tailwindcss-animate":
+            return tailwindcssAnimate;
+        default:
+            throw IMPORT_RESOLUTION_ERROR.create({
+                detail: `Tailwind plugin "${name}" is absent from the static extension registry`,
+            });
+    }
+}
+function requirePinnedPlugin(specifier) {
+    try {
+        return resolveTailwindPluginPolicy(specifier).name;
+    }
+    catch (cause) {
+        const displayName = typeof specifier === "string" ? bareName(specifier) : "<non-string>";
+        throw SECURITY_VIOLATION.create({
+            detail: `Package "${displayName}" is not an audited ext-css-tailwind plugin`,
+            cause,
+        });
+    }
+}
+function assertStaticPlugin(name, value) {
+    if (typeof value !== "function" &&
+        (typeof value !== "object" || value === null)) {
+        throw IMPORT_RESOLUTION_ERROR.create({
+            detail: `Tailwind plugin "${name}" did not export a plugin value`,
+        });
+    }
+}
+function assertCompleteStaticRegistry() {
+    for (let index = 0; index < TAILWIND_PLUGIN_ALLOWLIST.length; index++) {
+        const name = TAILWIND_PLUGIN_ALLOWLIST[index];
+        if (name === undefined) {
+            throw IMPORT_RESOLUTION_ERROR.create({
+                detail: "ext-css-tailwind plugin policy contains an invalid entry",
+            });
+        }
+        assertStaticPlugin(name, getStaticPlugin(name));
+    }
+}
+assertCompleteStaticRegistry();
+/**
+ * Resolve an audited plugin from the extension's immutable local registry.
+ * Unknown packages and version overrides fail before Tailwind receives a value.
+ */
+export function loadPlugin(id) {
+    const name = requirePinnedPlugin(id);
+    const plugin = getStaticPlugin(name);
+    assertStaticPlugin(name, plugin);
+    return plugin;
+}

package/esm/src/plugin-policy.d.ts

@@ -0,0 +1,24 @@
+/** Audited local plugin policy owned by ext-css-tailwind. */
+export type TailwindPluginPolicyEntry = Readonly<{
+    name: string;
+    version: string;
+    importSpecifier: string;
+    npmSpecifier: string;
+}>;
+/**
+ * Complete immutable inventory of third-party plugin implementations shipped
+ * by this extension. Each entry must have a matching exact import-map target
+ * and a static import in `plugin-loader.ts`.
+ */
+export declare const TAILWIND_PLUGIN_POLICY: readonly Readonly<{
+    name: string;
+    version: string;
+    importSpecifier: string;
+    npmSpecifier: string;
+}>[];
+export declare const PACKAGE_SPEC_RE: Readonly<RegExp>;
+export declare function bareName(specifier: string): string;
+export declare const TAILWIND_PLUGIN_ALLOWLIST: readonly string[];
+export declare function resolveTailwindPluginPolicy(specifier: string): TailwindPluginPolicyEntry;
+export declare const TAILWIND_PLUGIN_POLICY_IDENTITY: string;
+//# sourceMappingURL=plugin-policy.d.ts.map

package/esm/src/plugin-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-policy.d.ts","sourceRoot":"","sources":["../../src/src/plugin-policy.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAAC;AA2BH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;UApC3B,MAAM;aACH,MAAM;qBACE,MAAM;kBACT,MAAM;IAuCpB,CAAC;AAEH,eAAO,MAAM,eAAe,kBAE3B,CAAC;AAEF,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAUlD;AAaD,eAAO,MAAM,yBAAyB,mBAAoB,CAAC;AAE3D,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,GAChB,yBAAyB,CAqB3B;AAsBD,eAAO,MAAM,+BAA+B,EAIrC,MAAM,CAAC"}

package/esm/src/plugin-policy.js

@@ -0,0 +1,86 @@
+/** Audited local plugin policy owned by ext-css-tailwind. */
+const apply = Reflect.apply;
+const MapConstructor = Map;
+const NativeTypeError = TypeError;
+const arrayMap = Array.prototype.map;
+const arraySort = Array.prototype.sort;
+const freeze = Object.freeze;
+const jsonStringify = JSON.stringify;
+const mapGet = Map.prototype.get;
+const regexpExec = RegExp.prototype.exec;
+const stringIndexOf = String.prototype.indexOf;
+const stringSlice = String.prototype.slice;
+const stringStartsWith = String.prototype.startsWith;
+function definePlugin(name, version) {
+    return freeze({
+        name,
+        version,
+        importSpecifier: name,
+        npmSpecifier: `npm:${name}@${version}`,
+    });
+}
+/**
+ * Complete immutable inventory of third-party plugin implementations shipped
+ * by this extension. Each entry must have a matching exact import-map target
+ * and a static import in `plugin-loader.ts`.
+ */
+export const TAILWIND_PLUGIN_POLICY = freeze([
+    definePlugin("tailwindcss-animate", "1.0.7"),
+    definePlugin("@tailwindcss/typography", "0.5.19"),
+    definePlugin("@tailwindcss/forms", "0.5.11"),
+    definePlugin("tailwind-scrollbar-hide", "2.0.0"),
+    definePlugin("daisyui", "5.5.14"),
+]);
+export const PACKAGE_SPEC_RE = freeze(/^(?:@[a-z0-9][\w.-]*\/)?[a-z0-9][\w.-]*(?:@[\w.+-]+)?$/);
+export function bareName(specifier) {
+    if (typeof specifier !== "string") {
+        throw new NativeTypeError("Tailwind plugin specifier must be a string");
+    }
+    if (apply(stringStartsWith, specifier, ["@"])) {
+        const index = apply(stringIndexOf, specifier, ["@", 1]);
+        return index === -1 ? specifier : apply(stringSlice, specifier, [0, index]);
+    }
+    const index = apply(stringIndexOf, specifier, ["@"]);
+    return index === -1 ? specifier : apply(stringSlice, specifier, [0, index]);
+}
+const POLICY_BY_NAME = new MapConstructor(apply(arrayMap, TAILWIND_PLUGIN_POLICY, [
+    (entry) => [entry.name, entry],
+]));
+/** Immutable public view of the packages this extension can load. */
+const allowlist = apply(arrayMap, TAILWIND_PLUGIN_POLICY, [
+    (entry) => entry.name,
+]);
+apply(arraySort, allowlist, []);
+export const TAILWIND_PLUGIN_ALLOWLIST = freeze(allowlist);
+export function resolveTailwindPluginPolicy(specifier) {
+    if (typeof specifier !== "string" ||
+        apply(regexpExec, PACKAGE_SPEC_RE, [specifier]) === null) {
+        throw new NativeTypeError(`Invalid Tailwind plugin specifier: ${specifier}`);
+    }
+    const name = bareName(specifier);
+    const policy = apply(mapGet, POLICY_BY_NAME, [name]);
+    if (policy === undefined) {
+        throw new NativeTypeError(`Tailwind plugin is not allowlisted: ${name}`);
+    }
+    const pinnedSpecifier = `${policy.name}@${policy.version}`;
+    if (specifier !== name && specifier !== pinnedSpecifier) {
+        throw new NativeTypeError(`Tailwind plugin ${name} must use the audited version ${pinnedSpecifier}`);
+    }
+    return policy;
+}
+const identityPlugins = apply(arrayMap, TAILWIND_PLUGIN_POLICY, [
+    (entry) => ({
+        name: entry.name,
+        version: entry.version,
+        importSpecifier: entry.importSpecifier,
+        npmSpecifier: entry.npmSpecifier,
+    }),
+]);
+apply(arraySort, identityPlugins, [
+    (left, right) => left.name < right.name ? -1 : left.name > right.name ? 1 : 0,
+]);
+export const TAILWIND_PLUGIN_POLICY_IDENTITY = apply(jsonStringify, JSON, [{
+        schema: "veryfront.tailwind-plugin-policy.v3",
+        resolution: "extension-owned-static-npm-imports",
+        plugins: identityPlugins,
+    }]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veryfront/ext-css-tailwind",
-  "version": "0.1.1186",
+  "version": "0.1.1189",
   "description": "Veryfront first-party extension package for ext-css-tailwind",
   "keywords": [
     "veryfront",
@@ -27,7 +27,7 @@
   },
   "scripts": {},
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22.3.0"
   },
   "publishConfig": {
     "access": "public"
@@ -58,7 +58,7 @@
     "tailwindcss-animate": "1.0.7"
   },
   "peerDependencies": {
-    "veryfront": "^0.1.1186"
+    "veryfront": "^0.1.1189"
   },
   "type": "module",
   "types": "./esm/src/index.d.ts",