tyrell-components 1.0.0-TC28 → 1.0.0-TC30

package/lib/utils/flavor-sheet.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Custom (non-built-in) flavor support.
+ *
+ * Built-in flavors get static per-flavor CSS in each component's stylesheet.
+ * Any other flavor string is a custom flavor: the component generates the
+ * same wiring at runtime, pointed at the user's design tokens
+ * (--ty-color-X / --ty-bg-X / --ty-solid-X / ...), and adopts it as a
+ * constructed stylesheet.
+ *
+ * Why an adopted sheet: render() implementations replace shadowRoot.innerHTML
+ * (which would destroy an injected <style> element), and inline style on the
+ * host would defeat page-level overrides. Adopted sheets survive renders, and
+ * outer-document rules on the host still take precedence over :host rules —
+ * so `ty-tag[flavor="X"] { --tag-bg: ... }` escape hatches keep working.
+ */
+export interface CustomFlavorParts {
+    /** Full flavor string as given, e.g. "brand+" */
+    flavor: string;
+    /** Flavor with any +/- shade suffix stripped, e.g. "brand" */
+    base: string;
+    /** "" | "+" | "-" */
+    shade: string;
+}
+/**
+ * Keep a shadow root's custom-flavor sheet in sync with the current flavor.
+ *
+ * Built-in flavors (and anything that isn't a plain identifier, so attribute
+ * values can't inject CSS) remove the sheet. Custom flavors get `css(parts)`
+ * adopted into the shadow root. Returns the sheet to store for the next call.
+ */
+export declare function syncCustomFlavorSheet(shadow: ShadowRoot, sheet: CSSStyleSheet | null, flavor: unknown, css: (parts: CustomFlavorParts) => string): CSSStyleSheet | null;
+//# sourceMappingURL=flavor-sheet.d.ts.map

package/lib/utils/flavor-sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flavor-sheet.d.ts","sourceRoot":"","sources":["../../src/utils/flavor-sheet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAA;IACd,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,aAAa,GAAG,IAAI,EAC3B,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,MAAM,GACxC,aAAa,GAAG,IAAI,CAetB"}

package/lib/utils/flavor-sheet.js

@@ -0,0 +1,40 @@
+/**
+ * Custom (non-built-in) flavor support.
+ *
+ * Built-in flavors get static per-flavor CSS in each component's stylesheet.
+ * Any other flavor string is a custom flavor: the component generates the
+ * same wiring at runtime, pointed at the user's design tokens
+ * (--ty-color-X / --ty-bg-X / --ty-solid-X / ...), and adopts it as a
+ * constructed stylesheet.
+ *
+ * Why an adopted sheet: render() implementations replace shadowRoot.innerHTML
+ * (which would destroy an injected <style> element), and inline style on the
+ * host would defeat page-level overrides. Adopted sheets survive renders, and
+ * outer-document rules on the host still take precedence over :host rules —
+ * so `ty-tag[flavor="X"] { --tag-bg: ... }` escape hatches keep working.
+ */
+import { FLAVORS } from '../types/common.js';
+/**
+ * Keep a shadow root's custom-flavor sheet in sync with the current flavor.
+ *
+ * Built-in flavors (and anything that isn't a plain identifier, so attribute
+ * values can't inject CSS) remove the sheet. Custom flavors get `css(parts)`
+ * adopted into the shadow root. Returns the sheet to store for the next call.
+ */
+export function syncCustomFlavorSheet(shadow, sheet, flavor, css) {
+    const full = String(flavor || '');
+    const base = full.replace(/[+-]$/, '');
+    if (FLAVORS.includes(base) || !/^[A-Za-z][A-Za-z0-9_-]*$/.test(base)) {
+        if (sheet) {
+            shadow.adoptedStyleSheets = shadow.adoptedStyleSheets.filter((s) => s !== sheet);
+        }
+        return null;
+    }
+    if (!sheet) {
+        sheet = new CSSStyleSheet();
+        shadow.adoptedStyleSheets = [...shadow.adoptedStyleSheets, sheet];
+    }
+    sheet.replaceSync(css({ flavor: full, base, shade: full.slice(base.length) }));
+    return sheet;
+}
+//# sourceMappingURL=flavor-sheet.js.map

package/lib/utils/flavor-sheet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flavor-sheet.js","sourceRoot":"","sources":["../../src/utils/flavor-sheet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAW5C;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAkB,EAClB,KAA2B,EAC3B,MAAe,EACf,GAAyC;IAEzC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAA;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IACtC,IAAK,OAA6B,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5F,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAA;QAClF,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,GAAG,IAAI,aAAa,EAAE,CAAA;QAC3B,MAAM,CAAC,kBAAkB,GAAG,CAAC,GAAG,MAAM,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAA;IACnE,CAAC;IACD,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;IAC9E,OAAO,KAAK,CAAA;AACd,CAAC"}

package/lib/version.d.ts

@@ -4,5 +4,5 @@
  * This is automatically synced with package.json during build.
  * Use `npm version` to bump versions.
  */
-export declare const VERSION = "1.0.0-TC28";
+export declare const VERSION = "1.0.0-TC30";
 //# sourceMappingURL=version.d.ts.map

package/lib/version.js

@@ -7,5 +7,5 @@
  * This is automatically synced with package.json during build.
  * Use `npm version` to bump versions.
  */
-export const VERSION = '1.0.0-TC28';
+export const VERSION = '1.0.0-TC30';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tyrell-components",
-  "version": "1.0.0-TC28",
+  "version": "1.0.0-TC30",
   "description": "Tyrell Components - Framework-agnostic web components with semantic design system",
   "type": "module",
   "sideEffects": [