@memberjunction/theme-engine 0.0.0 → 5.50.0

package/dist/derive.js

@@ -0,0 +1,238 @@
+/**
+ * @fileoverview The single derivation function shared by save, live preview, and
+ * validation (org theming decision #4). Given ~8 brand seeds it produces the full
+ * --mj-* token contract: generated OKLCH ramps, resolved light/dark semantic maps,
+ * a brand-derived chart palette (G4), brand-tinted shadows (G3), the font token (G1),
+ * shape radii, an a11y contrast report, and the minimal CSS overlay to emit at runtime.
+ *
+ * Overlay strategy: the emitted overlay only redefines the PRIMITIVE ramps (plus viz,
+ * shadow, font, radius). Every semantic token and the entire [data-theme="dark"] block
+ * in _tokens.scss are `var(--mj-color-*)` references, so overriding primitives cascades
+ * into both modes automatically — the dark re-point and hover families come for free,
+ * with no risk of a parallel mapping diverging from the base stylesheet.
+ * @module @memberjunction/theme-engine
+ */
+import { mixHex, parseHex } from './color.js';
+import { buildContrastReport } from './contrast.js';
+import { ACCENT_SHAPE, BRAND_SHAPE, FAMILY_ANCHOR, generateBrandRamp, generateNeutralRamp, TERTIARY_SHAPE, } from './ramps.js';
+import { hexToOKLCH, oklchToHex } from './color.js';
+import { MJ_DEFAULT_SEEDS, resolveSeeds } from './seeds.js';
+/** Fixed (non-brand-derived) status ramp steps referenced by the semantic maps. */
+const STATUS = {
+    successBg: '#f0fdf4', success: '#22c55e', successText: '#15803d', successText100: '#dcfce7',
+    warningBg: '#fffbeb', warning: '#f59e0b', warningText: '#b45309', warningText100: '#fef3c7',
+    errorBg: '#fef2f2', error: '#ef4444', errorText: '#b91c1c', errorText100: '#fee2e2', error400: '#f87171',
+    infoBg: '#eff6ff', info: '#3b82f6', infoText: '#1d4ed8', infoText100: '#dbeafe',
+};
+/** Build the resolved semantic map for one mode from the generated primitive ramps. */
+function resolveSemantics(brand, accent, tertiary, neutral, mode) {
+    if (mode === 'light') {
+        return {
+            '--mj-bg-page': neutral[50], '--mj-bg-surface': neutral[0], '--mj-bg-surface-elevated': neutral[0],
+            '--mj-bg-surface-card': neutral[50], '--mj-bg-surface-sunken': neutral[100],
+            '--mj-bg-surface-hover': neutral[100], '--mj-bg-surface-active': neutral[200],
+            '--mj-text-primary': neutral[800], '--mj-text-secondary': neutral[600], '--mj-text-muted': neutral[500],
+            '--mj-text-disabled': neutral[400], '--mj-text-inverse': neutral[0],
+            '--mj-text-link': brand[500], '--mj-text-link-hover': brand[600],
+            '--mj-border-default': neutral[200], '--mj-border-subtle': neutral[100], '--mj-border-strong': neutral[300],
+            '--mj-border-focus': brand[500], '--mj-border-error': STATUS.error,
+            '--mj-brand-primary': brand[500], '--mj-brand-primary-hover': brand[600], '--mj-brand-primary-active': brand[700],
+            '--mj-brand-primary-light': brand[350], '--mj-brand-secondary': brand[900], '--mj-brand-on-primary': neutral[0],
+            '--mj-brand-accent': accent[400], '--mj-brand-accent-hover': accent[500], '--mj-brand-accent-active': accent[600],
+            '--mj-brand-accent-subtle': accent[50], '--mj-brand-on-accent': neutral[900],
+            '--mj-brand-tertiary': tertiary[500], '--mj-brand-tertiary-hover': tertiary[600],
+            '--mj-brand-tertiary-active': tertiary[700], '--mj-brand-tertiary-subtle': tertiary[50], '--mj-brand-on-tertiary': neutral[0],
+            '--mj-status-success': STATUS.success, '--mj-status-success-bg': STATUS.successBg, '--mj-status-success-text': STATUS.successText,
+            '--mj-status-warning': STATUS.warning, '--mj-status-warning-bg': STATUS.warningBg, '--mj-status-warning-text': STATUS.warningText,
+            '--mj-status-error': STATUS.error, '--mj-status-error-bg': STATUS.errorBg, '--mj-status-error-text': STATUS.errorText,
+            '--mj-status-info': STATUS.info, '--mj-status-info-bg': STATUS.infoBg, '--mj-status-info-text': STATUS.infoText,
+        };
+    }
+    return {
+        '--mj-bg-page': neutral[900], '--mj-bg-surface': neutral[800], '--mj-bg-surface-elevated': neutral[700],
+        // Card sits between surface (800) and elevated (700). The 0.32 weight is calibrated
+        // so MJ's default neutrals reproduce the historical #253347 (ΔE ≈ 0.011); the base
+        // stylesheet's dark block uses the equivalent color-mix(in srgb-linear, 800 68%, 700)
+        // so preview and runtime stay in exact lockstep under a brand overlay.
+        '--mj-bg-surface-card': mixHex(neutral[800], neutral[700], 0.32), '--mj-bg-surface-sunken': neutral[950],
+        '--mj-bg-surface-hover': neutral[600], '--mj-bg-surface-active': neutral[500],
+        '--mj-text-primary': neutral[100], '--mj-text-secondary': neutral[300], '--mj-text-muted': neutral[400],
+        '--mj-text-disabled': neutral[600], '--mj-text-inverse': neutral[900],
+        '--mj-text-link': brand[300], '--mj-text-link-hover': brand[200],
+        '--mj-border-default': neutral[700], '--mj-border-subtle': neutral[800], '--mj-border-strong': neutral[600],
+        '--mj-border-focus': brand[400], '--mj-border-error': STATUS.error400,
+        '--mj-brand-primary': brand[400], '--mj-brand-primary-hover': brand[300], '--mj-brand-primary-active': brand[200],
+        '--mj-brand-primary-light': brand[350], '--mj-brand-secondary': brand[900], '--mj-brand-on-primary': neutral[0],
+        '--mj-brand-accent': accent[300], '--mj-brand-accent-hover': accent[200], '--mj-brand-accent-active': accent[100],
+        '--mj-brand-accent-subtle': `color-mix(in srgb, ${accent[400]} 15%, transparent)`, '--mj-brand-on-accent': neutral[900],
+        '--mj-brand-tertiary': tertiary[400], '--mj-brand-tertiary-hover': tertiary[300], '--mj-brand-tertiary-active': tertiary[200],
+        '--mj-brand-tertiary-subtle': `color-mix(in srgb, ${tertiary[500]} 15%, transparent)`, '--mj-brand-on-tertiary': neutral[0],
+        '--mj-status-success': STATUS.success, '--mj-status-success-bg': `rgba(${rgbTriplet(STATUS.success)}, 0.15)`, '--mj-status-success-text': STATUS.successText100,
+        '--mj-status-warning': STATUS.warning, '--mj-status-warning-bg': `rgba(${rgbTriplet(STATUS.warning)}, 0.15)`, '--mj-status-warning-text': STATUS.warningText100,
+        '--mj-status-error': STATUS.error, '--mj-status-error-bg': `rgba(${rgbTriplet(STATUS.error)}, 0.15)`, '--mj-status-error-text': STATUS.errorText100,
+        '--mj-status-info': STATUS.info, '--mj-status-info-bg': `rgba(${rgbTriplet(STATUS.info)}, 0.15)`, '--mj-status-info-text': STATUS.infoText100,
+    };
+}
+/** Derive a categorical chart palette (G4) by rotating hue around the brand. */
+function deriveVizPalette(brandHueDeg, override) {
+    if (override && override.length) {
+        const out = override.slice(0, 10);
+        while (out.length < 10)
+            out.push(out[out.length % override.length]);
+        return out;
+    }
+    // Ten evenly-spaced hues at a categorical-friendly lightness/chroma, anchored at brand.
+    return Array.from({ length: 10 }, (_, i) => oklchToHex({ l: 0.63, c: 0.15, h: (brandHueDeg + i * 36) % 360 }));
+}
+/** `#rrggbb` -> `r, g, b` for rgba() shadow emission. */
+function rgbTriplet(hex) {
+    const { r, g, b } = parseHex(hex);
+    return `${r}, ${g}, ${b}`;
+}
+/** Round to at most 2 decimals and drop trailing zeros. */
+const px = (n) => `${Math.round(n)}px`;
+/**
+ * Derive the full theme from brand seeds. Feeding {@link MJ_DEFAULT_SEEDS} reproduces
+ * MJ's default _tokens.scss within perceptual tolerance.
+ */
+export function derive(seeds = MJ_DEFAULT_SEEDS) {
+    const s = resolveSeeds(seeds);
+    const brandHue = hexToOKLCH(s.primary).h;
+    const brand = generateBrandRamp(BRAND_SHAPE, FAMILY_ANCHOR.brand, s.primary, s.vibrancy);
+    const accent = generateBrandRamp(ACCENT_SHAPE, FAMILY_ANCHOR.accent, s.accent, s.vibrancy);
+    const tertiary = generateBrandRamp(TERTIARY_SHAPE, FAMILY_ANCHOR.tertiary, s.tertiary, s.vibrancy);
+    const neutral = generateNeutralRamp(brandHue, s.neutralChroma);
+    const primitives = {};
+    const addRamp = (name, ramp) => {
+        for (const step of Object.keys(ramp))
+            primitives[`--mj-color-${name}-${step}`] = ramp[Number(step)];
+    };
+    addRamp('brand', brand);
+    addRamp('accent', accent);
+    addRamp('tertiary', tertiary);
+    addRamp('neutral', neutral);
+    const viz = deriveVizPalette(brandHue, s.vizPalette);
+    const vizVars = {};
+    viz.forEach((hex, i) => (vizVars[`--mj-viz-${i + 1}`] = hex));
+    // Brand-tinted shadows (G3): re-color MJ's brand shadow tokens; alpha scaled by depth.
+    const brandRgb = rgbTriplet(brand[500]);
+    const shadowVars = {
+        '--mj-shadow-brand-sm': `0 2px 8px rgba(${brandRgb}, ${(0.3 * s.depth).toFixed(2)})`,
+        '--mj-shadow-brand-md': `0 4px 12px rgba(${brandRgb}, ${(0.4 * s.depth).toFixed(2)})`,
+    };
+    // Shape (radius) and type (font, G1).
+    const shapeVars = {
+        '--mj-radius-sm': px(s.radius / 2),
+        '--mj-radius-md': px(s.radius),
+        '--mj-radius-lg': px(s.radius * 1.5),
+        '--mj-radius-xl': px(s.radius * 2),
+        '--mj-radius-2xl': px(s.radius * 3),
+    };
+    const typeVars = {
+        '--mj-font-family': s.fontFamily,
+        '--mj-font-family-mono': s.fontFamilyMono,
+    };
+    const light = resolveSemantics(brand, accent, tertiary, neutral, 'light');
+    const dark = resolveSemantics(brand, accent, tertiary, neutral, 'dark');
+    const overlayVars = {
+        ...primitives,
+        ...vizVars,
+        ...shadowVars,
+        ...shapeVars,
+        ...typeVars,
+    };
+    return {
+        seeds: s,
+        primitives,
+        tokens: { light, dark },
+        overlayVars,
+        contrast: buildContrastReport(light, dark),
+    };
+}
+/**
+ * Serialize a derived theme into overlay CSS scoped to `[data-theme-overlay="<id>"]`.
+ * A single block suffices: it overrides primitives that _tokens.scss's semantic and
+ * dark blocks reference, so both modes re-point automatically.
+ *
+ * The optional advanced layer (decision: seed-first, with an escape hatch) is applied
+ * last: `overrides` merge over the derived vars; `customCss` is appended, wrapped in the
+ * overlay selector so raw rules stay scoped to this theme.
+ */
+export function emitOverlayCss(themeId, derived, options = {}) {
+    const vars = { ...derived.overlayVars, ...(options.overrides ?? {}) };
+    const body = Object.entries(vars)
+        .map(([k, v]) => `  ${k}: ${v};`)
+        .join('\n');
+    let css = `[data-theme-overlay="${themeId}"] {\n${body}\n}\n`;
+    const custom = (options.customCss ?? '').trim();
+    if (custom) {
+        css += '\n' + emitScopedCustomCss(`[data-theme-overlay="${themeId}"]`, custom);
+    }
+    return css;
+}
+/**
+ * Scope raw custom CSS under `selector`, but hoist at-rules that MUST live at the
+ * stylesheet top level (`@keyframes`, `@font-face`, `@property`) out of the wrapper —
+ * CSS nesting forbids them inside a style rule, so nesting them would silently break
+ * animations/fonts. Everything else is wrapped so it only applies to this theme.
+ *
+ * `@import` is STRIPPED entirely, not hoisted: a scoped theme overlay has no
+ * legitimate need to pull another stylesheet, an org-wide `@import` of a remote URL
+ * is a cross-origin request from every user's session (data-exfiltration surface),
+ * and a hoisted `@import` would be dead anyway — CSS ignores `@import` after any
+ * other rule, and the overlay Blob always begins with the token block.
+ */
+export function emitScopedCustomCss(selector, css) {
+    const trimmed = css.trim();
+    if (!trimmed)
+        return '';
+    const { hoisted, scoped } = splitHoistedAtRules(trimmed);
+    let out = '';
+    if (hoisted.trim())
+        out += `${hoisted.trim()}\n`;
+    if (scoped.trim())
+        out += `${selector} {\n${scoped.trim()}\n}\n`;
+    return out;
+}
+const HOIST_AT_RULE = /^@(?:-webkit-|-moz-|-o-)?(?:keyframes|font-face|property)\b/i;
+const STRIP_AT_RULE = /^@(?:-webkit-|-moz-|-o-)?import\b/i;
+/** Separate top-level hoistable at-rules from the rest of a custom-CSS string. */
+function splitHoistedAtRules(css) {
+    const hoisted = [];
+    let scoped = '';
+    let i = 0;
+    const n = css.length;
+    while (i < n) {
+        if (css[i] === '@' && (HOIST_AT_RULE.test(css.slice(i)) || STRIP_AT_RULE.test(css.slice(i)))) {
+            // @import is a statement ending at ';' — consumed and DISCARDED (see emitScopedCustomCss).
+            if (STRIP_AT_RULE.test(css.slice(i))) {
+                const semi = css.indexOf(';', i);
+                const end = semi === -1 ? n : semi + 1;
+                i = end;
+                continue;
+            }
+            const open = css.indexOf('{', i);
+            if (open === -1) {
+                scoped += css.slice(i);
+                break;
+            }
+            let depth = 0;
+            let j = open;
+            for (; j < n; j++) {
+                if (css[j] === '{')
+                    depth++;
+                else if (css[j] === '}' && --depth === 0) {
+                    j++;
+                    break;
+                }
+            }
+            hoisted.push(css.slice(i, j));
+            i = j;
+            continue;
+        }
+        scoped += css[i];
+        i++;
+    }
+    return { hoisted: hoisted.join('\n'), scoped };
+}
+//# sourceMappingURL=derive.js.map

