feat: adopt roxyapi-ui 0.11.0, map 10 new components, fix numeric anyOf attribute coercion, tokenize error colors, sync readme counts and examples

Author: ph33nx

README.md

@@ -14,11 +14,11 @@
 
 ## Ship a complete astrology, numerology, or tarot site this weekend. Not this quarter.
 
-The only multi domain spiritual intelligence plugin for WordPress. Drop daily horoscopes, numerology charts, tarot pulls, I Ching casts, dream symbol lookups, and natal chart calculators onto any page. One API key, ten spiritual data domains, 130+ endpoints. Verified against NASA JPL Horizons.
+The only multi domain spiritual intelligence plugin for WordPress. Drop daily horoscopes, numerology charts, tarot pulls, I Ching casts, dream symbol lookups, and natal chart calculators onto any page. One API key, 12 spiritual data domains, 150+ endpoints. Verified against NASA JPL Horizons.
 
 Interactive forms for your visitors. Gutenberg blocks for your editor. Shortcodes for anywhere else. Server side rendering keeps your API key out of the browser. Transient caching keeps your quota intact.
 
--   **17 hero blocks and shortcodes** covering western astrology, vedic astrology (kundli, panchang, mangal dosha, KP chart, gun milan), tarot (daily, three card, yes or no), numerology, biorhythm, angel numbers, crystals by zodiac, current moon phase, and two-chart compatibility (synastry, gun milan, Western compatibility).
+-   **17 hero shortcodes** covering western astrology, vedic astrology (kundli, panchang, mangal dosha, KP chart, gun milan), tarot (daily, three card, yes or no), numerology, biorhythm, angel numbers, crystals by zodiac, current moon phase, and two-chart compatibility (synastry, gun milan, Western compatibility). Six of them (horoscope, natal chart, tarot, numerology, biorhythm, angel number) also ship a hand-written Gutenberg block; the rest render through their shortcode.
 -   **Auto generated shortcodes** for the long tail. Every endpoint in the RoxyAPI OpenAPI spec is reachable from a shortcode.
 -   **Form mode on every hero shortcode.** Let visitors submit their own sign, name, birth date, or question and render a personalized reading. No JavaScript required.
 -   **Zero client side secrets.** All calls run in PHP. The API key never reaches the browser.
@@ -85,18 +85,18 @@ Form submissions post back to the same page over HTTPS. The plugin validates the
 
 ## Gutenberg blocks
 
-In the block editor, open the inserter and pick a block from the **RoxyAPI** category. Ten hero blocks, each with a variation picker:
+In the block editor, open the inserter and pick a block from the **RoxyAPI** category. Six hand-written hero blocks (Horoscope, Tarot, and Numerology include a variation picker):
 
 -   **Horoscope** (daily, weekly, monthly, love, career, Chinese)
 -   **Natal Chart**
 -   **Tarot** (daily, three card, Celtic Cross)
 -   **Numerology** (life path, expression, soul urge, full chart)
--   **I Ching**
--   **Dream Symbol**
 -   **Biorhythm**
 -   **Angel Number**
--   **Crystal**
--   **Astrology Section** wrapper that shares a default zodiac sign and birth date with every child block inside it via block context
+
+Beyond these, 125 long-tail endpoints (I Ching, dream symbols, crystals, human design, forecasts, and more) each auto-generate a matching block, for 131 blocks in total. The remaining endpoints render through their shortcode or a visitor form.
+
+The **Astrology Section** wrapper block shares a default zodiac sign and birth date with every child block inside it via block context.
 
 Every block renders server side through the same RoxyAPI client the shortcodes use. Same caching, same rate limiting, same secret handling.
 
@@ -121,14 +121,16 @@ define( 'ROXYAPI_ENCRYPTION_SALT', getenv( 'ROXYAPI_ENCRYPTION_SALT' ) );
 
 When `ROXYAPI_KEY` is defined, the settings field is read only and the constant takes priority. Your key never enters the database.
 
-## Ten domains, 130+ endpoints, one key
+## 12 domains, 150+ endpoints, one key
 
 | Domain            | What you get                                                                                                    |
 | ----------------- | --------------------------------------------------------------------------------------------------------------- |
 | Western astrology | Natal charts, horoscopes (daily, weekly, monthly, love, career), transits, synastry, moon phases, compatibility |
 | Vedic astrology   | Kundli, nakshatras, Dasha, Panchang, KP system, doshas, yogas, muhurta                                          |
 | Numerology        | Life path, expression, soul urge, personal year, personality, karmic analysis                                   |
 | Tarot             | Rider Waite Smith deck, single card, three card, Celtic Cross, custom spreads                                   |
