@roxyapi/ui 0.4.1 → 0.6.0

package/src/utils/disclosure.ts

@@ -0,0 +1,62 @@
+import type { TemplateResult } from 'lit';
+import { css, html } from 'lit';
+
+/**
+ * Disclosure chevron for `<details>`/`<summary>` accordions. Replaces the
+ * browser default triangle with a thin chevron that rotates when the host
+ * `<details>` opens. Render it inside the `<summary>` and pair with
+ * {@link disclosureStyles}.
+ */
+export function chevron(): TemplateResult {
+	return html`<svg
+		class="roxy-chevron"
+		viewBox="0 0 16 16"
+		width="14"
+		height="14"
+		aria-hidden="true"
+	>
+		<path
+			d="M4 6l4 4 4-4"
+			fill="none"
+			stroke="currentColor"
+			stroke-width="1.5"
+			stroke-linecap="round"
+			stroke-linejoin="round"
+		/>
+	</svg>`;
+}
+
+/**
+ * Shared `<details>` accordion styling: hides the native disclosure triangle
+ * and rotates the {@link chevron} 180 degrees when the accordion is open.
+ * Import into any component that renders disclosure accordions so the chevron
+ * looks and behaves identically.
+ */
+export const disclosureStyles = css`
+	summary {
+		list-style: none;
+	}
+	summary::-webkit-details-marker {
+		display: none;
+	}
+	/* Explicit size: components that draw a chart set a global svg { width: 100% }
+	   rule, and an element selector beats the SVG width/height attributes. This
+	   class selector wins back the 14px icon size. */
+	.roxy-chevron {
+		flex-shrink: 0;
+		width: 14px;
+		height: 14px;
+		aspect-ratio: auto;
+		color: var(--roxy-muted, #71717a);
+		transition: transform var(--roxy-motion-duration, 200ms)
+			var(--roxy-motion-easing, ease);
+	}
+	details[open] > summary .roxy-chevron {
+		transform: rotate(180deg);
+	}
+	@media (prefers-reduced-motion: reduce) {
+		.roxy-chevron {
+			transition: none;
+		}
+	}
+`;

package/src/utils/kundli-render.ts

@@ -1,8 +1,9 @@
 import type { TemplateResult } from 'lit';
-import { html, nothing, svg } from 'lit';
+import { nothing, svg } from 'lit';
 import { PLANET_ABBR, SIGN_ABBR, SIGNS_ORDER } from '../tokens/index.js';
 import { longitudeToSignPosition } from './degree.js';
 import { capitalize } from './string.js';