package/dist/derive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.js","sourceRoot":"","sources":["../src/derive.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview MemberJunction Theme Engine — framework-agnostic derivation of the
+ * full --mj-* token contract from a small set of brand seeds. Shared by the Angular
+ * theme builder (live preview) and a future server overlay endpoint.
+ * @module @memberjunction/theme-engine
+ */
+export * from './color.js';
+export * from './seeds.js';
+export * from './ramps.js';
+export * from './contrast.js';
+export * from './derive.js';
+export * from './logo.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview MemberJunction Theme Engine — framework-agnostic derivation of the
+ * full --mj-* token contract from a small set of brand seeds. Shared by the Angular
+ * theme builder (live preview) and a future server overlay endpoint.
+ * @module @memberjunction/theme-engine
+ */
+export * from './color.js';
+export * from './seeds.js';
+export * from './ramps.js';
+export * from './contrast.js';
+export * from './derive.js';
+export * from './logo.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/logo.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @fileoverview Logo validation for the theme pipeline (proposal 16.6). Logos are
+ * variant uploads, never recolored — so validation only checks that an upload FITS
+ * its slot (type, size, dimensions, aspect ratio) and, for SVGs, reports whether the
+ * artwork is detectably single-fill (the only case where "treat as monochrome" is
+ * offered). Framework-agnostic: no DOM, no network — it takes already-extracted file
+ * facts, so the Angular uploader and a future server endpoint share one rule set.
+ * @module @memberjunction/theme-engine
+ */
+/** A theme's logo variant URLs + header geometry, for overlay emission (16.6). */
+export interface ThemeLogos {
+    /** Logo mark for light surfaces -> --mj-logo-mark (light mode). */
+    lightMarkURL?: string;
+    /** Logo mark for dark surfaces -> --mj-logo-mark (dark mode). Enables the mode swap. */
+    darkMarkURL?: string;
+    /** Full wordmark -> --mj-logo-wordmark. */
+    wordmarkURL?: string;
+    /** Single-fill monochrome variant -> --mj-logo-mono. */
+    monochromeURL?: string;
+    /** Header mark box width in px -> --mj-logo-width. */
+    width?: number;
+    /** Header mark box height in px -> --mj-logo-height. */
+    height?: number;
+}
+/**
+ * Emit the logo overlay CSS for a theme (org-theming Phase 4). Logos are variant
+ * uploads, never recolored (16.6): dark mode *swaps artwork* via a mode-specific
+ * block, and when only one variant exists we emit a light `--mj-logo-plate-bg` in
+ * dark mode so the single mark stays legible on a plate (no filter transforms).
+ *
+ * Returns CSS scoped to `[data-theme-overlay="<id>"]` (+ a dark companion block);
+ * append it to the color overlay so one Blob carries the whole brand.
+ */
+export declare function emitLogoOverlayCss(themeId: string, logos: ThemeLogos): string;
+/** The four logo variant slots a theme can carry (16.6). */
+export type LogoSlot = 'mark' | 'wordmark' | 'monochrome';
+/** File facts the caller extracts (byte length, mime, intrinsic size, SVG source). */
+export interface LogoInput {
+    slot: LogoSlot;
+    /** MIME type, e.g. 'image/svg+xml', 'image/png', 'image/webp', 'image/jpeg'. */
+    mime: string;
+    /** File size in bytes. */
+    byteLength: number;
+    /** Raw SVG markup (when the upload is an SVG) — enables single-fill detection. */
+    svgText?: string;
+    /** Intrinsic width in px (raster pixels, or the SVG viewBox/width). */
+    width?: number;
+    /** Intrinsic height in px. */
+    height?: number;
+}
+/** Outcome of validating one upload. `ok` is false when there is any error. */
+export interface LogoValidationResult {
+    ok: boolean;
+    errors: string[];
+    warnings: string[];
+    /** True only for an SVG with at most one distinct fill/stroke color. */
+    isSingleFillSvg: boolean;
+    /** width / height when both are known. */
+    aspectRatio?: number;
+}
+/** Pull an intrinsic width/height from an SVG's viewBox (preferred) or width/height. */
+export declare function svgDimensions(svgText: string): {
+    width?: number;
+    height?: number;
+};
+/**
+ * Detect whether an SVG paints with at most one color — the only case where
+ * recoloring to a single monochrome tint is safe. `none` and `currentColor` are
+ * ignored (they carry no fixed hue); a gradient or >1 distinct color is not single-fill.
+ */
+export declare function isSingleFillSvg(svgText: string): boolean;
+/** Validate one logo upload against its slot's rules. */
+export declare function validateLogo(input: LogoInput): LogoValidationResult;
+//# sourceMappingURL=logo.d.ts.map

