@gtkx/css 1.0.0 → 1.2.0

package/README.md

@@ -161,7 +161,7 @@ Explore the [example apps](https://github.com/gtkx-org/gtkx/tree/main/examples):
 
 ## Status
 
-GTKX 1.0 is released.
+GTKX is stable and ready for production use.
 
 ## Contributing
 

package/dist/create-css.d.ts

@@ -1,8 +1,7 @@
 import type { CSSInterpolation } from "@emotion/serialize";
-import type { Element } from "stylis";
 /** A `cx` argument: a non-empty class name, or a boolean or nullish value that is dropped. */
 type CxToken = string | boolean | undefined | null;
-/** The `css`, `cx` and `injectGlobal` trio bound to one GTK4 stylesheet and its cache of inserted styles. */
+/** The `css`, `cx` and `injectGlobal` helpers bound to one GTK4 stylesheet and its cache of inserted styles. */
 type Css = {
     /**
      * Serializes the given style interpolations, inserts the resulting rules into the stylesheet, and
@@ -17,7 +16,6 @@ type Css = {
     /** Serializes and inserts the given styles into the stylesheet globally, unscoped by any class. */
     injectGlobal: (...args: CSSInterpolation[]) => void;
 };
-declare const removeLabel: (element: Element) => void;
 declare const createCss: () => Css;
-export { removeLabel, createCss, type Css };
+export { createCss, type Css };
 //# sourceMappingURL=create-css.d.ts.map

package/dist/create-css.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-css.d.ts","sourceRoot":"","sources":["../src/create-css.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAqC,MAAM,oBAAoB,CAAC;AAC9F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAMtC,8FAA8F;AAC9F,KAAK,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC;AAEnD,6GAA6G;AAC7G,KAAK,GAAG,GAAG;IACP;;;OAGG;IACH,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,gBAAgB,EAAE,KAAK,MAAM,CAAC;IAC7C;;;OAGG;IACH,EAAE,EAAE,CAAC,GAAG,UAAU,EAAE,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3C,mGAAmG;IACnG,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,gBAAgB,EAAE,KAAK,IAAI,CAAC;CACvD,CAAC;AASF,QAAA,MAAM,WAAW,GAAI,SAAS,OAAO,KAAG,IASvC,CAAC;AAiFF,QAAA,MAAM,SAAS,QAAO,GAUrB,CAAC;AAEF,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,GAAG,EAAE,CAAC"}
+{"version":3,"file":"create-css.d.ts","sourceRoot":"","sources":["../src/create-css.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAqC,MAAM,oBAAoB,CAAC;AAO9F,8FAA8F;AAC9F,KAAK,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC;AAEnD,gHAAgH;AAChH,KAAK,GAAG,GAAG;IACP;;;OAGG;IACH,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,gBAAgB,EAAE,KAAK,MAAM,CAAC;IAC7C;;;OAGG;IACH,EAAE,EAAE,CAAC,GAAG,UAAU,EAAE,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3C,mGAAmG;IACnG,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,gBAAgB,EAAE,KAAK,IAAI,CAAC;CACvD,CAAC;AA+GF,QAAA,MAAM,SAAS,QAAO,GAUrB,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,KAAK,GAAG,EAAE,CAAC"}

package/dist/create-css.js

@@ -15,6 +15,13 @@ const removeLabel = (element) => {
     element.value = "";
 };
 const getClassName = (serialized) => `${KEY}-${serialized.name}`;
+const terminateDeclarations = (styles) => {
+    const trimmed = styles.trimEnd();
+    if (trimmed.length === 0 || trimmed.endsWith(";") || trimmed.endsWith("}")) {
+        return trimmed;
+    }
+    return `${trimmed};`;
+};
 const isNonEmptyString = (token) => typeof token === "string" && token.length > 0;
 const partitionTokens = (tokens, registered) => {
     const rawClasses = [];
@@ -51,8 +58,9 @@ const insertStyles = (state, serialized) => {
         return;
     }
     const className = getClassName(serialized);
-    runStylis(state.sheet, `.${className}{${serialized.styles}}`);
-    state.registered[className] = serialized.styles;
+    const styles = terminateDeclarations(serialized.styles);
+    runStylis(state.sheet, `.${className}{${styles}}`);
+    state.registered[className] = styles;
 };
 const insertWithoutScoping = (state, serialized) => {
     if (!didMarkNewStyle(state, serialized)) {
@@ -83,5 +91,5 @@ const createCss = () => {
         },
     };
 };
-export { removeLabel, createCss };
+export { createCss };
 //# sourceMappingURL=create-css.js.map

package/dist/create-css.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-css.js","sourceRoot":"","sources":["../src/create-css.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CSSInterpolation, RegisteredCache, SerializedStyles } from \"@emotion/serialize\";\nimport type { Element } from \"stylis\";\nimport { serializeStyles } from \"@emotion/serialize\";\nimport { compile, middleware, rulesheet, stringify, serialize as stylisSerialize } from \"stylis\";\nimport { escapeNamedColors, restoreNamedColors } from \"./named-colors.js\";\nimport { StyleSheet } from \"./stylesheet.js\";\n\n/** A `cx` argument: a non-empty class name, or a boolean or nullish value that is dropped. */\ntype CxToken = string | boolean | undefined | null;\n\n/** The `css`, `cx` and `injectGlobal` trio bound to one GTK4 stylesheet and its cache of inserted styles. */\ntype Css = {\n    /**\n     * Serializes the given style interpolations, inserts the resulting rules into the stylesheet, and\n     * returns the generated GTK4 CSS class name.\n     */\n    css: (...args: CSSInterpolation[]) => string;\n    /**\n     * Filters out falsy tokens and returns the remaining class names, collapsing two or more\n     * GTKX-generated classes into one merged class where later styles win.\n     */\n    cx: (...classNames: CxToken[]) => string[];\n    /** Serializes and inserts the given styles into the stylesheet globally, unscoped by any class. */\n    injectGlobal: (...args: CSSInterpolation[]) => void;\n};\n\ntype TokenPartition = { rawClasses: string[]; registeredStyles: string[] };\ntype CssState = { sheet: StyleSheet; inserted: Set<string>; registered: RegisteredCache };\n\nconst KEY = \"gtkx\";\nconst LABEL_DECL_FIRST_CHAR = 108;\nconst LABEL_DECL_THIRD_CHAR = 98;\n\nconst removeLabel = (element: Element): void => {\n    if (!(element.type === \"decl\" &&\n        element.value.codePointAt(0) === LABEL_DECL_FIRST_CHAR &&\n        element.value.codePointAt(2) === LABEL_DECL_THIRD_CHAR)) {\n        return;\n    }\n\n    element.return = \"\";\n    element.value = \"\";\n};\n\nconst getClassName = (serialized: SerializedStyles): string => `${KEY}-${serialized.name}`;\nconst isNonEmptyString = (token: CxToken): token is string => typeof token === \"string\" && token.length > 0;\n\nconst partitionTokens = (tokens: string[], registered: RegisteredCache): TokenPartition => {\n    const rawClasses: string[] = [];\n    const registeredStyles: string[] = [];\n\n    for (const token of tokens) {\n        const styles = registered[token];\n\n        if (styles === undefined) {\n            rawClasses.push(token);\n        } else {\n            registeredStyles.push(styles);\n        }\n    }\n\n    return { rawClasses, registeredStyles };\n};\n\nconst runStylis = (sheet: StyleSheet, input: string): void => {\n    stylisSerialize(\n        compile(escapeNamedColors(input)),\n        middleware([\n            removeLabel,\n            stringify,\n            rulesheet((rule) => {\n                sheet.insert(restoreNamedColors(rule));\n            }),\n        ]),\n    );\n};\n\nconst didMarkNewStyle = (state: CssState, serialized: SerializedStyles): boolean => {\n    if (state.inserted.has(serialized.name)) {\n        return false;\n    }\n\n    state.inserted.add(serialized.name);\n\n    return true;\n};\n\nconst insertStyles = (state: CssState, serialized: SerializedStyles): void => {\n    if (!didMarkNewStyle(state, serialized)) {\n        return;\n    }\n\n    const className = getClassName(serialized);\n    runStylis(state.sheet, `.${className}{${serialized.styles}}`);\n    state.registered[className] = serialized.styles;\n};\n\nconst insertWithoutScoping = (state: CssState, serialized: SerializedStyles): void => {\n    if (!didMarkNewStyle(state, serialized)) {\n        return;\n    }\n\n    runStylis(state.sheet, serialized.styles);\n};\n\nconst cssClassName = (state: CssState, args: CSSInterpolation[]): string => {\n    const serialized = serializeStyles(args, state.registered);\n    insertStyles(state, serialized);\n\n    return getClassName(serialized);\n};\n\nconst cxClassNames = (state: CssState, classNames: CxToken[]): string[] => {\n    const tokens = classNames.filter(isNonEmptyString);\n    const { rawClasses, registeredStyles } = partitionTokens(tokens, state.registered);\n\n    if (registeredStyles.length < 2) {\n        return tokens;\n    }\n\n    return [...rawClasses, cssClassName(state, [registeredStyles.join(\"\")])];\n};\n\nconst createCss = (): Css => {\n    const state: CssState = { sheet: new StyleSheet(), inserted: new Set(), registered: {} };\n\n    return {\n        css: (...args) => cssClassName(state, args),\n        cx: (...classNames) => cxClassNames(state, classNames),\n        injectGlobal: (...args) => {\n            insertWithoutScoping(state, serializeStyles(args, state.registered));\n        },\n    };\n};\n\nexport { removeLabel, createCss, type Css };\n"]}
+{"version":3,"file":"create-css.js","sourceRoot":"","sources":["../src/create-css.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CSSInterpolation, RegisteredCache, SerializedStyles } from \"@emotion/serialize\";\nimport type { Element } from \"stylis\";\nimport { serializeStyles } from \"@emotion/serialize\";\nimport { compile, middleware, rulesheet, stringify, serialize as stylisSerialize } from \"stylis\";\nimport { escapeNamedColors, restoreNamedColors } from \"./named-colors.js\";\nimport { StyleSheet } from \"./stylesheet.js\";\n\n/** A `cx` argument: a non-empty class name, or a boolean or nullish value that is dropped. */\ntype CxToken = string | boolean | undefined | null;\n\n/** The `css`, `cx` and `injectGlobal` helpers bound to one GTK4 stylesheet and its cache of inserted styles. */\ntype Css = {\n    /**\n     * Serializes the given style interpolations, inserts the resulting rules into the stylesheet, and\n     * returns the generated GTK4 CSS class name.\n     */\n    css: (...args: CSSInterpolation[]) => string;\n    /**\n     * Filters out falsy tokens and returns the remaining class names, collapsing two or more\n     * GTKX-generated classes into one merged class where later styles win.\n     */\n    cx: (...classNames: CxToken[]) => string[];\n    /** Serializes and inserts the given styles into the stylesheet globally, unscoped by any class. */\n    injectGlobal: (...args: CSSInterpolation[]) => void;\n};\n\ntype TokenPartition = { rawClasses: string[]; registeredStyles: string[] };\ntype CssState = { sheet: StyleSheet; inserted: Set<string>; registered: RegisteredCache };\n\nconst KEY = \"gtkx\";\nconst LABEL_DECL_FIRST_CHAR = 108;\nconst LABEL_DECL_THIRD_CHAR = 98;\n\nconst removeLabel = (element: Element): void => {\n    if (!(element.type === \"decl\" &&\n        element.value.codePointAt(0) === LABEL_DECL_FIRST_CHAR &&\n        element.value.codePointAt(2) === LABEL_DECL_THIRD_CHAR)) {\n        return;\n    }\n\n    element.return = \"\";\n    element.value = \"\";\n};\n\nconst getClassName = (serialized: SerializedStyles): string => `${KEY}-${serialized.name}`;\n\nconst terminateDeclarations = (styles: string): string => {\n    const trimmed = styles.trimEnd();\n\n    if (trimmed.length === 0 || trimmed.endsWith(\";\") || trimmed.endsWith(\"}\")) {\n        return trimmed;\n    }\n\n    return `${trimmed};`;\n};\n\nconst isNonEmptyString = (token: CxToken): token is string => typeof token === \"string\" && token.length > 0;\n\nconst partitionTokens = (tokens: string[], registered: RegisteredCache): TokenPartition => {\n    const rawClasses: string[] = [];\n    const registeredStyles: string[] = [];\n\n    for (const token of tokens) {\n        const styles = registered[token];\n\n        if (styles === undefined) {\n            rawClasses.push(token);\n        } else {\n            registeredStyles.push(styles);\n        }\n    }\n\n    return { rawClasses, registeredStyles };\n};\n\nconst runStylis = (sheet: StyleSheet, input: string): void => {\n    stylisSerialize(\n        compile(escapeNamedColors(input)),\n        middleware([\n            removeLabel,\n            stringify,\n            rulesheet((rule) => {\n                sheet.insert(restoreNamedColors(rule));\n            }),\n        ]),\n    );\n};\n\nconst didMarkNewStyle = (state: CssState, serialized: SerializedStyles): boolean => {\n    if (state.inserted.has(serialized.name)) {\n        return false;\n    }\n\n    state.inserted.add(serialized.name);\n\n    return true;\n};\n\nconst insertStyles = (state: CssState, serialized: SerializedStyles): void => {\n    if (!didMarkNewStyle(state, serialized)) {\n        return;\n    }\n\n    const className = getClassName(serialized);\n    const styles = terminateDeclarations(serialized.styles);\n    runStylis(state.sheet, `.${className}{${styles}}`);\n    state.registered[className] = styles;\n};\n\nconst insertWithoutScoping = (state: CssState, serialized: SerializedStyles): void => {\n    if (!didMarkNewStyle(state, serialized)) {\n        return;\n    }\n\n    runStylis(state.sheet, serialized.styles);\n};\n\nconst cssClassName = (state: CssState, args: CSSInterpolation[]): string => {\n    const serialized = serializeStyles(args, state.registered);\n    insertStyles(state, serialized);\n\n    return getClassName(serialized);\n};\n\nconst cxClassNames = (state: CssState, classNames: CxToken[]): string[] => {\n    const tokens = classNames.filter(isNonEmptyString);\n    const { rawClasses, registeredStyles } = partitionTokens(tokens, state.registered);\n\n    if (registeredStyles.length < 2) {\n        return tokens;\n    }\n\n    return [...rawClasses, cssClassName(state, [registeredStyles.join(\"\")])];\n};\n\nconst createCss = (): Css => {\n    const state: CssState = { sheet: new StyleSheet(), inserted: new Set(), registered: {} };\n\n    return {\n        css: (...args) => cssClassName(state, args),\n        cx: (...classNames) => cxClassNames(state, classNames),\n        injectGlobal: (...args) => {\n            insertWithoutScoping(state, serializeStyles(args, state.registered));\n        },\n    };\n};\n\nexport { createCss, type Css };\n"]}

