@animus-ui/properties 0.1.21 → 0.1.23

package/dist/index.d.ts

@@ -85,6 +85,21 @@ export declare const isSpace: (value: ComponentValue | undefined) => boolean;
  * first argument is a custom-property name.
  */
 export declare function variableReads(values: readonly ComponentValue[]): VariableRead[];
+/** How a value spells the `!important` it ends with: `hidden !important`,
+ *  any case and spacing, or the shorthand `hidden!`. */
+type ImportantSpelling = 'important' | 'shorthand';
+interface ImportantPriority {
+  spelling: ImportantSpelling;
+  /** Where the value before the priority ends. */
+  end: number;
+}
+/**
+ * The `!important` `css` ends with; kept in step with `important_priority`
+ * in the Rust engine. The value has one `!`, a delim token, so a `!` inside
+ * a string, a `url()` or an escape is no priority, and neither is a lone `!`
+ * or `!important`.
+ */
+export declare function importantPriority(css: string): ImportantPriority | undefined;
 //#endregion
 //#region src/registration-values.d.ts
 /**
@@ -141,5 +156,5 @@ type FoldedInitialValue =
  */
 export declare function foldInitialValue(syntax: string, initialValue: string): FoldedInitialValue | undefined;
 //#endregion
-export type { ComponentValue, CssToken, FoldedInitialValue, VariableRead };
+export type { ComponentValue, CssToken, FoldedInitialValue, ImportantPriority, ImportantSpelling, VariableRead };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/shorthands.ts","../src/unitless.ts","../src/css-tokens.ts","../src/registration-values.ts"],"mappings":";;;;qBAGa;;;qBCHA,qBAAmB;;;wBAgHhB,mBAAmB;;;;;;;;;;KCxGvB;UA0BK;EACf,MAAM;EACN;EACA;;;EAGA;;EAEA;;;;wBAiFc,aACd,aACA;EACG;EAAc;;;wBAOH,kBAAkB;;wBAyFlB,SAAS,cAAc;;;KA0E3B;EAEN;;EAEA,MAAM;;EAEN,OAAO;EACP,UAAU;EACV;EACA;;EAEA;EAAe,OAAO;EAAU;EAAe;;;;;;;wBAgBrC,gBAAgB,iBAAiB,aAAa;;wBAoC9C,UACd,iBAAiB,kBACjB,OAAO,OAAO;;;;UAWC;EACf;EACA;EACA;EACA;IAAY;IAAe;IAAe;;;;qBAI/B,UAAO,OAAW;;;;;;wBAQf,cACd,iBAAiB,mBAChB;;;;;;;;;;;;wBCvWa,iBAAiB;;;wBA6BjB,iBAAiB;;UAWvB;EACR;EACA;;;KA+NU;;;;EAGN;EAAgB;;;;EAEhB;EAAkB;EAAc,MAAM;;;;EAEtC;EAAiB;;;;;EAGjB;;;;;;;;;;;;wBAYU,iBACd,gBACA,uBACC"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/shorthands.ts","../src/unitless.ts","../src/css-tokens.ts","../src/registration-values.ts"],"mappings":";;;;qBAGa;;;qBCHA,qBAAmB;;;wBAgHhB,mBAAmB;;;;;;;;;;KCxGvB;UA0BK;EACf,MAAM;EACN;EACA;;;EAGA;;EAEA;;;;wBAiFc,aACd,aACA;EACG;EAAc;;;wBAOH,kBAAkB;;wBAyFlB,SAAS,cAAc;;;KA0E3B;EAEN;;EAEA,MAAM;;EAEN,OAAO;EACP,UAAU;EACV;EACA;;EAEA;EAAe,OAAO;EAAU;EAAe;;;;;;;wBAgBrC,gBAAgB,iBAAiB,aAAa;;wBAoC9C,UACd,iBAAiB,kBACjB,OAAO,OAAO;;;;UAWC;EACf;EACA;EACA;EACA;IAAY;IAAe;IAAe;;;;qBAI/B,UAAO,OAAW;;;;;;wBAQf,cACd,iBAAiB,mBAChB;;;KAiCS;UAEK;EACf,UAAU;;EAEV;;;;;;;;wBASc,kBAAkB,cAAc;;;;;;;;;;;;wBCtZhC,iBAAiB;;;wBA6BjB,iBAAiB;;UAWvB;EACR;EACA;;;KA+NU;;;;EAGN;EAAgB;;;;EAEhB;EAAkB;EAAc,MAAM;;;;EAEtC;EAAiB;;;;;EAGjB;;;;;;;;;;;;wBAYU,iBACd,gBACA,uBACC"}

package/dist/index.js

@@ -430,6 +430,39 @@ function variableReads(values) {
 	visit(values);
 	return reads;
 }
+/**
+* The `!important` `css` ends with; kept in step with `important_priority`
+* in the Rust engine. The value has one `!`, a delim token, so a `!` inside
+* a string, a `url()` or an escape is no priority, and neither is a lone `!`
+* or `!important`.
+*/
+function importantPriority(css) {
+	const trimmed = css.trimEnd();
+	const endsImportant = trimmed.length >= 9 && /^important$/i.test(trimmed.slice(-9));
+	if (!css.endsWith("!") && !endsImportant) return void 0;
+	const tokens = tokenize(css);
+	let bang = -1;
+	for (let index = 0; index < tokens.length; index += 1) {
+		if (tokens[index].type !== "delim" || tokens[index].value !== "!") continue;
+		if (bang !== -1) return void 0;
+		bang = index;
+	}
+	if (bang === -1) return void 0;
+	if (bang === tokens.length - 1) {
+		const previous = tokens[bang - 1];
+		return previous !== void 0 && previous.type !== "whitespace" && previous.end === tokens[bang].start ? {
+			spelling: "shorthand",
+			end: previous.end
+		} : void 0;
+	}
+	const after = tokens.slice(bang + 1).filter((t) => t.type !== "whitespace");
+	if (after.length !== 1 || after[0].type !== "ident" || !/^important$/i.test(after[0].value)) return;
+	const value = tokens.slice(0, bang).findLast((t) => t.type !== "whitespace");
+	return value && {
+		spelling: "important",
+		end: value.end
+	};
+}
 //#endregion
 //#region src/registration-values.ts
 /**
@@ -727,4 +760,4 @@ function written(computed) {
 	return `${Number(computed.value.toPrecision(12))}${CANONICAL_UNITS[computed.type]}`;
 }
 //#endregion
-export { SHORTHAND_PROPERTIES, UNITLESS_PROPERTIES, componentValues, decodedIdentifier, dependsOnContext, foldInitialValue, identifierAt, isSpace, isUnitlessProperty, someValue, substitutesValue, tokenize, variableReads };
+export { SHORTHAND_PROPERTIES, UNITLESS_PROPERTIES, componentValues, decodedIdentifier, dependsOnContext, foldInitialValue, identifierAt, importantPriority, isSpace, isUnitlessProperty, someValue, substitutesValue, tokenize, variableReads };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animus-ui/properties",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "description": "CSS property classification data — unitless set, shorthand list, type re-exports",
   "keywords": [
     "animus",