cssints 0.1.0 → 0.2.0

package/dist/index.d.mts

@@ -1,8 +1,14 @@
 import { a as Kernel } from "./author-types-C1AhsnrT.mjs";
-import { n as cx } from "./runtime-CTvuM-Hm.mjs";
-import { n as At, t as CssNode } from "./node-CdhAGmF3.mjs";
-import { t as Fallback } from "./lib-2OEIfPAE.mjs";
+import { n as _cv, r as _cx } from "./runtime-Dt4Tm0Q7.mjs";
+import { n as At, t as CssNode } from "./node-OJ_w_Usj.mjs";
 import { CSS, CSSColorValue, CSSImageValue, CSSStyleValue, CSSUnitValue } from "@cssints/css-grammar/values";
+import { Effect } from "effect";
+//#region src/lib.d.ts
+/** What firstThatWorks() builds: its values as text, the wanted one first. */
+interface Fallback {
+  __fallback: string[];
+}
+//#endregion
 //#region src/macro.d.ts
 export declare const firstThatWorks: (...values: unknown[]) => Fallback;
 export declare class CSSAtRuleValue extends CSSStyleValue {
@@ -13,7 +19,7 @@ export declare class CSSAtRuleValue extends CSSStyleValue {
 }
 export declare const keyframes: (steps: unknown) => CSSAtRuleValue;
 export declare const positionTry: (...args: unknown[]) => CSSAtRuleValue | CssNode;
-export declare const cn: (...args: unknown[]) => CssNode;
+export declare const cn: (...all: unknown[]) => CssNode;
 export declare const flex: (...args: unknown[]) => CssNode;
 export declare const grid: (...args: unknown[]) => CssNode;
 type Styles = Record<string, Record<string, unknown>>;
@@ -26,9 +32,17 @@ interface CvConfig {
 export declare const cv: (config: CvConfig) => ((props?: Record<string, string | boolean | undefined>) => string) & {
   __cv: CvConfig;
 };
+export declare const __cnGroup: (statics: [number, unknown][], parts: [number, number][]) => {
+  __cnGroup: {
+    statics: [number, unknown][];
+    parts: [number, number][];
+  };
+};
+export declare const __nocn: () => undefined;
 export declare const css: Record<string, unknown>;
+export declare const __group: (id: string) => Record<string, unknown>;
 export declare function __at(file: string, site: number, offset: number): At;
 export declare const __unseen: (file: string, site: number) => boolean;
 export declare function __site(at: At, value: unknown): unknown;
 //#endregion
-export { CSS, CSSColorValue, CSSImageValue, CSSStyleValue, CSSUnitValue, cx };
+export { CSS, CSSColorValue, CSSImageValue, CSSStyleValue, CSSUnitValue, _cv, _cx };

package/dist/index.mjs

@@ -1,8 +1,8 @@
-import { a as registry, d as MacroError, f as MemberError, o as warn, r as forgetKernels, t as Registry } from "./registry-n9JCX4pl.mjs";
-import { A as isNode, C as minWidth, D as camel, E as VAR, M as probed, O as fail, S as merged, T as toDecls, _ as chainDecl, a as createTokens, b as hashClass, c as CSSTokenValue, d as token, f as CONTEXTS, g as carried, h as PSEUDOS, i as createGlobalTheme, j as node, k as failIn, l as isStyle, m as LAYER, n as addTheme, o as isDone, p as FUNCTIONS, r as check$1, s as tokensOf, t as DONE, u as style, v as checkVars, w as settled, x as isFallback, y as edge } from "./theme-BGEbFAYh.mjs";
-import { D as relation, S as addRuntime, _ as addKernel, i as byOrder, n as addGlobal, r as addLayers, y as kernelWarnings } from "./sheet-CO7a-mdA.mjs";
-import { n as loweredOf } from "./lowered-CeoXbm0P.mjs";
-import { t as CV_CALL } from "./instrument-Bdtk2INz.mjs";
+import { a as registry, d as MacroError, f as MemberError, o as warn, r as forgetKernels, t as Registry } from "./registry-CTumHB8p.mjs";
+import { A as camel, C as hashClass, D as settled, E as minWidth, F as probed, M as failIn, N as isNode, O as toDecls, P as node, S as edge, T as merged, _ as PSEUDOS, a as createTokens, b as checkVars, c as tokensOf, d as style, f as token, g as PROPS, h as LAYER, i as createGlobalTheme, j as fail, k as VAR, l as CSSTokenValue, m as FUNCTIONS, n as addTheme, o as isDone, p as CONTEXTS, r as check$1, t as DONE, u as isStyle, v as carried, w as isFallback, x as dropsOf, y as chainDecl } from "./theme-BsP2E4LB.mjs";
+import { D as relation, S as addRuntime, _ as addKernel, i as byOrder, n as addGlobal, r as addLayers, y as kernelWarnings } from "./sheet-BKsMTa0c.mjs";
+import { n as loweredOf } from "./lowered-D2KusPLp.mjs";
+import { n as CX_CALL, s as groups$1, t as CV_CALL } from "./instrument-gCazujmb.mjs";
 import { checkDeclarationNow, checkQuery, checkSelector, checkValueNow, isDeclarationError } from "@cssints/css-grammar/check";
 import { lackingOf, messageOf } from "@cssints/css-grammar/support";
 import { CSS, CSSColorValue, CSSImageValue, CSSStyleValue, CSSStyleValue as CSSStyleValue$1, CSSUnitValue } from "@cssints/css-grammar/values";
@@ -30,7 +30,7 @@ const OPERATORS = /* @__PURE__ */ new Set([
 	"*",
 	"/"
 ]);
-const isGroup = (p) => Array.isArray(p);
+const isGroup$1 = (p) => Array.isArray(p);
 const build = (member, name) => {
 	const { sep, math } = functions[name];
 	const grammar = math ? MATH : `<${name}()>`;
@@ -40,7 +40,7 @@ const build = (member, name) => {
 			else if (typeof p !== "number" && !(p instanceof CSSStyleValue$1)) throw fail(`cssints: ${member}() takes strings, numbers and Typed OM values (tokens, other calls), got ${Formatter.formatJson(p)}`);
 			return String(p);
 		};
-		const texts = parts.map((p, i) => isGroup(p) ? p.map(atom).join(" ") : name === "var" && !i && p instanceof CSSTokenValue ? p.name : atom(p));
+		const texts = parts.map((p, i) => isGroup$1(p) ? p.map(atom).join(" ") : name === "var" && !i && p instanceof CSSTokenValue ? p.name : atom(p));
 		const join = (ts) => ts.reduce((acc, t, i) => i ? `${acc}${OPERATORS.has(t) || OPERATORS.has(ts[i - 1]) ? " " : sep}${t}` : t, "");
 		const value = `${name}(${join(texts)})`;
 		const first = parts[0];
@@ -79,6 +79,102 @@ const checkText = (label, grammar, text, where) => {
 /** The members of `css` that are functions, by name. */
 const fns = Object.fromEntries(Object.entries(FUNCTIONS).map(([member, name]) => [member, build(member, name)]));
 //#endregion
+//#region src/group.ts
+const CONDITIONS = [
+	"media",
+	"container",
+	"supports"
+];
+const TIED = /* @__PURE__ */ new Set([
+	...Object.keys(PROPS),
+	...Object.keys(FUNCTIONS),
+	...Object.keys(PSEUDOS),
+	...CONDITIONS,
+	"keyframes",
+	"positionTry"
+]);
+const WORDS = /[^ ,)/:;"'<>=+*[\]{}!#%.⟨⟩&|\n\t(]+\(?/g;
+const words = (s) => new Set(s ? s.split(" ") : []);
+const groups = new Map(Object.entries(groups$1));
+const compiled$1 = /* @__PURE__ */ new Map();
+const compile$1 = (id) => {
+	const g = groups.get(id);
+	if (!g) throw fail(`cssints: no export group cssints/${id}`);
+	const members = words(g.members);
+	const units = g.ban.unit ? g.ban.unit.split(" ") : [];
+	return {
+		id,
+		members,
+		props: new Set([...members].flatMap((m) => PROPS[m] ? [PROPS[m]] : [])),
+		kw: new Map(Object.entries(g.ban.kw).map(([p, ws]) => [p, words(ws)])),
+		fn: new Set((g.ban.fn ? g.ban.fn.split(" ") : []).map((f) => `${f}(`)),
+		unit: units.length ? new RegExp(`^[0-9]+(?:e[0-9]+)?(?:${units.toSorted((a, b) => b.length - a.length).join("|")})$`) : void 0,
+		query: {
+			media: words(g.ban.media),
+			container: words(g.ban.container),
+			supports: words(g.ban.supports)
+		}
+	};
+};
+const hit = (c, own, text) => text.match(WORDS)?.find((w) => own?.has(w) || c.fn.has(w) || c.unit?.test(w));
+const said = (w) => w.endsWith("(") ? `${w.slice(0, -1)}()` : w;
+const refuse = (c, label, w) => fail(`cssints: ${label}: "${said(w)}" is not in cssints/${c.id}`);
+const guard = (c, n) => {
+	for (const [prop, value, , fallbacks] of n.__cssints) {
+		const own = c.kw.get(prop);
+		for (const v of fallbacks ? [value, ...fallbacks] : [value]) {
+			const w = hit(c, own, v);
+			if (w) throw refuse(c, prop, w);
+		}
+	}
+	return n;
+};
+const chained = (c, n) => new Proxy(n, { get: (t, k) => {
+	const v = Reflect.get(t, k);
+	if (typeof k !== "string" || k in t || typeof v !== "function") return v;
+	return (...args) => {
+		const next = guard(c, v(...args));
+		const prop = next.__cssints.at(-1)?.[0];
+		if (prop && !c.props.has(prop)) throw fail(`cssints: ${prop} is not in cssints/${c.id} (.${k}())`);
+		return chained(c, next);
+	};
+} });
+const texts = (q) => typeof q === "string" ? [q] : q && typeof q === "object" ? Object.values(q).flatMap(texts) : [];
+const wrap = (c, name, member) => {
+	const fn = member;
+	if (CONDITIONS.includes(name)) return (...qs) => {
+		const kind = name;
+		for (const q of qs.flatMap(texts)) {
+			const w = hit(c, c.query[kind], q);
+			if (w) throw refuse(c, `@${kind}`, w);
+		}
+		return fn(...qs);
+	};
+	if (!(name in PROPS) || typeof member !== "function") return member;
+	return (...args) => {
+		const made = fn(...args);
+		if (!isNode(made)) return made;
+		return name in CONTEXTS ? chained(c, guard(c, made)) : guard(c, made);
+	};
+};
+/**
+* The members of an export group.
+* @param {Record<string, unknown>} css `css` of macro.ts, passed in so that this file imports no engine module
+* @param {string} id the group: `widely-available`, `css-grid-2`, ...
+* @returns {Record<string, unknown>} `css` with the members of the group, as they are, and the ones it has not throwing, naming the group, when called
+*/
+const groupOf = (css, id) => {
+	if (id === "limited-availability") return css;
+	const c = compiled$1.get(id) ?? compiled$1.set(id, compile$1(id)).get(id);
+	return new Proxy(css, { get: (t, k) => {
+		if (typeof k !== "string") return Reflect.get(t, k);
+		if (TIED.has(k) && !c.members.has(k)) return () => {
+			throw fail(`cssints: ${k} is not in cssints/${id}`);
+		};
+		return wrap(c, k, t[k]);
+	} });
+};
+//#endregion
 //#region src/scope-engine.ts
 const NAME$1 = /^[a-z][a-z0-9-]*$/;
 const KEY = /^[A-Za-z][\w-]*$/;
@@ -131,7 +227,7 @@ const check = (plugin, label, grammar, value) => {
 };
 const valueOf = (plugin, label, args, spacing = false) => {
 	if (!args.length) throw failIn(plugin, `cssints: ${label}() expects a value`);
-	if (args.some(isNode)) throw failIn(plugin, `cssints: ${label}() takes values, not styles; merge styles with cn(...) or cx(...)`);
+	if (args.some(isNode)) throw failIn(plugin, `cssints: ${label}() takes values, not styles; merge styles with cn(...)`);
 	const [only] = args;
 	return spacing && args.length === 1 && typeof only === "number" ? `${only * .25}rem` : args.join(" ");
 };
@@ -544,7 +640,11 @@ const engine = {
 };
 //#endregion
 //#region src/runtime.ts
-const cx = (...a) => a.flat(Infinity).filter(Boolean).join(" ");
+function _cx(drops, ...a) {
+	const on = a.flat(Infinity).filter(Boolean).join(" ").split(" ");
+	const gone = drops.flatMap(([by, c]) => on.includes(by) ? c.split(" ") : []);
+	return on.filter((c) => c && !gone.includes(c)).join(" ");
+}
 function _cv(config) {
 	return (props = {}) => {
 		const out = [config.base];
@@ -634,9 +734,9 @@ const keyframes = (steps) => {
 };
 const positionTryProp = member("positionTry");
 const positionTry = (...args) => args.length === 1 && isNode(args[0]) ? atRule("position-try", "--pt-", blockOf("positionTry()", args[0], POSITION_TRY)) : positionTryProp(...args);
-const cn = (...args) => {
-	const decls = toDecls("cn", args);
-	return node(decls, carried(args));
+const cn = (...all) => {
+	const args = all.filter(Boolean);
+	return node(toDecls("cn", args), carried(args));
 };
 const flex = member("flex");
 const grid = member("grid");
@@ -1018,6 +1118,37 @@ const cv = (config) => {
 	};
 	return Object.assign((props) => (built[0] ??= build())(props), { __cv: config });
 };
+const isGroup = (v) => Predicate.hasProperty(v, "__cnGroup");
+const headOf = Effect.fnUntraced(function* ({ __cnGroup: { statics, parts } }, at) {
+	const { nodes } = yield* Registry;
+	const merged = cn(...statics.map(([, s]) => s));
+	const where = /* @__PURE__ */ new Map();
+	for (const [pos, s] of statics) if (isNode(s)) for (const d of s.__cssints) where.set(d, pos);
+	const all = nodes.get(at.file) ?? nodes.set(at.file, /* @__PURE__ */ new Map()).get(at.file);
+	all.set(at.site, merged.__cssints);
+	const drops = yield* Effect.try({
+		try: () => dropsOf([...merged.__cssints.map((decl) => ({
+			at: where.get(decl),
+			decl,
+			conditional: false
+		})), ...parts.flatMap(([pos, site]) => (all.get(site) ?? []).map((decl) => ({
+			at: pos,
+			decl,
+			conditional: true
+		})))]),
+		catch: (e) => {
+			if (e instanceof MacroError) return e;
+			throw e;
+		}
+	});
+	const classes = yield* classesOf(merged, at);
+	return `${CX_CALL}${Formatter.formatJson(drops)}, ${classes ? `${Formatter.formatJson(classes)}, ` : ""}`;
+});
+const __cnGroup = (statics, parts) => ({ __cnGroup: {
+	statics,
+	parts
+} });
+const __nocn = () => void 0;
 const named = {
 	cn,
 	firstThatWorks,
@@ -1044,6 +1175,7 @@ const named = {
 };
 const css = new Proxy(named, { get: (t, k) => Object.hasOwn(t, k) ? t[k] : member(String(k)) });
 named.css = css;
+const __group = (id) => groupOf(css, id);
 const kernelCss = new Proxy({
 	...named,
 	nest,
@@ -1078,6 +1210,7 @@ const isPluginValue = Predicate.isObjectKeyword;
 const replacementOf = Effect.fnUntraced(function* (at, value) {
 	if (isNode(value)) return Formatter.formatJson(yield* classesOf(value, at));
 	if (isCv(value)) return `${CV_CALL}${yield* cvOf(value.__cv, at)})`;
+	if (isGroup(value)) return yield* headOf(value, at);
 	if (isStyle(value)) return yield* inlineOf(value);
 	const tokens = tokensOf(value);
 	if (tokens !== void 0) return tokens;
@@ -1100,6 +1233,10 @@ const recordSite = Effect.fnUntraced(function* (at, value) {
 	const { sites } = yield* Registry;
 	const replacement = yield* replacementOf(at, value).pipe(Effect.mapError(located(at)));
 	if (replacement === void 0) return value;
+	if (isNode(value)) {
+		const { nodes } = yield* Registry;
+		(nodes.get(at.file) ?? nodes.set(at.file, /* @__PURE__ */ new Map()).get(at.file)).set(at.site, value.__cssints);
+	}
 	if (!sites.has(at.file)) sites.set(at.file, /* @__PURE__ */ new Map());
 	sites.get(at.file).set(at.site, replacement);
 	return value;
@@ -1129,4 +1266,4 @@ function __site(at, value) {
 	return exit.value;
 }
 //#endregion
-export { CSS, CSSAtRuleValue, CSSColorValue, CSSImageValue, CSSStyleValue, CSSUnitValue, __at, __site, __unseen, cn, css, cv, cx, firstThatWorks, flex, grid, keyframes, positionTry };
+export { CSS, CSSAtRuleValue, CSSColorValue, CSSImageValue, CSSStyleValue, CSSUnitValue, __at, __cnGroup, __group, __nocn, __site, __unseen, _cv, _cx, cn, css, cv, firstThatWorks, flex, grid, keyframes, positionTry };