+import { renderTablist } from './tablist.js';
 
 /**
  * Canonical viewBox geometry for every kundli style. The chart is drawn into a
@@ -320,6 +321,11 @@ function renderSouthCell(
 					? svg`<text class="house-num" x=${r.x + r.w - 6} y=${r.y + 12} text-anchor="end" dominant-baseline="central">${houseNum}</text>`
 					: nothing
 			}
+			${
+				isLagna
+					? svg`<text class="lagna-marker" x=${cx} y=${r.y + 26} text-anchor="middle" dominant-baseline="central">Asc</text>`
+					: nothing
+			}
 			${planets.length ? renderPlanetStack(planets, sign, cx, cy + 4, 14) : nothing}
 		</g>
 	`;
@@ -453,9 +459,15 @@ function renderNorthCell(
 	// always stays comfortably inside its triangle or diamond.
 	const rashiOffsetY = Math.min(14, Math.abs(c.y - CENTRE) * 0.45 + 6);
 	const ascOffsetY = rashiOffsetY + 12;
+	// North cells carry only a rasi number by convention. The ascendant also
+	// names its sign so the reader can see which sign rises without translating
+	// the number; other cells stay number-only.
+	const rashiLabel = isLagna
+		? `${rashiNum} · ${SIGN_ABBR[sign] ?? sign.slice(0, 2)}`
+		: `${rashiNum}`;
 	return svg`
 		<g class=${isLagna ? 'cell lagna' : 'cell'}>
-			<text class="rashi-num" x=${c.x} y=${c.y - rashiOffsetY} text-anchor="middle" dominant-baseline="central">${rashiNum}</text>
+			<text class="rashi-num" x=${c.x} y=${c.y - rashiOffsetY} text-anchor="middle" dominant-baseline="central">${rashiLabel}</text>
 			${
 				isLagna
 					? svg`<text class="lagna-marker" x=${c.x} y=${c.y - ascOffsetY} text-anchor="middle" dominant-baseline="central">Asc</text>`
@@ -705,37 +717,11 @@ export function renderKundliStyleTablist(
 	active: ChartStyle,
 	setStyle: (next: ChartStyle) => void,
 ): TemplateResult {
-	const onKeyDown = (e: KeyboardEvent) => {
-		const idx = CHART_STYLES.findIndex((s) => s.id === active);
-		if (e.key === 'ArrowRight') {
-			e.preventDefault();
-			const next = CHART_STYLES[(idx + 1) % CHART_STYLES.length];
-			if (next) setStyle(next.id);
-		} else if (e.key === 'ArrowLeft') {
-			e.preventDefault();
-			const next =
-				CHART_STYLES[(idx - 1 + CHART_STYLES.length) % CHART_STYLES.length];
-			if (next) setStyle(next.id);
-		}
-	};
-	return html`<div
-		class="kundli-tablist"
-		role="tablist"
-		aria-label="Kundli style"
-		@keydown=${onKeyDown}
-	>
-		${CHART_STYLES.map(
-			(s) => html`<button
-				type="button"
-				class="kundli-tab"
-				role="tab"
-				id="kundli-tab-${s.id}"
-				aria-selected=${active === s.id ? 'true' : 'false'}
-				tabindex=${active === s.id ? '0' : '-1'}
-				@click=${() => setStyle(s.id)}
-			>
-				${s.label}
-			</button>`,
-		)}
-	</div>`;
+	return renderTablist({
+		items: CHART_STYLES,
+		active,
+		onSelect: setStyle,
+		label: 'Kundli style',
+		idPrefix: 'kundli',
+	});
 }

package/src/utils/kundli-styles.ts

@@ -28,37 +28,6 @@ export const kundliStyles = css`
 		font-weight: var(--roxy-weight-bold, 600);
 		margin: 0;
 	}
-	.kundli-tablist {
-		display: inline-flex;
-		gap: 2px;
-		border-bottom: 2px solid var(--roxy-border, #e4e4e7);
-	}
-	.kundli-tab {
-		padding: var(--roxy-space-xs, 0.25rem) var(--roxy-space-md, 1rem);
-		font-size: var(--roxy-text-sm, 0.875rem);
-		background: none;
-		border: none;
-		border-bottom: 2px solid transparent;
-		margin-bottom: -2px;
-		cursor: pointer;
-		color: var(--roxy-muted, #71717a);
-		font-family: inherit;
-		transition: color var(--roxy-motion-duration, 200ms)
-			var(--roxy-motion-easing, ease);
-	}
-	.kundli-tab[aria-selected='true'] {
-		color: var(--roxy-accent-fg, #b45309);
-		border-bottom-color: var(--roxy-accent, #f59e0b);
-		font-weight: var(--roxy-weight-bold, 600);
-	}
-	.kundli-tab:hover:not([aria-selected='true']) {
-		color: var(--roxy-fg, #0a0a0a);
-	}
-	.kundli-tab:focus-visible {
-		outline: 2px solid var(--roxy-ring, rgba(245, 158, 11, 0.4));
-		outline-offset: 2px;
-		border-radius: 4px;
-	}
 	svg {
 		display: block;
 		width: 100%;

package/src/utils/markup-data.ts

@@ -0,0 +1,115 @@
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+
+/**
+ * Marker class on the inline JSON script a server emits inside a component.
+ *
+ * @example
+ * ```html
+ * <roxy-natal-chart>
+ *   <script type="application/json" class="roxy-data">{ ...response... }</script>
+ * </roxy-natal-chart>
+ * ```
+ */
+const ROXY_DATA_CLASS = 'roxy-data';
+
+/**
+ * True when the element is a `<script type="application/json">`. Uses tag name and attribute rather than `instanceof HTMLScriptElement` so the check holds in every DOM implementation, including server-rendered and hydration runtimes where the constructor global may be absent.
+ */
+function isJsonScript(el: Element): boolean {
+	return (
+		el.nodeName === 'SCRIPT' && el.getAttribute('type') === 'application/json'
+	);
+}
+
+/**
+ * Host shape the controller drives: any reactive element that exposes a public `data` slot. The controller only writes `data` when the host left it unset, so the JavaScript property path always wins.
+ */
+interface DataHost extends ReactiveControllerHost, HTMLElement {
+	data?: unknown;
+}
+
+/**
+ * Reactive controller that lets a component hydrate its `data` from embedded markup when no `data` property was assigned in JavaScript.
+ *
+ * @remarks
+ * The server-side and cached-render model: a backend renders the RoxyAPI response into a direct-child `<script type="application/json" class="roxy-data">` element, ships static HTML, and never runs per-element JavaScript to assign a property. On connect this controller reads that script, parses it, and feeds the result to the host. The JavaScript property path is untouched and authoritative: if `host.data` already holds a value when the host connects, the controller does nothing and the markup is ignored.
+ *
+ * Source resolution order on connect, first hit wins:
+ *
+ * 1. `host.data` already set in JavaScript -> leave it, read nothing.
+ * 2. A direct-child `<script type="application/json" class="roxy-data">` -> parse and use. Direct-child only, so a nested component's own script is never read by an ancestor.
+ *
+ * Fetching from a URL is intentionally unsupported: that would require a browser-visible key and breaks the server-rendered, cached model these consumers rely on.
+ *
+ * Timing: {@link hostConnected} runs inside the host `connectedCallback`. For an element parsed from server HTML, its direct children are present by the time the custom element upgrades and connects, so the script is readable here. For an element created with `document.createElement` and connected before any child is appended, there is nothing to read and the property path is the only source, which is exactly the existing behavior.
+ *
+ * Failure is safe: malformed JSON or a missing script leaves `host.data` untouched, so the host renders its normal empty state.
+ *
+ * Reading the script never mutates it, and only the marked script is touched, so any sibling fallback markup a server nested inside the element (for no-JavaScript, AMP, or crawler rendering) is left in place.
+ *
+ * @example
+ * ```ts
+ * import { MarkupDataController } from '../utils/markup-data.js';
+ *
+ * export class RoxyExample extends LitElement {
+ *   constructor() {
+ *     super();
+ *     new MarkupDataController(this);
+ *   }
+ *
+ *   @property({ attribute: false })
+ *   data: ExampleResponse | null = null;
+ * }
+ * ```
+ */
+export class MarkupDataController<T = unknown> implements ReactiveController {
+	private readonly host: DataHost;
+
+	constructor(host: DataHost) {
+		this.host = host;
+		host.addController(this);
+	}
+
+	hostConnected() {
+		// Property path wins. If the consumer (React, vanilla `.data =`, the
+		// widgets script, an MCP agent) already set data, never look at markup.
+		if (this.host.data != null) return;
+
+		const parsed = this.read();
+		if (parsed === undefined) return;
+
+		this.host.data = parsed as T;
+		this.host.requestUpdate();
+	}
+
+	/**
+	 * Resolve the embedded payload. Returns `undefined` when there is nothing valid to read so the caller can leave `host.data` untouched.
+	 */
+	private read(): T | undefined {
+		const inline = this.findInlineScript();
+		return inline ? this.parse(inline.textContent) : undefined;
+	}
+
+	/**
+	 * Direct-child `<script type="application/json" class="roxy-data">`. Scoped to immediate children so a nested data-driven component never has its script read by an ancestor, and so sibling fallback markup is ignored.
+	 */
+	private findInlineScript(): Element | null {
+		for (const child of Array.from(this.host.children)) {
+			if (isJsonScript(child) && child.classList.contains(ROXY_DATA_CLASS)) {
+				return child;
+			}
+		}
+		return null;
+	}
+
+	private parse(text: string | null): T | undefined {
+		if (!text?.trim()) return undefined;
+		try {
+			return JSON.parse(text) as T;
+		} catch {
+			// Malformed embedded JSON: fail safe, leave the host empty state in
+			// place rather than throwing during connect.
+			return undefined;
+		}
+	}
+}