+| Human Design      | Bodygraph with type, authority, profile, centers, channels, gates, plus two chart connection charts             |
+| Forecast          | Cross domain timelines, transit forecasts, solar returns, and significant dates                                 |
 | Biorhythm         | Physical, emotional, intellectual, intuitive cycles plus six extended cycles                                    |
 | I Ching           | Hexagrams, trigrams, coin casting, daily readings                                                               |
 | Crystals          | Healing properties, zodiac and chakra pairings, birthstones                                                     |

assets/css/frontend.css

@@ -378,7 +378,7 @@
 	padding: 0.75rem 1rem;
 	border: 1px solid color-mix(in srgb, currentcolor 12%, transparent);
 	border-inline-start-width: 4px;
-	border-inline-start-color: color-mix(in srgb, #b91c1c 70%, currentColor);
+	border-inline-start-color: color-mix(in srgb, var(--roxy-danger-fg, #b91c1c) 70%, currentColor);
 	border-radius: var(--wp--custom--border--radius, 6px);
 	background: color-mix(in srgb, #fee2e2 30%, transparent);
 	color: var(--wp--preset--color--foreground, currentColor);
@@ -454,7 +454,7 @@
 }
 
 :where(.roxyapi-form-required) {
-	color: #b91c1c;
+	color: var(--roxy-danger-fg, #b91c1c);
 }
 
 :where(.roxyapi-form-field input),
@@ -476,12 +476,12 @@
 
 :where(.roxyapi-form-field.has-error input),
 :where(.roxyapi-form-field.has-error select) {
-	border-color: color-mix(in srgb, #b91c1c 70%, currentColor);
+	border-color: color-mix(in srgb, var(--roxy-danger-fg, #b91c1c) 70%, currentColor);
 }
 
 :where(.roxyapi-form-error) {
 	font-size: 0.8125rem;
-	color: #b91c1c;
+	color: var(--roxy-danger-fg, #b91c1c);
 }
 
 :where(.roxyapi-form-help) {
@@ -512,7 +512,7 @@
 }
 
 :where(.roxyapi-form-consent.has-error) {
-	border-color: color-mix(in srgb, #b91c1c 70%, currentColor);
+	border-color: color-mix(in srgb, var(--roxy-danger-fg, #b91c1c) 70%, currentColor);
 }
 
 :where(.roxyapi-form-actions) {

assets/css/roxy-ui-tokens.css

@@ -41,6 +41,7 @@
 
 	/* Color: surface */
 	--roxy-bg: #ffffff;
+	--roxy-surface: #ffffff;
 	--roxy-fg: #0a0a0a;
 	--roxy-muted: #71717a;
 	--roxy-border: #e4e4e7;
@@ -123,6 +124,7 @@
 		--roxy-info-fg: #7dd3fc;
 
 		--roxy-bg: #0a0a0a;
+		--roxy-surface: #18181b;
 		--roxy-fg: #fafafa;
 		--roxy-muted: #a1a1aa;
 		--roxy-border: #27272a;
@@ -164,6 +166,7 @@
 	--roxy-info-fg: #075985;
 
 	--roxy-bg: #ffffff;
+	--roxy-surface: #ffffff;
 	--roxy-fg: #0a0a0a;
 	--roxy-muted: #71717a;
 	--roxy-border: #e4e4e7;
@@ -201,6 +204,7 @@
 	--roxy-info-fg: #7dd3fc;
 
 	--roxy-bg: #0a0a0a;
+	--roxy-surface: #18181b;
 	--roxy-fg: #fafafa;
 	--roxy-muted: #a1a1aa;
 	--roxy-border: #27272a;

assets/js/roxy-ui.js

@@ -39,6 +39,34 @@ if ( ! manifestUrl ) {
 	process.exit( 1 );
 }
 
+// Pin-consistency guard (offline, deterministic). The @roxyapi/ui version is
+// hand-copied to THREE places that drift independently: ROXYAPI_UI_VERSION in
+// roxyapi.php (cache-bust + the version fetch-ui-bundle.mjs vendors), and both
+// _meta.ui_version_pinned and the version embedded in _meta.ui_manifest_url
+// here. A mismatch makes this very check validate against the wrong build (or
+// silently against a stale manifest while the vendored bundle is newer). Fail
+// loudly so all three move together on every UI bump.
+const phpSource = readFileSync( path.join( root, 'roxyapi.php' ), 'utf8' );
+const phpPin = phpSource.match(
+	/const\s+ROXYAPI_UI_VERSION\s*=\s*'([^']+)'/
+)?.[ 1 ];
+const metaPin = map?._meta?.ui_version_pinned;
+const urlPin = String( manifestUrl ).match( /@roxyapi\/ui@([^/]+)\// )?.[ 1 ];
+if (
+	phpPin &&
+	metaPin &&
+	urlPin &&
+	! ( phpPin === metaPin && metaPin === urlPin )
+) {
+	console.error(
+		'@roxyapi/ui version pins disagree (align all three, then `npm run fetch:ui`):'
+	);
+	console.error( `  roxyapi.php ROXYAPI_UI_VERSION       = ${ phpPin }` );
+	console.error( `  component-map.json ui_version_pinned = ${ metaPin }` );
+	console.error( `  component-map.json ui_manifest_url   = ${ urlPin }` );
+	process.exit( 1 );
+}
+
 // Collect every tag referenced by the map, mapped to its slug form.
 const referenced = new Map(); // slug -> tag
 for ( const rows of Object.values( map.operations || {} ) ) {
@@ -139,10 +167,21 @@ if ( deadOps.length > 0 ) {
 	process.exit( 1 );
 }
 
+// Adoption signal (informational, never fatal). The map is intentionally a
+// subset of the build (helpers + reads that are fine as generic cards stay
+// unbound), but a jump in this count after a version bump means new upstream
+// components are available to wire up via a component-map row.
+const unbound = available.size - referenced.size;
+if ( unbound > 0 ) {
+	console.log(
+		`note: ${ unbound } of ${ available.size } component(s) in the pinned UI build are not bound to any operation. Bind in component-map.json to render them (unbound reads fall back to roxy-data).`
+	);
+}
+
 console.log(
-	`component-map.json OK: ${
-		referenced.size
-	} component tag(s) in the pinned UI build, ${
+	`component-map.json OK: ${ referenced.size } of ${
+		available.size
+	} component tag(s) bound in the pinned UI build, ${
 		Object.keys( map.operations || {} ).length
 	} operationId(s) present in the live spec`
 );

bin/check-component-map.mjs

@@ -1,8 +1,8 @@
 {
 	"_meta": {
 		"ui_package": "@roxyapi/ui",
-		"ui_version_pinned": "0.10.0",
-		"ui_manifest_url": "https://cdn.jsdelivr.net/npm/@roxyapi/ui@0.10.0/dist/manifest.json"
+		"ui_version_pinned": "0.11.0",
+		"ui_manifest_url": "https://cdn.jsdelivr.net/npm/@roxyapi/ui@0.11.0/dist/manifest.json"
 	},
 	"operations": {
 		"generateNatalChart": [ { "component": "roxy-natal-chart", "kind": "chart" } ],
@@ -68,6 +68,27 @@
 		"getDreamSymbol": [ { "component": "roxy-dream-card", "kind": "card" } ],
 
 		"getAngelNumber": [ { "component": "roxy-angel-number-card", "kind": "card" } ],
-		"analyzeNumberSequence": [ { "component": "roxy-angel-number-lookup", "kind": "card" } ]
+		"analyzeNumberSequence": [ { "component": "roxy-angel-number-lookup", "kind": "card" } ],
+
+		"calculateAspects": [ { "component": "roxy-aspects-table", "kind": "table" } ],
+		"calculateTransitAspects": [ { "component": "roxy-aspects-table", "kind": "table" } ],
+		"detectAspectPatterns": [ { "component": "roxy-aspects-table", "kind": "table" } ],
+		"calculateDrishti": [ { "component": "roxy-vedic-aspects", "kind": "table" } ],
+		"getHora": [ { "component": "roxy-hora-table", "kind": "table" } ],
+		"generateDigest": [ { "component": "roxy-forecast-digest", "kind": "card" } ],
+		"getCrystal": [ { "component": "roxy-crystal-card", "kind": "card" } ],
+		"searchDreamSymbols": [ { "component": "roxy-dream-search", "kind": "card" } ],
+		"calculateConnection": [ { "component": "roxy-hd-connection", "kind": "chart" } ],
+		"calculatePenta": [ { "component": "roxy-hd-penta", "kind": "chart" } ],
+		"calculateVariables": [ { "component": "roxy-hd-variables", "kind": "card" } ],
+
+		"getZodiacSign": [ { "component": "roxy-reference-card", "kind": "card" } ],
+		"getPlanetMeaning": [ { "component": "roxy-reference-card", "kind": "card" } ],
+		"getRashi": [ { "component": "roxy-reference-card", "kind": "card" } ],
+		"getTrigram": [ { "component": "roxy-reference-card", "kind": "card" } ],
+		"getGate": [ { "component": "roxy-reference-card", "kind": "card" } ],
+		"getCenter": [ { "component": "roxy-reference-card", "kind": "card" } ],
+		"getNumberMeaning": [ { "component": "roxy-reference-card", "kind": "card" } ],
+		"getCompoundNumber": [ { "component": "roxy-reference-card", "kind": "card" } ]
 	}
 }

bin/component-map.json

@@ -388,10 +388,22 @@ function extractBodyFields( op ) {
 	const required = new Set( schema.required || [] );
 	return Object.entries( props ).map( ( [ name, prop ] ) => {
 		const resolvedProp = resolveRef( prop );
+		// anyOf/oneOf of number + string (e.g. `timezone`: decimal hours OR IANA
+		// name). resolvedProp.type is undefined for these, so the body builder
+		// would send the shortcode attr as a raw string and the API rejects
+		// "5.5" (matches neither the number nor the IANA-string pattern).
+		const variants = resolvedProp.anyOf || resolvedProp.oneOf;
+		const numericString =
+			Array.isArray( variants ) &&
+			variants.some( ( v ) => {
+				const t = resolveRef( v ).type;
+				return t === 'number' || t === 'integer';
+			} );
 		return {
 			name,
 			required: required.has( name ),
 			type: resolvedProp.type || 'string',
+			numericString,
 			description: resolvedProp.description || '',
 			example: resolvedProp.example,
 		};
@@ -1110,6 +1122,9 @@ class ${ className } {
 							if ( f.type === 'boolean' ) {
 								return `\t\t\t\t'${ f.name }' => $atts['${ attr }'] !== '' ? filter_var( $atts['${ attr }'], FILTER_VALIDATE_BOOLEAN ) : '',`;
 							}
+							if ( f.numericString ) {
+								return `\t\t\t\t'${ f.name }' => $atts['${ attr }'] !== '' ? ( is_numeric( $atts['${ attr }'] ) ? (float) $atts['${ attr }'] : $atts['${ attr }'] ) : '',`;
+							}
 							return `\t\t\t\t'${ f.name }' => $atts['${ attr }'],`;
 						} )
 						.join(

bin/generate.mjs

@@ -38,6 +38,52 @@ The plugin itself is GPLv2 or later and the source is available at https://githu
 * Server side caching with per endpoint TTL to keep your API quota low
 * API key stays server side. Never exposed to the browser.
 
+== Shortcode examples ==
+
+Every reading is a shortcode. Pass attributes for a fixed reading the site owner controls, or drop the shortcode with no attributes to render an accessible visitor form. Heroes that take two charts or nested birth details are form mode only.
+
+**Hero shortcodes**
+
+`[roxy_horoscope sign="aries"]`
+`[roxy_natal_chart birth_date="1990-05-15" birth_time="14:30" lat="40.7128" lon="-74.0060" tz="America/New_York"]`
+`[roxy_kundli birth_date="1990-05-15" birth_time="14:30" lat="28.6139" lon="77.2090" tz="Asia/Kolkata"]`
+`[roxy_panchang date="2026-04-28" lat="28.6139" lon="77.2090" tz="Asia/Kolkata"]`
+`[roxy_mangal_dosha birth_date="1990-05-15" birth_time="14:30" lat="28.6139" lon="77.2090" tz="Asia/Kolkata"]`
+`[roxy_kp_chart birth_date="1990-05-15" birth_time="14:30" lat="28.6139" lon="77.2090" tz="Asia/Kolkata"]`
+`[roxy_moon_phase]`
+`[roxy_tarot_card spread="three" question="What should I focus on this week"]`
+`[roxy_tarot_yes_no question="Should I take the new job"]`
+`[roxy_numerology name="Ada Lovelace" birth_date="1815-12-10"]`
+`[roxy_life_path birth_date="1990-05-15"]`
+`[roxy_biorhythm birth_date="1990-05-15" target_date="today"]`
+`[roxy_angel_number number="1111"]`
+`[roxy_crystals_by_zodiac sign="aries"]`
+
+The three two chart compatibility heroes render a visitor form for both people and take no attributes:
+
+`[roxy_synastry]`
+`[roxy_gun_milan]`
+`[roxy_compatibility]`
+
+Leave the attributes off any hero shortcode to render a form instead. For example `[roxy_horoscope]` shows a zodiac sign picker and `[roxy_natal_chart]` shows a birth date, time, and city picker.
+
+**Long-tail shortcodes**
+
+A matching shortcode exists for every endpoint in the spec. A sample across the domains:
+
+* Western astrology: `[roxy_calculate_aspects date="1990-07-15" time="14:30:00" timezone="UTC"]` and `[roxy_get_weekly_horoscope sign="aries"]`
+* Vedic astrology: `[roxy_get_hora date="2026-02-03" latitude="17.385044" longitude="78.486671" timezone="UTC"]` and `[roxy_calculate_drishti date="2026-02-03" time="12:00:00" latitude="17.385044" longitude="78.486671" timezone="UTC"]`
+* Tarot: `[roxy_cast_celtic_cross question="What should I know about this path"]`
+* Numerology: `[roxy_calculate_expression full_name="Ada Lovelace"]`
+* Human design: `[roxy_generate_bodygraph date="1990-07-15" time="13:00:00" timezone="UTC" latitude="40.7128" longitude="-74.0060"]`, `[roxy_calculate_variables date="1990-07-15" time="13:00:00" timezone="UTC" latitude="40.7128" longitude="-74.0060"]`, plus the two chart `[roxy_calculate_connection]` and `[roxy_calculate_penta]` which render visitor forms and take no attributes
+* Forecast: `[roxy_generate_digest]` (renders a visitor form, no attributes)
+* I Ching: `[roxy_get_daily_hexagram]`
+* Crystals: `[roxy_get_crystal id="amethyst"]`
+* Dreams: `[roxy_search_dream_symbols q="water"]`
+* Location: `[roxy_search_cities q="berlin"]`
+
+Add lang to any shortcode to override the response language, for example `[roxy_get_crystal id="amethyst" lang="es"]`.
+
 == Installation ==
 
 1. In your WordPress admin, go to Plugins, Add New, search for "RoxyAPI", and click Install Now.
@@ -70,7 +116,7 @@ Not to get started. A limited number of free readings per day are allowed right
 
 = What readings can I add to my site? =
 
-One key covers 12 domains. Western astrology: natal chart, daily / weekly / monthly horoscopes, synastry, compatibility, transits, aspect patterns, and moon phases. Vedic astrology: kundli, KP chart, panchang, Vimshottari dasha, divisional charts, nakshatras, doshas (Manglik, Kaal Sarpa, Sade Sati), and classical yogas. Numerology: Life Path, Expression, Soul Urge, Personality, personal year, and compatibility. Tarot: single card, three card, Celtic Cross, and the full 78 card catalog. Human design: bodygraph, type, authority, profile, centers, channels, and gates. Forecasts: timelines, transit forecasts, solar returns, and significant dates. Plus biorhythm, I Ching hexagrams, crystal reference data, dream symbols, and angel numbers. Each one has a Gutenberg block and a matching shortcode. Browse the full list inside WordPress under RoxyAPI, Shortcodes.
+One key covers 12 domains. Western astrology: natal chart, daily / weekly / monthly horoscopes, synastry, compatibility, transits, aspect patterns, and moon phases. Vedic astrology: kundli, KP chart, panchang, Vimshottari dasha, divisional charts, nakshatras, doshas (Manglik, Kaal Sarpa, Sade Sati), and classical yogas. Numerology: Life Path, Expression, Soul Urge, Personality, personal year, and compatibility. Tarot: single card, three card, Celtic Cross, and the full 78 card catalog. Human design: bodygraph, type, authority, profile, centers, channels, and gates. Forecasts: timelines, transit forecasts, solar returns, and significant dates. Plus biorhythm, I Ching hexagrams, crystal reference data, dream symbols, and angel numbers. Every reading is available as a shortcode. The chart and reading heroes plus the 125 long-tail endpoints also ship a matching Gutenberg block. Interactive multi input readings such as two chart compatibility and nested birth forms are shortcode and visitor form mode, because the block editor cannot collect their nested input. Browse the full list inside WordPress under RoxyAPI, Shortcodes.
 
 = Can I show readings in another language? =
 

readme.txt

@@ -22,7 +22,7 @@
 }
 
 const ROXYAPI_VERSION     = '1.3.1';
-const ROXYAPI_UI_VERSION  = '0.10.0';
+const ROXYAPI_UI_VERSION  = '0.11.0';
 const ROXYAPI_PHP_MIN     = '7.4.0';
 const ROXYAPI_PLUGIN_FILE = __FILE__;