npm - @roxyapi/ui - Versions diffs - 0.8.1 → 0.9.0 - Mend

@roxyapi/ui 0.8.1 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (30) hide show

package/AGENTS.md +30 -7
package/README.md +11 -13
package/THEMING.md +7 -5
package/dist/cdn/roxy-ui.js +260 -37
package/dist/cdn/roxy-ui.js.map +4 -4
package/dist/cdn.d.ts +8 -0
package/dist/cdn.d.ts.map +1 -0
package/dist/index.cjs +1 -1
package/dist/index.cjs.map +1 -1
package/dist/index.js +1 -1
package/dist/index.js.map +1 -1
package/dist/manifest.json +24 -24
package/dist/styles/tokens-css.d.ts +2 -0
package/dist/styles/tokens-css.d.ts.map +1 -0
package/dist/styles/tokens.css +26 -11
package/dist/types/index.d.ts +1 -1
package/dist/types/index.d.ts.map +1 -1
package/dist/types/types.gen.d.ts +43 -26
package/dist/types/types.gen.d.ts.map +1 -1
package/dist/utils/inject-tokens.d.ts +16 -0
package/dist/utils/inject-tokens.d.ts.map +1 -0
package/dist/version.d.ts +1 -1
package/package.json +1 -1
package/src/cdn.ts +15 -0
package/src/styles/tokens-css.ts +225 -0
package/src/styles/tokens.css +26 -11
package/src/types/index.ts +1 -1
package/src/types/types.gen.ts +43 -26
package/src/utils/inject-tokens.ts +27 -0
package/src/version.ts +1 -1

package/src/utils/inject-tokens.ts ADDED Viewed

@@ -0,0 +1,27 @@
+import { ROXY_UI_TOKENS_CSS } from '../styles/tokens-css.js';
+/** Element id of the injected token stylesheet. Stable so injection is idempotent and so a host page can find, inspect, or remove it. */
+export const ROXY_UI_TOKENS_STYLE_ID = 'roxy-ui-tokens';
+/**
+ * Inject the Roxy UI design tokens (light + dark, all theme triggers) into the document head as the cascade's lowest-priority source, so a single CDN script tag yields full theming and dark mode with no separate stylesheet link.
+ *
+ * @remarks
+ * Three invariants hold this safe for every consumer:
+ *
+ * - SSR-safe: a missing `document` (Node, Lit-SSR, Bun) is a no-op. Only the CDN bundle calls this; the npm/ESM entry (`src/index.ts`) never touches the document, so bundler and server consumers are unaffected.
+ * - Idempotent: a second call (two script tags, HMR, re-registration) finds the existing `#roxy-ui-tokens` and returns without duplicating.
+ * - Lowest priority: the style is PREPENDED to `<head>`, so it is the earliest source-order rule. Any consumer `:root { --roxy-* }` brand override or linked `tokens.css` appears later and wins ties. This preserves backwards compatibility: existing pages that already link `tokens.css` and set overrides keep their exact behaviour.
+ *
+ * @returns The injected (or pre-existing) style element, or `null` under SSR.
+ */
+export function injectRoxyTokens(): HTMLStyleElement | null {
+	if (typeof document === 'undefined') return null;
+	const existing = document.getElementById(ROXY_UI_TOKENS_STYLE_ID);
+	if (existing) return existing as HTMLStyleElement;
+	const style = document.createElement('style');
+	style.id = ROXY_UI_TOKENS_STYLE_ID;
+	style.textContent = ROXY_UI_TOKENS_CSS;
+	document.head.prepend(style);
+	return style;
+}

package/src/version.ts CHANGED Viewed

@@ -1,2 +1,2 @@
 // Generated by scripts/sync-version.ts. Do not edit.
-export const ROXY_UI_VERSION = '0.8.1';
+export const ROXY_UI_VERSION = '0.9.0';