package/src/utils/tablist.ts

@@ -0,0 +1,124 @@
+import type { TemplateResult } from 'lit';
+import { css, html, nothing } from 'lit';
+
+/** A single tab in a {@link renderTablist} strip. */
+export interface TablistItem<T extends string = string> {
+	id: T;
+	label: string;
+}
+
+/**
+ * Shared styling for every horizontal tab strip in the library (natal chart
+ * views, transits, kundli styles). Keeping one rule set means the tabs look
+ * identical everywhere and theme through the same --roxy-* tokens.
+ */
+export const tablistStyles = css`
+	.roxy-tablist {
+		display: flex;
+		gap: 2px;
+		border-bottom: 2px solid var(--roxy-border, #e4e4e7);
+	}
+	.roxy-tab {
+		padding: var(--roxy-space-xs, 0.25rem) var(--roxy-space-md, 1rem);
+		font-size: var(--roxy-text-sm, 0.875rem);
+		background: none;
+		border: none;
+		border-bottom: 2px solid transparent;
+		margin-bottom: -2px;
+		cursor: pointer;
+		color: var(--roxy-muted, #71717a);
+		font-family: inherit;
+		transition: color var(--roxy-motion-duration, 200ms)
+			var(--roxy-motion-easing, ease);
+	}
+	.roxy-tab[aria-selected='true'] {
+		color: var(--roxy-accent-fg, #b45309);
+		border-bottom-color: var(--roxy-accent, #f59e0b);
+		font-weight: var(--roxy-weight-bold, 600);
+	}
+	.roxy-tab:hover:not([aria-selected='true']) {
+		color: var(--roxy-fg, #0a0a0a);
+	}
+	.roxy-tab:focus-visible {
+		outline: 2px solid var(--roxy-ring, rgba(245, 158, 11, 0.4));
+		outline-offset: 2px;
+		border-radius: 4px;
+	}
+`;
+
+/**
+ * Render a WAI-ARIA tablist. The host component owns the active-tab state; this
+ * helper draws the buttons, wires click plus Left/Right arrow navigation with a
+ * roving tabindex, and moves focus to the newly selected tab. Pair with
+ * {@link tablistStyles}.
+ *
+ * Pass `controls: true` when each tab governs a sibling
+ * `<div role="tabpanel" id="${idPrefix}-panel-${id}">` so the buttons advertise
+ * `aria-controls`. Omit it for tablists that swap a single rendered view in
+ * place with no separate panel element (the kundli style switch).
+ *
+ * @example
+ * ```ts
+ * renderTablist({
+ *   items: [{ id: 'wheel', label: 'Wheel' }, { id: 'grid', label: 'Aspect grid' }],
+ *   active: this.view,
+ *   onSelect: (v) => { this.view = v; },
+ *   label: 'Natal chart views',
+ *   idPrefix: 'natal',
+ *   controls: true,
+ * })
+ * ```
+ */
+export function renderTablist<T extends string>(opts: {
+	items: ReadonlyArray<TablistItem<T>>;
+	active: T;
+	onSelect: (id: T) => void;
+	label: string;
+	idPrefix: string;
+	controls?: boolean;
+}): TemplateResult {
+	const { items, active, onSelect, label, idPrefix, controls = false } = opts;
+	const onKeyDown = (e: KeyboardEvent) => {
+		if (e.key !== 'ArrowRight' && e.key !== 'ArrowLeft') return;
+		e.preventDefault();
+		const idx = items.findIndex((it) => it.id === active);
+		if (idx === -1) return;
+		const delta = e.key === 'ArrowRight' ? 1 : -1;
+		const next = items[(idx + delta + items.length) % items.length];
+		if (!next) return;
+		onSelect(next.id);
+		const root = (e.currentTarget as HTMLElement).getRootNode() as
+			| ShadowRoot
+			| Document;
+		requestAnimationFrame(() => {
+			root
+				.querySelector<HTMLButtonElement>(`#${idPrefix}-tab-${next.id}`)
+				?.focus();
+		});
+	};
+	return html`<div
+		class="roxy-tablist"
+		role="tablist"
+		aria-label=${label}
+		@keydown=${onKeyDown}
+	>
+		${items.map(
+			(it) => html`<button
+				type="button"
+				class="roxy-tab"
+				role="tab"
+				id="${idPrefix}-tab-${it.id}"
+				aria-selected=${active === it.id ? 'true' : 'false'}
+				aria-controls=${
+					// Only the active panel is rendered, so only the active tab points
+					// at a live element; otherwise aria-controls would dangle.
+					controls && active === it.id ? `${idPrefix}-panel-${it.id}` : nothing
+				}
+				tabindex=${active === it.id ? '0' : '-1'}
+				@click=${() => onSelect(it.id)}
+			>
+				${it.label}
+			</button>`,
+		)}
+	</div>`;
+}

package/src/version.ts

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