package/dist/logo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logo.d.ts","sourceRoot":"","sources":["../src/logo.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,kFAAkF;AAClF,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAOD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAwB7E;AAED,4DAA4D;AAC5D,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;AAE1D,sFAAsF;AACtF,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,CAAC;IACf,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,+EAA+E;AAC/E,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,wEAAwE;IACxE,eAAe,EAAE,OAAO,CAAC;IACzB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAuBD,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAMlF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAaxD;AAED,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,oBAAoB,CAiDnE"}

package/dist/logo.js

@@ -0,0 +1,137 @@
+/**
+ * @fileoverview Logo validation for the theme pipeline (proposal 16.6). Logos are
+ * variant uploads, never recolored — so validation only checks that an upload FITS
+ * its slot (type, size, dimensions, aspect ratio) and, for SVGs, reports whether the
+ * artwork is detectably single-fill (the only case where "treat as monochrome" is
+ * offered). Framework-agnostic: no DOM, no network — it takes already-extracted file
+ * facts, so the Angular uploader and a future server endpoint share one rule set.
+ * @module @memberjunction/theme-engine
+ */
+/** Escape a URL for safe embedding inside a CSS `url("...")` value. */
+function cssUrl(u) {
+    return `url("${u.replace(/["\\\n]/g, encodeURIComponent)}")`;
+}
+/**
+ * Emit the logo overlay CSS for a theme (org-theming Phase 4). Logos are variant
+ * uploads, never recolored (16.6): dark mode *swaps artwork* via a mode-specific
+ * block, and when only one variant exists we emit a light `--mj-logo-plate-bg` in
+ * dark mode so the single mark stays legible on a plate (no filter transforms).
+ *
+ * Returns CSS scoped to `[data-theme-overlay="<id>"]` (+ a dark companion block);
+ * append it to the color overlay so one Blob carries the whole brand.
+ */
+export function emitLogoOverlayCss(themeId, logos) {
+    const sel = `[data-theme-overlay="${themeId}"]`;
+    const base = [];
+    if (logos.lightMarkURL) {
+        base.push(`--mj-logo-mark: ${cssUrl(logos.lightMarkURL)};`);
+        // --mj-logo-mark-inverse is the light-on-dark artwork; fall back to the light mark.
+        base.push(`--mj-logo-mark-inverse: ${cssUrl(logos.darkMarkURL ?? logos.lightMarkURL)};`);
+    }
+    if (logos.wordmarkURL)
+        base.push(`--mj-logo-wordmark: ${cssUrl(logos.wordmarkURL)};`);
+    if (logos.monochromeURL)
+        base.push(`--mj-logo-mono: ${cssUrl(logos.monochromeURL)};`);
+    if (logos.width)
+        base.push(`--mj-logo-width: ${Math.round(logos.width)}px;`);
+    if (logos.height)
+        base.push(`--mj-logo-height: ${Math.round(logos.height)}px;`);
+    let css = base.length ? `${sel} {\n  ${base.join('\n  ')}\n}\n` : '';
+    if (logos.darkMarkURL) {
+        // Dark mode swaps to the dark-surface artwork.
+        css += `${sel}[data-theme="dark"] {\n  --mj-logo-mark: ${cssUrl(logos.darkMarkURL)};\n}\n`;
+    }
+    else if (logos.lightMarkURL) {
+        // Only a light-surface mark exists: plate it on white in dark mode so it stays legible.
+        css += `${sel}[data-theme="dark"] {\n  --mj-logo-plate-bg: #ffffff;\n}\n`;
+    }
+    return css;
+}
+const RULES = {
+    // Header mark: roughly square up to ~2:1 landscape.
+    mark: { maxBytes: 512 * 1024, rasterMinPx: 64, aspect: [0.5, 2.0] },
+    // Wordmark: wide lockup.
+    wordmark: { maxBytes: 1024 * 1024, rasterMinPx: 24, aspect: [2.0, 10.0] },
+    // Monochrome: same envelope as the mark.
+    monochrome: { maxBytes: 512 * 1024, rasterMinPx: 64, aspect: [0.5, 2.0] },
+};
+const SVG_MIME = 'image/svg+xml';
+const ACCEPTED_RASTER = ['image/png', 'image/webp', 'image/jpeg'];
+/** Pull an intrinsic width/height from an SVG's viewBox (preferred) or width/height. */
+export function svgDimensions(svgText) {
+    const vb = /viewBox\s*=\s*["']\s*[-\d.]+\s+[-\d.]+\s+([-\d.]+)\s+([-\d.]+)\s*["']/i.exec(svgText);
+    if (vb)
+        return { width: parseFloat(vb[1]), height: parseFloat(vb[2]) };
+    const w = /\bwidth\s*=\s*["']\s*([\d.]+)/i.exec(svgText);
+    const h = /\bheight\s*=\s*["']\s*([\d.]+)/i.exec(svgText);
+    return { width: w ? parseFloat(w[1]) : undefined, height: h ? parseFloat(h[1]) : undefined };
+}
+/**
+ * Detect whether an SVG paints with at most one color — the only case where
+ * recoloring to a single monochrome tint is safe. `none` and `currentColor` are
+ * ignored (they carry no fixed hue); a gradient or >1 distinct color is not single-fill.
+ */
+export function isSingleFillSvg(svgText) {
+    if (/<(linear|radial)Gradient|url\(#/i.test(svgText))
+        return false;
+    const colors = new Set();
+    const add = (raw) => {
+        if (!raw)
+            return;
+        const v = raw.trim().toLowerCase();
+        if (!v || v === 'none' || v === 'currentcolor' || v === 'transparent' || v === 'inherit')
+            return;
+        colors.add(v);
+    };
+    // fill="..."/stroke="..." attributes and fill:/stroke: within style="..."
+    for (const m of svgText.matchAll(/\b(?:fill|stroke)\s*=\s*["']([^"']+)["']/gi))
+        add(m[1]);
+    for (const m of svgText.matchAll(/(?:fill|stroke)\s*:\s*([^;"'}]+)/gi))
+        add(m[1]);
+    return colors.size <= 1;
+}
+/** Validate one logo upload against its slot's rules. */
+export function validateLogo(input) {
+    const rule = RULES[input.slot];
+    const errors = [];
+    const warnings = [];
+    const isSvg = input.mime === SVG_MIME;
+    if (!isSvg && !ACCEPTED_RASTER.includes(input.mime)) {
+        errors.push(`Unsupported file type "${input.mime}". Use SVG (preferred), PNG, or WebP.`);
+    }
+    if (input.byteLength > rule.maxBytes) {
+        errors.push(`File is ${(input.byteLength / 1024).toFixed(0)} KB; the ${input.slot} limit is ${(rule.maxBytes / 1024).toFixed(0)} KB.`);
+    }
+    let { width, height } = input;
+    if (isSvg && input.svgText && (width === undefined || height === undefined)) {
+        const d = svgDimensions(input.svgText);
+        width = width ?? d.width;
+        height = height ?? d.height;
+    }
+    if (!isSvg) {
+        warnings.push('SVG is preferred for logos — it stays crisp at every size.');
+        if (input.mime === 'image/jpeg') {
+            warnings.push('JPEG has no transparency; it will show a rectangular background on colored surfaces.');
+        }
+        if (width !== undefined && height !== undefined) {
+            if (Math.min(width, height) < rule.rasterMinPx) {
+                errors.push(`Raster logo is ${width}×${height}px; the ${input.slot} needs at least ${rule.rasterMinPx}px on the smaller side.`);
+            }
+        }
+        else {
+            warnings.push('Could not read the image dimensions to validate size/aspect ratio.');
+        }
+    }
+    let aspectRatio;
+    if (width && height) {
+        aspectRatio = width / height;
+        const [lo, hi] = rule.aspect;
+        if (aspectRatio < lo || aspectRatio > hi) {
+            errors.push(`Aspect ratio ${aspectRatio.toFixed(2)}:1 does not fit the ${input.slot} slot (expected ${lo}:1 to ${hi}:1). ` +
+                (input.slot === 'wordmark' ? 'Wordmarks should be a wide lockup.' : 'Use a squarer mark for the header.'));
+        }
+    }
+    const singleFill = isSvg && !!input.svgText && isSingleFillSvg(input.svgText);
+    return { ok: errors.length === 0, errors, warnings, isSingleFillSvg: singleFill, aspectRatio };
+}
+//# sourceMappingURL=logo.js.map

package/dist/logo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logo.js","sourceRoot":"","sources":["../src/logo.ts"],"names":[],"mappings":"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"}

package/dist/ramps.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview Perceptual ramp generation (audit G5). Each brand family carries a
+ * measured OKLCH "shape" (per-step lightness + chroma) lifted from MJ's own default
+ * ramps. A seed supplies the HUE (and a chroma scale relative to the family anchor);
+ * we re-hue the shape and rescale its chroma. Feeding MJ's own seeds back therefore
+ * reproduces MJ's ramps within rounding tolerance, while any other hue inherits MJ's
+ * proven, perceptually-uniform lightness structure.
+ * @module @memberjunction/theme-engine
+ */
+/** One step of a ramp: its numeric key (50..950) and its measured OKLCH L/C. */
+export interface RampStop {
+    step: number;
+    L: number;
+    C: number;
+}
+/** Measured shape of MJ's primary blue ramp. `anchor` is the step the seed maps to. */
+export declare const BRAND_SHAPE: RampStop[];
+/** Measured shape of MJ's accent ramp. Accent seed maps to the 400 slot. */
+export declare const ACCENT_SHAPE: RampStop[];
+/** Measured shape of MJ's tertiary cyan ramp. Tertiary seed maps to the 500 slot. */
+export declare const TERTIARY_SHAPE: RampStop[];
+/** Measured shape of MJ's slate neutral ramp. Chroma is driven by the `neutralChroma` seed. */
+export declare const NEUTRAL_SHAPE: RampStop[];
+/** Chroma of the neutral shape at its mid step, i.e. the `neutralChroma` reference point. */
+export declare const NEUTRAL_REFERENCE_CHROMA = 0.0407;
+/** The step in each brand family that its seed color represents. */
+export declare const FAMILY_ANCHOR: Record<'brand' | 'accent' | 'tertiary', number>;
+/**
+ * Re-hue and re-scale a family shape from a seed color. Every step keeps the shape's
+ * lightness; its hue becomes the seed's hue; its chroma is the shape chroma scaled so
+ * the anchor step matches the seed's chroma, times `vibrancy`.
+ */
+export declare function generateBrandRamp(shape: RampStop[], anchorStep: number, seedHex: string, vibrancy: number): Record<number, string>;
+/**
+ * The neutral ramp: shape lightness preserved, hue bled from the brand (G2), chroma
+ * scaled to the requested `neutralChroma` mid-target.
+ */
+export declare function generateNeutralRamp(brandHueDeg: number, neutralChroma: number): Record<number, string>;
+//# sourceMappingURL=ramps.d.ts.map

package/dist/ramps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ramps.d.ts","sourceRoot":"","sources":["../src/ramps.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,gFAAgF;AAChF,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,uFAAuF;AACvF,eAAO,MAAM,WAAW,EAAE,QAAQ,EAajC,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,YAAY,EAAE,QAAQ,EAWlC,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,cAAc,EAAE,QAAQ,EAWpC,CAAC;AAEF,+FAA+F;AAC/F,eAAO,MAAM,aAAa,EAAE,QAAQ,EAanC,CAAC;AAEF,6FAA6F;AAC7F,eAAO,MAAM,wBAAwB,SAAS,CAAC;AAE/C,oEAAoE;AACpE,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,OAAO,GAAG,QAAQ,GAAG,UAAU,EAAE,MAAM,CAIzE,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,QAAQ,EAAE,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUxB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOtG"}