package/dist/named-colors.d.ts

@@ -1,6 +1,4 @@
-declare const AT_RULE_KEYWORDS: Set<string>;
-declare const NAMED_COLOR_TOKEN = "gtkx-named-color__";
 declare const escapeNamedColors: (input: string) => string;
 declare const restoreNamedColors: (rule: string) => string;
-export { AT_RULE_KEYWORDS, NAMED_COLOR_TOKEN, escapeNamedColors, restoreNamedColors };
+export { escapeNamedColors, restoreNamedColors };
 //# sourceMappingURL=named-colors.d.ts.map

package/dist/named-colors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"named-colors.d.ts","sourceRoot":"","sources":["../src/named-colors.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAA6D,CAAC;AAEhG,QAAA,MAAM,iBAAiB,uBAAuB,CAAC;AAG/C,QAAA,MAAM,iBAAiB,GAAI,OAAO,MAAM,KAAG,MAGtC,CAAC;AAEN,QAAA,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,MAA2D,CAAC;AAEvG,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"named-colors.d.ts","sourceRoot":"","sources":["../src/named-colors.ts"],"names":[],"mappings":"AAKA,QAAA,MAAM,iBAAiB,GAAI,OAAO,MAAM,KAAG,MAGtC,CAAC;AAEN,QAAA,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,MAA2D,CAAC;AAEvG,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/named-colors.js

@@ -4,5 +4,5 @@ const NAMED_COLOR_TOKEN = "gtkx-named-color__";
 const NAMED_COLOR_TOKEN_PATTERN = new RegExp(String.raw `${NAMED_COLOR_TOKEN}([\w-]+)`, "g");
 const escapeNamedColors = (input) => input.replaceAll(AT_IDENTIFIER_PATTERN, (match, name) => AT_RULE_KEYWORDS.has(name) ? match : `${NAMED_COLOR_TOKEN}${name}`);
 const restoreNamedColors = (rule) => rule.replaceAll(NAMED_COLOR_TOKEN_PATTERN, "@$1");
-export { AT_RULE_KEYWORDS, NAMED_COLOR_TOKEN, escapeNamedColors, restoreNamedColors };
+export { escapeNamedColors, restoreNamedColors };
 //# sourceMappingURL=named-colors.js.map

package/dist/named-colors.js.map

@@ -1 +1 @@
-{"version":3,"file":"named-colors.js","sourceRoot":"","sources":["../src/named-colors.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAgB,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;AAChG,MAAM,qBAAqB,GAAG,qBAAqB,CAAC;AACpD,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AAC/C,MAAM,yBAAyB,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAA,GAAG,iBAAiB,UAAU,EAAE,GAAG,CAAC,CAAC;AAE5F,MAAM,iBAAiB,GAAG,CAAC,KAAa,EAAU,EAAE,CAChD,KAAK,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE,CAC5D,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,iBAAiB,GAAG,IAAI,EAAE,CACrE,CAAC;AAEN,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;AAEvG,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,CAAC","sourcesContent":["const AT_RULE_KEYWORDS: Set<string> = new Set([\"define-color\", \"import\", \"keyframes\", \"media\"]);\nconst AT_IDENTIFIER_PATTERN = /@([A-Za-z_][\\w-]*)/g;\nconst NAMED_COLOR_TOKEN = \"gtkx-named-color__\";\nconst NAMED_COLOR_TOKEN_PATTERN = new RegExp(String.raw`${NAMED_COLOR_TOKEN}([\\w-]+)`, \"g\");\n\nconst escapeNamedColors = (input: string): string =>\n    input.replaceAll(AT_IDENTIFIER_PATTERN, (match, name: string) =>\n        AT_RULE_KEYWORDS.has(name) ? match : `${NAMED_COLOR_TOKEN}${name}`,\n    );\n\nconst restoreNamedColors = (rule: string): string => rule.replaceAll(NAMED_COLOR_TOKEN_PATTERN, \"@$1\");\n\nexport { AT_RULE_KEYWORDS, NAMED_COLOR_TOKEN, escapeNamedColors, restoreNamedColors };\n"]}
+{"version":3,"file":"named-colors.js","sourceRoot":"","sources":["../src/named-colors.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAgB,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;AAChG,MAAM,qBAAqB,GAAG,qBAAqB,CAAC;AACpD,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AAC/C,MAAM,yBAAyB,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAA,GAAG,iBAAiB,UAAU,EAAE,GAAG,CAAC,CAAC;AAE5F,MAAM,iBAAiB,GAAG,CAAC,KAAa,EAAU,EAAE,CAChD,KAAK,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE,CAC5D,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,iBAAiB,GAAG,IAAI,EAAE,CACrE,CAAC;AAEN,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;AAEvG,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,CAAC","sourcesContent":["const AT_RULE_KEYWORDS: Set<string> = new Set([\"define-color\", \"import\", \"keyframes\", \"media\"]);\nconst AT_IDENTIFIER_PATTERN = /@([A-Za-z_][\\w-]*)/g;\nconst NAMED_COLOR_TOKEN = \"gtkx-named-color__\";\nconst NAMED_COLOR_TOKEN_PATTERN = new RegExp(String.raw`${NAMED_COLOR_TOKEN}([\\w-]+)`, \"g\");\n\nconst escapeNamedColors = (input: string): string =>\n    input.replaceAll(AT_IDENTIFIER_PATTERN, (match, name: string) =>\n        AT_RULE_KEYWORDS.has(name) ? match : `${NAMED_COLOR_TOKEN}${name}`,\n    );\n\nconst restoreNamedColors = (rule: string): string => rule.replaceAll(NAMED_COLOR_TOKEN_PATTERN, \"@$1\");\n\nexport { escapeNamedColors, restoreNamedColors };\n"]}

package/dist/self-contained.d.ts

@@ -0,0 +1,3 @@
+declare const containmentFailure: (rule: string) => string | null;
+export { containmentFailure };
+//# sourceMappingURL=self-contained.d.ts.map

package/dist/self-contained.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-contained.d.ts","sourceRoot":"","sources":["../src/self-contained.ts"],"names":[],"mappings":"AA6CA,QAAA,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,IAQnD,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/self-contained.js

@@ -0,0 +1,39 @@
+import { CssProvider } from "@gtkx/gi/gtk";
+import { randomBytes } from "node:crypto";
+import { brokenToken } from "./tokens.js";
+const PROBE_BYTES = 16;
+const PROBE_RULE = `.gtkx-probe-${randomBytes(PROBE_BYTES).toString("hex")}{color:rgb(0, 0, 0);}`;
+const SWALLOWS_WHAT_FOLLOWS = "would disable every rule after it";
+const gate = { provider: null, ruleset: null };
+const ignoreParsingError = () => undefined;
+const createQuietProvider = () => {
+    const provider = new CssProvider();
+    provider.on("parsing-error", ignoreParsingError);
+    return provider;
+};
+const quiet = () => {
+    gate.provider ??= createQuietProvider();
+    return gate.provider;
+};
+const parsed = (document) => {
+    const provider = quiet();
+    provider.loadFromString(document);
+    return provider.toString();
+};
+const probe = () => {
+    gate.ruleset ??= parsed(PROBE_RULE);
+    return gate.ruleset;
+};
+const hasProbe = (serialized) => {
+    const ruleset = probe();
+    return ruleset.length > 0 && `\n${serialized}`.includes(`\n${ruleset}`);
+};
+const containmentFailure = (rule) => {
+    const broken = brokenToken(rule);
+    if (broken !== null) {
+        return broken;
+    }
+    return hasProbe(parsed(`${rule}\n${PROBE_RULE}`)) ? null : SWALLOWS_WHAT_FOLLOWS;
+};
+export { containmentFailure };
+//# sourceMappingURL=self-contained.js.map

package/dist/self-contained.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-contained.js","sourceRoot":"","sources":["../src/self-contained.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,MAAM,WAAW,GAAG,EAAE,CAAC;AACvB,MAAM,UAAU,GAAG,eAAe,WAAW,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,uBAAuB,CAAC;AAClG,MAAM,qBAAqB,GAAG,mCAAmC,CAAC;AAClE,MAAM,IAAI,GAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAErD,MAAM,kBAAkB,GAAG,GAAc,EAAE,CAAC,SAAS,CAAC;AAEtD,MAAM,mBAAmB,GAAG,GAAgB,EAAE;IAC1C,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC;IAEjD,OAAO,QAAQ,CAAC;AACpB,CAAC,CAAC;AAEF,MAAM,KAAK,GAAG,GAAgB,EAAE;IAC5B,IAAI,CAAC,QAAQ,KAAK,mBAAmB,EAAE,CAAC;IAExC,OAAO,IAAI,CAAC,QAAQ,CAAC;AACzB,CAAC,CAAC;AAEF,MAAM,MAAM,GAAG,CAAC,QAAgB,EAAU,EAAE;IACxC,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC;IACzB,QAAQ,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAElC,OAAO,QAAQ,CAAC,QAAQ,EAAE,CAAC;AAC/B,CAAC,CAAC;AAEF,MAAM,KAAK,GAAG,GAAW,EAAE;IACvB,IAAI,CAAC,OAAO,KAAK,MAAM,CAAC,UAAU,CAAC,CAAC;IAEpC,OAAO,IAAI,CAAC,OAAO,CAAC;AACxB,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,UAAkB,EAAW,EAAE;IAC7C,MAAM,OAAO,GAAG,KAAK,EAAE,CAAC;IAExB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC,QAAQ,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;AAC5E,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAiB,EAAE;IACvD,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAEjC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,KAAK,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,qBAAqB,CAAC;AACrF,CAAC,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,CAAC","sourcesContent":["import { CssProvider } from \"@gtkx/gi/gtk\";\nimport { randomBytes } from \"node:crypto\";\nimport { brokenToken } from \"./tokens.js\";\n\ntype Gate = { provider: CssProvider | null; ruleset: string | null };\n\nconst PROBE_BYTES = 16;\nconst PROBE_RULE = `.gtkx-probe-${randomBytes(PROBE_BYTES).toString(\"hex\")}{color:rgb(0, 0, 0);}`;\nconst SWALLOWS_WHAT_FOLLOWS = \"would disable every rule after it\";\nconst gate: Gate = { provider: null, ruleset: null };\n\nconst ignoreParsingError = (): undefined => undefined;\n\nconst createQuietProvider = (): CssProvider => {\n    const provider = new CssProvider();\n    provider.on(\"parsing-error\", ignoreParsingError);\n\n    return provider;\n};\n\nconst quiet = (): CssProvider => {\n    gate.provider ??= createQuietProvider();\n\n    return gate.provider;\n};\n\nconst parsed = (document: string): string => {\n    const provider = quiet();\n    provider.loadFromString(document);\n\n    return provider.toString();\n};\n\nconst probe = (): string => {\n    gate.ruleset ??= parsed(PROBE_RULE);\n\n    return gate.ruleset;\n};\n\nconst hasProbe = (serialized: string): boolean => {\n    const ruleset = probe();\n\n    return ruleset.length > 0 && `\\n${serialized}`.includes(`\\n${ruleset}`);\n};\n\nconst containmentFailure = (rule: string): string | null => {\n    const broken = brokenToken(rule);\n\n    if (broken !== null) {\n        return broken;\n    }\n\n    return hasProbe(parsed(`${rule}\\n${PROBE_RULE}`)) ? null : SWALLOWS_WHAT_FOLLOWS;\n};\n\nexport { containmentFailure };\n"]}

package/dist/stylesheet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stylesheet.d.ts","sourceRoot":"","sources":["../src/stylesheet.ts"],"names":[],"mappings":"AAMA,cAAM,UAAU;IACZ,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,cAAc;IAatB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAI7B;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"stylesheet.d.ts","sourceRoot":"","sources":["../src/stylesheet.ts"],"names":[],"mappings":"AAcA,cAAM,UAAU;IACZ,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,cAAc;IAatB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAY7B;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/stylesheet.js

@@ -1,6 +1,11 @@
 import { createLogger } from "@gtkx/utils";
 import { attachParsingErrorLogger, registerProviderForDefaultDisplay } from "./provider.js";
+import { containmentFailure } from "./self-contained.js";
 const log = createLogger("css");
+const NUL = "\u{0}";
+const NUL_REASON = "carries a NUL byte, which GTK4 cannot load";
+const unusableReason = (rule) => rule.includes(NUL) ? NUL_REASON : containmentFailure(rule);
+const printableRule = (rule) => rule.replaceAll(NUL, String.raw `\0`);
 class StyleSheet {
     css = "";
     provider = null;
@@ -25,6 +30,11 @@ class StyleSheet {
         });
     }
     insert(rule) {
+        const reason = unusableReason(rule);
+        if (reason !== null) {
+            log.warn(`Dropped a malformed CSS rule that ${reason}: ${printableRule(rule)}`);
+            return;
+        }
         this.css += this.css.length > 0 ? `\n${rule}` : rule;
         this.scheduleUpdate();
     }

