@roxyapi/ui 0.12.1 → 0.12.3

package/dist/types/types.gen.d.ts

@@ -866,11 +866,11 @@ export type TransitsRequest = {
      */
     natalChart?: {
         /**
-         * Date in YYYY-MM-DD format.
+         * Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected.
          */
         date: string;
         /**
-         * Time in 24-hour HH:MM:SS format.
+         * Time in 24-hour format. Seconds are optional and default to 00 (14:30 becomes 14:30:00); a single-digit hour is zero-padded. Out-of-range values are rejected.
          */
         time: string;
         latitude: number;
@@ -2749,7 +2749,7 @@ export type BirthChartResponse = {
         };
     };
     /**
-     * Twelve classical yogas detected against this chart: Gajakesari (three-rule parashara definition), Sunapha, Anapha, Dhurdhura, Kemadruma, Chandra Mangala, Budha-Aditya, and the five Pancha Mahapurusha (Ruchaka, Bhadra, Hamsa, Malavya, Sasa). Each entry carries an `id` (matches `GET /yoga/{id}` for full glossary lookup), a `present` boolean, and classical-text `evidence` for the rule that triggered or failed.
+     * Twelve classical yogas detected against this chart: Gajakesari (three-rule parashara definition), Sunapha, Anapha, Dhurdhura, Kemadruma, Chandra Mangala, Budha-Aditya, and the five Pancha Mahapurusha (Ruchaka, Bhadra, Hamsa, Malavya, Sasa). Each entry carries an `id` (matches `GET /yoga/{id}` for full glossary lookup), a `present` boolean, a `quality` (Positive, Negative, or Both = auspicious, inauspicious, or context-dependent), and classical-text `evidence` for the rule that triggered or failed.
      */
     yogas?: Array<{
         /**
@@ -3586,7 +3586,7 @@ export type SadhesatiRequest = {
 };
 export type YogaDetectResponse = {
     /**
-     * Array of 12 detected yogas. Every entry carries a present boolean; filter on present === true for active yogas. Evidence text names the rule that triggered or failed.
+     * Array of 12 detected yogas. Every entry carries a `present` boolean and a `quality` (Positive, Negative, or Both = auspicious, inauspicious, or context-dependent); filter on present === true for active yogas. Evidence text names the rule that triggered or failed.
      */
     yogas: Array<{
         /**
@@ -4703,11 +4703,11 @@ export type KpPlanetsIntervalResponse = {
 };
 export type KpPlanetsIntervalRequest = {
     /**
-     * Start datetime in ISO 8601 format. Always interpreted as local time when a non-zero timezone is provided (Z suffix is ignored). With timezone 0, Z suffix is treated as UTC.
+     * Start datetime in ISO 8601 (YYYY-MM-DDTHH:MM:SS). Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC.
      */
     startDatetime: string;
     /**
-     * End datetime in ISO 8601 format. Maximum 7 days from start. Always interpreted as local time when a non-zero timezone is provided (Z suffix is ignored).
+     * End datetime in ISO 8601 (YYYY-MM-DDTHH:MM:SS). Maximum 7 days from start. Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC.
      */
     endDatetime: string;
     /**
@@ -14042,7 +14042,7 @@ export type GetBasicPanchangResponse = GetBasicPanchangResponses[keyof GetBasicP
 export type GetDetailedPanchangData = {
     body?: {
         /**
-         * Date in YYYY-MM-DD format.
+         * Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected.
          */
         date: string;
         /**
@@ -14596,7 +14596,7 @@ export type GetDetailedPanchangResponses = {
          */
         panchaka: {
             /**
-             * Whether Panchaka is in force at sunrise, the panchang day reference. Can be false while startsAt and endsAt are populated when Panchaka begins later in the day.
+             * True when Panchaka is in effect on this date, whether it is already running at sunrise or begins later in the day, in which case startsAt and endsAt give the window. False only when no Panchaka touches this date.
              */
             active: boolean;
             /**
@@ -14613,11 +14613,11 @@ export type GetDetailedPanchangResponses = {
             endsAt: string;
         };
         /**
-         * Bhadra (Vishti Karana), the 7th movable karana, avoided for all auspicious activities. Bhadra recurs roughly every 3 to 5 days and lasts about half a tithi, so most occurrences begin after sunrise rather than at it. startsAt and endsAt report the Bhadra beginning on this date regardless of whether it is active at sunrise.
+         * Bhadra (Vishti Karana), the 7th movable karana, avoided for all auspicious activities. Bhadra recurs roughly every 3 to 5 days and lasts about half a tithi. active is true whenever a Bhadra is attributed to this date; startsAt and endsAt give the window, which may end on the next calendar day.
          */
         bhadra: {
             /**
-             * Whether Bhadra (Vishti Karana) is in force at sunrise, the panchang day reference moment. Can be false while startsAt and endsAt are populated when Bhadra begins later in the day.
+             * True when a Bhadra (Vishti Karana) occurs on this date, in which case startsAt and endsAt give its window. False only when no Bhadra begins on this date.
              */
             active: boolean;
             /**
@@ -14713,7 +14713,7 @@ export type GetDetailedPanchangResponse = GetDetailedPanchangResponses[keyof Get
 export type GetChoghadiyaData = {
     body?: {
         /**
-         * Date in YYYY-MM-DD format.
+         * Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected.
          */
         date: string;
         /**
@@ -14897,7 +14897,7 @@ export type GetChoghadiyaResponse = GetChoghadiyaResponses[keyof GetChoghadiyaRe
 export type GetHoraData = {
     body?: {
         /**
-         * Date in YYYY-MM-DD format.
+         * Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected.
          */
         date: string;
         /**
@@ -16320,7 +16320,7 @@ export type GetKpRulingPlanetsData = {
          */
         timezone?: number | string;
         /**
-         * ISO 8601 datetime for ruling planets. Defaults to current time. Always interpreted as local time when a non-zero timezone is provided (Z suffix is ignored).
+         * ISO 8601 datetime (YYYY-MM-DDTHH:MM:SS) for ruling planets. Defaults to current time. Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC.
          */
         datetime?: string;
         /**
@@ -16452,11 +16452,11 @@ export type GetKpRulingPlanetsResponse = GetKpRulingPlanetsResponses[keyof GetKp
 export type GetKpRulingIntervalData = {
     body?: {
         /**
-         * Start of the interval range in ISO 8601 format. Always interpreted as local time when a non-zero timezone is provided (Z suffix is ignored).
+         * Start of the interval range in ISO 8601 (YYYY-MM-DDTHH:MM:SS). Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC.
          */
         startDatetime: string;
         /**
-         * End of the interval range in ISO 8601 format. Always interpreted as local time when a non-zero timezone is provided (Z suffix is ignored).
+         * End of the interval range in ISO 8601 (YYYY-MM-DDTHH:MM:SS). Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC.
          */
         endDatetime: string;
         /**
@@ -21156,7 +21156,7 @@ export type CalculatePersonalDayData = {
          */
         day: number;
         /**
-         * Target date in YYYY-MM-DD format (defaults to today)
+         * Target date in YYYY-MM-DD format. Defaults to today (UTC).
          */
         targetDate?: string;
     };
@@ -33097,7 +33097,7 @@ export type GetCrystalPairingsData = {
     body?: never;
     path: {
         /**
-         * URL-safe crystal identifier to find pairings for (e.g., "amethyst", "rose-quartz").
+         * URL-safe crystal identifier to find pairings for, case-insensitive (e.g., "amethyst", "Amethyst", "rose-quartz" all resolve).
          */
         id: string;
     };
@@ -34026,7 +34026,7 @@ export type GetCrystalData = {
     body?: never;
     path: {
         /**
-         * URL-safe crystal identifier (e.g., "amethyst", "rose-quartz", "black-tourmaline"). Must match an entry in the database.
+         * URL-safe crystal identifier, case-insensitive (e.g., "amethyst", "Amethyst", "rose-quartz" all resolve). Must match an entry in the database.
          */
         id: string;
     };

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const ROXY_UI_VERSION = "0.12.1";
+export declare const ROXY_UI_VERSION = "0.12.3";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roxyapi/ui",
-  "version": "0.12.1",
+  "version": "0.12.3",
   "description": "Web components for the RoxyAPI catalog. Drop-in charts, tables, cards, forms for astrology, tarot, numerology, biorhythm, I Ching, crystals, dreams, angel numbers, and more. One key, beautiful in 30 minutes.",
   "type": "module",
   "main": "./dist/index.cjs",

package/src/components/data.ts

@@ -2,6 +2,7 @@ import { css, html, nothing, type TemplateResult } from 'lit';
 import { customElement, property } from 'lit/decorators.js';
 import { RoxyDataElement } from '../utils/base-element.js';
 import { baseStyles } from '../utils/base-styles.js';
+import { formatDate, formatNumber, formatTime } from '../utils/format.js';
 import { humanize } from '../utils/string.js';
 
 /**
@@ -13,19 +14,31 @@ import { humanize } from '../utils/string.js';
  *   1. Primitive (string, number, boolean) -> single line.
  *   2. Array of primitives -> chip list.
  *   3. Array of objects with shared keys -> table.
- *   4. Object with title-like field -> card with key/value rows.
+ *   4. Object with title-like field -> card with key/value rows; object and
+ *      object-array values promote to full-width sections below the rows so
+ *      nested tables keep the whole container width.
  *   5. Otherwise -> definition list of all keys.
  *
+ * Scalar display rules (shared by rows, chips, and table cells): numbers
+ * round to 2 decimals, booleans read Yes/No, ISO dates and datetimes format
+ * for the locale, SCREAMING_SNAKE enums humanize, http(s) strings link out.
+ *
  * When a schema declares an `x-roxy-ui` hint, a future dispatcher can opt
  * into a hand-tuned component instead of this fallback.
  */
 
 type Json = string | number | boolean | null | Json[] | { [key: string]: Json };
+type Scalar = string | number | boolean;
 
 const TITLE_KEYS = ['title', 'name', 'label', 'heading', 'overview', 'summary'];
 const IMAGE_KEYS = ['imageUrl', 'image', 'icon', 'symbol'];
 const SKIP_KEYS = ['imageUrl', 'image']; // rendered separately, not in body rows
 
+const ISO_DATE =
+	/^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:\d{2})?)?$/;
+const ENUM_STRING = /^[A-Z0-9]+(_[A-Z0-9]+)+$/;
+const LINK_STRING = /^https?:\/\//;
+
 // Hard cap on recursion. Real RoxyAPI responses nest at most 5-6 deep; anything
 // deeper is either a circular reference (which would otherwise infinite-loop)
 // or a payload too rich for the generic fallback to render usefully. The
@@ -34,6 +47,21 @@ const SKIP_KEYS = ['imageUrl', 'image']; // rendered separately, not in body row
 // this same class without a separate import.
 const MAX_DEPTH = 6;
 
+function isPrimitive(value: Json | undefined): value is Scalar | null {
+	return (
+		value === null || ['string', 'number', 'boolean'].includes(typeof value)
+	);
+}
+
+/** Object or object-bearing array: needs full width, never fits a dl value cell. */
+function isComplex(value: Json): boolean {
+	return (
+		value !== null &&
+		typeof value === 'object' &&
+		!(Array.isArray(value) && value.every(isPrimitive))
+	);
+}
+
 @customElement('roxy-data')
 export class RoxyData extends RoxyDataElement<Json> {
 	static styles = [
@@ -47,6 +75,10 @@ export class RoxyData extends RoxyDataElement<Json> {
 				box-shadow: var(--roxy-shadow-sm);
 			}
 
+			.roxy-card a {
+				color: var(--roxy-accent-ink, #b45309);
+			}
+
 			.roxy-title {
 				font-size: var(--roxy-text-lg, 1.125rem);
 				font-weight: var(--roxy-weight-bold, 600);
@@ -95,6 +127,9 @@ export class RoxyData extends RoxyDataElement<Json> {
 				font-size: var(--roxy-text-xs, 0.75rem);
 			}
 
+			.roxy-table-wrap {
+				overflow-x: auto;
+			}
 			table.roxy-table {
 				width: 100%;
 				border-collapse: collapse;
@@ -106,6 +141,8 @@ export class RoxyData extends RoxyDataElement<Json> {
 				padding: var(--roxy-space-sm, 0.5rem);
 				text-align: left;
 				text-transform: none;
+				word-break: normal;
+				overflow-wrap: normal;
 			}
 			table.roxy-table th {
 				color: var(--roxy-muted, #71717a);
@@ -113,6 +150,7 @@ export class RoxyData extends RoxyDataElement<Json> {
 				text-transform: capitalize;
 				font-size: var(--roxy-text-xs, 0.75rem);
 				letter-spacing: 0.04em;
+				white-space: nowrap;
 			}
 
 			.roxy-image {
@@ -123,7 +161,7 @@ export class RoxyData extends RoxyDataElement<Json> {
 			}
 
 			.roxy-section {
-				margin-bottom: var(--roxy-space-md, 1rem);
+				margin-top: var(--roxy-space-md, 1rem);
 			}
 			.roxy-section h4 {
 				font-size: var(--roxy-text-sm, 0.875rem);
@@ -143,7 +181,9 @@ export class RoxyData extends RoxyDataElement<Json> {
 
 	protected renderData(data: Json) {
 		if (this.depth >= MAX_DEPTH) {
-			return html`<div class="roxy-empty" role="status">…</div>`;
+			return html`<div class="roxy-empty" role="status">
+				Nested data omitted
+			</div>`;
 		}
 		return html`<div class="roxy-card" aria-label="Generic data display">
 			${this.renderValue(data)}
@@ -152,10 +192,7 @@ export class RoxyData extends RoxyDataElement<Json> {
 
 	private renderValue(value: Json): TemplateResult | typeof nothing {
 		if (value === null || value === undefined) return nothing;
-		if (typeof value === 'string') return html`<p>${value}</p>`;
-		if (typeof value === 'number' || typeof value === 'boolean') {
-			return html`<p>${String(value)}</p>`;
-		}
+		if (isPrimitive(value)) return html`<p>${this.scalarTemplate(value)}</p>`;
 		if (Array.isArray(value)) return this.renderArray(value);
 		return this.renderObject(value as Record<string, Json>);
 	}
@@ -164,13 +201,8 @@ export class RoxyData extends RoxyDataElement<Json> {
 		if (arr.length === 0) {
 			return html`<div class="roxy-empty" role="status">Empty list</div>`;
 		}
-		const allPrimitive = arr.every(
-			(v) => v === null || ['string', 'number', 'boolean'].includes(typeof v),
-		);
-		if (allPrimitive) {
-			return html`<ul class="roxy-chips">
-				${arr.map((v) => html`<li>${String(v)}</li>`)}
-			</ul>`;
+		if (arr.every(isPrimitive)) {
+			return this.renderChips(arr as (Scalar | null)[]);
 		}
 		const allObjects = arr.every(
 			(v) => v !== null && typeof v === 'object' && !Array.isArray(v),
@@ -181,22 +213,37 @@ export class RoxyData extends RoxyDataElement<Json> {
 		</ol>`;
 	}
 
+	private renderChips(arr: (Scalar | null)[]): TemplateResult {
+		return html`<ul class="roxy-chips">
+			${arr
+				.filter((v): v is Scalar => v !== null)
+				.map((v) => html`<li>${this.formatScalar(v)}</li>`)}
+		</ul>`;
+	}
+
 	private renderTable(rows: Record<string, Json>[]): TemplateResult {
 		const keys = this.collectKeys(rows);
-		return html`<table class="roxy-table" role="table">
-			<thead>
-				<tr>
-					${keys.map((k) => html`<th>${humanize(k)}</th>`)}
-				</tr>
-			</thead>
-			<tbody>
-				${rows.map(
-					(row) => html`<tr>
-						${keys.map((k) => html`<td>${this.formatPrimitive(row[k])}</td>`)}
-					</tr>`,
-				)}
-			</tbody>
-		</table>`;
+		return html`<div
+			class="roxy-table-wrap"
+			role="group"
+			aria-label="Data table"
+			tabindex="0"
+		>
+			<table class="roxy-table" role="table">
+				<thead>
+					<tr>
+						${keys.map((k) => html`<th>${humanize(k)}</th>`)}
+					</tr>
+				</thead>
+				<tbody>
+					${rows.map(
+						(row) => html`<tr>
+							${keys.map((k) => html`<td>${this.renderCell(row[k])}</td>`)}
+						</tr>`,
+					)}
+				</tbody>
+			</table>
+		</div>`;
 	}
 
 	private renderObject(obj: Record<string, Json>): TemplateResult {
@@ -209,7 +256,7 @@ export class RoxyData extends RoxyDataElement<Json> {
 			titleKey !== 'summary' && typeof obj.summary === 'string'
 				? 'summary'
 				: null;
-		const rows = Object.entries(obj).filter(
+		const entries = Object.entries(obj).filter(
 			([k, v]) =>
 				k !== titleKey &&
 				k !== summaryKey &&
@@ -217,6 +264,11 @@ export class RoxyData extends RoxyDataElement<Json> {
 				v !== null &&
 				v !== undefined,
 		);
+		// Scalars and primitive arrays fit the two-column rows; objects and
+		// object arrays promote to full-width sections so nested tables are
+		// not squeezed into the value column.
+		const rows = entries.filter(([, v]) => !isComplex(v));
+		const sections = entries.filter(([, v]) => isComplex(v));
 
 		return html`
 			${
@@ -243,34 +295,64 @@ export class RoxyData extends RoxyDataElement<Json> {
 					</dl>`
 					: nothing
 			}
+			${sections.map(
+				([k, v]) => html`<div class="roxy-section">
+					<h4>${humanize(k)}</h4>
+					${this.renderField(v)}
+				</div>`,
+			)}
 		`;
 	}
 
 	private renderField(value: Json): TemplateResult | string {
 		if (value === null || value === undefined) return '';
-		if (typeof value === 'string') return value;
-		if (typeof value === 'number' || typeof value === 'boolean')
-			return String(value);
-		if (Array.isArray(value)) {
-			const allPrimitive = value.every((v) =>
-				['string', 'number', 'boolean'].includes(typeof v),
-			);
-			if (allPrimitive) {
-				return html`<ul class="roxy-chips">
-					${value.map((v) => html`<li>${String(v)}</li>`)}
-				</ul>`;
-			}
+		if (isPrimitive(value)) return html`${this.scalarTemplate(value)}`;
+		if (Array.isArray(value) && value.every(isPrimitive)) {
+			return this.renderChips(value as (Scalar | null)[]);
 		}
 		return html`<roxy-data .data=${value} .depth=${this.depth + 1}></roxy-data>`;
 	}
 
-	private formatPrimitive(value: Json | undefined): string {
+	private renderCell(value: Json | undefined): TemplateResult | string {
 		if (value === null || value === undefined) return '';
-		if (typeof value === 'string') return value;
-		if (typeof value === 'number' || typeof value === 'boolean')
-			return String(value);
-		if (Array.isArray(value)) return value.map(String).join(', ');
-		return JSON.stringify(value);
+		if (isPrimitive(value)) return this.scalarTemplate(value);
+		if (Array.isArray(value) && value.every(isPrimitive)) {
+			return (value as (Scalar | null)[])
+				.filter((v): v is Scalar => v !== null)
+				.map((v) => this.formatScalar(v))
+				.join(', ');
+		}
+		// Nested object or object array inside a row: recurse instead of
+		// stringifying to [object Object]. `bare` drops the card surface so
+		// the cell does not paint a card inside a cell.
+		return html`<roxy-data
+			bare
+			.data=${value}
+			.depth=${this.depth + 1}
+		></roxy-data>`;
+	}
+
+	private scalarTemplate(value: Scalar): TemplateResult | string {
+		if (typeof value === 'string' && LINK_STRING.test(value)) {
+			return html`<a href=${value} target="_blank" rel="noopener noreferrer"
+				>${value}</a
+			>`;
+		}
+		return this.formatScalar(value);
+	}
+
+	private formatScalar(value: Scalar): string {
+		if (typeof value === 'number') {
+			return formatNumber(value, 2) || String(value);
+		}
+		if (typeof value === 'boolean') return value ? 'Yes' : 'No';
+		if (ISO_DATE.test(value)) {
+			const time = formatTime(value);
+			const date = formatDate(value);
+			return time ? `${date}, ${time}` : date;
+		}
+		if (ENUM_STRING.test(value)) return humanize(value.toLowerCase());
+		return value;
 	}
 
 	private collectKeys(rows: Record<string, Json>[]): string[] {

package/src/types/types.gen.ts

@@ -877,11 +877,11 @@ export type TransitsRequest = {
      */
     natalChart?: {
         /**
-         * Date in YYYY-MM-DD format.
+         * Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected.
          */
         date: string;
         /**
-         * Time in 24-hour HH:MM:SS format.
+         * Time in 24-hour format. Seconds are optional and default to 00 (14:30 becomes 14:30:00); a single-digit hour is zero-padded. Out-of-range values are rejected.
          */
         time: string;
         latitude: number;
@@ -2779,7 +2779,7 @@ export type BirthChartResponse = {
         };
     };
     /**
-     * Twelve classical yogas detected against this chart: Gajakesari (three-rule parashara definition), Sunapha, Anapha, Dhurdhura, Kemadruma, Chandra Mangala, Budha-Aditya, and the five Pancha Mahapurusha (Ruchaka, Bhadra, Hamsa, Malavya, Sasa). Each entry carries an `id` (matches `GET /yoga/{id}` for full glossary lookup), a `present` boolean, and classical-text `evidence` for the rule that triggered or failed.
+     * Twelve classical yogas detected against this chart: Gajakesari (three-rule parashara definition), Sunapha, Anapha, Dhurdhura, Kemadruma, Chandra Mangala, Budha-Aditya, and the five Pancha Mahapurusha (Ruchaka, Bhadra, Hamsa, Malavya, Sasa). Each entry carries an `id` (matches `GET /yoga/{id}` for full glossary lookup), a `present` boolean, a `quality` (Positive, Negative, or Both = auspicious, inauspicious, or context-dependent), and classical-text `evidence` for the rule that triggered or failed.
      */
     yogas?: Array<{
         /**
@@ -3632,7 +3632,7 @@ export type SadhesatiRequest = {
 
 export type YogaDetectResponse = {
     /**
-     * Array of 12 detected yogas. Every entry carries a present boolean; filter on present === true for active yogas. Evidence text names the rule that triggered or failed.
+     * Array of 12 detected yogas. Every entry carries a `present` boolean and a `quality` (Positive, Negative, or Both = auspicious, inauspicious, or context-dependent); filter on present === true for active yogas. Evidence text names the rule that triggered or failed.
      */
     yogas: Array<{
         /**
@@ -4765,11 +4765,11 @@ export type KpPlanetsIntervalResponse = {
 
 export type KpPlanetsIntervalRequest = {
     /**
-     * Start datetime in ISO 8601 format. Always interpreted as local time when a non-zero timezone is provided (Z suffix is ignored). With timezone 0, Z suffix is treated as UTC.
+     * Start datetime in ISO 8601 (YYYY-MM-DDTHH:MM:SS). Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC.
      */
     startDatetime: string;
     /**
-     * End datetime in ISO 8601 format. Maximum 7 days from start. Always interpreted as local time when a non-zero timezone is provided (Z suffix is ignored).
+     * End datetime in ISO 8601 (YYYY-MM-DDTHH:MM:SS). Maximum 7 days from start. Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC.
      */
     endDatetime: string;
     /**
@@ -14341,7 +14341,7 @@ export type GetBasicPanchangResponse = GetBasicPanchangResponses[keyof GetBasicP
 export type GetDetailedPanchangData = {
     body?: {
         /**
-         * Date in YYYY-MM-DD format.
+         * Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected.
          */
         date: string;
         /**
@@ -14898,7 +14898,7 @@ export type GetDetailedPanchangResponses = {
          */
         panchaka: {
             /**
-             * Whether Panchaka is in force at sunrise, the panchang day reference. Can be false while startsAt and endsAt are populated when Panchaka begins later in the day.
+             * True when Panchaka is in effect on this date, whether it is already running at sunrise or begins later in the day, in which case startsAt and endsAt give the window. False only when no Panchaka touches this date.
              */
             active: boolean;
             /**
@@ -14915,11 +14915,11 @@ export type GetDetailedPanchangResponses = {
             endsAt: string;
         };
         /**
-         * Bhadra (Vishti Karana), the 7th movable karana, avoided for all auspicious activities. Bhadra recurs roughly every 3 to 5 days and lasts about half a tithi, so most occurrences begin after sunrise rather than at it. startsAt and endsAt report the Bhadra beginning on this date regardless of whether it is active at sunrise.
+         * Bhadra (Vishti Karana), the 7th movable karana, avoided for all auspicious activities. Bhadra recurs roughly every 3 to 5 days and lasts about half a tithi. active is true whenever a Bhadra is attributed to this date; startsAt and endsAt give the window, which may end on the next calendar day.
          */
         bhadra: {
             /**
-             * Whether Bhadra (Vishti Karana) is in force at sunrise, the panchang day reference moment. Can be false while startsAt and endsAt are populated when Bhadra begins later in the day.
+             * True when a Bhadra (Vishti Karana) occurs on this date, in which case startsAt and endsAt give its window. False only when no Bhadra begins on this date.
              */
             active: boolean;
             /**
@@ -15017,7 +15017,7 @@ export type GetDetailedPanchangResponse = GetDetailedPanchangResponses[keyof Get
 export type GetChoghadiyaData = {
     body?: {
         /**
-         * Date in YYYY-MM-DD format.
+         * Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected.
          */
         date: string;
         /**
@@ -15206,7 +15206,7 @@ export type GetChoghadiyaResponse = GetChoghadiyaResponses[keyof GetChoghadiyaRe
 export type GetHoraData = {
     body?: {
         /**
-         * Date in YYYY-MM-DD format.
+         * Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected.
          */
         date: string;
         /**
@@ -16684,7 +16684,7 @@ export type GetKpRulingPlanetsData = {
          */
         timezone?: number | string;
         /**
-         * ISO 8601 datetime for ruling planets. Defaults to current time. Always interpreted as local time when a non-zero timezone is provided (Z suffix is ignored).
+         * ISO 8601 datetime (YYYY-MM-DDTHH:MM:SS) for ruling planets. Defaults to current time. Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC.
          */
         datetime?: string;
         /**
@@ -16821,11 +16821,11 @@ export type GetKpRulingPlanetsResponse = GetKpRulingPlanetsResponses[keyof GetKp
 export type GetKpRulingIntervalData = {
     body?: {
         /**
-         * Start of the interval range in ISO 8601 format. Always interpreted as local time when a non-zero timezone is provided (Z suffix is ignored).
+         * Start of the interval range in ISO 8601 (YYYY-MM-DDTHH:MM:SS). Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC.
          */
         startDatetime: string;
         /**
-         * End of the interval range in ISO 8601 format. Always interpreted as local time when a non-zero timezone is provided (Z suffix is ignored).
+         * End of the interval range in ISO 8601 (YYYY-MM-DDTHH:MM:SS). Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC.
          */
         endDatetime: string;
         /**
@@ -21665,7 +21665,7 @@ export type CalculatePersonalDayData = {
          */
         day: number;
         /**
-         * Target date in YYYY-MM-DD format (defaults to today)
+         * Target date in YYYY-MM-DD format. Defaults to today (UTC).
          */
         targetDate?: string;
     };
@@ -33896,7 +33896,7 @@ export type GetCrystalPairingsData = {
     body?: never;
     path: {
         /**
-         * URL-safe crystal identifier to find pairings for (e.g., "amethyst", "rose-quartz").
+         * URL-safe crystal identifier to find pairings for, case-insensitive (e.g., "amethyst", "Amethyst", "rose-quartz" all resolve).
          */
         id: string;
     };
@@ -34855,7 +34855,7 @@ export type GetCrystalData = {
     body?: never;
     path: {
         /**
-         * URL-safe crystal identifier (e.g., "amethyst", "rose-quartz", "black-tourmaline"). Must match an entry in the database.
+         * URL-safe crystal identifier, case-insensitive (e.g., "amethyst", "Amethyst", "rose-quartz" all resolve). Must match an entry in the database.
          */
         id: string;
     };

package/src/version.ts

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