package/dist/stylesheet.js.map

@@ -1 +1 @@
-{"version":3,"file":"stylesheet.js","sourceRoot":"","sources":["../src/stylesheet.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,iCAAiC,EAAE,MAAM,eAAe,CAAC;AAE5F,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;AAEhC,MAAM,UAAU;IACJ,GAAG,GAAG,EAAE,CAAC;IACT,QAAQ,GAA2B,IAAI,CAAC;IACxC,eAAe,GAAG,KAAK,CAAC;IAExB,cAAc;QAClB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,QAAQ,CAAC;QACzB,CAAC;QAED,MAAM,QAAQ,GAAG,iCAAiC,EAAE,CAAC;QACrD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,wBAAwB,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QAE/C,OAAO,QAAQ,CAAC;IACpB,CAAC;IAEO,cAAc;QAClB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,OAAO;QACX,CAAC;QAED,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAE5B,cAAc,CAAC,GAAG,EAAE;YAChB,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;YAC7B,IAAI,CAAC,cAAc,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;IACP,CAAC;IAED,MAAM,CAAC,IAAY;QACf,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACrD,IAAI,CAAC,cAAc,EAAE,CAAC;IAC1B,CAAC;CACJ;AAED,OAAO,EAAE,UAAU,EAAE,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { createLogger } from \"@gtkx/utils\";\nimport { attachParsingErrorLogger, registerProviderForDefaultDisplay } from \"./provider.js\";\n\nconst log = createLogger(\"css\");\n\nclass StyleSheet {\n    private css = \"\";\n    private provider: Gtk.CssProvider | null = null;\n    private updateScheduled = false;\n\n    private ensureProvider(): Gtk.CssProvider {\n        if (this.provider) {\n            return this.provider;\n        }\n\n        const provider = registerProviderForDefaultDisplay();\n        this.provider = provider;\n        attachParsingErrorLogger(provider, log, \"CSS\");\n\n        return provider;\n    }\n\n    private scheduleUpdate(): void {\n        if (this.updateScheduled) {\n            return;\n        }\n\n        this.updateScheduled = true;\n\n        queueMicrotask(() => {\n            this.updateScheduled = false;\n            this.ensureProvider().loadFromString(this.css);\n        });\n    }\n\n    insert(rule: string): void {\n        this.css += this.css.length > 0 ? `\\n${rule}` : rule;\n        this.scheduleUpdate();\n    }\n}\n\nexport { StyleSheet };\n"]}
+{"version":3,"file":"stylesheet.js","sourceRoot":"","sources":["../src/stylesheet.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,iCAAiC,EAAE,MAAM,eAAe,CAAC;AAC5F,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;AAChC,MAAM,GAAG,GAAG,OAAO,CAAC;AACpB,MAAM,UAAU,GAAG,4CAA4C,CAAC;AAEhE,MAAM,cAAc,GAAG,CAAC,IAAY,EAAiB,EAAE,CACnD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAE/D,MAAM,aAAa,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAA,IAAI,CAAC,CAAC;AAErF,MAAM,UAAU;IACJ,GAAG,GAAG,EAAE,CAAC;IACT,QAAQ,GAA2B,IAAI,CAAC;IACxC,eAAe,GAAG,KAAK,CAAC;IAExB,cAAc;QAClB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,QAAQ,CAAC;QACzB,CAAC;QAED,MAAM,QAAQ,GAAG,iCAAiC,EAAE,CAAC;QACrD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,wBAAwB,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QAE/C,OAAO,QAAQ,CAAC;IACpB,CAAC;IAEO,cAAc;QAClB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,OAAO;QACX,CAAC;QAED,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAE5B,cAAc,CAAC,GAAG,EAAE;YAChB,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;YAC7B,IAAI,CAAC,cAAc,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;IACP,CAAC;IAED,MAAM,CAAC,IAAY;QACf,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAEpC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAClB,GAAG,CAAC,IAAI,CAAC,qCAAqC,MAAM,KAAK,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAEhF,OAAO;QACX,CAAC;QAED,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACrD,IAAI,CAAC,cAAc,EAAE,CAAC;IAC1B,CAAC;CACJ;AAED,OAAO,EAAE,UAAU,EAAE,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { createLogger } from \"@gtkx/utils\";\nimport { attachParsingErrorLogger, registerProviderForDefaultDisplay } from \"./provider.js\";\nimport { containmentFailure } from \"./self-contained.js\";\n\nconst log = createLogger(\"css\");\nconst NUL = \"\\u{0}\";\nconst NUL_REASON = \"carries a NUL byte, which GTK4 cannot load\";\n\nconst unusableReason = (rule: string): string | null =>\n    rule.includes(NUL) ? NUL_REASON : containmentFailure(rule);\n\nconst printableRule = (rule: string): string => rule.replaceAll(NUL, String.raw`\\0`);\n\nclass StyleSheet {\n    private css = \"\";\n    private provider: Gtk.CssProvider | null = null;\n    private updateScheduled = false;\n\n    private ensureProvider(): Gtk.CssProvider {\n        if (this.provider) {\n            return this.provider;\n        }\n\n        const provider = registerProviderForDefaultDisplay();\n        this.provider = provider;\n        attachParsingErrorLogger(provider, log, \"CSS\");\n\n        return provider;\n    }\n\n    private scheduleUpdate(): void {\n        if (this.updateScheduled) {\n            return;\n        }\n\n        this.updateScheduled = true;\n\n        queueMicrotask(() => {\n            this.updateScheduled = false;\n            this.ensureProvider().loadFromString(this.css);\n        });\n    }\n\n    insert(rule: string): void {\n        const reason = unusableReason(rule);\n\n        if (reason !== null) {\n            log.warn(`Dropped a malformed CSS rule that ${reason}: ${printableRule(rule)}`);\n\n            return;\n        }\n\n        this.css += this.css.length > 0 ? `\\n${rule}` : rule;\n        this.scheduleUpdate();\n    }\n}\n\nexport { StyleSheet };\n"]}

package/dist/tokens.d.ts

@@ -0,0 +1,3 @@
+declare const brokenToken: (text: string) => string | null;
+export { brokenToken };
+//# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AA2FA,QAAA,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,IAc5C,CAAC;AAEF,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/tokens.js

@@ -0,0 +1,77 @@
+const UNTERMINATED = "leaves a string, comment or url unterminated";
+const NEWLINE_IN_STRING = "carries a newline inside a string";
+const ESCAPE = "\\";
+const NEWLINE = "\n";
+const CLOSE_PAREN = ")";
+const COMMENT_OPEN = "/*";
+const COMMENT_CLOSE = "*/";
+const URL_OPEN = "url(";
+const QUOTES = new Set(['"', "'"]);
+const URL_TOKEN = /url\(/iy;
+const QUOTED_URL = /url\([\t\n\f\r ]*["']/iy;
+const hasMatchAt = (pattern, text, index) => {
+    pattern.lastIndex = index;
+    return pattern.test(text);
+};
+const isUrlStart = (text, index) => hasMatchAt(URL_TOKEN, text, index) && !hasMatchAt(QUOTED_URL, text, index);
+const took = (index) => ({ index, reason: null });
+const broke = (index, reason) => ({ index, reason });
+const stepped = (text, index) => index + (text.charAt(index) === ESCAPE ? 2 : 1);
+const endOfString = (text, index, quote) => {
+    const char = text.charAt(index);
+    if (char === quote) {
+        return took(index + 1);
+    }
+    return char === NEWLINE ? broke(index + 1, NEWLINE_IN_STRING) : null;
+};
+const readString = (text, start, quote) => {
+    let index = start;
+    while (index < text.length) {
+        const end = endOfString(text, index, quote);
+        if (end !== null) {
+            return end;
+        }
+        index = stepped(text, index);
+    }
+    return broke(index, UNTERMINATED);
+};
+const readComment = (text, start) => {
+    const end = text.indexOf(COMMENT_CLOSE, start);
+    return end === -1 ? broke(text.length, UNTERMINATED) : took(end + COMMENT_CLOSE.length);
+};
+const readUrl = (text, start) => {
+    let index = start;
+    while (index < text.length) {
+        if (text.charAt(index) === CLOSE_PAREN) {
+            return took(index + 1);
+        }
+        index = stepped(text, index);
+    }
+    return broke(index, UNTERMINATED);
+};
+const readNext = (text, index) => {
+    const char = text.charAt(index);
+    if (char === ESCAPE) {
+        return took(index + 2);
+    }
+    if (QUOTES.has(char)) {
+        return readString(text, index + 1, char);
+    }
+    if (text.startsWith(COMMENT_OPEN, index)) {
+        return readComment(text, index + COMMENT_OPEN.length);
+    }
+    return isUrlStart(text, index) ? readUrl(text, index + URL_OPEN.length) : took(index + 1);
+};
+const brokenToken = (text) => {
+    let index = 0;
+    while (index < text.length) {
+        const step = readNext(text, index);
+        if (step.reason !== null) {
+            return step.reason;
+        }
+        index = step.index;
+    }
+    return null;
+};
+export { brokenToken };
+//# sourceMappingURL=tokens.js.map

package/dist/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"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","sourcesContent":["type Step = { index: number; reason: string | null };\n\nconst UNTERMINATED = \"leaves a string, comment or url unterminated\";\nconst NEWLINE_IN_STRING = \"carries a newline inside a string\";\nconst ESCAPE = \"\\\\\";\nconst NEWLINE = \"\\n\";\nconst CLOSE_PAREN = \")\";\nconst COMMENT_OPEN = \"/*\";\nconst COMMENT_CLOSE = \"*/\";\nconst URL_OPEN = \"url(\";\nconst QUOTES = new Set(['\"', \"'\"]);\nconst URL_TOKEN = /url\\(/iy;\nconst QUOTED_URL = /url\\([\\t\\n\\f\\r ]*[\"']/iy;\n\nconst hasMatchAt = (pattern: RegExp, text: string, index: number): boolean => {\n    pattern.lastIndex = index;\n\n    return pattern.test(text);\n};\n\nconst isUrlStart = (text: string, index: number): boolean =>\n    hasMatchAt(URL_TOKEN, text, index) && !hasMatchAt(QUOTED_URL, text, index);\n\nconst took = (index: number): Step => ({ index, reason: null });\nconst broke = (index: number, reason: string): Step => ({ index, reason });\nconst stepped = (text: string, index: number): number => index + (text.charAt(index) === ESCAPE ? 2 : 1);\n\nconst endOfString = (text: string, index: number, quote: string): Step | null => {\n    const char = text.charAt(index);\n\n    if (char === quote) {\n        return took(index + 1);\n    }\n\n    return char === NEWLINE ? broke(index + 1, NEWLINE_IN_STRING) : null;\n};\n\nconst readString = (text: string, start: number, quote: string): Step => {\n    let index = start;\n\n    while (index < text.length) {\n        const end = endOfString(text, index, quote);\n\n        if (end !== null) {\n            return end;\n        }\n\n        index = stepped(text, index);\n    }\n\n    return broke(index, UNTERMINATED);\n};\n\nconst readComment = (text: string, start: number): Step => {\n    const end = text.indexOf(COMMENT_CLOSE, start);\n\n    return end === -1 ? broke(text.length, UNTERMINATED) : took(end + COMMENT_CLOSE.length);\n};\n\nconst readUrl = (text: string, start: number): Step => {\n    let index = start;\n\n    while (index < text.length) {\n        if (text.charAt(index) === CLOSE_PAREN) {\n            return took(index + 1);\n        }\n\n        index = stepped(text, index);\n    }\n\n    return broke(index, UNTERMINATED);\n};\n\nconst readNext = (text: string, index: number): Step => {\n    const char = text.charAt(index);\n\n    if (char === ESCAPE) {\n        return took(index + 2);\n    }\n\n    if (QUOTES.has(char)) {\n        return readString(text, index + 1, char);\n    }\n\n    if (text.startsWith(COMMENT_OPEN, index)) {\n        return readComment(text, index + COMMENT_OPEN.length);\n    }\n\n    return isUrlStart(text, index) ? readUrl(text, index + URL_OPEN.length) : took(index + 1);\n};\n\nconst brokenToken = (text: string): string | null => {\n    let index = 0;\n\n    while (index < text.length) {\n        const step = readNext(text, index);\n\n        if (step.reason !== null) {\n            return step.reason;\n        }\n\n        index = step.index;\n    }\n\n    return null;\n};\n\nexport { brokenToken };\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gtkx/css",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Emotion-flavored CSS-in-JS that compiles to real GTK4 CSS and installs it on the default display",
   "keywords": [
     "gtkx",
@@ -38,17 +38,27 @@
     "dist",
     "src"
   ],
+  "nx": {
+    "targets": {
+      "lint": {
+        "options": {
+          "cwd": ".",
+          "command": "eslint {projectRoot}"
+        }
+      }
+    }
+  },
   "engines": {
     "node": ">=24"
   },
   "dependencies": {
     "@emotion/serialize": "^1.3.3",
     "stylis": "^4.4.0",
-    "@gtkx/utils": "1.0.0"
+    "@gtkx/utils": "1.2.0"
   },
   "devDependencies": {
     "@types/stylis": "^4.2.7",
-    "@gtkx/vitest": "1.0.0"
+    "@gtkx/vitest": "1.2.0"
   },
   "scripts": {
     "release": "tsx ../../scripts/release-package.ts"

package/src/create-css.ts

@@ -8,7 +8,7 @@ import { StyleSheet } from "./stylesheet.js";
 /** A `cx` argument: a non-empty class name, or a boolean or nullish value that is dropped. */
 type CxToken = string | boolean | undefined | null;
 
-/** The `css`, `cx` and `injectGlobal` trio bound to one GTK4 stylesheet and its cache of inserted styles. */
+/** The `css`, `cx` and `injectGlobal` helpers bound to one GTK4 stylesheet and its cache of inserted styles. */
 type Css = {
     /**
      * Serializes the given style interpolations, inserts the resulting rules into the stylesheet, and
@@ -43,6 +43,17 @@ const removeLabel = (element: Element): void => {
 };
 
 const getClassName = (serialized: SerializedStyles): string => `${KEY}-${serialized.name}`;
+
+const terminateDeclarations = (styles: string): string => {
+    const trimmed = styles.trimEnd();
+
+    if (trimmed.length === 0 || trimmed.endsWith(";") || trimmed.endsWith("}")) {
+        return trimmed;
+    }
+
+    return `${trimmed};`;
+};
+
 const isNonEmptyString = (token: CxToken): token is string => typeof token === "string" && token.length > 0;
 
 const partitionTokens = (tokens: string[], registered: RegisteredCache): TokenPartition => {
@@ -91,8 +102,9 @@ const insertStyles = (state: CssState, serialized: SerializedStyles): void => {
     }
 
     const className = getClassName(serialized);
-    runStylis(state.sheet, `.${className}{${serialized.styles}}`);
-    state.registered[className] = serialized.styles;
+    const styles = terminateDeclarations(serialized.styles);
+    runStylis(state.sheet, `.${className}{${styles}}`);
+    state.registered[className] = styles;
 };
 
 const insertWithoutScoping = (state: CssState, serialized: SerializedStyles): void => {
@@ -133,4 +145,4 @@ const createCss = (): Css => {
     };
 };
 
-export { removeLabel, createCss, type Css };
+export { createCss, type Css };

package/src/named-colors.ts

@@ -10,4 +10,4 @@ const escapeNamedColors = (input: string): string =>
 
 const restoreNamedColors = (rule: string): string => rule.replaceAll(NAMED_COLOR_TOKEN_PATTERN, "@$1");
 
-export { AT_RULE_KEYWORDS, NAMED_COLOR_TOKEN, escapeNamedColors, restoreNamedColors };
+export { escapeNamedColors, restoreNamedColors };

package/src/self-contained.ts

@@ -0,0 +1,56 @@
+import { CssProvider } from "@gtkx/gi/gtk";
+import { randomBytes } from "node:crypto";
+import { brokenToken } from "./tokens.js";
+
+type Gate = { provider: CssProvider | null; ruleset: string | null };
+
+const PROBE_BYTES = 16;
+const PROBE_RULE = `.gtkx-probe-${randomBytes(PROBE_BYTES).toString("hex")}{color:rgb(0, 0, 0);}`;
+const SWALLOWS_WHAT_FOLLOWS = "would disable every rule after it";
+const gate: Gate = { provider: null, ruleset: null };
+
+const ignoreParsingError = (): undefined => undefined;
+
+const createQuietProvider = (): CssProvider => {
+    const provider = new CssProvider();
+    provider.on("parsing-error", ignoreParsingError);
+
+    return provider;
+};
+
+const quiet = (): CssProvider => {
+    gate.provider ??= createQuietProvider();
+
+    return gate.provider;
+};
+
+const parsed = (document: string): string => {
+    const provider = quiet();
+    provider.loadFromString(document);
+
+    return provider.toString();
+};
+
+const probe = (): string => {
+    gate.ruleset ??= parsed(PROBE_RULE);
+
+    return gate.ruleset;
+};
+
+const hasProbe = (serialized: string): boolean => {
+    const ruleset = probe();
+
+    return ruleset.length > 0 && `\n${serialized}`.includes(`\n${ruleset}`);
+};
+
+const containmentFailure = (rule: string): string | null => {
+    const broken = brokenToken(rule);
+
+    if (broken !== null) {
+        return broken;
+    }
+
+    return hasProbe(parsed(`${rule}\n${PROBE_RULE}`)) ? null : SWALLOWS_WHAT_FOLLOWS;
+};
+
+export { containmentFailure };

package/src/stylesheet.ts

@@ -1,8 +1,16 @@
 import type * as Gtk from "@gtkx/gi/gtk";
 import { createLogger } from "@gtkx/utils";
 import { attachParsingErrorLogger, registerProviderForDefaultDisplay } from "./provider.js";
+import { containmentFailure } from "./self-contained.js";
 
 const log = createLogger("css");
+const NUL = "\u{0}";
+const NUL_REASON = "carries a NUL byte, which GTK4 cannot load";
+
+const unusableReason = (rule: string): string | null =>
+    rule.includes(NUL) ? NUL_REASON : containmentFailure(rule);
+
+const printableRule = (rule: string): string => rule.replaceAll(NUL, String.raw`\0`);
 
 class StyleSheet {
     private css = "";
@@ -35,6 +43,14 @@ class StyleSheet {
     }
 
     insert(rule: string): void {
+        const reason = unusableReason(rule);
+
+        if (reason !== null) {
+            log.warn(`Dropped a malformed CSS rule that ${reason}: ${printableRule(rule)}`);
+
+            return;
+        }
+
         this.css += this.css.length > 0 ? `\n${rule}` : rule;
         this.scheduleUpdate();
     }

package/src/tokens.ts

@@ -0,0 +1,108 @@
+type Step = { index: number; reason: string | null };
+
+const UNTERMINATED = "leaves a string, comment or url unterminated";
+const NEWLINE_IN_STRING = "carries a newline inside a string";
+const ESCAPE = "\\";
+const NEWLINE = "\n";
+const CLOSE_PAREN = ")";
+const COMMENT_OPEN = "/*";
+const COMMENT_CLOSE = "*/";
+const URL_OPEN = "url(";
+const QUOTES = new Set(['"', "'"]);
+const URL_TOKEN = /url\(/iy;
+const QUOTED_URL = /url\([\t\n\f\r ]*["']/iy;
+
+const hasMatchAt = (pattern: RegExp, text: string, index: number): boolean => {
+    pattern.lastIndex = index;
+
+    return pattern.test(text);
+};
+
+const isUrlStart = (text: string, index: number): boolean =>
+    hasMatchAt(URL_TOKEN, text, index) && !hasMatchAt(QUOTED_URL, text, index);
+
+const took = (index: number): Step => ({ index, reason: null });
+const broke = (index: number, reason: string): Step => ({ index, reason });
+const stepped = (text: string, index: number): number => index + (text.charAt(index) === ESCAPE ? 2 : 1);
+
+const endOfString = (text: string, index: number, quote: string): Step | null => {
+    const char = text.charAt(index);
+
+    if (char === quote) {
+        return took(index + 1);
+    }
+
+    return char === NEWLINE ? broke(index + 1, NEWLINE_IN_STRING) : null;
+};
+
+const readString = (text: string, start: number, quote: string): Step => {
+    let index = start;
+
+    while (index < text.length) {
+        const end = endOfString(text, index, quote);
+
+        if (end !== null) {
+            return end;
+        }
+
+        index = stepped(text, index);
+    }
+
+    return broke(index, UNTERMINATED);
+};
+
+const readComment = (text: string, start: number): Step => {
+    const end = text.indexOf(COMMENT_CLOSE, start);
+
+    return end === -1 ? broke(text.length, UNTERMINATED) : took(end + COMMENT_CLOSE.length);
+};
+
+const readUrl = (text: string, start: number): Step => {
+    let index = start;
+
+    while (index < text.length) {
+        if (text.charAt(index) === CLOSE_PAREN) {
+            return took(index + 1);
+        }
+
+        index = stepped(text, index);
+    }
+
+    return broke(index, UNTERMINATED);
+};
+
+const readNext = (text: string, index: number): Step => {
+    const char = text.charAt(index);
+
+    if (char === ESCAPE) {
+        return took(index + 2);
+    }
+
+    if (QUOTES.has(char)) {
+        return readString(text, index + 1, char);
+    }
+
+    if (text.startsWith(COMMENT_OPEN, index)) {
+        return readComment(text, index + COMMENT_OPEN.length);
+    }
+
+    return isUrlStart(text, index) ? readUrl(text, index + URL_OPEN.length) : took(index + 1);
+};
+
+const brokenToken = (text: string): string | null => {
+    let index = 0;
+
+    while (index < text.length) {
+        const step = readNext(text, index);
+
+        if (step.reason !== null) {
+            return step.reason;
+        }
+
+        index = step.index;
+    }
+
+    return null;
+};
+
+export { brokenToken };