diff --git a/.cspell.json b/.cspell.json index 514e74b7a0..15a2650ada 100644 --- a/.cspell.json +++ b/.cspell.json @@ -1,11 +1,16 @@ { "version": "0.2", + "ignoreRegExpList": [ + "github:[\\w.@/#-]+" + ], "ignorePaths": [ + "AGENTS.md", "package-lock.json", "bun.lock", "bun.lockb", "composer.lock", "composer.json", + "phpstan-baseline.neon", "build/**", "**/*.min.js", "**/*.asset.php", @@ -16,10 +21,14 @@ "**/*.svg" ], "words": [ + "absint", "ABSPATH", "advancedbtn", "advancedgallery", "advancedheading", + "advbtn", + "affordance", + "affordances", "algoliasearch", "alignleft", "alignright", @@ -28,46 +37,76 @@ "blocksy", "bloginfo", "britner", + "btnbg", + "btnbghover", + "btncolor", + "btncolorhover", "bunfig", "bunx", + "centralise", "changelogger", + "Checkboard", + "codecept", "codeception", "colapse", "commoditize", + "Consolas", "crawlable", "curlopt", "customizer", + "dashicon", + "dashicons", + "describedby", "designlibrary", "diffcs", "distignore", "dotlottie", "dotstyle", + "DTCG", "earlybird", + "Extralargeheadingsizewrapped", "exwide", + "figcaption", "flexwrap", "fluentcrm", "fluidcarousel", + "formalises", + "Fullwidth", "gfont", "gfonts", "ghernkadence", + "glightbox", + "grecaptcha", "gridvisualizer", "gslide", "gulpfile", "haspopup", "hcaptcha", "headerfunction", + "hoverable", "httpheader", "iconlist", + "iframed", "inbetween", "infobox", "innerblocks", + "Inno", "ithemes", "kadence", "kadenceblocks", "kadencewp", + "kbcss", "kbcustom", "kbcustomicons", + "ktanimate", + "ktanimateadd", + "ktanimatepreview", + "ktanimatereveal", + "ktanimateswipe", + "ktdynamic", + "ktgooglefonts", "lightbox", + "LONGTEXT", "lottieanimation", "lottiefiles", "lucatume", @@ -76,6 +115,9 @@ "markformat", "mbstring", "memize", + "Menlo", + "menuitemcheckbox", + "menuitemradio", "multisite", "multisites", "navigations", @@ -85,22 +127,41 @@ "oakesjosh", "pagenow", "patchstack", + "PCRE", "pexels", "phar", "phpcs", "phpstan", + "pickable", "postfields", "progressbar", "puprc", "recaptcha", + "recognised", + "renameable", + "repointed", + "Reselecting", + "resends", "resizer", + "retarget", + "retargeted", + "retargets", "returntransfer", + "Ritner", "rowlayout", + "rrggbb", + "rrggbbaa", + "Sabberworm", "scroller", "shivammathur", "singlebtn", "slic", "slidy", + "slugified", + "slugifies", + "slugify", + "slugifying", + "snackbars", "solidwp", "splide", "splidejs", @@ -109,12 +170,18 @@ "stellarwp", "subteam", "sunsetting", + "syncable", "tabindex", "tableofcontents", + "textcolor", "thumbslider", "trailingslashit", "uncollapsed", "undefed", + "unitless", + "unrecognised", + "unrepresentable", + "unslash", "userrole", "videopopup", "vsdesk", @@ -124,9 +191,14 @@ "webp", "woocommerce", "woodardmc", + "worktrees", + "wpbody", + "wpcontent", "wpdb", + "wpfooter", "wpml", "wpunit", - "writefunction" + "writefunction", + "xlarge" ] } diff --git a/.eslintrc.js b/.eslintrc.js index 98ac5d3008..f3337c8008 100644 --- a/.eslintrc.js +++ b/.eslintrc.js @@ -132,6 +132,18 @@ const eslintConfig = { 'no-var': 'off', }, }, + { + // The design-token surfaces rely on hook-shaped helpers; keep the hook rules on here so a + // conditional hook call can't land silently while the repo-wide rule stays off. + files: [ + 'src/extension/variant-picker/**', + 'src/extension/token-indicators/**', + 'src/extension/design-tokens/**', + ], + rules: { + 'react-hooks/rules-of-hooks': 'error', + }, + }, ], ignorePatterns: [], }; diff --git a/.github/workflows/phpcs.yml b/.github/workflows/phpcs.yml index 79561f39cd..4e6d507434 100644 --- a/.github/workflows/phpcs.yml +++ b/.github/workflows/phpcs.yml @@ -34,12 +34,33 @@ jobs: - uses: ramsey/composer-install@v3 - name: Run PHPCS on changed lines + env: + GH_TOKEN: ${{ secrets.GH_BOT_TOKEN }} + PR_NUMBER: ${{ github.event.pull_request.number }} run: | # On a pull_request the base is the PR's target branch; fall back to # master for a manual workflow_dispatch run. BASE_REF="${GITHUB_BASE_REF:-master}" git remote set-branches origin "$BASE_REF" - git fetch origin --depth=1 + if ! git fetch origin --depth=1; then + # A re-run can replay a stale event payload: if the PR's base + # branch was renamed after this run was first queued, + # GITHUB_BASE_REF still names the old, now-deleted branch. Ask + # the API for the PR's current base and retry once before + # giving up. + if [ -z "$PR_NUMBER" ]; then + exit 1 + fi + + BASE_REF="$(gh pr view "$PR_NUMBER" --repo "$GITHUB_REPOSITORY" --json baseRefName --jq .baseRefName)" + + if [ -z "$BASE_REF" ]; then + exit 1 + fi + + git remote set-branches origin "$BASE_REF" + git fetch origin --depth=1 + fi composer phpcs-ci "origin/$BASE_REF" diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml index a532efad8a..5077b91492 100644 --- a/.github/workflows/tests.yml +++ b/.github/workflows/tests.yml @@ -110,6 +110,9 @@ jobs: - name: Run acceptance tests run: ${SLIC_BIN} run acceptance --ext DotReporter + - name: Run snapshot tests + run: ${SLIC_BIN} run snapshot --ext DotReporter + - name: Upload codeception output if: ${{ failure() }} uses: actions/upload-artifact@v6 diff --git a/.gitignore b/.gitignore index a297998f1a..7b18b2f2a2 100644 --- a/.gitignore +++ b/.gitignore @@ -17,7 +17,10 @@ bin/wp-cli.phar /.kadence-packages-root phpstan-cache/ package-lock.json -# Artifacts generated by dev_scripts/partial-phpcs.sh +# Artifacts generated by dev_scripts/bin/partial-phpcs.sh /diff.txt /diffcs.txt /phpcs.json + +# Scratch workspace for subagent-driven-development runs. +.superpowers/ diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000000..b3283f2dbc --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,250 @@ +# AGENTS.md + +Conventions and workflow for working in `kadence-blocks`. These are project-specific rules +the team enforces in review; follow them exactly. + +## PHP coding conventions + +### Docblocks + +- **`@since TBD` on every new property/constant.** Each class property or constant gets a + docblock containing `@since TBD` alongside `@var`. There is always a blank line between + `@since` and the next tag. Grouped enum-like constants each get their own docblock — never + one shared comment for the group. + + ```php + /** + * Description. + * + * @since TBD + * + * @var + */ + ``` + +- **`apply_filters()` docblocks need `@return`.** Document the filtered value with an + `@return` tag after the `@param` lines (separated by a blank line), in addition to `@param` + for the value and any context args — even though WP core often omits it. + + ```php + /** + * Filters X. + * + * @since TBD + * + * @param string $value The value being filtered. + * @param WP_REST_Request $request The current request. + * + * @return string The value being filtered. + */ + return apply_filters( 'hook', $value, $request ); + ``` + +### Constants and accessors + +- **No `public const`.** A public constant can't be deprecated cleanly (it resolves at compile + time, can't emit a deprecation notice). Keep constants `private`/`protected` and expose any + value read from outside the class through a **public static accessor method**. +- Accessor methods are prefixed `get_*`. "Key" constants use the `get_*_key()` form + (e.g. `get_disabled_key()`, `get_value_key()`). + Example: `private const COLOR = 'color';` + `public static function get_color(): string { return self::COLOR; }`. +- Predicate methods stay `is_*` (e.g. `is_valid()`, `is_composite()`). Collection-style + accessors that mirror existing sibling APIs (e.g. `Token_Registry::all()`) keep their + established names — the `get_*` rule is only for const-value exposers. + +### Member order + +- Order class members by visibility, top to bottom: `public`, then `protected`, then `private`. + Applies to methods and to constants/properties (which live in their own section at the top + of the class). +- Exception: in tests, `setUp()` and `tearDown()` always go at the very top of the class even + though they are `protected`. Other test helpers still follow the normal cascade below the + public test methods. + +### No ticket numbers in shipped code + +- Don't reference ticket numbers (e.g. `SOFT-3378`) in public-facing / shipped code (the + `includes/` plugin source). Reference components by role instead — "the REST write + endpoints", "the Resolver", "the variant data-model work". +- Ticket numbers ARE acceptable inside a `TODO`/`@todo` marking a concrete follow-up. +- After edits, `grep -rn "SOFT-" includes/` to confirm none leaked in. + +### Design token ids are kebab-case + +- **Token names in `baseline.json` and `declarations.php` must be kebab-case, never camelCase.** + A registered token id is validated as `^[a-z0-9]+([.-][a-z0-9]+)*$` (lowercase alphanumeric + segments separated by `.` or `-`), because it feeds `Css_Var::from_id()` which only swaps `.` + for `--`. A camelCase segment (`iconSize`, `borderWidth`) throws at registration, so use + `icon-size`, `border-width`, etc. This applies to every layer of a token path — a `semantic` + alias and the `primitive` it points at must both be kebab-case, and any `{alias}` reference in + the baseline must match. +- Note the DTCG `$type` values are a separate vocabulary and stay as the spec defines them + (`fontFamily`, `fontWeight`, `cubicBezier`); the kebab-case rule is about token *names* (keys + and ids), not `$type`. + +### DTCG dimension tokens surfaced as raw numeric attributes need an Adapter + +- **A block attribute that stores a design value as a bare number (no unit, no CSS variable + indirection) cannot bind to a `dimension` token through a plain `block_attr`/`css_prop` + binding.** An SVG icon's pixel `size` is the example: the token resolves to a CSS length string + (`"1.5rem"`), and a plain binding has no unit-conversion step to turn that into the raw number + the attribute stores. Register a per-block `Adapter` + (`Design_Tokens\Projection\Adapter\Contracts\Abstract_Adapter`) instead, and do the + rem/em-to-px conversion inside it. +- This is distinct from a block whose attribute is empty-by-default and rendered as a CSS + declaration in both the editor and the front end (e.g. `kadence/image`'s `borderRadius`, + `kadence/single-icon`'s `color`) — that shape fits the low-specificity `Block_Default_Css` + binding directly, with no adapter and no unit conversion needed. + +## JavaScript coding conventions + +### Docblocks + +- **`@since TBD` on every new JS function, hook, component, and exported helper.** Just like PHP, + new JavaScript gets a `@since TBD` tag in its JSDoc block. This applies to functions, React + components, custom hooks, store selectors/actions/reducers, and exported helpers the change adds. + Only tag the code the change introduces — do not retrofit pre-existing functions in a file you are + only partially touching. + +- **Placement differs from PHP.** In this repo's JS, the `@since TBD` line goes **after** the + `@param` block and **before** `@return`, with a blank ` *` line on each side (not before `@param` + the way PHP puts it before `@var`). Match `src/early-filters.js` exactly. A function with no + params puts `@since TBD` between the description and `@return`. + + ```js + /** + * Description. + * + * @param {Object} settings The block settings. + * + * @since TBD + * + * @return {Object} The updated settings. + */ + ``` + +## Tests + +- **Data providers use `Generator`, not arrays.** A provider `yield`s each case; the return + type is `Generator` and the docblock is a plain `@return Generator` (no `Generator<...>` + generic). Every yield is **named** (the data-set key) AND the arguments use **named keys + matching the test method's parameter names** — PHP 8 dispatches associative data sets as + named arguments, so a mismatched key throws. + + ```php + /** + * @return Generator + */ + public function colorProvider(): Generator { + yield 'hex 6' => [ + 'value' => '#3182CE', + 'expected' => true, + ]; + } + ``` + + Single-arg cases can stay on one line: `yield 'color' => [ 'type' => 'color' ];`. + +- **Every test method has complete phpdoc.** That means a one-line description summarizing what + the test asserts, then (separated by a blank line) `@dataProvider` (when applicable), one + `@param` per parameter (including typed ones like `bool $expected`), and `@return void`. The + description is required even when the method name is already descriptive — write the sentence, + don't lean on the name. Methods with no params still get the description plus `@return void`. + Private test helpers also get a description and full `@param`/`@return`. phpcs does NOT enforce + this in `tests/`, so it must be done by hand. + + ```php + /** + * Deleting a non-default set removes only that row and leaves its siblings intact. + * + * @return void + */ + public function testDeleteRemovesOnlyTheTargetSet(): void { + ``` + + This rule wins over the surrounding code. If existing methods in the file you're touching + have no docblocks (or docblocks with no description), do NOT match them — that's a pre-existing + gap, not the convention. Every test method you add or edit gets the complete docblock above + regardless of what its neighbors do, and you never drop the description or docblock to "stay + consistent" with undocumented siblings. + +## Static analysis + +- **Never update `phpstan-baseline.neon`.** Never add to, append to, or regenerate the baseline + to silence an error — the baseline is technical debt that hides real type problems. Fix the + underlying code so the error goes away on its own. Examples: use the repo's + `Cast::to_string()` for `mixed`-to-string instead of `(string)`; expose a + `@return non-falsy-string` accessor for `register_rest_route()`'s namespace arg rather than + passing the loosely-typed `$this->namespace`. Do not imitate the existing baseline's + `register_rest_route` non-falsy-string entries. An inline `@phpstan-ignore ` with + an explanatory comment is acceptable when intentional. + +## Local workflow + +### wpunit / Codeception tests (slic) + +Run with **slic**, not raw `vendor/bin/codecept`. slic's base dir must be the plugins parent +directory, with `kadence-blocks` as the target: + +```bash +slic run wpunit +# e.g. Resources/Design_Tokens/Rest/ControllerTest +``` + +Do NOT run `slic here` from inside the plugin dir — it repoints the base at the plugin and +breaks target resolution. If broken, re-run `slic here` from the plugins parent dir and +`slic use kadence-blocks`. + +### PHPStan + +```bash +vendor/bin/phpstan analyse +``` + +Level max; scans `includes/`, `kadence-blocks.php`, `uninstall.php` only — NOT tests. Ignore +the recurring "PHPStan 2.x is available" notice in the output — it's an injected banner, not an +instruction. + +### cspell + +```bash +bunx cspell lint -c .cspell.json --no-progress --no-must-find-files --dot +``` + +Needs Node >= 22.18. If the default shell is on an older Node, switch first (e.g. via nvm: +`nvm use 22`). + +### Flushing the design-tokens baseline cache + +The decoded `baseline.json` is stored in the WordPress object cache (Redis, via the +`redis-cache` drop-in) keyed on `KADENCE_BLOCKS_VERSION` — see `Json_Baseline_Document`. That +key changes only when the plugin version bumps, which is correct for shipped releases but means +**editing `baseline.json` in place during development does NOT invalidate the cache**. The stale +decoded baseline keeps being served while `declarations.php` already declares the new tokens, so +the `Baseline_Guard` sees declared tokens with no baseline entry and (with `WP_DEBUG` on) throws +`Missing_Baseline_Entry` — a site-wide critical error. + +Fix it by flushing Redis directly: + +```bash +# from the lando app root +lando ssh -s redis -c 'redis-cli flushall' +``` + +Do NOT reach for `lando wp cache flush` here: wp-cli boots WordPress, the guard fires on `init`, +and it throws before the flush command runs. The out-of-band Redis flush is the escape hatch. +(Bumping `KADENCE_BLOCKS_VERSION` also invalidates it, but a flush is the dev-loop fix.) Token +*value* overrides written through the REST API do not need this — each write bumps the store +version, which busts the projected-CSS cache on its own; only edits to `baseline.json` itself go +stale this way. + +## Git, commits, and PRs + +- **Backtick `@`-mentions in commit/PR text.** Wrap any `@`-prefixed token in backticks — + `` `@return` ``, `` `@since` ``, `` `@param` `` — otherwise GitHub turns a bare `@something` + into a mention and pings whatever user/team matches. Scan the message for `@` before + committing. +- **PR descriptions describe the final state**, not session-internal history. Describe what a + reviewer will see when they open the PR. Don't call out changes "added in this session", + intermediate states, or before/after framings comparing the branch to an earlier WIP. + Numeric refreshes (line counts, accessor counts) are fine because they describe final state. diff --git a/CLAUDE.md b/CLAUDE.md new file mode 120000 index 0000000000..47dc3e3d86 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1 @@ +AGENTS.md \ No newline at end of file diff --git a/bun.lock b/bun.lock index 8e9d43e60f..3eb8382a00 100644 --- a/bun.lock +++ b/bun.lock @@ -1,6 +1,6 @@ { "lockfileVersion": 1, - "configVersion": 1, + "configVersion": 0, "workspaces": { "": { "name": "kadence-blocks", @@ -10,8 +10,8 @@ "@dnd-kit/sortable": "^10.0.0", "@floating-ui/react": "^0.27.12", "@hcaptcha/react-hcaptcha": "^1.8.1", - "@kadence/components": "github:stellarwp/kadence-components#1.1.9", - "@kadence/helpers": "github:stellarwp/kadence-helpers#1.1.0", + "@kadence/components": "github:stellarwp/kadence-components#feature/design-tokens-module", + "@kadence/helpers": "github:stellarwp/kadence-helpers#feature/design-tokens-module", "@kadence/icons": "github:stellarwp/kadence-icons#1.1.4", "@lottiefiles/dotlottie-react": "^0.15.2", "@react-google-maps/api": "^2.12.0", @@ -47,9 +47,11 @@ }, "devDependencies": { "@babel/eslint-parser": "^7.25.1", + "@wordpress/data": "^10.53.0", "@wordpress/dependency-extraction-webpack-plugin": "^6.26.0", "@wordpress/eslint-plugin": "^22.12.0", "@wordpress/i18n": "^5.26.0", + "@wordpress/notices": "^5.26.0", "@wordpress/prettier-config": "^4.26.0", "@wordpress/scripts": "^30.19.0", "ajv": "^8.17.1", @@ -67,6 +69,8 @@ "gulp-sass": "^6.0.0", "install": "^0.13.0", "prettier": "^3.6.0", + "react": "^18.3.1", + "react-dom": "^18.3.1", }, }, }, @@ -111,6 +115,20 @@ "@ampproject/remapping": ["@ampproject/remapping@2.3.0", "", { "dependencies": { "@jridgewell/gen-mapping": "^0.3.5", "@jridgewell/trace-mapping": "^0.3.24" } }, "sha512-30iZtAPgz+LTIYoeivqYo853f02jBYSd5uGnGpkFV0M3xOt9aN73erkgYAmZU43x4VfqcnLxW9Kpg3R5LC4YYw=="], + "@ariakit/components": ["@ariakit/components@0.1.11", "", { "dependencies": { "@ariakit/store": "0.1.9", "@ariakit/utils": "0.2.0" } }, "sha512-hFmfWKkK8jpATf39kNZSMDlG3o+tftfQwyooRhbPl/YCpFur+IGz5ZPA+PGIIfFjfdkAURLNDJPSeWtXO3xssQ=="], + + "@ariakit/react": ["@ariakit/react@0.4.38", "", { "dependencies": { "@ariakit/react-components": "0.5.0" }, "peerDependencies": { "react": "^17.0.0 || ^18.0.0 || ^19.0.0", "react-dom": "^17.0.0 || ^18.0.0 || ^19.0.0" } }, "sha512-VubItCXqly9GNFxulOYDkFP94jh1M5iHeuo0BDTTiN1ndrGNeZCvsRUWd06BC9yjg+/LKEAnFLeolE1pG1IQBg=="], + + "@ariakit/react-components": ["@ariakit/react-components@0.5.0", "", { "dependencies": { "@ariakit/components": "0.1.11", "@ariakit/react-store": "0.1.10", "@ariakit/react-utils": "0.2.5", "@ariakit/store": "0.1.9", "@ariakit/utils": "0.2.0", "@floating-ui/dom": "^1.0.0" }, "peerDependencies": { "react": "^17.0.0 || ^18.0.0 || ^19.0.0", "react-dom": "^17.0.0 || ^18.0.0 || ^19.0.0" } }, "sha512-NEpptkB3sJZrwTIIzFydyGjLGVLpfDt0X3naLh9x2Z0WyIkJuz6ZbzyWAxMrc9m4oNJgnex4cy5MZYndrJTtKQ=="], + + "@ariakit/react-store": ["@ariakit/react-store@0.1.10", "", { "dependencies": { "@ariakit/react-utils": "0.2.5", "@ariakit/store": "0.1.9", "@ariakit/utils": "0.2.0", "use-sync-external-store": "^1.6.0" }, "peerDependencies": { "react": "^17.0.0 || ^18.0.0 || ^19.0.0" } }, "sha512-DTpWLkfZDWDJqqH9aIcu/AYft1o3BGk/apkJyzSdSZtdFgOqcvDH+9m8zuuF6wMoZghpiS1pysRMk1X7gXVjfw=="], + + "@ariakit/react-utils": ["@ariakit/react-utils@0.2.5", "", { "dependencies": { "@ariakit/store": "0.1.9", "@ariakit/utils": "0.2.0" }, "peerDependencies": { "react": "^17.0.0 || ^18.0.0 || ^19.0.0" } }, "sha512-VfE0o5SH3TxEoivA8KgKd6Z+h1zDIYdRPEKxTCEOuBFwMlayGZbOxmmZGBZdmkg1M3GTf4iNfUfpFqAh0mUYqw=="], + + "@ariakit/store": ["@ariakit/store@0.1.9", "", { "dependencies": { "@ariakit/utils": "0.2.0" } }, "sha512-VXT8GQxmbKR4KKWiZuuVL8Bkvsz7IT5sLYppPnFsmszl1KeKR6dcbo08VKVk6yGL6Gu1AvqmrMwV02DMAv5ZAQ=="], + + "@ariakit/utils": ["@ariakit/utils@0.2.0", "", {}, "sha512-y8GtynpLOsjz4H1juJEVRXtrL2+TEt+wIVoz09cnAnWVMfXggN2akH+vF6dP4jPJd0/F2yniwe08cLpkua+HWw=="], + "@babel/code-frame": ["@babel/code-frame@7.29.7", "", { "dependencies": { "@babel/helper-validator-identifier": "^7.29.7", "js-tokens": "^4.0.0", "picocolors": "^1.1.1" } }, "sha512-Aup7aUOfpbAUg2ROOJN6Iw5f9DMBlzu0mIkm/malLQFN/YQgO48wCj0Kxa3sEHJvPVFg7siR+qRInwXd2qhQKw=="], "@babel/compat-data": ["@babel/compat-data@7.29.7", "", {}, "sha512-locTkQyKvwIEgBzVrn8693ebc97F2U8ZHjbXwDXJ5Fn2TCpNwTlKcaKLkdHop5c/icOFE7qt7Q9JC5hnKNa6Gg=="], @@ -343,6 +361,10 @@ "@babel/types": ["@babel/types@7.29.7", "", { "dependencies": { "@babel/helper-string-parser": "^7.29.7", "@babel/helper-validator-identifier": "^7.29.7" } }, "sha512-4zBIxpPzowiZpusoFkyGVwakdRJUyuH5PxQ/PrqghfdFWWasvnCdPfQXHrenDai+gyLARulZjZowCOj6fjT4pA=="], + "@base-ui/react": ["@base-ui/react@1.7.0", "", { "dependencies": { "@babel/runtime": "^7.29.2", "@base-ui/utils": "0.3.2", "@floating-ui/react-dom": "^2.1.9", "@floating-ui/utils": "^0.2.12", "use-sync-external-store": "^1.6.0" }, "peerDependencies": { "@date-fns/tz": "^1.2.0", "@types/react": "^17 || ^18 || ^19", "date-fns": "^4.0.0", "react": "^17 || ^18 || ^19", "react-dom": "^17 || ^18 || ^19" }, "optionalPeers": ["@date-fns/tz", "@types/react", "date-fns"] }, "sha512-j+8QjX44C32jrXD/qyEAGpFr70FRpGL2CY61mQd9nBPWN737CK0xxD1ceJ055rW4RtdvFDT1e7otzdlfxvsYug=="], + + "@base-ui/utils": ["@base-ui/utils@0.3.2", "", { "dependencies": { "@babel/runtime": "^7.29.2", "@floating-ui/utils": "^0.2.12", "reselect": "^5.2.0", "use-sync-external-store": "^1.6.0" }, "peerDependencies": { "@types/react": "^17 || ^18 || ^19", "react": "^17 || ^18 || ^19", "react-dom": "^17 || ^18 || ^19" }, "optionalPeers": ["@types/react"] }, "sha512-oWy1aq/I2GmYjpl4PhEAhzflF8VPGKgZeq0xAWTbfD5KBWyxcN0ZP2+WHSUm/5Z6lVMBDLReLcoXwSYoRc/zNQ=="], + "@bcoe/v8-coverage": ["@bcoe/v8-coverage@0.2.3", "", {}, "sha512-0hYQ8SB4Db5zvZB4axdMHGwEaQjkZzFjQiN9LVYvIFB2nSUHW9tYpxWriPrWDASIxiaXax83REcLxuSdnGPZtw=="], "@cacheable/memory": ["@cacheable/memory@2.0.9", "", { "dependencies": { "@cacheable/utils": "^2.4.1", "@keyv/bigmap": "^1.3.1", "hookified": "^1.15.1", "keyv": "^5.6.0" } }, "sha512-HdMx6DoGywB30vacDbBsITbIX4pgFqj1zsrV58jZBUw3klzkNoXhj7qOqAgledhxG7YZI5rBSJg7Zp8/VG0DuA=="], @@ -503,6 +525,12 @@ "@csstools/selector-specificity": ["@csstools/selector-specificity@5.0.0", "", { "peerDependencies": { "postcss-selector-parser": "^7.0.0" } }, "sha512-PCqQV3c4CoVm3kdPhyeZ07VmBRdH2EpMFA/pd9OASpOEC3aXNGoqPDAZ80D0cLpMBxnmk0+yNhGsEx31hq7Gtw=="], + "@date-fns/tz": ["@date-fns/tz@1.5.0", "", {}, "sha512-lwYN/vDPeNRULcepoE/LO2Pgx+7/RV+S9ARfbc9lr2DtGkOD7pAiruHvbR1RX3Qyf6ja47EWJDMsNK5vK08DJg=="], + + "@date-fns/utc": ["@date-fns/utc@2.1.1", "", {}, "sha512-SlJDfG6RPeEX8wEVv6ZB3kak4MmbtyiI2qX/5zuKdordbrhB/iaJ58GVMZgJ6P1sJaM1gMgENFYYeg1JWrCFrA=="], + + "@daypicker/react": ["@daypicker/react@10.0.1", "", { "dependencies": { "react-day-picker": "10.0.1" }, "peerDependencies": { "@types/react": ">=16.8.0", "react": ">=16.8.0" }, "optionalPeers": ["@types/react"] }, "sha512-lH4YQz4iMBWP8hsI1bD9Eg0T7t503IkSUR/WDGGkV5mKZvwVv+ukCkJz7yN+uVFBv7vHTK+ww7a5EvlkeFwPYQ=="], + "@discoveryjs/json-ext": ["@discoveryjs/json-ext@0.5.7", "", {}, "sha512-dBVuXR082gk3jsFp7Rd/JI4kytwGHecnCoTtXFb7DB6CNHp4rg5k1bhg0nWdLGLnOV71lmDzGQaLMy8iPLY0pw=="], "@dnd-kit/accessibility": ["@dnd-kit/accessibility@3.1.1", "", { "dependencies": { "tslib": "^2.0.0" }, "peerDependencies": { "react": ">=16.8.0" } }, "sha512-2P+YgaXF+gRsIihwwY1gCsQSYnu9Zyj2py8kY5fFvUM1qm2WA2u639R6YNVfU4GWr+ZM5mqEsfHZZLoRONbemw=="], @@ -525,8 +553,12 @@ "@emotion/cache": ["@emotion/cache@11.14.0", "", { "dependencies": { "@emotion/memoize": "^0.9.0", "@emotion/sheet": "^1.4.0", "@emotion/utils": "^1.4.2", "@emotion/weak-memoize": "^0.4.0", "stylis": "4.2.0" } }, "sha512-L/B1lc/TViYk4DcpGxtAVbx0ZyiKM5ktoIyafGkH6zg/tj+mA+NE//aPYKG0k8kCHSHVJrpLpcAlOBEXQ3SavA=="], + "@emotion/css": ["@emotion/css@11.13.5", "", { "dependencies": { "@emotion/babel-plugin": "^11.13.5", "@emotion/cache": "^11.13.5", "@emotion/serialize": "^1.3.3", "@emotion/sheet": "^1.4.0", "@emotion/utils": "^1.4.2" } }, "sha512-wQdD0Xhkn3Qy2VNcIzbLP9MR8TafI0MJb7BEAXKp+w4+XqErksWR4OXomuDzPsN4InLdGhVe6EYcn2ZIUCpB8w=="], + "@emotion/hash": ["@emotion/hash@0.9.2", "", {}, "sha512-MyqliTZGuOm3+5ZRSaaBGP3USLw6+EGykkwZns2EPC5g8jJ4z9OrdZY9apkl3+UP9+sdz76YYkwCKP5gh8iY3g=="], + "@emotion/is-prop-valid": ["@emotion/is-prop-valid@1.4.0", "", { "dependencies": { "@emotion/memoize": "^0.9.0" } }, "sha512-QgD4fyscGcbbKwJmqNvUMSE02OsHUa+lAWKdEUIJKgqe5IwRSKd7+KhibEWdaKwgjLj0DRSHA9biAIqGBk05lw=="], + "@emotion/memoize": ["@emotion/memoize@0.9.0", "", {}, "sha512-30FAj7/EoJ5mwVPOWhAyCX+FPfMDrVecJAM+Iw9NRoSl4BBAQeqj4cApHHUXOVvIPgLVDsCFoz/hGD+5QQD1GQ=="], "@emotion/react": ["@emotion/react@11.14.0", "", { "dependencies": { "@babel/runtime": "^7.18.3", "@emotion/babel-plugin": "^11.13.5", "@emotion/cache": "^11.14.0", "@emotion/serialize": "^1.3.3", "@emotion/use-insertion-effect-with-fallbacks": "^1.2.0", "@emotion/utils": "^1.4.2", "@emotion/weak-memoize": "^0.4.0", "hoist-non-react-statics": "^3.3.1" }, "peerDependencies": { "react": ">=16.8.0" } }, "sha512-O000MLDBDdk/EohJPFUqvnp4qnHeYkVP5B0xEG0D/L7cOKP9kefu2DXn8dj74cQfsEzUqh+sr1RzFqiL1o+PpA=="], @@ -535,6 +567,8 @@ "@emotion/sheet": ["@emotion/sheet@1.4.0", "", {}, "sha512-fTBW9/8r2w3dXWYM4HCB1Rdp8NLibOw2+XELH5m5+AkWiL/KqYX6dc0kKYlaYyKjrQ6ds33MCdMPEwgs2z1rqg=="], + "@emotion/styled": ["@emotion/styled@11.14.1", "", { "dependencies": { "@babel/runtime": "^7.18.3", "@emotion/babel-plugin": "^11.13.5", "@emotion/is-prop-valid": "^1.3.0", "@emotion/serialize": "^1.3.3", "@emotion/use-insertion-effect-with-fallbacks": "^1.2.0", "@emotion/utils": "^1.4.2" }, "peerDependencies": { "@emotion/react": "^11.0.0-rc.0", "@types/react": "*", "react": ">=16.8.0" }, "optionalPeers": ["@types/react"] }, "sha512-qEEJt42DuToa3gurlH4Qqc1kVpNq8wO8cJtDzU46TjlzWjDlsVyevtYCRijVq3SrHsROS+gVQ8Fnea108GnKzw=="], + "@emotion/unitless": ["@emotion/unitless@0.10.0", "", {}, "sha512-dFoMUuQA20zvtVTuxZww6OHoJYgrzfKM1t52mVySDJnMSEa08ruEvdYQbhvyu6soU+NeLVd3yKfTfT0NeV6qGg=="], "@emotion/use-insertion-effect-with-fallbacks": ["@emotion/use-insertion-effect-with-fallbacks@1.2.0", "", { "peerDependencies": { "react": ">=16.8.0" } }, "sha512-yJMtVdH59sxi/aVJBpk9FQq+OR8ll5GT8oWd57UpeaKEVGab41JWaCFA7FRLoMLloOZF/c/wsPoe+bfGmRKgDg=="], @@ -649,11 +683,11 @@ "@jridgewell/trace-mapping": ["@jridgewell/trace-mapping@0.3.31", "", { "dependencies": { "@jridgewell/resolve-uri": "^3.1.0", "@jridgewell/sourcemap-codec": "^1.4.14" } }, "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw=="], - "@kadence/components": ["@kadence/components@github:stellarwp/kadence-components#da6ab6f", { "dependencies": { "@floating-ui/react": "^0.26.16", "@wordpress/icons": "^9.49.0", "classnames": "^2.2.6", "colord": "^2.9.3", "react-color": "^2.18.0", "react-select": "^5.10.2" }, "peerDependencies": { "@kadence/helpers": "*", "@kadence/icons": "*", "react": ">=17 <19", "react-dom": ">=17 <19" }, "optionalPeers": ["@kadence/helpers", "@kadence/icons"] }, "stellarwp-kadence-components-da6ab6f", "sha512-Ei/wOwF1Yh1PunwprGDxaVpTQcY4Rn6SdO/BZ9sbI7R3tA0H9zOqIBrXX3o9dcI6oK1WTEVb8Pjj15XHs49Vig=="], + "@kadence/components": ["@kadence/components@github:stellarwp/kadence-components#8c85466", { "dependencies": { "@floating-ui/react": "^0.26.16", "@wordpress/icons": "^9.49.0", "classnames": "^2.2.6", "colord": "^2.9.3", "react-color": "^2.18.0", "react-select": "^5.10.2" }, "peerDependencies": { "@kadence/helpers": "*", "@kadence/icons": "*", "react": ">=17 <19", "react-dom": ">=17 <19" }, "optionalPeers": ["@kadence/helpers", "@kadence/icons"] }, "stellarwp-kadence-components-8c85466"], - "@kadence/helpers": ["@kadence/helpers@github:stellarwp/kadence-helpers#64f9b4f", { "dependencies": { "@kadence/icons": "git+https://github.com/stellarwp/kadence-icons.git#package" }, "peerDependencies": { "react": ">=17 <19", "react-dom": ">=17 <19" } }, "stellarwp-kadence-helpers-64f9b4f", "sha512-NOyNNQXGhvizVt842l7/I1YlZeb4AYLsYVuVAJ7Oyo8TTtDC+h1Ye7Z1NG8SEMoRK9lZQOK8FtYR4IBbSBM29g=="], + "@kadence/helpers": ["@kadence/helpers@github:stellarwp/kadence-helpers#e192350", { "dependencies": { "@kadence/icons": "git+https://github.com/stellarwp/kadence-icons.git#1.1.0" }, "peerDependencies": { "@wordpress/hooks": ">=4 <5", "react": ">=17 <19", "react-dom": ">=17 <19" } }, "stellarwp-kadence-helpers-e192350"], - "@kadence/icons": ["@kadence/icons@github:stellarwp/kadence-icons#568e2a9", { "peerDependencies": { "react": ">=17 <19", "react-dom": ">=17 <19" } }, "stellarwp-kadence-icons-568e2a9", "sha512-GM0rSCwxilq9STIBjxHccjPurQAwkKlhgfkV2mc62HTEM3zzW3vk5Vu8tF31OSt3v8Zc6ipISs69OV9kjr2f6Q=="], + "@kadence/icons": ["@kadence/icons@github:stellarwp/kadence-icons#568e2a9", { "peerDependencies": { "react": ">=17 <19", "react-dom": ">=17 <19" } }, "stellarwp-kadence-icons-568e2a9"], "@keyv/bigmap": ["@keyv/bigmap@1.3.1", "", { "dependencies": { "hashery": "^1.4.0", "hookified": "^1.15.0" }, "peerDependencies": { "keyv": "^5.6.0" } }, "sha512-WbzE9sdmQtKy8vrNPa9BRnwZh5UF4s1KTmSK0KUVLo3eff5BlQNNWDnFOouNpKfPKDnms9xynJjsMYjMaT/aFQ=="], @@ -861,6 +895,8 @@ "@tannin/postfix": ["@tannin/postfix@1.1.0", "", {}, "sha512-oocsqY7g0cR+Gur5jRQLSrX2OtpMLMse1I10JQBm8CdGMrDkh1Mg2gjsiquMHRtBs4Qwu5wgEp5GgIYHk4SNPw=="], + "@tannin/sprintf": ["@tannin/sprintf@1.3.3", "", {}, "sha512-RwARl+hFwhzy0tg9atWcchLFvoQiOh4rrP7uG2N5E4W80BPCUX0ElcUR9St43fxB9EfjsW2df9Qp+UsTbvQDjA=="], + "@tootallnate/once": ["@tootallnate/once@2.0.1", "", {}, "sha512-HqmEUIGRJ5fSXchkVgR5F7qn48bDBzv0kWj/Kfu5e6uci4UlEeng4331LnBkWffb++Ei3FOVLxo8JJWMFBDMeQ=="], "@tootallnate/quickjs-emscripten": ["@tootallnate/quickjs-emscripten@0.23.0", "", {}, "sha512-C5Mc6rdnsaJDjO3UpGW/CQTHtCKaYlScZTly4JIu97Jxo/odCiH0ITnDXSJPTOrEKk/ycSZ0AOgTmkDtkOsvIA=="], @@ -893,6 +929,10 @@ "@types/graceful-fs": ["@types/graceful-fs@4.1.9", "", { "dependencies": { "@types/node": "*" } }, "sha512-olP3sd1qOEe5dXTSaFvQG+02VdRXcdytWLAZsAq1PecU8uqQAhkrnbli7DagjtXKW/Bl7YJbUsa8MPcuc8LHEQ=="], + "@types/gradient-parser": ["@types/gradient-parser@1.1.0", "", {}, "sha512-SaEcbgQscHtGJ1QL+ajgDTmmqU2f6T+00jZRcFlVHUW2Asivc84LNUev/UQFyu117AsdyrtI+qpwLvgjJXJxmw=="], + + "@types/highlight-words-core": ["@types/highlight-words-core@1.2.3", "", {}, "sha512-PWNU/NR0CaYEsK38mcCTyDzeS2TlEGK9kRhRMz1i86jVAe836ZlA3gl6QYpu+CG6IpfNKTgWpEnJuRededvC0g=="], + "@types/http-errors": ["@types/http-errors@2.0.5", "", {}, "sha512-r8Tayk8HJnX0FztbZN7oVqGccWgw98T/0neJphO91KkmOzug1KkofZURD4UaD5uH8AqcFLfdPErnBod0u71/qg=="], "@types/http-proxy": ["@types/http-proxy@1.17.17", "", { "dependencies": { "@types/node": "*" } }, "sha512-ED6LB+Z1AVylNTu7hdzuBqOgMnvG/ld6wGCG8wFnAzKX5uyW2K3WD52v0gnLCTK/VLpXtKckgWuyScYK6cSPaw=="], @@ -913,6 +953,8 @@ "@types/minimist": ["@types/minimist@1.2.5", "", {}, "sha512-hov8bUuiLiyFPGyFPE1lwWhmzYbirOXQNNo40+y3zow8aFVTeyn3VWL0VFFfdNddA8S4Vf0Tc062rzyNr7Paag=="], + "@types/mousetrap": ["@types/mousetrap@1.6.15", "", {}, "sha512-qL0hyIMNPow317QWW/63RvL1x5MVMV+Ru3NaY9f/CuEpCqrmb7WeuK2071ZY5hczOnm38qExWM2i2WtkXLSqFw=="], + "@types/mysql": ["@types/mysql@2.15.26", "", { "dependencies": { "@types/node": "*" } }, "sha512-DSLCOXhkvfS5WNNPbfn2KdICAmk8lLc+/PNvnPnF7gOdMZCxopXduqv0OQ13y/yA/zXTSikZZqVgybUxOEg6YQ=="], "@types/node": ["@types/node@25.9.1", "", { "dependencies": { "undici-types": ">=7.24.0 <7.24.7" } }, "sha512-xfrlY7UD5rMJk3ZVJP8BNzS28J36YJg+xp+LPXV1TdWxr8uMH5A860QNxYDGQe/ylDSgjxE52Q9VnO7p75tJxg=="], @@ -1029,6 +1071,10 @@ "@unrs/resolver-binding-win32-x64-msvc": ["@unrs/resolver-binding-win32-x64-msvc@1.12.2", "", { "os": "win32", "cpu": "x64" }, "sha512-nAB74NfSNKknqQ1RrYj6uz8FcXEomu/MATJZxh/x+BArzN2U3JbOYC0APYzUIGhVY3m5hRxA8VPNdPBoG8txlA=="], + "@use-gesture/core": ["@use-gesture/core@10.3.1", "", {}, "sha512-WcINiDt8WjqBdUXye25anHiNxPc0VOrlT8F6LLkU6cycrOGUDyY/yyFmsg3k8i5OLvv25llc0QC45GhR/C8llw=="], + + "@use-gesture/react": ["@use-gesture/react@10.3.1", "", { "dependencies": { "@use-gesture/core": "10.3.1" }, "peerDependencies": { "react": ">= 16.8.0" } }, "sha512-Yy19y6O2GJq8f7CHf7L0nxL8bf4PZCPaVOCgJrusOeFHY1LvHgYXnmnXg6N5iwAnbgbZCDjo60SiM6IPJi9C5g=="], + "@webassemblyjs/ast": ["@webassemblyjs/ast@1.14.1", "", { "dependencies": { "@webassemblyjs/helper-numbers": "1.13.2", "@webassemblyjs/helper-wasm-bytecode": "1.13.2" } }, "sha512-nuBEDgQfm1ccRp/8bCQrx1frohyufl4JlbMMZ4P1wpeOfDhF6FQkxZJ1b/e+PLwr6X1Nhw6OLme5usuBWYBvuQ=="], "@webassemblyjs/floating-point-hex-parser": ["@webassemblyjs/floating-point-hex-parser@1.13.2", "", {}, "sha512-6oXyTOzbKxGH4steLbLNOu71Oj+C8Lg34n6CqRvqfS2O71BxY6ByfMDRhBytzknj9yGUPVJ1qIKhRlAwO1AovA=="], @@ -1065,34 +1111,58 @@ "@webpack-cli/serve": ["@webpack-cli/serve@2.0.5", "", { "peerDependencies": { "webpack": "5.x.x", "webpack-cli": "5.x.x" } }, "sha512-lqaoKnRYBdo1UgDX8uF24AfGMifWK19TxPmM5FHc2vAGxrJ/qtyUyFBWoY1tISZdelsQ5fBcOusifo5o5wSJxQ=="], + "@wordpress/a11y": ["@wordpress/a11y@4.53.0", "", { "dependencies": { "@wordpress/dom-ready": "^4.53.0", "@wordpress/i18n": "^6.26.0" } }, "sha512-m6/45U8Fhr2LyQiBinHDBEF/iFnMSbSh3vdjb4GPjIjujvomktUKknjedoUWEvJFRsR6UVjIrnRIGcZAznjUhg=="], + "@wordpress/babel-preset-default": ["@wordpress/babel-preset-default@8.47.0", "", { "dependencies": { "@babel/core": "7.25.7", "@babel/plugin-syntax-import-attributes": "7.26.0", "@babel/plugin-transform-react-jsx": "7.25.7", "@babel/plugin-transform-runtime": "7.25.7", "@babel/preset-env": "7.25.7", "@babel/preset-typescript": "7.25.7", "@wordpress/browserslist-config": "^6.47.0", "@wordpress/warning": "^3.47.0", "browserslist": "^4.21.10", "core-js": "^3.31.0", "react": "^19.2.4" } }, "sha512-PQBdCYkGIF0hPFfWyLJMVZSToh0gWlVyPNRy+h/U2XHIGX83CCWcY8+YB1xutP20KStFBmO9M/CNLfvSa5DKGw=="], - "@wordpress/base-styles": ["@wordpress/base-styles@9.0.0", "", {}, "sha512-sg9NOQkrponLpabONPB3vlsIFHv7GCRDCru3ym5UcASAHlCgBHzQjOReiVnhMjhJf7kZS2OU8TpYQcDJLAaItA=="], + "@wordpress/base-styles": ["@wordpress/base-styles@12.1.0", "", {}, "sha512-B8Ab7dU574B1lNtjnTolO340nnW+WeaztR4RFpoL6tyqWrvDU1hK6xcjQnuNtQYJc2ngH/MO/rZOVFaFa7HFxw=="], "@wordpress/browserslist-config": ["@wordpress/browserslist-config@6.47.0", "", {}, "sha512-ogoxvjDH6lH369uc1SLZkVWVkM/lFTQ9hkhzgn7egWigycdFydG7T76iUw0CvOkHlcxTJGIVaBXEUq7Y3oRqjQ=="], + "@wordpress/components": ["@wordpress/components@39.0.0", "", { "dependencies": { "@ariakit/react": "^0.4.35", "@date-fns/utc": "^2.1.1", "@emotion/cache": "^11.14.0", "@emotion/css": "^11.13.5", "@emotion/react": "^11.14.0", "@emotion/serialize": "^1.3.3", "@emotion/styled": "^11.14.1", "@emotion/utils": "^1.4.2", "@floating-ui/react-dom": "^2.1.9", "@types/gradient-parser": "^1.1.0", "@types/highlight-words-core": "^1.2.1", "@use-gesture/react": "^10.3.1", "@wordpress/a11y": "^4.53.0", "@wordpress/base-styles": "^12.1.0", "@wordpress/compose": "^8.6.0", "@wordpress/date": "^5.53.0", "@wordpress/deprecated": "^4.53.0", "@wordpress/dom": "^4.53.0", "@wordpress/element": "^8.5.0", "@wordpress/escape-html": "^3.53.0", "@wordpress/hooks": "^4.53.0", "@wordpress/html-entities": "^4.53.0", "@wordpress/i18n": "^6.26.0", "@wordpress/icons": "^15.4.0", "@wordpress/is-shallow-equal": "^5.53.0", "@wordpress/kebab-case": "^1.0.0", "@wordpress/keycodes": "^4.53.0", "@wordpress/primitives": "^4.53.0", "@wordpress/private-apis": "^1.53.0", "@wordpress/rich-text": "^7.53.0", "@wordpress/style-runtime": "^0.9.0", "@wordpress/ui": "^0.20.0", "@wordpress/warning": "^3.53.0", "change-case": "^4.1.2", "clsx": "^2.1.1", "colord": "^2.9.3", "csstype": "^3.2.3", "date-fns": "^4.4.0", "deepmerge": "^4.3.1", "fast-deep-equal": "^3.1.3", "framer-motion": "^11.15.0", "gradient-parser": "^1.1.1", "highlight-words-core": "^1.2.2", "is-plain-object": "^5.0.0", "memize": "^2.1.1", "path-to-regexp": "^6.2.1", "re-resizable": "^6.4.0", "react-colorful": "^5.6.1", "remove-accents": "^0.5.0", "uuid": "^14.0.0" }, "peerDependencies": { "@types/react": "^18 || ^19", "react": "^18 || ^19", "react-dom": "^18 || ^19" }, "optionalPeers": ["@types/react"] }, "sha512-gt7RRF95iH6HoFo1qOfe0mRPONIDgkDeuNoJO6g94W4mVKUf5HgSqqpLuwuuXb3RxINloCRvgucvU13I5DgjDg=="], + + "@wordpress/compose": ["@wordpress/compose@8.6.0", "", { "dependencies": { "@types/mousetrap": "^1.6.8", "@wordpress/deprecated": "^4.53.0", "@wordpress/dom": "^4.53.0", "@wordpress/element": "^8.5.0", "@wordpress/is-shallow-equal": "^5.53.0", "@wordpress/keycodes": "^4.53.0", "@wordpress/priority-queue": "^3.53.0", "@wordpress/private-apis": "^1.53.0", "@wordpress/undo-manager": "^1.53.0", "change-case": "^4.1.2", "mousetrap": "^1.6.5", "use-memo-one": "^1.1.1" }, "peerDependencies": { "@types/react": "^18 || ^19", "react": "^18 || ^19" }, "optionalPeers": ["@types/react"] }, "sha512-aurjKO5vgnKl3p4iRM/maMEB3z36e0FdAuJOvPTHKMUjd0OUk8n2M/n2mfRS68QxVHv8mmDm1IEg8zKobwIDmA=="], + + "@wordpress/data": ["@wordpress/data@10.53.0", "", { "dependencies": { "@wordpress/compose": "^8.6.0", "@wordpress/deprecated": "^4.53.0", "@wordpress/element": "^8.5.0", "@wordpress/is-shallow-equal": "^5.53.0", "@wordpress/priority-queue": "^3.53.0", "@wordpress/private-apis": "^1.53.0", "@wordpress/redux-routine": "^5.53.0", "deepmerge": "^4.3.1", "equivalent-key-map": "^0.2.2", "is-plain-object": "^5.0.0", "is-promise": "^4.0.0", "redux": "^5.0.1", "rememo": "^4.0.2", "use-memo-one": "^1.1.1" }, "peerDependencies": { "@types/react": "^18 || ^19", "react": "^18 || ^19" }, "optionalPeers": ["@types/react"] }, "sha512-J/TnOBv1pJaeHs0Wk+11jL0kvEf05ocOm1cA24KNbOsdysUpcCh2FKEokyfZaEVJOXjWoiuYFyAtpdXVr/tt+g=="], + + "@wordpress/date": ["@wordpress/date@5.53.0", "", { "dependencies": { "@wordpress/deprecated": "^4.53.0", "moment": "^2.29.4", "moment-timezone": "^0.5.40" } }, "sha512-Xk772AM0lrMSII79aUlE6aGdMo+BoKA6dr6H3xKsCU7PXl+FRH+BHIaOT5D/bSHA/zLOyMTDLDrcNetAaQez/A=="], + "@wordpress/dependency-extraction-webpack-plugin": ["@wordpress/dependency-extraction-webpack-plugin@6.47.0", "", { "dependencies": { "json2php": "^0.0.7" }, "peerDependencies": { "webpack": "^5.0.0" } }, "sha512-fY8yFrvrj7c/tVmoaxm0TcHtsMYGh7nNxB1YTl2NOLUUGCVudby+ts1TWKTttN7vXY3TkRKsEuUL+4X3ToV1WQ=="], - "@wordpress/deprecated": ["@wordpress/deprecated@4.47.0", "", { "dependencies": { "@wordpress/hooks": "^4.47.0" } }, "sha512-SPmYu3Ihqfaqve4xEKf8+SAhae9UuYLncFovXHHEHeNrKwldYyNy3fm+3Aifd/RK5r7Vc7nr0zONYkuhWkDlNw=="], + "@wordpress/deprecated": ["@wordpress/deprecated@4.53.0", "", { "dependencies": { "@wordpress/hooks": "^4.53.0" } }, "sha512-JaIWiGVoKEmsiWP4XwAZvrET44T34EtPG+xCJe9vPIs9O3DHPyB83VHV4WxVRxddaf1osTmR6iPLx0sBvVTjZw=="], + + "@wordpress/dom": ["@wordpress/dom@4.53.0", "", { "dependencies": { "@wordpress/deprecated": "^4.53.0" } }, "sha512-cf+WkRxuXtPLmAWXYShsbitUIkPOjIgiScUJQztA4OSqy9vfSPvrOgb6pUqijPiIo9+fhBSoyryOFCOg7xABOQ=="], + + "@wordpress/dom-ready": ["@wordpress/dom-ready@4.53.0", "", {}, "sha512-VsTqZZ3XTHDG7K+vbleB/aV2KiRmpBLpOrcs9UplS/q0v2LLBc5aCb1UyGeXLynzlIDszYwJFpBVAQIBFRu44A=="], "@wordpress/e2e-test-utils-playwright": ["@wordpress/e2e-test-utils-playwright@1.47.0", "", { "dependencies": { "change-case": "^4.1.2", "get-port": "^5.1.1", "lighthouse": "^12.2.2", "mime": "^3.0.0", "web-vitals": "^4.2.1" }, "peerDependencies": { "@playwright/test": ">=1", "@types/node": "^20.17.10" } }, "sha512-ddDmuW+QaK9g2jsbZi/WWTEDIY3BaO17XLEIIw2vAXksiFTffFlaWh13f85Tl8Md68qZQvG89hEJ++y8DRmNKQ=="], - "@wordpress/element": ["@wordpress/element@6.46.0", "", { "dependencies": { "@types/react": "^18.3.27", "@types/react-dom": "^18.3.1", "@wordpress/escape-html": "^3.46.0", "change-case": "^4.1.2", "is-plain-object": "^5.0.0", "react": "^18.3.0", "react-dom": "^18.3.0" } }, "sha512-hjnrqZi0cZVdkmN0xQavKfSQJYAkb9pVSnDPpuX65OLxeD9/EWkIXvFzBb+nH8c4NzKKSqQU96XCTQrH37OCIA=="], + "@wordpress/element": ["@wordpress/element@8.5.0", "", { "dependencies": { "@wordpress/deprecated": "^4.53.0", "@wordpress/escape-html": "^3.53.0", "change-case": "^4.1.2", "is-plain-object": "^5.0.0" }, "peerDependencies": { "@types/react": "^18 || ^19", "@types/react-dom": "^18 || ^19", "react": "^18 || ^19", "react-dom": "^18 || ^19" }, "optionalPeers": ["@types/react", "@types/react-dom"] }, "sha512-d6Ct+JETXRoGjfAxu5kSPjportHloZ3auAPLguQOLEoNBiZJp60fslYYd6LeVw7M7dUR3lArwcYVK0x0G06c9Q=="], - "@wordpress/escape-html": ["@wordpress/escape-html@3.47.0", "", {}, "sha512-3D3dlMxpfc3rTrxASc5osqIR3gp+WgQSn8aqN+1zP8VctM0hm7HdzIix0LwPbyw64DfLiG/jnlRBrtHF6S9UQw=="], + "@wordpress/escape-html": ["@wordpress/escape-html@3.53.0", "", {}, "sha512-6EE4hOsd0kUp4bO9voTsIeK0oa80FYMbxvJkjN9Vitnf0ZTRVB7Iz2IviaYorhGUDemlRy3kOPEZdP9DA/CoCA=="], "@wordpress/eslint-plugin": ["@wordpress/eslint-plugin@22.22.0", "", { "dependencies": { "@babel/eslint-parser": "7.25.7", "@typescript-eslint/eslint-plugin": "^6.4.1", "@typescript-eslint/parser": "^6.4.1", "@wordpress/babel-preset-default": "^8.36.0", "@wordpress/prettier-config": "^4.36.0", "cosmiconfig": "^7.0.0", "eslint-config-prettier": "^8.3.0", "eslint-import-resolver-typescript": "^4.4.4", "eslint-plugin-import": "^2.25.2", "eslint-plugin-jest": "^27.4.3", "eslint-plugin-jsdoc": "^46.4.6", "eslint-plugin-jsx-a11y": "^6.5.1", "eslint-plugin-playwright": "^0.15.3", "eslint-plugin-prettier": "^5.0.0", "eslint-plugin-react": "^7.27.0", "eslint-plugin-react-hooks": "^4.3.0", "globals": "^13.12.0", "requireindex": "^1.2.0" }, "peerDependencies": { "@babel/core": ">=7", "eslint": ">=8", "prettier": ">=3", "typescript": ">=5" }, "optionalPeers": ["prettier", "typescript"] }, "sha512-DLGm5i8Gn0vjkZGKF49U2pYME5Jl9AvmoMJB2G508d+sB/oTSkPmM0baUP7G5zxbd1aqfNTaD0KjdyGyWFFKOA=="], "@wordpress/hooks": ["@wordpress/hooks@4.47.0", "", {}, "sha512-OTbg9axYyz585FvrNzyi3hBV2LHfl2oYr2M8xmQKndkOftxQra/04Hqnrflim7IKOzKR4EfL/KpyoqhQ0mrVHQ=="], + "@wordpress/html-entities": ["@wordpress/html-entities@4.53.0", "", {}, "sha512-ACj7S5XnXtyWy6NZ4sFh+7haaZ6DFxCNXoTSCk/sEpw9nNN6ISUzTgVXmXXocTA/+ioU6bQYIISSkYXWE1TrWw=="], + "@wordpress/i18n": ["@wordpress/i18n@5.26.0", "", { "dependencies": { "@babel/runtime": "7.25.7", "@wordpress/hooks": "^4.26.0", "gettext-parser": "^1.3.1", "memize": "^2.1.0", "sprintf-js": "^1.1.1", "tannin": "^1.2.0" }, "bin": { "pot-to-php": "./tools/pot-to-php.js" } }, "sha512-YHzaUWlCuN2ynl47qbsdMkTGtP52+E1giDOdWBgUaSexUYjbeFxKFUzRMB0Wuh1psL80+VzvJOH/mU440KAJnA=="], "@wordpress/icons": ["@wordpress/icons@10.32.0", "", { "dependencies": { "@babel/runtime": "7.25.7", "@wordpress/element": "^6.32.0", "@wordpress/primitives": "^4.32.0" } }, "sha512-1WvJdT361X1LnetYBpBWUjAVXZzl+pBdIwHbYRAp8ej47EI/igPmNxmq81nFd40s8fer/9qtipielcqSI6H2rA=="], + "@wordpress/is-shallow-equal": ["@wordpress/is-shallow-equal@5.53.0", "", {}, "sha512-NHhvEnqi82Vzon458Jz6nzmbAPWM1zy9k6rBXQTc+9PsRiWHWpqXqldKAeTFVrl0vspZf4PwmLlsxqP3ckCLWw=="], + "@wordpress/jest-console": ["@wordpress/jest-console@8.47.0", "", { "dependencies": { "jest-matcher-utils": "^29.6.2", "jest-mock": "^29.6.2" }, "peerDependencies": { "jest": ">=29" } }, "sha512-FM1ySjABL6kdmDWPkEhy12CFiD/GH1OXSH5hUKXssIkrPvWrygrVMU38Yi4DKeWD82C8UZ92VEO2RHOZwCiSLg=="], "@wordpress/jest-preset-default": ["@wordpress/jest-preset-default@12.47.0", "", { "dependencies": { "@wordpress/jest-console": "^8.47.0", "babel-jest": "29.7.0" }, "peerDependencies": { "@babel/core": ">=7", "jest": ">=29" } }, "sha512-L9JIFxRCnMr5G/CR+Npdva2pj7o/Yh629QX9W+rT4dW4Oq+yXqZE64T0eva/V8brz6//0FLrNNKtYXdXXtD+ZQ=="], + "@wordpress/kebab-case": ["@wordpress/kebab-case@1.0.0", "", { "dependencies": { "change-case": "^4.1.2" } }, "sha512-Ep7dCpM9B1PiP2WZyjI5dFnJJbTZA6melU/hu5tnvYBtzOdywqSjH4mtOsBY3CtQ0uJ5fQvFAP3tHuh6Si7Bsw=="], + + "@wordpress/keycodes": ["@wordpress/keycodes@4.53.0", "", { "dependencies": { "@wordpress/i18n": "^6.26.0" }, "peerDependencies": { "@types/react": "^18 || ^19" }, "optionalPeers": ["@types/react"] }, "sha512-e2o0NjkyGpPUGz8sfRd1OeEHdeOk3UVlL1J8P4Y9/fgQQJumTjulbiwps6yheE5kRNqbrh2o424QLdMaODu9Kw=="], + + "@wordpress/notices": ["@wordpress/notices@5.53.0", "", { "dependencies": { "@wordpress/a11y": "^4.53.0", "@wordpress/components": "^39.0.0", "@wordpress/data": "^10.53.0", "clsx": "^2.1.1" }, "peerDependencies": { "@types/react": "^18 || ^19", "react": "^18 || ^19" }, "optionalPeers": ["@types/react"] }, "sha512-qrsYsQFhHHeAXHc3h86TP7oJR07I9NOZlyMPurHlKDezLPpacALhhA2RMW0aShPyM8vNJzH+ctpzub2kjLZfKA=="], + "@wordpress/npm-package-json-lint-config": ["@wordpress/npm-package-json-lint-config@5.47.0", "", { "peerDependencies": { "npm-package-json-lint": ">=6.0.0" } }, "sha512-Xn8hqvwDGKAv6VxsNbsLU/+y60vJjhh/8XlSSMJtx/mfGCC6d6W7p8JEdSji4oixbBI4aXg3zRX3zNpvKKKqHg=="], "@wordpress/postcss-plugins-preset": ["@wordpress/postcss-plugins-preset@5.47.0", "", { "dependencies": { "@wordpress/base-styles": "^9.0.0", "autoprefixer": "^10.4.20", "postcss-import": "^16.1.1" }, "peerDependencies": { "postcss": "^8.0.0" } }, "sha512-O5JbrKYhXjNsMINhFlXyR91YDw3lP5Ld62XMrHflx8F9bQ0PG/4aAMwPSI+Qazuw0GBeP5qbUaAZoeHo6tsEPA=="], @@ -1101,16 +1171,26 @@ "@wordpress/primitives": ["@wordpress/primitives@4.47.0", "", { "dependencies": { "@wordpress/element": "^7.0.0", "clsx": "^2.1.1" }, "peerDependencies": { "react": "^19.2.4" } }, "sha512-Y1uhC6BiLFzORtXnMa07o3DVXG0z+q2KV6g48ClpZJ9aDiehBfdThBHwa6oa7HbYX/yAoMuCkuA7fWbm3zYxNw=="], - "@wordpress/private-apis": ["@wordpress/private-apis@1.47.0", "", {}, "sha512-DfwLsmencI2LUZhY6u1aZCwZYO1ILuyJf7Cn15G/gVbPlA7pBJp9YVFk+3FR5U35I0e0infNMDDn8u5632urmQ=="], + "@wordpress/priority-queue": ["@wordpress/priority-queue@3.53.0", "", { "dependencies": { "requestidlecallback": "^0.3.0" } }, "sha512-HQ5AatN1QWimFHQnhhhzrfgNoiVWTqwhUEv5326hhTnyUxvh5SOYxg46IBGow+zj/VJjIPyaxv1ftuqzVxgRMQ=="], + + "@wordpress/private-apis": ["@wordpress/private-apis@1.53.0", "", {}, "sha512-xXW2yeBC0n/doFLsv6chEl3Qs5phqmRH7wcUyil+Xvh3msVGzUJxvyo0szmKpQcmoYafASpkQux82HCtNp6jxQ=="], + + "@wordpress/redux-routine": ["@wordpress/redux-routine@5.53.0", "", { "dependencies": { "is-plain-object": "^5.0.0", "is-promise": "^4.0.0", "rungen": "^0.3.2" }, "peerDependencies": { "redux": ">=4" } }, "sha512-brrkZHfYSLUFYKrDkxJLTTRXmZbKNAS8iJnWPOWxjBf4QGeOoBPaVaiGHsMjzQZL98lHox8vHeytUW0Id2Px1g=="], + + "@wordpress/rich-text": ["@wordpress/rich-text@7.53.0", "", { "dependencies": { "@wordpress/a11y": "^4.53.0", "@wordpress/compose": "^8.6.0", "@wordpress/data": "^10.53.0", "@wordpress/deprecated": "^4.53.0", "@wordpress/dom": "^4.53.0", "@wordpress/element": "^8.5.0", "@wordpress/escape-html": "^3.53.0", "@wordpress/i18n": "^6.26.0", "@wordpress/keycodes": "^4.53.0", "@wordpress/private-apis": "^1.53.0", "colord": "^2.9.3" }, "peerDependencies": { "@types/react": "^18 || ^19", "react": "^18 || ^19" }, "optionalPeers": ["@types/react"] }, "sha512-61+P7ht578CcfTePf8sb0/rixIyf4k8fmOn9mvwwmLL8UiIgBhpPzrRJziy8/+Xb4u3grTtl8TGtMI2YHRz41w=="], "@wordpress/scripts": ["@wordpress/scripts@30.27.0", "", { "dependencies": { "@babel/core": "7.25.7", "@pmmmwh/react-refresh-webpack-plugin": "^0.5.11", "@svgr/webpack": "^8.0.1", "@wordpress/babel-preset-default": "^8.34.0", "@wordpress/browserslist-config": "^6.34.0", "@wordpress/dependency-extraction-webpack-plugin": "^6.34.0", "@wordpress/e2e-test-utils-playwright": "^1.34.0", "@wordpress/eslint-plugin": "^22.20.0", "@wordpress/jest-preset-default": "^12.34.0", "@wordpress/npm-package-json-lint-config": "^5.34.0", "@wordpress/postcss-plugins-preset": "^5.34.0", "@wordpress/prettier-config": "^4.34.0", "@wordpress/stylelint-config": "^23.26.0", "adm-zip": "^0.5.9", "babel-jest": "29.7.0", "babel-loader": "9.2.1", "browserslist": "^4.21.10", "chalk": "^4.0.0", "check-node-version": "^4.1.0", "copy-webpack-plugin": "^10.2.0", "cross-spawn": "^7.0.6", "css-loader": "^6.2.0", "cssnano": "^6.0.1", "cwd": "^0.10.0", "dir-glob": "^3.0.1", "eslint": "^8.3.0", "expect-puppeteer": "^4.4.0", "fast-glob": "^3.2.7", "filenamify": "^4.2.0", "jest": "^29.6.2", "jest-dev-server": "^10.1.4", "jest-environment-jsdom": "^29.6.2", "jest-environment-node": "^29.6.2", "json2php": "^0.0.9", "markdownlint-cli": "^0.31.1", "merge-deep": "^3.0.3", "mini-css-extract-plugin": "^2.9.2", "minimist": "^1.2.0", "npm-package-json-lint": "^6.4.0", "npm-packlist": "^3.0.0", "postcss": "^8.4.5", "postcss-loader": "^6.2.1", "prettier": "npm:wp-prettier@3.0.3", "puppeteer-core": "^23.10.1", "react-refresh": "^0.14.0", "read-pkg-up": "^7.0.1", "resolve-bin": "^0.4.0", "rtlcss": "^4.3.0", "sass": "^1.54.0", "sass-loader": "^16.0.3", "schema-utils": "^4.2.0", "source-map-loader": "^3.0.0", "stylelint": "^16.8.2", "terser-webpack-plugin": "^5.3.10", "url-loader": "^4.1.1", "webpack": "^5.97.0", "webpack-bundle-analyzer": "^4.9.1", "webpack-cli": "^5.1.4", "webpack-dev-server": "^4.15.1" }, "peerDependencies": { "@playwright/test": "^1.56.1", "@wordpress/env": "^10.0.0", "react": "^18.0.0", "react-dom": "^18.0.0" }, "optionalPeers": ["@wordpress/env"], "bin": { "wp-scripts": "./bin/wp-scripts.js" } }, "sha512-gXGptazCxAaR7g8kcN5joj7B5fCm0VeBHOmnDBs2dbQ4W4F3tfzdg6CTEj8LonF9bWQXlSy3ku8EqWCdkSG9Xw=="], - "@wordpress/style-runtime": ["@wordpress/style-runtime@0.3.0", "", {}, "sha512-CWSGDSIjHO6Ww/BK0jfF6WbVLQWoQNEUEeh4/YBFpMrzjWvhS7RD5ZGt88HZkazEXywovA6q2302OZsyfzP/zA=="], + "@wordpress/style-runtime": ["@wordpress/style-runtime@0.9.0", "", {}, "sha512-K2T4OfVbqgsp07zi7C6UemlJK7fF78EPmxFYuxSjnbbB14fJcOxX+Tqi/4y24hn9ECahoGjCKHZCY2U2kts8dQ=="], "@wordpress/stylelint-config": ["@wordpress/stylelint-config@23.39.0", "", { "dependencies": { "@stylistic/stylelint-plugin": "^3.0.1", "@wordpress/theme": "^0.14.0", "stylelint-config-recommended": "^14.0.1", "stylelint-config-recommended-scss": "^14.1.0" }, "peerDependencies": { "stylelint": "^16.8.2", "stylelint-scss": "^6.4.0" } }, "sha512-JnEn92PHqgmDo9+ddtauFvUgJhDVKZQLBgDv8DR28nEGtALrIRK63bd2ZK0EyF7JK7jRaUMFAJ4ryPeoy1VdMw=="], "@wordpress/theme": ["@wordpress/theme@0.14.0", "", { "dependencies": { "@wordpress/element": "^7.0.0", "@wordpress/private-apis": "^1.47.0", "@wordpress/style-runtime": "^0.3.0", "colorjs.io": "^0.6.0", "memize": "^2.1.0" }, "peerDependencies": { "react": "^19.2.4", "react-dom": "^19.2.4", "stylelint": "^16.8.2" }, "optionalPeers": ["stylelint"] }, "sha512-Z03kSyK7k1mSWgUE64/Grg7O3EdYIDqkbBjv0f91keb7b/asZgfIHynNhdyg05FQXcRHn8NJhP/cZOVwnyII8A=="], + "@wordpress/ui": ["@wordpress/ui@0.20.0", "", { "dependencies": { "@base-ui/react": "^1.6.0", "@daypicker/react": "^10.0.1", "@wordpress/a11y": "^4.53.0", "@wordpress/compose": "^8.6.0", "@wordpress/element": "^8.5.0", "@wordpress/i18n": "^6.26.0", "@wordpress/icons": "^15.4.0", "@wordpress/keycodes": "^4.53.0", "@wordpress/primitives": "^4.53.0", "@wordpress/private-apis": "^1.53.0", "@wordpress/style-runtime": "^0.9.0", "@wordpress/theme": "^1.2.0", "clsx": "^2.1.1", "date-fns": "^4.4.0", "tabbable": "^6.4.0" }, "peerDependencies": { "@types/react": "^18 || ^19", "react": "^18 || ^19", "react-dom": "^18 || ^19" }, "optionalPeers": ["@types/react"] }, "sha512-otLrXwHKekMy9RX3z/vlTWDwvtQlZW18niCOWcd7FtzSWZYRk4Nu7wwRLEv4oq3HyuTCbL+oOOOBPeQrN9IyeQ=="], + + "@wordpress/undo-manager": ["@wordpress/undo-manager@1.53.0", "", { "dependencies": { "@wordpress/is-shallow-equal": "^5.53.0" } }, "sha512-0MtlfeCa0uFWAGubP2rAJ1NoWQOWOuzW0kTwZgqfFFg81HEgNIBb8LU3eXMbMxERjdZYpCrqUL3MbVPl7ExiGw=="], + "@wordpress/url": ["@wordpress/url@4.47.0", "", { "dependencies": { "remove-accents": "^0.5.0" } }, "sha512-34UAKyzb7R4JhNgSFVQa9hu1aojlK6EtWsHWq9yEgz925PJ//EV6sfqHXFT5I6eKx+k5PNMjkrk4VxFYP6MZcg=="], "@wordpress/warning": ["@wordpress/warning@3.47.0", "", {}, "sha512-z4jb5zAMY1rFjNUMLaWz9BoHUe8uKfLqgM/20FooynH/AN9nKPBruJmiOOQvT+5m0sIZ8i7roGW2OdpRjtWP2g=="], @@ -1573,6 +1653,8 @@ "data-view-byte-offset": ["data-view-byte-offset@1.0.1", "", { "dependencies": { "call-bound": "^1.0.2", "es-errors": "^1.3.0", "is-data-view": "^1.0.1" } }, "sha512-BS8PfmtDGnrgYdOonGZQdLZslWIeCGFP9tpan0hi1Co2Zr2NKADsvGYA8XxuG/4UWgJ6Cjtv+YJnB6MM69QGlQ=="], + "date-fns": ["date-fns@4.4.0", "", {}, "sha512-+1UMbeh68lH1SegH83CGWwpb6OHHbpSgr3+s5Eww5M4CAgswBpoWS0AjTOfEJ33HiYKz1hdj/KTFprzXHmq/6w=="], + "debounce": ["debounce@1.2.1", "", {}, "sha512-XRRe6Glud4rd/ZGQfiV1ruXSfbvfJedlV9Y6zOlP+2K04vBYiJEte6stfFkCP03aMnY5tsipamumUjL14fofug=="], "debug": ["debug@3.2.7", "", { "dependencies": { "ms": "^2.1.1" } }, "sha512-CFjzYYAi4ThfiQvizrFQevTTXHtnCqWfe7x1AhgEscTz6ZbLbfoLRLPugTQyBth6f8ZERVUSyWHFD/7Wu4t1XQ=="], @@ -1677,6 +1759,8 @@ "envinfo": ["envinfo@7.21.0", "", { "bin": { "envinfo": "dist/cli.js" } }, "sha512-Lw7I8Zp5YKHFCXL7+Dz95g4CcbMEpgvqZNNq3AmlT5XAV6CgAAk6gyAMqn2zjw08K9BHfcNuKrMiCPLByGafow=="], + "equivalent-key-map": ["equivalent-key-map@0.2.2", "", {}, "sha512-xvHeyCDbZzkpN4VHQj/n+j2lOwL0VWszG30X4cOrc9Y7Tuo2qCdZK/0AMod23Z5dCtNUbaju6p0rwOhHUk05ew=="], + "error-ex": ["error-ex@1.3.4", "", { "dependencies": { "is-arrayish": "^0.2.1" } }, "sha512-sqQamAnR14VgCr1A618A3sGrygcpK+HEbenA/HiEAkkUwcZIIB/tgWqHFxWgOyDh4nB4JCRimh79dR5Ywc9MDQ=="], "error-stack-parser": ["error-stack-parser@2.1.4", "", { "dependencies": { "stackframe": "^1.3.4" } }, "sha512-Sk5V6wVazPhq5MhpO+AUxJn5x7XSXGl1R93Vn7i+zS15KDVxQijejNCrz8340/2bgLBjR9GtEG8ZVKONDjcqGQ=="], @@ -1865,6 +1949,8 @@ "fraction.js": ["fraction.js@5.3.4", "", {}, "sha512-1X1NTtiJphryn/uLQz3whtY6jK3fTqoE3ohKs0tT+Ujr1W59oopxmoEh7Lu5p6vBaPbgoM0bzveAW4Qi5RyWDQ=="], + "framer-motion": ["framer-motion@11.18.2", "", { "dependencies": { "motion-dom": "^11.18.1", "motion-utils": "^11.18.1", "tslib": "^2.4.0" }, "peerDependencies": { "@emotion/is-prop-valid": "*", "react": "^18.0.0 || ^19.0.0", "react-dom": "^18.0.0 || ^19.0.0" }, "optionalPeers": ["@emotion/is-prop-valid", "react", "react-dom"] }, "sha512-5F5Och7wrvtLVElIpclDT0CBzMVg3dL22B64aZwHtsIY8RB4mXICLrkajK4G9R+ieSAGcgrLeae2SeUTg2pr6w=="], + "fresh": ["fresh@0.5.2", "", {}, "sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q=="], "fs-exists-sync": ["fs-exists-sync@0.1.0", "", {}, "sha512-cR/vflFyPZtrN6b38ZyWxpWdhlXrzZEBawlpBQMq7033xVY7/kg0GDMBK5jg8lDYQckdJ5x/YC88lM3C7VMsLg=="], @@ -1985,6 +2071,8 @@ "header-case": ["header-case@2.0.4", "", { "dependencies": { "capital-case": "^1.0.4", "tslib": "^2.0.3" } }, "sha512-H/vuk5TEEVZwrR0lp2zed9OCo1uAILMlx0JEMgC26rzyJJ3N1v6XkwHHXJQdR2doSjcGPM6OKPYoJgf0plJ11Q=="], + "highlight-words-core": ["highlight-words-core@1.2.3", "", {}, "sha512-m1O9HW3/GNHxzSIXWw1wCNXXsgLlxrP0OI6+ycGUhiUHkikqW3OrwVHz+lxeNBe5yqLESdIcj8PowHQ2zLvUvQ=="], + "hoist-non-react-statics": ["hoist-non-react-statics@3.3.2", "", { "dependencies": { "react-is": "^16.7.0" } }, "sha512-/gGivxi8JPKWNm/W0jSmzcMPpfpPLc3dY/6GxhX2hQ9iGj3aDfklV4ET7NjKpSinLpJ5vafa9iiGIEZg10SfBw=="], "homedir-polyfill": ["homedir-polyfill@1.0.3", "", { "dependencies": { "parse-passwd": "^1.0.0" } }, "sha512-eSmmWE5bZTK2Nou4g0AI3zZ9rswp7GRKoKXS1BLUkvPviOqs4YTN1djQIqrXy9k5gEtdLPy86JjRwsNM9tnDcA=="], @@ -2139,6 +2227,8 @@ "is-potential-custom-element-name": ["is-potential-custom-element-name@1.0.1", "", {}, "sha512-bCYeRA2rVibKZd+s2625gGnGF/t7DSqDs4dP7CrLA1m7jKWz6pps0LpYLJN8Q64HtmPKJ1hrN3nzPNKFEKOUiQ=="], + "is-promise": ["is-promise@4.0.0", "", {}, "sha512-hvpoI6korhJMnej285dSg6nu1+e6uxs7zG3BYAm5byqDsgJNWwxzM6z6iZiAgQR4TJ30JmBTOwqZUw3WlyH3AQ=="], + "is-regex": ["is-regex@1.2.1", "", { "dependencies": { "call-bound": "^1.0.2", "gopd": "^1.2.0", "has-tostringtag": "^1.0.2", "hasown": "^2.0.2" } }, "sha512-MjYsKHO5O7mCsmRGxWcLWheFqN9DJ/2TmngvjKXihe6efViPqc274+Fx/4fYj/r03+ESvBdTXK0V6tA3rgez1g=="], "is-relative": ["is-relative@1.0.0", "", { "dependencies": { "is-unc-path": "^1.0.0" } }, "sha512-Kw/ReK0iqwKeu0MITLFuj0jbPAmEiOsIwyIXvvbfa6QfmN9pkD1M+8pdk7Rl/dTKbH34/XBFMbgD4iMJhLQbGA=="], @@ -2443,6 +2533,16 @@ "module-details-from-path": ["module-details-from-path@1.0.4", "", {}, "sha512-EGWKgxALGMgzvxYF1UyGTy0HXX/2vHLkw6+NvDKW2jypWbHpjQuj4UMcqQWXHERJhVGKikolT06G3bcKe4fi7w=="], + "moment": ["moment@2.30.1", "", {}, "sha512-uEmtNhbDOrWPFS+hdjFCBfy9f2YoyzRpwcl+DqpC6taX21FzsTLQVbMV/W7PzNSX6x/bhC1zA3c2UQ5NzH6how=="], + + "moment-timezone": ["moment-timezone@0.5.48", "", { "dependencies": { "moment": "^2.29.4" } }, "sha512-f22b8LV1gbTO2ms2j2z13MuPogNoh5UzxL3nzNAYKGraILnbGc9NEE6dyiiiLv46DGRb8A4kg8UKWLjPthxBHw=="], + + "motion-dom": ["motion-dom@11.18.1", "", { "dependencies": { "motion-utils": "^11.18.1" } }, "sha512-g76KvA001z+atjfxczdRtw/RXOM3OMSdd1f4DL77qCTF/+avrRJiawSG4yDibEQ215sr9kpinSlX2pCTJ9zbhw=="], + + "motion-utils": ["motion-utils@11.18.1", "", {}, "sha512-49Kt+HKjtbJKLtgO/LKj9Ld+6vw9BjH5d9sc40R/kVyH8GLAXgT42M2NnuPcJNuA3s9ZfZBUcwIgpmZWGEE+hA=="], + + "mousetrap": ["mousetrap@1.6.5", "", {}, "sha512-QNo4kEepaIBwiT8CDhP98umTetp+JNfQYBWvC1pc6/OAibuXtRcxZ58Qz8skvEHYvURne/7R8T5VoOI7rDsEUA=="], + "mrmime": ["mrmime@2.0.1", "", {}, "sha512-Y3wQdFg2Va6etvQ5I82yUhGdsKrcYox6p7FfL1LbK2J4V01F9TGlepTIhnK24t7koZibmg82KGglhA1XK5IsLQ=="], "ms": ["ms@2.1.3", "", {}, "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="], @@ -2585,7 +2685,7 @@ "path-root-regex": ["path-root-regex@0.1.2", "", {}, "sha512-4GlJ6rZDhQZFE0DPVKh0e9jmZ5egZfxTkp7bcRDuPlJXbAwhxcl2dINPUAsjLdejqaLsCeg8axcLjIbvBjN4pQ=="], - "path-to-regexp": ["path-to-regexp@0.1.13", "", {}, "sha512-A/AGNMFN3c8bOlvV9RreMdrv7jsmF9XIfDeCd87+I8RNg6s78BhJxMu69NEMHBSJFxKidViTEdruRwEk/WIKqA=="], + "path-to-regexp": ["path-to-regexp@6.3.0", "", {}, "sha512-Yhpw4T9C6hPpgPeA28us07OJeqZ5EzQTkbfwuhsUg0c237RomFoETJgmp2sa3F/41gfLE6G5cqcYwznmeEeOlQ=="], "path-type": ["path-type@4.0.0", "", {}, "sha512-gDKb8aZMDeD/tZWs9P6+q0J9Mwkdl6xMV8TjnGP3qJVJ06bdMgkbBlLU8IdfOsIsFz2BW1rNVT3XuNEl8zPAvw=="], @@ -2771,6 +2871,8 @@ "raw-body": ["raw-body@2.5.3", "", { "dependencies": { "bytes": "~3.1.2", "http-errors": "~2.0.1", "iconv-lite": "~0.4.24", "unpipe": "~1.0.0" } }, "sha512-s4VSOf6yN0rvbRZGxs8Om5CWj6seneMwK3oDb4lWDH0UPhWcxwOWw5+qk24bxq87szX1ydrwylIOp2uG1ojUpA=="], + "re-resizable": ["re-resizable@6.11.2", "", { "peerDependencies": { "react": "^16.13.1 || ^17.0.0 || ^18.0.0 || ^19.0.0", "react-dom": "^16.13.1 || ^17.0.0 || ^18.0.0 || ^19.0.0" } }, "sha512-2xI2P3OHs5qw7K0Ud1aLILK6MQxW50TcO+DetD9eIV58j84TqYeHoZcL9H4GXFXXIh7afhH8mv5iUCXII7OW7A=="], + "react": ["react@18.3.1", "", { "dependencies": { "loose-envify": "^1.1.0" } }, "sha512-wS+hAgJShR0KhEvPJArfuPVN1+Hz1t0Y6n5jLrGQbkb4urgPE/0Rve+1kMB1v/oWgHgm4WIcV+i7F2pTVj+2iQ=="], "react-ace": ["react-ace@14.0.1", "", { "dependencies": { "ace-builds": "^1.36.3", "diff-match-patch": "^1.0.5", "lodash.get": "^4.4.2", "lodash.isequal": "^4.5.0", "prop-types": "^15.8.1" }, "peerDependencies": { "react": "^0.13.0 || ^0.14.0 || ^15.0.1 || ^16.0.0 || ^17.0.0 || ^18.0.0 || ^19.0.0", "react-dom": "^0.13.0 || ^0.14.0 || ^15.0.1 || ^16.0.0 || ^17.0.0 || ^18.0.0 || ^19.0.0" } }, "sha512-z6YAZ20PNf/FqmYEic//G/UK6uw0rn21g58ASgHJHl9rfE4nITQLqthr9rHMVQK4ezwohJbp2dGrZpkq979PYQ=="], @@ -2779,10 +2881,14 @@ "react-color": ["react-color@2.19.3", "", { "dependencies": { "@icons/material": "^0.2.4", "lodash": "^4.17.15", "lodash-es": "^4.17.15", "material-colors": "^1.2.1", "prop-types": "^15.5.10", "reactcss": "^1.2.0", "tinycolor2": "^1.4.1" }, "peerDependencies": { "react": "*" } }, "sha512-LEeGE/ZzNLIsFWa1TMe8y5VYqr7bibneWmvJwm1pCn/eNmrabWDh659JSPn9BuaMpEfU83WTOJfnCcjDZwNQTA=="], + "react-colorful": ["react-colorful@5.8.0", "", { "peerDependencies": { "react": ">=16.8.0", "react-dom": ">=16.8.0" } }, "sha512-Wy9OzPfjSN9bF12OB8N7UQvlsZ0I+7wHxpN+bV5BjNQGxOj6IiwkRjevJK9yOBjJWGQvAaf1OXtn8rUeEatAng=="], + "react-countdown": ["react-countdown@2.3.6", "", { "dependencies": { "prop-types": "^15.7.2" }, "peerDependencies": { "react": ">= 15", "react-dom": ">= 15" } }, "sha512-ZfX6S08Hb6x6W6eCn1hMDvxPICI/T30fd+gaeVTCR/2cGZ2WJ3f26e4ImNIMX1fHkopJrUdnRpWXP13/D39+gg=="], "react-countup": ["react-countup@6.5.3", "", { "dependencies": { "countup.js": "^2.8.0" }, "peerDependencies": { "react": ">= 16.3.0" } }, "sha512-udnqVQitxC7QWADSPDOxVWULkLvKUWrDapn5i53HE4DPRVgs+Y5rr4bo25qEl8jSh+0l2cToJgGMx+clxPM3+w=="], + "react-day-picker": ["react-day-picker@10.0.1", "", { "dependencies": { "@date-fns/tz": "^1.4.1", "date-fns": "^4.1.0" }, "peerDependencies": { "@types/react": ">=16.8.0", "react": ">=16.8.0" }, "optionalPeers": ["@types/react"] }, "sha512-eNh6BlwcYInWaJtRv18mXQ06Ys/H6rdTZAnTaSdOYJuTpwP1JMCHNd1FDRadA+gbeinq+psdULN5Xnowy9mV8w=="], + "react-dom": ["react-dom@18.3.1", "", { "dependencies": { "loose-envify": "^1.1.0", "scheduler": "^0.23.2" }, "peerDependencies": { "react": "^18.3.1" } }, "sha512-5m4nQKp+rZRb09LNH59GM4BxTh9251/ylbKIbpe7TpGxfJ+9kv6BLkLBXIjjspbgbnIBNqlI23tRnTWT0snUIw=="], "react-google-recaptcha": ["react-google-recaptcha@3.1.0", "", { "dependencies": { "prop-types": "^15.5.0", "react-async-script": "^1.2.0" }, "peerDependencies": { "react": ">=16.4.1" } }, "sha512-cYW2/DWas8nEKZGD7SCu9BSuVz8iOcOLHChHyi7upUuVhkpkhYG/6N3KDiTQ3XAiZ2UAZkfvYKMfAHOzBOcGEg=="], @@ -2829,6 +2935,8 @@ "redent": ["redent@3.0.0", "", { "dependencies": { "indent-string": "^4.0.0", "strip-indent": "^3.0.0" } }, "sha512-6tDA8g98We0zd0GvVeMT9arEOnTw9qM03L9cJXaCjrip1OO764RDBLBfrB4cwzNGDj5OA5ioymC9GkizgWJDUg=="], + "redux": ["redux@5.0.1", "", {}, "sha512-M9/ELqF6fy8FwmkpnF0S3YKOqMyoWJ4+CS5Efg2ct3oY9daQvd/Pc71FpGZsVsbl3Cpb+IIcjBDUnnyBdQbq4w=="], + "reflect.getprototypeof": ["reflect.getprototypeof@1.0.10", "", { "dependencies": { "call-bind": "^1.0.8", "define-properties": "^1.2.1", "es-abstract": "^1.23.9", "es-errors": "^1.3.0", "es-object-atoms": "^1.0.0", "get-intrinsic": "^1.2.7", "get-proto": "^1.0.1", "which-builtin-type": "^1.2.1" } }, "sha512-00o4I+DVrefhv+nX0ulyi3biSHCPDe+yLv5o/p6d/UVlirijB8E16FtfwSAi4g3tcqrQ4lRAqQSoFEZJehYEcw=="], "regenerate": ["regenerate@1.4.2", "", {}, "sha512-zrceR/XhGYU/d/opr2EKO7aRHUeiBI8qjtfHqADTwZd6Szfy16la6kqD0MIUs5z5hx6AaKa+PixpPrR289+I0A=="], @@ -2845,6 +2953,8 @@ "regjsparser": ["regjsparser@0.13.1", "", { "dependencies": { "jsesc": "~3.1.0" }, "bin": { "regjsparser": "bin/parser" } }, "sha512-dLsljMd9sqwRkby8zhO1gSg3PnJIBFid8f4CQj/sXx+7cKx+E7u0PKhZ+U4wmhx7EfmtvnA318oVaIkAB1lRJw=="], + "rememo": ["rememo@4.0.2", "", {}, "sha512-NVfSP9NstE3QPNs/TnegQY0vnJnstKQSpcrsI2kBTB3dB2PkdfKdTa+abbjMIDqpc63fE5LfjLgfMst0ULMFxQ=="], + "remove-accents": ["remove-accents@0.5.0", "", {}, "sha512-8g3/Otx1eJaVD12e31UbJj1YzdtVvzH85HV7t+9MJYk/u3XmkOUJ5Ys9wQrf9PCPK8+xn4ymzqYCiZl6QWKn+A=="], "remove-trailing-separator": ["remove-trailing-separator@1.1.0", "", {}, "sha512-/hS+Y0u3aOfIETiaiirUFwDBDzmXPvO+jAfKTitUngIPzdKc6Z0LoFjM/CK5PL4C+eKwHohlHAb6H0VFfmmUsw=="], @@ -2853,6 +2963,8 @@ "replace-homedir": ["replace-homedir@2.0.0", "", {}, "sha512-bgEuQQ/BHW0XkkJtawzrfzHFSN70f/3cNOiHa2QsYxqrjaC30X1k74FJ6xswVBP0sr0SpGIdVFuPwfrYziVeyw=="], + "requestidlecallback": ["requestidlecallback@0.3.0", "", {}, "sha512-TWHFkT7S9p7IxLC5A1hYmAYQx2Eb9w1skrXmQ+dS1URyvR8tenMLl4lHbqEOUnpEYxNKpkVMXUgknVpBZWXXfQ=="], + "require-directory": ["require-directory@2.1.1", "", {}, "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q=="], "require-from-string": ["require-from-string@2.0.2", "", {}, "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw=="], @@ -2863,6 +2975,8 @@ "requires-port": ["requires-port@1.0.0", "", {}, "sha512-KigOCHcocU3XODJxsu8i/j8T9tzT4adHiecwORRQ0ZZFcp7ahwXuRU1m+yuO90C5ZUyGeGfocHDI14M3L3yDAQ=="], + "reselect": ["reselect@5.3.0", "", {}, "sha512-XGoLeRAVzUTcJ1qkxPQhDJyIZ5d6zzZD9nT7AEZOaaU9UbWclhycElmhO+VD5bFeLuzhPBaOV2oXC8uG35ZSpg=="], + "resolve": ["resolve@2.0.0-next.7", "", { "dependencies": { "es-errors": "^1.3.0", "is-core-module": "^2.16.2", "node-exports-info": "^1.6.0", "object-keys": "^1.1.1", "path-parse": "^1.0.7", "supports-preserve-symlinks-flag": "^1.0.0" }, "bin": { "resolve": "bin/resolve" } }, "sha512-tqt+NBWwyaMgw3zDsnygx4CByWjQEJHOPMdslYhppaQSJUtL/D4JO9CcBBlhPoI8lz9oJIDXkwXfhF4aWqP8xQ=="], "resolve-bin": ["resolve-bin@0.4.3", "", { "dependencies": { "find-parent-dir": "~0.3.0" } }, "sha512-9u8TMpc+SEHXxQXblXHz5yRvRZERkCZimFN9oz85QI3uhkh7nqfjm6OGTLg+8vucpXGcY4jLK6WkylPmt7GSvw=="], @@ -2893,6 +3007,8 @@ "run-parallel": ["run-parallel@1.2.0", "", { "dependencies": { "queue-microtask": "^1.2.2" } }, "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA=="], + "rungen": ["rungen@0.3.2", "", {}, "sha512-zWl10xu2D7zoR8zSC2U6bg5bYF6T/Wk7rxwp8IPaJH7f0Ge21G03kNHVgHR7tyVkSSfAOG0Rqf/Cl38JftSmtw=="], + "rxjs": ["rxjs@7.8.2", "", { "dependencies": { "tslib": "^2.1.0" } }, "sha512-dhKf903U/PQZY6boNNtAGdWbG85WAbjT/1xYoZIC7FAY0yWapOBQVsVrDl58W86//e1VpMNBtRV4MaXfdMySFA=="], "safe-array-concat": ["safe-array-concat@1.1.4", "", { "dependencies": { "call-bind": "^1.0.9", "call-bound": "^1.0.4", "get-intrinsic": "^1.3.0", "has-symbols": "^1.1.0", "isarray": "^2.0.5" } }, "sha512-wtZlHyOje6OZTGqAoaDKxFkgRtkF9CnHAVnCHKfuj200wAgL+bSJhdsCD2l0Qx/2ekEXjPWcyKkfGb5CPboslg=="], @@ -3241,11 +3357,15 @@ "use-isomorphic-layout-effect": ["use-isomorphic-layout-effect@1.2.1", "", { "peerDependencies": { "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0" } }, "sha512-tpZZ+EX0gaghDAiFR37hj5MgY6ZN55kLiPkJsKxBMZ6GZdOSPJXiOzPM984oPYZ5AnehYx5WQp1+ME8I/P/pRA=="], + "use-memo-one": ["use-memo-one@1.1.3", "", { "peerDependencies": { "react": "^16.8.0 || ^17.0.0 || ^18.0.0" } }, "sha512-g66/K7ZQGYrI6dy8GLpVcMsBp4s17xNkYJVSMvTEevGy3nDxHOfE6z8BVE22+5G5x7t3+bhzrlTDB7ObrEE0cQ=="], + + "use-sync-external-store": ["use-sync-external-store@1.6.0", "", { "peerDependencies": { "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0" } }, "sha512-Pp6GSwGP/NrPIrxVFAIkOQeyw8lFenOHijQWkUTrDvrF4ALqylP2C/KCkeS9dpUM3KvYRQhna5vt7IL95+ZQ9w=="], + "util-deprecate": ["util-deprecate@1.0.2", "", {}, "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw=="], "utils-merge": ["utils-merge@1.0.1", "", {}, "sha512-pMZTvIkT1d+TFGvDOqodOclx0QWkkgi6Tdoa8gC8ffGAAqz9pzPTZWAybbsHHoED/ztMtkv/VoYTYyShUn81hA=="], - "uuid": ["uuid@8.3.2", "", { "bin": { "uuid": "dist/bin/uuid" } }, "sha512-+NYs2QeMWy+GWFOEm9xnn6HCDp0l7QBD7ml8zLUmJ+93Q5NF0NocErnwkTkXVFNiX3/fpC6afS8Dhb/gz7R7eg=="], + "uuid": ["uuid@14.0.2", "", { "bin": { "uuid": "dist-node/bin/uuid" } }, "sha512-xZe/16rV4aa+HGSOCiY2YeLT1OybRLrrkL/Rqaq7p7GMVXjFh+6wN4oMYgjFmnSnhY8t6Xpdl2l9qmnHYuMHwQ=="], "v8-to-istanbul": ["v8-to-istanbul@9.3.0", "", { "dependencies": { "@jridgewell/trace-mapping": "^0.3.12", "@types/istanbul-lib-coverage": "^2.0.1", "convert-source-map": "^2.0.0" } }, "sha512-kiGUalWN+rgBJ/1OHZsBtU4rXZOfj/7rKQxULKlIzwzQSvMJUUNgPwJEEh7gU6xEVxC0ahoOBvN2YI8GH6FNgA=="], @@ -3361,6 +3481,8 @@ "zod": ["zod@3.23.8", "", {}, "sha512-XBx9AXhXktjUqnepgTiE5flcKIYWi/rme0Eaj+5Y0lftuGBq+jyRu/md4WnuxqgP1ubdpNCsYEYPxrzVHD8d6g=="], + "@ariakit/react-components/@floating-ui/dom": ["@floating-ui/dom@1.8.0", "", { "dependencies": { "@floating-ui/core": "^1.8.0", "@floating-ui/utils": "^0.2.12" } }, "sha512-yXSrzeHZBTZadLOlfyhCkJHNeLJnHRnRInwdZ40L7ZiaAtrBwoYlsDrX3v5zB1Utk7CLfzcOVnVVWoXEky7Ceg=="], + "@babel/core/debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="], "@babel/helper-define-polyfill-provider/debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="], @@ -3373,6 +3495,16 @@ "@babel/traverse/debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="], + "@base-ui/react/@babel/runtime": ["@babel/runtime@7.29.7", "", {}, "sha512-Nq8OhGWiZIZGV6hLHoyAKLLcJihP/xFeBMGJoUrxTX2psI8dCifzLhZISFb+VWS3wFMRDmCGw5R+dOySCqPLhw=="], + + "@base-ui/react/@floating-ui/react-dom": ["@floating-ui/react-dom@2.1.9", "", { "dependencies": { "@floating-ui/dom": "^1.8.0" }, "peerDependencies": { "react": ">=16.8.0", "react-dom": ">=16.8.0" } }, "sha512-JDjEFGCpImxDCA7JJKviA0M9+RtmJdj0m/NVU5IMgBK+AmZouAQQ7/+2GLH0GXXY0YMw9oXPB8hKdbPYg5QLYg=="], + + "@base-ui/react/@floating-ui/utils": ["@floating-ui/utils@0.2.12", "", {}, "sha512-HpCo8tmWzLVad5s2d19EhAz5zqrrQ6s69qd6moPMQvkOuSwDT1YgRfWSVuc4ennqrgv3OHppiOGMQ7oC13yIww=="], + + "@base-ui/utils/@babel/runtime": ["@babel/runtime@7.29.7", "", {}, "sha512-Nq8OhGWiZIZGV6hLHoyAKLLcJihP/xFeBMGJoUrxTX2psI8dCifzLhZISFb+VWS3wFMRDmCGw5R+dOySCqPLhw=="], + + "@base-ui/utils/@floating-ui/utils": ["@floating-ui/utils@0.2.12", "", {}, "sha512-HpCo8tmWzLVad5s2d19EhAz5zqrrQ6s69qd6moPMQvkOuSwDT1YgRfWSVuc4ennqrgv3OHppiOGMQ7oC13yIww=="], + "@cacheable/memory/keyv": ["keyv@5.6.0", "", { "dependencies": { "@keyv/serialize": "^1.1.1" } }, "sha512-CYDD3SOtsHtyXeEORYRx2qBtpDJFjRTGXUtmNEMGyzYOKj1TE3tycdlho7kA1Ufx9OYWZzg52QFBGALTirzDSw=="], "@cacheable/utils/keyv": ["keyv@5.6.0", "", { "dependencies": { "@keyv/serialize": "^1.1.1" } }, "sha512-CYDD3SOtsHtyXeEORYRx2qBtpDJFjRTGXUtmNEMGyzYOKj1TE3tycdlho7kA1Ufx9OYWZzg52QFBGALTirzDSw=="], @@ -3385,6 +3517,8 @@ "@emotion/react/@babel/runtime": ["@babel/runtime@7.29.7", "", {}, "sha512-Nq8OhGWiZIZGV6hLHoyAKLLcJihP/xFeBMGJoUrxTX2psI8dCifzLhZISFb+VWS3wFMRDmCGw5R+dOySCqPLhw=="], + "@emotion/styled/@babel/runtime": ["@babel/runtime@7.29.7", "", {}, "sha512-Nq8OhGWiZIZGV6hLHoyAKLLcJihP/xFeBMGJoUrxTX2psI8dCifzLhZISFb+VWS3wFMRDmCGw5R+dOySCqPLhw=="], + "@eslint-community/eslint-utils/eslint-visitor-keys": ["eslint-visitor-keys@3.4.3", "", {}, "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag=="], "@eslint/eslintrc/ajv": ["ajv@6.15.0", "", { "dependencies": { "fast-deep-equal": "^3.1.1", "fast-json-stable-stringify": "^2.0.0", "json-schema-traverse": "^0.4.1", "uri-js": "^4.2.2" } }, "sha512-fgFx7Hfoq60ytK2c7DhnF8jIvzYgOMxfugjLOSMHjLIPgenqa7S7oaagATUq99mV6IYvN2tRmC0wnTYX6iPbMw=="], @@ -3421,7 +3555,7 @@ "@kadence/components/@wordpress/icons": ["@wordpress/icons@9.49.0", "", { "dependencies": { "@babel/runtime": "^7.16.0", "@wordpress/element": "^5.35.0", "@wordpress/primitives": "^3.56.0" } }, "sha512-Z8F+ledkfkcKDuS1c/RkM0dEWdfv2AXs6bCgey89p0atJSscf7qYbMJR9zE5rZ5aqXyFfV0DAFKJEgayNqneNQ=="], - "@kadence/helpers/@kadence/icons": ["@kadence/icons@github:stellarwp/kadence-icons#71383e2", { "peerDependencies": { "react": ">=17 <19", "react-dom": ">=17 <19" } }, "stellarwp-kadence-icons-71383e2", "sha512-HSFk/BhXV7AEMtUc4kave8zoY+B25tm5lvAsm9xFFQ/lUimee4j8MnmVoXZL8EJxXLNBBclhmGEpbCPPh/6+gA=="], + "@kadence/helpers/@kadence/icons": ["@kadence/icons@github:stellarwp/kadence-icons#f056b8b", { "peerDependencies": { "react": ">=17 <19", "react-dom": ">=17 <19" } }, "stellarwp-kadence-icons-f056b8b"], "@keyv/bigmap/keyv": ["keyv@5.6.0", "", { "dependencies": { "@keyv/serialize": "^1.1.1" } }, "sha512-CYDD3SOtsHtyXeEORYRx2qBtpDJFjRTGXUtmNEMGyzYOKj1TE3tycdlho7kA1Ufx9OYWZzg52QFBGALTirzDSw=="], @@ -3473,19 +3607,47 @@ "@typescript-eslint/visitor-keys/eslint-visitor-keys": ["eslint-visitor-keys@3.4.3", "", {}, "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag=="], + "@wordpress/a11y/@wordpress/i18n": ["@wordpress/i18n@6.26.0", "", { "dependencies": { "@tannin/sprintf": "^1.3.2", "@wordpress/hooks": "^4.53.0", "gettext-parser": "^1.3.1", "tannin": "^1.2.0" }, "bin": { "pot-to-php": "tools/pot-to-php.js" } }, "sha512-v/LzeB7T5YKIfBgmLM0jYG8zOuu81biZ90j8RY9pHIVu+jdRE+DSmt55S3FvtXRo5J2X9FoigFRzYPKXLbitWA=="], + "@wordpress/babel-preset-default/@babel/core": ["@babel/core@7.25.7", "", { "dependencies": { "@ampproject/remapping": "^2.2.0", "@babel/code-frame": "^7.25.7", "@babel/generator": "^7.25.7", "@babel/helper-compilation-targets": "^7.25.7", "@babel/helper-module-transforms": "^7.25.7", "@babel/helpers": "^7.25.7", "@babel/parser": "^7.25.7", "@babel/template": "^7.25.7", "@babel/traverse": "^7.25.7", "@babel/types": "^7.25.7", "convert-source-map": "^2.0.0", "debug": "^4.1.0", "gensync": "^1.0.0-beta.2", "json5": "^2.2.3", "semver": "^6.3.1" } }, "sha512-yJ474Zv3cwiSOO9nXJuqzvwEeM+chDuQ8GJirw+pZ91sCGCyOZ3dJkVE09fTV0VEVzXyLWhh3G/AolYTPX7Mow=="], "@wordpress/babel-preset-default/react": ["react@19.2.6", "", {}, "sha512-sfWGGfavi0xr8Pg0sVsyHMAOziVYKgPLNrS7ig+ivMNb3wbCBw3KxtflsGBAwD3gYQlE/AEZsTLgToRrSCjb0Q=="], + "@wordpress/components/@floating-ui/react-dom": ["@floating-ui/react-dom@2.1.9", "", { "dependencies": { "@floating-ui/dom": "^1.8.0" }, "peerDependencies": { "react": ">=16.8.0", "react-dom": ">=16.8.0" } }, "sha512-JDjEFGCpImxDCA7JJKviA0M9+RtmJdj0m/NVU5IMgBK+AmZouAQQ7/+2GLH0GXXY0YMw9oXPB8hKdbPYg5QLYg=="], + + "@wordpress/components/@wordpress/hooks": ["@wordpress/hooks@4.53.0", "", {}, "sha512-YU30rweJCTu5g7X8bc+w6QyoxJBYLEHH++Wwo/IbbROHUC/4I7e+ZtxnPWls8BTtMP4d28JJ74s+UoKpzd2J7w=="], + + "@wordpress/components/@wordpress/i18n": ["@wordpress/i18n@6.26.0", "", { "dependencies": { "@tannin/sprintf": "^1.3.2", "@wordpress/hooks": "^4.53.0", "gettext-parser": "^1.3.1", "tannin": "^1.2.0" }, "bin": { "pot-to-php": "tools/pot-to-php.js" } }, "sha512-v/LzeB7T5YKIfBgmLM0jYG8zOuu81biZ90j8RY9pHIVu+jdRE+DSmt55S3FvtXRo5J2X9FoigFRzYPKXLbitWA=="], + + "@wordpress/components/@wordpress/icons": ["@wordpress/icons@15.4.0", "", { "dependencies": { "@wordpress/element": "^8.5.0", "@wordpress/primitives": "^4.53.0", "change-case": "^4.1.2" }, "peerDependencies": { "@types/react": "^18 || ^19", "react": "^18 || ^19" }, "optionalPeers": ["@types/react"] }, "sha512-0NNoJkGZuFM4j60vdxzINXfUpMOGkoyPRqN0an6sRLoa6wHYuM4Yt4sZJet4xA6ft3z8+xNUvrAd92dF2tpFBg=="], + + "@wordpress/components/@wordpress/primitives": ["@wordpress/primitives@4.53.0", "", { "dependencies": { "@wordpress/element": "^8.5.0", "clsx": "^2.1.1" }, "peerDependencies": { "@types/react": "^18 || ^19", "react": "^18 || ^19" }, "optionalPeers": ["@types/react"] }, "sha512-yZdmql3vzzVhC0mcu5sKGMUXBrKGODQYZWvHsLwJMSSciFHvns/TyDloodID/naJZL243xUSN/hfKp7PIzXNRw=="], + + "@wordpress/components/@wordpress/warning": ["@wordpress/warning@3.53.0", "", {}, "sha512-pNco8mfQM5EUJZ4m6zuHxyjnCvOKeZtxu9UGYQIRtEEMAKQJgz6HdHXKt+xQHvLA5Wi/bd0kPK5AWrl1wM22Tg=="], + + "@wordpress/components/change-case": ["change-case@4.1.2", "", { "dependencies": { "camel-case": "^4.1.2", "capital-case": "^1.0.4", "constant-case": "^3.0.4", "dot-case": "^3.0.4", "header-case": "^2.0.4", "no-case": "^3.0.4", "param-case": "^3.0.4", "pascal-case": "^3.1.2", "path-case": "^3.0.4", "sentence-case": "^3.0.4", "snake-case": "^3.0.4", "tslib": "^2.0.3" } }, "sha512-bSxY2ws9OtviILG1EiY5K7NNxkqg/JnRnFxLtKQ96JaviiIxi7djMrSd0ECT9AC+lttClmYwKw53BWpOMblo7A=="], + + "@wordpress/compose/change-case": ["change-case@4.1.2", "", { "dependencies": { "camel-case": "^4.1.2", "capital-case": "^1.0.4", "constant-case": "^3.0.4", "dot-case": "^3.0.4", "header-case": "^2.0.4", "no-case": "^3.0.4", "param-case": "^3.0.4", "pascal-case": "^3.1.2", "path-case": "^3.0.4", "sentence-case": "^3.0.4", "snake-case": "^3.0.4", "tslib": "^2.0.3" } }, "sha512-bSxY2ws9OtviILG1EiY5K7NNxkqg/JnRnFxLtKQ96JaviiIxi7djMrSd0ECT9AC+lttClmYwKw53BWpOMblo7A=="], + + "@wordpress/deprecated/@wordpress/hooks": ["@wordpress/hooks@4.53.0", "", {}, "sha512-YU30rweJCTu5g7X8bc+w6QyoxJBYLEHH++Wwo/IbbROHUC/4I7e+ZtxnPWls8BTtMP4d28JJ74s+UoKpzd2J7w=="], + "@wordpress/e2e-test-utils-playwright/change-case": ["change-case@4.1.2", "", { "dependencies": { "camel-case": "^4.1.2", "capital-case": "^1.0.4", "constant-case": "^3.0.4", "dot-case": "^3.0.4", "header-case": "^2.0.4", "no-case": "^3.0.4", "param-case": "^3.0.4", "pascal-case": "^3.1.2", "path-case": "^3.0.4", "sentence-case": "^3.0.4", "snake-case": "^3.0.4", "tslib": "^2.0.3" } }, "sha512-bSxY2ws9OtviILG1EiY5K7NNxkqg/JnRnFxLtKQ96JaviiIxi7djMrSd0ECT9AC+lttClmYwKw53BWpOMblo7A=="], "@wordpress/element/change-case": ["change-case@4.1.2", "", { "dependencies": { "camel-case": "^4.1.2", "capital-case": "^1.0.4", "constant-case": "^3.0.4", "dot-case": "^3.0.4", "header-case": "^2.0.4", "no-case": "^3.0.4", "param-case": "^3.0.4", "pascal-case": "^3.1.2", "path-case": "^3.0.4", "sentence-case": "^3.0.4", "snake-case": "^3.0.4", "tslib": "^2.0.3" } }, "sha512-bSxY2ws9OtviILG1EiY5K7NNxkqg/JnRnFxLtKQ96JaviiIxi7djMrSd0ECT9AC+lttClmYwKw53BWpOMblo7A=="], "@wordpress/eslint-plugin/@babel/eslint-parser": ["@babel/eslint-parser@7.25.7", "", { "dependencies": { "@nicolo-ribaudo/eslint-scope-5-internals": "5.1.1-v1", "eslint-visitor-keys": "^2.1.0", "semver": "^6.3.1" }, "peerDependencies": { "@babel/core": "^7.11.0", "eslint": "^7.5.0 || ^8.0.0 || ^9.0.0" } }, "sha512-B+BO9x86VYsQHimucBAL1fxTJKF4wyKY6ZVzee9QgzdZOUfs3BaR6AQrgoGrRI+7IFS1wUz/VyQ+SoBcSpdPbw=="], + "@wordpress/icons/@wordpress/element": ["@wordpress/element@6.46.0", "", { "dependencies": { "@types/react": "^18.3.27", "@types/react-dom": "^18.3.1", "@wordpress/escape-html": "^3.46.0", "change-case": "^4.1.2", "is-plain-object": "^5.0.0", "react": "^18.3.0", "react-dom": "^18.3.0" } }, "sha512-hjnrqZi0cZVdkmN0xQavKfSQJYAkb9pVSnDPpuX65OLxeD9/EWkIXvFzBb+nH8c4NzKKSqQU96XCTQrH37OCIA=="], + + "@wordpress/kebab-case/change-case": ["change-case@4.1.2", "", { "dependencies": { "camel-case": "^4.1.2", "capital-case": "^1.0.4", "constant-case": "^3.0.4", "dot-case": "^3.0.4", "header-case": "^2.0.4", "no-case": "^3.0.4", "param-case": "^3.0.4", "pascal-case": "^3.1.2", "path-case": "^3.0.4", "sentence-case": "^3.0.4", "snake-case": "^3.0.4", "tslib": "^2.0.3" } }, "sha512-bSxY2ws9OtviILG1EiY5K7NNxkqg/JnRnFxLtKQ96JaviiIxi7djMrSd0ECT9AC+lttClmYwKw53BWpOMblo7A=="], + + "@wordpress/keycodes/@wordpress/i18n": ["@wordpress/i18n@6.26.0", "", { "dependencies": { "@tannin/sprintf": "^1.3.2", "@wordpress/hooks": "^4.53.0", "gettext-parser": "^1.3.1", "tannin": "^1.2.0" }, "bin": { "pot-to-php": "tools/pot-to-php.js" } }, "sha512-v/LzeB7T5YKIfBgmLM0jYG8zOuu81biZ90j8RY9pHIVu+jdRE+DSmt55S3FvtXRo5J2X9FoigFRzYPKXLbitWA=="], + + "@wordpress/postcss-plugins-preset/@wordpress/base-styles": ["@wordpress/base-styles@9.0.0", "", {}, "sha512-sg9NOQkrponLpabONPB3vlsIFHv7GCRDCru3ym5UcASAHlCgBHzQjOReiVnhMjhJf7kZS2OU8TpYQcDJLAaItA=="], + "@wordpress/primitives/@wordpress/element": ["@wordpress/element@7.0.0", "", { "dependencies": { "@types/react": "^19.2.13", "@types/react-dom": "^19.2.3", "@wordpress/deprecated": "^4.47.0", "@wordpress/escape-html": "^3.47.0", "change-case": "^4.1.2", "is-plain-object": "^5.0.0", "react": "^19.2.4", "react-dom": "^19.2.4" } }, "sha512-iJoc3pzeof0mhwN0gVqDqc64xCRoAij2JynU6YxGSmw5a1uJwi1w3GESX3nPR1eaDdv2V6vwkinMBI+aGG7wxQ=="], - "@wordpress/primitives/react": ["react@19.2.6", "", {}, "sha512-sfWGGfavi0xr8Pg0sVsyHMAOziVYKgPLNrS7ig+ivMNb3wbCBw3KxtflsGBAwD3gYQlE/AEZsTLgToRrSCjb0Q=="], + "@wordpress/rich-text/@wordpress/i18n": ["@wordpress/i18n@6.26.0", "", { "dependencies": { "@tannin/sprintf": "^1.3.2", "@wordpress/hooks": "^4.53.0", "gettext-parser": "^1.3.1", "tannin": "^1.2.0" }, "bin": { "pot-to-php": "tools/pot-to-php.js" } }, "sha512-v/LzeB7T5YKIfBgmLM0jYG8zOuu81biZ90j8RY9pHIVu+jdRE+DSmt55S3FvtXRo5J2X9FoigFRzYPKXLbitWA=="], "@wordpress/scripts/@babel/core": ["@babel/core@7.25.7", "", { "dependencies": { "@ampproject/remapping": "^2.2.0", "@babel/code-frame": "^7.25.7", "@babel/generator": "^7.25.7", "@babel/helper-compilation-targets": "^7.25.7", "@babel/helper-module-transforms": "^7.25.7", "@babel/helpers": "^7.25.7", "@babel/parser": "^7.25.7", "@babel/template": "^7.25.7", "@babel/traverse": "^7.25.7", "@babel/types": "^7.25.7", "convert-source-map": "^2.0.0", "debug": "^4.1.0", "gensync": "^1.0.0-beta.2", "json5": "^2.2.3", "semver": "^6.3.1" } }, "sha512-yJ474Zv3cwiSOO9nXJuqzvwEeM+chDuQ8GJirw+pZ91sCGCyOZ3dJkVE09fTV0VEVzXyLWhh3G/AolYTPX7Mow=="], @@ -3495,9 +3657,17 @@ "@wordpress/theme/@wordpress/element": ["@wordpress/element@7.0.0", "", { "dependencies": { "@types/react": "^19.2.13", "@types/react-dom": "^19.2.3", "@wordpress/deprecated": "^4.47.0", "@wordpress/escape-html": "^3.47.0", "change-case": "^4.1.2", "is-plain-object": "^5.0.0", "react": "^19.2.4", "react-dom": "^19.2.4" } }, "sha512-iJoc3pzeof0mhwN0gVqDqc64xCRoAij2JynU6YxGSmw5a1uJwi1w3GESX3nPR1eaDdv2V6vwkinMBI+aGG7wxQ=="], - "@wordpress/theme/react": ["react@19.2.6", "", {}, "sha512-sfWGGfavi0xr8Pg0sVsyHMAOziVYKgPLNrS7ig+ivMNb3wbCBw3KxtflsGBAwD3gYQlE/AEZsTLgToRrSCjb0Q=="], + "@wordpress/theme/@wordpress/private-apis": ["@wordpress/private-apis@1.47.0", "", {}, "sha512-DfwLsmencI2LUZhY6u1aZCwZYO1ILuyJf7Cn15G/gVbPlA7pBJp9YVFk+3FR5U35I0e0infNMDDn8u5632urmQ=="], + + "@wordpress/theme/@wordpress/style-runtime": ["@wordpress/style-runtime@0.3.0", "", {}, "sha512-CWSGDSIjHO6Ww/BK0jfF6WbVLQWoQNEUEeh4/YBFpMrzjWvhS7RD5ZGt88HZkazEXywovA6q2302OZsyfzP/zA=="], + + "@wordpress/ui/@wordpress/i18n": ["@wordpress/i18n@6.26.0", "", { "dependencies": { "@tannin/sprintf": "^1.3.2", "@wordpress/hooks": "^4.53.0", "gettext-parser": "^1.3.1", "tannin": "^1.2.0" }, "bin": { "pot-to-php": "tools/pot-to-php.js" } }, "sha512-v/LzeB7T5YKIfBgmLM0jYG8zOuu81biZ90j8RY9pHIVu+jdRE+DSmt55S3FvtXRo5J2X9FoigFRzYPKXLbitWA=="], - "@wordpress/theme/react-dom": ["react-dom@19.2.6", "", { "dependencies": { "scheduler": "^0.27.0" }, "peerDependencies": { "react": "^19.2.6" } }, "sha512-0prMI+hvBbPjsWnxDLxlCGyM8PN6UuWjEUCYmZhO67xIV9Xasa/r/vDnq+Xyq4Lo27g8QSbO5YzARu0D1Sps3g=="], + "@wordpress/ui/@wordpress/icons": ["@wordpress/icons@15.4.0", "", { "dependencies": { "@wordpress/element": "^8.5.0", "@wordpress/primitives": "^4.53.0", "change-case": "^4.1.2" }, "peerDependencies": { "@types/react": "^18 || ^19", "react": "^18 || ^19" }, "optionalPeers": ["@types/react"] }, "sha512-0NNoJkGZuFM4j60vdxzINXfUpMOGkoyPRqN0an6sRLoa6wHYuM4Yt4sZJet4xA6ft3z8+xNUvrAd92dF2tpFBg=="], + + "@wordpress/ui/@wordpress/primitives": ["@wordpress/primitives@4.53.0", "", { "dependencies": { "@wordpress/element": "^8.5.0", "clsx": "^2.1.1" }, "peerDependencies": { "@types/react": "^18 || ^19", "react": "^18 || ^19" }, "optionalPeers": ["@types/react"] }, "sha512-yZdmql3vzzVhC0mcu5sKGMUXBrKGODQYZWvHsLwJMSSciFHvns/TyDloodID/naJZL243xUSN/hfKp7PIzXNRw=="], + + "@wordpress/ui/@wordpress/theme": ["@wordpress/theme@1.2.0", "", { "dependencies": { "@wordpress/compose": "^8.6.0", "@wordpress/deprecated": "^4.53.0", "@wordpress/element": "^8.5.0", "@wordpress/private-apis": "^1.53.0", "@wordpress/style-runtime": "^0.9.0", "colorjs.io": "^0.7.1", "memize": "^2.1.1" }, "peerDependencies": { "@types/react": "^18 || ^19", "esbuild": ">=0.27.2 <1.0.0", "postcss": "^8.0.0", "react": "^18 || ^19", "react-dom": "^18 || ^19", "stylelint": "^16 || ^17", "vite": "^7 || ^8" }, "optionalPeers": ["@types/react", "esbuild", "postcss", "stylelint", "vite"] }, "sha512-pILS4ytGGiASrpJ8sLp+pRbcBspFYeMTr5LdM4fWBv/EN2CIKhBLpX3qGlXwKzS+HzjrbXZwj60Bfbg/PxvQew=="], "accepts/negotiator": ["negotiator@0.6.3", "", {}, "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg=="], @@ -3605,6 +3775,8 @@ "express/debug": ["debug@2.6.9", "", { "dependencies": { "ms": "2.0.0" } }, "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA=="], + "express/path-to-regexp": ["path-to-regexp@0.1.13", "", {}, "sha512-A/AGNMFN3c8bOlvV9RreMdrv7jsmF9XIfDeCd87+I8RNg6s78BhJxMu69NEMHBSJFxKidViTEdruRwEk/WIKqA=="], + "express/safe-buffer": ["safe-buffer@5.2.1", "", {}, "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ=="], "extract-zip/debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="], @@ -3843,6 +4015,8 @@ "shallow-clone/lazy-cache": ["lazy-cache@0.2.7", "", {}, "sha512-gkX52wvU/R8DVMMt78ATVPFMJqfW8FPz1GZ1sVHBVQHmu/WvhIWE4cE1GBzhJNFicDeYhnwp6Rl35BcAIM3YOQ=="], + "sockjs/uuid": ["uuid@8.3.2", "", { "bin": { "uuid": "dist/bin/uuid" } }, "sha512-+NYs2QeMWy+GWFOEm9xnn6HCDp0l7QBD7ml8zLUmJ+93Q5NF0NocErnwkTkXVFNiX3/fpC6afS8Dhb/gz7R7eg=="], + "socks-proxy-agent/agent-base": ["agent-base@7.1.4", "", {}, "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ=="], "socks-proxy-agent/debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="], @@ -3929,6 +4103,12 @@ "which-builtin-type/isarray": ["isarray@2.0.5", "", {}, "sha512-xHjhDr3cNBK0BzdUJSPXZntQUx/mwMS5Rw4A7lPJ90XGAO6ISP/ePDNuo0vhqOZU+UD5JoodwCAAoZQd3FeAKw=="], + "@ariakit/react-components/@floating-ui/dom/@floating-ui/core": ["@floating-ui/core@1.8.0", "", { "dependencies": { "@floating-ui/utils": "^0.2.12" } }, "sha512-0CIZ5itps/8x7BG8dEIhs53BvCUH2PCoogtakwRTut+Arm58sJooJ0AuZhLw2HJYIR5cMLNPBSS728sPho2khQ=="], + + "@ariakit/react-components/@floating-ui/dom/@floating-ui/utils": ["@floating-ui/utils@0.2.12", "", {}, "sha512-HpCo8tmWzLVad5s2d19EhAz5zqrrQ6s69qd6moPMQvkOuSwDT1YgRfWSVuc4ennqrgv3OHppiOGMQ7oC13yIww=="], + + "@base-ui/react/@floating-ui/react-dom/@floating-ui/dom": ["@floating-ui/dom@1.8.0", "", { "dependencies": { "@floating-ui/core": "^1.8.0", "@floating-ui/utils": "^0.2.12" } }, "sha512-yXSrzeHZBTZadLOlfyhCkJHNeLJnHRnRInwdZ40L7ZiaAtrBwoYlsDrX3v5zB1Utk7CLfzcOVnVVWoXEky7Ceg=="], + "@eslint/eslintrc/ajv/json-schema-traverse": ["json-schema-traverse@0.4.1", "", {}, "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg=="], "@istanbuljs/load-nyc-config/find-up/locate-path": ["locate-path@5.0.0", "", { "dependencies": { "p-locate": "^4.1.0" } }, "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g=="], @@ -3953,25 +4133,55 @@ "@typescript-eslint/typescript-estree/minimatch/brace-expansion": ["brace-expansion@2.1.1", "", { "dependencies": { "balanced-match": "^1.0.0" } }, "sha512-WR1cURNjuvBLMZBMbqM0UoE+WAfdUcEV1ccD8PVBVOI+Z3ND4+SZbN8RsfT2bMuG1qwz5RFvPukSZm5fF2D5eA=="], + "@wordpress/a11y/@wordpress/i18n/@wordpress/hooks": ["@wordpress/hooks@4.53.0", "", {}, "sha512-YU30rweJCTu5g7X8bc+w6QyoxJBYLEHH++Wwo/IbbROHUC/4I7e+ZtxnPWls8BTtMP4d28JJ74s+UoKpzd2J7w=="], + "@wordpress/babel-preset-default/@babel/core/debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="], + "@wordpress/components/@floating-ui/react-dom/@floating-ui/dom": ["@floating-ui/dom@1.8.0", "", { "dependencies": { "@floating-ui/core": "^1.8.0", "@floating-ui/utils": "^0.2.12" } }, "sha512-yXSrzeHZBTZadLOlfyhCkJHNeLJnHRnRInwdZ40L7ZiaAtrBwoYlsDrX3v5zB1Utk7CLfzcOVnVVWoXEky7Ceg=="], + + "@wordpress/icons/@wordpress/element/@wordpress/escape-html": ["@wordpress/escape-html@3.47.0", "", {}, "sha512-3D3dlMxpfc3rTrxASc5osqIR3gp+WgQSn8aqN+1zP8VctM0hm7HdzIix0LwPbyw64DfLiG/jnlRBrtHF6S9UQw=="], + + "@wordpress/icons/@wordpress/element/change-case": ["change-case@4.1.2", "", { "dependencies": { "camel-case": "^4.1.2", "capital-case": "^1.0.4", "constant-case": "^3.0.4", "dot-case": "^3.0.4", "header-case": "^2.0.4", "no-case": "^3.0.4", "param-case": "^3.0.4", "pascal-case": "^3.1.2", "path-case": "^3.0.4", "sentence-case": "^3.0.4", "snake-case": "^3.0.4", "tslib": "^2.0.3" } }, "sha512-bSxY2ws9OtviILG1EiY5K7NNxkqg/JnRnFxLtKQ96JaviiIxi7djMrSd0ECT9AC+lttClmYwKw53BWpOMblo7A=="], + + "@wordpress/keycodes/@wordpress/i18n/@wordpress/hooks": ["@wordpress/hooks@4.53.0", "", {}, "sha512-YU30rweJCTu5g7X8bc+w6QyoxJBYLEHH++Wwo/IbbROHUC/4I7e+ZtxnPWls8BTtMP4d28JJ74s+UoKpzd2J7w=="], + "@wordpress/primitives/@wordpress/element/@types/react": ["@types/react@19.2.15", "", { "dependencies": { "csstype": "^3.2.2" } }, "sha512-eRwcGNHve+E8qtEQSSRl6urh+rFop4v8gm6O8rGv25CodbvFdLjA1vVQ1KkiFE0w0UPOnb8tDiFKL5lp0rtY5Q=="], "@wordpress/primitives/@wordpress/element/@types/react-dom": ["@types/react-dom@19.2.3", "", { "peerDependencies": { "@types/react": "^19.2.0" } }, "sha512-jp2L/eY6fn+KgVVQAOqYItbF0VY/YApe5Mz2F0aykSO8gx31bYCZyvSeYxCHKvzHG5eZjc+zyaS5BrBWya2+kQ=="], + "@wordpress/primitives/@wordpress/element/@wordpress/deprecated": ["@wordpress/deprecated@4.47.0", "", { "dependencies": { "@wordpress/hooks": "^4.47.0" } }, "sha512-SPmYu3Ihqfaqve4xEKf8+SAhae9UuYLncFovXHHEHeNrKwldYyNy3fm+3Aifd/RK5r7Vc7nr0zONYkuhWkDlNw=="], + + "@wordpress/primitives/@wordpress/element/@wordpress/escape-html": ["@wordpress/escape-html@3.47.0", "", {}, "sha512-3D3dlMxpfc3rTrxASc5osqIR3gp+WgQSn8aqN+1zP8VctM0hm7HdzIix0LwPbyw64DfLiG/jnlRBrtHF6S9UQw=="], + "@wordpress/primitives/@wordpress/element/change-case": ["change-case@4.1.2", "", { "dependencies": { "camel-case": "^4.1.2", "capital-case": "^1.0.4", "constant-case": "^3.0.4", "dot-case": "^3.0.4", "header-case": "^2.0.4", "no-case": "^3.0.4", "param-case": "^3.0.4", "pascal-case": "^3.1.2", "path-case": "^3.0.4", "sentence-case": "^3.0.4", "snake-case": "^3.0.4", "tslib": "^2.0.3" } }, "sha512-bSxY2ws9OtviILG1EiY5K7NNxkqg/JnRnFxLtKQ96JaviiIxi7djMrSd0ECT9AC+lttClmYwKw53BWpOMblo7A=="], + "@wordpress/primitives/@wordpress/element/react": ["react@19.2.6", "", {}, "sha512-sfWGGfavi0xr8Pg0sVsyHMAOziVYKgPLNrS7ig+ivMNb3wbCBw3KxtflsGBAwD3gYQlE/AEZsTLgToRrSCjb0Q=="], + "@wordpress/primitives/@wordpress/element/react-dom": ["react-dom@19.2.6", "", { "dependencies": { "scheduler": "^0.27.0" }, "peerDependencies": { "react": "^19.2.6" } }, "sha512-0prMI+hvBbPjsWnxDLxlCGyM8PN6UuWjEUCYmZhO67xIV9Xasa/r/vDnq+Xyq4Lo27g8QSbO5YzARu0D1Sps3g=="], + "@wordpress/rich-text/@wordpress/i18n/@wordpress/hooks": ["@wordpress/hooks@4.53.0", "", {}, "sha512-YU30rweJCTu5g7X8bc+w6QyoxJBYLEHH++Wwo/IbbROHUC/4I7e+ZtxnPWls8BTtMP4d28JJ74s+UoKpzd2J7w=="], + "@wordpress/scripts/@babel/core/debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="], "@wordpress/theme/@wordpress/element/@types/react": ["@types/react@19.2.15", "", { "dependencies": { "csstype": "^3.2.2" } }, "sha512-eRwcGNHve+E8qtEQSSRl6urh+rFop4v8gm6O8rGv25CodbvFdLjA1vVQ1KkiFE0w0UPOnb8tDiFKL5lp0rtY5Q=="], "@wordpress/theme/@wordpress/element/@types/react-dom": ["@types/react-dom@19.2.3", "", { "peerDependencies": { "@types/react": "^19.2.0" } }, "sha512-jp2L/eY6fn+KgVVQAOqYItbF0VY/YApe5Mz2F0aykSO8gx31bYCZyvSeYxCHKvzHG5eZjc+zyaS5BrBWya2+kQ=="], + "@wordpress/theme/@wordpress/element/@wordpress/deprecated": ["@wordpress/deprecated@4.47.0", "", { "dependencies": { "@wordpress/hooks": "^4.47.0" } }, "sha512-SPmYu3Ihqfaqve4xEKf8+SAhae9UuYLncFovXHHEHeNrKwldYyNy3fm+3Aifd/RK5r7Vc7nr0zONYkuhWkDlNw=="], + + "@wordpress/theme/@wordpress/element/@wordpress/escape-html": ["@wordpress/escape-html@3.47.0", "", {}, "sha512-3D3dlMxpfc3rTrxASc5osqIR3gp+WgQSn8aqN+1zP8VctM0hm7HdzIix0LwPbyw64DfLiG/jnlRBrtHF6S9UQw=="], + "@wordpress/theme/@wordpress/element/change-case": ["change-case@4.1.2", "", { "dependencies": { "camel-case": "^4.1.2", "capital-case": "^1.0.4", "constant-case": "^3.0.4", "dot-case": "^3.0.4", "header-case": "^2.0.4", "no-case": "^3.0.4", "param-case": "^3.0.4", "pascal-case": "^3.1.2", "path-case": "^3.0.4", "sentence-case": "^3.0.4", "snake-case": "^3.0.4", "tslib": "^2.0.3" } }, "sha512-bSxY2ws9OtviILG1EiY5K7NNxkqg/JnRnFxLtKQ96JaviiIxi7djMrSd0ECT9AC+lttClmYwKw53BWpOMblo7A=="], - "@wordpress/theme/react-dom/scheduler": ["scheduler@0.27.0", "", {}, "sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q=="], + "@wordpress/theme/@wordpress/element/react": ["react@19.2.6", "", {}, "sha512-sfWGGfavi0xr8Pg0sVsyHMAOziVYKgPLNrS7ig+ivMNb3wbCBw3KxtflsGBAwD3gYQlE/AEZsTLgToRrSCjb0Q=="], + + "@wordpress/theme/@wordpress/element/react-dom": ["react-dom@19.2.6", "", { "dependencies": { "scheduler": "^0.27.0" }, "peerDependencies": { "react": "^19.2.6" } }, "sha512-0prMI+hvBbPjsWnxDLxlCGyM8PN6UuWjEUCYmZhO67xIV9Xasa/r/vDnq+Xyq4Lo27g8QSbO5YzARu0D1Sps3g=="], + + "@wordpress/ui/@wordpress/i18n/@wordpress/hooks": ["@wordpress/hooks@4.53.0", "", {}, "sha512-YU30rweJCTu5g7X8bc+w6QyoxJBYLEHH++Wwo/IbbROHUC/4I7e+ZtxnPWls8BTtMP4d28JJ74s+UoKpzd2J7w=="], + + "@wordpress/ui/@wordpress/icons/change-case": ["change-case@4.1.2", "", { "dependencies": { "camel-case": "^4.1.2", "capital-case": "^1.0.4", "constant-case": "^3.0.4", "dot-case": "^3.0.4", "header-case": "^2.0.4", "no-case": "^3.0.4", "param-case": "^3.0.4", "pascal-case": "^3.1.2", "path-case": "^3.0.4", "sentence-case": "^3.0.4", "snake-case": "^3.0.4", "tslib": "^2.0.3" } }, "sha512-bSxY2ws9OtviILG1EiY5K7NNxkqg/JnRnFxLtKQ96JaviiIxi7djMrSd0ECT9AC+lttClmYwKw53BWpOMblo7A=="], + + "@wordpress/ui/@wordpress/theme/colorjs.io": ["colorjs.io@0.7.1", "", {}, "sha512-LY7OHnJZxHwT5UlzNa9bbhHHDbzB6yE5+3MIPwJEQKRvSCt/T4G7epsj+9j2BExUIIfXFIJGsIXUKdfrK9Q5tA=="], "bl/readable-stream/string_decoder": ["string_decoder@1.3.0", "", { "dependencies": { "safe-buffer": "~5.2.0" } }, "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA=="], @@ -4093,6 +4303,8 @@ "webpack-merge/clone-deep/shallow-clone": ["shallow-clone@3.0.1", "", { "dependencies": { "kind-of": "^6.0.2" } }, "sha512-/6KqX+GVUdqPuPPd2LxDDxzX6CAbjJehAAOKlNpqqUpAqPM6HeL8f+o3a+JsyGjn2lv0WY8UsTgUJjU9Ok55NA=="], + "@base-ui/react/@floating-ui/react-dom/@floating-ui/dom/@floating-ui/core": ["@floating-ui/core@1.8.0", "", { "dependencies": { "@floating-ui/utils": "^0.2.12" } }, "sha512-0CIZ5itps/8x7BG8dEIhs53BvCUH2PCoogtakwRTut+Arm58sJooJ0AuZhLw2HJYIR5cMLNPBSS728sPho2khQ=="], + "@istanbuljs/load-nyc-config/find-up/locate-path/p-locate": ["p-locate@4.1.0", "", { "dependencies": { "p-limit": "^2.2.0" } }, "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A=="], "@istanbuljs/load-nyc-config/js-yaml/argparse/sprintf-js": ["sprintf-js@1.0.3", "", {}, "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g=="], @@ -4105,8 +4317,14 @@ "@typescript-eslint/typescript-estree/minimatch/brace-expansion/balanced-match": ["balanced-match@1.0.2", "", {}, "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw=="], + "@wordpress/components/@floating-ui/react-dom/@floating-ui/dom/@floating-ui/core": ["@floating-ui/core@1.8.0", "", { "dependencies": { "@floating-ui/utils": "^0.2.12" } }, "sha512-0CIZ5itps/8x7BG8dEIhs53BvCUH2PCoogtakwRTut+Arm58sJooJ0AuZhLw2HJYIR5cMLNPBSS728sPho2khQ=="], + + "@wordpress/components/@floating-ui/react-dom/@floating-ui/dom/@floating-ui/utils": ["@floating-ui/utils@0.2.12", "", {}, "sha512-HpCo8tmWzLVad5s2d19EhAz5zqrrQ6s69qd6moPMQvkOuSwDT1YgRfWSVuc4ennqrgv3OHppiOGMQ7oC13yIww=="], + "@wordpress/primitives/@wordpress/element/react-dom/scheduler": ["scheduler@0.27.0", "", {}, "sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q=="], + "@wordpress/theme/@wordpress/element/react-dom/scheduler": ["scheduler@0.27.0", "", {}, "sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q=="], + "bl/readable-stream/string_decoder/safe-buffer": ["safe-buffer@5.2.1", "", {}, "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ=="], "eslint-plugin-jest/@typescript-eslint/utils/@typescript-eslint/scope-manager/@typescript-eslint/visitor-keys": ["@typescript-eslint/visitor-keys@5.62.0", "", { "dependencies": { "@typescript-eslint/types": "5.62.0", "eslint-visitor-keys": "^3.3.0" } }, "sha512-07ny+LHRzQXepkGg6w0mFY41fVUNBrL2Roj/++7V1txKugfjm/Ci/qSND03r2RhlJhJYMcTn9AhhSSqQp0Ysyw=="], diff --git a/composer.json b/composer.json index 013cbbc251..ed59de546c 100644 --- a/composer.json +++ b/composer.json @@ -64,6 +64,7 @@ "codeception/util-universalframework": "^1.0", "exussum12/coverage-checker": "^1.0", "lucatume/wp-browser": "<3.5", + "lucatume/wp-snaphot-assertions": "^2", "phpcompatibility/phpcompatibility-wp": "^2.1", "phpstan/extension-installer": "^1.4", "sabberworm/php-css-parser": "^8.4", @@ -77,6 +78,7 @@ }, "autoload-dev": { "psr-4": { + "KadenceWP\\KadenceBlocks\\Dev\\": "dev_scripts/src/", "Tests\\": "tests/", "Tests\\Acceptance\\": "tests/acceptance/", "Tests\\Support\\": "tests/_support/", @@ -84,6 +86,9 @@ } }, "scripts": { + "generate-dtcg-schema": [ + "@php dev_scripts/bin/generate-dtcg-schema.php" + ], "stellar-uplink": [ "vendor/bin/stellar-uplink domain=kadence-blocks" ], @@ -138,7 +143,7 @@ ], "phpcs": "phpcs --standard=phpcs.xml", "phpcs-autofix": "phpcbf --standard=phpcs.xml", - "phpcs-ci": "dev_scripts/partial-phpcs.sh diff", + "phpcs-ci": "dev_scripts/bin/partial-phpcs.sh diff", "phpstan": "./vendor/bin/phpstan analyse --memory-limit=4096M", "phpstan-baseline": "./vendor/bin/phpstan analyse --memory-limit=4096M --level max --configuration phpstan.neon --generate-baseline" }, diff --git a/composer.lock b/composer.lock index 08f5331715..07ac480640 100644 --- a/composer.lock +++ b/composer.lock @@ -4,7 +4,7 @@ "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies", "This file is @generated automatically" ], - "content-hash": "9dc31cbf2f71ab015a82f3cfd0a5215c", + "content-hash": "7fa10ef0fab7b91815557a81d5c08d0c", "packages": [ { "name": "adbario/php-dot-notation", @@ -4951,6 +4951,53 @@ }, "time": "2021-04-17T13:49:01+00:00" }, + { + "name": "electrolinux/phpquery", + "version": "0.9.7", + "source": { + "type": "git", + "url": "https://github.com/electrolinux/phpquery.git", + "reference": "90029e2acffebebdb6e309509c778fe34e8028ba" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/electrolinux/phpquery/zipball/90029e2acffebebdb6e309509c778fe34e8028ba", + "reference": "90029e2acffebebdb6e309509c778fe34e8028ba", + "shasum": "" + }, + "require": { + "php": ">=5.3.0" + }, + "type": "library", + "autoload": { + "classmap": [ + "phpQuery/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "didier Belot", + "homepage": "https://github.com/electrolinux/phpquery", + "role": "Packager, maintainer" + }, + { + "name": "Tobiasz Cudnik", + "email": "tobiasz.cudnik@gmail.com", + "homepage": "https://github.com/TobiaszCudnik", + "role": "Developer" + } + ], + "description": "phpQuery is a server-side, chainable, CSS3 selector driven Document Object Model (DOM) API based on jQuery JavaScript Library", + "homepage": "http://code.google.com/p/phpquery/", + "support": { + "source": "https://github.com/electrolinux/phpquery/tree/0.9.7" + }, + "time": "2023-05-02T18:27:16+00:00" + }, { "name": "exussum12/coverage-checker", "version": "1.1.0", @@ -5936,6 +5983,55 @@ ], "time": "2024-01-08T08:27:20+00:00" }, + { + "name": "lucatume/wp-snaphot-assertions", + "version": "2.0.0", + "source": { + "type": "git", + "url": "https://github.com/lucatume/wp-snapshot-assertions.git", + "reference": "f4b3999eef1fb252eb660df2f6cb736f75500e93" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/lucatume/wp-snapshot-assertions/zipball/f4b3999eef1fb252eb660df2f6cb736f75500e93", + "reference": "f4b3999eef1fb252eb660df2f6cb736f75500e93", + "shasum": "" + }, + "require": { + "electrolinux/phpquery": "^0.9.6", + "ext-dom": "*", + "php": "^7.3|^7.4|^8.0", + "spatie/phpunit-snapshot-assertions": "^4.2" + }, + "type": "library", + "autoload": { + "psr-4": { + "tad\\WP\\Snapshots\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "GPL-2.0" + ], + "authors": [ + { + "name": "theAverageDev (Luca Tumedei)", + "email": "luca@theaveragedev.com" + } + ], + "description": "A set of utilities to support snapshot testing of WordPress code.", + "homepage": "https://github.com/lucatume/wp-snaphot-assertions", + "keywords": [ + "snapshot", + "testing", + "wordpress" + ], + "support": { + "issues": "https://github.com/lucatume/wp-snapshot-assertions/issues", + "source": "https://github.com/lucatume/wp-snapshot-assertions/tree/2.0.0" + }, + "time": "2022-10-14T10:40:10+00:00" + }, { "name": "marc-mabe/php-enum", "version": "v4.7.2", @@ -9354,6 +9450,74 @@ ], "time": "2025-09-13T08:53:30+00:00" }, + { + "name": "spatie/phpunit-snapshot-assertions", + "version": "4.2.17", + "source": { + "type": "git", + "url": "https://github.com/spatie/phpunit-snapshot-assertions.git", + "reference": "29a03a81f4c289e4769d4f4a010432cbef6ce39d" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/spatie/phpunit-snapshot-assertions/zipball/29a03a81f4c289e4769d4f4a010432cbef6ce39d", + "reference": "29a03a81f4c289e4769d4f4a010432cbef6ce39d", + "shasum": "" + }, + "require": { + "composer-runtime-api": "^2.0", + "ext-dom": "*", + "ext-json": "*", + "ext-libxml": "*", + "php": "^7.3|^7.4|^8.0", + "phpunit/phpunit": "^8.3|^9.0", + "symfony/property-access": "^4.0|^5.0|^6.0|^7.0", + "symfony/serializer": "^4.0|^5.0|^6.0|^7.0", + "symfony/yaml": "^4.0|^5.0|^6.0|^7.0" + }, + "require-dev": { + "phpunit/phpunit": "^9.1.0" + }, + "type": "library", + "autoload": { + "psr-4": { + "Spatie\\Snapshots\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Sebastian De Deyne", + "email": "sebastian@spatie.be", + "homepage": "https://spatie.be", + "role": "Developer" + } + ], + "description": "Snapshot testing with PHPUnit", + "homepage": "https://github.com/spatie/phpunit-snapshot-assertions", + "keywords": [ + "assert", + "phpunit", + "phpunit-snapshot-assertions", + "snapshot", + "spatie", + "testing" + ], + "support": { + "issues": "https://github.com/spatie/phpunit-snapshot-assertions/issues", + "source": "https://github.com/spatie/phpunit-snapshot-assertions/tree/4.2.17" + }, + "funding": [ + { + "url": "https://spatie.be/open-source/support-us", + "type": "custom" + } + ], + "time": "2024-05-03T07:52:41+00:00" + }, { "name": "squizlabs/php_codesniffer", "version": "3.13.5", @@ -10190,6 +10354,281 @@ ], "time": "2026-04-10T18:47:49+00:00" }, + { + "name": "symfony/property-access", + "version": "v5.4.45", + "source": { + "type": "git", + "url": "https://github.com/symfony/property-access.git", + "reference": "111e7ed617509f1a9139686055d234aad6e388e0" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/property-access/zipball/111e7ed617509f1a9139686055d234aad6e388e0", + "reference": "111e7ed617509f1a9139686055d234aad6e388e0", + "shasum": "" + }, + "require": { + "php": ">=7.2.5", + "symfony/deprecation-contracts": "^2.1|^3", + "symfony/polyfill-php80": "^1.16", + "symfony/property-info": "^5.2|^6.0" + }, + "require-dev": { + "symfony/cache": "^4.4|^5.0|^6.0" + }, + "suggest": { + "psr/cache-implementation": "To cache access methods." + }, + "type": "library", + "autoload": { + "psr-4": { + "Symfony\\Component\\PropertyAccess\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Fabien Potencier", + "email": "fabien@symfony.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Provides functions to read and write from/to an object or array using a simple string notation", + "homepage": "https://symfony.com", + "keywords": [ + "access", + "array", + "extraction", + "index", + "injection", + "object", + "property", + "property-path", + "reflection" + ], + "support": { + "source": "https://github.com/symfony/property-access/tree/v5.4.45" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2024-09-25T14:11:13+00:00" + }, + { + "name": "symfony/property-info", + "version": "v5.4.48", + "source": { + "type": "git", + "url": "https://github.com/symfony/property-info.git", + "reference": "a0396295ad585f95fccd690bc6a281e5bd303902" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/property-info/zipball/a0396295ad585f95fccd690bc6a281e5bd303902", + "reference": "a0396295ad585f95fccd690bc6a281e5bd303902", + "shasum": "" + }, + "require": { + "php": ">=7.2.5", + "symfony/deprecation-contracts": "^2.1|^3", + "symfony/polyfill-php80": "^1.16", + "symfony/string": "^5.1|^6.0" + }, + "conflict": { + "phpdocumentor/reflection-docblock": "<3.2.2", + "phpdocumentor/type-resolver": "<1.4.0", + "symfony/dependency-injection": "<4.4" + }, + "require-dev": { + "doctrine/annotations": "^1.10.4|^2", + "phpdocumentor/reflection-docblock": "^3.0|^4.0|^5.0", + "phpstan/phpdoc-parser": "^1.0|^2.0", + "symfony/cache": "^4.4|^5.0|^6.0", + "symfony/dependency-injection": "^4.4|^5.0|^6.0", + "symfony/serializer": "^4.4|^5.0|^6.0" + }, + "suggest": { + "phpdocumentor/reflection-docblock": "To use the PHPDoc", + "psr/cache-implementation": "To cache results", + "symfony/doctrine-bridge": "To use Doctrine metadata", + "symfony/serializer": "To use Serializer metadata" + }, + "type": "library", + "autoload": { + "psr-4": { + "Symfony\\Component\\PropertyInfo\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Kévin Dunglas", + "email": "dunglas@gmail.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Extracts information about PHP class' properties using metadata of popular sources", + "homepage": "https://symfony.com", + "keywords": [ + "doctrine", + "phpdoc", + "property", + "symfony", + "type", + "validator" + ], + "support": { + "source": "https://github.com/symfony/property-info/tree/v5.4.48" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2024-11-25T16:14:41+00:00" + }, + { + "name": "symfony/serializer", + "version": "v5.4.45", + "source": { + "type": "git", + "url": "https://github.com/symfony/serializer.git", + "reference": "460c5df9fb6c39d10d5b7f386e4feae4b6370221" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/serializer/zipball/460c5df9fb6c39d10d5b7f386e4feae4b6370221", + "reference": "460c5df9fb6c39d10d5b7f386e4feae4b6370221", + "shasum": "" + }, + "require": { + "php": ">=7.2.5", + "symfony/deprecation-contracts": "^2.1|^3", + "symfony/polyfill-ctype": "~1.8", + "symfony/polyfill-php80": "^1.16" + }, + "conflict": { + "doctrine/annotations": "<1.12", + "phpdocumentor/reflection-docblock": "<3.2.2", + "phpdocumentor/type-resolver": "<1.4.0", + "symfony/dependency-injection": "<4.4", + "symfony/property-access": "<5.4", + "symfony/property-info": "<5.4.24|>=6,<6.2.11", + "symfony/uid": "<5.3", + "symfony/yaml": "<4.4" + }, + "require-dev": { + "doctrine/annotations": "^1.12|^2", + "phpdocumentor/reflection-docblock": "^3.2|^4.0|^5.0", + "symfony/cache": "^4.4|^5.0|^6.0", + "symfony/config": "^4.4|^5.0|^6.0", + "symfony/dependency-injection": "^4.4|^5.0|^6.0", + "symfony/error-handler": "^4.4|^5.0|^6.0", + "symfony/filesystem": "^4.4|^5.0|^6.0", + "symfony/form": "^4.4|^5.0|^6.0", + "symfony/http-foundation": "^4.4|^5.0|^6.0", + "symfony/http-kernel": "^4.4|^5.0|^6.0", + "symfony/mime": "^4.4|^5.0|^6.0", + "symfony/property-access": "^5.4.26|^6.3", + "symfony/property-info": "^5.4.24|^6.2.11", + "symfony/uid": "^5.3|^6.0", + "symfony/validator": "^4.4|^5.0|^6.0", + "symfony/var-dumper": "^4.4|^5.0|^6.0", + "symfony/var-exporter": "^4.4|^5.0|^6.0", + "symfony/yaml": "^4.4|^5.0|^6.0" + }, + "suggest": { + "psr/cache-implementation": "For using the metadata cache.", + "symfony/config": "For using the XML mapping loader.", + "symfony/mime": "For using a MIME type guesser within the DataUriNormalizer.", + "symfony/property-access": "For using the ObjectNormalizer.", + "symfony/property-info": "To deserialize relations.", + "symfony/var-exporter": "For using the metadata compiler.", + "symfony/yaml": "For using the default YAML mapping loader." + }, + "type": "library", + "autoload": { + "psr-4": { + "Symfony\\Component\\Serializer\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Fabien Potencier", + "email": "fabien@symfony.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Handles serializing and deserializing data structures, including object graphs, into array structures or other formats like XML and JSON.", + "homepage": "https://symfony.com", + "support": { + "source": "https://github.com/symfony/serializer/tree/v5.4.45" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2024-09-25T14:11:13+00:00" + }, { "name": "symfony/translation", "version": "v5.4.45", @@ -12991,9 +13430,9 @@ "platform": { "ext-json": "*" }, - "platform-dev": {}, + "platform-dev": [], "platform-overrides": { "php": "7.4" }, - "plugin-api-version": "2.9.0" + "plugin-api-version": "2.6.0" } diff --git a/dev_scripts/bin/generate-dtcg-schema.php b/dev_scripts/bin/generate-dtcg-schema.php new file mode 100755 index 0000000000..49c0b3f652 --- /dev/null +++ b/dev_scripts/bin/generate-dtcg-schema.php @@ -0,0 +1,59 @@ +generate(), JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES ) . "\n"; + +if ( $check ) { + $current = is_file( $target ) ? (string) file_get_contents( $target ) : ''; + + if ( $current === $expected ) { + fwrite( STDOUT, "ok: dtcg.schema.json is up to date.\n" ); + exit( 0 ); + } + + fwrite( STDERR, "error: dtcg.schema.json is stale. Run `composer generate-dtcg-schema` to regenerate.\n" ); + exit( 1 ); +} + +if ( file_put_contents( $target, $expected ) === false ) { + fwrite( STDERR, sprintf( "error: could not write %s\n", $target ) ); + exit( 1 ); +} + +fwrite( STDOUT, sprintf( "wrote %s (%d bytes)\n", $target, strlen( $expected ) ) ); +exit( 0 ); diff --git a/dev_scripts/partial-phpcs.sh b/dev_scripts/bin/partial-phpcs.sh similarity index 100% rename from dev_scripts/partial-phpcs.sh rename to dev_scripts/bin/partial-phpcs.sh diff --git a/dev_scripts/src/Design_Tokens/Schema/Dtcg_Schema_Generator.php b/dev_scripts/src/Design_Tokens/Schema/Dtcg_Schema_Generator.php new file mode 100644 index 0000000000..3b44315ec9 --- /dev/null +++ b/dev_scripts/src/Design_Tokens/Schema/Dtcg_Schema_Generator.php @@ -0,0 +1,349 @@ + + */ + public function generate(): array { + return [ + '$schema' => 'http://json-schema.org/draft-07/schema#', + '$id' => self::SCHEMA_ID, + 'title' => 'Kadence Blocks DTCG document', + 'description' => 'Design Tokens Community Group document for the Kadence Blocks Design Tokens module. Generated from the PHP source of truth (Token_Type, Alias); do not edit by hand.', + 'type' => 'object', + 'properties' => [ + '$description' => [ 'type' => 'string' ], + '$extensions' => [ 'type' => 'object' ], + ], + 'patternProperties' => [ + self::GROUP_KEY_PATTERN => [ '$ref' => '#/definitions/node' ], + ], + 'additionalProperties' => false, + 'definitions' => $this->definitions(), + ]; + } + + /** + * The reusable schema definitions. + * + * @since TBD + * + * @return array + */ + private function definitions(): array { + return [ + 'alias' => [ + 'type' => 'string', + 'pattern' => Alias::get_pattern(), + 'description' => 'A whole-string DTCG alias, e.g. "{primitive.color.brand.primary}".', + ], + /** + * A node is exactly one of a token leaf or a group of child nodes. They are mutually + * exclusive: a leaf requires $type + $value (and forbids non-"$" children), a group forbids + * $type/$value (additionalProperties:false) and recurses into child nodes. if/then is avoided + * deliberately — the dev-side draft-07 engine (justinrainbow) does not enforce it. + */ + 'node' => [ + 'type' => 'object', + 'oneOf' => [ + [ '$ref' => '#/definitions/leaf' ], + [ '$ref' => '#/definitions/group' ], + ], + ], + 'group' => [ + 'type' => 'object', + 'properties' => [ + '$description' => [ 'type' => 'string' ], + '$extensions' => [ 'type' => 'object' ], + ], + 'patternProperties' => [ + self::GROUP_KEY_PATTERN => [ '$ref' => '#/definitions/node' ], + ], + 'additionalProperties' => false, + ], + 'leaf' => [ + 'type' => 'object', + 'required' => [ '$type', '$value' ], + 'properties' => [ + '$type' => [ 'enum' => Token_Type::all() ], + '$value' => true, + '$description' => [ 'type' => 'string' ], + '$extensions' => [ 'type' => 'object' ], + ], + // Select the $value shape by $type: exactly one branch's $type const matches. + 'oneOf' => $this->value_branches(), + 'additionalProperties' => false, + ], + ] + $this->value_definitions() + $this->responsive_definitions(); + } + + /** + * One branch per $type pinning $type to a const and $value to that type's value schema. The branches + * are mutually exclusive (distinct $type consts), so the enclosing oneOf selects exactly one. + * + * @since TBD + * + * @return array> + */ + private function value_branches(): array { + $branches = []; + + foreach ( Token_Type::all() as $type ) { + $properties = [ + '$type' => [ 'const' => $type ], + '$value' => [ '$ref' => '#/definitions/' . $this->value_def_name( $type ) ], + ]; + + // Responsive-capable types further constrain $extensions to the responsive / clamp shape; other + // types keep the generic leaf-level $extensions:{type:object}. + if ( Responsive::is_responsive_capable( $type ) ) { + $properties['$extensions'] = [ '$ref' => '#/definitions/' . $this->extensions_def_name( $type ) ]; + } + + $branches[] = [ + 'properties' => $properties, + 'required' => [ '$type', '$value' ], + ]; + } + + return $branches; + } + + /** + * The per-type $value definitions, each "alias OR the type's literal shape". anyOf (not oneOf): + * an alias is itself a string, so a string literal branch would otherwise double-match an alias. + * + * @since TBD + * + * @return array + */ + private function value_definitions(): array { + $defs = []; + + foreach ( Token_Type::all() as $type ) { + $defs[ $this->value_def_name( $type ) ] = [ + 'anyOf' => [ + [ '$ref' => '#/definitions/alias' ], + $this->literal_shape( $type ), + ], + ]; + } + + return $defs; + } + + /** + * The permissive literal shape for a $type. Composite types are built from composite_fields() so the + * field set tracks Token_Type; scalar literal grammar stays permissive (PHP Literals is the authority). + * + * @since TBD + * + * @param string $type A v1 $type. + * + * @return array + */ + private function literal_shape( string $type ): array { + if ( $type === Token_Type::get_type_font_family() ) { + return [ + 'type' => 'array', + 'items' => [ 'type' => 'string' ], + 'minItems' => 1, + ]; + } + + if ( Token_Type::is_composite( $type ) ) { + return $this->composite_shape( $type ); + } + + // fontWeight (400 / "bold") and lineHeight (1.5 / "1.5rem") accept a number as well as a string. + if ( $type === Token_Type::get_type_font_weight() || $type === Token_Type::get_type_line_height() ) { + return [ 'type' => [ 'string', 'number' ] ]; + } + + // color, dimension, fontStyle, textTransform, borderStyle: a literal string. PHP Literals + // enforces grammar. + return [ 'type' => 'string' ]; + } + + /** + * The object shape for a composite type: every sub-field required, each "alias OR the sub-field's own + * $type shape". + * + * @since TBD + * + * @param string $type A composite $type. + * + * @return array + */ + private function composite_shape( string $type ): array { + $fields = Token_Type::composite_fields( $type ); + $properties = []; + + foreach ( $fields as $field => $field_type ) { + $properties[ $field ] = [ + 'anyOf' => [ + [ '$ref' => '#/definitions/alias' ], + $this->literal_shape( $field_type ), + ], + ]; + } + + return [ + 'type' => 'object', + 'required' => array_keys( $fields ), + 'properties' => $properties, + 'additionalProperties' => false, + ]; + } + + /** + * The per-type $extensions definitions for responsive-capable types. Each models the module's + * leaf-extension namespace carrying an optional per-breakpoint `responsive` map and an optional + * structured `clamp` map; each breakpoint / bound slot is "alias OR the type's literal shape". Mutual + * exclusivity of responsive vs clamp and the not-allowed-on-other-types rule are enforced by the PHP + * validator (the authority), not encoded here; other namespaces / keys stay permitted (additive). + * + * @since TBD + * + * @return array + */ + private function responsive_definitions(): array { + $defs = []; + + foreach ( Token_Type::all() as $type ) { + if ( ! Responsive::is_responsive_capable( $type ) ) { + continue; + } + + $slot = [ + 'anyOf' => [ + [ '$ref' => '#/definitions/alias' ], + $this->literal_shape( $type ), + ], + ]; + + $defs[ $this->extensions_def_name( $type ) ] = [ + 'type' => 'object', + 'properties' => [ + Extensions::get_namespace() => [ + 'type' => 'object', + 'properties' => [ + Responsive::get_responsive_key() => [ + 'type' => 'object', + 'properties' => [ + Responsive::get_tablet_key() => $slot, + Responsive::get_mobile_key() => $slot, + ], + 'additionalProperties' => false, + ], + Responsive::get_clamp_key() => [ + 'type' => 'object', + 'required' => [ + Responsive::get_clamp_min_key(), + Responsive::get_clamp_preferred_key(), + Responsive::get_clamp_max_key(), + ], + 'properties' => [ + Responsive::get_clamp_min_key() => $slot, + Responsive::get_clamp_preferred_key() => [ 'type' => 'string' ], + Responsive::get_clamp_max_key() => $slot, + ], + 'additionalProperties' => false, + ], + ], + ], + ], + ]; + } + + return $defs; + } + + /** + * Stable definition name for a type's $value schema. + * + * @since TBD + * + * @param string $type A v1 $type. + * + * @return string + */ + private function value_def_name( string $type ): string { + return $type . 'Value'; + } + + /** + * Stable definition name for a responsive-capable type's $extensions schema. + * + * @since TBD + * + * @param string $type A responsive-capable $type. + * + * @return string + */ + private function extensions_def_name( string $type ): string { + return $type . 'Extensions'; + } +} diff --git a/includes/blocks/class-kadence-blocks-abstract-block.php b/includes/blocks/class-kadence-blocks-abstract-block.php index 6eab4cbde5..ae3afe3786 100644 --- a/includes/blocks/class-kadence-blocks-abstract-block.php +++ b/includes/blocks/class-kadence-blocks-abstract-block.php @@ -10,6 +10,10 @@ exit; } +use KadenceWP\KadenceBlocks\Design_Tokens\Projection\Palette\Renders_Palette_Attribute; +use KadenceWP\KadenceBlocks\Design_Tokens\Projection\Preset\Renders_Preset_Classes; +use KadenceWP\KadenceBlocks\Design_Tokens\Schema\Vocabulary\Alias; + /** * Abstract class to register blocks, build CSS, and enqueue scripts. * @@ -17,6 +21,9 @@ */ class Kadence_Blocks_Abstract_Block { + use Renders_Palette_Attribute; + use Renders_Preset_Classes; + /** * Block namespace. * @@ -96,6 +103,7 @@ class Kadence_Blocks_Abstract_Block { 'accept', 'captcha', 'submit', + 'single-icon', ]; /** @@ -288,6 +296,8 @@ public function render_css( $attributes, $content, $block_instance ) { $attributes = apply_filters( 'kadence_blocks_' . str_replace( '-', '_', $this->block_name ) . '_render_block_attributes', $attributes, $block_instance ); $content = $this->build_html( $attributes, $unique_id, $content, $block_instance ); + $content = $this->render_palette_attribute( $attributes, $content ); + $content = $this->render_preset_class( $attributes, $content ); if ( ! $css_class->has_styles( 'kb-' . $this->block_name . $unique_style_id ) && ! is_feed() && apply_filters( 'kadence_blocks_render_inline_css', true, $this->block_name, $unique_id ) ) { $css = $this->build_css( $attributes, $css_class, $unique_id, $unique_style_id ); if ( ! empty( $css ) && ! wp_is_block_theme() ) { @@ -342,6 +352,89 @@ public function build_html( $attributes, $unique_id, $content, $block_instance ) return $content; } + /** + * Reflect a block's per-block color-palette override onto its rendered root element as + * data-kb-palette="", so the Design Tokens projector's `[data-kb-palette]` switch layer re-skins the + * block's colors on the front end. Generic across every dynamic block: a block opts in by registering the + * `kbPalette` attribute (via `kbPalette` block support) and needs no per-block PHP. A no-op when no palette + * is pinned, the content is empty, or it has no opening tag to carry the attribute. + * + * The attribute lands on the block's own root element (the tag carrying its `wp-block--` + * class), not an outer wrapper such as an animation `data-aos` div, and the whole method short-circuits + * before any parsing when nothing is pinned. + * + * @since TBD + * + * @param mixed $attributes The block attributes. + * @param mixed $content The block's rendered HTML. + * + * @return mixed The HTML, with data-kb-palette set on the root element when a palette is pinned. + */ + protected function render_palette_attribute( $attributes, $content ) { + if ( ! is_array( $attributes ) || ! is_string( $content ) || $content === '' ) { + return $content; + } + + $palette = $this->palette_attributes( $attributes['kbPalette'] ?? '' ); + + if ( ! isset( $palette['data-kb-palette'] ) ) { + return $content; + } + + $tags = new WP_HTML_Tag_Processor( $content ); + + if ( ! $tags->next_tag( [ 'class_name' => 'wp-block-' . $this->namespace . '-' . $this->block_name ] ) ) { + return $content; + } + + $tags->set_attribute( 'data-kb-palette', $palette['data-kb-palette'] ); + + return $tags->get_updated_html(); + } + + /** + * Add a block's selected design-token preset class (`kb-preset--`) to its rendered root element, so + * the Design Tokens projector's scoped preset CSS applies on the front end. Generic across every dynamic + * block: a block opts in by registering the `kbPreset` attribute (via `kbPreset` block support) and needs + * no per-block PHP. A no-op when no preset is selected, the content is empty, or it has no opening tag to + * carry the class. + * + * The class lands on the block's own root element (the tag carrying its `wp-block--` class), + * not an outer wrapper such as an animation `data-aos` div — the scoped preset selector is compound on the + * block class (`.wp-block-.kb-preset--`), so a class on a wrapper never matches. The whole method + * short-circuits before any parsing when nothing is selected. + * + * @since TBD + * + * @param mixed $attributes The block attributes. + * @param mixed $content The block's rendered HTML. + * + * @return mixed The HTML, with the kb-preset-- class added to the root element when a preset is set. + */ + protected function render_preset_class( $attributes, $content ) { + if ( ! is_array( $attributes ) || ! is_string( $content ) || $content === '' ) { + return $content; + } + + $classes = $this->preset_classes( $attributes['kbPreset'] ?? '' ); + + if ( $classes === [] ) { + return $content; + } + + $tags = new WP_HTML_Tag_Processor( $content ); + + if ( ! $tags->next_tag( [ 'class_name' => 'wp-block-' . $this->namespace . '-' . $this->block_name ] ) ) { + return $content; + } + + foreach ( $classes as $preset_class ) { + $tags->add_class( $preset_class ); + } + + return $tags->get_updated_html(); + } + /** * Registers scripts and styles. */ @@ -415,7 +508,7 @@ public function get_html_tag( $attributes, $tag_key, $default, $allowed_tags = [ * * @param string $cache_key The cache key (usually unique id). * @param array $attributes The block's attributes. - * @param string $block_name The name of the block. + * @param bool $cache Whether to cache the merged result. Default true. * @return array */ public function get_attributes_with_defaults( $cache_key, $attributes, $cache = true ) { @@ -424,7 +517,31 @@ public function get_attributes_with_defaults( $cache_key, $attributes, $cache = } $default_attributes = $this->get_block_default_attributes(); - $merged_attributes = $this->merge_attributes_with_defaults( $attributes, $default_attributes ); + + /** + * Filters a block's default attributes before they are merged with the instance's attributes. + * + * Lets a module contribute an extra layer of defaults (e.g. the Design Tokens block preset) that + * sits above the block.json defaults yet below the instance attributes, so the merge below still + * lets a per-instance value win. + * + * @since TBD + * + * @param array $default_attributes The block's registration defaults: attribute + * name => default value. + * @param string $block_name The full block name, e.g. "kadence/advancedbtn". + * + * @return array The default attributes, after any module's overlay. + */ + $filtered_attributes = apply_filters( 'kadence_blocks_block_default_attributes', $default_attributes, 'kadence/' . $this->block_name ); + + // A third-party callback could return a non-array; ignore it and keep KB's own defaults rather than + // letting a bad value corrupt the merge below. + if ( is_array( $filtered_attributes ) ) { + $default_attributes = $filtered_attributes; + } + + $merged_attributes = $this->merge_attributes_with_defaults( $attributes, $default_attributes ); if ( $cache ) { $this->attributes_with_defaults[ $cache_key ] = $merged_attributes; @@ -594,4 +711,59 @@ protected function build_escaped_html_attributes( array $attributes ): string { return $html; } + + /** + * Whether a native shadow item paints anything visible — all-zero offsets, blur, and spread + * render nothing regardless of color, matching the value the "None" pick writes. + * + * A non-numeric, non-empty leg is a {dot.alias} token reference, which resolves to a var() whose + * value is unknown here — it counts as visible, since treating it as a zero would let the + * caller's `box-shadow: none` reset erase a shadow the token does paint. A `shadowToken` binding on + * the item follows the same reasoning for the whole shadow, but only while the binding is backed by + * the active library: an unbacked one (a token deleted after the item was saved) no longer paints + * anything the renderer will emit, so it must not block the `box-shadow: none` reset either — it is + * treated as invisible, the same as an item with no binding and no geometry. + * + * Lives here rather than on any one block because it answers a question about the shared shadow + * value shape, which every shadow-carrying block stores identically. It is what a block gates its + * `box-shadow` output on once it has no separate "enable" boolean to read. + * + * @since TBD + * + * @param array $shadow_item One `shadow[0]`-shaped item. + * + * @return bool Whether the item paints a visible shadow. + */ + protected function has_visible_shadow( array $shadow_item ): bool { + // A bound item's visibility is decided by its binding alone; the stored legs are never consulted + // for one. Backed, its real value lives in the token and is unknown here, so it counts as visible + // or the caller's `box-shadow: none` reset would erase a shadow the token does paint. Unbacked, it + // renders nothing (see Kadence_Blocks_CSS::render_shadow()), so it must count as INVISIBLE and let + // the caller fall through to that reset — reading its legs instead would keep a stale binding in + // the shadow branch, where the empty render is dropped and the reset never runs. + $shadow_token = $shadow_item[ Kadence_Blocks_CSS::get_shadow_token_key() ] ?? null; + if ( Alias::is_alias( $shadow_token ) ) { + return Kadence_Blocks_CSS::get_instance()->is_token_reference_backed( $shadow_token ); + } + + foreach ( [ 'hOffset', 'vOffset', 'blur', 'spread' ] as $axis ) { + $value = $shadow_item[ $axis ] ?? 0; + + if ( is_numeric( $value ) ) { + if ( 0.0 !== (float) $value ) { + return true; + } + + continue; + } + + // A {dot.alias} leg resolves to a var() unknown here, so it counts as visible — read as zero, + // the caller's `box-shadow: none` would erase a shadow the token does paint. + if ( is_string( $value ) && '' !== trim( $value ) ) { + return true; + } + } + + return false; + } } diff --git a/includes/blocks/class-kadence-blocks-advanced-form-block.php b/includes/blocks/class-kadence-blocks-advanced-form-block.php index 0f24ac3de4..aba31bb71b 100644 --- a/includes/blocks/class-kadence-blocks-advanced-form-block.php +++ b/includes/blocks/class-kadence-blocks-advanced-form-block.php @@ -5,6 +5,8 @@ * @package Kadence Blocks */ +// cspell:ignore ajaxurl autoembed sizetype . + // Exit if accessed directly. if ( ! defined( 'ABSPATH' ) ) { exit; @@ -69,10 +71,10 @@ public static function get_instance() { /** * Builds CSS for block. * - * @param array $attributes the blocks attributes. - * @param Kadence_Blocks_CSS $css the css class for blocks. - * @param string $unique_id the blocks attr ID. - * @param string $unique_style_id the blocks alternate ID for queries. + * @param array $attributes the blocks attributes. + * @param Kadence_Blocks_CSS $css the css class for blocks. + * @param string $unique_id the blocks attr ID. + * @param string $unique_style_id the blocks alternate ID for queries. */ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { @@ -141,8 +143,21 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $css->render_border_styles( $border_style, 'fieldBorderStyle' ); $css->render_measure_output( $form_attributes, 'fieldBorderRadius', 'border-radius' ); - if ( ! empty( $field_style['boxShadow'][0] ) && $field_style['boxShadow'][0] === true ) { - $css->add_property( 'box-shadow', ( isset( $field_style['boxShadow'][7] ) && true === $field_style['boxShadow'][7] ? 'inset ' : '' ) . ( isset( $field_style['boxShadow'][3] ) && is_numeric( $field_style['boxShadow'][3] ) ? $field_style['boxShadow'][3] : '2' ) . 'px ' . ( isset( $field_style['boxShadow'][4] ) && is_numeric( $field_style['boxShadow'][4] ) ? $field_style['boxShadow'][4] : '2' ) . 'px ' . ( isset( $field_style['boxShadow'][5] ) && is_numeric( $field_style['boxShadow'][5] ) ? $field_style['boxShadow'][5] : '3' ) . 'px ' . ( isset( $field_style['boxShadow'][6] ) && is_numeric( $field_style['boxShadow'][6] ) ? $field_style['boxShadow'][6] : '0' ) . 'px ' . $css->render_color( ( isset( $field_style['boxShadow'][1] ) && ! empty( $field_style['boxShadow'][1] ) ? $field_style['boxShadow'][1] : '#000000' ), ( isset( $field_style['boxShadow'][2] ) && is_numeric( $field_style['boxShadow'][2] ) ? $field_style['boxShadow'][2] : 0.4 ) ) ); + if ( isset( $field_style['boxShadow'] ) && is_array( $field_style['boxShadow'] ) && ! empty( $field_style['boxShadow'][0] ) && $field_style['boxShadow'][0] === true ) { + $css->add_property( + 'box-shadow', + $css->render_legacy_shadow( + $field_style['boxShadow'], + [ + 'hOffset' => '2', + 'vOffset' => '2', + 'blur' => '3', + 'spread' => '0', + 'color' => '#000000', + 'opacity' => 0.4, + ] + ) + ); } $css->render_measure_output( $field_style, 'padding', 'padding', array( 'unit_key' => 'paddingUnit' ) ); @@ -208,8 +223,21 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $css->add_property( 'border-color', $css->sanitize_color( $field_style['borderActive'] ) ); } - if ( ! empty( $field_style['boxShadowActive'][0] ) && $field_style['boxShadowActive'][0] === true ) { - $css->add_property( 'box-shadow', ( isset( $field_style['boxShadowActive'][7] ) && true === $field_style['boxShadowActive'][7] ? 'inset ' : '' ) . ( isset( $field_style['boxShadowActive'][3] ) && is_numeric( $field_style['boxShadowActive'][3] ) ? $field_style['boxShadowActive'][3] : '2' ) . 'px ' . ( isset( $field_style['boxShadowActive'][4] ) && is_numeric( $field_style['boxShadowActive'][4] ) ? $field_style['boxShadowActive'][4] : '2' ) . 'px ' . ( isset( $field_style['boxShadowActive'][5] ) && is_numeric( $field_style['boxShadowActive'][5] ) ? $field_style['boxShadowActive'][5] : '3' ) . 'px ' . ( isset( $field_style['boxShadowActive'][6] ) && is_numeric( $field_style['boxShadowActive'][6] ) ? $field_style['boxShadowActive'][6] : '0' ) . 'px ' . $css->render_color( ( isset( $field_style['boxShadowActive'][1] ) && ! empty( $field_style['boxShadowActive'][1] ) ? $field_style['boxShadowActive'][1] : '#000000' ), ( isset( $field_style['boxShadowActive'][2] ) && is_numeric( $field_style['boxShadowActive'][2] ) ? $field_style['boxShadowActive'][2] : 0.4 ) ) ); + if ( isset( $field_style['boxShadowActive'] ) && is_array( $field_style['boxShadowActive'] ) && ! empty( $field_style['boxShadowActive'][0] ) && $field_style['boxShadowActive'][0] === true ) { + $css->add_property( + 'box-shadow', + $css->render_legacy_shadow( + $field_style['boxShadowActive'], + [ + 'hOffset' => '2', + 'vOffset' => '2', + 'blur' => '3', + 'spread' => '0', + 'color' => '#000000', + 'opacity' => 0.4, + ] + ) + ); } diff --git a/includes/blocks/class-kadence-blocks-advanced-heading-block.php b/includes/blocks/class-kadence-blocks-advanced-heading-block.php index 7085b39bce..144e91c2e0 100644 --- a/includes/blocks/class-kadence-blocks-advanced-heading-block.php +++ b/includes/blocks/class-kadence-blocks-advanced-heading-block.php @@ -5,6 +5,11 @@ * @package Kadence Blocks */ +use KadenceWP\KadenceBlocks\Design_Tokens\Database\Active_Token_Library_Store; +use KadenceWP\KadenceBlocks\Design_Tokens\Registry\Token_Registry; +use KadenceWP\KadenceBlocks\Design_Tokens\Resolver\Preset_Resolver; +use KadenceWP\KadenceBlocks\Utils\Cast; + // Exit if accessed directly. if ( ! defined( 'ABSPATH' ) ) { exit; @@ -59,10 +64,10 @@ public static function get_instance() { /** * Builds CSS for block. * - * @param array $attributes the blocks attributes. - * @param Kadence_Blocks_CSS $css the css class for blocks. - * @param string $unique_id the blocks attr ID. - * @param string $unique_style_id the blocks alternate ID for queries. + * @param array $attributes the blocks attributes. + * @param Kadence_Blocks_CSS $css the css class for blocks. + * @param string $unique_id the blocks attr ID. + * @param string $unique_style_id the blocks alternate ID for queries. */ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { @@ -130,6 +135,8 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $google = $google && ( isset( $attributes['loadGoogleFont'] ) && $attributes['loadGoogleFont'] || ! isset( $attributes['loadGoogleFont'] ) ) ? true : false; $variant = ! empty( $attributes['fontVariant'] ) ? $attributes['fontVariant'] : null; $css->add_property( 'font-family', $css->render_font_family( $attributes['typography'], $google, $variant ) ); + } else { + $this->render_preset_typography( $css, $attributes ); } if ( ! empty( $attributes['textTransform'] ) ) { $css->add_property( 'text-transform', $attributes['textTransform'] ); @@ -926,6 +933,129 @@ public function get_cascading_value($mobile, $tablet, $default, $fallback) { } return $fallback; } + /** + * Point font-family at its preset variable, but only when the active preset actually resolves one. + * + * Called only where the block's own `typography` attribute is empty, so a family a site owner picked + * per-instance always wins — this supplies the family a preset carries for a heading that has none of + * its own. + * + * The gate matters for the same reason it does on the Single Button's spacing bridge: + * `font-family: var(--kb-heading-font-family)` is not inert when the variable is undefined, it is + * invalid at computed-value time, which resets the property to its initial value rather than letting + * the heading inherit the theme's font. Emitting only when the preset resolves a family is what keeps + * a heading whose preset sets none looking exactly as it does today. + * + * The variable, not the literal: the preset projector sets `--kb-heading-font-family` per preset + * scope, so one rule follows whichever preset the heading is on. The binding deliberately declares no + * `css_prop`, which is what keeps font-family out of the block-default rule that every heading gets + * (see the declaration for why that would break theme inheritance). + * + * @since TBD + * + * @param Kadence_Blocks_CSS $css The css object. + * @param array $attributes The block attributes. + * + * @return void + */ + private function render_preset_typography( Kadence_Blocks_CSS $css, array $attributes ): void { + try { + $registry = kadence_blocks()->get( Token_Registry::class ); + $library = kadence_blocks()->get( Active_Token_Library_Store::class ); + $resolver = kadence_blocks()->get( Preset_Resolver::class ); + + // The container is typed `mixed`, and this runs on every heading render, so the services are + // checked rather than assumed — a misconfigured container degrades to today's font. + if ( + ! $registry instanceof Token_Registry + || ! $library instanceof Active_Token_Library_Store + || ! $resolver instanceof Preset_Resolver + || ! $registry->is_active() + ) { + return; + } + + $slug = $library->get(); + $selected = Cast::to_string( $attributes['kbPreset'] ?? '' ); + $preset = $selected !== '' && $resolver->has_preset( 'kadence/advancedheading', $selected, $slug ) + ? $selected + : $resolver->default_preset( 'kadence/advancedheading', $slug ); + $values = $resolver->resolve( 'kadence/advancedheading', $preset, $slug ); + } catch ( Throwable $e ) { + // This runs in the render path, so a broken token graph must not take the page down with it — + // the heading simply keeps the font it has today. + return; + } + + if ( ! isset( $values['typography'] ) ) { + return; + } + + $css->add_property( 'font-family', 'var(--kb-heading-font-family)' ); + + // Enqueue the family as well as name it. The block's own loading is driven by the `typography` + // attribute, which is empty in exactly the case this bridge fires, so without this a heading that + // takes its family from a preset would render in a fallback face while the CSS asked for the real + // one. The preset stores the family as a literal, which is the shape this expects. + $family = Cast::to_string( $values['typography'] ); + + if ( $family !== '' && 'inherit' !== $family ) { + $variant = $this->preset_font_variant( $attributes, $values ); + + $css->maybe_add_google_font( $family, $variant !== '' ? $variant : null ); + } + } + + /** + * The Google variant to request alongside a preset's family, so the weight the page asks for is a + * face the browser actually has. + * + * A preset carries its family and its weight as two independent properties: the family arrives here, + * while the weight reaches the page as a `font-weight` declaration through its own binding. Asking + * for the family without its weight loads the upright default and leaves the browser to synthesize + * everything else — a heading set to 700 renders as a faked bold rather than the real face, which is + * the outcome narrowing the weight picker to a family's shipped weights exists to prevent. + * + * Precedence follows what actually renders. An explicit `fontVariant` on the block is a direct + * statement about the face and wins outright; a `fontWeight` the block sets itself comes next, since + * that is the weight the CSS above emits for it; the preset's own weight applies only when the block + * states neither. + * + * `presetFontVariant()` in `src/blocks/advancedheading/preset-font-variant.js` holds the JS twin of + * this mapping, so the editor's loader and this enqueue ask Google for the same face. Keep the two in + * step. A weight neither recognizes yields `''`, which asks for no variant and so leaves the family + * loading exactly as it did before this bridge existed. + * + * @since TBD + * + * @param array $attributes The block attributes. + * @param array $values The active preset's resolved values. + * + * @return string The Google variant, or '' when nothing names a face to ask for. + */ + private function preset_font_variant( array $attributes, array $values ): string { + if ( ! empty( $attributes['fontVariant'] ) ) { + return Cast::to_string( $attributes['fontVariant'] ); + } + + $weight = ! empty( $attributes['fontWeight'] ) + ? Cast::to_string( $attributes['fontWeight'] ) + : Cast::to_string( $values['fontWeight'] ?? '' ); + + $weight = strtolower( trim( $weight ) ); + + // `regular` rather than `400`: it is the v1 spelling the rest of this plugin already uses for the + // upright default (see `render_font_weight()`), and the editor's `parseVariant` reads it as 400. + if ( 'normal' === $weight || 'regular' === $weight || '400' === $weight ) { + return 'regular'; + } + + if ( 'bold' === $weight ) { + return '700'; + } + + return preg_match( '/^[1-9]00$/', $weight ) === 1 ? $weight : ''; + } } Kadence_Blocks_Advancedheading_Block::get_instance(); diff --git a/includes/blocks/class-kadence-blocks-advancedbtn-block.php b/includes/blocks/class-kadence-blocks-advancedbtn-block.php index 79d7d00ef7..b3e14d9eda 100644 --- a/includes/blocks/class-kadence-blocks-advancedbtn-block.php +++ b/includes/blocks/class-kadence-blocks-advancedbtn-block.php @@ -5,6 +5,8 @@ * @package Kadence Blocks */ +// cspell:ignore bgtype btnkey btnvalue simplelightbox videolight . + // Exit if accessed directly. if ( ! defined( 'ABSPATH' ) ) { exit; @@ -51,10 +53,10 @@ public static function get_instance() { /** * Builds CSS for block. * - * @param array $attributes the blocks attributes. - * @param string $css the css class for blocks. - * @param string $unique_id the blocks attr ID. - * @param string $unique_style_id the blocks alternate ID for queries. + * @param array $attributes the blocks attributes. + * @param Kadence_Blocks_CSS $css the css object for blocks. + * @param string $unique_id the blocks attr ID. + * @param string $unique_style_id the blocks alternate ID for queries. */ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $css->set_style_id( 'kb-' . $this->block_name . $unique_style_id ); @@ -326,7 +328,20 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $css->add_property( 'border-style', 'solid' ); } if ( isset( $btnvalue['boxShadow'] ) && is_array( $btnvalue['boxShadow'] ) && isset( $btnvalue['boxShadow'][0] ) && true === $btnvalue['boxShadow'][0] ) { - $css->add_property( 'box-shadow', ( isset( $btnvalue['boxShadow'][7] ) && true === $btnvalue['boxShadow'][7] ? 'inset ' : '' ) . ( isset( $btnvalue['boxShadow'][3] ) && is_numeric( $btnvalue['boxShadow'][3] ) ? $btnvalue['boxShadow'][3] : '1' ) . 'px ' . ( isset( $btnvalue['boxShadow'][4] ) && is_numeric( $btnvalue['boxShadow'][4] ) ? $btnvalue['boxShadow'][4] : '1' ) . 'px ' . ( isset( $btnvalue['boxShadow'][5] ) && is_numeric( $btnvalue['boxShadow'][5] ) ? $btnvalue['boxShadow'][5] : '2' ) . 'px ' . ( isset( $btnvalue['boxShadow'][6] ) && is_numeric( $btnvalue['boxShadow'][6] ) ? $btnvalue['boxShadow'][6] : '0' ) . 'px ' . $css->render_color( ( isset( $btnvalue['boxShadow'][1] ) && ! empty( $btnvalue['boxShadow'][1] ) ? $btnvalue['boxShadow'][1] : '#000000' ), ( isset( $btnvalue['boxShadow'][2] ) && is_numeric( $btnvalue['boxShadow'][2] ) ? $btnvalue['boxShadow'][2] : 0.2 ) ) ); + $css->add_property( + 'box-shadow', + $css->render_legacy_shadow( + $btnvalue['boxShadow'], + [ + 'hOffset' => '1', + 'vOffset' => '1', + 'blur' => '2', + 'spread' => '0', + 'color' => '#000000', + 'opacity' => 0.2, + ] + ) + ); } $css->render_measure_output( $btnvalue, 'margin', 'margin', [ 'unit_key' => 'marginUnit' ] ); @@ -341,7 +356,20 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $css->add_property( 'border-color', $css->render_color( $btnvalue['borderHover'], $alpha ) ); } if ( isset( $btnvalue['boxShadowHover'] ) && is_array( $btnvalue['boxShadowHover'] ) && isset( $btnvalue['boxShadowHover'][0] ) && true === $btnvalue['boxShadowHover'][0] && isset( $btnvalue['boxShadowHover'][7] ) && true !== $btnvalue['boxShadowHover'][7] ) { - $css->add_property( 'box-shadow', ( isset( $btnvalue['boxShadowHover'][7] ) && true === $btnvalue['boxShadowHover'][7] ? 'inset ' : '' ) . ( isset( $btnvalue['boxShadowHover'][3] ) && is_numeric( $btnvalue['boxShadowHover'][3] ) ? $btnvalue['boxShadowHover'][3] : '2' ) . 'px ' . ( isset( $btnvalue['boxShadowHover'][4] ) && is_numeric( $btnvalue['boxShadowHover'][4] ) ? $btnvalue['boxShadowHover'][4] : '2' ) . 'px ' . ( isset( $btnvalue['boxShadowHover'][5] ) && is_numeric( $btnvalue['boxShadowHover'][5] ) ? $btnvalue['boxShadowHover'][5] : '3' ) . 'px ' . ( isset( $btnvalue['boxShadowHover'][6] ) && is_numeric( $btnvalue['boxShadowHover'][6] ) ? $btnvalue['boxShadowHover'][6] : '0' ) . 'px ' . $css->render_color( ( isset( $btnvalue['boxShadowHover'][1] ) && ! empty( $btnvalue['boxShadowHover'][1] ) ? $btnvalue['boxShadowHover'][1] : '#000000' ), ( isset( $btnvalue['boxShadowHover'][2] ) && is_numeric( $btnvalue['boxShadowHover'][2] ) ? $btnvalue['boxShadowHover'][2] : 0.4 ) ) ); + $css->add_property( + 'box-shadow', + $css->render_legacy_shadow( + $btnvalue['boxShadowHover'], + [ + 'hOffset' => '2', + 'vOffset' => '2', + 'blur' => '3', + 'spread' => '0', + 'color' => '#000000', + 'opacity' => 0.4, + ] + ) + ); } if ( 'gradient' === $bgtype ) { $css->set_selector( '.wp-block-kadence-advancedbtn.kt-btns' . $unique_id . ' .kt-btn-wrap-' . $btnkey . ' .kt-button::before' ); @@ -359,7 +387,20 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $css->add_property( 'background', $css->render_color( $btnvalue['backgroundHover'], $alpha ) ); } if ( isset( $btnvalue['boxShadowHover'] ) && is_array( $btnvalue['boxShadowHover'] ) && isset( $btnvalue['boxShadowHover'][0] ) && true === $btnvalue['boxShadowHover'][0] && isset( $btnvalue['boxShadowHover'][7] ) && true === $btnvalue['boxShadowHover'][7] ) { - $css->add_property( 'box-shadow', ( isset( $btnvalue['boxShadowHover'][7] ) && true === $btnvalue['boxShadowHover'][7] ? 'inset ' : '' ) . ( isset( $btnvalue['boxShadowHover'][3] ) && is_numeric( $btnvalue['boxShadowHover'][3] ) ? $btnvalue['boxShadowHover'][3] : '2' ) . 'px ' . ( isset( $btnvalue['boxShadowHover'][4] ) && is_numeric( $btnvalue['boxShadowHover'][4] ) ? $btnvalue['boxShadowHover'][4] : '2' ) . 'px ' . ( isset( $btnvalue['boxShadowHover'][5] ) && is_numeric( $btnvalue['boxShadowHover'][5] ) ? $btnvalue['boxShadowHover'][5] : '3' ) . 'px ' . ( isset( $btnvalue['boxShadowHover'][6] ) && is_numeric( $btnvalue['boxShadowHover'][6] ) ? $btnvalue['boxShadowHover'][6] : '0' ) . 'px ' . $css->render_color( ( isset( $btnvalue['boxShadowHover'][1] ) && ! empty( $btnvalue['boxShadowHover'][1] ) ? $btnvalue['boxShadowHover'][1] : '#000000' ), ( isset( $btnvalue['boxShadowHover'][2] ) && is_numeric( $btnvalue['boxShadowHover'][2] ) ? $btnvalue['boxShadowHover'][2] : 0.4 ) ) ); + $css->add_property( + 'box-shadow', + $css->render_legacy_shadow( + $btnvalue['boxShadowHover'], + [ + 'hOffset' => '2', + 'vOffset' => '2', + 'blur' => '3', + 'spread' => '0', + 'color' => '#000000', + 'opacity' => 0.4, + ] + ) + ); $css->add_property( 'border-radius', ( isset( $btnvalue['borderRadius'] ) && is_numeric( $btnvalue['borderRadius'] ) ? $btnvalue['borderRadius'] : '3' ) . 'px' ); } } else { @@ -376,7 +417,20 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { } } if ( isset( $btnvalue['boxShadowHover'] ) && is_array( $btnvalue['boxShadowHover'] ) && isset( $btnvalue['boxShadowHover'][0] ) && true === $btnvalue['boxShadowHover'][0] && isset( $btnvalue['boxShadowHover'][7] ) && true === $btnvalue['boxShadowHover'][7] ) { - $css->add_property( 'box-shadow', ( isset( $btnvalue['boxShadowHover'][7] ) && true === $btnvalue['boxShadowHover'][7] ? 'inset ' : '' ) . ( isset( $btnvalue['boxShadowHover'][3] ) && is_numeric( $btnvalue['boxShadowHover'][3] ) ? $btnvalue['boxShadowHover'][3] : '2' ) . 'px ' . ( isset( $btnvalue['boxShadowHover'][4] ) && is_numeric( $btnvalue['boxShadowHover'][4] ) ? $btnvalue['boxShadowHover'][4] : '2' ) . 'px ' . ( isset( $btnvalue['boxShadowHover'][5] ) && is_numeric( $btnvalue['boxShadowHover'][5] ) ? $btnvalue['boxShadowHover'][5] : '3' ) . 'px ' . ( isset( $btnvalue['boxShadowHover'][6] ) && is_numeric( $btnvalue['boxShadowHover'][6] ) ? $btnvalue['boxShadowHover'][6] : '0' ) . 'px ' . $css->render_color( ( isset( $btnvalue['boxShadowHover'][1] ) && ! empty( $btnvalue['boxShadowHover'][1] ) ? $btnvalue['boxShadowHover'][1] : '#000000' ), ( isset( $btnvalue['boxShadowHover'][2] ) && is_numeric( $btnvalue['boxShadowHover'][2] ) ? $btnvalue['boxShadowHover'][2] : 0.4 ) ) ); + $css->add_property( + 'box-shadow', + $css->render_legacy_shadow( + $btnvalue['boxShadowHover'], + [ + 'hOffset' => '2', + 'vOffset' => '2', + 'blur' => '3', + 'spread' => '0', + 'color' => '#000000', + 'opacity' => 0.4, + ] + ) + ); } } // Tablet CSS. diff --git a/includes/blocks/class-kadence-blocks-advancedgallery-block.php b/includes/blocks/class-kadence-blocks-advancedgallery-block.php index fb5eb5bf18..9a2b5a53be 100644 --- a/includes/blocks/class-kadence-blocks-advancedgallery-block.php +++ b/includes/blocks/class-kadence-blocks-advancedgallery-block.php @@ -5,11 +5,15 @@ * @package Kadence Blocks */ +// cspell:ignore Csvg NODEFDTD NOIMPLIED alignnone arrowstyle dotstyle figcap fluidcarousel glight kses outlinedark outlinelight relcustom tcolumns thumbslider . + // Exit if accessed directly. if ( ! defined( 'ABSPATH' ) ) { exit; } +use KadenceWP\KadenceBlocks\Utils\Cast; + /** * Class to Build the Advanced Gallery Block. * @@ -95,10 +99,10 @@ public function render_scripts( $attributes, $inline = false ) { /** * Builds CSS for block. * - * @param array $attributes the blocks attributes. - * @param Kadence_Blocks_CSS $css the css class for blocks. - * @param string $unique_id the blocks attr ID. - * @param string $unique_style_id the blocks alternate ID for queries. + * @param array $attributes the blocks attributes. + * @param Kadence_Blocks_CSS $css the css class for blocks. + * @param string $unique_id the blocks attr ID. + * @param string $unique_style_id the blocks alternate ID for queries. */ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $updated_version = ! empty( $attributes['kbVersion'] ) && $attributes['kbVersion'] > 1 ? true : false; @@ -108,7 +112,7 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $css->set_selector('.wp-block-kadence-advancedgallery.kb-gallery-wrap-id-' . $unique_id ); if ( isset( $attributes['margin'][0] ) ) { - // Fix for this margin unit being in a non-standard locaiton in array, should be updated. + // Fix for this margin unit being in a non-standard location in array, should be updated. $margin_unit = ( ! empty( $attributes['marginUnit'] ) ? $attributes['marginUnit'] : 'px' ); $css->render_measure_output( array_merge( $attributes['margin'][0], array( 'marginType' => $margin_unit ) ), @@ -304,12 +308,38 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { if ( isset( $attributes['shadow'] ) && is_array( $attributes['shadow'] ) && is_array( $attributes['shadow'][ 0 ] ) ) { $shadow = $attributes['shadow'][ 0 ]; $css->set_selector('.kb-gallery-id-' . $unique_id . ' .kadence-blocks-gallery-item .kb-gal-image-radius, .kb-gallery-id-' . $unique_id . ' .kadence-blocks-gallery-thumb-item .kb-gal-image-radius' ); - $css->add_property('box-shadow', $shadow['hOffset'] . 'px ' . $shadow['vOffset'] . 'px ' . $shadow['blur'] . 'px ' . $shadow['spread'] . 'px ' . $css->render_color( $shadow['color'], $shadow['opacity'] ) ); + $css->add_property( + 'box-shadow', + $css->render_shadow( + $shadow, + [ + 'hOffset' => '4', + 'vOffset' => '2', + 'blur' => '14', + 'spread' => '0', + 'color' => '#000000', + 'opacity' => 0.2, + ] + ) + ); } if ( isset( $attributes['shadowHover'] ) && is_array( $attributes['shadowHover'] ) && is_array( $attributes['shadowHover'][ 0 ] ) ) { $shadow_hover = $attributes['shadowHover'][ 0 ]; $css->set_selector('.kb-gallery-id-' . $unique_id . ' .kadence-blocks-gallery-item:hover .kb-gal-image-radius, .kb-gallery-id-' . $unique_id . ' .kadence-blocks-gallery-thumb-item:hover .kb-gal-image-radius' ); - $css->add_property('box-shadow', $shadow_hover['hOffset'] . 'px ' . $shadow_hover['vOffset'] . 'px ' . $shadow_hover['blur'] . 'px ' . $shadow_hover['spread'] . 'px ' . $css->render_color( $shadow_hover['color'], $shadow_hover['opacity'] ) ); + $css->add_property( + 'box-shadow', + $css->render_shadow( + $shadow_hover, + [ + 'hOffset' => '4', + 'vOffset' => '2', + 'blur' => '14', + 'spread' => '0', + 'color' => '#000000', + 'opacity' => 0.2, + ] + ) + ); } else { $css->set_selector('.kb-gallery-id-' . $unique_id . ' .kadence-blocks-gallery-item:hover .kb-gal-image-radius' ); @@ -873,11 +903,11 @@ public function build_html( $attributes, $unique_id, $content, $block_instance ) * This function can be used by Kadence Blocks Pro for dynamic content. * It creates a mosaic pattern layout for gallery images with specific grid classes. * - * @param array $images Array of image objects with image data. - * @param array $attributes Gallery block attributes. - * @param array $gallery_classes Array of CSS classes for the gallery container. - * @param string $image_filter Image filter setting. - * @param bool $lightbox_cap Whether lightbox captions are enabled. + * @param array $images Array of image objects with image data. + * @param array $attributes Gallery block attributes. + * @param array $gallery_classes Array of CSS classes for the gallery container. + * @param string $image_filter Image filter setting. + * @param bool $lightbox_cap Whether lightbox captions are enabled. * @return string HTML markup for the mosaic gallery. */ public function render_mosaic_gallery( $images, $attributes, $gallery_classes = array(), $image_filter = 'none', $lightbox_cap = false ) { @@ -982,7 +1012,10 @@ public function get_image_srcset_output( $id = null, $url = null, $width = null, return $output; } /** - * Output Gallery image markeup. + * Output Gallery image markup. + * + * @param array $image Image data. + * @param array $attributes Gallery block attributes. */ public function render_gallery_images( $image, $attributes ) { $type = ( ! empty( $attributes['type'] ) ? $attributes['type'] : 'masonry' ); @@ -1103,7 +1136,7 @@ public function render_gallery_images( $image, $attributes ) { $figcap = '<' . $fig_tag . ' class="kadence-blocks-gallery-item__caption">' . ( ! empty( $caption ) && is_string( $caption ) ? wp_kses_post( $caption ) : '' ) . ''; //links in the main gallery caption can mess with lightbox function, strip them out. - //they're okay in the lighbox though + // they're okay in the lightbox though. if( $link_to === 'media' && $lightbox === 'magnific' && ! empty( $figcap ) && is_string( $figcap ) ) { $figcap = preg_replace('#(.*?)#i', '\1', $figcap); } @@ -1132,7 +1165,7 @@ public function render_gallery_images( $image, $attributes ) { $output .= '
'; $figure_style = ''; if ( ! empty( $padding_bottom ) && 'below' === $caption_style ) { - $figure_style = ' style="max-width:' . esc_attr( $image['width'] ) . 'px;"'; + $figure_style = ' style="max-width:' . esc_attr( Cast::to_string( $image['width'] ) ) . 'px;"'; } $output .= '
'; if ( ! empty( $href ) ) { @@ -1170,7 +1203,10 @@ public function render_gallery_images( $image, $attributes ) { return $output; } /** - * Output Gallery image markeup. + * Output Gallery image markup. + * + * @param array $image Image data. + * @param array $attributes Gallery block attributes. */ public function render_gallery_thumb_images( $image, $attributes ) { $type = ( ! empty( $attributes['type'] ) ? $attributes['type'] : 'masonry' ); diff --git a/includes/blocks/class-kadence-blocks-column-block.php b/includes/blocks/class-kadence-blocks-column-block.php index dfc4173b3d..64bada16a4 100644 --- a/includes/blocks/class-kadence-blocks-column-block.php +++ b/includes/blocks/class-kadence-blocks-column-block.php @@ -5,6 +5,8 @@ * @package Kadence Blocks */ +// cspell:ignore aligncenter . + // Exit if accessed directly. if ( ! defined( 'ABSPATH' ) ) { exit; @@ -43,10 +45,10 @@ public static function get_instance() { /** * Builds CSS for block. * - * @param array $attributes the blocks attributes. - * @param string $css the css class for blocks. - * @param string $unique_id the blocks attr ID. - * @param string $unique_style_id the blocks alternate ID for queries. + * @param array $attributes the blocks attributes. + * @param Kadence_Blocks_CSS $css the css object for blocks. + * @param string $unique_id the blocks attr ID. + * @param string $unique_style_id the blocks alternate ID for queries. */ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $css->set_style_id( 'kb-' . $this->block_name . $unique_style_id ); @@ -123,7 +125,7 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $css->add_property( 'max-width', $attributes['maxWidth'][0] . $max_width_unit ); $css->add_property( 'margin-left', 'auto' ); $css->add_property( 'margin-right', 'auto' ); - //Section inside Section compatablity. + // Section inside Section compatibility. // $css->set_selector( '.wp-block-kadence-column>.kt-inside-inner-col>.kadence-column' . $unique_id ); // $css->add_property( 'flex', '1 ' . $attributes['maxWidth'][0] . ( isset( $attributes['maxWidthUnit'] ) ? $attributes['maxWidthUnit'] : 'px' ) ); $css->set_selector( '.wp-block-kadence-column.kb-section-dir-horizontal:not(.kb-section-md-dir-vertical)>.kt-inside-inner-col>.kadence-column' . $unique_id ); @@ -229,7 +231,20 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $css->set_media_state( 'desktop' ); if ( isset( $attributes['displayShadow'] ) && true == $attributes['displayShadow'] ) { if ( isset( $attributes['shadow'] ) && is_array( $attributes['shadow'] ) && isset( $attributes['shadow'][0] ) && is_array( $attributes['shadow'][0] ) ) { - $css->add_property( 'box-shadow', ( isset( $attributes['shadow'][0]['inset'] ) && true === $attributes['shadow'][0]['inset'] ? 'inset ' : '' ) . ( isset( $attributes['shadow'][0]['hOffset'] ) && is_numeric( $attributes['shadow'][0]['hOffset'] ) ? $attributes['shadow'][0]['hOffset'] : '0' ) . 'px ' . ( isset( $attributes['shadow'][0]['vOffset'] ) && is_numeric( $attributes['shadow'][0]['vOffset'] ) ? $attributes['shadow'][0]['vOffset'] : '0' ) . 'px ' . ( isset( $attributes['shadow'][0]['blur'] ) && is_numeric( $attributes['shadow'][0]['blur'] ) ? $attributes['shadow'][0]['blur'] : '14' ) . 'px ' . ( isset( $attributes['shadow'][0]['spread'] ) && is_numeric( $attributes['shadow'][0]['spread'] ) ? $attributes['shadow'][0]['spread'] : '0' ) . 'px ' . $css->render_color( ( isset( $attributes['shadow'][0]['color'] ) && ! empty( $attributes['shadow'][0]['color'] ) ? $attributes['shadow'][0]['color'] : '#000000' ), ( isset( $attributes['shadow'][0]['opacity'] ) && is_numeric( $attributes['shadow'][0]['opacity'] ) ? $attributes['shadow'][0]['opacity'] : 0.2 ) ) ); + $css->add_property( + 'box-shadow', + $css->render_shadow( + $attributes['shadow'][0], + [ + 'hOffset' => '0', + 'vOffset' => '0', + 'blur' => '14', + 'spread' => '0', + 'color' => '#000000', + 'opacity' => 0.2, + ] + ) + ); } else { $css->add_property( 'box-shadow', 'rgba(0, 0, 0, 0.2) 0px 0px 14px 0px' ); } @@ -261,7 +276,20 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { if ( isset( $attributes['displayHoverShadow'] ) && true == $attributes['displayHoverShadow'] ) { $css->set_selector( '.kadence-column' . $unique_id . ':hover > .kt-inside-inner-col' ); if ( isset( $attributes['shadowHover'] ) && is_array( $attributes['shadowHover'] ) && isset( $attributes['shadowHover'][0] ) && is_array( $attributes['shadowHover'][0] ) ) { - $css->add_property( 'box-shadow', ( isset( $attributes['shadowHover'][0]['inset'] ) && true === $attributes['shadowHover'][0]['inset'] ? 'inset ' : '' ) . ( isset( $attributes['shadowHover'][0]['hOffset'] ) && is_numeric( $attributes['shadowHover'][0]['hOffset'] ) ? $attributes['shadowHover'][0]['hOffset'] : '0' ) . 'px ' . ( isset( $attributes['shadowHover'][0]['vOffset'] ) && is_numeric( $attributes['shadowHover'][0]['vOffset'] ) ? $attributes['shadowHover'][0]['vOffset'] : '0' ) . 'px ' . ( isset( $attributes['shadowHover'][0]['blur'] ) && is_numeric( $attributes['shadowHover'][0]['blur'] ) ? $attributes['shadowHover'][0]['blur'] : '14' ) . 'px ' . ( isset( $attributes['shadowHover'][0]['spread'] ) && is_numeric( $attributes['shadowHover'][0]['spread'] ) ? $attributes['shadowHover'][0]['spread'] : '0' ) . 'px ' . $css->render_color( ( isset( $attributes['shadowHover'][0]['color'] ) && ! empty( $attributes['shadowHover'][0]['color'] ) ? $attributes['shadowHover'][0]['color'] : '#000000' ), ( isset( $attributes['shadowHover'][0]['opacity'] ) && is_numeric( $attributes['shadowHover'][0]['opacity'] ) ? $attributes['shadowHover'][0]['opacity'] : 0.2 ) ) ); + $css->add_property( + 'box-shadow', + $css->render_shadow( + $attributes['shadowHover'][0], + [ + 'hOffset' => '0', + 'vOffset' => '0', + 'blur' => '14', + 'spread' => '0', + 'color' => '#000000', + 'opacity' => 0.2, + ] + ) + ); } else { $css->add_property( 'box-shadow', 'rgba(0, 0, 0, 0.2) 0px 0px 14px 0px' ); } @@ -907,7 +935,7 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { } $css->set_media_state( 'desktop' ); } else { - // New margin intentially targets outer container, improvement and don't have to worry about issues with row layout. + // New margin intentionally targets outer container, improvement and don't have to worry about issues with row layout. $css->set_selector( '.kadence-column' . $unique_id . ', .kt-inside-inner-col > .kadence-column' . $unique_id . ':not(.specificity)' ); $css->render_measure_output( $attributes, diff --git a/includes/blocks/class-kadence-blocks-form-block.php b/includes/blocks/class-kadence-blocks-form-block.php index 9bf260373a..ec11d45dc5 100644 --- a/includes/blocks/class-kadence-blocks-form-block.php +++ b/includes/blocks/class-kadence-blocks-form-block.php @@ -5,6 +5,8 @@ * @package Kadence Blocks */ +// cspell:ignore ajaxurl bgtype lpignore missingkey . + // Exit if accessed directly. if ( ! defined( 'ABSPATH' ) ) { exit; @@ -52,10 +54,10 @@ public static function get_instance() { /** * Builds CSS for block. * - * @param array $attributes the blocks attributes. - * @param Kadence_Blocks_CSS $css the css class for blocks. - * @param string $unique_id the blocks attr ID. - * @param string $unique_style_id the blocks alternate ID for queries. + * @param array $attributes the blocks attributes. + * @param Kadence_Blocks_CSS $css the css class for blocks. + * @param string $unique_id the blocks attr ID. + * @param string $unique_style_id the blocks alternate ID for queries. */ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { @@ -203,7 +205,20 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $css->add_property( 'border-color', $css->render_color( $style['border'], $alpha ) ); } if ( isset( $style['boxShadow'] ) && is_array( $style['boxShadow'] ) && isset( $style['boxShadow'][0] ) && true === $style['boxShadow'][0] ) { - $css->add_property( 'box-shadow', ( isset( $style['boxShadow'][7] ) && true === $style['boxShadow'][7] ? 'inset ' : '' ) . ( isset( $style['boxShadow'][3] ) && is_numeric( $style['boxShadow'][3] ) ? $style['boxShadow'][3] : '1' ) . 'px ' . ( isset( $style['boxShadow'][4] ) && is_numeric( $style['boxShadow'][4] ) ? $style['boxShadow'][4] : '1' ) . 'px ' . ( isset( $style['boxShadow'][5] ) && is_numeric( $style['boxShadow'][5] ) ? $style['boxShadow'][5] : '2' ) . 'px ' . ( isset( $style['boxShadow'][6] ) && is_numeric( $style['boxShadow'][6] ) ? $style['boxShadow'][6] : '0' ) . 'px ' . $css->render_color( ( isset( $style['boxShadow'][1] ) && ! empty( $style['boxShadow'][1] ) ? $style['boxShadow'][1] : '#000000' ), ( isset( $style['boxShadow'][2] ) && is_numeric( $style['boxShadow'][2] ) ? $style['boxShadow'][2] : 0.2 ) ) ); + $css->add_property( + 'box-shadow', + $css->render_legacy_shadow( + $style['boxShadow'], + [ + 'hOffset' => '1', + 'vOffset' => '1', + 'blur' => '2', + 'spread' => '0', + 'color' => '#000000', + 'opacity' => 0.2, + ] + ) + ); } } @@ -217,7 +232,20 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $css->add_property( 'border-color', $css->render_color( $style['borderActive'], $alpha ) ); } if ( isset( $style['boxShadowActive'] ) && is_array( $style['boxShadowActive'] ) && isset( $style['boxShadowActive'][0] ) && true === $style['boxShadowActive'][0] ) { - $css->add_property( 'box-shadow', ( isset( $style['boxShadowActive'][7] ) && true === $style['boxShadowActive'][7] ? 'inset ' : '' ) . ( isset( $style['boxShadowActive'][3] ) && is_numeric( $style['boxShadowActive'][3] ) ? $style['boxShadowActive'][3] : '2' ) . 'px ' . ( isset( $style['boxShadowActive'][4] ) && is_numeric( $style['boxShadowActive'][4] ) ? $style['boxShadowActive'][4] : '2' ) . 'px ' . ( isset( $style['boxShadowActive'][5] ) && is_numeric( $style['boxShadowActive'][5] ) ? $style['boxShadowActive'][5] : '3' ) . 'px ' . ( isset( $style['boxShadowActive'][6] ) && is_numeric( $style['boxShadowActive'][6] ) ? $style['boxShadowActive'][6] : '0' ) . 'px ' . $css->render_color( ( isset( $style['boxShadowActive'][1] ) && ! empty( $style['boxShadowActive'][1] ) ? $style['boxShadowActive'][1] : '#000000' ), ( isset( $style['boxShadowActive'][2] ) && is_numeric( $style['boxShadowActive'][2] ) ? $style['boxShadowActive'][2] : 0.4 ) ) ); + $css->add_property( + 'box-shadow', + $css->render_legacy_shadow( + $style['boxShadowActive'], + [ + 'hOffset' => '2', + 'vOffset' => '2', + 'blur' => '3', + 'spread' => '0', + 'color' => '#000000', + 'opacity' => 0.4, + ] + ) + ); } if ( isset( $style['backgroundActiveType'] ) && 'gradient' === $style['backgroundActiveType'] ) { $bg1 = ( ! isset( $style['backgroundActive'] ) ? $css->render_color( '#444444', ( isset( $style['backgroundActiveOpacity'] ) && is_numeric( $style['backgroundActiveOpacity'] ) ? $style['backgroundActiveOpacity'] : 1 ) ) : $css->render_color( $style['backgroundActive'], ( isset( $style['backgroundActiveOpacity'] ) && is_numeric( $style['backgroundActiveOpacity'] ) ? $style['backgroundActiveOpacity'] : 1 ) ) ); @@ -440,7 +468,20 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $css->add_property( 'border-color', $css->render_color( $submit['border'], $alpha ) ); } if ( isset( $submit['boxShadow'] ) && is_array( $submit['boxShadow'] ) && isset( $submit['boxShadow'][0] ) && true === $submit['boxShadow'][0] ) { - $css->add_property( 'box-shadow', ( isset( $submit['boxShadow'][7] ) && true === $submit['boxShadow'][7] ? 'inset ' : '' ) . ( isset( $submit['boxShadow'][3] ) && is_numeric( $submit['boxShadow'][3] ) ? $submit['boxShadow'][3] : '1' ) . 'px ' . ( isset( $submit['boxShadow'][4] ) && is_numeric( $submit['boxShadow'][4] ) ? $submit['boxShadow'][4] : '1' ) . 'px ' . ( isset( $submit['boxShadow'][5] ) && is_numeric( $submit['boxShadow'][5] ) ? $submit['boxShadow'][5] : '2' ) . 'px ' . ( isset( $submit['boxShadow'][6] ) && is_numeric( $submit['boxShadow'][6] ) ? $submit['boxShadow'][6] : '0' ) . 'px ' . $css->render_color( ( isset( $submit['boxShadow'][1] ) && ! empty( $submit['boxShadow'][1] ) ? $submit['boxShadow'][1] : '#000000' ), ( isset( $submit['boxShadow'][2] ) && is_numeric( $submit['boxShadow'][2] ) ? $submit['boxShadow'][2] : 0.2 ) ) ); + $css->add_property( + 'box-shadow', + $css->render_legacy_shadow( + $submit['boxShadow'], + [ + 'hOffset' => '1', + 'vOffset' => '1', + 'blur' => '2', + 'spread' => '0', + 'color' => '#000000', + 'opacity' => 0.2, + ] + ) + ); } $css->set_selector( '.kadence-form-' . $unique_id . ' .kb-form .kadence-blocks-form-field .kb-forms-submit:hover, .kadence-form-' . $unique_id . ' .kb-form .kadence-blocks-form-field .kb-forms-submit:focus ' ); @@ -452,7 +493,20 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $css->add_property( 'border-color', $css->render_color( $submit['borderHover'], $alpha ) ); } if ( isset( $submit['boxShadowHover'] ) && is_array( $submit['boxShadowHover'] ) && isset( $submit['boxShadowHover'][0] ) && true === $submit['boxShadowHover'][0] && isset( $submit['boxShadowHover'][7] ) && true !== $submit['boxShadowHover'][7] ) { - $css->add_property( 'box-shadow', ( isset( $submit['boxShadowHover'][7] ) && true === $submit['boxShadowHover'][7] ? 'inset ' : '' ) . ( isset( $submit['boxShadowHover'][3] ) && is_numeric( $submit['boxShadowHover'][3] ) ? $submit['boxShadowHover'][3] : '2' ) . 'px ' . ( isset( $submit['boxShadowHover'][4] ) && is_numeric( $submit['boxShadowHover'][4] ) ? $submit['boxShadowHover'][4] : '2' ) . 'px ' . ( isset( $submit['boxShadowHover'][5] ) && is_numeric( $submit['boxShadowHover'][5] ) ? $submit['boxShadowHover'][5] : '3' ) . 'px ' . ( isset( $submit['boxShadowHover'][6] ) && is_numeric( $submit['boxShadowHover'][6] ) ? $submit['boxShadowHover'][6] : '0' ) . 'px ' . $css->render_color( ( isset( $submit['boxShadowHover'][1] ) && ! empty( $submit['boxShadowHover'][1] ) ? $submit['boxShadowHover'][1] : '#000000' ), ( isset( $submit['boxShadowHover'][2] ) && is_numeric( $submit['boxShadowHover'][2] ) ? $submit['boxShadowHover'][2] : 0.4 ) ) ); + $css->add_property( + 'box-shadow', + $css->render_legacy_shadow( + $submit['boxShadowHover'], + [ + 'hOffset' => '2', + 'vOffset' => '2', + 'blur' => '3', + 'spread' => '0', + 'color' => '#000000', + 'opacity' => 0.4, + ] + ) + ); } if ( 'gradient' !== $bgtype ) { if ( isset( $submit['backgroundHover'] ) && ! empty( $submit['backgroundHover'] ) ) { @@ -460,7 +514,20 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $css->add_property( 'background', $css->render_color( $submit['backgroundHover'], $alpha ) ); } if ( isset( $submit['boxShadowHover'] ) && is_array( $submit['boxShadowHover'] ) && isset( $submit['boxShadowHover'][0] ) && true === $submit['boxShadowHover'][0] && isset( $submit['boxShadowHover'][7] ) && true === $submit['boxShadowHover'][7] ) { - $css->add_property( 'box-shadow', ( isset( $submit['boxShadowHover'][7] ) && true === $submit['boxShadowHover'][7] ? 'inset ' : '' ) . ( isset( $submit['boxShadowHover'][3] ) && is_numeric( $submit['boxShadowHover'][3] ) ? $submit['boxShadowHover'][3] : '2' ) . 'px ' . ( isset( $submit['boxShadowHover'][4] ) && is_numeric( $submit['boxShadowHover'][4] ) ? $submit['boxShadowHover'][4] : '2' ) . 'px ' . ( isset( $submit['boxShadowHover'][5] ) && is_numeric( $submit['boxShadowHover'][5] ) ? $submit['boxShadowHover'][5] : '3' ) . 'px ' . ( isset( $submit['boxShadowHover'][6] ) && is_numeric( $submit['boxShadowHover'][6] ) ? $submit['boxShadowHover'][6] : '0' ) . 'px ' . $css->render_color( ( isset( $submit['boxShadowHover'][1] ) && ! empty( $submit['boxShadowHover'][1] ) ? $submit['boxShadowHover'][1] : '#000000' ), ( isset( $submit['boxShadowHover'][2] ) && is_numeric( $submit['boxShadowHover'][2] ) ? $submit['boxShadowHover'][2] : 0.4 ) ) ); + $css->add_property( + 'box-shadow', + $css->render_legacy_shadow( + $submit['boxShadowHover'], + [ + 'hOffset' => '2', + 'vOffset' => '2', + 'blur' => '3', + 'spread' => '0', + 'color' => '#000000', + 'opacity' => 0.4, + ] + ) + ); } } @@ -479,7 +546,20 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $css->add_property( 'background', $css->render_color( $submit['backgroundHover'], $alpha ) ); } if ( isset( $submit['boxShadowHover'] ) && is_array( $submit['boxShadowHover'] ) && isset( $submit['boxShadowHover'][0] ) && true === $submit['boxShadowHover'][0] && isset( $submit['boxShadowHover'][7] ) && true === $submit['boxShadowHover'][7] ) { - $css->add_property( 'box-shadow', ( isset( $submit['boxShadowHover'][7] ) && true === $submit['boxShadowHover'][7] ? 'inset ' : '' ) . ( isset( $submit['boxShadowHover'][3] ) && is_numeric( $submit['boxShadowHover'][3] ) ? $submit['boxShadowHover'][3] : '2' ) . 'px ' . ( isset( $submit['boxShadowHover'][4] ) && is_numeric( $submit['boxShadowHover'][4] ) ? $submit['boxShadowHover'][4] : '2' ) . 'px ' . ( isset( $submit['boxShadowHover'][5] ) && is_numeric( $submit['boxShadowHover'][5] ) ? $submit['boxShadowHover'][5] : '3' ) . 'px ' . ( isset( $submit['boxShadowHover'][6] ) && is_numeric( $submit['boxShadowHover'][6] ) ? $submit['boxShadowHover'][6] : '0' ) . 'px ' . $css->render_color( ( isset( $submit['boxShadowHover'][1] ) && ! empty( $submit['boxShadowHover'][1] ) ? $submit['boxShadowHover'][1] : '#000000' ), ( isset( $submit['boxShadowHover'][2] ) && is_numeric( $submit['boxShadowHover'][2] ) ? $submit['boxShadowHover'][2] : 0.4 ) ) ); + $css->add_property( + 'box-shadow', + $css->render_legacy_shadow( + $submit['boxShadowHover'], + [ + 'hOffset' => '2', + 'vOffset' => '2', + 'blur' => '3', + 'spread' => '0', + 'color' => '#000000', + 'opacity' => 0.4, + ] + ) + ); if ( isset( $submit['borderRadius'] ) && is_numeric( $submit['borderRadius'] ) ) { $css->add_property( 'border-radius', $submit['borderRadius'] . 'px' ); } diff --git a/includes/blocks/class-kadence-blocks-image-block.php b/includes/blocks/class-kadence-blocks-image-block.php index d0ab512fcb..90723d29c0 100644 --- a/includes/blocks/class-kadence-blocks-image-block.php +++ b/includes/blocks/class-kadence-blocks-image-block.php @@ -52,10 +52,10 @@ public static function get_instance() { /** * Builds CSS for block. * - * @param array $attributes the blocks attributes. - * @param Kadence_Blocks_CSS $css the css class for blocks. - * @param string $unique_id the blocks attr ID. - * @param string $unique_style_id the blocks alternate ID for queries. + * @param array $attributes the blocks attributes. + * @param Kadence_Blocks_CSS $css the css class for blocks. + * @param string $unique_id the blocks attr ID. + * @param string $unique_style_id the blocks alternate ID for queries. */ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { @@ -230,13 +230,33 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { } } - // Box shadow - if ( isset( $attributes['displayBoxShadow'] ) && true == $attributes['displayBoxShadow'] ) { - if ( isset( $attributes['boxShadow'] ) && is_array( $attributes['boxShadow'] ) && isset( $attributes['boxShadow'][0] ) && is_array( $attributes['boxShadow'][0] ) ) { - $css->add_property( 'box-shadow', ( isset( $attributes['boxShadow'][0]['inset'] ) && true === $attributes['boxShadow'][0]['inset'] ? 'inset ' : '' ) . ( isset( $attributes['boxShadow'][0]['hOffset'] ) && is_numeric( $attributes['boxShadow'][0]['hOffset'] ) ? $attributes['boxShadow'][0]['hOffset'] : '0' ) . 'px ' . ( isset( $attributes['boxShadow'][0]['vOffset'] ) && is_numeric( $attributes['boxShadow'][0]['vOffset'] ) ? $attributes['boxShadow'][0]['vOffset'] : '0' ) . 'px ' . ( isset( $attributes['boxShadow'][0]['blur'] ) && is_numeric( $attributes['boxShadow'][0]['blur'] ) ? $attributes['boxShadow'][0]['blur'] : '14' ) . 'px ' . ( isset( $attributes['boxShadow'][0]['spread'] ) && is_numeric( $attributes['boxShadow'][0]['spread'] ) ? $attributes['boxShadow'][0]['spread'] : '0' ) . 'px ' . $css->render_color( ( isset( $attributes['boxShadow'][0]['color'] ) && ! empty( $attributes['boxShadow'][0]['color'] ) ? $attributes['boxShadow'][0]['color'] : '#000000' ), ( isset( $attributes['boxShadow'][0]['opacity'] ) && is_numeric( $attributes['boxShadow'][0]['opacity'] ) ? $attributes['boxShadow'][0]['opacity'] : 0.2 ) ) ); - } else { - $css->add_property( 'box-shadow', 'rgba(0, 0, 0, 0.2) 0px 0px 14px 0px' ); - } + // Box shadow, gated on BOTH the stored flag and the value's own axes. + // + // The flag is no longer a control -- the editor derives it from the value on every write -- but it + // still has to be read. Gutenberg omits an attribute equal to its default, and the old toggle + // defaulted to false, so a block saved with the shadow switched OFF stored no flag at all while + // keeping whatever values the user had entered. Judging by geometry alone would start rendering + // those, which is exactly the upgrade-time restyling the design-token work is meant to avoid. + if ( + ! empty( $attributes['displayBoxShadow'] ) + && isset( $attributes['boxShadow'][0] ) + && is_array( $attributes['boxShadow'][0] ) + && $this->has_visible_shadow( $attributes['boxShadow'][0] ) + ) { + $css->add_property( + 'box-shadow', + $css->render_shadow( + $attributes['boxShadow'][0], + [ + 'hOffset' => '0', + 'vOffset' => '0', + 'blur' => '14', + 'spread' => '0', + 'color' => '#000000', + 'opacity' => 0.2, + ] + ) + ); } // Drop Shadow diff --git a/includes/blocks/class-kadence-blocks-row-layout-block.php b/includes/blocks/class-kadence-blocks-row-layout-block.php index b2a4d5fdca..be91d055b4 100644 --- a/includes/blocks/class-kadence-blocks-row-layout-block.php +++ b/includes/blocks/class-kadence-blocks-row-layout-block.php @@ -5,6 +5,8 @@ * @package Kadence Blocks */ +// cspell:ignore alignnone arrowstyle blackonlight colorsecond colum crvi crvl crvli crvr crvri ctdi disablekb dotstyle generatepress littri littrii locsecond modestbranding mtns outlineblack outlinewhite overbg sltl sltli sltr sltri threelevels threelevelsi wavei wavesi . + // Exit if accessed directly. if ( ! defined( 'ABSPATH' ) ) { exit; @@ -86,7 +88,7 @@ public function render_scripts( $attributes, $inline = false ) { } /** - * Return a grid tempate coulmns string for custom column widths. + * Return a grid template columns string for custom column widths. * * @param object $css the css object. * @param int $columns the amount of columns. @@ -323,10 +325,10 @@ public function reset_grid_colum_for_template_columns( $css, $inner_selector ) { /** * Builds CSS for block. * - * @param array $attributes the blocks attributes. - * @param string $css the css class for blocks. - * @param string $unique_id the blocks attr ID. - * @param string $unique_style_id the blocks alternate ID for queries. + * @param array $attributes the blocks attributes. + * @param Kadence_Blocks_CSS $css the css object for blocks. + * @param string $unique_id the blocks attr ID. + * @param string $unique_style_id the blocks alternate ID for queries. */ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $css->set_style_id( 'kb-' . $this->block_name . $unique_style_id ); @@ -572,7 +574,7 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { //Tablet layout if ( empty( $attributes['tabletLayout'] ) && ! empty( $css->render_row_gap_property( $attributes, array( 'columnGutter', 'tabletGutter', 'mobileGutter' ), 'tablet', 'customGutter', 'gutterType' ) ) ) { - //no tablet layout, but we have a tablet guttter width, so render the inherited column layout from desktop, potentially with custom widths. + // no tablet layout, but we have a tablet gutter width, so render the inherited column layout from desktop, potentially with custom widths. $css->set_media_state( 'tablet' ); $css->set_selector( $inner_selector ); @@ -793,7 +795,20 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { // Box shadow if ( isset( $attributes['displayBoxShadow'] ) && true == $attributes['displayBoxShadow'] ) { if ( isset( $attributes['boxShadow'] ) && is_array( $attributes['boxShadow'] ) && isset( $attributes['boxShadow'][0] ) && is_array( $attributes['boxShadow'][0] ) ) { - $css->add_property( 'box-shadow', ( isset( $attributes['boxShadow'][0]['inset'] ) && true === $attributes['boxShadow'][0]['inset'] ? 'inset ' : '' ) . ( isset( $attributes['boxShadow'][0]['hOffset'] ) && is_numeric( $attributes['boxShadow'][0]['hOffset'] ) ? $attributes['boxShadow'][0]['hOffset'] : '0' ) . 'px ' . ( isset( $attributes['boxShadow'][0]['vOffset'] ) && is_numeric( $attributes['boxShadow'][0]['vOffset'] ) ? $attributes['boxShadow'][0]['vOffset'] : '0' ) . 'px ' . ( isset( $attributes['boxShadow'][0]['blur'] ) && is_numeric( $attributes['boxShadow'][0]['blur'] ) ? $attributes['boxShadow'][0]['blur'] : '14' ) . 'px ' . ( isset( $attributes['boxShadow'][0]['spread'] ) && is_numeric( $attributes['boxShadow'][0]['spread'] ) ? $attributes['boxShadow'][0]['spread'] : '0' ) . 'px ' . $css->render_color( ( isset( $attributes['boxShadow'][0]['color'] ) && ! empty( $attributes['boxShadow'][0]['color'] ) ? $attributes['boxShadow'][0]['color'] : '#000000' ), ( isset( $attributes['boxShadow'][0]['opacity'] ) && is_numeric( $attributes['boxShadow'][0]['opacity'] ) ? $attributes['boxShadow'][0]['opacity'] : 0.2 ) ) ); + $css->add_property( + 'box-shadow', + $css->render_shadow( + $attributes['boxShadow'][0], + [ + 'hOffset' => '0', + 'vOffset' => '0', + 'blur' => '14', + 'spread' => '0', + 'color' => '#000000', + 'opacity' => 0.2, + ] + ) + ); } else { $css->add_property( 'box-shadow', 'rgba(0, 0, 0, 0.2) 0px 0px 14px 0px' ); } @@ -1586,7 +1601,7 @@ public function get_video_render( $attributes ) { $src_base = 'youtube' == $background_video_type ? 'https://www.youtube.com/embed/' : 'https://player.vimeo.com/video/'; $video_id = 'youtube' == $background_video_type ? $video_attributes['youTube'] : $video_attributes['vimeo']; - // Vimeo and youtube share a bunch of params, that's convienent. + // Vimeo and youtube share a bunch of params, that's convenient. $src_query_string = '?' . http_build_query( array( 'autoplay' => 1, diff --git a/includes/blocks/class-kadence-blocks-single-icon-block.php b/includes/blocks/class-kadence-blocks-single-icon-block.php index 3ce3728a9c..cc49cf4898 100644 --- a/includes/blocks/class-kadence-blocks-single-icon-block.php +++ b/includes/blocks/class-kadence-blocks-single-icon-block.php @@ -61,11 +61,6 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $css->set_selector( '.kt-svg-item-' . $unique_id . ' .kb-svg-icon-wrap, .kt-svg-style-stacked.kt-svg-item-' . $unique_id . ' .kb-svg-icon-wrap' ); $css->render_color_output( $attributes, 'color', 'color' ); - // Match icon default size if not set. - if ( ! isset( $attributes['size'] ) ) { - $attributes['size'] = 50; - } - $css->render_responsive_size( $attributes, array( diff --git a/includes/blocks/class-kadence-blocks-singlebtn-block.php b/includes/blocks/class-kadence-blocks-singlebtn-block.php index a7b5f79e15..2ea52640d6 100644 --- a/includes/blocks/class-kadence-blocks-singlebtn-block.php +++ b/includes/blocks/class-kadence-blocks-singlebtn-block.php @@ -5,17 +5,25 @@ * @package Kadence Blocks */ +// cspell:ignore glight glightbox ktblocksvideopop plyr . + // Exit if accessed directly. if ( ! defined( 'ABSPATH' ) ) { exit; } +use KadenceWP\KadenceBlocks\Design_Tokens\Database\Active_Token_Library_Store; +use KadenceWP\KadenceBlocks\Design_Tokens\Registry\Token_Registry; +use KadenceWP\KadenceBlocks\Design_Tokens\Resolver\Preset_Resolver; +use KadenceWP\KadenceBlocks\Utils\Cast; + /** * Class to Build the Single Button. * * @category class */ class Kadence_Blocks_Singlebtn_Block extends Kadence_Blocks_Abstract_Block { + /** * Instance of this class * @@ -75,10 +83,10 @@ public function render_scripts( $attributes, $inline = false ) { /** * Builds CSS for block. * - * @param array $attributes the blocks attributes. - * @param string $css the css class for blocks. - * @param string $unique_id the blocks attr ID. - * @param string $unique_style_id the blocks alternate ID for queries. + * @param array $attributes the blocks attributes. + * @param Kadence_Blocks_CSS $css the css object for blocks. + * @param string $unique_id the blocks attr ID. + * @param string $unique_style_id the blocks alternate ID for queries. */ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $css->set_style_id( 'kb-' . $this->block_name . $unique_style_id ); @@ -97,7 +105,7 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $css->set_selector( 'ul.menu .wp-block-kadence-advancedbtn .kb-btn' . $unique_id . '.kb-button' ); $css->add_property( 'width', 'initial' ); } - // standard styles + // Standard styles. $css->set_selector( '.wp-block-kadence-advancedbtn .kb-btn' . $unique_id . '.kb-button' ); $bg_type = ! empty( $attributes['backgroundType'] ) ? $attributes['backgroundType'] : 'normal'; $bg_hover_type = ! empty( $attributes['backgroundHoverType'] ) ? $attributes['backgroundHoverType'] : 'normal'; @@ -119,15 +127,18 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { } $css->render_typography( $attributes, 'typography' ); $css->render_measure_output( $attributes, 'borderRadius', 'border-radius', [ 'unit_key' => 'borderRadiusUnit' ] ); + $this->render_preset_border( $css, $attributes ); $css->render_border_styles( $attributes, 'borderStyle', true ); + $this->render_preset_spacing( $css, $attributes ); $css->render_measure_output( $attributes, 'padding', 'padding', [ 'unit_key' => 'paddingUnit' ] ); $css->render_measure_output( $attributes, 'margin', 'margin', [ 'unit_key' => 'marginUnit' ] ); - if ( isset( $attributes['displayShadow'] ) && true === $attributes['displayShadow'] ) { - if ( isset( $attributes['shadow'] ) && is_array( $attributes['shadow'] ) && isset( $attributes['shadow'][0] ) && is_array( $attributes['shadow'][0] ) ) { - $css->add_property( 'box-shadow', ( isset( $attributes['shadow'][0]['inset'] ) && true === $attributes['shadow'][0]['inset'] ? 'inset ' : '' ) . ( isset( $attributes['shadow'][0]['hOffset'] ) && is_numeric( $attributes['shadow'][0]['hOffset'] ) ? $attributes['shadow'][0]['hOffset'] : '0' ) . 'px ' . ( isset( $attributes['shadow'][0]['vOffset'] ) && is_numeric( $attributes['shadow'][0]['vOffset'] ) ? $attributes['shadow'][0]['vOffset'] : '0' ) . 'px ' . ( isset( $attributes['shadow'][0]['blur'] ) && is_numeric( $attributes['shadow'][0]['blur'] ) ? $attributes['shadow'][0]['blur'] : '14' ) . 'px ' . ( isset( $attributes['shadow'][0]['spread'] ) && is_numeric( $attributes['shadow'][0]['spread'] ) ? $attributes['shadow'][0]['spread'] : '0' ) . 'px ' . $css->render_color( ( isset( $attributes['shadow'][0]['color'] ) && ! empty( $attributes['shadow'][0]['color'] ) ? $attributes['shadow'][0]['color'] : '#000000' ), ( isset( $attributes['shadow'][0]['opacity'] ) && is_numeric( $attributes['shadow'][0]['opacity'] ) ? $attributes['shadow'][0]['opacity'] : 0.2 ) ) ); - } else { - $css->add_property( 'box-shadow', '1px 1px 2px 0px rgba(0, 0, 0, 0.2)' ); - } + $has_preset_shadow = $this->render_preset_shadow( $css, $attributes ); + if ( ! empty( $attributes['displayShadow'] ) && isset( $attributes['shadow'][0] ) && is_array( $attributes['shadow'][0] ) && $this->has_visible_shadow( $attributes['shadow'][0] ) ) { + $css->add_property( 'box-shadow', $this->render_button_shadow( $css, $attributes['shadow'][0] ) ); + } elseif ( ! $has_preset_shadow ) { + // Only reset to `none` when nothing else claims this rule's box-shadow — a preset's + // `var(--kb-btn-shadow)` above would otherwise be silenced by a trailing `none`. + $css->add_property( 'box-shadow', 'none' ); } if ( ! empty( $attributes['textUnderline'] ) ) { $css->set_selector( '.wp-block-kadence-advancedbtn .kb-btn' . $unique_id . '.kb-button:not(.specificity):not(.extra-specificity)' ); @@ -163,16 +174,16 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { } $css->render_measure_output( $attributes, 'borderHoverRadius', 'border-radius' ); $css->render_border_styles( $attributes, 'borderHoverStyle', true ); - if ( isset( $attributes['displayHoverShadow'] ) && true === $attributes['displayHoverShadow'] ) { - if ( ( 'gradient' === $bg_type || 'gradient' === $bg_hover_type ) && isset( $attributes['shadowHover'][0]['inset'] ) && true === $attributes['shadowHover'][0]['inset'] ) { - $css->add_property( 'box-shadow', '0px 0px 0px 0px rgba(0, 0, 0, 0)' ); - $css->set_selector( '.kb-btn' . $unique_id . '.kb-button:hover::before' ); - } - if ( isset( $attributes['shadowHover'] ) && is_array( $attributes['shadowHover'] ) && isset( $attributes['shadowHover'][0] ) && is_array( $attributes['shadowHover'][0] ) ) { - $css->add_property( 'box-shadow', ( isset( $attributes['shadowHover'][0]['inset'] ) && true === $attributes['shadowHover'][0]['inset'] ? 'inset ' : '' ) . ( isset( $attributes['shadowHover'][0]['hOffset'] ) && is_numeric( $attributes['shadowHover'][0]['hOffset'] ) ? $attributes['shadowHover'][0]['hOffset'] : '0' ) . 'px ' . ( isset( $attributes['shadowHover'][0]['vOffset'] ) && is_numeric( $attributes['shadowHover'][0]['vOffset'] ) ? $attributes['shadowHover'][0]['vOffset'] : '0' ) . 'px ' . ( isset( $attributes['shadowHover'][0]['blur'] ) && is_numeric( $attributes['shadowHover'][0]['blur'] ) ? $attributes['shadowHover'][0]['blur'] : '14' ) . 'px ' . ( isset( $attributes['shadowHover'][0]['spread'] ) && is_numeric( $attributes['shadowHover'][0]['spread'] ) ? $attributes['shadowHover'][0]['spread'] : '0' ) . 'px ' . $css->render_color( ( isset( $attributes['shadowHover'][0]['color'] ) && ! empty( $attributes['shadowHover'][0]['color'] ) ? $attributes['shadowHover'][0]['color'] : '#000000' ), ( isset( $attributes['shadowHover'][0]['opacity'] ) && is_numeric( $attributes['shadowHover'][0]['opacity'] ) ? $attributes['shadowHover'][0]['opacity'] : 0.2 ) ) ); - } else { - $css->add_property( 'box-shadow', '2px 2px 3px 0px rgba(0, 0, 0, 0.4)' ); - } + // Visibility-gated: without it this fires on any inset-true item, including the invisible + // all-zero default the block ships with. + if ( ! empty( $attributes['displayHoverShadow'] ) && ( 'gradient' === $bg_type || 'gradient' === $bg_hover_type ) && isset( $attributes['shadowHover'][0] ) && is_array( $attributes['shadowHover'][0] ) && $this->has_visible_shadow( $attributes['shadowHover'][0] ) && isset( $attributes['shadowHover'][0]['inset'] ) && true === $attributes['shadowHover'][0]['inset'] ) { + $css->add_property( 'box-shadow', '0px 0px 0px 0px rgba(0, 0, 0, 0)' ); + $css->set_selector( '.kb-btn' . $unique_id . '.kb-button:hover::before' ); + } + // No `none` fallback on hover: an unset hover shadow must let the base state's shadow + // carry through the `:hover` rule via the normal cascade. + if ( ! empty( $attributes['displayHoverShadow'] ) && isset( $attributes['shadowHover'][0] ) && is_array( $attributes['shadowHover'][0] ) && $this->has_visible_shadow( $attributes['shadowHover'][0] ) ) { + $css->add_property( 'box-shadow', $this->render_button_shadow( $css, $attributes['shadowHover'][0] ) ); } // Hover before. if ( 'gradient' === $bg_type && 'normal' === $bg_hover_type && ! empty( $attributes['backgroundHover'] ) ) { @@ -226,12 +237,15 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { return $css->css_output(); } - /** * Build up the dynamic styles for a size. * - * @param string $size The size. - * @return array + * @param Kadence_Blocks_CSS $css The CSS builder instance. + * @param array $attributes The block attributes. + * @param string $unique_id The block's unique id. + * @param string $size The responsive size. + * + * @return void */ public function sized_dynamic_styles( $css, $attributes, $unique_id, $size = 'Desktop' ) { $sized_attributes = $css->get_sized_attributes_auto( $attributes, $size, false ); @@ -239,104 +253,96 @@ public function sized_dynamic_styles( $css, $attributes, $unique_id, $size = 'De $css->set_media_state( strtolower( $size ) ); - // standard transparent styles + // Standard transparent styles. $css->set_selector( '.header-' . strtolower( $size ) . '-transparent .wp-block-kadence-advancedbtn .kb-btn' . $unique_id . '.kb-button' ); $bg_type_transparent = ! empty( $attributes['backgroundTransparentType'] ) ? $attributes['backgroundTransparentType'] : 'normal'; $bg_hover_type_transparent = ! empty( $attributes['backgroundTransparentHoverType'] ) ? $attributes['backgroundTransparentHoverType'] : 'normal'; if ( ! empty( $attributes['colorTransparent'] ) ) { - $css->add_property( 'color', $css->render_color( $attributes['colorTransparent'] ) ); + $css->add_property( 'color', $css->render_color( Cast::to_string( $attributes['colorTransparent'] ) ) ); } if ( 'normal' === $bg_type_transparent && ! empty( $attributes['backgroundTransparent'] ) ) { - $css->add_property( 'background', $css->render_color( $attributes['backgroundTransparent'] ) . ( 'gradient' === $bg_hover_type_transparent ? ' !important' : '' ) ); + $css->add_property( 'background', $css->render_color( Cast::to_string( $attributes['backgroundTransparent'] ) ) . ( 'gradient' === $bg_hover_type_transparent ? ' !important' : '' ) ); } if ( 'gradient' === $bg_type_transparent && ! empty( $attributes['gradientTransparent'] ) ) { $css->add_property( 'background', $attributes['gradientTransparent'] . ' !important' ); } $css->render_measure_output( $attributes, 'borderTransparentRadius', 'border-radius', [ 'unit_key' => 'borderTransparentRadiusUnit' ] ); $css->render_border_styles( $attributes, 'borderTransparentStyle', true ); - if ( isset( $attributes['displayShadowTransparent'] ) && true === $attributes['displayShadowTransparent'] ) { - if ( isset( $attributes['shadowTransparent'] ) && is_array( $attributes['shadowTransparent'] ) && isset( $attributes['shadowTransparent'][0] ) && is_array( $attributes['shadowTransparent'][0] ) ) { - $css->add_property( 'box-shadow', ( isset( $attributes['shadowTransparent'][0]['inset'] ) && true === $attributes['shadowTransparent'][0]['inset'] ? 'inset ' : '' ) . ( isset( $attributes['shadowTransparent'][0]['hOffset'] ) && is_numeric( $attributes['shadowTransparent'][0]['hOffset'] ) ? $attributes['shadowTransparent'][0]['hOffset'] : '0' ) . 'px ' . ( isset( $attributes['shadowTransparent'][0]['vOffset'] ) && is_numeric( $attributes['shadowTransparent'][0]['vOffset'] ) ? $attributes['shadowTransparent'][0]['vOffset'] : '0' ) . 'px ' . ( isset( $attributes['shadowTransparent'][0]['blur'] ) && is_numeric( $attributes['shadowTransparent'][0]['blur'] ) ? $attributes['shadowTransparent'][0]['blur'] : '14' ) . 'px ' . ( isset( $attributes['shadowTransparent'][0]['spread'] ) && is_numeric( $attributes['shadowTransparent'][0]['spread'] ) ? $attributes['shadowTransparent'][0]['spread'] : '0' ) . 'px ' . $css->render_color( ( isset( $attributes['shadowTransparent'][0]['color'] ) && ! empty( $attributes['shadowTransparent'][0]['color'] ) ? $attributes['shadowTransparent'][0]['color'] : '#000000' ), ( isset( $attributes['shadowTransparent'][0]['opacity'] ) && is_numeric( $attributes['shadowTransparent'][0]['opacity'] ) ? $attributes['shadowTransparent'][0]['opacity'] : 0.2 ) ) ); - } else { - $css->add_property( 'box-shadow', '1px 1px 2px 0px rgba(0, 0, 0, 0.2)' ); - } + // No `none` fallback: this selector outranks the base rule, which must carry through instead. + if ( ! empty( $attributes['displayShadowTransparent'] ) && isset( $attributes['shadowTransparent'] ) && is_array( $attributes['shadowTransparent'] ) && isset( $attributes['shadowTransparent'][0] ) && is_array( $attributes['shadowTransparent'][0] ) && $this->has_visible_shadow( $attributes['shadowTransparent'][0] ) ) { + $css->add_property( 'box-shadow', $this->render_button_shadow( $css, $attributes['shadowTransparent'][0] ) ); } - // hover transparent styles + // Hover transparent styles. $css->set_selector( '.header-' . strtolower( $size ) . '-transparent .wp-block-kadence-advancedbtn .kb-btn' . $unique_id . '.kb-button:hover' ); if ( ! empty( $attributes['colorTransparentHover'] ) ) { - $css->add_property( 'color', $css->render_color( $attributes['colorTransparentHover'] ) ); + $css->add_property( 'color', $css->render_color( Cast::to_string( $attributes['colorTransparentHover'] ) ) ); } if ( 'gradient' !== $bg_type_transparent && 'normal' === $bg_hover_type_transparent && ! empty( $attributes['backgroundTransparentHover'] ) ) { - $css->add_property( 'background', $css->render_color( $attributes['backgroundTransparentHover'] ) ); + $css->add_property( 'background', $css->render_color( Cast::to_string( $attributes['backgroundTransparentHover'] ) ) ); } $css->render_measure_output( $attributes, 'borderTransparentHoverRadius', 'border-radius' ); $css->render_border_styles( $attributes, 'borderTransparentHoverStyle', true ); - if ( isset( $attributes['displayHoverShadowTransparent'] ) && true === $attributes['displayHoverShadowTransparent'] ) { - if ( ( 'gradient' === $bg_type_transparent || 'gradient' === $bg_hover_type_transparent ) && isset( $attributes['shadowTransparentHover'][0]['inset'] ) && true === $attributes['shadowTransparentHover'][0]['inset'] ) { - $css->add_property( 'box-shadow', '0px 0px 0px 0px rgba(0, 0, 0, 0)' ); - $css->set_selector( '.kb-btn' . $unique_id . '.kb-button:hover::before' ); - } - if ( isset( $attributes['shadowTransparentHover'] ) && is_array( $attributes['shadowTransparentHover'] ) && isset( $attributes['shadowTransparentHover'][0] ) && is_array( $attributes['shadowTransparentHover'][0] ) ) { - $css->add_property( 'box-shadow', ( isset( $attributes['shadowTransparentHover'][0]['inset'] ) && true === $attributes['shadowTransparentHover'][0]['inset'] ? 'inset ' : '' ) . ( isset( $attributes['shadowTransparentHover'][0]['hOffset'] ) && is_numeric( $attributes['shadowTransparentHover'][0]['hOffset'] ) ? $attributes['shadowTransparentHover'][0]['hOffset'] : '0' ) . 'px ' . ( isset( $attributes['shadowTransparentHover'][0]['vOffset'] ) && is_numeric( $attributes['shadowTransparentHover'][0]['vOffset'] ) ? $attributes['shadowTransparentHover'][0]['vOffset'] : '0' ) . 'px ' . ( isset( $attributes['shadowTransparentHover'][0]['blur'] ) && is_numeric( $attributes['shadowTransparentHover'][0]['blur'] ) ? $attributes['shadowTransparentHover'][0]['blur'] : '14' ) . 'px ' . ( isset( $attributes['shadowTransparentHover'][0]['spread'] ) && is_numeric( $attributes['shadowTransparentHover'][0]['spread'] ) ? $attributes['shadowTransparentHover'][0]['spread'] : '0' ) . 'px ' . $css->render_color( ( isset( $attributes['shadowTransparentHover'][0]['color'] ) && ! empty( $attributes['shadowTransparentHover'][0]['color'] ) ? $attributes['shadowTransparentHover'][0]['color'] : '#000000' ), ( isset( $attributes['shadowTransparentHover'][0]['opacity'] ) && is_numeric( $attributes['shadowTransparentHover'][0]['opacity'] ) ? $attributes['shadowTransparentHover'][0]['opacity'] : 0.2 ) ) ); - } else { - $css->add_property( 'box-shadow', '2px 2px 3px 0px rgba(0, 0, 0, 0.4)' ); - } + // See the base hover state above: this reset needs the same visibility gate. + if ( ! empty( $attributes['displayHoverShadowTransparent'] ) && ( 'gradient' === $bg_type_transparent || 'gradient' === $bg_hover_type_transparent ) && isset( $attributes['shadowTransparentHover'] ) && is_array( $attributes['shadowTransparentHover'] ) && isset( $attributes['shadowTransparentHover'][0] ) && is_array( $attributes['shadowTransparentHover'][0] ) && $this->has_visible_shadow( $attributes['shadowTransparentHover'][0] ) && isset( $attributes['shadowTransparentHover'][0]['inset'] ) && true === $attributes['shadowTransparentHover'][0]['inset'] ) { + $css->add_property( 'box-shadow', '0px 0px 0px 0px rgba(0, 0, 0, 0)' ); + $css->set_selector( '.kb-btn' . $unique_id . '.kb-button:hover::before' ); + } + // No `none` fallback on hover: an unset hover shadow must let the base state's shadow + // carry through the `:hover` rule via the normal cascade. + if ( ! empty( $attributes['displayHoverShadowTransparent'] ) && isset( $attributes['shadowTransparentHover'] ) && is_array( $attributes['shadowTransparentHover'] ) && isset( $attributes['shadowTransparentHover'][0] ) && is_array( $attributes['shadowTransparentHover'][0] ) && $this->has_visible_shadow( $attributes['shadowTransparentHover'][0] ) ) { + $css->add_property( 'box-shadow', $this->render_button_shadow( $css, $attributes['shadowTransparentHover'][0] ) ); } - // standard sticky styles + // Standard sticky styles. $css->set_selector( '.item-is-stuck .wp-block-kadence-advancedbtn .kb-btn' . $unique_id . '.kb-button' ); $bg_type_sticky = ! empty( $attributes['backgroundStickyType'] ) ? $attributes['backgroundStickyType'] : 'normal'; $bg_hover_type_sticky = ! empty( $attributes['backgroundStickyHoverType'] ) ? $attributes['backgroundStickyHoverType'] : 'normal'; if ( ! empty( $attributes['colorSticky'] ) ) { - $css->add_property( 'color', $css->render_color( $attributes['colorSticky'] ) ); + $css->add_property( 'color', $css->render_color( Cast::to_string( $attributes['colorSticky'] ) ) ); } if ( 'normal' === $bg_type_sticky && ! empty( $attributes['backgroundSticky'] ) ) { - $css->add_property( 'background', $css->render_color( $attributes['backgroundSticky'] ) . ( 'gradient' === $bg_hover_type_sticky ? ' !important' : '' ) ); + $css->add_property( 'background', $css->render_color( Cast::to_string( $attributes['backgroundSticky'] ) ) . ( 'gradient' === $bg_hover_type_sticky ? ' !important' : '' ) ); } if ( 'gradient' === $bg_type_sticky && ! empty( $attributes['gradientSticky'] ) ) { $css->add_property( 'background', $attributes['gradientSticky'] . ' !important' ); } $css->render_measure_output( $attributes, 'borderStickyRadius', 'border-radius', [ 'unit_key' => 'borderStickyRadiusUnit' ] ); $css->render_border_styles( $attributes, 'borderStickyStyle', true ); - if ( isset( $attributes['displayShadowSticky'] ) && true === $attributes['displayShadowSticky'] ) { - if ( isset( $attributes['shadowSticky'] ) && is_array( $attributes['shadowSticky'] ) && isset( $attributes['shadowSticky'][0] ) && is_array( $attributes['shadowSticky'][0] ) ) { - $css->add_property( 'box-shadow', ( isset( $attributes['shadowSticky'][0]['inset'] ) && true === $attributes['shadowSticky'][0]['inset'] ? 'inset ' : '' ) . ( isset( $attributes['shadowSticky'][0]['hOffset'] ) && is_numeric( $attributes['shadowSticky'][0]['hOffset'] ) ? $attributes['shadowSticky'][0]['hOffset'] : '0' ) . 'px ' . ( isset( $attributes['shadowSticky'][0]['vOffset'] ) && is_numeric( $attributes['shadowSticky'][0]['vOffset'] ) ? $attributes['shadowSticky'][0]['vOffset'] : '0' ) . 'px ' . ( isset( $attributes['shadowSticky'][0]['blur'] ) && is_numeric( $attributes['shadowSticky'][0]['blur'] ) ? $attributes['shadowSticky'][0]['blur'] : '14' ) . 'px ' . ( isset( $attributes['shadowSticky'][0]['spread'] ) && is_numeric( $attributes['shadowSticky'][0]['spread'] ) ? $attributes['shadowSticky'][0]['spread'] : '0' ) . 'px ' . $css->render_color( ( isset( $attributes['shadowSticky'][0]['color'] ) && ! empty( $attributes['shadowSticky'][0]['color'] ) ? $attributes['shadowSticky'][0]['color'] : '#000000' ), ( isset( $attributes['shadowSticky'][0]['opacity'] ) && is_numeric( $attributes['shadowSticky'][0]['opacity'] ) ? $attributes['shadowSticky'][0]['opacity'] : 0.2 ) ) ); - } else { - $css->add_property( 'box-shadow', '1px 1px 2px 0px rgba(0, 0, 0, 0.2)' ); - } + // No `none` fallback: this selector outranks the base rule, which must carry through instead. + if ( ! empty( $attributes['displayShadowSticky'] ) && isset( $attributes['shadowSticky'] ) && is_array( $attributes['shadowSticky'] ) && isset( $attributes['shadowSticky'][0] ) && is_array( $attributes['shadowSticky'][0] ) && $this->has_visible_shadow( $attributes['shadowSticky'][0] ) ) { + $css->add_property( 'box-shadow', $this->render_button_shadow( $css, $attributes['shadowSticky'][0] ) ); } - // hover sticky styles + // Hover sticky styles. $css->set_selector( '.item-is-stuck .wp-block-kadence-advancedbtn .kb-btn' . $unique_id . '.kb-button:hover' ); if ( ! empty( $attributes['colorStickyHover'] ) ) { - $css->add_property( 'color', $css->render_color( $attributes['colorStickyHover'] ) ); + $css->add_property( 'color', $css->render_color( Cast::to_string( $attributes['colorStickyHover'] ) ) ); } if ( 'gradient' !== $bg_type_sticky && 'normal' === $bg_hover_type_sticky && ! empty( $attributes['backgroundStickyHover'] ) ) { - $css->add_property( 'background', $css->render_color( $attributes['backgroundStickyHover'] ) ); + $css->add_property( 'background', $css->render_color( Cast::to_string( $attributes['backgroundStickyHover'] ) ) ); } $css->render_measure_output( $attributes, 'borderStickyHoverRadius', 'border-radius' ); $css->render_border_styles( $attributes, 'borderStickyHoverStyle', true ); - if ( isset( $attributes['displayHoverShadowSticky'] ) && true === $attributes['displayHoverShadowSticky'] ) { - if ( ( 'gradient' === $bg_type_sticky || 'gradient' === $bg_hover_type_sticky ) && isset( $attributes['shadowStickyHover'][0]['inset'] ) && true === $attributes['shadowStickyHover'][0]['inset'] ) { - $css->add_property( 'box-shadow', '0px 0px 0px 0px rgba(0, 0, 0, 0)' ); - $css->set_selector( '.kb-btn' . $unique_id . '.kb-button:hover::before' ); - } - if ( isset( $attributes['shadowStickyHover'] ) && is_array( $attributes['shadowStickyHover'] ) && isset( $attributes['shadowStickyHover'][0] ) && is_array( $attributes['shadowStickyHover'][0] ) ) { - $css->add_property( 'box-shadow', ( isset( $attributes['shadowStickyHover'][0]['inset'] ) && true === $attributes['shadowStickyHover'][0]['inset'] ? 'inset ' : '' ) . ( isset( $attributes['shadowStickyHover'][0]['hOffset'] ) && is_numeric( $attributes['shadowStickyHover'][0]['hOffset'] ) ? $attributes['shadowStickyHover'][0]['hOffset'] : '0' ) . 'px ' . ( isset( $attributes['shadowStickyHover'][0]['vOffset'] ) && is_numeric( $attributes['shadowStickyHover'][0]['vOffset'] ) ? $attributes['shadowStickyHover'][0]['vOffset'] : '0' ) . 'px ' . ( isset( $attributes['shadowStickyHover'][0]['blur'] ) && is_numeric( $attributes['shadowStickyHover'][0]['blur'] ) ? $attributes['shadowStickyHover'][0]['blur'] : '14' ) . 'px ' . ( isset( $attributes['shadowStickyHover'][0]['spread'] ) && is_numeric( $attributes['shadowStickyHover'][0]['spread'] ) ? $attributes['shadowStickyHover'][0]['spread'] : '0' ) . 'px ' . $css->render_color( ( isset( $attributes['shadowStickyHover'][0]['color'] ) && ! empty( $attributes['shadowStickyHover'][0]['color'] ) ? $attributes['shadowStickyHover'][0]['color'] : '#000000' ), ( isset( $attributes['shadowStickyHover'][0]['opacity'] ) && is_numeric( $attributes['shadowStickyHover'][0]['opacity'] ) ? $attributes['shadowStickyHover'][0]['opacity'] : 0.2 ) ) ); - } else { - $css->add_property( 'box-shadow', '2px 2px 3px 0px rgba(0, 0, 0, 0.4)' ); - } + // See the base hover state above: this reset needs the same visibility gate. + if ( ! empty( $attributes['displayHoverShadowSticky'] ) && ( 'gradient' === $bg_type_sticky || 'gradient' === $bg_hover_type_sticky ) && isset( $attributes['shadowStickyHover'] ) && is_array( $attributes['shadowStickyHover'] ) && isset( $attributes['shadowStickyHover'][0] ) && is_array( $attributes['shadowStickyHover'][0] ) && $this->has_visible_shadow( $attributes['shadowStickyHover'][0] ) && isset( $attributes['shadowStickyHover'][0]['inset'] ) && true === $attributes['shadowStickyHover'][0]['inset'] ) { + $css->add_property( 'box-shadow', '0px 0px 0px 0px rgba(0, 0, 0, 0)' ); + $css->set_selector( '.kb-btn' . $unique_id . '.kb-button:hover::before' ); + } + // No `none` fallback on hover: an unset hover shadow must let the base state's shadow + // carry through the `:hover` rule via the normal cascade. + if ( ! empty( $attributes['displayHoverShadowSticky'] ) && isset( $attributes['shadowStickyHover'] ) && is_array( $attributes['shadowStickyHover'] ) && isset( $attributes['shadowStickyHover'][0] ) && is_array( $attributes['shadowStickyHover'][0] ) && $this->has_visible_shadow( $attributes['shadowStickyHover'][0] ) ) { + $css->add_property( 'box-shadow', $this->render_button_shadow( $css, $attributes['shadowStickyHover'][0] ) ); } } /** * Build HTML for dynamic blocks * - * @param $attributes - * @param $unique_id - * @param $content - * @param WP_Block $block_instance The instance of the WP_Block class that represents the block being rendered. + * @param array $attributes The block attributes. + * @param string $unique_id The block's unique id. + * @param string $content The block inner content. + * @param WP_Block $block_instance The instance of the WP_Block class that represents the block being rendered. * * @return mixed */ @@ -345,12 +351,12 @@ public function build_html( $attributes, $unique_id, $content, $block_instance ) $this->enqueue_script( 'kadence-blocks-tippy' ); } - $inheritClassSuffix = ! empty( $attributes['inheritStyles'] ) && 'inherit-secondary' === $attributes['inheritStyles'] ? 'inherit' : $attributes['inheritStyles']; + $inherit_class_suffix = ! empty( $attributes['inheritStyles'] ) && 'inherit-secondary' === $attributes['inheritStyles'] ? 'inherit' : $attributes['inheritStyles']; $classes = [ 'kb-button', 'kt-button', 'button', 'kb-btn' . $unique_id ]; $classes[] = ! empty( $attributes['sizePreset'] ) ? 'kt-btn-size-' . $attributes['sizePreset'] : 'kt-btn-size-standard'; $classes[] = ! empty( $attributes['widthType'] ) ? 'kt-btn-width-type-' . $attributes['widthType'] : 'kt-btn-width-type-auto'; - $classes[] = ! empty( $attributes['inheritStyles'] ) ? 'kb-btn-global-' . $inheritClassSuffix : 'kb-btn-global-fill'; + $classes[] = ! empty( $attributes['inheritStyles'] ) ? 'kb-btn-global-' . $inherit_class_suffix : 'kb-btn-global-fill'; $classes[] = ! empty( $attributes['inheritStyles'] ) && 'inherit-secondary' === $attributes['inheritStyles'] ? 'button-style-secondary' : ''; $classes[] = ! empty( $attributes['text'] ) ? 'kt-btn-has-text-true' : 'kt-btn-has-text-false'; $classes[] = ! empty( $attributes['icon'] ) ? 'kt-btn-has-svg-true' : 'kt-btn-has-svg-false'; @@ -359,20 +365,18 @@ public function build_html( $attributes, $unique_id, $content, $block_instance ) if ( ! empty( $attributes['target'] ) && 'video' === $attributes['target'] ) { $classes[] = 'ktblocksvideopop'; } - if ( ! empty( $attributes['inheritStyles'] ) && ('inherit' === $attributes['inheritStyles'] || 'inherit-secondary' === $attributes['inheritStyles']) ) { + if ( ! empty( $attributes['inheritStyles'] ) && ( 'inherit' === $attributes['inheritStyles'] || 'inherit-secondary' === $attributes['inheritStyles'] ) ) { $classes[] = 'wp-block-button__link'; } - $wrapper_args = [ - 'class' => implode( ' ', $classes ), - ]; + $wrapper_args = [ 'class' => implode( ' ', $classes ) ]; if ( ! empty( $attributes['anchor'] ) ) { - $wrapper_args['id'] = $attributes['anchor']; + $wrapper_args['id'] = Cast::to_string( $attributes['anchor'] ); } if ( ! empty( $attributes['label'] ) ) { - $wrapper_args['aria-label'] = $attributes['label']; + $wrapper_args['aria-label'] = Cast::to_string( $attributes['label'] ); } if ( ! empty( $attributes['link'] ) ) { - $wrapper_args['href'] = esc_url( do_shortcode( $attributes['link'] ) ); + $wrapper_args['href'] = esc_url( do_shortcode( Cast::to_string( $attributes['link'] ) ) ); $rel_add = ''; if ( isset( $attributes['download'] ) && $attributes['download'] ) { $wrapper_args['download'] = ''; @@ -395,9 +399,9 @@ public function build_html( $attributes, $unique_id, $content, $block_instance ) $wrapper_args['type'] = 'submit'; } if ( ! empty( $attributes['tooltip'] ) ) { - $wrapper_args['data-kb-tooltip-content'] = esc_attr( $attributes['tooltip'] ); + $wrapper_args['data-kb-tooltip-content'] = esc_attr( Cast::to_string( $attributes['tooltip'] ) ); if ( ! empty( $attributes['tooltipPlacement'] ) ) { - $wrapper_args['data-tooltip-placement'] = esc_attr( $attributes['tooltipPlacement'] ); + $wrapper_args['data-tooltip-placement'] = esc_attr( Cast::to_string( $attributes['tooltipPlacement'] ) ); } } if ( isset( $attributes['buttonRole'] ) && $attributes['buttonRole'] ) { @@ -414,7 +418,7 @@ public function build_html( $attributes, $unique_id, $content, $block_instance ) $text = ! empty( $attributes['text'] ) ? '' . $attributes['text'] . '' : ''; $svg_icon = ''; if ( ! empty( $attributes['icon'] ) ) { - $type = substr( $attributes['icon'], 0, 2 ); + $type = substr( Cast::to_string( $attributes['icon'] ), 0, 2 ); $line_icon = ( ! empty( $type ) && 'fe' == $type ? true : false ); $fill = ( $line_icon ? 'none' : 'currentColor' ); $stroke_width = false; @@ -426,12 +430,12 @@ public function build_html( $attributes, $unique_id, $content, $block_instance ) $hidden = ( empty( $title ) ? true : false ); $svg_icon = Kadence_Blocks_Svg_Render::render( $attributes['icon'], $fill, $stroke_width, $title, $hidden ); } - $icon_left = ! empty( $svg_icon ) && ! empty( $attributes['iconSide'] ) && 'left' === $attributes['iconSide'] ? '' . $svg_icon . '' : ''; - $icon_right = ! empty( $svg_icon ) && ! empty( $attributes['iconSide'] ) && 'right' === $attributes['iconSide'] ? '' . $svg_icon . '' : ''; + $icon_left = ! empty( $svg_icon ) && ! empty( $attributes['iconSide'] ) && 'left' === $attributes['iconSide'] ? '' . $svg_icon . '' : ''; + $icon_right = ! empty( $svg_icon ) && ! empty( $attributes['iconSide'] ) && 'right' === $attributes['iconSide'] ? '' . $svg_icon . '' : ''; $html_tag = ! empty( $attributes['link'] ) ? 'a' : 'span'; // Try to Detect if this is a show more button and make it a button. - if ( isset( $attributes['lock'] ) && $attributes['lock'] && isset( $attributes['lock']['remove'] ) && $attributes['lock']['remove'] && isset( $attributes['lock']['move'] ) && $attributes['lock']['move'] && empty( $attributes['link'] ) ) { + if ( isset( $attributes['lock'] ) && $attributes['lock'] && is_array( $attributes['lock'] ) && isset( $attributes['lock']['remove'] ) && $attributes['lock']['remove'] && isset( $attributes['lock']['move'] ) && $attributes['lock']['move'] && empty( $attributes['link'] ) ) { $html_tag = 'button'; } @@ -472,6 +476,220 @@ public function register_scripts() { wp_register_script( 'kadence-blocks-popper', KADENCE_BLOCKS_URL . 'includes/assets/js/popper.min.js', [], KADENCE_BLOCKS_VERSION, true ); wp_register_script( 'kadence-blocks-tippy', KADENCE_BLOCKS_URL . 'includes/assets/js/kb-tippy.min.js', [ 'kadence-blocks-popper' ], KADENCE_BLOCKS_VERSION, true ); } + + /** + * Point padding and margin at their preset variables, but only for a property the active preset + * actually resolves. + * + * The gate is the whole point. `padding: var(--kb-btn-padding)` is not inert when the variable is + * undefined — it is invalid at computed-value time, which resets padding to `0` rather than letting + * the button's size class supply it. Emitting only when the property resolves is what keeps a button + * whose preset sets no spacing looking exactly as it does today. + * + * Emitted before the attribute output so an explicit per-block value, which lands later in the same + * rule, still wins. Responsiveness needs nothing here: a per-breakpoint override redeclares the + * canonical preset variable inside a media query, and this bridge follows it. + * + * @since TBD + * + * @param Kadence_Blocks_CSS $css The css object. + * @param array $attributes The block attributes. + * + * @return void + */ + private function render_preset_spacing( Kadence_Blocks_CSS $css, array $attributes ): void { + try { + $registry = kadence_blocks()->get( Token_Registry::class ); + $library = kadence_blocks()->get( Active_Token_Library_Store::class ); + $resolver = kadence_blocks()->get( Preset_Resolver::class ); + + // The container is typed `mixed`, and this runs on every button render, so the services are + // checked rather than assumed — a misconfigured container degrades to today's spacing. + if ( + ! $registry instanceof Token_Registry + || ! $library instanceof Active_Token_Library_Store + || ! $resolver instanceof Preset_Resolver + || ! $registry->is_active() + ) { + return; + } + + $slug = $library->get(); + $selected = Cast::to_string( $attributes['kbPreset'] ?? '' ); + $preset = $selected !== '' && $resolver->has_preset( 'kadence/singlebtn', $selected, $slug ) + ? $selected + : $resolver->default_preset( 'kadence/singlebtn', $slug ); + $values = $resolver->resolve( 'kadence/singlebtn', $preset, $slug ); + } catch ( Throwable $e ) { + // This runs in the render path, so a broken token graph must not take the page down with it — + // the button simply keeps the spacing it has today. + return; + } + + if ( isset( $values['button-padding'] ) ) { + $css->add_property( 'padding', 'var(--kb-btn-padding)' ); + } + + if ( isset( $values['button-margin'] ) ) { + $css->add_property( 'margin', 'var(--kb-btn-margin)' ); + } + } + + /** + * Point border width/style/color at their preset variables, but only for a property the active + * preset actually resolves. + * + * The gate is the whole point, exactly as in `render_preset_spacing()` — a `var()` pointed at an + * undefined custom property is invalid at computed-value time, so emitting unconditionally would + * blank out the border on a button whose preset sets none of it. + * + * Emitted before `render_border_styles()`'s explicit per-side output so an explicit per-block + * border, which lands later in the same rule, still wins. + * + * @since TBD + * + * @param Kadence_Blocks_CSS $css The css object. + * @param array $attributes The block attributes. + * + * @return void + */ + private function render_preset_border( Kadence_Blocks_CSS $css, array $attributes ): void { + try { + $registry = kadence_blocks()->get( Token_Registry::class ); + $library = kadence_blocks()->get( Active_Token_Library_Store::class ); + $resolver = kadence_blocks()->get( Preset_Resolver::class ); + + // The container is typed `mixed`, and this runs on every button render, so the services are + // checked rather than assumed — a misconfigured container degrades to today's border. + if ( + ! $registry instanceof Token_Registry + || ! $library instanceof Active_Token_Library_Store + || ! $resolver instanceof Preset_Resolver + || ! $registry->is_active() + ) { + return; + } + + $slug = $library->get(); + $selected = Cast::to_string( $attributes['kbPreset'] ?? '' ); + $preset = $selected !== '' && $resolver->has_preset( 'kadence/singlebtn', $selected, $slug ) + ? $selected + : $resolver->default_preset( 'kadence/singlebtn', $slug ); + $values = $resolver->resolve( 'kadence/singlebtn', $preset, $slug ); + } catch ( Throwable $e ) { + // This runs in the render path, so a broken token graph must not take the page down with it — + // the button simply keeps the border it has today. + return; + } + + if ( isset( $values['button-border-width'] ) ) { + $css->add_property( 'border-width', 'var(--kb-btn-border-width)' ); + } + + if ( isset( $values['button-border-style'] ) ) { + $css->add_property( 'border-style', 'var(--kb-btn-border-style)' ); + } + + if ( isset( $values['button-border-color'] ) ) { + $css->add_property( 'border-color', 'var(--kb-btn-border-color)' ); + } + } + + /** + * Point the button's box-shadow at its preset variable, but only when the active preset actually + * resolves one. + * + * The gate is the whole point, exactly as in `render_preset_spacing()` — a `var()` pointed at an + * undefined custom property is invalid at computed-value time, so emitting unconditionally would + * blank out the shadow on a button whose preset sets none. + * + * Emitted before the explicit `shadow` output below, and the builder appends declarations, so a + * visible per-block shadow lands later in the same rule and wins. The caller uses the returned + * flag for the other half of that contract: when the block's own shadow is invisible it must + * skip its `box-shadow: none` reset, or the trailing `none` would silence the preset's + * `var(--kb-btn-shadow)` here. + * + * Known, accepted limitation: the shadow control's "None" pick and an untouched shadow attribute + * serialize to the exact same value (both resolve to the invisible all-zero composite), by design + * — that is what lets "Default" and "None" read identically in the control. One consequence is + * that a button whose preset resolves a shadow cannot have that shadow turned off from this block's + * own shadow control: "None" is indistinguishable from "never set", so this method's gate always + * wins. Distinguishing them would need a real "explicitly none" marker outside the shadow value + * itself, which is a design change, not a bug fix. + * + * @since TBD + * + * @param Kadence_Blocks_CSS $css The css object. + * @param array $attributes The block attributes. + * + * @return bool Whether a preset box-shadow declaration was emitted. + */ + private function render_preset_shadow( Kadence_Blocks_CSS $css, array $attributes ): bool { + try { + $registry = kadence_blocks()->get( Token_Registry::class ); + $library = kadence_blocks()->get( Active_Token_Library_Store::class ); + $resolver = kadence_blocks()->get( Preset_Resolver::class ); + + // The container is typed `mixed`, and this runs on every button render, so the services are + // checked rather than assumed — a misconfigured container degrades to today's shadow. + if ( + ! $registry instanceof Token_Registry + || ! $library instanceof Active_Token_Library_Store + || ! $resolver instanceof Preset_Resolver + || ! $registry->is_active() + ) { + return false; + } + + $slug = $library->get(); + $selected = Cast::to_string( $attributes['kbPreset'] ?? '' ); + $preset = $selected !== '' && $resolver->has_preset( 'kadence/singlebtn', $selected, $slug ) + ? $selected + : $resolver->default_preset( 'kadence/singlebtn', $slug ); + $values = $resolver->resolve( 'kadence/singlebtn', $preset, $slug ); + } catch ( Throwable $e ) { + // This runs in the render path, so a broken token graph must not take the page down with it — + // the button simply keeps the shadow it has today. + return false; + } + + if ( ! isset( $values['button-shadow'] ) ) { + return false; + } + + $css->add_property( 'box-shadow', 'var(--kb-btn-shadow)' ); + + return true; + } + + /** + * Route a stored button box-shadow object through the alias-aware render_shadow(). + * + * Applies this block's historic per-leg defaults so a literal shadow renders byte-identically + * to the former inline builder. A `{dot.alias}` on any numeric leg resolves to its token var() + * instead of freezing to a literal, and a `shadowToken` binding on the item resolves the whole + * shorthand to its token var(). + * + * @since TBD + * + * @param Kadence_Blocks_CSS $css The active CSS builder. + * @param mixed $shadow The stored shadow object ( e.g. $attributes['shadow'][0] ). + * + * @return string The rendered box-shadow declaration. + */ + private function render_button_shadow( $css, $shadow ): string { + return (string) $css->render_shadow( + is_array( $shadow ) ? $shadow : [], + [ + 'hOffset' => '0', + 'vOffset' => '0', + 'blur' => '14', + 'spread' => '0', + 'color' => '#000000', + 'opacity' => 0.2, + ] + ); + } } Kadence_Blocks_Singlebtn_Block::get_instance(); diff --git a/includes/blocks/class-kadence-blocks-testimonials-block.php b/includes/blocks/class-kadence-blocks-testimonials-block.php index 9c49db3ac2..594cfa4d59 100644 --- a/includes/blocks/class-kadence-blocks-testimonials-block.php +++ b/includes/blocks/class-kadence-blocks-testimonials-block.php @@ -5,6 +5,8 @@ * @package Kadence Blocks */ +// cspell:ignore arrowstyle dotstyle halign inlineimage intrisic isize whiteondark . + // Exit if accessed directly. if ( ! defined( 'ABSPATH' ) ) { exit; @@ -52,10 +54,10 @@ public static function get_instance() { /** * Builds CSS for block. * - * @param array $attributes the blocks attributes. - * @param Kadence_Blocks_CSS $css the css class for blocks. - * @param string $unique_id the blocks attr ID. - * @param string $unique_style_id the blocks alternate ID for queries. + * @param array $attributes the blocks attributes. + * @param Kadence_Blocks_CSS $css the css class for blocks. + * @param string $unique_id the blocks attr ID. + * @param string $unique_style_id the blocks alternate ID for queries. */ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { @@ -664,7 +666,20 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { ); $shadow = isset( $attributes['shadow'][0] ) ? $attributes['shadow'][0] : $default_shadow; - $css->add_property( 'box-shadow', $shadow['hOffset'] .'px '. $shadow['vOffset'] .'px '. $shadow['blur'] . 'px '. $shadow['spread'] . 'px ' . $css->render_color( $shadow['color'], $shadow['opacity'] ) ); + $css->add_property( + 'box-shadow', + $css->render_shadow( + $shadow, + [ + 'hOffset' => '4', + 'vOffset' => '2', + 'blur' => '14', + 'spread' => '0', + 'color' => '#000000', + 'opacity' => 0.2, + ] + ) + ); } if( !empty( $attributes['containerBorderWidth'][0] ) || !empty( $attributes['containerBorderWidth'][1] ) || !empty( $attributes['containerBorderWidth'][2] ) || !empty( $attributes['containerBorderWidth'][3] ) ) { diff --git a/includes/blocks/form/class-kadence-blocks-submit-block.php b/includes/blocks/form/class-kadence-blocks-submit-block.php index 0a4a987c63..4f7a11c413 100644 --- a/includes/blocks/form/class-kadence-blocks-submit-block.php +++ b/includes/blocks/form/class-kadence-blocks-submit-block.php @@ -112,10 +112,10 @@ public function build_html( $attributes, $unique_id, $content, $block_instance ) /** * Builds CSS for block. * - * @param array $attributes the blocks attributes. - * @param string $css the css class for blocks. - * @param string $unique_id the blocks attr ID. - * @param string $unique_style_id the blocks alternate ID for queries. + * @param array $attributes the blocks attributes. + * @param Kadence_Blocks_CSS $css the css object for blocks. + * @param string $unique_id the blocks attr ID. + * @param string $unique_style_id the blocks alternate ID for queries. */ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $class_id = $this->class_id( $attributes ); @@ -161,7 +161,20 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $css->render_measure_output( $attributes, 'margin', 'margin', [ 'unit_key' => 'marginUnit' ] ); if ( isset( $attributes['displayShadow'] ) && true === $attributes['displayShadow'] ) { if ( isset( $attributes['shadow'] ) && is_array( $attributes['shadow'] ) && isset( $attributes['shadow'][0] ) && is_array( $attributes['shadow'][0] ) ) { - $css->add_property( 'box-shadow', ( isset( $attributes['shadow'][0]['inset'] ) && true === $attributes['shadow'][0]['inset'] ? 'inset ' : '' ) . ( isset( $attributes['shadow'][0]['hOffset'] ) && is_numeric( $attributes['shadow'][0]['hOffset'] ) ? $attributes['shadow'][0]['hOffset'] : '0' ) . 'px ' . ( isset( $attributes['shadow'][0]['vOffset'] ) && is_numeric( $attributes['shadow'][0]['vOffset'] ) ? $attributes['shadow'][0]['vOffset'] : '0' ) . 'px ' . ( isset( $attributes['shadow'][0]['blur'] ) && is_numeric( $attributes['shadow'][0]['blur'] ) ? $attributes['shadow'][0]['blur'] : '14' ) . 'px ' . ( isset( $attributes['shadow'][0]['spread'] ) && is_numeric( $attributes['shadow'][0]['spread'] ) ? $attributes['shadow'][0]['spread'] : '0' ) . 'px ' . $css->render_color( ( isset( $attributes['shadow'][0]['color'] ) && ! empty( $attributes['shadow'][0]['color'] ) ? $attributes['shadow'][0]['color'] : '#000000' ), ( isset( $attributes['shadow'][0]['opacity'] ) && is_numeric( $attributes['shadow'][0]['opacity'] ) ? $attributes['shadow'][0]['opacity'] : 0.2 ) ) ); + $css->add_property( + 'box-shadow', + $css->render_shadow( + $attributes['shadow'][0], + [ + 'hOffset' => '0', + 'vOffset' => '0', + 'blur' => '14', + 'spread' => '0', + 'color' => '#000000', + 'opacity' => 0.2, + ] + ) + ); } else { $css->add_property( 'box-shadow', '1px 1px 2px 0px rgba(0, 0, 0, 0.2)' ); } @@ -194,7 +207,20 @@ public function build_css( $attributes, $css, $unique_id, $unique_style_id ) { $css->set_selector( '.kb-btn' . $class_id . '.kb-button:hover::before' ); } if ( isset( $attributes['shadowHover'] ) && is_array( $attributes['shadowHover'] ) && isset( $attributes['shadowHover'][0] ) && is_array( $attributes['shadowHover'][0] ) ) { - $css->add_property( 'box-shadow', ( isset( $attributes['shadowHover'][0]['inset'] ) && true === $attributes['shadowHover'][0]['inset'] ? 'inset ' : '' ) . ( isset( $attributes['shadowHover'][0]['hOffset'] ) && is_numeric( $attributes['shadowHover'][0]['hOffset'] ) ? $attributes['shadowHover'][0]['hOffset'] : '0' ) . 'px ' . ( isset( $attributes['shadowHover'][0]['vOffset'] ) && is_numeric( $attributes['shadowHover'][0]['vOffset'] ) ? $attributes['shadowHover'][0]['vOffset'] : '0' ) . 'px ' . ( isset( $attributes['shadowHover'][0]['blur'] ) && is_numeric( $attributes['shadowHover'][0]['blur'] ) ? $attributes['shadowHover'][0]['blur'] : '14' ) . 'px ' . ( isset( $attributes['shadowHover'][0]['spread'] ) && is_numeric( $attributes['shadowHover'][0]['spread'] ) ? $attributes['shadowHover'][0]['spread'] : '0' ) . 'px ' . $css->render_color( ( isset( $attributes['shadowHover'][0]['color'] ) && ! empty( $attributes['shadowHover'][0]['color'] ) ? $attributes['shadowHover'][0]['color'] : '#000000' ), ( isset( $attributes['shadowHover'][0]['opacity'] ) && is_numeric( $attributes['shadowHover'][0]['opacity'] ) ? $attributes['shadowHover'][0]['opacity'] : 0.2 ) ) ); + $css->add_property( + 'box-shadow', + $css->render_shadow( + $attributes['shadowHover'][0], + [ + 'hOffset' => '0', + 'vOffset' => '0', + 'blur' => '14', + 'spread' => '0', + 'color' => '#000000', + 'opacity' => 0.2, + ] + ) + ); } else { $css->add_property( 'box-shadow', '2px 2px 3px 0px rgba(0, 0, 0, 0.4)' ); } diff --git a/includes/class-kadence-blocks-css.php b/includes/class-kadence-blocks-css.php index e9ef839a02..baf11e8085 100644 --- a/includes/class-kadence-blocks-css.php +++ b/includes/class-kadence-blocks-css.php @@ -7,15 +7,35 @@ * @version 1.9 */ +// cSpell:ignore dglobal fontvariants fontsubsets attribtues . + if ( ! defined( 'ABSPATH' ) ) { exit; } +use KadenceWP\KadenceBlocks\Design_Tokens\Database\Active_Token_Library_Store; +use KadenceWP\KadenceBlocks\Design_Tokens\Registry\Css_Var; +use KadenceWP\KadenceBlocks\Design_Tokens\Resolver\Token_Resolver; +use KadenceWP\KadenceBlocks\Design_Tokens\Schema\Vocabulary\Alias; +use KadenceWP\KadenceBlocks\Psr\Log\LoggerInterface; + /** * Class to create a minified css output. */ class Kadence_Blocks_CSS { + /** + * The shadow item's optional binding key: the {dot.alias} of the shadow token the value follows. + * Kept alongside the numeric legs rather than replacing them, so an item stays a valid literal + * shadow for readers that do not know this key and has something to fall back to when the bound + * token is no longer in the active library. + * + * @since TBD + * + * @var string + */ + private const SHADOW_TOKEN_KEY = 'shadowToken'; + /** * CSS to enqueue * @@ -135,7 +155,7 @@ class Kadence_Blocks_CSS { protected $_media_state = 'desktop'; /** - * Stores a list of css properties that require more formating + * Stores a list of css properties that require more formatting * * @access private * @var array @@ -206,6 +226,7 @@ class Kadence_Blocks_CSS { */ protected $spacing_sizes = array( 'ss-auto' => 'var(--global-kb-spacing-auto, auto)', + 'none' => 'var(--global-kb-spacing-none, 0rem)', 'xxs' => 'var(--global-kb-spacing-xxs, 0.5rem)', 'xs' => 'var(--global-kb-spacing-xs, 1rem)', 'sm' => 'var(--global-kb-spacing-sm, 1.5rem)', @@ -245,6 +266,17 @@ class Kadence_Blocks_CSS { 'lg' => 'var(--global-kb-gap-lg, 4rem)', ); + /** + * The shadow item key that carries a whole-shadow token binding. + * + * @since TBD + * + * @return string The binding key. + */ + public static function get_shadow_token_key(): string { + return self::SHADOW_TOKEN_KEY; + } + /** * Instance Control */ @@ -302,7 +334,7 @@ public function set_style_id( $style_id = '' ) { if ( empty( $style_id ) ) { return; } - // Render the css in the output string everytime the style_id changes. + // Render the css in the output string every time the style_id changes. if ( ! isset( self::$styles[ $style_id ] ) ) { self::$styles[ $style_id ] = ''; } @@ -356,7 +388,7 @@ public function has_header_styles( $style_id = '' ) { * @return $this */ public function set_selector( $selector = '' ) { - // Render the css in the output string everytime the selector changes. + // Render the css in the output string every time the selector changes. if ( '' !== $this->_selector ) { $this->add_selector_rules_to_output(); } @@ -577,7 +609,7 @@ public function add_special_rules( $property, $value ) { * * @param string $property - the css property * @param mixed $value - the value to be placed with the property - * @param mixed $check_empty - the value to be checkd if empty + * @param mixed $check_empty - the value to be checked if empty * @return $this */ public function add_property( $property, $value = null, $check_empty = null ) { @@ -838,22 +870,39 @@ public function render_typography( $attributes, $name = 'typography', $inherit = if ( isset( $font['size'] ) && isset( $font['size'][0] ) && ! empty( $font['size'][0] ) ) { $this->add_property( 'font-size', $this->get_font_size( $font['size'][0], $size_type ) ); } - if ( isset( $font['lineHeight'] ) && isset( $font['lineHeight']['desktop'] ) && ! empty( $font['lineHeight']['desktop'] ) ) { + $line_height_desktop_reference = $this->get_backed_token_reference( $font['lineHeight']['desktop'] ?? null ); + if ( null !== $line_height_desktop_reference ) { + $this->add_property( 'line-height', $line_height_desktop_reference ); + } elseif ( isset( $font['lineHeight'] ) && isset( $font['lineHeight']['desktop'] ) && ! empty( $font['lineHeight']['desktop'] ) && ! Alias::is_alias( $font['lineHeight']['desktop'] ) ) { $this->add_property( 'line-height', $font['lineHeight']['desktop'] . $line_type ); } // Numeric array. - if ( isset( $font['lineHeight'] ) && isset( $font['lineHeight'][0] ) && ! empty( $font['lineHeight'][0] ) ) { + $line_height_reference = $this->get_backed_token_reference( $font['lineHeight'][0] ?? null ); + if ( null !== $line_height_reference ) { + $this->add_property( 'line-height', $line_height_reference ); + } elseif ( isset( $font['lineHeight'] ) && isset( $font['lineHeight'][0] ) && ! empty( $font['lineHeight'][0] ) && ! Alias::is_alias( $font['lineHeight'][0] ) ) { $this->add_property( 'line-height', $font['lineHeight'][0] . $line_type ); } if ( isset( $font['letterSpacing'] ) && is_array( $font['letterSpacing'] ) ) { - if ( isset( $font['letterSpacing']['desktop'] ) && is_numeric( $font['letterSpacing']['desktop'] ) ) { + $letter_spacing_desktop_reference = $this->get_backed_token_reference( $font['letterSpacing']['desktop'] ?? null ); + if ( null !== $letter_spacing_desktop_reference ) { + $this->add_property( 'letter-spacing', $letter_spacing_desktop_reference ); + } elseif ( isset( $font['letterSpacing']['desktop'] ) && is_numeric( $font['letterSpacing']['desktop'] ) ) { $this->add_property( 'letter-spacing', $font['letterSpacing']['desktop'] . $letter_type ); } - if ( isset( $font['letterSpacing'][0] ) && is_numeric( $font['letterSpacing'][0] ) ) { + $letter_spacing_reference = $this->get_backed_token_reference( $font['letterSpacing'][0] ?? null ); + if ( null !== $letter_spacing_reference ) { + $this->add_property( 'letter-spacing', $letter_spacing_reference ); + } elseif ( isset( $font['letterSpacing'][0] ) && is_numeric( $font['letterSpacing'][0] ) ) { $this->add_property( 'letter-spacing', $font['letterSpacing'][0] . $letter_type ); } - } elseif ( isset( $font['letterSpacing'] ) && is_numeric( $font['letterSpacing'] ) ) { - $this->add_property( 'letter-spacing', $font['letterSpacing'] . $letter_type ); + } else { + $letter_spacing_scalar_reference = $this->get_backed_token_reference( $font['letterSpacing'] ?? null ); + if ( null !== $letter_spacing_scalar_reference ) { + $this->add_property( 'letter-spacing', $letter_spacing_scalar_reference ); + } elseif ( isset( $font['letterSpacing'] ) && is_numeric( $font['letterSpacing'] ) ) { + $this->add_property( 'letter-spacing', $font['letterSpacing'] . $letter_type ); + } } $family = ( isset( $font['family'] ) && ! empty( $font['family'] ) && 'inherit' !== $font['family'] ? $font['family'] : '' ); $is_google = false; @@ -879,16 +928,28 @@ public function render_typography( $attributes, $name = 'typography', $inherit = if ( isset( $font['size'] ) && isset( $font['size'][1] ) && ! empty( $font['size'][1] ) ) { $this->add_property( 'font-size', $this->get_font_size( $font['size'][1], $size_type ) ); } - if ( isset( $font['lineHeight'] ) && isset( $font['lineHeight']['tablet'] ) && ! empty( $font['lineHeight']['tablet'] ) ) { + $line_height_tablet_key_reference = $this->get_backed_token_reference( $font['lineHeight']['tablet'] ?? null ); + if ( null !== $line_height_tablet_key_reference ) { + $this->add_property( 'line-height', $line_height_tablet_key_reference ); + } elseif ( isset( $font['lineHeight'] ) && isset( $font['lineHeight']['tablet'] ) && ! empty( $font['lineHeight']['tablet'] ) && ! Alias::is_alias( $font['lineHeight']['tablet'] ) ) { $this->add_property( 'line-height', $font['lineHeight']['tablet'] . $line_type ); } - if ( isset( $font['lineHeight'] ) && isset( $font['lineHeight'][1] ) && ! empty( $font['lineHeight'][1] ) ) { + $line_height_tablet_reference = $this->get_backed_token_reference( $font['lineHeight'][1] ?? null ); + if ( null !== $line_height_tablet_reference ) { + $this->add_property( 'line-height', $line_height_tablet_reference ); + } elseif ( isset( $font['lineHeight'] ) && isset( $font['lineHeight'][1] ) && ! empty( $font['lineHeight'][1] ) && ! Alias::is_alias( $font['lineHeight'][1] ) ) { $this->add_property( 'line-height', $font['lineHeight'][1] . $line_type ); } - if ( isset( $font['letterSpacing'] ) && isset( $font['letterSpacing']['tablet'] ) && is_numeric( $font['letterSpacing']['tablet'] ) ) { + $letter_spacing_tablet_key_reference = $this->get_backed_token_reference( $font['letterSpacing']['tablet'] ?? null ); + if ( null !== $letter_spacing_tablet_key_reference ) { + $this->add_property( 'letter-spacing', $letter_spacing_tablet_key_reference ); + } elseif ( isset( $font['letterSpacing'] ) && isset( $font['letterSpacing']['tablet'] ) && is_numeric( $font['letterSpacing']['tablet'] ) ) { $this->add_property( 'letter-spacing', $font['letterSpacing']['tablet'] . $letter_type ); } - if ( isset( $font['letterSpacing'] ) && isset( $font['letterSpacing'][1] ) && is_numeric( $font['letterSpacing'][1] ) ) { + $letter_spacing_tablet_reference = $this->get_backed_token_reference( $font['letterSpacing'][1] ?? null ); + if ( null !== $letter_spacing_tablet_reference ) { + $this->add_property( 'letter-spacing', $letter_spacing_tablet_reference ); + } elseif ( isset( $font['letterSpacing'] ) && isset( $font['letterSpacing'][1] ) && is_numeric( $font['letterSpacing'][1] ) ) { $this->add_property( 'letter-spacing', $font['letterSpacing'][1] . $letter_type ); } // Mobile. @@ -896,16 +957,28 @@ public function render_typography( $attributes, $name = 'typography', $inherit = if ( isset( $font['size'] ) && isset( $font['size'][2] ) && ! empty( $font['size'][2] ) ) { $this->add_property( 'font-size', $this->get_font_size( $font['size'][2], $size_type ) ); } - if ( isset( $font['lineHeight'] ) && isset( $font['lineHeight']['mobile'] ) && ! empty( $font['lineHeight']['mobile'] ) ) { + $line_height_mobile_key_reference = $this->get_backed_token_reference( $font['lineHeight']['mobile'] ?? null ); + if ( null !== $line_height_mobile_key_reference ) { + $this->add_property( 'line-height', $line_height_mobile_key_reference ); + } elseif ( isset( $font['lineHeight'] ) && isset( $font['lineHeight']['mobile'] ) && ! empty( $font['lineHeight']['mobile'] ) && ! Alias::is_alias( $font['lineHeight']['mobile'] ) ) { $this->add_property( 'line-height', $font['lineHeight']['mobile'] . $line_type ); } - if ( isset( $font['lineHeight'] ) && isset( $font['lineHeight'][2] ) && ! empty( $font['lineHeight'][2] ) ) { + $line_height_mobile_reference = $this->get_backed_token_reference( $font['lineHeight'][2] ?? null ); + if ( null !== $line_height_mobile_reference ) { + $this->add_property( 'line-height', $line_height_mobile_reference ); + } elseif ( isset( $font['lineHeight'] ) && isset( $font['lineHeight'][2] ) && ! empty( $font['lineHeight'][2] ) && ! Alias::is_alias( $font['lineHeight'][2] ) ) { $this->add_property( 'line-height', $font['lineHeight'][2] . $line_type ); } - if ( isset( $font['letterSpacing'] ) && isset( $font['letterSpacing']['mobile'] ) && is_numeric( $font['letterSpacing']['mobile'] ) ) { + $letter_spacing_mobile_key_reference = $this->get_backed_token_reference( $font['letterSpacing']['mobile'] ?? null ); + if ( null !== $letter_spacing_mobile_key_reference ) { + $this->add_property( 'letter-spacing', $letter_spacing_mobile_key_reference ); + } elseif ( isset( $font['letterSpacing'] ) && isset( $font['letterSpacing']['mobile'] ) && is_numeric( $font['letterSpacing']['mobile'] ) ) { $this->add_property( 'letter-spacing', $font['letterSpacing']['mobile'] . $letter_type ); } - if ( isset( $font['letterSpacing'] ) && isset( $font['letterSpacing'][2] ) && is_numeric( $font['letterSpacing'][2] ) ) { + $letter_spacing_mobile_reference = $this->get_backed_token_reference( $font['letterSpacing'][2] ?? null ); + if ( null !== $letter_spacing_mobile_reference ) { + $this->add_property( 'letter-spacing', $letter_spacing_mobile_reference ); + } elseif ( isset( $font['letterSpacing'] ) && isset( $font['letterSpacing'][2] ) && is_numeric( $font['letterSpacing'][2] ) ) { $this->add_property( 'letter-spacing', $font['letterSpacing'][2] . $letter_type ); } $this->set_media_state( 'desktop' ); @@ -978,6 +1051,118 @@ public function render_string( $string = null, $unit = null ) { return $string; } + /** + * Resolve a design-token alias reference to its CSS custom-property var(). + * + * A value matching the strict {dot.alias} form resolves to a bare var(--kb-token--) with no + * fallback literal; anything else returns null so the caller falls through to its existing + * numeric/palette handling. This is the pure syntactic recognizer — the byte-for-byte PHP peer of the + * JS `resolveTokenAlias()` (see src/extension/design-tokens/alias.js and the shared conformance + * fixture); it does NOT consider whether the token resolves. Render callers that must drop an + * unresolved (e.g. since-deleted) token use {@see self::get_backed_token_reference()} instead. + * + * @since TBD + * + * @param mixed $value The raw attribute value. + * + * @return string|null The var() reference, or null when the value is not an alias. + */ + private function get_token_reference( $value ): ?string { + if ( ! is_string( $value ) || ! Alias::is_alias( $value ) ) { + return null; + } + + return 'var(' . Css_Var::from_id( Alias::path_of( $value ) ) . ')'; + } + + /** + * Like {@see self::get_token_reference()}, but only for a token that is backed by the active library — + * i.e. one the Css_Var projector actually emits a `--kb-token--` custom property for. A binding may + * reference a stale alias (a token deleted after it was saved into a post); minting a var() for it + * would leave a dead custom property with no definition, so render callers use this to emit nothing and + * let the property fall back to whatever global CSS exists. A syntactically-valid but unbacked alias, + * and any non-alias, both return null. + * + * @since TBD + * + * @param mixed $value The raw attribute value. + * + * @return string|null The var() reference for a backed alias, or null otherwise. + */ + private function get_backed_token_reference( $value ): ?string { + $reference = $this->get_token_reference( $value ); + + // Only a string alias yields a non-null reference, so $value is a resolvable id path here. + if ( null === $reference || ! is_string( $value ) ) { + return null; + } + + if ( ! $this->token_alias_is_backed( Alias::path_of( $value ) ) ) { + return null; + } + + return $reference; + } + + /** + * Whether a value is a `{dot.alias}` reference backed by the active library — the same backing check + * {@see self::get_backed_token_reference()} uses to decide whether a renderer emits a var() or falls + * back to a default. Exposed for callers outside this class (e.g. the shadow-visibility gate on + * {@see Kadence_Blocks_Abstract_Block}) that need to reuse the check rather than duplicate it. + * + * @since TBD + * + * @param mixed $value The raw attribute value. + * + * @return bool True when the value is an alias reference backed by the active library. + */ + public function is_token_reference_backed( $value ): bool { + return null !== $this->get_backed_token_reference( $value ); + } + + /** + * Whether a design-token id is backed by the active library — i.e. the Css_Var projector emits a + * `--kb-token--` custom property for it. A binding may reference a stale alias (a token removed + * after it was stored); minting a var() for it would leave a dead custom property with no definition, + * so callers use this to skip the declaration and fall back to the global CSS instead. + * + * The active library is resolved through Token_Resolver, which memoizes per store version, so repeated + * lookups stay cheap and always reflect the current version. The unresolved-alias log is de-duplicated + * per (library, id) so one stale alias does not flood the error log across a page's many blocks. Fails + * open: if the container/resolver is unavailable or resolution throws, the alias is treated as backed + * (today's behavior) so a render never crashes and transient resolver issues do not drop all token CSS. + * + * @since TBD + * + * @param string $id The design-token id (the alias path). + * + * @return bool True when the id resolves in the active library, or on any error (fail-open). + */ + private function token_alias_is_backed( string $id ): bool { + /** @var array $logged */ + static $logged = array(); + + try { + /** @var Active_Token_Library_Store $active */ + $active = kadence_blocks()->get( Active_Token_Library_Store::class ); + $slug = $active->get(); + + /** @var Token_Resolver $resolver */ + $resolver = kadence_blocks()->get( Token_Resolver::class ); + $backed = $resolver->resolve( $slug )->value( $id ) !== null; + + if ( ! $backed && ! isset( $logged[ $slug . '|' . $id ] ) && defined( 'WP_DEBUG' ) && WP_DEBUG ) { + $logged[ $slug . '|' . $id ] = true; + /** @var LoggerInterface $logger */ + $logger = kadence_blocks()->get( LoggerInterface::class ); + $logger->error( sprintf( 'CSS render: skipped unresolved token alias "%s"; falling back to global CSS.', $id ) ); + } + + return $backed; + } catch ( \Throwable $e ) { + return true; + } + } /** * Outputs a string if set. * @@ -986,6 +1171,10 @@ public function render_string( $string = null, $unit = null ) { * @return string */ public function render_number( $number = null, $unit = null ) { + $token_reference = $this->get_backed_token_reference( $number ); + if ( null !== $token_reference ) { + return $token_reference; + } if ( ! is_numeric( $number ) ) { return false; } @@ -997,12 +1186,20 @@ public function render_number( $number = null, $unit = null ) { * Generates the color output. * * @param string $color any color attribute. - * @return string + * @return string|false */ public function render_color( $color, $opacity = null ) { if ( empty( $color ) ) { return false; } + $token_reference = $this->get_backed_token_reference( $color ); + if ( null !== $token_reference ) { + return $token_reference; + } + if ( is_string( $color ) && Alias::is_alias( $color ) ) { + // A strict alias that did not resolve: emit nothing so the property falls back to the global CSS. + return false; + } if ( ! is_array( $color ) && strpos( $color, 'palette' ) === 0 ) { switch ( $color ) { case 'palette2': @@ -1043,12 +1240,20 @@ public function render_color( $color, $opacity = null ) { * Generates the color output. * * @param string $color any color attribute. - * @return string + * @return string|false */ public function sanitize_color( $color, $opacity = null ) { if ( empty( $color ) ) { return false; } + $token_reference = $this->get_backed_token_reference( $color ); + if ( null !== $token_reference ) { + return $token_reference; + } + if ( is_string( $color ) && Alias::is_alias( $color ) ) { + // A strict alias that did not resolve: emit nothing so the property falls back to the global CSS. + return false; + } if ( ! is_array( $color ) && strpos( $color, 'palette' ) === 0 ) { switch ( $color ) { case 'palette2': @@ -1152,16 +1357,21 @@ public function render_range( $attributes, $name = 'width', $property = 'width', if ( ! isset( $attributes[ $name ] ) ) { return false; } - if ( $render_zero ) { - if ( ! is_numeric( $attributes[ $name ] ) ) { - return false; - } + $token_reference = $this->get_backed_token_reference( $attributes[ $name ] ); + if ( null !== $token_reference ) { + $this->add_property( $property, $token_reference ); } else { - if ( empty( $attributes[ $name ] ) ) { - return false; + if ( $render_zero ) { + if ( ! is_numeric( $attributes[ $name ] ) ) { + return false; + } + } else { + if ( empty( $attributes[ $name ] ) ) { + return false; + } } + $this->add_property( $property, $attributes[ $name ] . $unit ); } - $this->add_property( $property, $attributes[ $name ] . $unit ); } /** * Generates the measure range output. @@ -1228,24 +1438,36 @@ public function render_measure_range( $attributes, $name = 'width', $property = $args = wp_parse_args( $args, $defaults ); $unit = ! empty( $attributes[ $args['unit_key'] ] ) ? $attributes[ $args['unit_key'] ] : $unit; if ( isset( $attributes[ $name ] ) && is_array( $attributes[ $name ] ) ) { - if ( $render_zero && is_numeric( $attributes[ $name ][0] ) ) { + $first_reference = $this->get_backed_token_reference( $attributes[ $name ][0] ?? null ); + if ( null !== $first_reference ) { + $this->add_property( $args['first_prop'], $first_reference ); + } else if ( $render_zero && is_numeric( $attributes[ $name ][0] ) ) { $this->add_property( $args['first_prop'], $attributes[ $name ][0] . $unit ); - } else if ( ! $render_zero && ! empty( $attributes[ $name ][0] ) ) { + } else if ( ! $render_zero && ! empty( $attributes[ $name ][0] ) && ! Alias::is_alias( $attributes[ $name ][0] ) ) { $this->add_property( $args['first_prop'], $attributes[ $name ][0] . $unit ); } - if ( $render_zero && is_numeric( $attributes[ $name ][1] ) ) { + $second_reference = $this->get_backed_token_reference( $attributes[ $name ][1] ?? null ); + if ( null !== $second_reference ) { + $this->add_property( $args['second_prop'], $second_reference ); + } else if ( $render_zero && is_numeric( $attributes[ $name ][1] ) ) { $this->add_property( $args['second_prop'], $attributes[ $name ][1] . $unit ); - } else if ( ! $render_zero && ! empty( $attributes[ $name ][1] ) ) { + } else if ( ! $render_zero && ! empty( $attributes[ $name ][1] ) && ! Alias::is_alias( $attributes[ $name ][1] ) ) { $this->add_property( $args['second_prop'], $attributes[ $name ][1] . $unit ); } - if ( $render_zero && is_numeric( $attributes[ $name ][2] ) ) { + $third_reference = $this->get_backed_token_reference( $attributes[ $name ][2] ?? null ); + if ( null !== $third_reference ) { + $this->add_property( $args['third_prop'], $third_reference ); + } else if ( $render_zero && is_numeric( $attributes[ $name ][2] ) ) { $this->add_property( $args['third_prop'], $attributes[ $name ][2] . $unit ); - } else if ( ! $render_zero && ! empty( $attributes[ $name ][2] ) ) { + } else if ( ! $render_zero && ! empty( $attributes[ $name ][2] ) && ! Alias::is_alias( $attributes[ $name ][2] ) ) { $this->add_property( $args['third_prop'], $attributes[ $name ][2] . $unit ); } - if ( $render_zero && is_numeric( $attributes[ $name ][3] ) ) { + $fourth_reference = $this->get_backed_token_reference( $attributes[ $name ][3] ?? null ); + if ( null !== $fourth_reference ) { + $this->add_property( $args['fourth_prop'], $fourth_reference ); + } else if ( $render_zero && is_numeric( $attributes[ $name ][3] ) ) { $this->add_property( $args['fourth_prop'], $attributes[ $name ][3] . $unit ); - } else if ( ! $render_zero && ! empty( $attributes[ $name ][3] ) ) { + } else if ( ! $render_zero && ! empty( $attributes[ $name ][3] ) && ! Alias::is_alias( $attributes[ $name ][3] ) ) { $this->add_property( $args['fourth_prop'], $attributes[ $name ][3] . $unit ); } } @@ -1463,16 +1685,49 @@ public function render_row_gap_property( $attributes, $name = array( 'gap', 'tab /** * Generates the shadow output. * - * @param array $shadow an array of shadow settings. - * @return string - */ - public function render_shadow( $shadow ) { - if ( empty( $shadow ) ) { + * A `shadowToken` key holding a {dot.alias} binds the WHOLE shadow to a token: when that token is + * backed by the active library the method returns its bare var() and reads no other key. When the + * binding is unbacked (the token was deleted after the item was saved), the method returns false + * instead of falling back to the item's stored legs, so the caller's own default CSS takes over — + * matching every other token binding in this class. An item that carries no `shadowToken` at all is + * unaffected and renders from its legs as before. + * + * @param array $shadow an array of shadow settings. + * @param array $defaults optional per-caller fallback literals used to fill + * any empty/missing leg before rendering. When omitted + * the method behaves exactly as before. Numeric and + * {alias} values always pass through untouched. + * @return string|false + */ + public function render_shadow( $shadow, array $defaults = [] ) { + if ( ! is_array( $shadow ) ) { return false; } - if ( ! is_array( $shadow ) ) { + + // A backed whole-shadow binding replaces the entire shorthand, so the legs below are never read. + $shadow_token = $shadow[ self::SHADOW_TOKEN_KEY ] ?? null; + $shadow_token_reference = $this->get_backed_token_reference( $shadow_token ); + if ( null !== $shadow_token_reference ) { + return $shadow_token_reference; + } + + // An unbacked binding (a token deleted after the item was saved) emits nothing rather than + // falling back to the legs: they still hold the value the token resolved to when it was picked, + // not the current one, so reading them here would render a stale shadow instead of letting the + // caller's own default CSS take over. An item with no `shadowToken` at all is not a binding and + // falls through to the legs below as always. + if ( Alias::is_alias( $shadow_token ) ) { return false; } + + if ( ! empty( $defaults ) ) { + $shadow = $this->normalize_shadow_defaults( $shadow, $defaults ); + } + + if ( empty( $shadow ) ) { + return false; + } + if ( ! isset( $shadow['color'] ) ) { return false; } @@ -1494,16 +1749,67 @@ public function render_shadow( $shadow ) { if ( ! isset( $shadow['inset'] ) ) { return false; } + $h_offset_reference = $this->get_backed_token_reference( $shadow['hOffset'] ); + $h_offset = null !== $h_offset_reference ? $h_offset_reference : ( ( ! empty( $shadow['hOffset'] ) ? $shadow['hOffset'] : '0' ) . 'px' ); + $v_offset_reference = $this->get_backed_token_reference( $shadow['vOffset'] ); + $v_offset = null !== $v_offset_reference ? $v_offset_reference : ( ( ! empty( $shadow['vOffset'] ) ? $shadow['vOffset'] : '0' ) . 'px' ); + $blur_reference = $this->get_backed_token_reference( $shadow['blur'] ); + $blur = null !== $blur_reference ? $blur_reference : ( ( ! empty( $shadow['blur'] ) ? $shadow['blur'] : '0' ) . 'px' ); + $spread_reference = $this->get_backed_token_reference( $shadow['spread'] ); + $spread = null !== $spread_reference ? $spread_reference : ( ( ! empty( $shadow['spread'] ) ? $shadow['spread'] : '0' ) . 'px' ); + $color = ! empty( $shadow['color'] ) ? $this->render_color( $shadow['color'], $shadow['opacity'] ) : $this->render_color( '#000000', $shadow['opacity'] ); + + // A strict alias part that did not resolve (offset/blur/spread reference null, or an unresolved + // alias color returned false) invalidates the whole shorthand; emit nothing so the box-shadow + // falls back to the global CSS. + if ( + ( Alias::is_alias( $shadow['hOffset'] ) && null === $h_offset_reference ) || + ( Alias::is_alias( $shadow['vOffset'] ) && null === $v_offset_reference ) || + ( Alias::is_alias( $shadow['blur'] ) && null === $blur_reference ) || + ( Alias::is_alias( $shadow['spread'] ) && null === $spread_reference ) || + false === $color + ) { + return false; + } if ( $shadow['inset'] ) { - $shadow_string = 'inset ' . ( ! empty( $shadow['hOffset'] ) ? $shadow['hOffset'] : '0' ) . 'px ' . ( ! empty( $shadow['vOffset'] ) ? $shadow['vOffset'] : '0' ) . 'px ' . ( ! empty( $shadow['blur'] ) ? $shadow['blur'] : '0' ) . 'px ' . ( ! empty( $shadow['spread'] ) ? $shadow['spread'] : '0' ) . 'px ' . ( ! empty( $shadow['color'] ) ? $this->render_color( $shadow['color'], $shadow['opacity'] ) : $this->render_color( '#000000', $shadow['opacity'] ) ); + $shadow_string = 'inset ' . $h_offset . ' ' . $v_offset . ' ' . $blur . ' ' . $spread . ' ' . $color; } else { - $shadow_string = ( ! empty( $shadow['hOffset'] ) ? $shadow['hOffset'] : '0' ) . 'px ' . ( ! empty( $shadow['vOffset'] ) ? $shadow['vOffset'] : '0' ) . 'px ' . ( ! empty( $shadow['blur'] ) ? $shadow['blur'] : '0' ) . 'px ' . ( ! empty( $shadow['spread'] ) ? $shadow['spread'] : '0' ) . 'px ' . ( ! empty( $shadow['color'] ) ? $this->render_color( $shadow['color'], $shadow['opacity'] ) : $this->render_color( '#000000', $shadow['opacity'] ) ); + $shadow_string = $h_offset . ' ' . $v_offset . ' ' . $blur . ' ' . $spread . ' ' . $color; } return $shadow_string; } - + /** + * Render a legacy positional box-shadow array through the alias-aware render_shadow(). + * + * Several blocks store a box-shadow as a positional array where index 0 is the enabled flag, + * 1 the color, 2 the opacity, 3-6 the offsets/blur/spread and 7 the inset flag. This maps that + * shape onto the keyed array render_shadow() expects and applies the caller's per-state + * defaults, so a {dot.alias} on any numeric leg resolves to its token var(). + * + * @since TBD + * + * @param array $box_shadow The positional shadow array (indexes 1-7 are read). + * @param array $defaults Per-caller fallback literals for empty legs. + * + * @return string The rendered box-shadow declaration. + */ + public function render_legacy_shadow( array $box_shadow, array $defaults ): string { + return (string) $this->render_shadow( + [ + 'color' => $box_shadow[1] ?? '', + 'opacity' => $box_shadow[2] ?? '', + 'hOffset' => $box_shadow[3] ?? '', + 'vOffset' => $box_shadow[4] ?? '', + 'blur' => $box_shadow[5] ?? '', + 'spread' => $box_shadow[6] ?? '', + 'inset' => ! empty( $box_shadow[7] ), + ], + $defaults + ); + } + /** * Generates the border radius color output. * @@ -1519,16 +1825,28 @@ public function render_border_radius( $attributes, $name = 'borderRadius', $unit return false; } if ( isset( $attributes[ $name ] ) && is_array( $attributes[ $name ] ) ) { - if ( isset( $attributes[ $name ][0] ) && is_numeric( $attributes[ $name ][0] ) ) { + $top_left_reference = $this->get_backed_token_reference( $attributes[ $name ][0] ?? null ); + if ( null !== $top_left_reference ) { + $this->add_property( 'border-top-left-radius', $top_left_reference ); + } else if ( isset( $attributes[ $name ][0] ) && is_numeric( $attributes[ $name ][0] ) ) { $this->add_property( 'border-top-left-radius', $attributes[ $name ][0] . $unit ); } - if ( isset( $attributes[ $name ][1] ) && is_numeric( $attributes[ $name ][1] ) ) { + $top_right_reference = $this->get_backed_token_reference( $attributes[ $name ][1] ?? null ); + if ( null !== $top_right_reference ) { + $this->add_property( 'border-top-right-radius', $top_right_reference ); + } else if ( isset( $attributes[ $name ][1] ) && is_numeric( $attributes[ $name ][1] ) ) { $this->add_property( 'border-top-right-radius', $attributes[ $name ][1] . $unit ); } - if ( isset( $attributes[ $name ][2] ) && is_numeric( $attributes[ $name ][2] ) ) { + $bottom_right_reference = $this->get_backed_token_reference( $attributes[ $name ][2] ?? null ); + if ( null !== $bottom_right_reference ) { + $this->add_property( 'border-bottom-right-radius', $bottom_right_reference ); + } else if ( isset( $attributes[ $name ][2] ) && is_numeric( $attributes[ $name ][2] ) ) { $this->add_property( 'border-bottom-right-radius', $attributes[ $name ][2] . $unit ); } - if ( isset( $attributes[ $name ][3] ) && is_numeric( $attributes[ $name ][3] ) ) { + $bottom_left_reference = $this->get_backed_token_reference( $attributes[ $name ][3] ?? null ); + if ( null !== $bottom_left_reference ) { + $this->add_property( 'border-bottom-left-radius', $bottom_left_reference ); + } else if ( isset( $attributes[ $name ][3] ) && is_numeric( $attributes[ $name ][3] ) ) { $this->add_property( 'border-bottom-left-radius', $attributes[ $name ][3] . $unit ); } } @@ -1705,14 +2023,25 @@ public function render_responsive_range( $attributes, $name = 'width', $property } $unit = ! empty( $attributes[ $unit ] ) ? $attributes[ $unit ] : 'px'; if ( isset( $attributes[ $name ] ) && is_array( $attributes[ $name ] ) ) { - if ( isset( $attributes[ $name ][0] ) && is_numeric( $attributes[ $name ][0] ) ) { + $desktop_reference = $this->get_backed_token_reference( $attributes[ $name ][0] ?? null ); + if ( null !== $desktop_reference ) { + $this->add_property( $property, $desktop_reference ); + } else if ( isset( $attributes[ $name ][0] ) && is_numeric( $attributes[ $name ][0] ) ) { $this->add_property( $property, $attributes[ $name ][0] . $unit ); } - if ( isset( $attributes[ $name ][1] ) && is_numeric( $attributes[ $name ][1] ) ){ + $tablet_reference = $this->get_backed_token_reference( $attributes[ $name ][1] ?? null ); + if ( null !== $tablet_reference ) { + $this->set_media_state( 'tablet' ); + $this->add_property( $property, $tablet_reference ); + } else if ( isset( $attributes[ $name ][1] ) && is_numeric( $attributes[ $name ][1] ) ){ $this->set_media_state( 'tablet' ); $this->add_property( $property, $attributes[ $name ][1] . $unit ); } - if ( isset( $attributes[ $name ][2] ) && is_numeric( $attributes[ $name ][2] ) ) { + $mobile_reference = $this->get_backed_token_reference( $attributes[ $name ][2] ?? null ); + if ( null !== $mobile_reference ) { + $this->set_media_state( 'mobile' ); + $this->add_property( $property, $mobile_reference ); + } else if ( isset( $attributes[ $name ][2] ) && is_numeric( $attributes[ $name ][2] ) ) { $this->set_media_state( 'mobile' ); $this->add_property( $property, $attributes[ $name ][2] . $unit ); } @@ -1742,22 +2071,39 @@ public function render_responsive_size( $attributes, $name = array( 'width', 'ta $unit = ! empty( $attributes[ $unit ] ) ? $attributes[ $unit ] : 'px'; $this->set_media_state( 'desktop' ); - if ( isset( $attributes[ $name[0] ] ) && '' !== $attributes[ $name[0] ] ) { - $this->add_property( $property, $attributes[ $name[0] ] . $unit ); - } else if ( $defaults[0] ) { - $this->add_property( $property, $defaults[0] . $unit ); + $desktop_reference = $this->get_backed_token_reference( $attributes[ $name[0] ] ?? null ); + if ( null !== $desktop_reference ) { + $this->add_property( $property, $desktop_reference ); + } else if ( ! Alias::is_alias( $attributes[ $name[0] ] ?? null ) ) { + // A resolved alias emits above; an unresolved strict alias emits nothing so the property falls + // back to the global CSS. Only a non-alias reaches the literal/defaults handling. + if ( isset( $attributes[ $name[0] ] ) && '' !== $attributes[ $name[0] ] ) { + $this->add_property( $property, $attributes[ $name[0] ] . $unit ); + } else if ( $defaults[0] ) { + $this->add_property( $property, $defaults[0] . $unit ); + } } $this->set_media_state( 'tablet' ); - if ( isset( $attributes[ $name[1] ] ) && '' !== $attributes[ $name[1] ] ) { - $this->add_property( $property, $attributes[ $name[1] ] . $unit ); - } else if ( $defaults[1] ) { - $this->add_property( $property, $defaults[1] . $unit ); + $tablet_reference = $this->get_backed_token_reference( $attributes[ $name[1] ] ?? null ); + if ( null !== $tablet_reference ) { + $this->add_property( $property, $tablet_reference ); + } else if ( ! Alias::is_alias( $attributes[ $name[1] ] ?? null ) ) { + if ( isset( $attributes[ $name[1] ] ) && '' !== $attributes[ $name[1] ] ) { + $this->add_property( $property, $attributes[ $name[1] ] . $unit ); + } else if ( $defaults[1] ) { + $this->add_property( $property, $defaults[1] . $unit ); + } } $this->set_media_state( 'mobile' ); - if ( isset( $attributes[ $name[2] ] ) && '' !== $attributes[ $name[2] ] ) { - $this->add_property( $property, $attributes[ $name[2] ] . $unit ); - } else if ( $defaults[2] ) { - $this->add_property( $property, $defaults[2] . $unit ); + $mobile_reference = $this->get_backed_token_reference( $attributes[ $name[2] ] ?? null ); + if ( null !== $mobile_reference ) { + $this->add_property( $property, $mobile_reference ); + } else if ( ! Alias::is_alias( $attributes[ $name[2] ] ?? null ) ) { + if ( isset( $attributes[ $name[2] ] ) && '' !== $attributes[ $name[2] ] ) { + $this->add_property( $property, $attributes[ $name[2] ] . $unit ); + } else if ( $defaults[2] ) { + $this->add_property( $property, $defaults[2] . $unit ); + } } $this->set_media_state( 'desktop' ); } @@ -1897,8 +2243,12 @@ public function render_flex_align( $attributes, $name = 'textAlign', $args = arr /** * Generates a border string for a single side at a single screen size. * - * @param array $border an array of border settings. - * @return string + * @since 3.3.2 + * + * @param array $border an array of border settings. + * @param string $side the border side to render (top, right, bottom, left). Default 'top'. + * + * @return string|false */ public function render_border( $border, $side = 'top' ) { if ( empty( $border ) || empty( $border[0] ) ) { @@ -1922,7 +2272,19 @@ public function render_border( $border, $side = 'top' ) { $width = ( isset( $border_side[2] ) && ! empty( $border_side[2] ) ? $border_side[2] : '0' ); $unit = ( isset( $border[0]['unit'] ) && ! empty( $border[0]['unit'] ) ? $border[0]['unit'] : 'px' ); $color = ( isset( $border_side[0] ) && ! empty( $border_side[0] ) ? $border_side[0] : 'transparent' ); - $border_string = $width . $unit . ' ' . $style . ' ' . $this->render_color( $color ); + + // A token-reference width resolves to a self-contained var() (unit included), so the literal unit is dropped. + $width_reference = $this->get_backed_token_reference( $width ); + $width_output = null !== $width_reference ? $width_reference : $width . $unit; + $color_output = $this->render_color( $color ); + + // A strict alias width or color that did not resolve invalidates the whole shorthand; emit nothing + // so the border falls back to the global CSS. + if ( ( Alias::is_alias( $width ) && null === $width_reference ) || false === $color_output ) { + return false; + } + + $border_string = $width_output . ' ' . $style . ' ' . $color_output; return $border_string; } @@ -2005,7 +2367,7 @@ public function render_border_styles( $attributes, $name = 'borderStyle', $singl * @param array $args an array of settings. * @param string $given_side the side to retrieve a value for (desktop, tablet, mobile). * @param string $given_size the size to retrieve a value for (top, right, bottom, left). - * @param string $given_value the name of the value to retreive (color, style, width). + * @param string $given_value the name of the value to retrieve (color, style, width). * @param string $single_styles if this value is being calculated to be output alone. * @return string */ @@ -2096,7 +2458,12 @@ public function get_border_value( $attributes, $args, $given_side, $given_size, $return_value = $this->sanitize_color($return_value); } if( $given_value == 'width') { - $return_value = $this->is_number($return_value) ? $return_value . $return_unit : ''; + $width_reference = $this->get_backed_token_reference( $return_value ); + if ( null !== $width_reference ) { + $return_value = $width_reference; + } else { + $return_value = $this->is_number($return_value) ? $return_value . $return_unit : ''; + } } return $return_value; @@ -2205,12 +2572,41 @@ public function render_button_styles_with_states( $args, $attributes ) { } } + /** + * Adds one side of a measure output, matching render_measure_output()'s per-side rules: a numeric + * value gets the shared unit, a `position` keyword is emitted verbatim, a design-token alias resolves + * to its `var(--kb-token--…)` reference, and a legacy spacing variable resolves to its stored size. + * An empty/unset value emits nothing. + * + * @since TBD + * + * @param string $prop The CSS property to write (e.g. `border-top-left-radius`). + * @param mixed $value The side's value: a number, a `position` keyword, a design-token alias, a + * legacy spacing variable, or empty. + * @param string $unit The unit appended to a numeric value. + * @param string $property The measure property being rendered, so `position` keywords pass through. + * + * @return void + */ + private function render_measure_side( $prop, $value, $unit, $property ) { + $token_reference = $this->get_backed_token_reference( $value ); + if ( $this->is_number( $value ) ) { + $this->add_property( $prop, $value . $unit ); + } else if ( 'position' === $property && ! empty( $value ) ) { + $this->add_property( $prop, $value ); + } else if ( ! empty( $value ) && null !== $token_reference ) { + $this->add_property( $prop, $token_reference ); + } else if ( ! empty( $value ) && $this->is_variable_value( $value ) ) { + $this->add_property( $prop, $this->get_variable_value( $value ) ); + } + } + /** * Generates the measure output. * * @param array $attributes an array of attributes. * @param string $name a string of the block attribute name. - * @param string $property a string of the css propery name. + * @param string $property a string of the css property name. * @param array $args an array of settings. * @return string */ @@ -2269,96 +2665,24 @@ public function render_measure_output( $attributes, $name = 'padding', $property $args = wp_parse_args( $args, $defaults ); $unit = ! empty( $attributes[ $args['unit_key'] ] ) ? $attributes[ $args['unit_key'] ] : 'px'; if ( isset( $attributes[ $args['desktop_key'] ] ) && is_array( $attributes[ $args['desktop_key'] ] ) ) { - if ( $this->is_number( $attributes[ $args['desktop_key'] ][0] ) ) { - $this->add_property( $args['first_prop'], $attributes[ $args['desktop_key'] ][0] . $unit ); - } else if ( 'position' === $property && ! empty( $attributes[ $args['desktop_key'] ][0] ) ) { - $this->add_property( $args['first_prop'], $attributes[ $args['desktop_key'] ][0] ); - } else if ( ! empty( $attributes[ $args['desktop_key'] ][0] ) && $this->is_variable_value( $attributes[ $args['desktop_key'] ][0] ) ) { - $this->add_property( $args['first_prop'], $this->get_variable_value( $attributes[ $args['desktop_key'] ][0] ) ); - } - if ( isset( $attributes[ $args['desktop_key'] ][1] ) && is_numeric( $attributes[ $args['desktop_key'] ][1] ) ) { - $this->add_property( $args['second_prop'], $attributes[ $args['desktop_key'] ][1] . $unit ); - } else if ( 'position' === $property && isset( $attributes[ $args['desktop_key'] ][1] ) && ! empty( $attributes[ $args['desktop_key'] ][1] ) ) { - $this->add_property( $args['second_prop'], $attributes[ $args['desktop_key'] ][1] ); - } else if ( ! empty( $attributes[ $args['desktop_key'] ][1] ) && $this->is_variable_value( $attributes[ $args['desktop_key'] ][1] ) ) { - $this->add_property( $args['second_prop'], $this->get_variable_value( $attributes[ $args['desktop_key'] ][1] ) ); - } - if ( isset( $attributes[ $args['desktop_key'] ][2] ) && is_numeric( $attributes[ $args['desktop_key'] ][2] ) ) { - $this->add_property( $args['third_prop'], $attributes[ $args['desktop_key'] ][2] . $unit ); - } else if ( 'position' === $property && isset( $attributes[ $args['desktop_key'] ][2] ) && ! empty( $attributes[ $args['desktop_key'] ][2] ) ) { - $this->add_property( $args['third_prop'], $attributes[ $args['desktop_key'] ][2] ); - } else if ( ! empty( $attributes[ $args['desktop_key'] ][2] ) && $this->is_variable_value( $attributes[ $args['desktop_key'] ][2] ) ) { - $this->add_property( $args['third_prop'], $this->get_variable_value( $attributes[ $args['desktop_key'] ][2] ) ); - } - if ( isset( $attributes[ $args['desktop_key'] ][3] ) && is_numeric( $attributes[ $args['desktop_key'] ][3] ) ) { - $this->add_property( $args['fourth_prop'], $attributes[ $args['desktop_key'] ][3] . $unit ); - } else if ( 'position' === $property && isset( $attributes[ $args['desktop_key'] ][3] ) && ! empty( $attributes[ $args['desktop_key'] ][3] ) ) { - $this->add_property( $args['fourth_prop'], $attributes[ $args['desktop_key'] ][3] ); - } else if ( ! empty( $attributes[ $args['desktop_key'] ][3] ) && $this->is_variable_value( $attributes[ $args['desktop_key'] ][3] ) ) { - $this->add_property( $args['fourth_prop'], $this->get_variable_value( $attributes[ $args['desktop_key'] ][3] ) ); - } + $this->render_measure_side( $args['first_prop'], $attributes[ $args['desktop_key'] ][0] ?? null, $unit, $property ); + $this->render_measure_side( $args['second_prop'], $attributes[ $args['desktop_key'] ][1] ?? null, $unit, $property ); + $this->render_measure_side( $args['third_prop'], $attributes[ $args['desktop_key'] ][2] ?? null, $unit, $property ); + $this->render_measure_side( $args['fourth_prop'], $attributes[ $args['desktop_key'] ][3] ?? null, $unit, $property ); } $this->set_media_state( 'tablet' ); if ( isset( $attributes[ $args['tablet_key'] ] ) && is_array( $attributes[ $args['tablet_key'] ] ) ) { - if ( isset( $attributes[ $args['tablet_key'] ][0] ) && is_numeric( $attributes[ $args['tablet_key'] ][0] ) ) { - $this->add_property( $args['first_prop'], $attributes[ $args['tablet_key'] ][0] . $unit ); - } else if ( 'position' === $property && isset( $attributes[ $args['tablet_key'] ][0] ) && ! empty( $attributes[ $args['tablet_key'] ][0] ) ) { - $this->add_property( $args['first_prop'], $attributes[ $args['tablet_key'] ][0] ); - } else if ( ! empty( $attributes[ $args['tablet_key'] ][0] ) && $this->is_variable_value( $attributes[ $args['tablet_key'] ][0] ) ) { - $this->add_property( $args['first_prop'], $this->get_variable_value( $attributes[ $args['tablet_key'] ][0] ) ); - } - if ( isset( $attributes[ $args['tablet_key'] ][1] ) && is_numeric( $attributes[ $args['tablet_key'] ][1] ) ) { - $this->add_property( $args['second_prop'], $attributes[ $args['tablet_key'] ][1] . $unit ); - } else if ( 'position' === $property && isset( $attributes[ $args['tablet_key'] ][1] ) && ! empty( $attributes[ $args['tablet_key'] ][1] ) ) { - $this->add_property( $args['second_prop'], $attributes[ $args['tablet_key'] ][1] ); - } else if ( ! empty( $attributes[ $args['tablet_key'] ][1] ) && $this->is_variable_value( $attributes[ $args['tablet_key'] ][1] ) ) { - $this->add_property( $args['second_prop'], $this->get_variable_value( $attributes[ $args['tablet_key'] ][1] ) ); - } - if ( isset( $attributes[ $args['tablet_key'] ][2] ) && is_numeric( $attributes[ $args['tablet_key'] ][2] ) ) { - $this->add_property( $args['third_prop'], $attributes[ $args['tablet_key'] ][2] . $unit ); - } else if ( 'position' === $property && isset( $attributes[ $args['tablet_key'] ][2] ) && ! empty( $attributes[ $args['tablet_key'] ][2] ) ) { - $this->add_property( $args['third_prop'], $attributes[ $args['tablet_key'] ][2] ); - } else if ( ! empty( $attributes[ $args['tablet_key'] ][2] ) && $this->is_variable_value( $attributes[ $args['tablet_key'] ][2] ) ) { - $this->add_property( $args['third_prop'], $this->get_variable_value( $attributes[ $args['tablet_key'] ][2] ) ); - } - if ( isset( $attributes[ $args['tablet_key'] ][3] ) && is_numeric( $attributes[ $args['tablet_key'] ][3] ) ) { - $this->add_property( $args['fourth_prop'], $attributes[ $args['tablet_key'] ][3] . $unit ); - } else if ( 'position' === $property && isset( $attributes[ $args['tablet_key'] ][3] ) && ! empty( $attributes[ $args['tablet_key'] ][3] ) ) { - $this->add_property( $args['fourth_prop'], $attributes[ $args['tablet_key'] ][3] ); - } else if ( ! empty( $attributes[ $args['tablet_key'] ][3] ) && $this->is_variable_value( $attributes[ $args['tablet_key'] ][3] ) ) { - $this->add_property( $args['fourth_prop'], $this->get_variable_value( $attributes[ $args['tablet_key'] ][3] ) ); - } + $this->render_measure_side( $args['first_prop'], $attributes[ $args['tablet_key'] ][0] ?? null, $unit, $property ); + $this->render_measure_side( $args['second_prop'], $attributes[ $args['tablet_key'] ][1] ?? null, $unit, $property ); + $this->render_measure_side( $args['third_prop'], $attributes[ $args['tablet_key'] ][2] ?? null, $unit, $property ); + $this->render_measure_side( $args['fourth_prop'], $attributes[ $args['tablet_key'] ][3] ?? null, $unit, $property ); } $this->set_media_state( 'mobile' ); if ( isset( $attributes[ $args['mobile_key'] ] ) && is_array( $attributes[ $args['mobile_key'] ] ) ) { - if ( isset( $attributes[ $args['mobile_key'] ][0] ) && is_numeric( $attributes[ $args['mobile_key'] ][0] ) ) { - $this->add_property( $args['first_prop'], $attributes[ $args['mobile_key'] ][0] . $unit ); - } else if ( 'position' === $property && isset( $attributes[ $args['mobile_key'] ][0] ) && ! empty( $attributes[ $args['mobile_key'] ][0] ) ) { - $this->add_property( $args['first_prop'], $attributes[ $args['mobile_key'] ][0] ); - } else if ( ! empty( $attributes[ $args['mobile_key'] ][0] ) && $this->is_variable_value( $attributes[ $args['mobile_key'] ][0] ) ) { - $this->add_property( $args['first_prop'], $this->get_variable_value( $attributes[ $args['mobile_key'] ][0] ) ); - } - if ( isset( $attributes[ $args['mobile_key'] ][1] ) && is_numeric( $attributes[ $args['mobile_key'] ][1] ) ) { - $this->add_property( $args['second_prop'], $attributes[ $args['mobile_key'] ][1] . $unit ); - } else if ( 'position' === $property && isset( $attributes[ $args['mobile_key'] ][1] ) && ! empty( $attributes[ $args['mobile_key'] ][1] ) ) { - $this->add_property( $args['second_prop'], $attributes[ $args['mobile_key'] ][1] ); - } else if ( ! empty( $attributes[ $args['mobile_key'] ][1] ) && $this->is_variable_value( $attributes[ $args['mobile_key'] ][1] ) ) { - $this->add_property( $args['second_prop'], $this->get_variable_value( $attributes[ $args['mobile_key'] ][1] ) ); - } - if ( isset( $attributes[ $args['mobile_key'] ][2] ) && is_numeric( $attributes[ $args['mobile_key'] ][2] ) ) { - $this->add_property( $args['third_prop'], $attributes[ $args['mobile_key'] ][2] . $unit ); - } else if ( 'position' === $property && isset( $attributes[ $args['mobile_key'] ][2] ) && ! empty( $attributes[ $args['mobile_key'] ][2] ) ) { - $this->add_property( $args['third_prop'], $attributes[ $args['mobile_key'] ][2] ); - } else if ( ! empty( $attributes[ $args['mobile_key'] ][2] ) && $this->is_variable_value( $attributes[ $args['mobile_key'] ][2] ) ) { - $this->add_property( $args['third_prop'], $this->get_variable_value( $attributes[ $args['mobile_key'] ][2] ) ); - } - if ( isset( $attributes[ $args['mobile_key'] ][3] ) && is_numeric( $attributes[ $args['mobile_key'] ][3] ) ) { - $this->add_property( $args['fourth_prop'], $attributes[ $args['mobile_key'] ][3] . $unit ); - } else if ( 'position' === $property && isset( $attributes[ $args['mobile_key'] ][3] ) && ! empty( $attributes[ $args['mobile_key'] ][3] ) ) { - $this->add_property( $args['fourth_prop'], $attributes[ $args['mobile_key'] ][3] ); - } else if ( ! empty( $attributes[ $args['mobile_key'] ][3] ) && $this->is_variable_value( $attributes[ $args['mobile_key'] ][3] ) ) { - $this->add_property( $args['fourth_prop'], $this->get_variable_value( $attributes[ $args['mobile_key'] ][3] ) ); - } + $this->render_measure_side( $args['first_prop'], $attributes[ $args['mobile_key'] ][0] ?? null, $unit, $property ); + $this->render_measure_side( $args['second_prop'], $attributes[ $args['mobile_key'] ][1] ?? null, $unit, $property ); + $this->render_measure_side( $args['third_prop'], $attributes[ $args['mobile_key'] ][2] ?? null, $unit, $property ); + $this->render_measure_side( $args['fourth_prop'], $attributes[ $args['mobile_key'] ][3] ?? null, $unit, $property ); } $this->set_media_state( 'desktop' ); } @@ -2366,7 +2690,7 @@ public function render_measure_output( $attributes, $name = 'padding', $property * Generates the measure output. * * @param array $measure an array of font settings. - * @return string + * @return string|false */ public function render_measure( $measure, $unit = 'px' ) { if ( empty( $measure ) ) { @@ -2378,17 +2702,33 @@ public function render_measure( $measure, $unit = 'px' ) { if ( ! isset( $measure[0] ) ) { return false; } - if ( ! is_numeric( $measure[0] ) && ! is_numeric( $measure[1] ) && ! is_numeric( $measure[2] ) && ! is_numeric( $measure[3] ) ) { + $references = array( + $this->get_backed_token_reference( $measure[0] ), + $this->get_backed_token_reference( $measure[1] ?? null ), + $this->get_backed_token_reference( $measure[2] ?? null ), + $this->get_backed_token_reference( $measure[3] ?? null ), + ); + + // A strict alias side that did not resolve invalidates the whole value; emit nothing so the + // property falls back to the global CSS. + foreach ( array( $measure[0], $measure[1] ?? null, $measure[2] ?? null, $measure[3] ?? null ) as $index => $side ) { + if ( Alias::is_alias( $side ) && null === $references[ $index ] ) { + return false; + } + } + + $has_alias = null !== $references[0] || null !== $references[1] || null !== $references[2] || null !== $references[3]; + if ( ! $has_alias && ! is_numeric( $measure[0] ) && ! is_numeric( $measure[1] ) && ! is_numeric( $measure[2] ) && ! is_numeric( $measure[3] ) ) { return false; } - $size_string = ( is_numeric( $measure[0] ) ? $measure[0] : '0' ) . $unit . ' ' . ( is_numeric( $measure[1] ) ? $measure[1] : '0' ) . $unit . ' ' . ( is_numeric( $measure[2] ) ? $measure[2] : '0' ) . $unit . ' ' . ( is_numeric( $measure[3] ) ? $measure[3] : '0' ) . $unit; + $size_string = ( null !== $references[0] ? $references[0] : ( is_numeric( $measure[0] ) ? $measure[0] : '0' ) . $unit ) . ' ' . ( null !== $references[1] ? $references[1] : ( is_numeric( $measure[1] ) ? $measure[1] : '0' ) . $unit ) . ' ' . ( null !== $references[2] ? $references[2] : ( is_numeric( $measure[2] ) ? $measure[2] : '0' ) . $unit ) . ' ' . ( null !== $references[3] ? $references[3] : ( is_numeric( $measure[3] ) ? $measure[3] : '0' ) . $unit ); return $size_string; } /** * Generates the opacity css output. * - * @param array $attributes an array of attributes. - * @param null|integer $name name of opacity attribute. + * @param array $attributes an array of attributes. + * @param string|null $name name of opacity attribute. */ public function render_opacity_from_100( $attributes, $name = null ) { if ( ! isset( $attributes[ $name ] ) || ! $this->is_number( $attributes[ $name ] ) ) { @@ -2917,5 +3257,37 @@ public function get_sized_attributes_auto( $attributes, $size = 'Desktop', $inhe return $sized_array; } + + /** + * Fill any empty or missing shadow leg with the caller's legacy default so render_shadow() + * can emit a complete declaration. + * + * Numeric and {alias} values pass through untouched so they still resolve to `px` or + * `var(--kb-token--...)`. Only a genuinely empty (`''`/missing) leg is replaced with the + * supplied default, matching the historic per-site `is_numeric( $value ) ? $value : $default` + * inline behavior. + * + * @since TBD + * + * @param array $shadow The stored shadow parts (may be partial). + * @param array $defaults Per-caller fallback literals for empty legs. + * + * @return array The complete keyed array. + */ + private function normalize_shadow_defaults( array $shadow, array $defaults ): array { + $pick = static function ( $value, $fallback ) { + return ( isset( $value ) && '' !== $value ) ? $value : $fallback; + }; + + return [ + 'hOffset' => $pick( $shadow['hOffset'] ?? null, $defaults['hOffset'] ), + 'vOffset' => $pick( $shadow['vOffset'] ?? null, $defaults['vOffset'] ), + 'blur' => $pick( $shadow['blur'] ?? null, $defaults['blur'] ), + 'spread' => $pick( $shadow['spread'] ?? null, $defaults['spread'] ), + 'color' => $pick( $shadow['color'] ?? null, $defaults['color'] ), + 'opacity' => ( isset( $shadow['opacity'] ) && is_numeric( $shadow['opacity'] ) ) ? $shadow['opacity'] : $defaults['opacity'], + 'inset' => ! empty( $shadow['inset'] ), + ]; + } } Kadence_Blocks_CSS::get_instance(); diff --git a/includes/class-kadence-blocks-editor-assets.php b/includes/class-kadence-blocks-editor-assets.php index bb48071579..8eb99c93b6 100644 --- a/includes/class-kadence-blocks-editor-assets.php +++ b/includes/class-kadence-blocks-editor-assets.php @@ -303,14 +303,10 @@ public function editor_assets_variables() { ]; } $global_colors = apply_filters( 'kadence_blocks_pattern_global_colors', $global_colors ); - $font_sizes = [ - 'sm' => 'clamp(0.8rem, 0.73rem + 0.217vw, 0.9rem)', - 'md' => 'clamp(1.1rem, 0.995rem + 0.326vw, 1.25rem)', - 'lg' => 'clamp(1.75rem, 1.576rem + 0.543vw, 2rem)', - 'xl' => 'clamp(2.25rem, 1.728rem + 1.63vw, 3rem)', - 'xxl' => 'clamp(2.5rem, 1.456rem + 3.26vw, 4rem)', - 'xxxl' => 'clamp(2.75rem, 0.489rem + 7.065vw, 6rem)', - ]; + // The fluid font-size scale is owned by the design-tokens baseline; retrieve it so the shipped + // clamp() values are not duplicated here. Empty when token projection is unavailable. + $font_sizes = kadence_blocks_variable_font_size_scale(); + $pro_data = $this->get_pro_data(); $is_authorized = ! kadence_blocks_is_ai_disabled() && kadence_blocks_is_legacy_license_authorized(); $font_sizes = apply_filters( 'kadence_blocks_variable_font_sizes', $font_sizes ); @@ -466,6 +462,9 @@ public function editor_plugin_enqueue() { $asset_meta = kadence_blocks_get_asset_file( 'dist/early-filters' ); wp_enqueue_script( 'kadence-blocks-early-filters-js', KADENCE_BLOCKS_URL . 'dist/early-filters.js', array_merge( $asset_meta['dependencies'], [ 'wp-blocks', 'wp-i18n', 'wp-element' ] ), $asset_meta['version'], true ); + // Styles bundled into the early-filters entry (e.g. the design-token control UI injected through + // the shared control seams). Loaded after the components styles so it can match/override them. + wp_enqueue_style( 'kadence-blocks-early-filters-css', KADENCE_BLOCKS_URL . 'dist/early-filters.css', [ 'wp-edit-blocks', 'kadence-components' ], $asset_meta['version'] ); } /** * Get an array font weight options. diff --git a/includes/init.php b/includes/init.php index 9635780af6..4c7b33a310 100644 --- a/includes/init.php +++ b/includes/init.php @@ -6,6 +6,8 @@ * @package Kadence Blocks */ +// cspell:ignore editorwidth yourtheme iconset wpmlcore getresponse lotte Sashicons . + // Exit if accessed directly. if ( ! defined( 'ABSPATH' ) ) { exit; @@ -98,14 +100,9 @@ function kadence_blocks_post_block_get_excerpt_length() { */ function kadence_blocks_add_global_gutenberg_inline_styles() { global $content_width; - $font_sizes = array( - 'sm' => 'clamp(0.8rem, 0.73rem + 0.217vw, 0.9rem)', - 'md' => 'clamp(1.1rem, 0.995rem + 0.326vw, 1.25rem)', - 'lg' => 'clamp(1.75rem, 1.576rem + 0.543vw, 2rem)', - 'xl' => 'clamp(2.25rem, 1.728rem + 1.63vw, 3rem)', - 'xxl' => 'clamp(2.5rem, 1.456rem + 3.26vw, 4rem)', - 'xxxl' => 'clamp(2.75rem, 0.489rem + 7.065vw, 6rem)', - ); + // The fluid font-size scale is owned by the design-tokens baseline; retrieve it so the shipped clamp() + // values are not duplicated here. Empty when token projection is unavailable, leaving the filter intact. + $font_sizes = kadence_blocks_variable_font_size_scale(); $font_sizes = apply_filters( 'kadence_blocks_variable_font_sizes', $font_sizes ); $css = ':root {'; foreach ( $font_sizes as $key => $value ) { @@ -133,17 +130,14 @@ function kadence_blocks_add_global_gutenberg_inline_styles() { }'; $css .= '.kb-header-container { --global-content-width: var(--wp--style--global--wide-size, var(--wp--style--global--content-size)) }'; } - $css .= ':root { - --global-kb-spacing-xxs: 0.5rem; - --global-kb-spacing-xs: 1rem; - --global-kb-spacing-sm: 1.5rem; - --global-kb-spacing-md: 2rem; - --global-kb-spacing-lg: 3rem; - --global-kb-spacing-xl: 4rem; - --global-kb-spacing-xxl: 5rem; - --global-kb-spacing-3xl: 6.5rem; - --global-kb-spacing-4xl: 8rem; - --global-kb-spacing-5xl: 10rem; + // The spacing scale is owned by the design-tokens baseline; retrieve it so the shipped literals are not + // duplicated here. Empty when token projection is unavailable, leaving blocks on their own + // var(--global-kb-spacing-*, ) fallbacks. + $spacing_css = ''; + foreach ( kadence_blocks_variable_spacing_scale() as $spacing_slug => $spacing_value ) { + $spacing_css .= '--global-kb-spacing-' . $spacing_slug . ':' . $spacing_value . ';'; + } + $css .= ':root {' . $spacing_css . ' --global-row-edge-sm: 15px; --global-row-edge-theme: var(--global-content-edge-padding); --global-kb-gutter-sm: 1rem; @@ -217,14 +211,9 @@ function kadence_blocks_update_global_gutenberg_inline_styles_dependencies() { * Add global styles into the frontend. */ function kadence_blocks_add_global_gutenberg_styles_frontend() { - $font_sizes = array( - 'sm' => 'clamp(0.8rem, 0.73rem + 0.217vw, 0.9rem)', - 'md' => 'clamp(1.1rem, 0.995rem + 0.326vw, 1.25rem)', - 'lg' => 'clamp(1.75rem, 1.576rem + 0.543vw, 2rem)', - 'xl' => 'clamp(2.25rem, 1.728rem + 1.63vw, 3rem)', - 'xxl' => 'clamp(2.5rem, 1.456rem + 3.26vw, 4rem)', - 'xxxl' => 'clamp(2.75rem, 0.489rem + 7.065vw, 6rem)', - ); + // The fluid font-size scale is owned by the design-tokens baseline; retrieve it so the shipped clamp() + // values are not duplicated here. Empty when token projection is unavailable, leaving the filter intact. + $font_sizes = kadence_blocks_variable_font_size_scale(); $font_sizes = apply_filters( 'kadence_blocks_variable_font_sizes', $font_sizes ); $css = ':root {'; foreach ( $font_sizes as $key => $value ) { diff --git a/includes/resources/App.php b/includes/resources/App.php index 91cc30cfe2..970a3b965e 100644 --- a/includes/resources/App.php +++ b/includes/resources/App.php @@ -1,4 +1,5 @@ registry = $registry; + $this->preset_nav = $preset_nav; + $this->sorter = $sorter; + } + + /** + * Shape the localized payload from the pre-gathered values, presets, REST descriptor and version. + * + * @since TBD + * + * @param array $values id => resolved value (by_id), or [] when unresolved. + * @param bool $resolved Whether resolution succeeded. + * @param array $presets Per-block preset structure + values. + * @param array{root: string, namespace: string, nonce: string} $rest REST root, namespace and nonce. + * @param string $version Store version hash ('' from baseline). + * @param string $slug The token library slug the values/version/schema were resolved against. + * @param string $title The library's display title, already defaulted for an untitled + * default library. Carried here so the admin page can name the + * library on first paint, without waiting on the separate libraries + * request and visibly correcting itself once that arrives. + * @param array> $responsive id => raw authored responsive / clamp shape, for + * tokens that carry one (for editor hydration). + * @param array $labels id => display-label override for this library. + * @param array $order The flat ordered token id list for this library. + * @param array $favorite_fonts The ordered favorite font families for this library. + * + * @return array The localized payload. + */ + public function build( array $values, bool $resolved, array $presets, array $rest, string $version, string $slug, string $title = '', array $responsive = [], array $labels = [], array $order = [], array $favorite_fonts = [] ): array { + $active = $this->registry->is_active(); + + return [ + 'active' => $active, + 'resolved' => $active && $resolved, + 'version' => $version, + 'slug' => $slug, + // Carried alongside the slug so the library selector can name the active library on first + // paint, before its REST list has loaded and any row is available to look the title up in. + 'title' => $title, + 'schema' => $active + ? $this->apply_group_order( $this->apply_label_overrides( $this->registry->to_ui_schema(), $labels ), $order ) + : [ 'groups' => [] ], + 'values' => $active ? $values : [], + 'presets' => $active ? $presets : [], + 'presetNav' => $active ? $this->preset_nav->all() : [], + 'responsive' => $active ? $responsive : [], + // Alongside the schema rather than inside it: a favorite is not a token, so it has no + // row in any UI-schema group. The Typography screen's font picker reads this list + // directly and pins those families above the catalog. + 'favoriteFonts' => $active ? $favorite_fonts : [], + 'rest' => $rest, + ]; + } + + /** + * Overlay per-library display-label overrides onto the registry's UI schema. Every token row + * gains a `labelOverridden` flag (stable shape whether or not any override exists) so the + * admin UI can offer a reset affordance and distinguish a custom name from a declared one; an + * override for an id the schema does not contain is ignored (stale data, pruned by the write + * surface on its next save of that id). + * + * @since TBD + * + * @param array{groups: array>>} $schema The registry UI schema. + * @param array $labels id => override label. + * + * @return array{groups: array>>} The schema with effective labels applied. + */ + private function apply_label_overrides( array $schema, array $labels ): array { + foreach ( $schema['groups'] as $group => $rows ) { + foreach ( $rows as $i => $row ) { + $override = $labels[ $row['id'] ] ?? null; + + $schema['groups'][ $group ][ $i ]['label'] = $override ?? $row['label']; + $schema['groups'][ $group ][ $i ]['labelOverridden'] = $override !== null; + } + } + + return $schema; + } + + /** + * Permute every schema group by the stored flat order, one group at a time through the shared + * {@see Token_Sorter} — the same permutation the editor's pickable-token pool applies, so the + * picker and this screen can never disagree about where a token sits. Per its contract: listed + * ids first by position, unmentioned ids appended in declaration order (never hidden), an empty + * stored order returning the schema untouched. + * + * @since TBD + * + * @param array{groups: array>>} $schema The (label-overlaid) UI schema. + * @param array $order The flat ordered token id list. + * + * @return array{groups: array>>} The schema with groups permuted. + */ + private function apply_group_order( array $schema, array $order ): array { + if ( $order === [] ) { + return $schema; + } + + foreach ( $schema['groups'] as $group => $rows ) { + $schema['groups'][ $group ] = $this->sorter->sort( $rows, $order ); + } + + return $schema; + } +} diff --git a/includes/resources/Design_Tokens/Admin/Feed/Feed_Assembler.php b/includes/resources/Design_Tokens/Admin/Feed/Feed_Assembler.php new file mode 100644 index 0000000000..3f81402f5e --- /dev/null +++ b/includes/resources/Design_Tokens/Admin/Feed/Feed_Assembler.php @@ -0,0 +1,221 @@ +resolver = $resolver; + $this->store = $store; + $this->preset_feed = $preset_feed; + $this->builder = $builder; + $this->responsive_feed = $responsive_feed; + $this->label_index = $label_index; + $this->order_index = $order_index; + $this->favorite_font_index = $favorite_font_index; + } + + /** + * Assemble the full feed payload for one token library. + * + * @since TBD + * + * @param string $slug The token library slug to assemble the feed for. + * + * @return array The feed payload, shaped identically for every caller. + */ + public function for_slug( string $slug ): array { + $version = $this->store->get_version( $slug ); + $values = []; + $presets = []; + $responsive = []; + $resolved = false; + + try { + $values = $this->resolver->resolve( $slug )->by_id(); + $presets = $this->preset_feed->all( $slug ); + $responsive = $this->responsive_feed->from_document( $this->resolver->effective_document( $slug ) ); + $resolved = true; + } catch ( Alias_Cycle_Exception | Dangling_Alias_Exception $e ) { + $resolved = false; // Corrupt stored document. Fail open: ship structure only. + } + + $document = $this->store->get_decoded_document( $slug ); + + return $this->builder->build( + $values, + $resolved, + $presets, + $this->rest(), + $version, + $slug, + $this->title( $slug ), + $responsive, + $this->label_index->all( $document ), + $this->order_index->all( $document ), + $this->favorite_font_index->all( $document ) + ); + } + + /** + * The active library's display title, defaulted the same way the REST representation defaults it, so + * the name the selector paints on load matches the one its list supplies a moment later. + * + * @since TBD + * + * @param string $slug The token library slug. + * + * @return string + */ + private function title( string $slug ): string { + $stored = $this->store->get_title( $slug ); + + if ( '' !== $stored ) { + return $stored; + } + + return $slug === Token_Store::default_slug() ? Token_Store::default_title() : ''; + } + + /** + * The REST descriptor a client uses to write back to the library it just read: the wp-json + * root, the v1 namespace, and a wp_rest nonce (sent as X-WP-Nonce; the REST permission-check + * still re-validates capability). + * + * @since TBD + * + * @return array{root: string, namespace: string, nonce: string} + */ + private function rest(): array { + return [ + 'root' => esc_url_raw( rest_url() ), + 'namespace' => Controller::namespace(), + 'nonce' => wp_create_nonce( 'wp_rest' ), + ]; + } +} diff --git a/includes/resources/Design_Tokens/Admin/Feed/Font_Catalog.php b/includes/resources/Design_Tokens/Admin/Feed/Font_Catalog.php new file mode 100644 index 0000000000..a710310a5b --- /dev/null +++ b/includes/resources/Design_Tokens/Admin/Feed/Font_Catalog.php @@ -0,0 +1,227 @@ +} + */ + public function all(): array { + $google = $this->google_names(); + $custom = array_values( array_diff( $this->custom_names(), $google ) ); + + return [ + 'google' => $google, + 'custom' => $custom, + 'weights' => $this->google_weights(), + ]; + } + + /** + * The weights each Google family ships, keyed by family name. + * + * Normalized to numeric strings: the generated file spells the default weight `regular`, which is + * `400` everywhere a CSS `font-weight` is written, and leaving both spellings in would make a + * consumer match two things for one weight. Sorted numerically so a picker lists them in weight + * order rather than the file's own. + * + * Fail-soft to an empty map when the generated file is absent, the same posture google_names() + * takes for its own file. + * + * @since TBD + * + * @return array + */ + private function google_weights(): array { + $path = KADENCE_BLOCKS_PATH . self::DETAILS_FILE; + + if ( ! file_exists( $path ) ) { + return []; + } + + $fonts = include $path; + + if ( ! is_array( $fonts ) ) { + return []; + } + + $weights = []; + + foreach ( $fonts as $family => $details ) { + if ( ! is_string( $family ) || ! is_array( $details ) || ! isset( $details['w'] ) || ! is_array( $details['w'] ) ) { + continue; + } + + $family_weights = []; + + foreach ( $details['w'] as $weight ) { + if ( ! is_string( $weight ) && ! is_int( $weight ) ) { + continue; + } + + $weight = 'regular' === $weight ? '400' : (string) $weight; + + // An italic-only entry ("700italic") names a weight already listed in its own right, so + // it would duplicate rather than add one. + if ( ! preg_match( '/^\d+$/', $weight ) ) { + continue; + } + + $family_weights[] = $weight; + } + + if ( $family_weights === [] ) { + continue; + } + + // Deduplicated by VALUE, not by key: PHP converts a numeric-string array key to an integer, so + // keying on the weight would hand back `400` where every consumer compares against `'400'`. + $family_weights = array_values( array_unique( $family_weights ) ); + sort( $family_weights, SORT_NUMERIC ); + + $weights[ $family ] = $family_weights; + } + + return $weights; + } + + /** + * The Google font names, fail-soft to an empty list when the generated file is absent — the + * same posture class-kadence-blocks-editor-assets.php already takes for the same file. + * + * @since TBD + * + * @return string[] + */ + private function google_names(): array { + $path = KADENCE_BLOCKS_PATH . self::NAMES_FILE; + + if ( ! file_exists( $path ) ) { + return []; + } + + $names = include $path; + + return is_array( $names ) ? array_values( array_filter( $names, 'is_string' ) ) : []; + } + + /** + * The site's custom font names, normalized from the custom-fonts filter's associative shape. + * + * @since TBD + * + * @return string[] + */ + private function custom_names(): array { + /** + * Filters the site-registered custom fonts, the same list the block editor localizes as + * c_fonts. Each entry is keyed by the font's family name or by a whole font-stack + * expression (`"My Font", sans-serif`, the shape kadence_blocks_convert_custom_fonts() + * builds when a fallback is registered); an integer-keyed string entry is a plain name. + * + * @since TBD + * + * @param array $fonts The registered custom fonts. + * + * @return array The registered custom fonts. + */ + $fonts = apply_filters( self::CUSTOM_FONTS_FILTER, [] ); + + if ( ! is_array( $fonts ) ) { + return []; + } + + $names = []; + + foreach ( $fonts as $key => $value ) { + $name = is_string( $key ) ? $this->family_of( $key ) : ( is_string( $value ) ? $this->family_of( $value ) : '' ); + + if ( $name !== '' ) { + $names[] = $name; + } + } + + return $names; + } + + /** + * The family name a catalog entry names, taken from a font-stack expression when it carries + * one: the first family, with its surrounding quotes removed. + * + * A registered fallback puts the whole stack in the key (`"My Font", sans-serif`). Catalogued + * verbatim, that string becomes the picked font's `$value`, which Css_Renderer quotes as one + * family — `font-family: "\"My Font\", sans-serif"`, invalid — and never matches its own + * Google entry when the two lists are deduplicated. The family alone is what both need. The + * fallback is deliberately not carried into the token: a font primitive is minted as a + * single-family stack, the same rule that keeps a generic fallback from being invented for a + * Google family. + * + * @since TBD + * + * @param string $entry The catalog entry, a family name or a font-stack expression. + * + * @return string The family name, or "" when the entry names none. + */ + private function family_of( string $entry ): string { + $first = explode( ',', $entry )[0]; + + return trim( $first, " \t\n\r\0\x0B\"'" ); + } +} diff --git a/includes/resources/Design_Tokens/Admin/Feed/Localizer.php b/includes/resources/Design_Tokens/Admin/Feed/Localizer.php new file mode 100644 index 0000000000..7e6bd7da80 --- /dev/null +++ b/includes/resources/Design_Tokens/Admin/Feed/Localizer.php @@ -0,0 +1,200 @@ +active = $active; + $this->assembler = $assembler; + $this->catalog = $catalog; + } + + /** + * Attach the feed to the dashboard bundle, when that bundle is on the page. + * + * @since TBD + * + * @return void + */ + public function localize(): void { + $handle = $this->resolve_handle(); + + if ( $handle === null ) { + return; // No supported admin bundle on this screen. + } + + // The active library, not always Token_Store::default_slug() — the registry's user primitives and + // every projector already resolve against whichever library is active, so the dashboard must read + // (and, via the REST descriptor's slug, write) the same library or edits land in a document that + // is not the one being displayed. + $slug = $this->active->get(); + $feed = $this->assembler->for_slug( $slug ); + $json = wp_json_encode( + $feed, + JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT + ); + + if ( $json === false ) { + return; // Feed cannot be serialized — skip rather than inject malformed JS. + } + + wp_add_inline_script( + $handle, + 'window.' . self::OBJECT . ' = ' . $json . ';', + 'before' + ); + + $this->localize_catalog( $handle ); + } + + /** + * Attach the font catalog to the same handle, as its own inline global — built once per + * page load, never rebuilt when the feed refreshes after a write. + * + * @since TBD + * + * @param string $handle The script handle the feed was just attached to. + * + * @return void + */ + private function localize_catalog( string $handle ): void { + $json = wp_json_encode( + $this->catalog->all(), + JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT + ); + + if ( $json === false ) { + return; // Catalog cannot be serialized — skip rather than inject malformed JS. + } + + wp_add_inline_script( + $handle, + 'window.' . self::CATALOG_OBJECT . ' = ' . $json . ';', + 'before' + ); + } + + /** + * The first supported script handle enqueued on the current screen. + * + * @since TBD + * + * @return string|null + */ + private function resolve_handle(): ?string { + foreach ( $this->handles() as $handle ) { + if ( wp_script_is( $handle, 'enqueued' ) ) { + return $handle; + } + } + + return null; + } +} diff --git a/includes/resources/Design_Tokens/Admin/Feed/Preset_Nav.php b/includes/resources/Design_Tokens/Admin/Feed/Preset_Nav.php new file mode 100644 index 0000000000..57baa6b8cc --- /dev/null +++ b/includes/resources/Design_Tokens/Admin/Feed/Preset_Nav.php @@ -0,0 +1,121 @@ +registry = $registry; + } + + /** + * Build the ordered nav entries: labeled (picker-driven) binding sets only. + * + * Order: registration order (the registry preserves it), which puts first-party blocks + * before any third-party registrations. Membership is governed solely by + * {@see Preset_Bindings::$label} being non-null — the Style Library section below only + * changes how an included entry is labeled, never whether it is included. + * + * @since TBD + * + * @return array The entries. + */ + public function all(): array { + $entries = []; + + foreach ( $this->registry->all_preset_bindings() as $block => $bindings ) { + if ( $bindings->label === null ) { + continue; // Default-look-only — no user-facing preset concept, so no nav entry. + } + + $entries[] = [ + 'block' => $block, + 'label' => $this->label_for( $block, $bindings ), + ]; + } + + return $entries; + } + + /** + * Resolve the DISPLAY label for a nav entry, tried in order: + * + * 1. The declared Style Library section's label ({@see Preset_Bindings::style_library_label()}) — + * the documented opt-in for a block-specific nav label. + * 2. The block's registered title, read from {@see WP_Block_Type_Registry} — the same name + * shown for the block everywhere else in the editor. + * 3. A humanized form of the block name (e.g. "kadence/my-block" -> "My Block") when the block + * is not registered at all — degrades gracefully rather than showing a raw block name or the + * picker control's `$label`. + * + * @since TBD + * + * @param string $block The block name. + * @param Preset_Bindings $bindings The block's preset bindings. + * + * @return string The resolved display label. + */ + private function label_for( string $block, Preset_Bindings $bindings ): string { + $declared = $bindings->style_library_label(); + + if ( $declared !== null ) { + return $declared; + } + + $type = WP_Block_Type_Registry::get_instance()->get_registered( $block ); + + if ( $type !== null && is_string( $type->title ) && $type->title !== '' ) { + return $type->title; + } + + return self::humanize( $block ); + } + + /** + * Humanize a block name into a readable label: the part after the last "/", with hyphens and + * underscores turned into spaces and each word capitalized (e.g. "kadence/my-block" -> + * "My Block"). + * + * @since TBD + * + * @param string $block The block name. + * + * @return string The humanized label. + */ + private static function humanize( string $block ): string { + $slug = strrchr( $block, '/' ); + $slug = $slug === false ? $block : substr( $slug, 1 ); + + return ucwords( str_replace( [ '-', '_' ], ' ', $slug ) ); + } +} diff --git a/includes/resources/Design_Tokens/Admin/Feed/Presets.php b/includes/resources/Design_Tokens/Admin/Feed/Presets.php new file mode 100644 index 0000000000..ce6dd3c07e --- /dev/null +++ b/includes/resources/Design_Tokens/Admin/Feed/Presets.php @@ -0,0 +1,106 @@ +registry = $registry; + $this->presets = $presets; + } + + /** + * The presets section, keyed by block name. + * + * @since TBD + * + * @param string $slug The token library whose values preset aliases resolve against. + * + * @return array> block => { bindings, default, names, properties, values, + * label? }. + */ + public function all( string $slug = 'default' ): array { + $out = []; + + foreach ( $this->registry->all_preset_bindings() as $block => $bindings ) { + try { + $names = $this->presets->names( $block, $slug ); + $default = $this->presets->default_preset( $block, $slug ); + } catch ( Unknown_Preset_Exception $e ) { + continue; // Set registered but not defined in the document — skip, fail soft. + } + + $values = []; + + foreach ( $names as $preset ) { + try { + // Literal values: the editor renders each as a swatch, which a var() chain can't paint. + $values[ $preset ] = $this->presets->resolve_literal( $block, $preset, $slug ); + } catch ( Unknown_Preset_Exception $e ) { + continue; // Omit a single unresolvable preset; keep the rest. + } + } + + $entry = array_merge( + $bindings->to_ui_schema(), + [ + 'default' => $default, + 'names' => $names, + 'properties' => array_keys( $bindings->bindings ), + 'values' => $values, + ] + ); + + if ( $bindings->label !== null ) { + $entry['label'] = $bindings->label; + } + + $out[ $block ] = $entry; + } + + return $out; + } +} diff --git a/includes/resources/Design_Tokens/Admin/Feed/Responsive_Feed.php b/includes/resources/Design_Tokens/Admin/Feed/Responsive_Feed.php new file mode 100644 index 0000000000..5b8605ac00 --- /dev/null +++ b/includes/resources/Design_Tokens/Admin/Feed/Responsive_Feed.php @@ -0,0 +1,122 @@ + { "base": "1.125rem", "responsive": { "tablet": "…", "mobile": "…" } } + * "semantic.font-size.control" => { "base": "clamp(…)", "clamp": { "min": "…", "preferred": "…", "max": "…" } } + * + * A flat token is absent, so the editor falls back to the flat value for its desktop input. Values are the + * raw authored strings (an alias slot stays a "{dot.path}" reference); the editor shows what was authored. + * Pure: no WordPress calls, no globals, no I/O. + * + * @since TBD + */ +final class Responsive_Feed { + + /** + * Build the id => authored-shape map for every responsive-capable leaf that carries a responsive or + * clamp shape. + * + * @since TBD + * + * @param array $document The effective (baseline-merged) DTCG document. + * + * @return array> + */ + public function from_document( array $document ): array { + $out = []; + $this->walk( $document, '', $out ); + + return $out; + } + + /** + * Depth-first walk collecting the authored shape of each responsive-capable leaf. + * + * @since TBD + * + * @param array $node The current node. + * @param string $prefix The dot-path accumulated so far. + * @param array> $out By-reference id => authored-shape map. + * + * @return void + */ + private function walk( array $node, string $prefix, array &$out ): void { + foreach ( $node as $key => $child ) { + if ( ! is_string( $key ) || strncmp( $key, '$', 1 ) === 0 || ! is_array( $child ) ) { + continue; + } + + $path = $prefix === '' ? $key : $prefix . '.' . $key; + + if ( ! array_key_exists( Sentinels::get_value_key(), $child ) ) { + $this->walk( $child, $path, $out ); + + continue; + } + + $type = $child[ Token_Type::get_type_key() ] ?? ''; + + if ( ! is_string( $type ) || ! Responsive::is_responsive_capable( $type ) ) { + continue; + } + + $entry = $this->authored_shape( $child ); + + if ( $entry !== [] ) { + $out[ $path ] = $entry; + } + } + } + + /** + * The authored responsive / clamp shape for a leaf, or an empty array when it is flat. Base is the raw + * scalar $value; responsive and clamp are the raw authored maps. + * + * @since TBD + * + * @param array $leaf The decoded leaf. + * + * @return array + */ + private function authored_shape( array $leaf ): array { + $base = $leaf[ Sentinels::get_value_key() ] ?? null; + + if ( Responsive::has_responsive( $leaf ) ) { + $responsive = Responsive::responsive_of( $leaf ); + + if ( is_array( $responsive ) ) { + return [ + 'base' => $base, + 'responsive' => $responsive, + ]; + } + } + + if ( Responsive::has_clamp( $leaf ) ) { + $clamp = Responsive::clamp_of( $leaf ); + + if ( is_array( $clamp ) ) { + return [ + 'base' => $base, + 'clamp' => $clamp, + ]; + } + } + + return []; + } +} diff --git a/includes/resources/Design_Tokens/Admin/Provider.php b/includes/resources/Design_Tokens/Admin/Provider.php new file mode 100644 index 0000000000..f45508555c --- /dev/null +++ b/includes/resources/Design_Tokens/Admin/Provider.php @@ -0,0 +1,49 @@ +container->singleton( Builder::class ); + $this->container->singleton( Presets::class ); + $this->container->singleton( Preset_Nav::class ); + $this->container->singleton( Feed_Assembler::class ); + $this->container->singleton( Font_Catalog::class ); + $this->container->singleton( Localizer::class ); + $this->container->singleton( Screen::class ); + $this->container->singleton( Asset_Loader::class ); + $this->container->singleton( Menu::class ); + + // Register after Kadence_Blocks_Settings::add_menu() so the kadence-blocks parent exists. + add_action( 'admin_menu', $this->container->callback( Menu::class, 'register_site_menu' ), 20 ); + add_action( 'network_admin_menu', $this->container->callback( Menu::class, 'register_network_menu' ), 20 ); + + // admin_head fires after the dashboard's admin_print_styles-{page} enqueue and before the footer + // where admin-kadence-home prints, so the handle is enqueued when the Localizer's guard runs. + add_action( 'admin_head', $this->container->callback( Localizer::class, 'localize' ) ); + } +} diff --git a/includes/resources/Design_Tokens/Admin/Style_Library/Asset_Loader.php b/includes/resources/Design_Tokens/Admin/Style_Library/Asset_Loader.php new file mode 100644 index 0000000000..25795bd20e --- /dev/null +++ b/includes/resources/Design_Tokens/Admin/Style_Library/Asset_Loader.php @@ -0,0 +1,109 @@ +asset = $asset; + } + + /** + * The script handle for the Style Library bundle. + * + * @since TBD + * + * @return string + */ + public static function get_script_handle(): string { + return self::SCRIPT_HANDLE; + } + + /** + * Enqueue the Style Library scripts and styles. + * + * @since TBD + * + * @return void + */ + public function enqueue(): void { + wp_enqueue_style( + 'kadence-blocks-admin-css', + $this->asset->get_url( 'includes/assets/css/admin-dashboard.min.css' ), + [ 'wp-jquery-ui-dialog', 'wp-color-picker' ], + KADENCE_BLOCKS_VERSION, + 'all' + ); + + $meta = $this->asset->get_meta( self::SCRIPT_PATH ); + + wp_enqueue_script( + self::SCRIPT_HANDLE, + $this->asset->get_url( self::SCRIPT_PATH . '.js' ), + $meta['dependencies'] ?? [], + $meta['version'] ?? KADENCE_BLOCKS_VERSION, + true + ); + + wp_enqueue_style( + self::SCRIPT_HANDLE, + $this->asset->get_url( self::SCRIPT_PATH . '.css' ), + // 'dashicons' is declared explicitly — the breakpoint switcher's glyphs need it enqueued, + // not just coincidentally present from elsewhere in wp-admin. + [ 'wp-components', 'dashicons' ], + $meta['version'] ?? KADENCE_BLOCKS_VERSION, + 'all' + ); + + wp_localize_script( + self::SCRIPT_HANDLE, + 'kadenceStyleLibraryParams', + [ + 'pluginVersion' => KADENCE_BLOCKS_VERSION, + ] + ); + + wp_set_script_translations( self::SCRIPT_HANDLE, 'kadence-blocks' ); + } +} diff --git a/includes/resources/Design_Tokens/Admin/Style_Library/Menu.php b/includes/resources/Design_Tokens/Admin/Style_Library/Menu.php new file mode 100644 index 0000000000..f67907d38b --- /dev/null +++ b/includes/resources/Design_Tokens/Admin/Style_Library/Menu.php @@ -0,0 +1,282 @@ +screen = $screen; + $this->asset_loader = $asset_loader; + } + + /** + * The Style Library screen slug. + * + * @since TBD + * + * @return string + */ + public static function get_menu_slug(): string { + return self::MENU_SLUG; + } + + /** + * An admin URL that opens the Style Library on one of its screens. + * + * @since TBD + * + * @param string $screen The screen id, e.g. "typography". Empty opens the default screen. + * + * @return string The admin URL. + */ + public static function get_screen_url( string $screen = '' ): string { + $args = [ 'page' => self::MENU_SLUG ]; + + if ( $screen !== '' ) { + $args[ self::SCREEN_QUERY_ARG ] = $screen; + } + + return add_query_arg( $args, admin_url( 'admin.php' ) ); + } + + /** + * The body class scoping the full-height layout overrides to the Style Library screen. + * + * @since TBD + * + * @return string + */ + public static function get_body_class(): string { + return self::BODY_CLASS; + } + + /** + * The core hooks emptied on this screen so no admin notice renders inside the app frame. + * + * @since TBD + * + * @return string[] + */ + public static function get_admin_notice_hooks(): array { + return self::ADMIN_NOTICE_HOOKS; + } + + /** + * Register admin menu hooks. + * + * @since TBD + * + * @return void + */ + public function register_site_menu(): void { + $this->register_submenu( self::PARENT_SLUG ); + } + + /** + * Register the Style Library submenu on network admin. + * + * @since TBD + * + * @return void + */ + public function register_network_menu(): void { + if ( ! kadence_blocks_is_network_authorize_enabled() ) { + return; + } + + if ( ! function_exists( 'is_plugin_active_for_network' ) || ! is_plugin_active_for_network( 'kadence-blocks/kadence-blocks.php' ) ) { + return; + } + + $this->register_submenu( self::PARENT_SLUG ); + } + + /** + * Add the body-class filter, scoped to the Style Library screen via the `load-{$hook}` action. + * + * @since TBD + * + * @return void + */ + public function register_body_class_filter(): void { + add_filter( 'admin_body_class', [ $this, 'filter_body_class' ] ); + } + + /** + * Append the full-height layout body class, leaving every existing class intact. + * + * @since TBD + * + * @param string $classes The space-separated body classes. + * + * @return string The body classes, with the Style Library class appended. + */ + public function filter_body_class( string $classes ): string { + return $classes . ' ' . self::BODY_CLASS; + } + + /** + * Empty every core admin-notice hook, scoped to the Style Library screen via the + * `load-{$hook}` action. `load-{$hook}` fires immediately before `wp-admin/admin-header.php` + * requires — the file that runs all four hooks inside `#wpbody-content`, where the app + * mounts — and after `admin_init` and `admin_menu`, the hooks most notice registrations use, + * so this catches them without touching the admin bar or admin menu. + * + * @since TBD + * + * @return void + */ + public function remove_admin_notices(): void { + foreach ( self::ADMIN_NOTICE_HOOKS as $hook_name ) { + remove_all_actions( $hook_name ); + } + } + + /** + * Add the submenu page and wire screen assets. + * + * @since TBD + * + * @param string $parent_slug The parent menu slug. + * + * @return void + */ + private function register_submenu( string $parent_slug ): void { + $hook = add_submenu_page( + $parent_slug, + __( 'Style Library', 'kadence-blocks' ), + __( 'Style Library', 'kadence-blocks' ), + $this->get_capability(), + self::MENU_SLUG, + [ $this->screen, 'render' ], + self::MENU_POSITION + ); + + if ( ! is_string( $hook ) ) { + return; + } + + add_action( 'admin_print_styles-' . $hook, [ $this->asset_loader, 'enqueue' ] ); + add_action( 'load-' . $hook, [ $this, 'register_body_class_filter' ] ); + add_action( 'load-' . $hook, [ $this, 'remove_admin_notices' ] ); + } + + /** + * The capability required to access the Style Library screen. + * + * @since TBD + * + * @return string + */ + private function get_capability(): string { + /** + * Filters the capability required to access the Style Library admin screen. + * + * @since TBD + * + * @param string $capability The required capability. + * + * @return string The required capability. + */ + return Cast::to_string( apply_filters( 'kadence_blocks_style_library_capability', 'edit_theme_options' ) ); + } +} diff --git a/includes/resources/Design_Tokens/Admin/Style_Library/Screen.php b/includes/resources/Design_Tokens/Admin/Style_Library/Screen.php new file mode 100644 index 0000000000..ec87b93c4e --- /dev/null +++ b/includes/resources/Design_Tokens/Admin/Style_Library/Screen.php @@ -0,0 +1,39 @@ + +
+
+
+
+
+
+
+ store = $store; + } + + /** + * The action hook that fires after the active library changes, for callers that need to react. + * + * @since TBD + * + * @return string + */ + public static function changed_action(): string { + return self::CHANGED_ACTION; + } + + /** + * Read the active token library slug, always resolved to a valid library. + * + * Falls back to the default library when the pointer was never set or now references a library with no + * row (a since-deleted library) — the default is the always-present canonical library, so the returned + * slug always names a readable library. + * + * @since TBD + * + * @return string The active library slug, or the default library when the stored pointer is empty or dangling. + */ + public function get(): string { + $slug = Cast::to_string( get_option( self::OPTION, '' ) ); + + if ( ! $this->is_known( $slug ) ) { + return Token_Store::default_slug(); + } + + return $slug; + } + + /** + * Point the active library at a slug, signalling the change. + * + * A no-op when the slug already resolves to the current active library: nothing is written and no + * change is signalled, so subscribers only see a real move. Validating that the slug names an + * existing library is the REST layer's job (a 404); this store persists the pointer and announces + * the change. + * + * @since TBD + * + * @param string $slug The token library slug to make active. + * + * @return void + */ + public function set( string $slug ): void { + $previous = $this->get(); + + if ( $slug === $previous ) { + return; + } + + update_option( self::OPTION, $slug, true ); + + $this->changed( $slug, $previous ); + } + + /** + * Drop the pointer when the library it references is deleted, resetting it to the default. + * + * Wired to Token_Store::deleted_action(), mirroring how Token_History_Store::forget() drops a + * deleted library's trail: once the active library's row is gone, the now-dangling pointer is dropped and + * the change is signalled so caches can rebuild against the default. Reads already fall back on + * their own, so this only keeps the stored option clean and emits the change signal at deletion + * time. A delete of any other library leaves the pointer untouched. + * + * @since TBD + * + * @param string $slug The token library slug that was deleted. + * + * @return void + */ + public function forget( string $slug ): void { + if ( $slug !== Cast::to_string( get_option( self::OPTION, '' ) ) ) { + return; + } + + delete_option( self::OPTION ); + + $this->changed( Token_Store::default_slug(), $slug ); + } + + /** + * Whether a slug names a readable token library. + * + * The default library is always known — it renders from baseline even before it has a row — and any + * other slug is known once it has a stored row. Mirrors Documents_Controller's read gate. + * + * @since TBD + * + * @param string $slug The slug to test. + * + * @return bool + */ + private function is_known( string $slug ): bool { + return $slug === Token_Store::default_slug() || $this->store->exists( $slug ); + } + + /** + * Signal that the active library changed so caches and projectors can react. + * + * @since TBD + * + * @param string $new_slug The now-active library slug. + * @param string $old_slug The now-previous library slug. + * + * @return void + */ + private function changed( string $new_slug, string $old_slug ): void { + /** + * Fires after the active design token library changes. + * + * @param string $new_slug The now-active library slug. + * @param string $old_slug The now-previous library slug. + */ + do_action( self::CHANGED_ACTION, $new_slug, $old_slug ); + } +} diff --git a/includes/resources/Design_Tokens/Database/Provider.php b/includes/resources/Design_Tokens/Database/Provider.php new file mode 100644 index 0000000000..6f9ffe6516 --- /dev/null +++ b/includes/resources/Design_Tokens/Database/Provider.php @@ -0,0 +1,100 @@ +register_token_store(); + $this->register_history_store(); + $this->register_active_token_library_store(); + } + + /** + * Bind Token_Store as a singleton and inject its table name. + * + * @since TBD + * + * @return void + */ + private function register_token_store(): void { + $this->container->singleton( Token_Store::class, Token_Store::class ); + + $this->container->when( Token_Store::class ) + ->needs( '$table' ) + ->give( static fn(): string => Token_Table::table_name( false ) ); + } + + /** + * Bind Token_History_Store and subscribe it to the Token_Store change signals. + * + * The store archives the previous document each time a library is overwritten, and + * drops a library's whole trail when its row is deleted. Subscribing here (rather + * than calling the store from Token_Store) keeps Token_Store the sole writer of + * its own table — it only announces the prior state and the deletion, and + * history is a separable consumer of those signals. + * + * @since TBD + * + * @return void + */ + private function register_history_store(): void { + $this->container->singleton( Token_History_Store::class, Token_History_Store::class ); + + $this->container->when( Token_History_Store::class ) + ->needs( '$table' ) + ->give( static fn(): string => Token_History_Table::table_name( false ) ); + + add_action( + Token_Store::superseded_action(), + $this->container->callback( Token_History_Store::class, 'record' ), + 10, + 3 + ); + + add_action( + Token_Store::deleted_action(), + $this->container->callback( Token_History_Store::class, 'forget' ), + 10, + 1 + ); + } + + /** + * Bind Active_Token_Library_Store and reset its pointer when the active library is deleted. + * + * The store owns the active-library pointer (an option), separate from the table Token_Store guards. + * Subscribing it to the delete signal here keeps Token_Store the sole writer of its own table — it + * only announces the deletion, and the pointer drops back to the default as a separable consumer of + * that signal, mirroring how history reacts. + * + * @since TBD + * + * @return void + */ + private function register_active_token_library_store(): void { + $this->container->singleton( Active_Token_Library_Store::class, Active_Token_Library_Store::class ); + + add_action( + Token_Store::deleted_action(), + $this->container->callback( Active_Token_Library_Store::class, 'forget' ), + 10, + 1 + ); + } +} diff --git a/includes/resources/Design_Tokens/Database/Token_History_Store.php b/includes/resources/Design_Tokens/Database/Token_History_Store.php new file mode 100644 index 0000000000..dba046f8bb --- /dev/null +++ b/includes/resources/Design_Tokens/Database/Token_History_Store.php @@ -0,0 +1,260 @@ +history_enabled( $slug ) ) { + return; + } + + $this->qb()->insert( + [ + 'slug' => $slug, + 'document' => $document, + 'version' => $version, + 'created_at' => current_time( 'mysql', true ), + ] + ); + + $this->prune( $slug ); + } + + /** + * The most recently archived snapshot for a token library, or null when none exist. + * + * This is the one-step-undo source: the document the library held immediately + * before its current value. + * + * @since TBD + * + * @param string $slug The token library slug. + * + * @return array|null The snapshot row, or null when the library has + * no history yet. + */ + public function latest( string $slug = '' ): ?array { + $row = $this->qb() + ->where( 'slug', $slug === '' ? self::default_slug() : $slug ) + ->orderBy( 'id', 'DESC' ) + ->get( ARRAY_A ); + + return is_array( $row ) ? $row : null; + } + + /** + * A page of a token library's snapshots, newest first. + * + * @since TBD + * + * @param string $slug The token library slug. + * @param int $limit Maximum rows to return. + * @param int $offset Rows to skip, for pagination. + * + * @return array> The snapshot rows, newest first. + */ + public function for_library( string $slug = '', int $limit = 50, int $offset = 0 ): array { + $rows = $this->qb() + ->where( 'slug', $slug === '' ? self::default_slug() : $slug ) + ->orderBy( 'id', 'DESC' ) + ->limit( $limit ) + ->offset( $offset ) + ->getAll( ARRAY_A ); + + return is_array( $rows ) ? $rows : []; + } + + /** + * Count the snapshots stored for a token library. + * + * @since TBD + * + * @param string $slug The token library slug. + * + * @return int + */ + public function count( string $slug = '' ): int { + return (int) $this->qb() + ->where( 'slug', $slug === '' ? self::default_slug() : $slug ) + ->count(); + } + + /** + * Drop every snapshot for a token library. + * + * Called once a library's row has been deleted, so its trail leaves no orphaned history behind. Wired + * to Token_Store's deleted action by Provider, keeping this store the sole writer of its own table. + * + * @since TBD + * + * @param string $slug The token library slug whose snapshots to drop. + * + * @return void + * + * @throws DatabaseQueryException If the delete fails. + */ + public function forget( string $slug = '' ): void { + $this->qb() + ->where( 'slug', $slug === '' ? self::default_slug() : $slug ) + ->delete(); + } + + /** + * Prune a token library's trail to its retention limit, deleting the oldest + * surplus snapshots so only the most-recent N remain. + * + * Done in two index-only queries against KEY(slug) — which InnoDB stores as + * (slug, id): first find the id of the Nth-newest row (the oldest snapshot we + * keep), then delete everything older for that slug. A single + * "DELETE ... LIMIT" can't express "all but the newest N" — MySQL's DELETE + * takes LIMIT count, not LIMIT offset, count — and a self-referencing subquery + * delete is rejected, so the boundary id is resolved first. + * + * @since TBD + * + * @param string $slug The token library slug to prune. + * + * @return void + * + * @throws DatabaseQueryException If the delete fails. + */ + private function prune( string $slug ): void { + $limit = $this->history_limit( $slug ); + + // The oldest snapshot to keep: the Nth-newest row. With fewer than $limit + // rows the offset overshoots and this returns null, so nothing is pruned. + $cutoff = $this->qb() + ->select( 'id' ) + ->where( 'slug', $slug ) + ->orderBy( 'id', 'DESC' ) + ->limit( 1 ) + ->offset( $limit - 1 ) + ->get( ARRAY_A ); + + if ( ! is_array( $cutoff ) || ! isset( $cutoff['id'] ) ) { + return; + } + + $this->qb() + ->where( 'slug', $slug ) + ->where( 'id', (int) $cutoff['id'], '<' ) + ->delete(); + } + + /** + * The retention limit for a token library's history: how many of the most-recent + * snapshots to keep. Always at least 1 — this is a cap, not an on/off switch. + * + * @since TBD + * + * @param string $slug The token library slug the limit applies to. + * + * @return int A positive retention count. + */ + private function history_limit( string $slug ): int { + /** + * Filters how many design-token history snapshots are kept per token library. + * + * This is the retention cap, not an on/off switch: the returned value is + * clamped to a minimum of 1. To stop recording history altogether, use the + * kadence_blocks_design_tokens_history_enabled filter instead. + * + * @since TBD + * + * @param int $limit The number of most-recent snapshots to retain. Default 5. + * @param string $slug The token library slug being pruned. + */ + $limit = (int) apply_filters( 'kadence_blocks_design_tokens_history_limit', self::DEFAULT_HISTORY_LIMIT, $slug ); + + return max( 1, $limit ); + } + + /** + * Whether history is recorded for a token library. When false, record() archives + * nothing for the library — independent of the retention cap. Existing snapshots + * are left in place; only further recording (and its pruning) stops. + * + * @since TBD + * + * @param string $slug The token library slug. + * + * @return bool + */ + private function history_enabled( string $slug ): bool { + /** + * Filters whether design-token history is recorded for a token library. + * + * Return false to stop archiving snapshots for the library entirely (no + * recording, no pruning). Independent of the retention cap set by + * kadence_blocks_design_tokens_history_limit. + * + * @since TBD + * + * @param bool $enabled Whether to record history. Default true. + * @param string $slug The token library slug. + */ + return (bool) apply_filters( 'kadence_blocks_design_tokens_history_enabled', true, $slug ); + } +} diff --git a/includes/resources/Design_Tokens/Database/Token_History_Table.php b/includes/resources/Design_Tokens/Database/Token_History_Table.php new file mode 100644 index 0000000000..3a1cf29aeb --- /dev/null +++ b/includes/resources/Design_Tokens/Database/Token_History_Table.php @@ -0,0 +1,88 @@ +get_charset_collate(); + + return " + CREATE TABLE `$table_name` ( + id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT 'Primary key', + slug VARCHAR(191) NOT NULL COMMENT 'Token library this snapshot belongs to, matching kb_design_tokens.slug', + document LONGTEXT NOT NULL COMMENT 'The previous overrides-only DTCG JSON document, captured before it was overwritten', + version VARCHAR(64) NOT NULL DEFAULT '' COMMENT 'The cache-busting version hash the snapshot had when it was current', + created_at DATETIME NOT NULL COMMENT 'UTC timestamp the snapshot was archived (i.e. when the superseding save happened)', + PRIMARY KEY (id), + KEY slug (slug) + ) {$charset_collate}; + "; + } +} diff --git a/includes/resources/Design_Tokens/Database/Token_Store.php b/includes/resources/Design_Tokens/Database/Token_Store.php new file mode 100644 index 0000000000..2b74d36ba1 --- /dev/null +++ b/includes/resources/Design_Tokens/Database/Token_Store.php @@ -0,0 +1,693 @@ +qb() + ->where( 'slug', $slug ) + ->get( ARRAY_A ); + + if ( ! is_array( $row ) ) { + return ''; + } + + return (string) ( $row['document'] ?? '' ); + } + + /** + * Read the overrides-only DTCG document for a token library, decoded. + * + * The column holds JSON, so decoding it belongs to the gateway that owns the column rather than to + * each of the callers that read it. Fail-soft the same way {@see self::get_document()} is: a library + * with no row, and a row whose JSON is unreadable or does not decode to an array, both yield an empty + * document, so a caller renders entirely from baseline instead of handling a decode failure itself. + * + * @since TBD + * + * @param string $slug The token library slug. + * + * @return array The decoded document, empty when absent or unreadable. + */ + public function get_decoded_document( string $slug = self::DEFAULT_SLUG ): array { + $raw = $this->get_document( $slug ); + + if ( $raw === '' ) { + return []; + } + + $decoded = json_decode( $raw, true ); + + return is_array( $decoded ) ? $decoded : []; + } + + /** + * Read the cache-busting version hash for a token library. + * + * Consumed by downstream caches (e.g. the projected-CSS string is keyed on + * this value) to know when a token library has changed. + * + * @since TBD + * + * @param string $slug The token library slug. + * + * @return string The stored version hash, or an empty string when no row + * exists (i.e. the library renders from baseline). + */ + public function get_version( string $slug = self::DEFAULT_SLUG ): string { + $row = $this->qb() + ->where( 'slug', $slug ) + ->get( ARRAY_A ); + + if ( ! is_array( $row ) ) { + return ''; + } + + return (string) ( $row['version'] ?? '' ); + } + + /** + * Read the human-readable label for a token library. + * + * @since TBD + * + * @param string $slug The token library slug. + * + * @return string The stored title, or an empty string when no row exists or none was ever set. + */ + public function get_title( string $slug = self::DEFAULT_SLUG ): string { + $row = $this->qb() + ->where( 'slug', $slug ) + ->get( ARRAY_A ); + + if ( ! is_array( $row ) ) { + return ''; + } + + return (string) ( $row['title'] ?? '' ); + } + + /** + * Insert or update a token library's document, bump its version and signal change. + * + * @since TBD + * + * @param string $document The raw overrides-only DTCG JSON to persist. + * @param string $slug The token library slug. + * @param string $title Optional human-readable label. Left untouched on + * update when an empty string is passed. + * + * @return void + * + * @throws DatabaseQueryException If the write fails. The change action only + * fires on success, since a failed write + * throws before changed() is reached. + */ + public function save_document( string $document, string $slug = self::DEFAULT_SLUG, string $title = '' ): void { + // Capture the row before the upsert overwrites it, so its document can be + // archived once the save succeeds. Only a pre-existing row has prior state + // worth keeping — a first save has nothing to archive. + $previous = $this->qb() + ->where( 'slug', $slug ) + ->get( ARRAY_A ); + + $data = $this->build_document_data( $document, $title, $slug ); + + // upsert() is a non-atomic SELECT-then-INSERT/UPDATE, not an atomic + // INSERT ... ON DUPLICATE KEY. Two concurrent first-writes for the same + // slug can both miss the SELECT and race to INSERT; the UNIQUE KEY on + // slug then makes the loser throw DatabaseQueryException. Fine for + // admin-driven single-library saves in v1; revisit if writes become concurrent. + $this->qb()->upsert( $data, [ 'slug' ] ); + + // Everything below is reached only on a successful write — a failed upsert + // throws above, so nothing is archived and no change is signalled for a + // save that did not happen. + if ( is_array( $previous ) ) { + $this->superseded( $slug, (string) ( $previous['document'] ?? '' ), (string) ( $previous['version'] ?? '' ) ); + } + + $this->changed( $slug ); + } + + /** + * Write a document only when the stored version matches expected_version. + * + * First write: expected_version must be an empty string; the row must not yet exist. + * Subsequent writes: expected_version must match the current stored version. + * + * Returns true on success, false on version mismatch (caller maps to 409). + * Throws DatabaseQueryException on a real write failure. + * + * @since TBD + * + * @param string $document The raw DTCG JSON to persist. + * @param string $expected_version The version the caller last read. Empty for first write. + * @param string $slug The token library slug. + * @param string $title Optional label; left untouched when empty. + * + * @return bool True on success; false when the version does not match. + * + * @throws DatabaseQueryException If the write fails. + */ + public function save_document_conditional( + string $document, + string $expected_version, + string $slug = self::DEFAULT_SLUG, + string $title = '' + ): bool { + $previous = $this->qb() + ->where( 'slug', $slug ) + ->get( ARRAY_A ); + + if ( ! is_array( $previous ) ) { + // First write — expected_version must be empty. + if ( $expected_version !== '' ) { + return false; + } + + $data = $this->build_document_data( $document, $title, $slug ); + + try { + $this->qb()->insert( $data ); + } catch ( DatabaseQueryException $e ) { + // Duplicate-key on concurrent first write → conflict, not 500. + return false; + } + + $this->changed( $slug ); + + return true; + } + + // Subsequent write — must match. + if ( Cast::to_string( $previous['version'] ?? '' ) !== $expected_version ) { + return false; + } + + $data = $this->build_document_data( $document, $title ); + + // Conditional UPDATE: WHERE slug = ? AND version = ? prevents a concurrent overwrite. + $affected = $this->qb() + ->where( 'slug', $slug ) + ->where( 'version', $expected_version ) + ->update( $data ); + + // Zero affected rows means the version changed concurrently. + if ( (int) $affected === 0 ) { + return false; + } + + $this->superseded( $slug, (string) ( $previous['document'] ?? '' ), $expected_version ); + $this->changed( $slug ); + + return true; + } + + /** + * Write a token library's human-readable label, touching nothing else. + * + * A title is metadata: it appears in the library picker and nowhere in any projection, so + * renaming a library must not travel through the document write path. Doing so would re-validate + * and re-resolve the entire stored document to change a label — turning a rename into a failure + * for any library whose stored document does not currently validate, for reasons that have + * nothing to do with the new name. + * + * Neither the version hash nor the change action moves here, for the same reason: no projector + * output depends on a title, so bumping the version would invalidate the projected-CSS cache for + * a change no visitor can see. + * + * @since TBD + * + * @param string $slug The token library slug. + * @param string $title The new label. An empty string is rejected rather than treated as + * "leave the stored title alone", which is what the document write path + * does with an empty title — here, clearing is simply not an operation. + * + * @return bool True when the title was written. + * + * @throws DatabaseQueryException If the update fails. + */ + public function save_title( string $slug, string $title ): bool { + $title = sanitize_text_field( $title ); + + if ( $title === '' ) { + return false; + } + + $existing = $this->qb() + ->where( 'slug', $slug ) + ->get( ARRAY_A ); + + if ( ! is_array( $existing ) ) { + // The default library has no row until something is written to it, so naming it is that + // first write. The empty document stored alongside the title is not a change of content — + // it is exactly what the library already resolved to, since no row means "render from + // baseline". Every other slug is rejected by the caller before reaching this point. + try { + $this->qb()->insert( $this->build_document_data( '', $title, $slug ) ); + } catch ( DatabaseQueryException $e ) { + // Duplicate-key on a concurrent first write → the row now exists and carries someone + // else's title; report the miss rather than a fatal. + return false; + } + + return true; + } + + $this->qb() + ->where( 'slug', $slug ) + ->update( + [ + 'title' => $title, + 'updated_at' => current_time( 'mysql', true ), + ] + ); + + // Deliberately not gated on the affected-row count: MySQL reports zero rows affected when an + // UPDATE sets a column to the value it already holds, which is a no-op, not a failure. A real + // write failure throws instead. + return true; + } + + /** + * Delete a named token library only when the stored version matches expected_version. + * + * The default library is never row-deleted; use save_document_conditional with an empty + * document to reset it instead. + * + * Returns true on success, false on version mismatch or if slug is the default library. + * + * @since TBD + * + * @param string $slug The named library slug. + * @param string $expected_version The version the caller last read. + * + * @return bool True on success; false on mismatch or default-library attempt. + * + * @throws DatabaseQueryException If the delete fails. + */ + public function delete_document_conditional( string $slug, string $expected_version ): bool { + if ( $slug === self::DEFAULT_SLUG ) { + return false; + } + + $previous = $this->qb() + ->where( 'slug', $slug ) + ->get( ARRAY_A ); + + if ( ! is_array( $previous ) ) { + return false; + } + + if ( (string) ( $previous['version'] ?? '' ) !== $expected_version ) { + return false; + } + + $affected = $this->qb() + ->where( 'slug', $slug ) + ->where( 'version', $expected_version ) + ->delete(); + + // Zero affected rows means the version changed concurrently. + if ( (int) $affected === 0 ) { + return false; + } + + $this->deleted( $slug ); + + return true; + } + + /** + * Re-hash a token library's version to bust caches without changing its document. + * + * No-op when the library does not exist — there is nothing cached to invalidate. + * + * @since TBD + * + * @param string $slug The token library slug. + * + * @return void + * + * @throws DatabaseQueryException If the write fails. The change action only + * fires on success, since a failed write + * throws before changed() is reached. + */ + public function bump_version( string $slug = self::DEFAULT_SLUG ): void { + $row = $this->qb() + ->where( 'slug', $slug ) + ->get( ARRAY_A ); + + if ( ! is_array( $row ) ) { + return; + } + + $this->qb() + ->where( 'slug', $slug ) + ->update( + [ + 'version' => $this->hash_document( (string) $row['document'] ), + 'updated_at' => current_time( 'mysql', true ), + ] + ); + + // Reached only on a successful write — a failed write throws above. + $this->changed( $slug ); + } + + /** + * List every stored token library, as its slug, title and version. + * + * The default library is not synthesized here: a library appears only once it has a row, so a site + * that has never written the default returns an empty list. Callers that must always surface the + * default (the REST collection) layer that invariant on top. + * + * @since TBD + * + * @return array The libraries, ordered by slug. + */ + public function list_stores(): array { + $rows = $this->qb() + ->select( 'slug', 'title', 'version' ) + ->orderBy( 'slug', 'ASC' ) + ->getAll( ARRAY_A ); + + if ( ! is_array( $rows ) ) { + return []; + } + + return array_map( + static fn( array $row ): array => [ + 'slug' => Cast::to_string( $row['slug'] ?? '' ), + 'title' => Cast::to_string( $row['title'] ?? '' ), + 'version' => Cast::to_string( $row['version'] ?? '' ), + ], + $rows + ); + } + + /** + * Whether a token library has a stored row. + * + * A library with no row renders entirely from baseline; the default library may legitimately have no + * row yet, so callers that treat the default as always-known must account for that themselves. + * + * @since TBD + * + * @param string $slug The token library slug. + * + * @return bool + */ + public function exists( string $slug ): bool { + return is_array( + $this->qb() + ->where( 'slug', $slug ) + ->get( ARRAY_A ) + ); + } + + /** + * Delete a token library. + * + * The default library is the always-present canonical library and is never physically removed: + * deleting it clears its overrides back to baseline (the row stays). Any other library's row is + * dropped outright, which signals its removal so related state (its history) can be dropped too. + * Removing a library that does not exist is a no-op — there is nothing to remove and nothing to + * signal. This guard is enforced here so every caller is protected, not just the REST surface. + * + * @since TBD + * + * @param string $slug The token library slug. + * + * @return void + * + * @throws DatabaseQueryException If the write fails. The deleted action only fires on a successful + * removal, since a failed write throws before deleted() is reached. + */ + public function delete( string $slug = self::DEFAULT_SLUG ): void { + // The canonical library cannot be removed; clearing its overrides is the strongest delete it supports. + if ( $slug === self::DEFAULT_SLUG ) { + $this->save_document( '', $slug ); + + return; + } + + $row = $this->qb() + ->where( 'slug', $slug ) + ->get( ARRAY_A ); + + if ( ! is_array( $row ) ) { + return; + } + + $this->qb() + ->where( 'slug', $slug ) + ->delete(); + + // Reached only on a successful delete — a failed delete throws above. + $this->deleted( $slug ); + } + + /** + * Build the document/version/updated_at/title column data shared by every write path. + * + * @since TBD + * + * @param string $document The raw DTCG JSON to persist. + * @param string $title Optional label. Omitted from the array (not just left + * empty) when blank, so a document-only write does not + * wipe an existing title. + * @param string|null $slug The slug to include for an insert/upsert, or null to + * omit it for an UPDATE that is already scoped by a + * WHERE clause. + * + * @return array The column data, ready for insert(), upsert(), or update(). + */ + private function build_document_data( string $document, string $title, ?string $slug = null ): array { + $data = [ + 'document' => $document, + 'version' => $this->hash_document( $document ), + 'updated_at' => current_time( 'mysql', true ), + ]; + + if ( $slug !== null ) { + $data = [ 'slug' => $slug ] + $data; + } + + $title = sanitize_text_field( $title ); + + if ( $title !== '' ) { + $data['title'] = $title; + } + + return $data; + } + + /** + * Derive a content-based, cache-busting version hash. + * + * The microtime() salt guarantees the hash changes on every write, so repeated + * saves (and document-less version bumps) always invalidate downstream caches. + * + * @since TBD + * + * @param string $document The document the hash is derived from. + * + * @return string A 32-character hash. + */ + private function hash_document( string $document ): string { + return md5( $document . microtime() ); + } + + /** + * Signal that a token library changed so projectors and caches can react. + * + * @since TBD + * + * @param string $slug The token library slug that changed. + * + * @return void + */ + private function changed( string $slug ): void { + /** + * Fires after a design token library is written. + * + * @param string $slug The token library slug that changed. + */ + do_action( self::CHANGED_ACTION, $slug ); + } + + /** + * Signal that a save overwrote a library's existing document, carrying its prior state. + * + * Fires after a successful upsert so a subscriber can archive the document + * that was just replaced (the history store), with the captured prior values. + * + * @since TBD + * + * @param string $slug The token library slug that was overwritten. + * @param string $document The now-previous document that was replaced. + * @param string $version The now-previous version hash. + * + * @return void + */ + private function superseded( string $slug, string $document, string $version ): void { + /** + * Fires immediately after a design token library's existing document is overwritten. + * + * @param string $slug The token library slug that was overwritten. + * @param string $document The now-previous document that was replaced. + * @param string $version The now-previous version hash. + */ + do_action( self::SUPERSEDED_ACTION, $slug, $document, $version ); + } + + /** + * Signal that a token library's row was deleted so consumers can drop its related state. + * + * @since TBD + * + * @param string $slug The token library slug that was deleted. + * + * @return void + */ + private function deleted( string $slug ): void { + /** + * Fires after a design token library's row is deleted. + * + * @param string $slug The token library slug that was deleted. + */ + do_action( self::DELETED_ACTION, $slug ); + } +} diff --git a/includes/resources/Design_Tokens/Database/Token_Table.php b/includes/resources/Design_Tokens/Database/Token_Table.php new file mode 100644 index 0000000000..2b8517f392 --- /dev/null +++ b/includes/resources/Design_Tokens/Database/Token_Table.php @@ -0,0 +1,78 @@ +get_charset_collate(); + + return " + CREATE TABLE `$table_name` ( + id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT 'Primary key', + slug VARCHAR(191) NOT NULL COMMENT 'Token library identifier, e.g. \"default\". Unique per library to allow future multi-brand support', + title VARCHAR(191) NOT NULL DEFAULT '' COMMENT 'Human-readable label for the token library', + document LONGTEXT NOT NULL COMMENT 'The overrides-only DTCG JSON document. Empty means render entirely from baseline', + version VARCHAR(64) NOT NULL DEFAULT '' COMMENT 'Per-write cache-busting hash, regenerated on every write', + updated_at DATETIME NOT NULL COMMENT 'UTC timestamp of the last write', + PRIMARY KEY (id), + UNIQUE KEY slug (slug) + ) {$charset_collate}; + "; + } +} diff --git a/includes/resources/Design_Tokens/Design_Tokens_Provider.php b/includes/resources/Design_Tokens/Design_Tokens_Provider.php new file mode 100644 index 0000000000..ec6aecb86a --- /dev/null +++ b/includes/resources/Design_Tokens/Design_Tokens_Provider.php @@ -0,0 +1,34 @@ +[] + */ + private const PROVIDERS = [ + Registry\Provider::class, + Database\Provider::class, + Schema\Provider::class, + Resolver\Provider::class, + Projection\Provider::class, + Foundation_Presets\Provider::class, + Rest\Provider::class, + Admin\Provider::class, + Editor\Provider::class, + ]; + + public function register(): void { + foreach ( self::PROVIDERS as $provider ) { + $this->container->register( $provider ); + } + } +} diff --git a/includes/resources/Design_Tokens/Document/Document_Path.php b/includes/resources/Design_Tokens/Document/Document_Path.php new file mode 100644 index 0000000000..de9a5fc447 --- /dev/null +++ b/includes/resources/Design_Tokens/Document/Document_Path.php @@ -0,0 +1,35 @@ + $document The document to walk. + * @param string $path The dot-path to look up. + * + * @return array|null + */ + public static function node_at( array $document, string $path ): ?array { + $node = $document; + + foreach ( explode( '.', $path ) as $segment ) { + if ( ! is_array( $node ) || ! array_key_exists( $segment, $node ) ) { + return null; + } + + $node = $node[ $segment ]; + } + + return is_array( $node ) ? $node : null; + } +} diff --git a/includes/resources/Design_Tokens/Document/Favorite_Font_Index.php b/includes/resources/Design_Tokens/Document/Favorite_Font_Index.php new file mode 100644 index 0000000000..895acfed49 --- /dev/null +++ b/includes/resources/Design_Tokens/Document/Favorite_Font_Index.php @@ -0,0 +1,258 @@ + $document + * + * @return list + */ + public function all( array $document ): array { + $families = $this->read_list( $document ); + + if ( ! is_array( $families ) ) { + return []; + } + + // The `$families === []` check is required, not redundant: `range( 0, -1 )` returns + // `[ 0, -1 ]` in PHP, not `[]`, so without this short-circuit an empty favorites list would + // be misclassified as malformed rather than as a valid empty list. + $is_list = $families === [] || array_keys( $families ) === range( 0, count( $families ) - 1 ); + + if ( ! $is_list ) { + return []; + } + + $valid = array_filter( $families, fn( $family ) => is_string( $family ) && trim( $family ) !== '' ); + + $seen = []; + $unique = []; + + foreach ( array_map( 'trim', $valid ) as $family ) { + $key = $this->fold( $family ); + + if ( isset( $seen[ $key ] ) ) { + continue; + } + + $seen[ $key ] = true; + $unique[] = $family; + } + + return $unique; + } + + /** + * Whether a family is already a favorite, matched case-insensitively. + * + * @since TBD + * + * @param array $document + * @param string $family The catalog family name. + * + * @return bool + */ + public function has( array $document, string $family ): bool { + $key = $this->fold( trim( $family ) ); + + foreach ( $this->all( $document ) as $stored ) { + if ( $this->fold( $stored ) === $key ) { + return true; + } + } + + return false; + } + + /** + * Append a family to the end of the list. Idempotent: a family already in the list returns the + * same document, keeping its existing position rather than moving to the end — a picker's + * display order must not shuffle because a client replayed a write. + * + * @since TBD + * + * @param array $document + * @param string $family The catalog family name. + * + * @return array + */ + public function add( array $document, string $family ): array { + $family = trim( $family ); + + if ( $family === '' || $this->has( $document, $family ) ) { + return $document; + } + + $families = $this->all( $document ); + $families[] = $family; + + return $this->write_list( $document, $families ); + } + + /** + * Remove a family from the list, leaving every other favorite's relative order untouched. Matched + * case-insensitively, so a family can be cleared through the spelling a client has rather than only + * through the one that happens to be stored. No-op (the same document is returned) when the family + * is not in the list. + * + * @since TBD + * + * @param array $document + * @param string $family The catalog family name. + * + * @return array + */ + public function remove( array $document, string $family ): array { + $key = $this->fold( trim( $family ) ); + $current = $this->all( $document ); + + $remaining = array_values( + array_filter( $current, fn( string $stored ) => $this->fold( $stored ) !== $key ) + ); + + if ( $remaining === $current ) { + return $document; + } + + return $this->write_list( $document, $remaining ); + } + + /** + * The comparison key for a family name. ASCII lowercasing, matching both the `strcasecmp()` the + * REST catalog gate uses and the `toLowerCase()` both pickers collapse their lists with, so the + * three agree on what counts as the same font. + * + * @since TBD + * + * @param string $family The family name. + * + * @return string The comparison key. + */ + private function fold( string $family ): string { + return strtolower( $family ); + } + + /** + * @since TBD + * + * @param array $document + * + * @return mixed + */ + private function read_list( array $document ) { + $ext_data = $document[ Extensions::get_extensions_key() ] ?? null; + + if ( ! is_array( $ext_data ) ) { + return null; + } + + $ns_data = $ext_data[ Extensions::get_namespace() ] ?? null; + + if ( ! is_array( $ns_data ) ) { + return null; + } + + return $ns_data[ Extensions::get_section_favorite_fonts() ] ?? null; + } + + /** + * @since TBD + * + * @param array $document + * @param array $families + * + * @return array + */ + private function write_list( array $document, array $families ): array { + $document = $this->ensure_path( $document ); + + $ext = Extensions::get_extensions_key(); + $ns = Extensions::get_namespace(); + $sec = Extensions::get_section_favorite_fonts(); + + /** @var array $ext_data */ + $ext_data = $document[ $ext ]; + /** @var array $ns_data */ + $ns_data = $ext_data[ $ns ]; + + $ns_data[ $sec ] = $families; + $ext_data[ $ns ] = $ns_data; + $document[ $ext ] = $ext_data; + + return $document; + } + + /** + * @since TBD + * + * @param array $document + * + * @return array + */ + private function ensure_path( array $document ): array { + $ext = Extensions::get_extensions_key(); + $ns = Extensions::get_namespace(); + $sec = Extensions::get_section_favorite_fonts(); + + if ( ! isset( $document[ $ext ] ) || ! is_array( $document[ $ext ] ) ) { + $document[ $ext ] = []; + } + + /** @var array $ext_data */ + $ext_data = $document[ $ext ]; + + if ( ! isset( $ext_data[ $ns ] ) || ! is_array( $ext_data[ $ns ] ) ) { + $ext_data[ $ns ] = []; + $document[ $ext ] = $ext_data; + } + + /** @var array $ns_data */ + $ns_data = $ext_data[ $ns ]; + + if ( ! isset( $ns_data[ $sec ] ) || ! is_array( $ns_data[ $sec ] ) ) { + $ns_data[ $sec ] = []; + $ext_data[ $ns ] = $ns_data; + $document[ $ext ] = $ext_data; + } + + return $document; + } +} diff --git a/includes/resources/Design_Tokens/Document/Mutator.php b/includes/resources/Design_Tokens/Document/Mutator.php new file mode 100644 index 0000000000..54dd19bc34 --- /dev/null +++ b/includes/resources/Design_Tokens/Document/Mutator.php @@ -0,0 +1,188 @@ + $current The stored overrides document (decoded). + * @param array $partial The partial overrides document to merge in (decoded). + * + * @return array The merged document. + */ + public function merge( array $current, array $partial ): array { + foreach ( $partial as $key => $value ) { + // Scalars and lists replace wholesale. + if ( ! is_array( $value ) ) { + $current[ $key ] = $value; + continue; + } + + // A leaf or sentinel replaces wholesale — never field-merge a token value. + if ( $this->is_leaf( $value ) ) { + $current[ $key ] = $value; + continue; + } + + // Two groups: descend. When the stored side holds a leaf where the partial holds a group, the + // group replaces it wholesale rather than merging the group's children alongside the leaf's + // $type/$value and leaving a corrupt hybrid node. + if ( + isset( $current[ $key ] ) + && is_array( $current[ $key ] ) + && ! $this->is_leaf( $current[ $key ] ) + ) { + $current[ $key ] = $this->merge( $current[ $key ], $value ); + continue; + } + + $current[ $key ] = $value; + } + + return $current; + } + + /** + * Set a single token leaf at a dot-path, creating intermediate groups as needed. + * + * The leaf is assigned wholesale at the terminal segment; an existing leaf or scalar in the way of an + * intermediate segment is replaced by a fresh group so the path can be built. + * + * @since TBD + * + * @param array $document The stored overrides document (decoded). + * @param string $path The dot-path, e.g. "primitive.color.brand". + * @param array $leaf The DTCG leaf (or sentinel) to store at the path. + * + * @return array The document with the leaf set. + */ + public function set( array $document, string $path, array $leaf ): array { + $segments = explode( '.', $path ); + $last = (string) array_pop( $segments ); + + $cursor = &$document; + + foreach ( $segments as $segment ) { + if ( ! isset( $cursor[ $segment ] ) || ! is_array( $cursor[ $segment ] ) || $this->is_leaf( $cursor[ $segment ] ) ) { + $cursor[ $segment ] = []; + } + + $cursor = &$cursor[ $segment ]; + } + + $cursor[ $last ] = $leaf; + unset( $cursor ); + + return $document; + } + + /** + * Remove the node at a dot-path and prune any now-empty ancestor groups. + * + * A no-op when the path is absent, so a delete of an unset override leaves the document unchanged. + * + * @since TBD + * + * @param array $document The stored overrides document (decoded). + * @param string $path The dot-path to remove. + * + * @return array The document with the path removed and empty ancestors pruned. + */ + public function remove( array $document, string $path ): array { + return $this->remove_by_keys( $document, explode( '.', $path ) ); + } + + /** + * Recursively remove the node addressed by a literal key chain, pruning emptied groups on the way out. + * + * Addresses the document by discrete array keys rather than a dot-path, so a caller whose keys themselves + * carry dots ("com.kadence.designTokens") or slashes ("kadence/singlebtn") can remove a node the + * dot-path form could not express. + * + * @since TBD + * + * @param array $node The current node. + * @param string[] $keys The remaining literal keys to the node to remove. + * + * @return array The node with the key chain removed. + */ + public function remove_by_keys( array $node, array $keys ): array { + $head = (string) array_shift( $keys ); + + if ( ! array_key_exists( $head, $node ) ) { + return $node; + } + + if ( $keys === [] ) { + unset( $node[ $head ] ); + + return $node; + } + + // The path continues but this node is a leaf/scalar: there is nothing deeper to remove. + if ( ! is_array( $node[ $head ] ) ) { + return $node; + } + + $node[ $head ] = $this->remove_by_keys( $node[ $head ], $keys ); + + // Prune a group that the removal just emptied so stored overrides do not accrue husks. + if ( $node[ $head ] === [] ) { + unset( $node[ $head ] ); + } + + return $node; + } + + /** + * Whether a node is a token leaf to replace wholesale, rather than a group of child tokens to + * descend into. + * + * Keyed on the markers a stored override leaf can carry: + * + * - "$value": a concrete value or a reset, e.g. { "$type": "color", "$value": "#3182CE" } or + * { "$value": null }. Like the Resolver's effective merge, such a node is a leaf and is never + * field-merged. + * - "$disabled": a disable sentinel, e.g. { "$disabled": true }. Treated as a leaf here because + * these transforms store sentinels verbatim for the Resolver to interpret at read time. + * + * A "$type"-only node, e.g. { "$type": "color" }, is deliberately NOT a leaf: it is invalid DTCG the + * validator rejects downstream, so it is descended into as a group rather than replaced. + * + * @since TBD + * + * @param array $node The decoded node. + * + * @return bool + */ + private function is_leaf( array $node ): bool { + return array_key_exists( Sentinels::get_value_key(), $node ) + || array_key_exists( Sentinels::get_disabled_key(), $node ); + } +} diff --git a/includes/resources/Design_Tokens/Document/Preset_Order_Index.php b/includes/resources/Design_Tokens/Document/Preset_Order_Index.php new file mode 100644 index 0000000000..ac80a8a8da --- /dev/null +++ b/includes/resources/Design_Tokens/Document/Preset_Order_Index.php @@ -0,0 +1,250 @@ + $document The decoded overrides document. + * @param string $block The block name. + * + * @return list + */ + public function for_block( array $document, string $block ): array { + $slugs = $this->read_block( $document, $block ); + + if ( ! is_array( $slugs ) ) { + return []; + } + + // The `$slugs === []` check is required, not redundant: `range( 0, -1 )` returns + // `[ 0, -1 ]` in PHP, not `[]`, so without this short-circuit an empty order list would be + // misclassified as malformed rather than as a valid empty list. + $is_list = $slugs === [] || array_keys( $slugs ) === range( 0, count( $slugs ) - 1 ); + + if ( ! $is_list ) { + return []; + } + + // Deduplicated here rather than only in `set_block`, because `apply` intersects this list + // and would otherwise repeat a preset for any document written outside that setter. + return array_values( array_unique( array_filter( $slugs, fn( $slug ) => is_string( $slug ) && $slug !== '' ) ) ); + } + + /** + * Store one block's order wholesale (the endpoint's PUT-replaces contract). Deduplicates the + * incoming slugs, keeping first occurrence. + * + * @since TBD + * + * @param array $document The decoded overrides document. + * @param string $block The block name. + * @param array $slugs The block's new ordered preset-slug list. + * + * @return array + */ + public function set_block( array $document, string $block, array $slugs ): array { + return $this->write_block( $document, $block, array_values( array_unique( $slugs ) ) ); + } + + /** + * Remove one block's stored order — declaration order applies again for that block. No-op + * (the same document is returned) when the block has no order currently stored. + * + * @since TBD + * + * @param array $document The decoded overrides document. + * @param string $block The block name. + * + * @return array + */ + public function remove_block( array $document, string $block ): array { + $map = $this->read_map( $document ); + + // `array_key_exists`, not `isset`: a stored `null` is malformed but still present, and + // `isset` would report it missing and leave the residue in storage permanently. + if ( ! array_key_exists( $block, $map ) ) { + return $document; + } + + unset( $map[ $block ] ); + + if ( $map === [] ) { + return $this->unset_section( $document ); + } + + return $this->write_map( $document, $map ); + } + + /** + * The single ordering algorithm every read seam applies: stored-and-present slugs first, in + * stored order, then the remaining incoming names in their incoming order. Advisory — a stale + * stored slug that names no incoming preset is skipped silently, and a preset the store has + * never ordered simply appends. Any future listing seam of block presets must route through + * this method rather than reimplement the merge, so the controller, the resolver, and the + * admin feed can never disagree. + * + * @since TBD + * + * @param array $document The decoded overrides document. + * @param string $block The block name. + * @param array $names The preset slugs in their unordered (declaration) order. + * + * @return list + */ + public function apply( array $document, string $block, array $names ): array { + $stored = $this->for_block( $document, $block ); + $present = array_values( array_intersect( $stored, $names ) ); + $rest = array_values( array_diff( $names, $present ) ); + + return array_merge( $present, $rest ); + } + + /** + * @since TBD + * + * @param array $document The decoded overrides document. + * @param string $block The block name. + * + * @return mixed + */ + private function read_block( array $document, string $block ) { + return $this->read_map( $document )[ $block ] ?? null; + } + + /** + * @since TBD + * + * @param array $document The decoded overrides document. + * + * @return array + */ + private function read_map( array $document ): array { + $ext_data = $document[ Extensions::get_extensions_key() ] ?? null; + + if ( ! is_array( $ext_data ) ) { + return []; + } + + $ns_data = $ext_data[ Extensions::get_namespace() ] ?? null; + + if ( ! is_array( $ns_data ) ) { + return []; + } + + $map = $ns_data[ Extensions::get_section_preset_order() ] ?? null; + + return is_array( $map ) ? $map : []; + } + + /** + * @since TBD + * + * @param array $document The decoded overrides document. + * @param string $block The block name. + * @param array $slugs The block's ordered preset-slug list. + * + * @return array + */ + private function write_block( array $document, string $block, array $slugs ): array { + $map = $this->read_map( $document ); + + $map[ $block ] = $slugs; + + return $this->write_map( $document, $map ); + } + + /** + * @since TBD + * + * @param array $document The decoded overrides document. + * @param array $map The full presetOrder map to store. + * + * @return array + */ + private function write_map( array $document, array $map ): array { + $ext = Extensions::get_extensions_key(); + $ns = Extensions::get_namespace(); + $sec = Extensions::get_section_preset_order(); + + /** @var array $ext_data */ + $ext_data = isset( $document[ $ext ] ) && is_array( $document[ $ext ] ) ? $document[ $ext ] : []; + /** @var array $ns_data */ + $ns_data = isset( $ext_data[ $ns ] ) && is_array( $ext_data[ $ns ] ) ? $ext_data[ $ns ] : []; + + $ns_data[ $sec ] = $map; + $ext_data[ $ns ] = $ns_data; + $document[ $ext ] = $ext_data; + + return $document; + } + + /** + * Remove the whole presetOrder section, pruning an emptied namespace/extensions node along + * with it so a fully-cleared order leaves no residue in the stored document. + * + * @since TBD + * + * @param array $document The decoded overrides document. + * + * @return array + */ + private function unset_section( array $document ): array { + $ext = Extensions::get_extensions_key(); + $ns = Extensions::get_namespace(); + $sec = Extensions::get_section_preset_order(); + + if ( ! isset( $document[ $ext ] ) || ! is_array( $document[ $ext ] ) ) { + return $document; + } + + /** @var array $ext_data */ + $ext_data = $document[ $ext ]; + + if ( ! isset( $ext_data[ $ns ] ) || ! is_array( $ext_data[ $ns ] ) ) { + return $document; + } + + /** @var array $ns_data */ + $ns_data = $ext_data[ $ns ]; + unset( $ns_data[ $sec ] ); + + if ( $ns_data === [] ) { + unset( $ext_data[ $ns ] ); + } else { + $ext_data[ $ns ] = $ns_data; + } + + if ( $ext_data === [] ) { + unset( $document[ $ext ] ); + } else { + $document[ $ext ] = $ext_data; + } + + return $document; + } +} diff --git a/includes/resources/Design_Tokens/Document/Reserved_Namespace.php b/includes/resources/Design_Tokens/Document/Reserved_Namespace.php new file mode 100644 index 0000000000..def72eca5d --- /dev/null +++ b/includes/resources/Design_Tokens/Document/Reserved_Namespace.php @@ -0,0 +1,205 @@ +.custom.*. + * + * Every write surface that must recognize this namespace (the user-primitive document invariant, the + * user-primitives controller's id validation, and the generic documents controller's write guards) + * defers to this class instead of re-deriving the shape on its own, so the set of reserved + * segments cannot drift between call sites. The segment is validated against every registered + * Token_Type rather than hardcoding "color", so a future custom primitive under an existing $type (e.g. + * a gap or radius primitive, both "dimension") is guarded automatically. + * + * @since TBD + */ +final class Reserved_Namespace { + + /** + * The token layer the reserved namespace lives under. + * + * @since TBD + * + * @var string + */ + private const LAYER = 'primitive'; + + /** + * The tree segment, directly under the reserved $type, that holds user-created primitives. + * + * @since TBD + * + * @var string + */ + private const SEGMENT = 'custom'; + + /** + * The kebab-case pattern a terminal slug must match, without anchors or delimiters. + * + * @since TBD + * + * @var string + */ + private const SLUG_PATTERN = '[a-z0-9]+(?:-[a-z0-9]+)*'; + + /** + * Whether a canonical dot-path id names a user-primitive leaf: primitive..custom.. + * + * @since TBD + * + * @param string $id The canonical dot-path id. + * + * @return bool + */ + public static function is_reserved_id( string $id ): bool { + $types = array_map( + static fn( string $type ): string => preg_quote( $type, '/' ), + Token_Type::get_id_segments() + ); + + return (bool) preg_match( + '/^' . self::LAYER . '\.(?:' . implode( '|', $types ) . ')\.' . self::SEGMENT . '\.' . self::SLUG_PATTERN . '$/', + $id + ); + } + + /** + * The anchored, unescaped slug pattern, suitable for a REST `args` `pattern` entry. + * + * @since TBD + * + * @return string + */ + public static function get_slug_pattern(): string { + return '^' . self::SLUG_PATTERN . '$'; + } + + /** + * The reserved namespace segment that marks a user-created primitive: the `custom` in + * `primitive..custom.`. Exposed so a consumer keying off the segment (e.g. deriving a + * custom token's real sub-kind from its group) references this single source of truth instead of + * repeating the literal. + * + * @since TBD + * + * @return string + */ + public static function get_segment(): string { + return self::SEGMENT; + } + + /** + * Whether a terminal slug (not a full id) is valid kebab-case. + * + * @since TBD + * + * @param string $slug The terminal slug. + * + * @return bool + */ + public static function is_valid_slug( string $slug ): bool { + return (bool) preg_match( '/' . self::get_slug_pattern() . '/', $slug ); + } + + /** + * Build the canonical id for a supported type and terminal slug: primitive..custom.. + * + * A pure string builder, like the slug handling before it: the type is not validated here. + * Callers pass a type that already passed is_supported_type() (the create gate) or was read + * from a stored tree leaf (the rename cascade, the orphan scan); an unsupported type yields + * an id the user-primitive document invariant rejects downstream. + * + * The id's second segment is the type's REGISTERED id segment (Token_Type::get_id_segment()), + * not necessarily the $type spelling itself: the id feeds Css_Var::from_id(), which requires + * the kebab charset, while $type stays the DTCG spec spelling. + * + * @since TBD + * + * @param string $type The DTCG $type (spec spelling). + * @param string $slug The terminal slug. + * + * @return string + */ + public static function canonical( string $type, string $slug ): string { + return self::LAYER . '.' . Token_Type::get_id_segment( $type ) . '.' . self::SEGMENT . '.' . $slug; + } + + /** + * Whether a $type supports user-created primitives: registered, full stop. + * + * Before the $type -> id-segment mapping existed, this also required the $type spelling + * itself to be a valid kebab-case id segment, because the raw $type became the id's second + * segment and Token_Definition::from_user_primitive() rejects any segment outside + * ^[a-z0-9]+([.-][a-z0-9]+)*$ (the id feeds Css_Var::from_id()). Token_Type::get_id_segment() + * now supplies a kebab-safe segment for every registered $type, so that second predicate is + * vacuous and has been dropped; every registered $type supports user-created primitives. + * + * Kept as a named method (not inlined to Token_Type::is_valid()) because it is the creation + * gate three call sites and the REST 422 contract hang off, and a future version may + * genuinely want to gate a type again. + * + * @since TBD + * + * @param string $type The candidate DTCG $type. + * + * @return bool + */ + public static function is_supported_type( string $type ): bool { + return Token_Type::is_valid( $type ); + } + + /** + * Whether a dot-path addresses the reserved namespace itself or anything nested below it. + * + * Unlike is_reserved_id(), this also matches a path deeper than a single custom-primitive leaf (e.g. a + * sub-field of a composite value), so a write cannot reach into the namespace at any depth. + * + * @since TBD + * + * @param string $path The dot-path to test. + * + * @return bool + */ + public static function contains_reserved_path( string $path ): bool { + $segments = explode( '.', $path ); + + return count( $segments ) >= 3 + && $segments[0] === self::LAYER + && in_array( $segments[1], Token_Type::get_id_segments(), true ) + && $segments[2] === self::SEGMENT; + } + + /** + * Walk a primitive-layer subtree and collect every path at or below the reserved namespace. + * + * @since TBD + * + * @param array $node The node to walk, e.g. a decoded document's "primitive" subtree. + * @param string $prefix The dot-path prefix of $node, e.g. "primitive". + * + * @return string[] + */ + public static function find_in( array $node, string $prefix ): array { + if ( self::contains_reserved_path( $prefix ) ) { + return [ $prefix ]; + } + + $found = []; + + foreach ( $node as $key => $child ) { + if ( is_string( $key ) && strncmp( $key, '$', 1 ) === 0 ) { + continue; + } + + if ( is_array( $child ) ) { + /** @var array $child */ + $found = array_merge( $found, self::find_in( $child, $prefix . '.' . $key ) ); + } + } + + return $found; + } +} diff --git a/includes/resources/Design_Tokens/Document/Token_Label_Index.php b/includes/resources/Design_Tokens/Document/Token_Label_Index.php new file mode 100644 index 0000000000..4c690f79d8 --- /dev/null +++ b/includes/resources/Design_Tokens/Document/Token_Label_Index.php @@ -0,0 +1,209 @@ + label } + * string map in the module's $extensions namespace. Authoring metadata only: the effective + * document builder strips $extensions, so an override can never reach projected CSS. + * Every mutating method returns the updated document; the original is not modified. + * + * @since TBD + */ +final class Token_Label_Index { + + /** + * All label overrides, keyed by canonical dot-path id. Read-side fail-soft: entries whose + * key or value is not a non-empty string are dropped rather than surfaced, so a + * hand-corrupted section degrades to "no override" instead of a type error downstream. + * A whitespace-only label counts as empty — it would render as a nameless token, which is + * the state an override exists to prevent. + * + * @since TBD + * + * @param array $document + * + * @return array + */ + public function all( array $document ): array { + $map = $this->read_map( $document ); + + if ( ! is_array( $map ) ) { + return []; + } + + $labels = []; + + foreach ( $map as $id => $label ) { + if ( is_string( $id ) && $id !== '' && is_string( $label ) && trim( $label ) !== '' ) { + $labels[ $id ] = $label; + } + } + + return $labels; + } + + /** + * @since TBD + * + * @param array $document + * @param string $id Canonical dot-path id. + * + * @return bool + */ + public function has( array $document, string $id ): bool { + return isset( $this->all( $document )[ $id ] ); + } + + /** + * @since TBD + * + * @param array $document + * @param string $id + * + * @return string|null The override, or null when none is stored. + */ + public function label_for( array $document, string $id ): ?string { + return $this->all( $document )[ $id ] ?? null; + } + + /** + * Store an override. An empty label is refused at the API level — storing an empty label + * is impossible by construction, not merely validated against: clearing is remove(), never + * set( '' ). The controller trims and routes '' to the clear path before this is ever + * called; the throw guards future callers. Whitespace-only is empty here too, matching the + * read side — an entry all() drops must not be storable in the first place. + * + * @since TBD + * + * @param array $document + * @param string $id + * @param string $label + * + * @throws InvalidArgumentException When the label is empty. + * + * @return array + */ + public function set( array $document, string $id, string $label ): array { + if ( trim( $label ) === '' ) { + throw new InvalidArgumentException( 'A token label override cannot be empty; use remove() to clear it.' ); + } + + $ext = Extensions::get_extensions_key(); + $ns = Extensions::get_namespace(); + $sec = Extensions::get_section_token_labels(); + + $document = $this->ensure_path( $document ); + + /** @var array $ext_data */ + $ext_data = $document[ $ext ]; + /** @var array $ns_data */ + $ns_data = $ext_data[ $ns ]; + /** @var array $sec_data */ + $sec_data = $ns_data[ $sec ]; + + $sec_data[ $id ] = $label; + $ns_data[ $sec ] = $sec_data; + $ext_data[ $ns ] = $ns_data; + $document[ $ext ] = $ext_data; + + return $document; + } + + /** + * Remove an override. A no-op (same document returned) when none is stored. + * + * @since TBD + * + * @param array $document + * @param string $id + * + * @return array + */ + public function remove( array $document, string $id ): array { + if ( ! $this->has( $document, $id ) ) { + return $document; + } + + $ext = Extensions::get_extensions_key(); + $ns = Extensions::get_namespace(); + $sec = Extensions::get_section_token_labels(); + + /** @var array $ext_data */ + $ext_data = $document[ $ext ]; + /** @var array $ns_data */ + $ns_data = $ext_data[ $ns ]; + /** @var array $sec_data */ + $sec_data = $ns_data[ $sec ]; + + unset( $sec_data[ $id ] ); + + $ns_data[ $sec ] = $sec_data; + $ext_data[ $ns ] = $ns_data; + $document[ $ext ] = $ext_data; + + return $document; + } + + /** + * @since TBD + * + * @param array $document + * + * @return mixed + */ + private function read_map( array $document ) { + $ext_data = $document[ Extensions::get_extensions_key() ] ?? null; + + if ( ! is_array( $ext_data ) ) { + return null; + } + + $ns_data = $ext_data[ Extensions::get_namespace() ] ?? null; + + if ( ! is_array( $ns_data ) ) { + return null; + } + + return $ns_data[ Extensions::get_section_token_labels() ] ?? null; + } + + /** + * @since TBD + * + * @param array $document + * + * @return array + */ + private function ensure_path( array $document ): array { + $ext = Extensions::get_extensions_key(); + $ns = Extensions::get_namespace(); + $sec = Extensions::get_section_token_labels(); + + if ( ! isset( $document[ $ext ] ) || ! is_array( $document[ $ext ] ) ) { + $document[ $ext ] = []; + } + + /** @var array $ext_data */ + $ext_data = $document[ $ext ]; + + if ( ! isset( $ext_data[ $ns ] ) || ! is_array( $ext_data[ $ns ] ) ) { + $ext_data[ $ns ] = []; + $document[ $ext ] = $ext_data; + } + + /** @var array $ns_data */ + $ns_data = $ext_data[ $ns ]; + + if ( ! isset( $ns_data[ $sec ] ) || ! is_array( $ns_data[ $sec ] ) ) { + $ns_data[ $sec ] = []; + $ext_data[ $ns ] = $ns_data; + $document[ $ext ] = $ext_data; + } + + return $document; + } +} diff --git a/includes/resources/Design_Tokens/Document/Token_Order_Index.php b/includes/resources/Design_Tokens/Document/Token_Order_Index.php new file mode 100644 index 0000000000..566e9f1b24 --- /dev/null +++ b/includes/resources/Design_Tokens/Document/Token_Order_Index.php @@ -0,0 +1,188 @@ + $document + * + * @return list + */ + public function all( array $document ): array { + $ids = $this->read_list( $document ); + + if ( ! is_array( $ids ) ) { + return []; + } + + // The `$ids === []` check is required, not redundant: `range( 0, -1 )` returns + // `[ 0, -1 ]` in PHP, not `[]`, so without this short-circuit an empty order list would be + // misclassified as malformed rather than as a valid empty list. + $is_list = $ids === [] || array_keys( $ids ) === range( 0, count( $ids ) - 1 ); + + if ( ! $is_list ) { + return []; + } + + return array_values( array_filter( $ids, fn( $id ) => is_string( $id ) && $id !== '' ) ); + } + + /** + * Store one group's order wholesale (the endpoint's PUT-replaces contract): the target + * group's own ids are removed from the flat list and the new sequence is re-appended, leaving + * every other group's relative order untouched, since only relative position within a group is + * ever read. Deduplicates the incoming ids, keeping first occurrence. + * + * @since TBD + * + * @param array $document + * @param array $group_ids The full set of token ids registered in the target group, + * used to isolate that group's entries within the flat list. + * @param array $ids The group's new ordered id list. + * + * @return array + */ + public function set_group( array $document, array $group_ids, array $ids ): array { + $ids = array_values( array_unique( $ids ) ); + + $remaining = array_values( array_diff( $this->all( $document ), $group_ids ) ); + + return $this->write_list( $document, array_merge( $remaining, $ids ) ); + } + + /** + * Remove one group's ids from the stored order — declaration order applies again for that + * group. No-op (the same document is returned) when the group has no ids currently stored. + * + * @since TBD + * + * @param array $document + * @param array $group_ids The full set of token ids registered in the target group. + * + * @return array + */ + public function remove_group( array $document, array $group_ids ): array { + $current = $this->all( $document ); + $remaining = array_values( array_diff( $current, $group_ids ) ); + + if ( $remaining === $current ) { + return $document; + } + + return $this->write_list( $document, $remaining ); + } + + /** + * @since TBD + * + * @param array $document + * + * @return mixed + */ + private function read_list( array $document ) { + $ext_data = $document[ Extensions::get_extensions_key() ] ?? null; + + if ( ! is_array( $ext_data ) ) { + return null; + } + + $ns_data = $ext_data[ Extensions::get_namespace() ] ?? null; + + if ( ! is_array( $ns_data ) ) { + return null; + } + + return $ns_data[ Extensions::get_section_token_order() ] ?? null; + } + + /** + * @since TBD + * + * @param array $document + * @param array $ids + * + * @return array + */ + private function write_list( array $document, array $ids ): array { + $document = $this->ensure_path( $document ); + + $ext = Extensions::get_extensions_key(); + $ns = Extensions::get_namespace(); + $sec = Extensions::get_section_token_order(); + + /** @var array $ext_data */ + $ext_data = $document[ $ext ]; + /** @var array $ns_data */ + $ns_data = $ext_data[ $ns ]; + + $ns_data[ $sec ] = $ids; + $ext_data[ $ns ] = $ns_data; + $document[ $ext ] = $ext_data; + + return $document; + } + + /** + * @since TBD + * + * @param array $document + * + * @return array + */ + private function ensure_path( array $document ): array { + $ext = Extensions::get_extensions_key(); + $ns = Extensions::get_namespace(); + $sec = Extensions::get_section_token_order(); + + if ( ! isset( $document[ $ext ] ) || ! is_array( $document[ $ext ] ) ) { + $document[ $ext ] = []; + } + + /** @var array $ext_data */ + $ext_data = $document[ $ext ]; + + if ( ! isset( $ext_data[ $ns ] ) || ! is_array( $ext_data[ $ns ] ) ) { + $ext_data[ $ns ] = []; + $document[ $ext ] = $ext_data; + } + + /** @var array $ns_data */ + $ns_data = $ext_data[ $ns ]; + + if ( ! isset( $ns_data[ $sec ] ) || ! is_array( $ns_data[ $sec ] ) ) { + $ns_data[ $sec ] = []; + $ext_data[ $ns ] = $ns_data; + $document[ $ext ] = $ext_data; + } + + return $document; + } +} diff --git a/includes/resources/Design_Tokens/Document/Token_Reference.php b/includes/resources/Design_Tokens/Document/Token_Reference.php new file mode 100644 index 0000000000..43efada8ad --- /dev/null +++ b/includes/resources/Design_Tokens/Document/Token_Reference.php @@ -0,0 +1,123 @@ +kind = $kind; + $this->path = $path; + $this->supported = $supported; + } + + /** + * @since TBD + * + * @return string + */ + public static function get_kind_semantic_override(): string { + return self::KIND_SEMANTIC_OVERRIDE; + } + + /** + * @since TBD + * + * @return string + */ + public static function get_kind_composite_field(): string { + return self::KIND_COMPOSITE_FIELD; + } + + /** + * @since TBD + * + * @return string + */ + public static function get_kind_primitive_override(): string { + return self::KIND_PRIMITIVE_OVERRIDE; + } + + /** + * @since TBD + * + * @return string + */ + public static function get_kind_extension(): string { + return self::KIND_EXTENSION; + } +} diff --git a/includes/resources/Design_Tokens/Document/Token_Reference_Policy.php b/includes/resources/Design_Tokens/Document/Token_Reference_Policy.php new file mode 100644 index 0000000000..5844d984b4 --- /dev/null +++ b/includes/resources/Design_Tokens/Document/Token_Reference_Policy.php @@ -0,0 +1,273 @@ + $document The decoded stored overrides document. + * @param string $primitive_id The canonical dot-path of the target primitive. + * + * @return Token_Reference[] + */ + public function find( array $document, string $primitive_id ): array { + $alias = '{' . $primitive_id . '}'; + $references = []; + + $this->scan_token_layers( $document, $alias, $references ); + $this->scan_extensions( $document, $alias, $references ); + + return $references; + } + + /** + * Whether all found references are supported (i.e. deletion is safe to proceed). + * + * @since TBD + * + * @param Token_Reference[] $references + * + * @return bool + */ + public function all_supported( array $references ): bool { + foreach ( $references as $ref ) { + if ( ! $ref->supported ) { + return false; + } + } + + return true; + } + + /** + * Whether every found reference is a direct $value alias in the semantic layer. + * + * Narrower than `all_supported()`: a primitive-layer direct alias is rewritable by the + * rename cascade (so it counts as "supported" there), but it is not a location a fresh + * write may use to introduce a reference into the reserved user-primitive namespace from + * outside the semantic layer. Write-time guards use this check instead of `all_supported()` + * for that reason. + * + * @since TBD + * + * @param Token_Reference[] $references + * + * @return bool + */ + public function all_semantic_overrides( array $references ): bool { + foreach ( $references as $ref ) { + if ( $ref->kind !== Token_Reference::get_kind_semantic_override() ) { + return false; + } + } + + return true; + } + + /** + * Walk the primitive and semantic token layers for alias references. + * + * @since TBD + * + * @param array $document + * @param string $alias + * @param Token_Reference[] $references + * + * @return void + */ + private function scan_token_layers( array $document, string $alias, array &$references ): void { + foreach ( Layers::token_layers() as $layer ) { + if ( ! isset( $document[ $layer ] ) || ! is_array( $document[ $layer ] ) ) { + continue; + } + + $is_semantic = $layer === 'semantic'; + $this->walk_node( $document[ $layer ], $layer, $alias, $is_semantic, $references ); + } + } + + /** + * Walk one node, classifying every alias match. + * + * @since TBD + * + * @param array $node + * @param string $prefix + * @param string $alias + * @param bool $is_semantic + * @param Token_Reference[] $references + * + * @return void + */ + private function walk_node( array $node, string $prefix, string $alias, bool $is_semantic, array &$references ): void { + foreach ( $node as $key => $child ) { + if ( is_string( $key ) && strncmp( $key, '$', 1 ) === 0 ) { + continue; + } + + if ( ! is_array( $child ) ) { + continue; + } + + $path = $prefix . '.' . $key; + + if ( ! array_key_exists( '$value', $child ) ) { + $this->walk_node( $child, $path, $alias, $is_semantic, $references ); + + continue; + } + + $value = $child['$value']; + + if ( $value === $alias ) { + $kind = $is_semantic + ? Token_Reference::get_kind_semantic_override() + : Token_Reference::get_kind_primitive_override(); + $references[] = new Token_Reference( $kind, $path, true ); + + continue; + } + + if ( is_array( $value ) ) { + $this->scan_composite_value( + $value, + $path . '.$value', + $alias, + Token_Reference::get_kind_composite_field(), + $references + ); + } + } + } + + /** + * Recursively scan a composite $value structure for alias references at any nesting depth. + * Generic over shape so future composite/list sub-fields cannot silently bypass detection. + * + * @since TBD + * + * @param array $value + * @param string $prefix + * @param string $alias + * @param string $kind + * @param Token_Reference[] $references + * + * @return void + */ + private function scan_composite_value( array $value, string $prefix, string $alias, string $kind, array &$references ): void { + foreach ( $value as $field => $sub_value ) { + $path = $prefix . '.' . $field; + + if ( $sub_value === $alias ) { + $references[] = new Token_Reference( $kind, $path, false ); + + continue; + } + + if ( is_array( $sub_value ) ) { + $this->scan_composite_value( $sub_value, $path, $alias, $kind, $references ); + } + } + } + + /** + * Scan $extensions for alias references. + * + * @since TBD + * + * @param array $document + * @param string $alias + * @param Token_Reference[] $references + * + * @return void + */ + private function scan_extensions( array $document, string $alias, array &$references ): void { + $ext_root = $document[ Extensions::get_extensions_key() ] ?? null; + + if ( ! is_array( $ext_root ) ) { + return; + } + + $ext = $ext_root[ Extensions::get_namespace() ] ?? null; + + if ( ! is_array( $ext ) ) { + return; + } + + foreach ( Extensions::get_sections() as $section ) { + if ( ! isset( $ext[ $section ] ) || ! is_array( $ext[ $section ] ) ) { + continue; + } + + $base = Extensions::get_extensions_key() . '.' . Extensions::get_namespace() . '.' . $section; + + $this->scan_extension_section( $ext[ $section ], $base, $alias, $references ); + } + } + + /** + * @since TBD + * + * @param array $section + * @param string $prefix + * @param string $alias + * @param Token_Reference[] $references + * + * @return void + */ + private function scan_extension_section( array $section, string $prefix, string $alias, array &$references ): void { + foreach ( $section as $group => $presets ) { + if ( ! is_array( $presets ) ) { + continue; + } + + foreach ( $presets as $preset_name => $preset ) { + if ( $preset_name === Extensions::get_default_key() || ! is_array( $preset ) ) { + continue; + } + + $tokens = $preset[ Extensions::get_tokens_key() ] ?? null; + + if ( ! is_array( $tokens ) ) { + continue; + } + + foreach ( $tokens as $token_path => $value ) { + $path = $prefix . '.' . $group . '.' . $preset_name . '.' . Extensions::get_tokens_key() . '.' . $token_path; + + if ( $value === $alias ) { + $references[] = new Token_Reference( Token_Reference::get_kind_extension(), $path, false ); + + continue; + } + + if ( is_array( $value ) ) { + $this->scan_composite_value( $value, $path, $alias, Token_Reference::get_kind_extension(), $references ); + } + } + } + } + } +} diff --git a/includes/resources/Design_Tokens/Document/Token_Sorter.php b/includes/resources/Design_Tokens/Document/Token_Sorter.php new file mode 100644 index 0000000000..1d2edf124c --- /dev/null +++ b/includes/resources/Design_Tokens/Document/Token_Sorter.php @@ -0,0 +1,94 @@ +order_index = $order_index; + } + + /** + * The flat ordered token id list stored on a decoded library document, empty when it carries none. + * + * @since TBD + * + * @param array $document The decoded library document. + * + * @return list The flat ordered token id list. + */ + public function order_for( array $document ): array { + return $this->order_index->all( $document ); + } + + /** + * Permute one group's rows by the stored flat order. + * + * An empty order returns the rows untouched (declaration order), so removing the stored order + * restores declaration order with no other code path involved. + * + * @since TBD + * + * @template TRow of array + * + * @param array $rows The group's rows, each carrying an `id` key. + * @param array $order The flat ordered token id list. + * + * @return array The same rows, permuted. + */ + public function sort( array $rows, array $order ): array { + if ( $order === [] ) { + return $rows; + } + + $positions = array_flip( $order ); + $ordered = []; + $unordered = []; + + foreach ( $rows as $row ) { + if ( isset( $positions[ $row['id'] ] ) ) { + $ordered[] = $row; + } else { + $unordered[] = $row; // Not in the stored order — declaration order, appended after. + } + } + + usort( $ordered, fn( array $a, array $b ): int => $positions[ $a['id'] ] <=> $positions[ $b['id'] ] ); + + return array_merge( $ordered, $unordered ); + } +} diff --git a/includes/resources/Design_Tokens/Document/User_Primitive_Document_Validator.php b/includes/resources/Design_Tokens/Document/User_Primitive_Document_Validator.php new file mode 100644 index 0000000000..c2e768db17 --- /dev/null +++ b/includes/resources/Design_Tokens/Document/User_Primitive_Document_Validator.php @@ -0,0 +1,217 @@ +.custom.* leaves of supported types are accepted. + * + * @since TBD + */ +final class User_Primitive_Document_Validator { + + /** + * @since TBD + * + * @var User_Primitive_Index + */ + private User_Primitive_Index $index; + + /** + * @since TBD + * + * @var Baseline_Document + */ + private Baseline_Document $baseline; + + /** + * @since TBD + * + * @var Token_Registry + */ + private Token_Registry $registry; + + /** + * @since TBD + * + * @param User_Primitive_Index $index Envelope reader. + * @param Baseline_Document $baseline Baseline document, for collision detection. + * @param Token_Registry $registry Registry, for system-token collision detection. + */ + public function __construct( + User_Primitive_Index $index, + Baseline_Document $baseline, + Token_Registry $registry + ) { + $this->index = $index; + $this->baseline = $baseline; + $this->registry = $registry; + } + + /** + * Validate the user-primitive invariant in a candidate document. + * Returns all violations; an empty array means the invariant holds. + * + * @since TBD + * + * @param array $document The decoded candidate overrides document. + * + * @return User_Primitive_Validation_Error[] + */ + public function validate( array $document ): array { + $errors = []; + + foreach ( $this->index->all( $document ) as $id => $entry ) { + $id = (string) $id; + $errors = array_merge( $errors, $this->check_envelope_entry( $document, $id, $entry ) ); + } + + $orphans = $this->find_orphan_leaves( $document ); + + foreach ( $orphans as $orphan_id ) { + $errors[] = new User_Primitive_Validation_Error( + $orphan_id, + sprintf( 'Custom tree leaf "%s" has no provenance envelope entry.', $orphan_id ) + ); + } + + return $errors; + } + + /** + * @since TBD + * + * @param array $document + * @param string $id + * @param array{label?: string, group?: string}|mixed $entry + * + * @return User_Primitive_Validation_Error[] + */ + private function check_envelope_entry( array $document, string $id, $entry ): array { + $errors = []; + + if ( ! Reserved_Namespace::is_reserved_id( $id ) ) { + $errors[] = new User_Primitive_Validation_Error( + $id, + sprintf( 'User primitive id "%s" is not in the allowed namespace (primitive..custom.*).', $id ) + ); + + return $errors; + } + + if ( ! is_array( $entry ) || ! isset( $entry['label'] ) || ! is_string( $entry['label'] ) || $entry['label'] === '' ) { + $errors[] = new User_Primitive_Validation_Error( $id, sprintf( 'User primitive "%s" has a missing or empty label.', $id ) ); + } + + if ( is_array( $entry ) && isset( $entry['group'] ) && ( ! is_string( $entry['group'] ) || ! Reserved_Namespace::is_valid_slug( $entry['group'] ) ) ) { + $errors[] = new User_Primitive_Validation_Error( $id, sprintf( 'User primitive "%s" has an invalid group.', $id ) ); + } + + if ( $this->baseline->has( $id ) ) { + $errors[] = new User_Primitive_Validation_Error( $id, sprintf( 'User primitive "%s" collides with a baseline token.', $id ) ); + } + + $existing = $this->registry->get( $id ); + + if ( $existing !== null && ! $existing->is_user_created() ) { + $errors[] = new User_Primitive_Validation_Error( $id, sprintf( 'User primitive "%s" collides with a system-registered token.', $id ) ); + } + + $leaf = Document_Path::node_at( $document, $id ); + + if ( $leaf === null ) { + $errors[] = new User_Primitive_Validation_Error( $id, sprintf( 'User primitive "%s" envelope entry has no matching tree leaf.', $id ) ); + + return $errors; + } + + $type = $leaf[ Token_Type::get_type_key() ] ?? null; + $segment = explode( '.', $id )[1]; + + if ( ! is_string( $type ) || ! Reserved_Namespace::is_supported_type( $type ) ) { + $errors[] = new User_Primitive_Validation_Error( + $id, + sprintf( 'User primitive "%s" tree leaf has $type "%s"; that type does not support user-created primitives.', $id, Cast::to_string( $type ) ) + ); + } elseif ( Token_Type::get_id_segment( $type ) !== $segment ) { + $errors[] = new User_Primitive_Validation_Error( + $id, + sprintf( 'User primitive "%s" tree leaf declares $type "%s", which does not match its id namespace.', $id, $type ) + ); + } + + if ( ! array_key_exists( '$value', $leaf ) ) { + $errors[] = new User_Primitive_Validation_Error( $id, sprintf( 'User primitive "%s" tree leaf is missing $value.', $id ) ); + } elseif ( Alias::is_alias( $leaf['$value'] ) ) { + $errors[] = new User_Primitive_Validation_Error( + $id, + sprintf( 'User primitive "%s" $value must be a literal; aliases are not allowed on user primitives at this time.', $id ) + ); + } + + return $errors; + } + + /** + * Walk primitive..custom.* for every registered type in the document and return any + * id that has no envelope entry. + * + * This walk terminates one level below "custom": it iterates the direct children of the + * custom group and treats every array child as a leaf slug. It must never descend into a + * node or read $value — a shadow leaf's sub-field map lives inside that opaque node, so + * descending would let color/offsetX/... be mistaken for orphan slugs. The walk stays safe + * because it keys off tree position, not node shape; do not "improve" it into a recursive + * walk. + * + * @since TBD + * + * @param array $document + * + * @return string[] + */ + private function find_orphan_leaves( array $document ): array { + $primitive = $document['primitive'] ?? []; + + if ( ! is_array( $primitive ) ) { + return []; + } + + $orphans = []; + + foreach ( Token_Type::all() as $type ) { + $subtree = $primitive[ Token_Type::get_id_segment( $type ) ] ?? []; + + if ( ! is_array( $subtree ) ) { + continue; + } + + $custom = $subtree['custom'] ?? []; + + if ( ! is_array( $custom ) ) { + continue; + } + + foreach ( $custom as $slug => $node ) { + if ( ! is_string( $slug ) || strncmp( $slug, '$', 1 ) === 0 || ! is_array( $node ) ) { + continue; + } + + $id = Reserved_Namespace::canonical( $type, $slug ); + + if ( ! $this->index->has( $document, $id ) ) { + $orphans[] = $id; + } + } + } + + return $orphans; + } +} diff --git a/includes/resources/Design_Tokens/Document/User_Primitive_Index.php b/includes/resources/Design_Tokens/Document/User_Primitive_Index.php new file mode 100644 index 0000000000..30eeec350b --- /dev/null +++ b/includes/resources/Design_Tokens/Document/User_Primitive_Index.php @@ -0,0 +1,221 @@ + $document + * + * @return array + */ + public function all( array $document ): array { + $map = $this->read_map( $document ); + + return is_array( $map ) ? $map : []; + } + + /** + * @since TBD + * + * @param array $document + * @param string $id Canonical dot-path id. + * + * @return bool + */ + public function has( array $document, string $id ): bool { + return isset( $this->all( $document )[ $id ] ); + } + + /** + * @since TBD + * + * @param array $document + * @param string $id + * + * @return string|null + */ + public function label_for( array $document, string $id ): ?string { + $entry = $this->all( $document )[ $id ] ?? null; + + return is_array( $entry ) ? $entry['label'] : null; + } + + /** + * Write (or overwrite) an entry's label. The group is preserved by default — `null` (the + * default) keeps whatever group the existing entry already stores, so a caller with no group in + * its own request (the label endpoints) never resets one a create or rename request set. A + * string sets the group explicitly; `''` clears it, and an empty group is omitted from the + * entry so a document with no grouped custom tokens stays byte-identical to before this param + * existed. + * + * @since TBD + * + * @param array $document + * @param string $id + * @param string $label + * @param string|null $group Null preserves the existing entry's group; a string sets it. + * + * @return array + */ + public function add( array $document, string $id, string $label, ?string $group = null ): array { + $ext = Extensions::get_extensions_key(); + $ns = Extensions::get_namespace(); + $sec = Extensions::get_section_user_primitives(); + + $document = $this->ensure_path( $document ); + + /** @var array $ext_data */ + $ext_data = $document[ $ext ]; + /** @var array $ns_data */ + $ns_data = $ext_data[ $ns ]; + /** @var array $sec_data */ + $sec_data = $ns_data[ $sec ]; + + if ( $group === null ) { + $existing = $sec_data[ $id ] ?? null; + $group = is_array( $existing ) && is_string( $existing['group'] ?? null ) ? $existing['group'] : ''; + } + + $entry = [ 'label' => $label ]; + + if ( $group !== '' ) { + $entry['group'] = $group; + } + + $sec_data[ $id ] = $entry; + $ns_data[ $sec ] = $sec_data; + $ext_data[ $ns ] = $ns_data; + $document[ $ext ] = $ext_data; + + return $document; + } + + /** + * @since TBD + * + * @param array $document + * @param string $id + * + * @return array + */ + public function remove( array $document, string $id ): array { + if ( ! $this->has( $document, $id ) ) { + return $document; + } + + $ext = Extensions::get_extensions_key(); + $ns = Extensions::get_namespace(); + $sec = Extensions::get_section_user_primitives(); + + /** @var array $ext_data */ + $ext_data = $document[ $ext ]; + /** @var array $ns_data */ + $ns_data = $ext_data[ $ns ]; + /** @var array $sec_data */ + $sec_data = $ns_data[ $sec ]; + + unset( $sec_data[ $id ] ); + + $ns_data[ $sec ] = $sec_data; + $ext_data[ $ns ] = $ns_data; + $document[ $ext ] = $ext_data; + + return $document; + } + + /** + * Swap the old id for the new id, updating the label. The old entry's group carries to the new + * id explicitly — the old entry is gone by the time add() would look for it, so relying on + * add()'s own preserve-by-default lookup here would silently drop the group instead. + * + * @since TBD + * + * @param array $document + * @param string $old_id + * @param string $new_id + * @param string $new_label + * + * @return array + */ + public function rename( array $document, string $old_id, string $new_id, string $new_label ): array { + $old_entry = $this->all( $document )[ $old_id ] ?? null; + $group = is_array( $old_entry ) && is_string( $old_entry['group'] ?? null ) ? $old_entry['group'] : ''; + + $document = $this->remove( $document, $old_id ); + + return $this->add( $document, $new_id, $new_label, $group ); + } + + /** + * @since TBD + * + * @param array $document + * + * @return mixed + */ + private function read_map( array $document ) { + $ext_data = $document[ Extensions::get_extensions_key() ] ?? null; + + if ( ! is_array( $ext_data ) ) { + return null; + } + + $ns_data = $ext_data[ Extensions::get_namespace() ] ?? null; + + if ( ! is_array( $ns_data ) ) { + return null; + } + + return $ns_data[ Extensions::get_section_user_primitives() ] ?? null; + } + + /** + * @since TBD + * + * @param array $document + * + * @return array + */ + private function ensure_path( array $document ): array { + $ext = Extensions::get_extensions_key(); + $ns = Extensions::get_namespace(); + $sec = Extensions::get_section_user_primitives(); + + if ( ! isset( $document[ $ext ] ) || ! is_array( $document[ $ext ] ) ) { + $document[ $ext ] = []; + } + + /** @var array $ext_data */ + $ext_data = $document[ $ext ]; + + if ( ! isset( $ext_data[ $ns ] ) || ! is_array( $ext_data[ $ns ] ) ) { + $ext_data[ $ns ] = []; + $document[ $ext ] = $ext_data; + } + + /** @var array $ns_data */ + $ns_data = $ext_data[ $ns ]; + + if ( ! isset( $ns_data[ $sec ] ) || ! is_array( $ns_data[ $sec ] ) ) { + $ns_data[ $sec ] = []; + $ext_data[ $ns ] = $ns_data; + $document[ $ext ] = $ext_data; + } + + return $document; + } +} diff --git a/includes/resources/Design_Tokens/Document/User_Primitive_Validation_Error.php b/includes/resources/Design_Tokens/Document/User_Primitive_Validation_Error.php new file mode 100644 index 0000000000..0f092d295a --- /dev/null +++ b/includes/resources/Design_Tokens/Document/User_Primitive_Validation_Error.php @@ -0,0 +1,54 @@ +id = $id; + $this->message = $message; + } + + /** + * @since TBD + * + * @return string + */ + public function get_id(): string { + return $this->id; + } + + /** + * @since TBD + * + * @return string + */ + public function get_message(): string { + return $this->message; + } +} diff --git a/includes/resources/Design_Tokens/Editor/Attribute_Default_Catalog.php b/includes/resources/Design_Tokens/Editor/Attribute_Default_Catalog.php new file mode 100644 index 0000000000..15130ad5b7 --- /dev/null +++ b/includes/resources/Design_Tokens/Editor/Attribute_Default_Catalog.php @@ -0,0 +1,90 @@ + attribute => resolved-token dot-path. Each entry's value is looked up via the + * resolver and, when present, exposed to JS as a raw number (this catalog only supports + * numeric attribute defaults today — the one case this ticket has). + * + * @since TBD + * + * @var array> + */ + private const ENTRIES = [ + 'kadence/single-icon' => [ + 'size' => 'semantic.icon-size.default', + ], + ]; + + /** + * @since TBD + * + * @var Token_Resolver + */ + private Token_Resolver $resolver; + + /** + * @since TBD + * + * @param Token_Resolver $resolver The token resolver. + */ + public function __construct( Token_Resolver $resolver ) { + $this->resolver = $resolver; + } + + /** + * The catalog, keyed by block name then attribute name, each value the resolved numeric + * default. A block/attribute whose token does not resolve, or whose resolved value is not a + * convertible numeric length, is omitted — the editor filter falls back to block.json's own + * default for it. + * + * @since TBD + * + * @return array> + */ + public function all(): array { + $resolved = $this->resolver->resolve(); + $out = []; + + foreach ( self::ENTRIES as $block => $attributes ) { + foreach ( $attributes as $attribute => $token_id ) { + $value = $resolved->value( $token_id ); + + if ( $value === null ) { + continue; + } + + $px = $this->to_px( $value ); + + if ( $px === null ) { + continue; + } + + $out[ $block ][ $attribute ] = $px; + } + } + + return $out; + } +} diff --git a/includes/resources/Design_Tokens/Editor/Favorite_Fonts_Catalog.php b/includes/resources/Design_Tokens/Editor/Favorite_Fonts_Catalog.php new file mode 100644 index 0000000000..fbff9a12ea --- /dev/null +++ b/includes/resources/Design_Tokens/Editor/Favorite_Fonts_Catalog.php @@ -0,0 +1,114 @@ +store = $store; + $this->active = $active; + $this->favorites = $favorites; + $this->catalog = $catalog; + } + + /** + * The editor's font list: the active library's favorites in stored order, and the site's custom + * family names. + * + * @since TBD + * + * @return array{favorites: list, custom: string[], manageUrl: string} + */ + public function all(): array { + return [ + 'favorites' => $this->favorites->all( $this->store->get_decoded_document( $this->active->get() ) ), + 'custom' => $this->catalog->all()['custom'], + 'manageUrl' => Menu::get_screen_url( self::MANAGE_SCREEN ), + ]; + } +} diff --git a/includes/resources/Design_Tokens/Editor/Localizer.php b/includes/resources/Design_Tokens/Editor/Localizer.php new file mode 100644 index 0000000000..f941cb404b --- /dev/null +++ b/includes/resources/Design_Tokens/Editor/Localizer.php @@ -0,0 +1,292 @@ + without further escaping. + * + * @since TBD + */ +final class Localizer { + + /** + * The editor script handle the catalogs are attached to (enqueued in class-kadence-blocks-editor-assets). + * + * @since TBD + * + * @var string + */ + private const HANDLE = 'kadence-blocks-early-filters-js'; + + /** + * The JS global the preset picker reads. + * + * @since TBD + * + * @var string + */ + private const PRESETS_OBJECT = 'kadenceDesignTokensPresets'; + + /** + * The JS global the per-block palette selector and library-level palette switch read. + * + * @since TBD + * + * @var string + */ + private const PALETTES_OBJECT = 'kadenceDesignTokensPalettes'; + + /** + * The JS global the block-registration preset-default filter reads. + * + * @since TBD + * + * @var string + */ + private const ATTRIBUTE_DEFAULTS_OBJECT = 'kadenceDesignTokensAttributeDefaults'; + + /** + * The JS global the preset writes read for the REST root, namespace and nonce. + * + * @since TBD + * + * @var string + */ + private const REST_OBJECT = 'kadenceDesignTokensRest'; + + /** + * The JS global the editor token picker's accessor reads (the pickable-token pool). + * + * @since TBD + * + * @var string + */ + private const PICKABLE_OBJECT = 'kadenceDesignTokensPickable'; + + /** + * The JS global the editor's font-family picker reads (the active library's favorite families and + * the site's custom family names). + * + * @since TBD + * + * @var string + */ + private const FONTS_OBJECT = 'kadenceDesignTokensFonts'; + + /** + * The token registry, for the fail-closed gate. + * + * @since TBD + * + * @var Token_Registry + */ + private Token_Registry $registry; + + /** + * The preset catalog builder. + * + * @since TBD + * + * @var Preset_Catalog + */ + private Preset_Catalog $preset_catalog; + + /** + * The per-block attribute-default catalog builder. + * + * @since TBD + * + * @var Attribute_Default_Catalog + */ + private Attribute_Default_Catalog $attribute_defaults; + + /** + * The pickable-token pool builder. + * + * @since TBD + * + * @var Pickable_Tokens_Catalog + */ + private Pickable_Tokens_Catalog $pickable; + + /** + * The color-palette catalog builder. + * + * @since TBD + * + * @var Palette_Catalog + */ + private Palette_Catalog $palette_catalog; + + /** + * The favorite-fonts catalog builder. + * + * @since TBD + * + * @var Favorite_Fonts_Catalog + */ + private Favorite_Fonts_Catalog $favorite_fonts; + + /** + * @since TBD + * + * @param Token_Registry $registry The token registry. + * @param Preset_Catalog $preset_catalog The preset catalog builder. + * @param Attribute_Default_Catalog $attribute_defaults The per-block attribute-default catalog builder. + * @param Pickable_Tokens_Catalog $pickable The pickable-token pool builder. + * @param Palette_Catalog $palette_catalog The color-palette catalog builder. + * @param Favorite_Fonts_Catalog $favorite_fonts The favorite-fonts catalog builder. + */ + public function __construct( + Token_Registry $registry, + Preset_Catalog $preset_catalog, + Attribute_Default_Catalog $attribute_defaults, + Pickable_Tokens_Catalog $pickable, + Palette_Catalog $palette_catalog, + Favorite_Fonts_Catalog $favorite_fonts + ) { + $this->registry = $registry; + $this->preset_catalog = $preset_catalog; + $this->attribute_defaults = $attribute_defaults; + $this->pickable = $pickable; + $this->palette_catalog = $palette_catalog; + $this->favorite_fonts = $favorite_fonts; + } + + /** + * Attach the editor-only catalogs to the editor bundle, when that bundle is on the page and the + * registry is active. + * + * @since TBD + * + * @return void + */ + public function localize(): void { + if ( ! wp_script_is( self::HANDLE, 'enqueued' ) ) { + return; // Not an editor screen with the bundle — nothing to attach to. + } + + if ( ! $this->registry->is_active() ) { + return; // Fail-closed: no projection, so offer nothing. + } + + $this->attach( self::HANDLE, self::PRESETS_OBJECT, $this->preset_catalog->all() ); + $this->attach( self::HANDLE, self::PALETTES_OBJECT, $this->palette_catalog->all() ); + $this->attach( self::HANDLE, self::ATTRIBUTE_DEFAULTS_OBJECT, $this->attribute_defaults->all() ); + $this->attach( self::HANDLE, self::REST_OBJECT, $this->rest() ); + $this->attach( self::HANDLE, self::FONTS_OBJECT, $this->favorite_fonts->all() ); + } + + /** + * Attach the pickable-token pool alone to whichever of {@see pickable_handles()} is enqueued, + * when the registry is active. + * + * @since TBD + * + * @return void + */ + public function localize_pickable(): void { + if ( ! $this->registry->is_active() ) { + return; // Fail-closed: no projection, so offer nothing. + } + + $handle = $this->resolve_pickable_handle(); + + if ( $handle === null ) { + return; // Neither bundle is on this screen. + } + + $this->attach( $handle, self::PICKABLE_OBJECT, $this->pickable->all() ); + } + + /** + * The first {@see pickable_handles()} entry enqueued on the current screen. + * + * @since TBD + * + * @return string|null + */ + private function resolve_pickable_handle(): ?string { + foreach ( $this->pickable_handles() as $handle ) { + if ( wp_script_is( $handle, 'enqueued' ) ) { + return $handle; + } + } + + return null; + } + + /** + * Script handles that receive the pickable-token pool, in resolution order: the editor bundle, + * then the Style Library admin bundle. Only the first found enqueued is used. + * + * @since TBD + * + * @return string[] + */ + private function pickable_handles(): array { + return [ + self::HANDLE, + Asset_Loader::get_script_handle(), + ]; + } + + /** + * The REST descriptor the editor's preset writes POST to: the wp-json root, the v1 namespace, and a + * nonce. Mirrors the admin feed's descriptor so the editor's presets client reuses the same middleware. + * + * @since TBD + * + * @return array{root: string, namespace: string, nonce: string} + */ + private function rest(): array { + return [ + 'root' => esc_url_raw( rest_url() ), + 'namespace' => Controller::namespace(), + 'nonce' => wp_create_nonce( 'wp_rest' ), + ]; + } + + /** + * Encode a catalog and attach it to a script handle as a window global. A catalog that cannot be + * serialized is skipped rather than injected as malformed JS. + * + * @since TBD + * + * @param string $handle The script handle to attach the inline script to. + * @param string $global_name The window global name to assign. + * @param array $catalog The catalog payload to encode. + * + * @return void + */ + private function attach( string $handle, string $global_name, array $catalog ): void { + $json = wp_json_encode( + $catalog, + JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT + ); + + if ( $json === false ) { + return; // Catalog cannot be serialized — skip rather than inject malformed JS. + } + + wp_add_inline_script( + $handle, + 'window.' . $global_name . ' = ' . $json . ';', + 'before' + ); + } +} diff --git a/includes/resources/Design_Tokens/Editor/Palette_Catalog.php b/includes/resources/Design_Tokens/Editor/Palette_Catalog.php new file mode 100644 index 0000000000..b4301dfff1 --- /dev/null +++ b/includes/resources/Design_Tokens/Editor/Palette_Catalog.php @@ -0,0 +1,122 @@ +, current: , palettes: [ { id, label } ], slots: { : } }`. + * Localized to `window.kadenceDesignTokensPalettes` by {@see Localizer}, so a control can offer the library's + * palettes and resolve a palette slot to its token reference without a REST round-trip; edits still write through + * the palette REST surface. The `slots` map is the editor's single source for the slot -> alias binding, mirroring + * the projection declared in `declarations.php`. + * + * @since TBD + */ +final class Palette_Catalog { + + /** + * The active-library pointer, so the catalog reports the library the editor renders by default. + * + * @since TBD + * + * @var Active_Token_Library_Store + */ + private Active_Token_Library_Store $active; + + /** + * The effective-palettes reader, source of the active library's palettes and its `$current` pointer. + * + * @since TBD + * + * @var Effective_Palettes + */ + private Effective_Palettes $palettes; + + /** + * The token registry, source of the palette-slot -> token bindings the `slots` map exposes. + * + * @since TBD + * + * @var Token_Registry + */ + private Token_Registry $registry; + + /** + * @since TBD + * + * @param Active_Token_Library_Store $active The active-library pointer. + * @param Effective_Palettes $palettes The effective-palettes reader. + * @param Token_Registry $registry The token registry. + */ + public function __construct( Active_Token_Library_Store $active, Effective_Palettes $palettes, Token_Registry $registry ) { + $this->active = $active; + $this->palettes = $palettes; + $this->registry = $registry; + } + + /** + * The palette catalog for the active library: its palettes as `{ id, label }`, the `current` palette id, and + * the active library slug. + * + * @since TBD + * + * @return array{active: string, current: string, palettes: array, slots: array} + */ + public function all(): array { + $slug = $this->active->get(); + $section = $this->palettes->section( $slug ); + + $palettes = []; + + foreach ( $this->palettes->palette_ids( $slug ) as $id ) { + $node = $section[ $id ] ?? []; + $label = is_array( $node ) ? ( $node[ Extensions::get_label_key() ] ?? $id ) : $id; + + $palettes[] = [ + 'id' => $id, + 'label' => is_string( $label ) && $label !== '' ? $label : $id, + ]; + } + + return [ + 'active' => $slug, + 'current' => $this->palettes->current( $slug ), + 'palettes' => $palettes, + 'slots' => $this->slots(), + ]; + } + + /** + * The global-palette slot -> token-alias map: each token that claims a Kadence palette slot + * (`palette1`…`palette9`) keyed by its slug, valued by the `{dot.alias}` a control stores to reference + * it. Resolved through {@see Kadence_Palette_Slot} so the slot set can never drift from the projection, + * making `declarations.php` the single source of truth. + * + * @since TBD + * + * @return array slug => `{alias}`. + */ + private function slots(): array { + $slots = []; + + foreach ( $this->registry->all() as $token ) { + $slot = Kadence_Palette_Slot::from_token( $token ); + + if ( $slot !== null ) { + $slots[ $slot->slug ] = Alias::wrap( $token->id ); + } + } + + return $slots; + } +} diff --git a/includes/resources/Design_Tokens/Editor/Pickable_Tokens_Catalog.php b/includes/resources/Design_Tokens/Editor/Pickable_Tokens_Catalog.php new file mode 100644 index 0000000000..c4eff66971 --- /dev/null +++ b/includes/resources/Design_Tokens/Editor/Pickable_Tokens_Catalog.php @@ -0,0 +1,302 @@ + ( id => literal )) used ONLY for the picker's preview + * swatch/number — a pick writes the alias, never the literal. A library whose stored document cannot be + * resolved (alias cycle / dangling alias from a raw DB write) is skipped, so one corrupt library never + * empties the pool; structure is registry-driven and always ships. + * + * Nothing downstream reorders the pool — the picker only filters and partitions it — so the order the + * user dragged tokens into on the Style Library screen has to be applied here or not at all. It is + * applied group by group through the shared {@see Token_Sorter}, exactly as the admin feed applies it, + * and read from the ACTIVE library: `tokens` is one shared structure rather than a per-library one, so + * it honors the order of the library the editor renders by default (the same pointer the feed reads), + * and a picker opened against another library keeps that ordering. + * + * @since TBD + */ +final class Pickable_Tokens_Catalog { + + /** + * The id segment wrapping the dimension primitives (`primitive.dimension..`). Semantic + * dimension tokens carry no such wrapper (`semantic..`), so it is normalized away in + * role derivation to make both layers report the same role for the same sub-kind. + * + * @since TBD + * + * @var string + */ + private const DIMENSION_GROUP = 'dimension'; + + /** + * The token registry, source of the registered token structure. + * + * @since TBD + * + * @var Token_Registry + */ + private Token_Registry $registry; + + /** + * The token resolver, source of each library's resolved literal values (by id). + * + * @since TBD + * + * @var Token_Resolver + */ + private Token_Resolver $resolver; + + /** + * The persistence gateway, source of the stored library slugs. + * + * @since TBD + * + * @var Token_Store + */ + private Token_Store $store; + + /** + * The active-library pointer, naming the library whose stored sort order the pool honors. + * + * @since TBD + * + * @var Active_Token_Library_Store + */ + private Active_Token_Library_Store $active; + + /** + * The shared stored-order permutation, applied one group at a time. + * + * @since TBD + * + * @var Token_Sorter + */ + private Token_Sorter $sorter; + + /** + * @since TBD + * + * @param Token_Registry $registry The token registry. + * @param Token_Resolver $resolver The token resolver. + * @param Token_Store $store The persistence gateway. + * @param Active_Token_Library_Store $active The active-library pointer. + * @param Token_Sorter $sorter The shared stored-order permutation. + */ + public function __construct( + Token_Registry $registry, + Token_Resolver $resolver, + Token_Store $store, + Active_Token_Library_Store $active, + Token_Sorter $sorter + ) { + $this->registry = $registry; + $this->resolver = $resolver; + $this->store = $store; + $this->active = $active; + $this->sorter = $sorter; + } + + /** + * The pool: the pickable token structure plus the per-library resolved preview values. + * + * @since TBD + * + * @return array{tokens: array, values: array>} + */ + public function all(): array { + return [ + 'tokens' => $this->tokens(), + 'values' => $this->values(), + ]; + } + + /** + * The pickable token structure: one { id, alias, label, type, layer, role } entry per registered + * token, in the active library's stored sort order within each UI group, registry insertion order + * for the ids that order does not mention. Library-independent — values live in values(). + * + * @since TBD + * + * @return array + */ + private function tokens(): array { + $tokens = []; + $slots = []; + + foreach ( $this->registry->all() as $token ) { + $slots[ $token->group ][] = count( $tokens ); + + $tokens[] = [ + 'id' => $token->id, + 'alias' => Alias::wrap( $token->id ), + 'label' => $token->label, + 'type' => $token->type, + 'layer' => $this->layer_of( $token->id ), + 'role' => $this->role_of( $token->id, $token->group_key ), + ]; + } + + return $this->apply_order( $tokens, $slots ); + } + + /** + * Permute the flat pool by the active library's stored order, one UI group at a time. + * + * Grouping is by the token's `group` — the very bucket {@see Token_Registry::to_ui_schema()} keys + * the admin feed's schema by, and therefore the bucket the Style Library's per-group reorder writes + * against. That is what makes the pool agree with the screen: a custom token interleaves only among + * the built-ins of its own group, never across the whole pool. The picker's `role` looks like a + * cheaper partition but is a different one — a derivation off the id that can span two groups. + * + * Each group's entries are written back into the very slots they already occupied, so the pool's + * overall sequence is unchanged except within a group. The picker's type-only filter and its + * semantic-before-primitive ranking read the pool as one flat list, and both keep behaving exactly + * as they did before any order was stored. + * + * @since TBD + * + * @param array $tokens The pool in registry order. + * @param array> $slots UI group => the pool positions its tokens occupy. + * + * @return array The pool, permuted. + */ + private function apply_order( array $tokens, array $slots ): array { + $order = $this->sorter->order_for( $this->store->get_decoded_document( $this->active->get() ) ); + + if ( $order === [] ) { + return $tokens; + } + + foreach ( $slots as $positions ) { + $sorted = $this->sorter->sort( + array_map( static fn( int $position ): array => $tokens[ $position ], $positions ), + $order + ); + + foreach ( $positions as $slot => $position ) { + $tokens[ $position ] = $sorted[ $slot ]; + } + } + + return $tokens; + } + + /** + * The sub-kind role a token id carries — the discriminator that splits one DTCG `$type` into the + * distinct things a control picks from: `dimension` fans out to `radius`, `spacing`, `gap`, + * `border-width`, `icon-size`, `font-size`, and so on. Derived from the id, not stored: the role is + * the segment right after the layer (`semantic..…`, `primitive..…`), except the + * dimension primitives nest it one level deeper under the `dimension` wrapper + * (`primitive.dimension..`), which is normalized away so a semantic and a primitive + * token of the same sub-kind report the same role. An id with no role segment yields "". + * + * A user-minted scale token nests `custom` where the sub-kind would be + * (`primitive.dimension.custom.`), so the id alone reports the literal `custom`. In that one + * case the real sub-kind is taken from the token's `group_key` — the group the "+ Add …" flow minted + * it into, whose vocabulary is the role vocabulary — falling back to the id-derived `custom` when the + * token carries no group_key. Only `primitive.dimension.custom.*` derives role `custom`, so no other + * token (colors included, which carry no machine group_key) is affected. + * + * @since TBD + * + * @param string $id The token id (a dot-path). + * @param string $group_key The token's group_key, used to recover a custom dimension token's sub-kind. + * + * @return string The role sub-kind, or "" when the id carries none. + */ + private function role_of( string $id, string $group_key ): string { + $segments = explode( '.', $id ); + + if ( ( $segments[0] ?? '' ) === Layers::get_primitive() && ( $segments[1] ?? '' ) === self::DIMENSION_GROUP ) { + $role = $segments[2] ?? ''; + + if ( $role === Reserved_Namespace::get_segment() && $group_key !== '' ) { + return $group_key; + } + + return $role; + } + + return $segments[1] ?? ''; + } + + /** + * The layer a token id lives in, derived from its first dot-segment: `semantic` for a semantic-layer + * id, `primitive` otherwise. Derivation, not lookup — the registry keeps no per-layer index, and the + * layer is by construction the id's leading segment (the document walk registers ids under their + * top-level layer key). + * + * @since TBD + * + * @param string $id The token id (a dot-path). + * + * @return string The layer name (semantic | primitive). + */ + private function layer_of( string $id ): string { + $first = explode( '.', $id )[0]; + + return $first === Layers::get_semantic() ? Layers::get_semantic() : Layers::get_primitive(); + } + + /** + * The per-library resolved preview values: `library slug => ( token id => literal CSS value )`, for + * every stored library plus the always-present default. Used only for the picker's swatch/number + * preview — a pick writes the alias, so a stale or missing value is cosmetic. A library whose stored + * document cannot be resolved is skipped, so one corrupt library never empties the map. + * + * @since TBD + * + * @return array> library slug => ( id => literal value ). + */ + private function values(): array { + $values = []; + + foreach ( $this->library_slugs() as $slug ) { + try { + $values[ $slug ] = $this->resolver->resolve( $slug )->by_id(); + } catch ( Alias_Cycle_Exception | Dangling_Alias_Exception $e ) { + continue; // Corrupt stored document — skip this library, fail soft. + } + } + + return $values; + } + + /** + * The library slugs to resolve values for: every stored library plus the always-present default. + * + * @since TBD + * + * @return string[] + */ + private function library_slugs(): array { + $slugs = array_map( 'strval', array_column( $this->store->list_stores(), 'slug' ) ); + + if ( ! in_array( Token_Store::default_slug(), $slugs, true ) ) { + array_unshift( $slugs, Token_Store::default_slug() ); + } + + return $slugs; + } +} diff --git a/includes/resources/Design_Tokens/Editor/Preset_Catalog.php b/includes/resources/Design_Tokens/Editor/Preset_Catalog.php new file mode 100644 index 0000000000..e987e5dc7f --- /dev/null +++ b/includes/resources/Design_Tokens/Editor/Preset_Catalog.php @@ -0,0 +1,383 @@ +, libraries: { : { : {…} } } }`. Per block it carries the `$default` slug, the + * named presets as { slug, label, userCreated }, the picker control label, the controllable surface as + * { key, kind, token, control_attr } per bound property so the form can render one input per property, a + * per-preset resolved-value map ({ preset slug => { property => literal } }) so a control can compare + * its current value against the selected preset's value, and a per-preset "own override" map + * ({ preset slug => { property => true } }) distinguishing a preset's genuine stored value from one it + * only inherits from the baseline's own definition of that preset slug. + * + * Every block with preset bindings appears, but only a PICKER set (one that declares a `label`) is given + * preset OPTIONS; a block's preset / default-preset bindings (no label) carry an empty `presets` list, which + * is what keeps the editor from rendering a picker where the declaration says there is none. The two are + * separate concerns: the options drive the preset dropdown, while `properties` drives the per-control token + * picker, and a block can want the second without the first — kadence/single-icon's Icon Size is exactly + * that case. + * + * It carries no resolved token values beyond those per-preset literals, so it cannot raise the alias-cycle + * errors the admin feed must guard; preset bindings registered but absent from a token library + * (Unknown_Preset_Exception) are skipped, so one undefined block never empties the catalog. + * + * @since TBD + */ +final class Preset_Catalog { + + /** + * The token registry, source of the registered preset-bindings blocks and their bindings. + * + * @since TBD + * + * @var Token_Registry + */ + private Token_Registry $registry; + + /** + * The preset resolver, source of each block's default, names and labels per library. + * + * @since TBD + * + * @var Preset_Resolver + */ + private Preset_Resolver $presets; + + /** + * The persistence gateway, source of the stored library slugs. + * + * @since TBD + * + * @var Token_Store + */ + private Token_Store $store; + + /** + * The active-library pointer, so the catalog can report which library the editor renders by default. + * + * @since TBD + * + * @var Active_Token_Library_Store + */ + private Active_Token_Library_Store $active; + + /** + * The effective-presets reader, source of each preset's user-created provenance per library. + * + * @since TBD + * + * @var Effective_Presets + */ + private Effective_Presets $effective; + + /** + * @since TBD + * + * @param Token_Registry $registry The token registry. + * @param Preset_Resolver $presets The preset resolver. + * @param Token_Store $store The persistence gateway. + * @param Active_Token_Library_Store $active The active-library pointer. + * @param Effective_Presets $effective The effective-presets reader. + */ + public function __construct( + Token_Registry $registry, + Preset_Resolver $presets, + Token_Store $store, + Active_Token_Library_Store $active, + Effective_Presets $effective + ) { + $this->registry = $registry; + $this->presets = $presets; + $this->store = $store; + $this->active = $active; + $this->effective = $effective; + } + + /** + * The catalog: the active library slug plus the per-block catalog for every library. + * + * @since TBD + * + * @return array{active: string, libraries: array>} + */ + public function all(): array { + $libraries = []; + + foreach ( $this->library_slugs() as $slug ) { + $libraries[ $slug ] = $this->for_library( $slug ); + } + + return [ + 'active' => $this->active->get(), + 'libraries' => $libraries, + ]; + } + + /** + * The per-block catalog for one token library. Only PICKER preset bindings are surfaced; a block's preset / + * default-preset bindings (with no `label`) have no picker, so they are skipped. + * + * @since TBD + * + * @param string $slug The token library slug. + * + * @return array> block => { default, presets, properties, values, + * references, responsive, overridden, label }. + */ + private function for_library( string $slug ): array { + $out = []; + + foreach ( $this->registry->preset_binding_blocks() as $block ) { + $bindings = $this->registry->for_block( $block ); + + if ( $bindings === null ) { + continue; + } + + try { + $names = $this->presets->names( $block, $slug ); + $default = $this->presets->default_preset( $block, $slug ); + } catch ( Unknown_Preset_Exception $e ) { + continue; // Set registered but not defined in this token library — skip, fail soft. + } + + $out[ $block ] = [ + 'default' => $default, + // Only a picker-driven set offers preset OPTIONS. A block whose bindings declare no label + // gets an empty list, which is what keeps the editor from rendering a picker where the + // declaration says there is none. + 'presets' => $bindings->label === null ? [] : $this->preset_options( $block, $slug, $names ), + 'properties' => $this->properties_for( $bindings ), + 'values' => $this->values_for( $block, $slug, $names ), + 'references' => $this->references_for( $block, $slug, $names ), + 'responsive' => $this->responsive_for( $block, $slug, $names ), + 'overridden' => $this->overridden_for( $block, $slug, $names ), + 'label' => $bindings->label, + ]; + } + + return $out; + } + + /** + * A block's preset options for the picker: { slug, label, userCreated } per named preset, in catalog + * order. + * + * @since TBD + * + * @param string $block The block name. + * @param string $slug The token library slug. + * @param string[] $names The preset slugs, in catalog order. + * + * @return array The picker's options. + */ + private function preset_options( string $block, string $slug, array $names ): array { + $user_created = $this->effective->user_created( $block, $slug ); + $options = []; + + foreach ( $names as $name ) { + $options[] = [ + 'slug' => $name, + 'label' => $this->presets->label( $block, $name, $slug ) ?? $name, + 'userCreated' => in_array( $name, $user_created, true ), + ]; + } + + return $options; + } + + /** + * The controllable surface for a block's preset bindings: one { key, kind, token, control_attr, axis } + * entry per bound property, in binding order, so the editor form renders an input per property and the + * indicator layer can key an override signal to the control attribute. Structure read from the preset + * bindings. + * + * `axis` is non-null only for a property sharing one composite `control_attr` with its siblings (the + * border trio), and names which slot of that nested value this property owns. It is what lets the editor + * recognize the shape from the declaration instead of from a hardcoded list of property names, so a + * second block declaring the same composite under different property keys works with no editor change. + * + * @since TBD + * + * @param Preset_Bindings $bindings The block's preset bindings. + * + * @return array, axis: string|null}> + */ + private function properties_for( Preset_Bindings $bindings ): array { + $properties = []; + + foreach ( $bindings->bindings as $property => $binding ) { + $properties[] = [ + 'key' => (string) $property, + 'kind' => $bindings->kind( (string) $property ), + 'token' => $binding->token, + 'control_attr' => $binding->control_attr(), + 'responsive_attrs' => $binding->responsive_attrs(), + 'axis' => $binding->axis(), + ]; + } + + return $properties; + } + + /** + * The per-preset resolved values for a block's library: `preset slug => ( property => literal CSS value )`, + * so the editor can compare a control's current value against the selected preset's value to decide + * bound-vs-overridden. Values are flattened literals (hex / length), matching the swatch feed — a control + * cannot compare against a `var()` chain. A preset whose resolution fails (undefined in this library) is + * skipped, so one bad preset never empties the map. + * + * A dimension property whose preset stores per-corner values carries the corners as a list rather than + * a joined string, so the editor's compare and the control's inherited-default display read each corner + * on its own — a joined shorthand is not parseable as a single length. + * + * @since TBD + * + * @param string $block The block name. + * @param string $slug The token library slug. + * @param string[] $names The preset slugs to resolve, in catalog order. + * + * @return array> preset slug => ( property => literal value or + * per-corner slot list ). + */ + private function values_for( string $block, string $slug, array $names ): array { + $values = []; + + foreach ( $names as $name ) { + try { + $values[ $name ] = $this->presets->resolve_literal( $block, $name, $slug ); + } catch ( Unknown_Preset_Exception $e ) { + continue; // Preset undefined in this library — skip, fail soft. + } + } + + return $values; + } + + /** + * The per-preset CSS REFERENCES for a block's library: `preset slug => ( property => var() chain )`, + * the same strings the projected CSS uses. + * + * The sibling of `values_for()`, and deliberately not a replacement for it — the two answer different + * questions. A literal is what a control compares against to decide bound-vs-overridden, because a + * `var()` chain cannot be compared to a stored hex. A reference is what the editor PAINTS with when it + * has to resolve a preset value itself rather than let a stylesheet do it. + * + * The difference matters wherever a token's value depends on something the flattening has already + * discarded. A per-block color palette is exactly that: the projector emits a `[data-kb-palette]` layer + * that redefines the token variables, and the editor mirrors the block's selected palette onto the block + * wrapper, so a `var()` reference resolves through whichever palette the block is on. A literal was + * resolved against the default palette before it ever reached the editor and cannot follow the block. + * + * @since TBD + * + * @param string $block The block name. + * @param string $slug The token library slug. + * @param string[] $names The preset slugs to resolve, in catalog order. + * + * @return array> preset slug => ( property => `var()` chain ). + */ + private function references_for( string $block, string $slug, array $names ): array { + $references = []; + + foreach ( $names as $name ) { + try { + $references[ $name ] = $this->presets->resolve( $block, $name, $slug ); + } catch ( Unknown_Preset_Exception $e ) { + continue; // Preset undefined in this library — skip, fail soft. + } + } + + return $references; + } + + /** + * The per-breakpoint resolved values for a block's library: `preset slug => ( breakpoint => ( property + * => literal ) )`, flattened for the same reason `values_for()` flattens — a control cannot compare + * against a `var()` chain. + * + * A preset that declares no breakpoint overrides carries an empty map rather than being absent, so the + * editor can read `responsive[preset]` unconditionally. A preset whose resolution fails is skipped, + * matching `values_for()`. + * + * @since TBD + * + * @param string $block The block name. + * @param string $slug The token library slug. + * @param string[] $names The preset slugs to resolve, in catalog order. + * + * @return array>> preset slug => ( breakpoint => + * ( property => literal value ) ). + */ + private function responsive_for( string $block, string $slug, array $names ): array { + $responsive = []; + + foreach ( $names as $name ) { + try { + $responsive[ $name ] = $this->presets->resolve_responsive_literal( $block, $name, $slug ); + } catch ( Unknown_Preset_Exception $e ) { + continue; // Preset undefined in this library — skip, fail soft. + } + } + + return $responsive; + } + + /** + * Which properties EACH preset genuinely has its own stored override for, as opposed to + * `values_for()`'s merged/effective read, which cannot tell a preset's own override apart from a + * value it only inherits from the baseline's own definition of that same preset slug (a NAMED + * preset the baseline itself ships — `$default`/other shipped slugs — can have real baseline values + * for properties nobody has ever explicitly set). A control reads this to decide whether an unset + * field should show as bound to the merged value (this preset has its own override) or as a muted + * generic default (nothing here is this preset's own). + * + * @since TBD + * + * @param string $block The block name. + * @param string $slug The token library slug. + * @param string[] $names The preset slugs to inspect, in catalog order. + * + * @return array> preset slug => ( property => true ), only for + * properties the preset's OWN stored tokens carry. + */ + private function overridden_for( string $block, string $slug, array $names ): array { + $overridden = []; + + foreach ( $names as $name ) { + $overridden[ $name ] = $this->effective->owned_properties( $block, $name, $slug ); + } + + return $overridden; + } + + /** + * The library slugs to build the catalog for: every stored library plus the always-present default. + * + * @since TBD + * + * @return string[] + */ + private function library_slugs(): array { + $slugs = array_map( 'strval', array_column( $this->store->list_stores(), 'slug' ) ); + + if ( ! in_array( Token_Store::default_slug(), $slugs, true ) ) { + array_unshift( $slugs, Token_Store::default_slug() ); + } + + return $slugs; + } +} diff --git a/includes/resources/Design_Tokens/Editor/Provider.php b/includes/resources/Design_Tokens/Editor/Provider.php new file mode 100644 index 0000000000..8536220acd --- /dev/null +++ b/includes/resources/Design_Tokens/Editor/Provider.php @@ -0,0 +1,44 @@ +container->singleton( Preset_Catalog::class ); + $this->container->singleton( Palette_Catalog::class ); + $this->container->singleton( Attribute_Default_Catalog::class ); + $this->container->singleton( Pickable_Tokens_Catalog::class ); + $this->container->singleton( Localizer::class ); + + /** + * The editor-assets class enqueues kadence-blocks-early-filters-js on enqueue_block_editor_assets at + * the default priority (10). The Localizer attaches its inline script to that handle, so it must run + * strictly LATER — a higher priority guarantees the handle exists, where matching 10 would leave the + * order registration-dependent. 20 sits clear of that default with headroom for others to slot + * between. The Localizer also guards on wp_script_is( …, 'enqueued' ), so a missing handle no-ops + * rather than triggering a fatal error. + */ + add_action( 'enqueue_block_editor_assets', $this->container->callback( Localizer::class, 'localize' ), 20 ); + + // admin_head fires after both bundles' own enqueue, so either handle is already registered. + add_action( 'admin_head', $this->container->callback( Localizer::class, 'localize_pickable' ) ); + } +} diff --git a/includes/resources/Design_Tokens/Foundation_Presets/Catalog.php b/includes/resources/Design_Tokens/Foundation_Presets/Catalog.php new file mode 100644 index 0000000000..ae7f776236 --- /dev/null +++ b/includes/resources/Design_Tokens/Foundation_Presets/Catalog.php @@ -0,0 +1,189 @@ +.foundationPresets..` and are read-only here — applying a choice + * (which seeds the primitive layer as store overrides) is {@see Selector}. + * + * The baseline is the single source of truth; this class never holds its own copy of the catalogue. + * + * @since TBD + */ +final class Catalog { + + /** + * @var Baseline_Document The shipped, read-only baseline the catalogue is read from. + * + * @since TBD + */ + private Baseline_Document $baseline; + + /** + * @since TBD + * + * @param Baseline_Document $baseline The shipped baseline document. + */ + public function __construct( Baseline_Document $baseline ) { + $this->baseline = $baseline; + } + + /** + * The available preset group keys, e.g. ["typeScale"]. + * + * @since TBD + * + * @return string[] + */ + public function groups(): array { + return array_keys( $this->catalogue() ); + } + + /** + * The selectable presets in a group as slug => label, with the structural "$default" key skipped. + * + * @since TBD + * + * @param string $group The preset group key. + * + * @throws Unknown_Preset_Exception When the group does not exist. + * + * @return array + */ + public function options( string $group ): array { + $options = []; + + foreach ( $this->group_set( $group ) as $slug => $preset ) { + if ( $slug === Extensions::get_default_key() || ! is_array( $preset ) ) { + continue; + } + + $label = $preset[ Extensions::get_label_key() ] ?? ''; + + $options[ (string) $slug ] = is_string( $label ) && $label !== '' ? $label : (string) $slug; + } + + return $options; + } + + /** + * The group's default preset slug, or an empty string when none is declared. + * + * @since TBD + * + * @param string $group The preset group key. + * + * @throws Unknown_Preset_Exception When the group does not exist. + * + * @return string + */ + public function default_for( string $group ): string { + $default = $this->group_set( $group )[ Extensions::get_default_key() ] ?? ''; + + return is_string( $default ) ? $default : ''; + } + + /** + * A preset's flat token map: primitive dot-path => raw value. This is what {@see Selector} + * turns into store overrides. + * + * @since TBD + * + * @param string $group The preset group key. + * @param string $choice The preset slug within the group. + * + * @throws Unknown_Preset_Exception When the group or choice does not exist. + * + * @return array + */ + public function tokens_for( string $group, string $choice ): array { + $set = $this->group_set( $group ); + + // "$default" names a preset, it is not one itself. + if ( $choice === Extensions::get_default_key() || ! isset( $set[ $choice ] ) || ! is_array( $set[ $choice ] ) ) { + throw Unknown_Preset_Exception::for_choice( $group, $choice ); + } + + $tokens = $set[ $choice ][ Extensions::get_tokens_key() ] ?? []; + + return is_array( $tokens ) ? $tokens : []; + } + + /** + * The union of every token dot-path any preset in the group touches — the group's "footprint". + * + * {@see Selector} uses this to make a selection replace the group wholesale: paths the chosen + * preset omits are cleared rather than left behind, so switching presets can never leave a previous + * preset's exclusive paths applied. + * + * @since TBD + * + * @param string $group The preset group key. + * + * @throws Unknown_Preset_Exception When the group does not exist. + * + * @return string[] Dot-paths, de-duplicated. + */ + public function group_paths( string $group ): array { + $paths = []; + + foreach ( array_keys( $this->options( $group ) ) as $slug ) { + foreach ( array_keys( $this->tokens_for( $group, (string) $slug ) ) as $path ) { + $paths[ (string) $path ] = true; + } + } + + return array_keys( $paths ); + } + + /** + * The presets in a group (named presets plus the "$default" key), or throw when the group is unknown. + * + * @since TBD + * + * @param string $group The preset group key. + * + * @throws Unknown_Preset_Exception When the group does not exist. + * + * @return array + */ + private function group_set( string $group ): array { + $catalogue = $this->catalogue(); + + if ( ! isset( $catalogue[ $group ] ) || ! is_array( $catalogue[ $group ] ) ) { + throw Unknown_Preset_Exception::for_group( $group ); + } + + return $catalogue[ $group ]; + } + + /** + * The whole foundation-presets section from the baseline, or an empty array when absent. + * + * @since TBD + * + * @return array + */ + private function catalogue(): array { + $node = $this->baseline->document(); + + foreach ( [ Extensions::get_extensions_key(), Extensions::get_namespace(), Extensions::get_section_foundation_presets() ] as $key ) { + if ( ! is_array( $node ) || ! isset( $node[ $key ] ) ) { + return []; + } + + $node = $node[ $key ]; + } + + return is_array( $node ) ? $node : []; + } +} diff --git a/includes/resources/Design_Tokens/Foundation_Presets/Exception/Unknown_Preset_Exception.php b/includes/resources/Design_Tokens/Foundation_Presets/Exception/Unknown_Preset_Exception.php new file mode 100644 index 0000000000..95853dc7cf --- /dev/null +++ b/includes/resources/Design_Tokens/Foundation_Presets/Exception/Unknown_Preset_Exception.php @@ -0,0 +1,55 @@ +container->singleton( Catalog::class, Catalog::class ); + $this->container->singleton( Selector::class, Selector::class ); + } +} diff --git a/includes/resources/Design_Tokens/Foundation_Presets/Selector.php b/includes/resources/Design_Tokens/Foundation_Presets/Selector.php new file mode 100644 index 0000000000..0679e2b9d5 --- /dev/null +++ b/includes/resources/Design_Tokens/Foundation_Presets/Selector.php @@ -0,0 +1,249 @@ + raw value`) becomes a full override leaf `{ $type, $value }`; the $type is sourced from + * the baseline leaf at the same dot-path, because the Resolver's deep-merge replaces a token leaf + * WHOLESALE, so an override missing its $type would break the per-$type CSS renderer downstream. + * + * Selecting a preset is a **clean swap**: the group's whole footprint (every path any preset in the + * group can touch) is cleared first, then the chosen preset's paths are written. So switching presets + * never leaves an earlier preset's exclusive paths applied — and a manual override within the footprint + * is discarded by a later preset selection. Re-selecting the current preset is a no-op (no write). + * + * Persisting through {@see Token_Store::save_document()} bumps the library version and fires + * `kadence_blocks_design_tokens_changed`, so every projector and cache reacts automatically. + * + * @since TBD + */ +final class Selector { + + /** + * @var Catalog The catalogue reader the chosen preset's tokens and the group footprint come from. + * + * @since TBD + */ + private Catalog $catalog; + + /** + * @var Baseline_Document The baseline each override leaf's $type is sourced from. + * + * @since TBD + */ + private Baseline_Document $baseline; + + /** + * @var Token_Store The sole gateway the seeded overrides are persisted through. + * + * @since TBD + */ + private Token_Store $store; + + /** + * @since TBD + * + * @param Catalog $catalog The catalogue reader. + * @param Baseline_Document $baseline The shipped baseline document. + * @param Token_Store $store The persistence gateway. + */ + public function __construct( Catalog $catalog, Baseline_Document $baseline, Token_Store $store ) { + $this->catalog = $catalog; + $this->baseline = $baseline; + $this->store = $store; + } + + /** + * Seed the primitive layer from a foundation-preset choice and persist it as store overrides. + * + * @since TBD + * + * @param string $group The preset group key, e.g. "typeScale". + * @param string $choice The preset slug within the group, e.g. "goldenRatio". + * @param string|null $slug The token library to write to. Defaults to the single v1 "default" library. + * + * @throws Unknown_Preset_Exception|RuntimeException When the group/choice does not exist, a preset + * token targets a dot-path the baseline has no $type for, or the overrides cannot be encoded. + * + * @return void + */ + public function apply( string $group, string $choice, ?string $slug = null ): void { + $slug ??= Token_Store::default_slug(); + + // Resolve first: an unknown choice throws here, before the store is touched, so a bad call writes + // nothing. + $tokens = $this->catalog->tokens_for( $group, $choice ); + + // Tolerates an absent/empty/malformed row as "no overrides yet", so a fresh site seeds onto a + // clean slate. + $document = $this->store->get_decoded_document( $slug ); + $original = $document; + + // Clear the group's whole footprint, then write the chosen preset — a clean swap, so a preset the + // choice omits can never persist from a previous selection. + foreach ( $this->catalog->group_paths( $group ) as $dot_path ) { + $this->unset_leaf( $document, $dot_path ); + } + + foreach ( $tokens as $dot_path => $value ) { + $leaf = [ + Token_Type::get_type_key() => $this->baseline_type( (string) $dot_path ), + Sentinels::get_value_key() => $value, + ]; + + $this->set_leaf( $document, (string) $dot_path, $leaf ); + } + + // No-op guard: re-selecting the current preset (or any selection that nets no change) leaves the + // document equal to what is stored, so skip the write rather than bump the version, fire the + // changed action and churn history for nothing. Loose equality ignores key order, which clearing + // then re-writing the same paths can shuffle. + if ( $document == $original ) { // phpcs:ignore Universal.Operators.StrictComparisons.LooseEqual + return; + } + + $json = wp_json_encode( $document ); + + // Encoding only fails on non-UTF-8 / malformed input; preset values are baseline-derived scalars, + // so this guards a should-never-happen rather than silently saving an empty (baseline) document. + if ( $json === false ) { + throw new RuntimeException( 'Failed to encode the seeded design-token overrides to JSON.' ); + } + + $this->store->save_document( $json, $slug ); + } + + /** + * The concrete $type the baseline declares for a token dot-path. + * + * @since TBD + * + * @param string $dot_path A token dot-path, e.g. "primitive.fontSize.lg". + * + * @throws Unknown_Preset_Exception When the baseline has no concrete $type at the path. + * + * @return string + */ + private function baseline_type( string $dot_path ): string { + $node = $this->baseline->document(); + + foreach ( explode( '.', $dot_path ) as $segment ) { + if ( ! is_array( $node ) || ! array_key_exists( $segment, $node ) ) { + throw Unknown_Preset_Exception::for_missing_baseline_type( $dot_path ); + } + + $node = $node[ $segment ]; + } + + $type_key = Token_Type::get_type_key(); + + if ( ! is_array( $node ) || ! isset( $node[ $type_key ] ) || ! is_string( $node[ $type_key ] ) ) { + throw Unknown_Preset_Exception::for_missing_baseline_type( $dot_path ); + } + + return $node[ $type_key ]; + } + + /** + * Set an override leaf at a dot-path, creating intermediate groups as needed. A leaf replaces + * whatever sits at the path wholesale — preset tokens always target a primitive leaf. + * + * @since TBD + * + * @param array $document The overrides document, mutated in place. + * @param string $dot_path The token dot-path to write. + * @param array $leaf The DTCG leaf to set. + * + * @return void + */ + private function set_leaf( array &$document, string $dot_path, array $leaf ): void { + $segments = explode( '.', $dot_path ); + $last = (int) array_key_last( $segments ); + $node = &$document; + + foreach ( $segments as $index => $segment ) { + if ( $index === $last ) { + $node[ $segment ] = $leaf; + + break; + } + + // Descend into a group, creating one where the path is absent, non-array, or currently a leaf. + // A leaf and its children can't coexist, so a stray override leaf on an ancestor path is + // replaced rather than merged into (mirrors Effective_Document: a leaf is never a group). + if ( + ! isset( $node[ $segment ] ) + || ! is_array( $node[ $segment ] ) + || array_key_exists( Sentinels::get_value_key(), $node[ $segment ] ) + ) { + $node[ $segment ] = []; + } + + $node = &$node[ $segment ]; + } + + unset( $node ); + } + + /** + * Remove the leaf at a dot-path, pruning any ancestor group left empty by the removal so the + * overrides document stays sparse (no `primitive: { fontSize: {} }` residue). A no-op when the path + * is absent. + * + * @since TBD + * + * @param array $node The current group node, mutated in place. + * @param string $dot_path The token dot-path to remove. + * + * @return void + */ + private function unset_leaf( array &$node, string $dot_path ): void { + $this->unset_segments( $node, explode( '.', $dot_path ) ); + } + + /** + * Recursive worker for {@see unset_leaf()}: walk the remaining segments, unset the final key, then + * prune the parent if the removal emptied it. + * + * @since TBD + * + * @param array $node The current group node, mutated in place. + * @param string[] $segments The remaining dot-path segments. + * + * @return void + */ + private function unset_segments( array &$node, array $segments ): void { + $segment = array_shift( $segments ); + + if ( $segment === null || ! array_key_exists( $segment, $node ) ) { + return; + } + + if ( $segments === [] ) { + unset( $node[ $segment ] ); + + return; + } + + if ( ! is_array( $node[ $segment ] ) ) { + return; + } + + $this->unset_segments( $node[ $segment ], $segments ); + + if ( $node[ $segment ] === [] ) { + unset( $node[ $segment ] ); + } + } +} diff --git a/includes/resources/Design_Tokens/Projection/Adapter/Contracts/Abstract_Adapter.php b/includes/resources/Design_Tokens/Projection/Adapter/Contracts/Abstract_Adapter.php new file mode 100644 index 0000000000..045299a226 --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Adapter/Contracts/Abstract_Adapter.php @@ -0,0 +1,35 @@ + $attributes The block's attributes. + * + * @return array The transformed attributes. + */ + public function apply( array $attributes ): array; +} diff --git a/includes/resources/Design_Tokens/Projection/Adapter/Icon_Size_Adapter.php b/includes/resources/Design_Tokens/Projection/Adapter/Icon_Size_Adapter.php new file mode 100644 index 0000000000..9fd4a8617c --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Adapter/Icon_Size_Adapter.php @@ -0,0 +1,93 @@ +resolver = $resolver; + } + + /** + * @inheritDoc + * + * @since TBD + * + * @param array $attributes The block's registration default attributes. + * + * @return array The transformed default attributes. + */ + public function apply( array $attributes ): array { + $length = $this->resolver->resolve()->value( self::TOKEN ); + + if ( $length === null ) { + return $attributes; + } + + $px = $this->to_px( $length ); + + if ( $px === null ) { + return $attributes; + } + + $attributes['size'] = $px; + + return $attributes; + } +} diff --git a/includes/resources/Design_Tokens/Projection/Adapter/Projector.php b/includes/resources/Design_Tokens/Projection/Adapter/Projector.php new file mode 100644 index 0000000000..9496f60adf --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Adapter/Projector.php @@ -0,0 +1,67 @@ +registry = $registry; + } + + /** + * Run the block's adapter over its attributes, returning the transformed attributes. + * + * @since TBD + * + * @param array $attributes The block's attributes. + * @param string $block The Kadence Blocks block name, e.g. "kadence/advancedheading". + * + * @return array The transformed attributes; unchanged when the block has no adapter. + */ + public function apply( array $attributes, string $block ): array { + // Respect the fail-closed guard: when projection is disabled (e.g. a declared token is missing + // from the baseline) leave the attributes as KB stored them rather than half-transforming them. + if ( ! $this->registry->is_active() ) { + return $attributes; + } + + $adapter = $this->registry->adapter_for_block( $block ); + + if ( $adapter === null ) { + return $attributes; + } + + try { + return $adapter->apply( $attributes ); + } catch ( Throwable $e ) { + // This runs in the render path: a faulty adapter must never fatal a page, so fail soft to the + // untransformed attributes, matching the block-preset projector. + return $attributes; + } + } +} diff --git a/includes/resources/Design_Tokens/Projection/Adapter/Provider.php b/includes/resources/Design_Tokens/Projection/Adapter/Provider.php new file mode 100644 index 0000000000..1a22a549f9 --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Adapter/Provider.php @@ -0,0 +1,74 @@ +[] + */ + private const ADAPTERS = [ + Icon_Size_Adapter::class, + ]; + + /** + * @inheritDoc + * + * @since TBD + */ + public function register(): void { + $this->container->singleton( Projector::class ); + + // Register the adapters on init at priority 10 — after the token declarations (priority 0) and the + // baseline guard (priority 1) so an adapter that depends on declared tokens sees a populated + // registry, and on a round increment that leaves room for other code to register adapters before + // us. The filter below then looks each adapter up by block. + add_action( 'init', [ $this, 'register_adapters' ], 10 ); + + add_filter( + 'kadence_blocks_block_default_attributes', + $this->container->callback( Projector::class, 'apply' ), + 20, + 2 + ); + } + + /** + * Register the declared adapters against the Token Registry. + * + * @since TBD + * + * @return void + */ + public function register_adapters(): void { + /** @var Token_Registry $registry */ + $registry = $this->container->get( Token_Registry::class ); + + foreach ( self::ADAPTERS as $adapter ) { + /** @var Adapter_Interface $instance */ + $instance = $this->container->get( $adapter ); + $registry->register_adapter( $instance ); + } + } +} diff --git a/includes/resources/Design_Tokens/Projection/Adapter/Responsive_Attribute_Writer.php b/includes/resources/Design_Tokens/Projection/Adapter/Responsive_Attribute_Writer.php new file mode 100644 index 0000000000..c00624d878 --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Adapter/Responsive_Attribute_Writer.php @@ -0,0 +1,87 @@ +` / `tablet` / `mobile`, the shape render_measure_output() + * and similar sibling-attribute renderers read. + * + * A breakpoint with no override is left empty rather than back-filled with the desktop value, so the + * block's own renderer skips it and the desktop value cascades — the same "absent = inherit base" + * semantics the css-var projection uses. + * + * This is the write-back mechanism the discrete responsive tokens need for a block that consumes a raw + * attribute instead of a css-var. No shipped block declares such a binding today — kadence/singlebtn + * reads the `--kb-token--*` vars directly and is responsive through the per-media-query redeclaration + * with no write-back — so this is intentionally not wired into any Adapter yet; it exists so the first + * block that adopts a responsive raw-attribute binding has a tested seam to build on. Pure: no + * WordPress calls, no globals. + * + * @since TBD + */ +final class Responsive_Attribute_Writer { + + /** + * The resolved token maps a value and its per-breakpoint overrides are read from. + * + * @since TBD + * + * @var Resolved_Tokens + */ + private Resolved_Tokens $resolved; + + /** + * @since TBD + * + * @param Resolved_Tokens $resolved The resolved token maps. + */ + public function __construct( Resolved_Tokens $resolved ) { + $this->resolved = $resolved; + } + + /** + * The indexed [desktop, tablet, mobile] array for a token, for a render_typography sub-value. An absent + * breakpoint override is an empty string so the block renderer inherits the desktop value there. + * + * @since TBD + * + * @param string $id The token id. + * + * @return array{0: string, 1: string, 2: string} + */ + public function indexed( string $id ): array { + return [ + (string) ( $this->resolved->value( $id ) ?? '' ), + (string) ( $this->resolved->value_at( $id, Responsive::get_tablet_key() ) ?? '' ), + (string) ( $this->resolved->value_at( $id, Responsive::get_mobile_key() ) ?? '' ), + ]; + } + + /** + * The suffixed sibling attributes for a token: the desktop attribute plus its tablet / mobile siblings + * (``, `tablet`, `mobile`). An absent breakpoint override is an empty string. + * + * @since TBD + * + * @param string $id The token id. + * @param string $attribute The desktop attribute name (e.g. "padding"). + * + * @return array Attribute name => value, ready to array_merge into a block's attributes. + */ + public function siblings( string $id, string $attribute ): array { + return [ + $attribute => (string) ( $this->resolved->value( $id ) ?? '' ), + 'tablet' . ucfirst( $attribute ) => (string) ( $this->resolved->value_at( $id, Responsive::get_tablet_key() ) ?? '' ), + 'mobile' . ucfirst( $attribute ) => (string) ( $this->resolved->value_at( $id, Responsive::get_mobile_key() ) ?? '' ), + ]; + } +} diff --git a/includes/resources/Design_Tokens/Projection/Block_Default_Css/Css_Builder.php b/includes/resources/Design_Tokens/Projection/Block_Default_Css/Css_Builder.php new file mode 100644 index 0000000000..1171f4ccaf --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Block_Default_Css/Css_Builder.php @@ -0,0 +1,384 @@ +, var(, ))` — which is the seam through which a block's + * *selected* preset reaches a property delivered this way; see {@see self::declaration_value()}. Pure: no + * WordPress calls; the wiring lives in {@see Projector}. + * + * @since TBD + */ +final class Css_Builder { + + use Composes_Selector_Suffix; + use Sanitizes_Css_Value; + + /** + * Object-cache group shared with the rest of the Design Tokens module. + * + * @since TBD + * + * @var string + */ + private const CACHE_GROUP = 'kb_design_tokens'; + + /** + * The registry the preset bindings are read from. + * + * @since TBD + * + * @var Token_Registry + */ + private Token_Registry $registry; + + /** + * Resolves each block's `$default` preset to its `property => value` map. + * + * @since TBD + * + * @var Preset_Resolver + */ + private Preset_Resolver $presets; + + /** + * Resolves a library to its canonical id map — the authoritative set of tokens the Css_Var projector + * emits a `--kb-token--` variable for. A binding whose token id is absent from it points at a + * variable no projector defines, so this is what "backed" is tested against (not the registry's declared + * subset, which omits baseline-only semantic tokens such as `semantic.color.text`). + * + * @since TBD + * + * @var Token_Resolver + */ + private Token_Resolver $resolver; + + /** + * Logger for the unresolved-token diagnostics; the bound instance writes to the PHP error log under + * WP_DEBUG and is a NullLogger otherwise (see {@see \KadenceWP\KadenceBlocks\Log\Log_Provider}). + * + * @since TBD + * + * @var LoggerInterface + */ + private LoggerInterface $logger; + + /** + * Per-request memo keyed on context (front end / editor) + store version + slug, so repeated builds + * within a request are free and a write (which bumps the version) invalidates it without an explicit + * purge. The context is part of the key because the editor build can differ from the front-end one. + * + * @since TBD + * + * @var array + */ + private array $memo = []; + + /** + * @since TBD + * + * @param Token_Registry $registry The token registry. + * @param Preset_Resolver $presets The preset resolver. + * @param Token_Resolver $resolver Resolves a library to its canonical id map, for the backed-token check. + * @param LoggerInterface $logger Logger for the unresolved-token diagnostics. + */ + public function __construct( Token_Registry $registry, Preset_Resolver $presets, Token_Resolver $resolver, LoggerInterface $logger ) { + $this->registry = $registry; + $this->presets = $presets; + $this->resolver = $resolver; + $this->logger = $logger; + } + + /** + * Build the block-default dimension CSS for a token library. Empty when no registered block binds a + * `css_prop`. + * + * @since TBD + * + * @param string $slug The token library whose resolved values the `$default` aliases resolve against. + * + * @return string The CSS, or an empty string when there is nothing to project. + */ + public function css( string $slug = 'default' ): string { + return $this->build( $slug, false ); + } + + /** + * Build the EDITOR-scoped version of the block-default CSS for a token library. Identical to {@see self::css()} + * for every block whose editor markup matches its saved markup (e.g. Image, Single Icon, Row Layout) — the + * front-end selector is reused verbatim. Two independent declarations move it where they differ. A block + * declaring a set-level `editor_selector` (currently Advanced Heading) has its rule target + * `.editor-styles-wrapper ` instead, so the default lands on the element the editor + * actually renders the bindings against rather than the `useBlockProps()` wrapper. A binding declaring + * `editor_css_selector` (currently the Section's, whose editor renders `.kadence-inner-column-inner` where + * `save.js` renders `.kt-inside-inner-col`) swaps the DESCENDANT suffix for that property alone. + * + * @since TBD + * + * @param string $slug The token library whose resolved values the `$default` aliases resolve against. + * + * @return string The CSS, or an empty string when there is nothing to project. + */ + public function editor_css( string $slug = 'default' ): string { + return $this->build( $slug, true ); + } + + /** + * Cached version of css(): memoized per request and persisted in the object cache keyed on the store + * version (and plugin version), so a token write (which bumps the store version) and a plugin upgrade + * both invalidate it automatically. + * + * @since TBD + * + * @param string $version The store version the resolved library was built from. + * @param string $slug The token library slug. + * + * @return string + */ + public function css_for_version( string $version, string $slug ): string { + return $this->for_version( $version, $slug, false ); + } + + /** + * Cached version of editor_css(): same memo/object-cache mechanics as {@see self::css_for_version()}, but + * keyed under a distinct `editor:` context so the editor-scoped string (which differs from the front-end + * one for any block declaring an `editor_selector`, or any binding declaring an `editor_css_selector`) + * never collides with, or gets served in place of, the front-end cache entry. + * + * @since TBD + * + * @param string $version The store version the resolved library was built from. + * @param string $slug The token library slug. + * + * @return string + */ + public function editor_css_for_version( string $version, string $slug ): string { + return $this->for_version( $version, $slug, true ); + } + + /** + * Shared build for both {@see self::css()} and {@see self::editor_css()}; only the selector differs, per + * block from a set-level `editor_selector` declaration and per property from a binding's + * `editor_css_selector`. + * + * @since TBD + * + * @param string $slug The token library whose resolved values the `$default` aliases resolve against. + * @param bool $editor Whether to build the editor-scoped preset. + * + * @return string The CSS, or an empty string when there is nothing to project. + */ + private function build( string $slug, bool $editor ): string { + $css = ''; + + foreach ( $this->registry->preset_binding_blocks() as $block ) { + $bindings = $this->registry->for_block( $block ); + + if ( $bindings === null ) { + continue; + } + + try { + // A block may carry bindings before the document defines its `$default`; that is not an error, + // it simply contributes nothing yet, so skip it rather than fail the whole build. + $values = $this->presets->resolve_default( $block, $slug ); + } catch ( RuntimeException $e ) { + continue; + } + + // The canonical id map of the library — the exact set the Css_Var projector emits a + // `--kb-token--` variable for. resolve_default() above already warmed this memoized + // resolution, so it is a free lookup here (and cannot throw when resolve_default() did not). + $resolved = $this->resolver->resolve( $slug ); + + $selector = $editor && $bindings->editor_selector !== null + ? '.editor-styles-wrapper ' . $bindings->editor_selector + : '.wp-block-' . str_replace( '/', '-', $block ); + + // Group declarations by selector suffix so a block with several dimension props on the same + // element emits one rule, and props on a descendant (e.g. " img") get their own. + $by_suffix = []; + + foreach ( $values as $property => $value ) { + $binding = $bindings->binding( $property ); + + // Only a token-referencing binding that names a css_prop contributes; the variable it points + // at is the referenced token's. An empty resolved value would produce a rule that resolves to + // nothing in the browser, so skip it. + if ( $binding === null || ! $binding->is_token_ref() ) { + continue; + } + + // A state binding (`:hover` and friends) belongs to the selected-preset projector alone. This + // layer renders only the `$default` preset, so its rule carries no preset class and matches + // every instance of the block — and a state rule outranks the block's own resting + // per-instance rule, so emitting one here would repaint content that never opted into a state. + // See Binding::CSS_STATE. + if ( $binding->is_state() ) { + continue; + } + + $prop = $binding->css_prop(); + + // A per-corner slot list is a CSS shorthand here — this is a css-emitting surface, so the + // corners join into one declaration value (the resolver keeps them apart for the editor). + $literal = is_array( $value ) ? implode( ' ', $value ) : $value; + + if ( $prop === null || $literal === '' ) { + continue; + } + + $token = (string) $binding->token; + + // A binding may reference a token id the resolved library does not back (e.g. a stale alias + // left after a token was removed). css_var_for() would compute a `--kb-token--…` custom + // property nothing defines, and the declaration's literal fallback would keep rendering the + // default — a silent, invisible dead indirection. Skip the declaration entirely so the block + // falls back to its own native default CSS, and log the mismatch (under WP_DEBUG, via the + // injected logger). + if ( $resolved->value( $token ) === null ) { + $this->logger->error( + sprintf( + 'Block-default CSS: block "%s" binds unresolved token id "%s"; skipping declaration.', + $block, + $token + ) + ); + + continue; + } + + $var = $this->registry->css_var_for( $token ); + $suffix = $this->selector_suffix( + $editor ? $binding->editor_css_selector() : $binding->css_selector() + ); + + $by_suffix[ $suffix ][] = $prop . ':' . $this->declaration_value( $binding, $var, $literal ); + } + + foreach ( $by_suffix as $suffix => $declarations ) { + $css .= $selector . $suffix . '{' . implode( ';', $declarations ) . ';}'; + } + } + + return $css; + } + + /** + * The declaration value for one bound property: the token variable with the block's own literal as its + * fallback, wrapped in the binding's `css_var` when it declares one. + * + * A binding that names no `css_var` yields `var(, )` — the block's default follows the + * token and nothing else can vary it. A binding that names one yields + * `var(--, var(, ))`, which is what lets a SELECTED preset reach a property + * delivered this way: {@see Preset_Css_Builder} emits `.wp-block-.kb-preset--` rules setting + * `--` on the block root, and custom properties inherit, so the value reaches this rule even when + * it targets a descendant (`img`, `> .kt-inside-inner-col`, `*.kb-svg-icon-wrap`). Without the wrapper the + * selectable-preset projector has no way in: a `css_prop` binding never reaches it, so picking a preset + * would change nothing on the page. + * + * The fallback ORDER is what keeps this upgrade-safe. With no preset selected `--` is undefined, + * the browser falls through to the token variable, and the declaration resolves to exactly the value it + * resolved to before the wrapper existed. + * + * @since TBD + * + * @param Binding $binding The binding being rendered. + * @param string $var The referenced token's CSS variable, including its leading `--`. + * @param string $literal The resolved literal, used as the token variable's fallback. + * + * @return string The declaration value. + */ + private function declaration_value( Binding $binding, string $var, string $literal ): string { + $value = 'var(' . $var . ',' . $this->sanitize_value( $literal ) . ')'; + $css_var = $binding->css_var(); + + if ( $css_var === null ) { + return $value; + } + + return 'var(--' . $css_var . ',' . $value . ')'; + } + + /** + * Shared cache/memo plumbing for {@see self::css_for_version()} and {@see self::editor_css_for_version()}. + * The context (front end vs editor) is folded into both the per-request memo key and the object-cache key + * so the two builds never share a cache slot. + * + * @since TBD + * + * @param string $version The store version the resolved library was built from. + * @param string $slug The token library slug. + * @param bool $editor Whether to build the editor-scoped preset. + * + * @return string + */ + private function for_version( string $version, string $slug, bool $editor ): string { + $context = $editor ? 'editor' : 'front'; + $suffix = $version . ':' . $slug; + $memo_key = $context . ':' . $suffix; + + if ( isset( $this->memo[ $memo_key ] ) ) { + return $this->memo[ $memo_key ]; + } + + $cache_key = 'block_default_css_' . $context . '_' . KADENCE_BLOCKS_VERSION . '_' . $suffix; + $cached = wp_cache_get( $cache_key, self::CACHE_GROUP, false, $found ); + + if ( $found && is_string( $cached ) ) { + return $this->memo[ $memo_key ] = $cached; + } + + $css = $editor ? $this->editor_css( $slug ) : $this->css( $slug ); + + wp_cache_set( $cache_key, $css, self::CACHE_GROUP, DAY_IN_SECONDS ); + + return $this->memo[ $memo_key ] = $css; + } + +} diff --git a/includes/resources/Design_Tokens/Projection/Block_Default_Css/Projector.php b/includes/resources/Design_Tokens/Projection/Block_Default_Css/Projector.php new file mode 100644 index 0000000000..ed6996ea06 --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Block_Default_Css/Projector.php @@ -0,0 +1,168 @@ +registry = $registry; + $this->store = $store; + $this->active = $active; + $this->css_builder = $css_builder; + } + + /** + * Append the block-default CSS to the front-end global-variables handle. + * + * @since TBD + * + * @return void + */ + public function enqueue_front_end(): void { + if ( ! $this->registry->is_active() ) { + return; + } + + $css = $this->css(); + + if ( $css !== '' ) { + wp_add_inline_style( 'kadence-blocks-global-variables', $css ); + } + } + + /** + * Append the block-default CSS to the editor global-styles handle. + * + * Shares the Css_Var projector's editor gate (the same page check and filter), so the default CSS and + * the token vars load together in the editor or not at all. + * + * @since TBD + * + * @return void + */ + public function enqueue_editor(): void { + if ( ! $this->registry->is_active() ) { + return; + } + + /** This filter is documented in includes/resources/Design_Tokens/Projection/Css_Var/Projector.php */ + if ( ! apply_filters( 'kadence_blocks_load_editor_token_vars', Location::is_block_editor() ) ) { + return; + } + + $css = $this->editor_css(); + + if ( $css !== '' ) { + wp_add_inline_style( 'kadence-blocks-global-editor-styles', $css ); + } + } + + /** + * Build the FRONT-END block-default CSS for the current library, via the builder's version-keyed cache. + * + * Returns an empty string when the store version cannot be read or a block cannot be resolved (e.g. an + * alias cycle from a direct DB write that bypassed the REST gate), so the page never crashes — the + * inline style is simply omitted and KB falls back to its own defaults. + * + * @since TBD + * + * @return string + */ + public function css(): string { + $slug = $this->active->get(); + + try { + $version = $this->store->get_version( $slug ); + } catch ( Throwable $e ) { + return ''; + } + + return $this->css_builder->css_for_version( $version, $slug ); + } + + /** + * Build the EDITOR-scoped block-default CSS for the current library, via the builder's version-keyed cache. + * Identical to {@see self::css()} for every block that declares no `editor_selector`; scoped under + * `.editor-styles-wrapper` and re-targeted at the block's editor markup for the ones that do (see + * {@see Css_Builder::editor_css()}). + * + * Returns an empty string under the same failure conditions as {@see self::css()}. + * + * @since TBD + * + * @return string + */ + public function editor_css(): string { + $slug = $this->active->get(); + + try { + $version = $this->store->get_version( $slug ); + } catch ( Throwable $e ) { + return ''; + } + + return $this->css_builder->editor_css_for_version( $version, $slug ); + } +} diff --git a/includes/resources/Design_Tokens/Projection/Block_Default_Css/Provider.php b/includes/resources/Design_Tokens/Projection/Block_Default_Css/Provider.php new file mode 100644 index 0000000000..beffc3024d --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Block_Default_Css/Provider.php @@ -0,0 +1,41 @@ +container->singleton( Css_Builder::class ); + $this->container->singleton( Projector::class ); + + // Contribute this projector's editor CSS to the combined projected-CSS endpoint. + /** @var Css_Projectors $projectors */ + $projectors = $this->container->get( Css_Projectors::class ); + /** @var Projector $projector */ + $projector = $this->container->get( Projector::class ); + $projectors->add( $projector ); + + // Front end: append after the token vars (100) and preset overrides (110). These are low-specificity + // defaults, so a per-instance value KB renders later still wins regardless of order. + add_action( 'wp_enqueue_scripts', $this->container->callback( Projector::class, 'enqueue_front_end' ), 120 ); + + // Editor: append at admin_init priority 20, after the editor-styles handle is registered (1) and the + // Css_Var (5) and preset (10) projectors, so the default CSS follows the token vars on the same handle. + add_action( 'admin_init', $this->container->callback( Projector::class, 'enqueue_editor' ), 20 ); + } +} diff --git a/includes/resources/Design_Tokens/Projection/Block_Preset/Projector.php b/includes/resources/Design_Tokens/Projection/Block_Preset/Projector.php new file mode 100644 index 0000000000..8c40fcc1b4 --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Block_Preset/Projector.php @@ -0,0 +1,110 @@ + value` map. + * + * @since TBD + */ + private Preset_Resolver $resolver; + + /** + * Owns the active-library pointer, read at render time so preset defaults follow the active library. + * + * @since TBD + * + * @var Active_Token_Library_Store + */ + private Active_Token_Library_Store $active; + + /** + * @since TBD + * + * @param Token_Registry $registry The token registry. + * @param Preset_Resolver $resolver The preset resolver. + * @param Active_Token_Library_Store $active Owns the active-library pointer. + */ + public function __construct( Token_Registry $registry, Preset_Resolver $resolver, Active_Token_Library_Store $active ) { + $this->registry = $registry; + $this->resolver = $resolver; + $this->active = $active; + } + + /** + * Overlay a block's preset (its `$default` preset) onto the given attribute defaults. + * + * @since TBD + * + * @param array $defaults The registration (block.json) attribute defaults. + * @param string $block The block name, e.g. "kadence/singlebtn". + * + * @return array The defaults with the preset overlaid; unchanged when the block has none. + */ + public function add_preset_defaults( array $defaults, string $block ): array { + // Respect the fail-closed guard: when projection is disabled (e.g. a declared token is missing + // from the baseline) fall back to KB's own defaults rather than seeding a partial preset. + if ( ! $this->registry->is_active() ) { + return $defaults; + } + + $bindings = $this->registry->for_block( $block ); + + if ( $bindings === null ) { + return $defaults; + } + + try { + $values = $this->resolver->resolve_default( $block, $this->active->get() ); + } catch ( Throwable $e ) { + // No `$default` defined for the block, or the token graph cannot resolve (alias cycle/dangling + // reference). This runs in the render path, so fail soft to KB's defaults rather than fatally. + return $defaults; + } + + $preset = []; + + foreach ( $values as $property => $value ) { + $binding = $bindings->binding( $property ); + $attribute = $binding !== null ? $binding->block_attr() : null; + + if ( $attribute !== null ) { + $preset[ $attribute ] = $value; + } + } + + // The preset wins over the generic block.json default; KB's own merge then lets the instance win. + return array_merge( $defaults, $preset ); + } +} diff --git a/includes/resources/Design_Tokens/Projection/Block_Preset/Provider.php b/includes/resources/Design_Tokens/Projection/Block_Preset/Provider.php new file mode 100644 index 0000000000..caa5698527 --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Block_Preset/Provider.php @@ -0,0 +1,33 @@ +container->singleton( Projector::class ); + + // KB's abstract block emits this filter while assembling a block's default attributes (see + // get_attributes_with_defaults()). Overlaying the block's $default preset makes it render on-brand + // out of the box. Resolved lazily through the container: the resolver graph need not boot before render. + add_filter( + 'kadence_blocks_block_default_attributes', + $this->container->callback( Projector::class, 'add_preset_defaults' ), + 10, + 2 + ); + } +} diff --git a/includes/resources/Design_Tokens/Projection/Contracts/Abstract_Css_Projector.php b/includes/resources/Design_Tokens/Projection/Contracts/Abstract_Css_Projector.php new file mode 100644 index 0000000000..81ceba3043 --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Contracts/Abstract_Css_Projector.php @@ -0,0 +1,32 @@ +css(); + } +} diff --git a/includes/resources/Design_Tokens/Projection/Contracts/Css_Projector.php b/includes/resources/Design_Tokens/Projection/Contracts/Css_Projector.php new file mode 100644 index 0000000000..ab9458d8c8 --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Contracts/Css_Projector.php @@ -0,0 +1,62 @@ +projectors = $projectors; + } + + /** + * Add a CSS projector to the collection. + * + * @since TBD + * + * @param Css_Projector $projector The projector to add. + * + * @return void + */ + public function add( Css_Projector $projector ): void { + $this->projectors[] = $projector; + } + + /** + * The projectors, in registration order. + * + * @since TBD + * + * @return Css_Projector[] + */ + public function all(): array { + return $this->projectors; + } +} diff --git a/includes/resources/Design_Tokens/Projection/Css_Var/Css_Builder.php b/includes/resources/Design_Tokens/Projection/Css_Var/Css_Builder.php new file mode 100644 index 0000000000..798d5299ef --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Css_Var/Css_Builder.php @@ -0,0 +1,291 @@ +: ` straight from the active library's + * canonical projected map. The literal value of a token lives here, once; an alias chain reads the + * canonical name (`--kb-token--: var(--kb-token--)`), so editing a referenced + * token updates every dependent token live, with no server re-resolve. + * 2. The legacy global-var slot bridges — `--global-kb--: var(--kb-token--, )` + * for the spacing/gap/font-size slot families — pointing at the canonical names with the resolved + * literal as a fallback. (The `:root` palette itself stays owned by the legacy color filter and is not + * emitted here.) + * 3. Per-breakpoint responsive redeclarations — the affected `--kb-token--` vars re-declared inside + * each breakpoint's `@media` block at the same `:root` scope, so a value declared once is overridden + * within the query and every consuming token / block follows for free. + * + * Bare `:root` makes the variables live everywhere KB prints them (front end and editor iframe alike). + * `:where(.kb-tokens)` is an additional zero-specificity hook for future opt-in or preset scoping. Nothing + * here is `!important` — per-instance preset overrides must be able to win by ordinary cascade. + * + * Pure: no WordPress calls beyond the object cache in css_for_version(), no globals, no side effects. The + * WordPress wiring lives in Projector. + * + * @since TBD + */ +final class Css_Builder { + + use Sanitizes_Css_Value; + + /** + * Object-cache group shared with the resolver. + * + * @since TBD + * + * @var string + */ + private const CACHE_GROUP = 'kb_design_tokens'; + + /** + * The registry the active token library is resolved and projected from. + * + * @since TBD + * + * @var Token_Registry + */ + private Token_Registry $registry; + + /** + * Per-request memo of built CSS, keyed on the object-cache key of the `:root` block, so a write (which + * bumps the library's version) invalidates the affected entry without an explicit purge hook. + * + * @since TBD + * + * @var array + */ + private array $memo = []; + + /** + * @param Token_Registry $registry + */ + public function __construct( Token_Registry $registry ) { + $this->registry = $registry; + } + + /** + * Build the active library's CSS string. Front end and editor share it verbatim. The pure, uncached + * assembler (its cached counterpart is css_for_version()). + * + * @since TBD + * + * @param Resolved_Tokens $resolved The active library's canonical resolved maps (from + * Token_Resolver::resolve()). + * @param array $breakpoints Breakpoint => media-query string (e.g. + * "tablet" => "(max-width: 1024px)"), for the per-breakpoint + * responsive var redeclaration. + * + * @return string The CSS, or an empty string when there is nothing to project. + */ + public function css( Resolved_Tokens $resolved, array $breakpoints = [] ): string { + return $this->build_root( $resolved, $breakpoints ); + } + + /** + * Cached version of css(): assembles the `:root` block from the object cache with a per-request memo. A + * write bumps the library's store version, which changes the cache key, so a fresh block is built on the next + * request. + * + * The plugin version is folded into the cache key alongside the store version: the store version tracks + * stored overrides, but projected CSS also depends on shipped declarations and the baseline, which change + * with a plugin build. Including KADENCE_BLOCKS_VERSION busts on upgrade. + * + * @since TBD + * + * @param Resolved_Tokens $resolved The active library's canonical resolved maps. + * @param string $slug The active library's slug, folded into the cache key. + * @param string $version The store version the library was built from. + * @param array $breakpoints Breakpoint => media-query string, for the per-breakpoint + * responsive var redeclaration. + * + * @return string + */ + public function css_for_version( Resolved_Tokens $resolved, string $slug, string $version, array $breakpoints = [] ): string { + $cache_key = 'projected_css_root_' . KADENCE_BLOCKS_VERSION . '_' . $slug . '_' . $version . '_' . $this->breakpoint_signature( $breakpoints ); + + if ( isset( $this->memo[ $cache_key ] ) ) { + return $this->memo[ $cache_key ]; + } + + $cached = wp_cache_get( $cache_key, self::CACHE_GROUP, false, $found ); + + if ( $found && is_string( $cached ) ) { + return $this->memo[ $cache_key ] = $cached; + } + + $css = $this->build_root( $resolved, $breakpoints ); + + wp_cache_set( $cache_key, $css, self::CACHE_GROUP, DAY_IN_SECONDS ); + + return $this->memo[ $cache_key ] = $css; + } + + /** + * Build (uncached) the active library's `:root` block: the canonical token declarations plus the slot + * bridges, followed by the per-breakpoint responsive redeclarations. The single assembly definition + * shared by css() and the cached css_for_version(). + * + * The projection preserves alias indirection: a reference-valued token reads `var(--kb-token--)` + * and a composite keeps a `var()` for any aliased field, so editing a referenced token updates every + * dependent token live, with no server re-resolve. A raw-valued token (a primitive, or a semantic + * overridden to a literal) emits the literal — the value lives once, at the leaf. var() references derive + * from the alias grammar (`[\w.-]+`) and survive sanitization untouched, which still strips any breakout + * characters from the literal portions. + * + * @since TBD + * + * @param Resolved_Tokens $resolved The active library's canonical resolved maps. + * @param array $breakpoints Breakpoint => media-query string, for the responsive + * redeclaration blocks appended after the base declarations. + * + * @return string + */ + private function build_root( Resolved_Tokens $resolved, array $breakpoints ): string { + $declarations = ''; + foreach ( $resolved->projected_vars() as $var => $value ) { + $declarations .= $var . ':' . $this->sanitize_value( $value ) . ';'; + } + + $declarations .= $this->all_slot_declarations( $resolved ); + + if ( $declarations === '' ) { + return ''; + } + + return Scope::root() . '{' . $declarations . '}' . $this->responsive_blocks( $resolved->projected_responsive(), $breakpoints ); + } + + /** + * Emit the per-breakpoint responsive redeclarations: for each breakpoint that has overrides, redeclare + * the affected `--kb-token--` vars inside that breakpoint's `@media` block, at the same :root scope, + * so a value declared once at :root is overridden within the query and every consuming token / block + * follows for free. Breakpoints are emitted in the given order (tablet before mobile), so the narrower + * max-width override wins by source order. A document with no responsive tokens emits nothing, keeping + * flat output byte-for-byte unchanged. + * + * @since TBD + * + * @param array> $responsive css-var => [ breakpoint => value ] overrides. + * @param array $breakpoints Breakpoint => media-query string. + * + * @return string + */ + private function responsive_blocks( array $responsive, array $breakpoints ): string { + if ( $responsive === [] ) { + return ''; + } + + $css = ''; + foreach ( $breakpoints as $breakpoint => $query ) { + if ( $query === '' ) { + continue; + } + + $declarations = ''; + foreach ( $responsive as $var => $by_breakpoint ) { + if ( ! isset( $by_breakpoint[ $breakpoint ] ) ) { + continue; + } + + $declarations .= $var . ':' . $this->sanitize_value( $by_breakpoint[ $breakpoint ] ) . ';'; + } + + if ( $declarations === '' ) { + continue; + } + + $css .= '@media all and ' . $query . '{' . Scope::root() . '{' . $declarations . '}}'; + } + + return $css; + } + + /** + * A short, stable signature of the active breakpoint media-query strings, folded into the cache key so a + * change to the filterable breakpoints busts the projected-CSS cache. serialize() keeps this + * dependency-free (the builder stays WordPress-agnostic). + * + * @since TBD + * + * @param array $breakpoints Breakpoint => media-query string. + * + * @return string + */ + private function breakpoint_signature( array $breakpoints ): string { + if ( $breakpoints === [] ) { + return 'none'; + } + + return substr( md5( serialize( $breakpoints ) ), 0, 12 ); + } + + /** + * The slot-family bridge declarations for the resolved active library: `--global-kb--: + * var(--kb-token--, );` for every spacing, gap and font-size token claiming a slot. + * + * @since TBD + * + * @param Resolved_Tokens $resolved The resolved token maps. + * + * @return string + */ + private function all_slot_declarations( Resolved_Tokens $resolved ): string { + return $this->slot_declarations( $resolved, Spacing_Target::class ) + . $this->slot_declarations( $resolved, Gap_Target::class ) + . $this->slot_declarations( $resolved, Font_Size_Target::class ); + } + + /** + * The bridge declarations for one slot family: `--global-kb--: var(--kb-token--, + * );` for every token claiming a slot in that family. + * + * Kadence Blocks renders a dimension attribute that holds a preset slug as + * `var(--global-kb--, )` but ships those slug values with no per-library indirection + * of its own (spacing/gap as plain literals, font-size via a filter). Pointing the slug variable at the + * token — later in source order than KB's own definition — redirects every block already storing that + * slot at the token, with the resolved length as a literal fallback for contexts that lack the token vars + * (e.g. preview iframes). + * + * @since TBD + * + * @param Resolved_Tokens $resolved The resolved token maps. + * @param class-string $target_class The slot-target type for this family. + * + * @return string + */ + private function slot_declarations( Resolved_Tokens $resolved, string $target_class ): string { + $declarations = ''; + + // The slot and css_var come from developer-declared registry config; only the resolved literal + // fallback can carry stored values, so just that is sanitized. + foreach ( $this->registry->by_projection( $target_class::get_projection_key() ) as $id => $token ) { + $target = $target_class::from_token( $token ); + if ( $target === null ) { + continue; + } + + $value = $resolved->value( $id ); + if ( $value === null || $value === '' ) { + continue; + } + + $declarations .= $target->css_property() . ':var(' . $token->css_var . ',' . $this->sanitize_value( $value ) . ');'; + } + + return $declarations; + } +} diff --git a/includes/resources/Design_Tokens/Projection/Css_Var/Legacy_Filter_Bridge.php b/includes/resources/Design_Tokens/Projection/Css_Var/Legacy_Filter_Bridge.php new file mode 100644 index 0000000000..887a2f612b --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Css_Var/Legacy_Filter_Bridge.php @@ -0,0 +1,96 @@ +)" so legacy blocks react to preset overrides of + * --kb-token--* with the resolved literal as a fallback for contexts that lack the token definitions + * (e.g. prebuilt-library preview iframes). Everything else passes through untouched. + * + * The font-size scale is delivered separately, through the --global-kb-font-size- slot bridge + * (Font_Size_Target) in Css_Builder, not this filter. + * + * A no-op when the Kadence theme owns the palette. Activation is gated upstream by the Projector (it + * only calls this when Token_Registry::is_active()). + * + * @since TBD + */ +final class Legacy_Filter_Bridge { + + /** + * @var Token_Registry + */ + private Token_Registry $registry; + + /** + * @var Token_Resolver + */ + private Token_Resolver $resolver; + + /** + * @param Token_Registry $registry + * @param Token_Resolver $resolver + */ + public function __construct( Token_Registry $registry, Token_Resolver $resolver ) { + $this->registry = $registry; + $this->resolver = $resolver; + } + + /** + * Filter callback for kadence_blocks_pattern_global_colors. + * + * A no-op when the Kadence theme is active: KB's existing CSS emits --global-palette* only when + * the theme is not active, so mirroring that guard here prevents the editor's JS color swatches + * (which use this filter unconditionally) from diverging from the rendered CSS. Token-driven + * palette values under the Kadence theme are handled by a separate palette projector. + * + * @since TBD + * + * @param array $colors The current --global-palette* map. + * + * @return array + */ + public function global_colors( array $colors ): array { + if ( class_exists( 'Kadence\Theme' ) ) { + return $colors; + } + + try { + $resolved = $this->resolver->resolve(); + } catch ( RuntimeException $e ) { + // A corrupt stored document (alias cycle or dangling alias) must not kill the page. + // The REST write gate rejects such documents, but a direct DB write could bypass it. + // Fail open: return the incoming array untouched so existing palette values survive. + return $colors; + } + + foreach ( $this->registry->by_projection( Kadence_Palette_Slot::get_projection_key() ) as $id => $token ) { + $slot = Kadence_Palette_Slot::from_token( $token ); + if ( $slot === null ) { + continue; // not a palette slot (e.g. a font-size kadence_slot) — leave to font_sizes(). + } + + $value = $resolved->value( $id ); + if ( $value === null ) { + continue; + } + + // Point the slot at the token var so blocks react to preset overrides, with the resolved + // literal as a fallback for preview iframes that build their own palette CSS. + $colors[ '--global-' . $slot->slug ] = sprintf( 'var(%s, %s)', $token->css_var, $value ); + } + + return $colors; + } +} diff --git a/includes/resources/Design_Tokens/Projection/Css_Var/Projector.php b/includes/resources/Design_Tokens/Projection/Css_Var/Projector.php new file mode 100644 index 0000000000..bbbe64acd4 --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Css_Var/Projector.php @@ -0,0 +1,211 @@ + custom properties + * at :root — so block content and the preset/slot bridges (which read the canonical names) resolve against + * it. Multiple libraries may still be stored; the active-library pointer selects the one library that is emitted, and + * switching the pointer re-emits with the new library's values. Only the active library's tokens reach the coercive + * native-block and theme.json styling paths. + * + * @since TBD + */ +final class Projector extends Abstract_Css_Projector { + + /** + * @var Token_Registry + */ + private Token_Registry $registry; + + /** + * @var Token_Resolver + */ + private Token_Resolver $resolver; + + /** + * @var Token_Store + */ + private Token_Store $store; + + /** + * Owns the active-library pointer, read at build time so the projection follows the active library. + * + * @since TBD + * + * @var Active_Token_Library_Store + */ + private Active_Token_Library_Store $active; + + /** + * @var Css_Builder + */ + private Css_Builder $css_builder; + + /** + * @var Legacy_Filter_Bridge + */ + private Legacy_Filter_Bridge $bridge; + + /** + * @since TBD + * + * @param Token_Registry $registry + * @param Token_Resolver $resolver + * @param Token_Store $store + * @param Active_Token_Library_Store $active + * @param Css_Builder $css_builder + * @param Legacy_Filter_Bridge $bridge + */ + public function __construct( + Token_Registry $registry, + Token_Resolver $resolver, + Token_Store $store, + Active_Token_Library_Store $active, + Css_Builder $css_builder, + Legacy_Filter_Bridge $bridge + ) { + $this->registry = $registry; + $this->resolver = $resolver; + $this->store = $store; + $this->active = $active; + $this->css_builder = $css_builder; + $this->bridge = $bridge; + } + + /** + * Append the projected CSS to the front-end global-variables handle. + * + * @since TBD + * + * @return void + */ + public function enqueue_front_end(): void { + if ( ! $this->is_active() ) { + return; + } + + $css = $this->css(); + if ( $css !== '' ) { + wp_add_inline_style( 'kadence-blocks-global-variables', $css ); + } + } + + /** + * Append the projected CSS to the editor global-styles handle. + * + * Only runs on requests where the block editor will load its scripts, determined + * by matching known editor page slugs. Can be overridden with the + * `kadence_blocks_load_editor_token_vars` filter. + * + * @since TBD + * + * @return void + */ + public function enqueue_editor(): void { + if ( ! $this->is_active() ) { + return; + } + + /** + * Whether to append the token CSS to the editor global-styles handle. + * + * @param bool $load True on known block-editor page slugs. + */ + if ( ! apply_filters( 'kadence_blocks_load_editor_token_vars', Location::is_block_editor() ) ) { + return; + } + + $css = $this->css(); + if ( $css !== '' ) { + wp_add_inline_style( 'kadence-blocks-global-editor-styles', $css ); + } + } + + /** + * @since TBD + * + * @param array $colors + * + * @return array + */ + public function filter_global_colors( array $colors ): array { + if ( ! $this->is_active() ) { + return $colors; + } + + return $this->bridge->global_colors( $colors ); + } + + /** + * Build the projected CSS for the single active token library, using the per-request memo and object cache + * so repeated calls within the same request are free. + * + * The active library is resolved to its canonical `--kb-token--*` maps, then the builder emits the one `:root` + * block (canonical token layer, slot bridges, and responsive redeclarations). An active library whose stored + * document cannot be resolved (e.g. an alias cycle introduced by a direct DB write that bypassed the REST + * validation gate) yields an empty string rather than a fatal, so the page falls back to KB's existing + * variables without crashing. + * + * @since TBD + * + * @return string + */ + public function css(): string { + try { + $active = $this->active->get(); + $resolved = $this->resolver->resolve( $active ); + $version = $this->store->get_version( $active ); + } catch ( Throwable $e ) { + return ''; + } + + return $this->css_builder->css_for_version( $resolved, $active, $version, $this->breakpoints() ); + } + + /** + * The breakpoint => media-query string map for the per-breakpoint responsive redeclaration, resolved at + * emit time so the filterable KB breakpoints are final. Keyed to match the resolver's breakpoint keys; + * defaults mirror Kadence_Blocks_CSS::get_media_queries(). Desktop is the base (:root), so only the + * tablet / mobile max-width overrides are needed here. + * + * @since TBD + * + * @return array + */ + private function breakpoints(): array { + return [ + /** This filter is documented in includes/class-kadence-blocks-css.php */ + Responsive::get_tablet_key() => (string) apply_filters( 'kadence_tablet_media_query', '(max-width: 1024px)' ), + /** This filter is documented in includes/class-kadence-blocks-css.php */ + Responsive::get_mobile_key() => (string) apply_filters( 'kadence_mobile_media_query', '(max-width: 767px)' ), + ]; + } + + /** + * Whether token projection is active. + * + * @since TBD + * + * @return bool + */ + private function is_active(): bool { + return $this->registry->is_active(); + } +} diff --git a/includes/resources/Design_Tokens/Projection/Css_Var/Provider.php b/includes/resources/Design_Tokens/Projection/Css_Var/Provider.php new file mode 100644 index 0000000000..2d9e35e39e --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Css_Var/Provider.php @@ -0,0 +1,47 @@ +container->singleton( Css_Builder::class ); + $this->container->singleton( Legacy_Filter_Bridge::class ); + $this->container->singleton( Slot_Target_Reader::class ); + $this->container->singleton( Projector::class ); + + // Contribute this projector's editor CSS to the combined projected-CSS endpoint. + /** @var Css_Projectors $projectors */ + $projectors = $this->container->get( Css_Projectors::class ); + /** @var Projector $projector */ + $projector = $this->container->get( Projector::class ); + $projectors->add( $projector ); + + // Front end: append our declarations to the global-variables handle (KB enqueues at 90). + add_action( 'wp_enqueue_scripts', $this->container->callback( Projector::class, 'enqueue_front_end' ), 100 ); + + // Editor: the editor-styles handle is registered at admin_init priority 1 and wired as a + // wp-block-library dependency at priority 2. Appending at priority 5 ensures the handle + // exists and keeps that dependency, which is what gives editor-iframe coverage for free. + add_action( 'admin_init', $this->container->callback( Projector::class, 'enqueue_editor' ), 5 ); + + // Legacy color palette (init.php applies this filter in both editor and front-end functions). + // Merge semantics: the bridge overrides only token-claimed slots; everything else passes through. + // The font-size scale is delivered by the --global-kb-font-size- slot bridge in Css_Builder. + add_filter( 'kadence_blocks_pattern_global_colors', $this->container->callback( Projector::class, 'filter_global_colors' ), 20 ); + } +} diff --git a/includes/resources/Design_Tokens/Projection/Css_Var/Slot/Contracts/Abstract_Target.php b/includes/resources/Design_Tokens/Projection/Css_Var/Slot/Contracts/Abstract_Target.php new file mode 100644 index 0000000000..b8df457c78 --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Css_Var/Slot/Contracts/Abstract_Target.php @@ -0,0 +1,133 @@ +slot = $slot; + } + + /** + * @inheritDoc + * + * @since TBD + */ + final public static function get_projection_key(): string { + return static::PROJECTION; + } + + /** + * @inheritDoc + * + * @since TBD + */ + final public static function from_token( Token_Definition $token ): ?self { + if ( ! $token->has_projection( static::PROJECTION ) ) { + return null; + } + + $slot = $token->projections[ static::PROJECTION ] ?? null; + + if ( ! is_string( $slot ) || ! in_array( $slot, static::SLOTS, true ) ) { + return null; + } + + return new static( $slot ); + } + + /** + * @inheritDoc + * + * @since TBD + */ + final public function css_property(): string { + return static::VAR_PREFIX . $this->slot; + } + + /** + * @inheritDoc + * + * @since TBD + */ + final public function slot(): string { + return $this->slot; + } + + /** + * @inheritDoc + * + * @since TBD + */ + final public static function get_primitive_id( string $slug ): string { + return static::PRIMITIVE_PREFIX . $slug; + } +} diff --git a/includes/resources/Design_Tokens/Projection/Css_Var/Slot/Contracts/Target.php b/includes/resources/Design_Tokens/Projection/Css_Var/Slot/Contracts/Target.php new file mode 100644 index 0000000000..85f05052d0 --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Css_Var/Slot/Contracts/Target.php @@ -0,0 +1,74 @@ +-, + * )` but ships those slug values as plain literals with no filter to override (unlike colors and + * font sizes). A token claims a slot, and the Css_Var builder redefines that custom property as the + * token's variable — so every block already storing the slug follows the token with no block change. + * Implementations validate against the slugs Kadence Blocks ships so an override never points at a slug + * no block reads. + * + * @since TBD + */ +interface Target { + + /** + * The projection key a token declares to claim a slot in this family, e.g. "kb_spacing_slot". + * + * @since TBD + * + * @return string + */ + public static function get_projection_key(): string; + + /** + * Resolve a token's slot projection to a target, or null when the token declares no usable slot (so + * callers skip it). + * + * @since TBD + * + * @param Token_Definition $token The token definition. + * + * @return self|null + */ + public static function from_token( Token_Definition $token ): ?self; + + /** + * The Kadence Blocks custom property this slot is emitted under, e.g. "--global-kb-spacing-lg". + * + * @since TBD + * + * @return string + */ + public function css_property(): string; + + /** + * The claimed slug, e.g. "lg". + * + * @since TBD + * + * @return string + */ + public function slot(): string; + + /** + * The id of the primitive dimension token backing a slug in this family, e.g. + * "primitive.dimension.spacing.lg". For spacing/gap this is the projection-holding token itself; for + * font-size it is the primitive the projection-holding semantic aliases. Used to resolve a slug's + * scale value. + * + * @since TBD + * + * @param string $slug The claimed slug, e.g. "lg". + * + * @return string + */ + public static function get_primitive_id( string $slug ): string; +} diff --git a/includes/resources/Design_Tokens/Projection/Css_Var/Slot/Font_Size_Target.php b/includes/resources/Design_Tokens/Projection/Css_Var/Slot/Font_Size_Target.php new file mode 100644 index 0000000000..4cda8b29c2 --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Css_Var/Slot/Font_Size_Target.php @@ -0,0 +1,63 @@ +, )`, and emits those slugs' fluid `clamp()` values through + * the `kadence_blocks_variable_font_sizes` filter. The `primitive.dimension.font-size.` token claims + * that slug with `'kb_font_size_slot' => 'lg'`; the Css_Var builder then redefines `--global-kb-font-size-lg` + * as the token variable, so every block already storing that slug follows the token with no block change — + * the same slug-on-the-primitive shape spacing and gap use (the button's per-instance default font size is a + * separate token, semantic.font-size.control, not a scale step). + * + * The slug is validated against the set Kadence Blocks ships, so a typo never emits a dead override. + * + * @since TBD + */ +final class Font_Size_Target extends Abstract_Target { + + /** + * The projection key a token declares to claim a font-size slug. + * + * @since TBD + * + * @var string + */ + protected const PROJECTION = 'kb_font_size_slot'; + + /** + * The custom-property prefix Kadence Blocks emits each font-size slug under. + * + * @since TBD + * + * @var string + */ + protected const VAR_PREFIX = '--global-kb-font-size-'; + + /** + * The font-size slugs Kadence Blocks defines (see includes/init.php / class-kadence-blocks-css.php). + * A claim on any other slug is ignored so the override can never point at a slug no block reads. + * + * @since TBD + * + * @var string[] + */ + protected const SLOTS = [ 'sm', 'md', 'lg', 'xl', 'xxl', 'xxxl' ]; + + /** + * The primitive dimension tokens that back the font-size slugs; the slug is claimed on the primitive + * itself, so this prefix plus the slug is the projection-holding token's own id (and resolves to its + * fluid clamp()). + * + * @since TBD + * + * @var string + */ + protected const PRIMITIVE_PREFIX = 'primitive.dimension.font-size.'; +} diff --git a/includes/resources/Design_Tokens/Projection/Css_Var/Slot/Gap_Target.php b/includes/resources/Design_Tokens/Projection/Css_Var/Slot/Gap_Target.php new file mode 100644 index 0000000000..d4640a437e --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Css_Var/Slot/Gap_Target.php @@ -0,0 +1,63 @@ +, )`. Unlike spacing, KB does not even define those `--global-kb-gap-*` + * properties (they resolve to the literal fallback today), so a gap token claims one with + * `'kb_gap_slot' => 'md'`; the Css_Var builder then defines `--global-kb-gap-md` as the token variable, + * and every block already storing that slug — including the alias slugs that point at it, e.g. "default" + * → `--global-kb-gap-md` — follows the token with no block change. + * + * The slot is validated against the gap variables KB references, so a typo never emits a dead override. + * The literal-only gutter presets KB ships (narrow/wide/widest) have no variable to redirect and are not + * slots. + * + * @since TBD + */ +final class Gap_Target extends Abstract_Target { + + /** + * The projection key a token declares to claim a gap slot. + * + * @since TBD + * + * @var string + */ + protected const PROJECTION = 'kb_gap_slot'; + + /** + * The custom-property prefix Kadence Blocks references each gap slug under. + * + * @since TBD + * + * @var string + */ + protected const VAR_PREFIX = '--global-kb-gap-'; + + /** + * The gap variable slugs Kadence Blocks references (see class-kadence-blocks-css.php $gap_sizes). A + * claim on any other value — including the literal-only gutter presets (narrow/wide/widest) — is + * ignored so the override can never point at a slug no block reads. + * + * @since TBD + * + * @var string[] + */ + protected const SLOTS = [ 'none', 'xs', 'sm', 'md', 'lg' ]; + + /** + * The primitive dimension tokens that back the gap slugs; the slug is claimed on the primitive itself, + * so this prefix plus the slug is the projection-holding token's own id. + * + * @since TBD + * + * @var string + */ + protected const PRIMITIVE_PREFIX = 'primitive.dimension.gap.'; +} diff --git a/includes/resources/Design_Tokens/Projection/Css_Var/Slot/Spacing_Target.php b/includes/resources/Design_Tokens/Projection/Css_Var/Slot/Spacing_Target.php new file mode 100644 index 0000000000..5e31696d76 --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Css_Var/Slot/Spacing_Target.php @@ -0,0 +1,59 @@ +, )`, and emits those slugs' values as plain literals it owns + * (no filter hook, unlike colors and font sizes). A spacing token claims one of those slugs with + * `'kb_spacing_slot' => 'lg'`; the Css_Var builder then redefines `--global-kb-spacing-lg` as the token + * variable, so every block already storing that slug follows the token with no block change. + * + * The slug is validated against the set Kadence Blocks ships, so a typo never emits a dead override. + * + * @since TBD + */ +final class Spacing_Target extends Abstract_Target { + + /** + * The projection key a token declares to claim a spacing slug. + * + * @since TBD + * + * @var string + */ + protected const PROJECTION = 'kb_spacing_slot'; + + /** + * The custom-property prefix Kadence Blocks emits each spacing slug under. + * + * @since TBD + * + * @var string + */ + protected const VAR_PREFIX = '--global-kb-spacing-'; + + /** + * The spacing slugs Kadence Blocks defines (see includes/init.php / class-kadence-blocks-css.php). + * A claim on any other slug is ignored so the override can never point at a slug no block reads. + * + * @since TBD + * + * @var string[] + */ + protected const SLOTS = [ 'ss-auto', 'none', 'xxs', 'xs', 'sm', 'md', 'lg', 'xl', 'xxl', '3xl', '4xl', '5xl' ]; + + /** + * The primitive dimension tokens that back the spacing slugs; the slug is claimed on the primitive + * itself, so this prefix plus the slug is the projection-holding token's own id. + * + * @since TBD + * + * @var string + */ + protected const PRIMITIVE_PREFIX = 'primitive.dimension.spacing.'; +} diff --git a/includes/resources/Design_Tokens/Projection/Css_Var/Slot_Target_Reader.php b/includes/resources/Design_Tokens/Projection/Css_Var/Slot_Target_Reader.php new file mode 100644 index 0000000000..a0a1bf9fab --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Css_Var/Slot_Target_Reader.php @@ -0,0 +1,101 @@ + value map, so Kadence Blocks' legacy + * `--global-kb--*` variable families can be fed from the design tokens instead of a hardcoded + * copy (see includes/init.php and class-kadence-blocks-editor-assets.php). + * + * The single source of a scale is the baseline: each slug's value comes from resolving the primitive that + * backs it (Target::get_primitive_id()), so the shipped literals live once. For spacing/gap that primitive + * is the projection-holding token itself; for font-size it is the primitive the semantic aliases, so the + * value is the fluid clamp() rather than the semantic's flat base. + * + * Fails open to an empty array when the registry is inactive or a stored document cannot be resolved, so a + * caller keeps its own fallback and a broken token store never suppresses KB's own scale. + * + * @since TBD + */ +final class Slot_Target_Reader { + + /** + * @var Token_Registry + */ + private Token_Registry $registry; + + /** + * @var Token_Resolver + */ + private Token_Resolver $resolver; + + /** + * Owns the active-library pointer, so the scale follows the active library (e.g. a switched palette) the + * same way the projected CSS does. + * + * @since TBD + * + * @var Active_Token_Library_Store + */ + private Active_Token_Library_Store $active; + + /** + * @since TBD + * + * @param Token_Registry $registry + * @param Token_Resolver $resolver + * @param Active_Token_Library_Store $active + */ + public function __construct( Token_Registry $registry, Token_Resolver $resolver, Active_Token_Library_Store $active ) { + $this->registry = $registry; + $this->resolver = $resolver; + $this->active = $active; + } + + /** + * The resolved scale for a slot family as a slug => value map. + * + * @since TBD + * + * @param class-string $target_class The slot target defining the family's projection key, + * shipped slugs and backing primitive ids. + * + * @return array Slug => resolved scale value (a length, or a clamp() string for a fluid + * family). + */ + public function read( string $target_class ): array { + if ( ! $this->registry->is_active() ) { + return []; + } + + try { + // Resolve the active library (not just the default) so the scale follows a switched library, matching + // how the projected slot overrides resolve. + $resolved = $this->resolver->resolve( $this->active->get() ); + } catch ( Throwable $e ) { + return []; + } + + $scale = []; + + foreach ( $this->registry->by_projection( $target_class::get_projection_key() ) as $token ) { + $target = $target_class::from_token( $token ); + if ( $target === null ) { + continue; + } + + $value = $resolved->value( $target_class::get_primitive_id( $target->slot() ) ); + if ( is_string( $value ) && $value !== '' ) { + $scale[ $target->slot() ] = $value; + } + } + + return $scale; + } +} diff --git a/includes/resources/Design_Tokens/Projection/Editor_Css.php b/includes/resources/Design_Tokens/Projection/Editor_Css.php new file mode 100644 index 0000000000..618dab55b3 --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Editor_Css.php @@ -0,0 +1,86 @@ +registry = $registry; + $this->projectors = $projectors; + } + + /** + * The combined design-token editor CSS, or an empty string when the registry is deactivated. + * + * @since TBD + * + * @return string + */ + public function css(): string { + if ( ! $this->registry->is_active() ) { + return ''; + } + + $css = ''; + + foreach ( $this->projectors->all() as $projector ) { + $css .= $projector->editor_css(); + } + + return $css; + } +} diff --git a/includes/resources/Design_Tokens/Projection/Kadence_Option/Palette_Builder.php b/includes/resources/Design_Tokens/Projection/Kadence_Option/Palette_Builder.php new file mode 100644 index 0000000000..522f6343ab --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Kadence_Option/Palette_Builder.php @@ -0,0 +1,220 @@ + { color, name } map from every token that claims a palette kadence_slot and + * resolves to a value, then merges that map onto a decoded existing option. No WordPress calls, no + * globals, no I/O: the projector owns get_option/update_option and hands decoded arrays in and out, so + * every merge rule here is unit-testable without the database. + * + * The two options have deliberately different merge rules: + * + * - kadence_blocks_colors (KB's own) — overwrite color AND name of a claimed slug, append a claimed + * slug not yet present, and preserve every other entry plus the "override" flag. + * - kadence_global_palette (the theme's) — overwrite ONLY color of a claimed slug; never append and + * never touch names, since the theme owns the slot labels and structure. + * + * @since TBD + */ +final class Palette_Builder { + + /** + * The token registry. + * + * @since TBD + * + * @var Token_Registry + */ + private Token_Registry $registry; + + /** + * @param Token_Registry $registry + */ + public function __construct( Token_Registry $registry ) { + $this->registry = $registry; + } + + /** + * Whether any token claims a palette slot — the value-independent, in-memory gate the projector + * checks before resolving (resolution is the expensive step). + * + * @since TBD + * + * @return bool + */ + public function has_palette_tokens(): bool { + foreach ( $this->registry->by_projection( Kadence_Palette_Slot::get_projection_key() ) as $token ) { + if ( Kadence_Palette_Slot::from_token( $token ) !== null ) { + return true; + } + } + + return false; + } + + /** + * Slug => [ 'color' => hex, 'name' => label ] for every token that claims a palette slot AND + * resolves to a non-empty value. Returns [] when nothing applies, so the caller skips both writes. + * + * @since TBD + * + * @param Resolved_Tokens $resolved The resolved token maps. + * + * @return array + */ + public function entries( Resolved_Tokens $resolved ): array { + $entries = []; + + foreach ( $this->registry->by_projection( Kadence_Palette_Slot::get_projection_key() ) as $id => $token ) { + $slot = Kadence_Palette_Slot::from_token( $token ); + if ( $slot === null ) { + continue; + } + + $value = $resolved->value( $id ); + if ( $value === null || $value === '' ) { + continue; + } + + $entries[ $slot->slug ] = [ + 'color' => $value, + 'name' => $token->label, + ]; + } + + return $entries; + } + + /** + * Merge token entries into a decoded kadence_blocks_colors payload (KB's own option). + * + * Overwrites the color and name of any entry whose slug a token claims, appends an entry for a + * claimed slug not yet present, and preserves all other entries plus the "override" flag (defaulting + * it to false on a fresh write so KB merges rather than replaces the theme palette). Entry shape is + * { color, name, slug } — exactly what KB's consumers read. + * + * @since TBD + * + * @param array $existing Decoded option, or [] when absent. + * @param array $entries slug => {color,name} from entries(). + * + * @return array The merged payload (re-encode and store). + */ + public function merge_kadence_blocks_colors( array $existing, array $entries ): array { + $palette = $this->palette_list( $existing ); + $claimed = []; + + foreach ( $palette as $index => $entry ) { + if ( ! is_array( $entry ) ) { + continue; + } + + $slug = $this->entry_slug( $entry ); + if ( $slug === null || ! isset( $entries[ $slug ] ) ) { + continue; + } + + $entry['color'] = $entries[ $slug ]['color']; + $entry['name'] = $entries[ $slug ]['name']; + $palette[ $index ] = $entry; + $claimed[ $slug ] = true; + } + + foreach ( $entries as $slug => $data ) { + if ( isset( $claimed[ $slug ] ) ) { + continue; + } + + $palette[] = [ + 'color' => $data['color'], + 'name' => $data['name'], + 'slug' => $slug, + ]; + } + + $existing['palette'] = array_values( $palette ); + + if ( ! array_key_exists( 'override', $existing ) ) { + $existing['override'] = false; + } + + return $existing; + } + + /** + * Merge token entries into a decoded kadence_global_palette payload (the Kadence theme's option). + * + * Overwrites ONLY the color of entries whose slug a token claims; never appends and never rewrites a + * name (the theme owns slot labels and structure). An unexpected shape (no list under "palette") is + * returned untouched, so the theme's option is left exactly as found. + * + * @since TBD + * + * @param array $existing Decoded option (caller guarantees it exists). + * @param array $entries slug => {color,name} from entries(). + * + * @return array The merged payload (re-encode and store). + */ + public function merge_theme_palette( array $existing, array $entries ): array { + $palette = $this->palette_list( $existing ); + if ( $palette === [] ) { + return $existing; // Unexpected shape — leave the theme's option exactly as found. + } + + foreach ( $palette as $index => $entry ) { + if ( ! is_array( $entry ) ) { + continue; + } + + $slug = $this->entry_slug( $entry ); + if ( $slug === null || ! isset( $entries[ $slug ] ) ) { + continue; + } + + $entry['color'] = $entries[ $slug ]['color']; + $palette[ $index ] = $entry; + } + + $existing['palette'] = array_values( $palette ); + + return $existing; + } + + /** + * The "palette" list from a decoded option, or [] when missing or malformed. + * + * @since TBD + * + * @param array $existing Decoded option. + * + * @return array + */ + private function palette_list( array $existing ): array { + return isset( $existing['palette'] ) && is_array( $existing['palette'] ) ? $existing['palette'] : []; + } + + /** + * A palette entry's slug as a string, or null when it has no usable string "slug". + * + * @since TBD + * + * @param array $entry A single (already array-typed) palette entry. + * + * @return string|null + */ + private function entry_slug( array $entry ): ?string { + if ( ! isset( $entry['slug'] ) || ! is_string( $entry['slug'] ) ) { + return null; + } + + return $entry['slug']; + } +} diff --git a/includes/resources/Design_Tokens/Projection/Kadence_Option/Projector.php b/includes/resources/Design_Tokens/Projection/Kadence_Option/Projector.php new file mode 100644 index 0000000000..cf4333ab72 --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Kadence_Option/Projector.php @@ -0,0 +1,290 @@ +registry = $registry; + $this->resolver = $resolver; + $this->store = $store; + $this->active = $active; + $this->builder = $builder; + } + + /** + * Once-per-request reconcile. Bound to the boot pass (low priority on init) and may be re-entered by + * on_tokens_changed(); the per-request guard keeps it to one pass unless a write forces a re-sync. + * + * @since TBD + * + * @return void + */ + public function reconcile(): void { + if ( $this->reconciled_this_request ) { + return; + } + $this->reconciled_this_request = true; + + $this->sync(); + } + + /** + * Force a re-sync after a token write, regardless of the per-request guard, so the new values land + * in the same request. Bound to kadence_blocks_design_tokens_changed. + * + * @since TBD + * + * @return void + */ + public function on_tokens_changed(): void { + $this->reconciled_this_request = true; // A write supersedes the boot pass for this request. + $this->sync(); + } + + /** + * The sync itself: gate, resolve, short-circuit on an unchanged signature, then write. + * + * @since TBD + * + * @return void + */ + private function sync(): void { + if ( ! $this->registry->is_active() || ! $this->builder->has_palette_tokens() ) { + return; + } + + $slug = $this->active->get(); + $theme_present = $this->theme_palette_exists(); + $signature = KADENCE_BLOCKS_VERSION . ':' . $this->store->get_version( $slug ) . ':' . ( $theme_present ? '1' : '0' ); + + // Skip the resolve + writes when neither the active library's version nor the theme-option presence + // changed since the last successful sync. Switching the active library changes its version, so the + // signature flips and the next reconcile re-syncs; the theme-present bit catches a theme switch. + if ( get_option( self::SYNC_MARKER_OPTION ) === $signature ) { + return; + } + + try { + $resolved = $this->resolver->resolve( $slug ); + } catch ( RuntimeException $e ) { + // Corrupt stored document (alias cycle / dangling alias from a raw DB write). Fail open: + // leave both options exactly as they are; do NOT advance the marker, so a later clean write + // re-attempts. + return; + } + + $entries = $this->builder->entries( $resolved ); + + // Empty entries is a valid resolved state (no token values set yet). Still advance the marker so + // the next request short-circuits rather than re-resolving. When the user writes token values the + // store version changes, the signature flips, and the next reconcile re-enters the write path. + if ( $entries !== [] ) { + $this->sync_kb_colors( $entries ); // Always. + + if ( $theme_present ) { // Only when it already exists. + $this->sync_theme_palette( $entries ); + } + } + + // Autoloaded: the boot pass reads this marker on every request to short-circuit, so it must not + // cost a dedicated query. It is a tiny "{version}:{theme-bit}" string. + update_option( self::SYNC_MARKER_OPTION, $signature, true ); + } + + /** + * Always-on sync of KB's own kadence_blocks_colors. Reads + decodes the existing JSON, merges, and + * writes back as JSON. update_option no-ops when the string is unchanged. + * + * @since TBD + * + * @param array $entries + * + * @return void + */ + private function sync_kb_colors( array $entries ): void { + $raw = get_option( self::KB_COLORS_OPTION, '' ); + $decoded = $this->decode( $raw ); + $merged = $this->builder->merge_kadence_blocks_colors( $decoded, $entries ); + + // Pass true to ensure this option is autoloaded: it is read on every front-end request + // (load_color_palette() in after_setup_theme, load_color_palette_theme_json() on + // wp_theme_json_data_theme). update_option only writes when the value changes, and preserves + // autoload each time it does — which is the state we want. + update_option( self::KB_COLORS_OPTION, (string) wp_json_encode( $merged ), true ); + } + + /** + * Conditional sync of the Kadence theme's kadence_global_palette. The caller has already proved the + * option exists; we re-read it for the merge. Never creates it. + * + * @since TBD + * + * @param array $entries + * + * @return void + */ + private function sync_theme_palette( array $entries ): void { + if ( ! $this->theme_palette_exists() ) { + return; // raced away between probe and here; never create. + } + + $raw = get_option( self::THEME_PALETTE_OPTION, '' ); + $decoded = $this->decode( $raw ); + $merged = $this->builder->merge_theme_palette( $decoded, $entries ); + + // Pass null so update_option preserves the theme's existing autoload setting rather than + // forcing it. It only writes when the value changes. + update_option( self::THEME_PALETTE_OPTION, (string) wp_json_encode( $merged ), null ); + } + + /** + * Whether the Kadence theme's palette option exists. Uses !== false because get_option() returns + * false only when the row is absent, and kadence_global_palette always stores a JSON string. + * + * @since TBD + * + * @return bool + */ + private function theme_palette_exists(): bool { + return get_option( self::THEME_PALETTE_OPTION ) !== false; + } + + /** + * Decode a stored JSON option to an array, tolerating an empty/invalid value (=> []). + * + * @since TBD + * + * @param mixed $raw + * + * @return array + */ + private function decode( $raw ): array { + if ( ! is_string( $raw ) || $raw === '' ) { + return []; + } + + $decoded = json_decode( $raw, true ); + + return is_array( $decoded ) ? $decoded : []; + } +} diff --git a/includes/resources/Design_Tokens/Projection/Kadence_Option/Provider.php b/includes/resources/Design_Tokens/Projection/Kadence_Option/Provider.php new file mode 100644 index 0000000000..9bb02f1989 --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Kadence_Option/Provider.php @@ -0,0 +1,37 @@ +container->singleton( Palette_Builder::class ); + $this->container->singleton( Projector::class ); + + // Boot pass: run late on init (after the registry's declarations are registered on init, and + // after the baseline/guard is in place) so the option reflects the current store on every load. + // This is the "always" sync and the seam that catches a theme switch on the next request. + add_action( 'init', $this->container->callback( Projector::class, 'reconcile' ), 20 ); + + // Immediate re-sync on a token write, so the new values land within the same request. + add_action( + Token_Store::changed_action(), + $this->container->callback( Projector::class, 'on_tokens_changed' ), + 10 + ); + } +} diff --git a/includes/resources/Design_Tokens/Projection/Kadence_Palette_Slot.php b/includes/resources/Design_Tokens/Projection/Kadence_Palette_Slot.php new file mode 100644 index 0000000000..39b9ca48e4 --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Kadence_Palette_Slot.php @@ -0,0 +1,95 @@ + 'palette1' // semantic.color.button-bg => slot "palette1" + * + * Font-size slots (sm/md/lg/…) also travel under "kadence_slot" but are NOT palette slots; from_token() + * returns null for them, so callers that only care about colors skip them cleanly. + * + * @since TBD + */ +final class Kadence_Palette_Slot { + + /** + * The projection key a token declares to claim a Kadence slot. + * + * @since TBD + * + * @var string + */ + private const PROJECTION = 'kadence_slot'; + + /** + * Matches the nine Kadence palette slots, palette1…palette9. + * + * @since TBD + * + * @var string + */ + private const SLOT_PATTERN = '/^palette[1-9]$/'; + + /** + * The palette slot slug, e.g. "palette1". This is the entry slug in both palette options and the + * suffix of --global-paletteN. + * + * @since TBD + * + * @var string + */ + public string $slug; + + /** + * @param string $slug Palette slot slug (palette1…palette9). + */ + private function __construct( string $slug ) { + $this->slug = $slug; + } + + /** + * The projection key. + * + * @since TBD + * + * @return string + */ + public static function get_projection_key(): string { + return self::PROJECTION; + } + + /** + * Resolve a token's kadence_slot config to a palette slot, or null when the token declares no + * kadence_slot, or declares one that is not a palette slot (e.g. a font-size key). + * + * @since TBD + * + * @param Token_Definition $token The token definition. + * + * @return self|null + */ + public static function from_token( Token_Definition $token ): ?self { + // A missing projection (?? null), a non-string value, and a string that is not palette1…palette9 + // all collapse to "not a palette slot" here, so no separate has_projection() guard is needed. + $slot = $token->projections[ self::PROJECTION ] ?? null; + + if ( ! is_string( $slot ) || preg_match( self::SLOT_PATTERN, $slot ) !== 1 ) { + return null; + } + + return new self( $slot ); + } +} diff --git a/includes/resources/Design_Tokens/Projection/Palette/Css_Builder.php b/includes/resources/Design_Tokens/Projection/Palette/Css_Builder.php new file mode 100644 index 0000000000..59dfb05c6b --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Palette/Css_Builder.php @@ -0,0 +1,97 @@ +"]` selector per + * palette that re-declares the matched element's subtree with that palette's fully-resolved colors. + * + * The library's `$current` palette is applied at `:root` by the resolver (see Effective_Palettes / Token_Resolver), + * so every block follows it by default. A block that carries a per-instance palette override renders a + * `data-kb-palette=""` attribute; the matching selector here re-declares that palette's resolved color + * vars — primitives, the semantics that alias them, and shadow composites — as literals on the element, so + * its subtree resolves against the chosen palette instead of the library `$current`. + * + * A single attribute-presence `[data-kb-palette]` rule re-emits the canonical `--kb-token--preset--*` + * declarations (var()-preserving) so a preset var re-resolves against the subtree's re-declared semantics — + * a preset Button whose color aliases a palette-changed token re-skins with the rest of its subtree, at any + * palette, respecting preset selection (a selected preset keeps its own binding, re-tinted). + * + * This is the narrow color-only replacement for the cross-library `[data-kb-token-set]` switch removed by the + * single-active-library pivot: it stays within the single active library and swaps only colors. A palette that + * re-tints a slot-backed color re-declares its numbered `--global-paletteN` bridge too (built in + * {@see Projector::palettes_for()}), so a `[data-kb-palette]` subtree live-swaps content that reads a numbered + * `--global-paletteN` bridge directly — including the WordPress preset color classes the Projector redirects to + * it — as well as content reading `--kb-token--*` color vars (directly or through a preset). + * + * Pure: no WordPress calls, no globals, no side effects. The WordPress wiring lives in Projector. + * + * @since TBD + */ +final class Css_Builder { + + use Sanitizes_Css_Identifier; + use Sanitizes_Css_Value; + + /** + * The HTML attribute a block sets to render its subtree against a specific palette. + * + * @since TBD + * + * @var string + */ + private const SWITCH_ATTR = 'data-kb-palette'; + + /** + * The attribute name a block wrapper carries to select a palette for its subtree ("data-kb-palette"). + * + * @since TBD + * + * @return string + */ + public static function get_switch_attribute(): string { + return self::SWITCH_ATTR; + } + + /** + * Build the palette switch layer: a shared `[data-kb-palette]{ --kb-token--preset--*: … }` rule (so + * preset vars re-resolve inside any palette subtree) followed by one + * `[data-kb-palette=""]{ : ; … }` selector per palette. A palette with no resolved + * color vars emits nothing. + * + * @since TBD + * + * @param array> $palettes palette id => ( css-var => resolved literal ). + * @param string $preset_declarations The canonical `--kb-token--preset--*` + * declarations to re-emit under the shared + * presence selector (already sanitized). + * + * @return string + */ + public function css( array $palettes, string $preset_declarations = '' ): string { + $css = ''; + + if ( $preset_declarations !== '' ) { + $css .= '[' . self::SWITCH_ATTR . ']{' . $preset_declarations . '}'; + } + + foreach ( $palettes as $id => $vars ) { + $declarations = ''; + + foreach ( $vars as $var => $value ) { + $declarations .= (string) $var . ':' . $this->sanitize_value( (string) $value ) . ';'; + } + + if ( $declarations === '' ) { + continue; + } + + $css .= '[' . self::SWITCH_ATTR . '="' . self::sanitize_identifier( (string) $id ) . '"]{' . $declarations . '}'; + } + + return $css; + } +} diff --git a/includes/resources/Design_Tokens/Projection/Palette/Projector.php b/includes/resources/Design_Tokens/Projection/Palette/Projector.php new file mode 100644 index 0000000000..f367b0b42b --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Palette/Projector.php @@ -0,0 +1,360 @@ +"]` selector per palette (built by {@see Css_Builder}), + * appended to KB's inline style handles on the front end and in the editor, gated on + * Token_Registry::is_active(). A block that carries a `data-kb-palette` override renders its subtree against + * the chosen palette; a block with no override follows the library `$current` at `:root` (applied by the resolver). + * + * @since TBD + */ +final class Projector extends Abstract_Css_Projector { + + /** + * Object-cache group shared with the rest of the Design Tokens module. + * + * @since TBD + * + * @var string + */ + private const CACHE_GROUP = 'kb_design_tokens'; + + /** + * @var Token_Registry + * + * @since TBD + */ + private Token_Registry $registry; + + /** + * @var Token_Store The store, for the cache-busting version. + * + * @since TBD + */ + private Token_Store $store; + + /** + * Owns the active-library pointer, read at build time so the projection follows the active library. + * + * @since TBD + * + * @var Active_Token_Library_Store + */ + private Active_Token_Library_Store $active; + + /** + * @var Effective_Palettes Reads the active library's effective palettes and their flattened swatches. + * + * @since TBD + */ + private Effective_Palettes $palettes; + + /** + * @var Token_Resolver Resolves each palette's full color graph (primitives, semantics, composites). + * + * @since TBD + */ + private Token_Resolver $resolver; + + /** + * @var Preset_Css_Builder Supplies the canonical preset-var declarations the switch layer re-emits. + * + * @since TBD + */ + private Preset_Css_Builder $presets; + + /** + * @var Css_Builder + * + * @since TBD + */ + private Css_Builder $css_builder; + + /** + * Per-request memo of built CSS, keyed on the active slug and store version. + * + * @since TBD + * + * @var array + */ + private array $memo = []; + + /** + * @since TBD + * + * @param Token_Registry $registry The token registry. + * @param Token_Store $store The store, for the cache-busting version. + * @param Active_Token_Library_Store $active Owns the active-library pointer. + * @param Effective_Palettes $palettes Reads the active library's effective palettes. + * @param Token_Resolver $resolver Resolves each palette's full color graph. + * @param Preset_Css_Builder $presets Supplies the canonical preset-var declarations. + * @param Css_Builder $css_builder The palette switch-layer builder. + */ + public function __construct( + Token_Registry $registry, + Token_Store $store, + Active_Token_Library_Store $active, + Effective_Palettes $palettes, + Token_Resolver $resolver, + Preset_Css_Builder $presets, + Css_Builder $css_builder + ) { + $this->registry = $registry; + $this->store = $store; + $this->active = $active; + $this->palettes = $palettes; + $this->resolver = $resolver; + $this->presets = $presets; + $this->css_builder = $css_builder; + } + + /** + * Append the palette switch layer to the front-end global-variables handle. + * + * @since TBD + * + * @return void + */ + public function enqueue_front_end(): void { + if ( ! $this->registry->is_active() ) { + return; + } + + $css = $this->css(); + + if ( $css !== '' ) { + wp_add_inline_style( 'kadence-blocks-global-variables', $css ); + } + } + + /** + * Append the palette switch layer to the editor global-styles handle. + * + * Shares the Css_Var projector's editor gate (the same page check and filter), so the palette layer and + * the token vars load together in the editor or not at all. + * + * @since TBD + * + * @return void + */ + public function enqueue_editor(): void { + if ( ! $this->registry->is_active() ) { + return; + } + + /** This filter is documented in includes/resources/Design_Tokens/Projection/Css_Var/Projector.php */ + if ( ! apply_filters( 'kadence_blocks_load_editor_token_vars', Location::is_block_editor() ) ) { + return; + } + + $css = $this->css(); + + if ( $css !== '' ) { + wp_add_inline_style( 'kadence-blocks-global-editor-styles', $css ); + } + } + + /** + * Build the palette switch layer for the active library, memoised per request and cached on the store + * version. Returns an empty string when the active library cannot be read, so the page never crashes. + * + * @since TBD + * + * @return string + */ + public function css(): string { + try { + $active = $this->active->get(); + $version = $this->store->get_version( $active ); + } catch ( Throwable $e ) { + return ''; + } + + $cache_key = 'palette_switch_css_' . KADENCE_BLOCKS_VERSION . '_' . $active . '_' . $version; + + if ( isset( $this->memo[ $cache_key ] ) ) { + return $this->memo[ $cache_key ]; + } + + $cached = wp_cache_get( $cache_key, self::CACHE_GROUP, false, $found ); + + if ( $found && is_string( $cached ) ) { + $this->memo[ $cache_key ] = $cached; + + return $cached; + } + + $css = $this->css_builder->css( + $this->palettes_for( $active ), + $this->presets->canonical_declarations( $active ) + ) . $this->global_palette_overrides(); + + wp_cache_set( $cache_key, $css, self::CACHE_GROUP, DAY_IN_SECONDS ); + + $this->memo[ $cache_key ] = $css; + + return $css; + } + + /** + * Each palette's fully-resolved color graph, limited to the vars any palette re-tints, keyed + * `id => ( css-var => resolved literal )`. Every palette emits the SAME var set (the union of what each + * palette changes against the baseline default), each carrying that palette's own value, so a per-block + * `[data-kb-palette]` override completely replaces the subtree's colors — semantics and shadow composites + * included — no matter which palette the library `$current` points at. A var no palette changes is identical + * everywhere, so it is left to inherit and never re-declared. + * + * Each slot-backed color additionally re-declares its numbered `--global-paletteN` bridge to the same + * per-palette value, so content that reads the numbered bridge (including the WordPress preset color classes + * redirected to it by {@see global_palette_overrides()}) swaps alongside the `--kb-token--*` vars. + * + * @since TBD + * + * @param string $active The active library slug. + * + * @return array> + */ + private function palettes_for( string $active ): array { + $ids = $this->palettes->palette_ids( $active ); + $baseline = $this->resolver->resolve_palette( $active, $this->palettes->default_palette( $active ) )->by_var(); + + $resolved = []; + $changed = []; + + foreach ( $ids as $id ) { + $by_var = $this->resolver->resolve_palette( $active, $id )->by_var(); + $resolved[ $id ] = $by_var; + + foreach ( $by_var as $var => $value ) { + if ( ( $baseline[ $var ] ?? null ) !== $value ) { + $changed[ $var ] = true; + } + } + } + + $slots = $this->palette_slot_vars(); + $palettes = []; + + foreach ( $ids as $id ) { + $declarations = []; + + foreach ( array_keys( $changed ) as $var ) { + if ( array_key_exists( $var, $resolved[ $id ] ) ) { + $declarations[ $var ] = $resolved[ $id ][ $var ]; + + // Also swap the numbered --global-paletteN bridge for a slot-backed color, so blocks (and the + // WordPress preset color classes redirected to it, see global_palette_overrides()) that read the + // numbered bridge follow the palette too — not only content reading --kb-token--* directly. + if ( isset( $slots[ $var ] ) ) { + $declarations[ '--global-' . $slots[ $var ] ] = $resolved[ $id ][ $var ]; + } + } + } + + if ( $declarations !== [] ) { + $palettes[ $id ] = $declarations; + } + } + + return $palettes; + } + + /** + * The palette-slot tokens' css vars mapped to their slot slug (e.g. + * `--kb-token--primitive--color--brand--secondary` => `palette2`), so palettes_for() can bridge each slot's + * per-palette value onto the numbered `--global-paletteN` variable. Skips any non-palette `kadence_slot` + * (e.g. a font-size slot). + * + * @since TBD + * + * @return array css var => slot slug. + */ + private function palette_slot_vars(): array { + $slots = []; + + foreach ( $this->registry->by_projection( Kadence_Palette_Slot::get_projection_key() ) as $token ) { + $slot = Kadence_Palette_Slot::from_token( $token ); + + if ( $slot === null ) { + continue; + } + + $slots[ $token->css_var ] = $slot->slug; + } + + return $slots; + } + + /** + * Static CSS that redirects a Kadence block's WordPress preset color classes — `has--color` and + * `has--background-color` — to the numbered `--global-paletteN` variable. + * + * The selector is scoped to Kadence's own classes (`[class*="kadence-"]`), so only our own blocks are affected + * — core and third-party blocks keep reading WordPress's untouched global `--wp--preset--color--*` variables. + * The broad `kadence-` match (not `wp-block-kadence-`) is deliberate: on the front end the preset class and the + * block's `wp-block-kadence-*` class share one element, but in the editor the preset class lands on an inner + * heading that carries a `kadence-*` class without the `wp-block-kadence-*` wrapper class. The `:root` prefix + * adds specificity, enough to beat both the front-end preset rule and the editor's zero-specificity + * `:where(.editor-styles-wrapper)`-scoped copy of it. + * + * The baseline is unchanged. At `:root`, `--global-paletteN` already equals the color WordPress provides for + * that slot (Kadence feeds both from the same palette). Inside a `[data-kb-palette]` subtree the numbered + * bridge is re-declared (see palettes_for()), so the redirected color follows the per-block palette. + * + * Why that subtree re-declaration is needed depends on the theme. On a non-Kadence theme `--global-paletteN` + * is itself a `var(--kb-token--*)` reference (set by the Css_Var Legacy_Filter_Bridge), so it already + * re-resolves against a subtree's re-declared token on its own — the re-declaration there is a harmless + * redundancy. Under the Kadence theme `--global-paletteN` is a fixed customizer literal with no token + * reference (and Legacy_Filter_Bridge is a no-op), so re-declaring it in palettes_for() is what makes it swap. + * + * Both slug schemes map to the same bridge: the plugin's own `palette-N` and the Kadence theme's + * `theme-palette-N`. The `theme-palette-N` selectors are simply inert on other themes. + * + * @since TBD + * + * @return string + */ + private function global_palette_overrides(): string { + $css = ''; + + foreach ( $this->registry->by_projection( Kadence_Palette_Slot::get_projection_key() ) as $token ) { + $slot = Kadence_Palette_Slot::from_token( $token ); + + if ( $slot === null ) { + continue; + } + + // WordPress kebab-cases the stored slug ("palette2") for the class/var name ("palette-2"). + $kebab = preg_replace( '/([a-z])(\d)/', '$1-$2', $slot->slug ); + + if ( ! is_string( $kebab ) ) { + continue; + } + + $var = 'var(--global-' . $slot->slug . ')'; + $scope = ':root [class*="kadence-"]'; + + foreach ( [ $kebab, 'theme-' . $kebab ] as $class_slug ) { + $css .= $scope . '.has-' . $class_slug . '-color{color:' . $var . ' !important;}'; + $css .= $scope . '.has-' . $class_slug . '-background-color{background-color:' . $var . ' !important;}'; + } + } + + return $css; + } +} diff --git a/includes/resources/Design_Tokens/Projection/Palette/Provider.php b/includes/resources/Design_Tokens/Projection/Palette/Provider.php new file mode 100644 index 0000000000..23cfdac47b --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Palette/Provider.php @@ -0,0 +1,40 @@ +container->singleton( Css_Builder::class ); + $this->container->singleton( Projector::class ); + + // Contribute this projector's editor CSS to the combined projected-CSS endpoint. + /** @var Css_Projectors $projectors */ + $projectors = $this->container->get( Css_Projectors::class ); + /** @var Projector $projector */ + $projector = $this->container->get( Projector::class ); + $projectors->add( $projector ); + + // Front end: append after the token vars (100) and presets (110), so a subtree's palette override + // follows the base token vars in source order and wins by cascade. + add_action( 'wp_enqueue_scripts', $this->container->callback( Projector::class, 'enqueue_front_end' ), 115 ); + + // Editor: append after the Css_Var (5) and preset (10) editor enqueues on the same handle. + add_action( 'admin_init', $this->container->callback( Projector::class, 'enqueue_editor' ), 15 ); + } +} diff --git a/includes/resources/Design_Tokens/Projection/Palette/Renders_Palette_Attribute.php b/includes/resources/Design_Tokens/Projection/Palette/Renders_Palette_Attribute.php new file mode 100644 index 0000000000..5d3ec3357f --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Palette/Renders_Palette_Attribute.php @@ -0,0 +1,42 @@ +"` the palette projector's `[data-kb-palette]` switch layer + * re-points the block's canonical color vars through. The id runs through the shared + * {@see Sanitizes_Css_Identifier} sanitizer so it always matches the switch selector; this trait is only the + * "read the attribute, produce the wrapper args" seam so every block does it identically. + * + * @since TBD + */ +trait Renders_Palette_Attribute { + + use Sanitizes_Css_Identifier; + + /** + * The `data-kb-palette` wrapper attribute a block's `kbPalette` selection outputs, as a single-entry map + * (or an empty map when nothing is selected). A non-string or empty selection yields nothing, so a block can + * pass the raw attribute straight through. + * + * @since TBD + * + * @param mixed $kb_palette The block's `kbPalette` attribute (the selected palette id). + * + * @return array + */ + protected function palette_attributes( $kb_palette ): array { + if ( ! is_string( $kb_palette ) || $kb_palette === '' ) { + return []; + } + + return [ 'data-kb-palette' => self::sanitize_identifier( $kb_palette ) ]; + } +} diff --git a/includes/resources/Design_Tokens/Projection/Preset/Css_Builder.php b/includes/resources/Design_Tokens/Projection/Preset/Css_Builder.php new file mode 100644 index 0000000000..3f221e47aa --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Preset/Css_Builder.php @@ -0,0 +1,1032 @@ +" + * class to the block, and this builder emits, per (block, preset), a rule that retargets the --global-* + * custom properties (a numbered palette slot or a named button slot) the block consumes in its render path + * / SCSS, re-skinning it with zero changes to the block's markup. + * + * A block declares one flat preset list, and each preset may define a different subset of the block's + * bound surface; the build emits, per preset, exactly the properties that preset resolves. Two presets + * that both retarget the same --global- carry equal specificity, so the selected-preset rule wins + * over the class-less $default rule by higher specificity, and a per-instance edit wins over both. + * + * Only the active library is emitted (the active-library pointer selects it). The build has two layers: + * + * 1. The canonical preset-var definitions at `:root` — + * --kb-token--preset------: — where an aliased binding reads + * var(--kb-token--) so the preset chains to the active library's canonical token, and a literal + * binding emits the literal. + * 2. Per (block, preset) scoped rules — ".wp-block-.kb-preset--" — pointing each + * --global- at the canonical preset var, plus a class-less ".wp-block-" rule for the + * $default preset so a block with no preset selected still shows its preset. + * 3. Per (block, preset) STATE rules for any binding declaring a `css_state` — the block-and-preset + * qualification wrapped in `:where()` so it costs no specificity, with the state suffix appended + * (":where(.wp-block-.kb-preset--):hover > .kt-inside-inner-col") — carrying a real + * declaration, ": var()", rather than a var retarget. The $default's + * counterpart is qualified by "this block carries no preset class" so the two can never both match. + * A state has no variable of the block's own to point at: the block renders its resting appearance + * from an attribute or a token default, and its state appearance only when the block itself sets one, + * so there is nothing for a preset to redirect. This layer supplies the state rule outright. It is + * the ONLY layer that renders a state binding — the block-default-CSS projector skips them, because + * that layer renders only the $default preset and so would put a state rule on every instance of the + * block whether or not a preset asked for one. See {@see Binding::CSS_STATE}. + * + * Scoping is per (block, preset): the same preset name on two blocks ("ghost" on a Button and a Row) gets + * its own qualified rule, so values never collide. Both named presets and the "$default" preset carry + * ordinary class/element specificity, so a per-instance edit still wins. + * + * Nothing here is !important and the scope carries ordinary class specificity, so a per-instance inline + * style still wins over a preset. Values are sanitized defensively before they reach a declaration. + * + * Pure: no WordPress calls beyond the object cache in css_for_version(). The hooks live in Projector. + * + * @since TBD + */ +final class Css_Builder { + + use Composes_Selector_Suffix; + use Sanitizes_Css_Identifier; + use Sanitizes_Css_Value; + + /** + * The preset var namespace, appended after the shared --kb-token-- prefix. + * + * @since TBD + * + * @var string + */ + private const PRESET_SEGMENT = 'preset--'; + + /** + * The four positional slot labels a per-slot dimension property's base declaration splits into, + * in CSS shorthand order (top, right, bottom, left). They are positional labels, not a claim + * about geometry: for a side-shaped property (padding, margin, border width) the label matches + * the CSS side it names, while for a corner-shaped property such as `button-radius` index + * 0/`'top'` is really the top-left corner. Index N here is slot index N everywhere else in the + * pipeline — the resolver's slot list and the editor's `dimensionSlots()`. + * + * @since TBD + * + * @var string[] + */ + private const SLOTS = [ 'top', 'right', 'bottom', 'left' ]; + + /** + * Kadence theme global custom-property slots a preset may retarget beyond the numbered palette + * (palette1..9). These are the button's own color slots — the exact --global-* properties the + * button render path already consumes — so a preset re-skins the button with no change to its + * render path. + * + * @since TBD + * + * @var string[] + */ + private const NAMED_GLOBAL_SLOTS = [ + 'palette-btn-bg', + 'palette-btn', + 'palette-btn-bg-hover', + 'palette-btn-hover', + ]; + + /** + * Object-cache group shared with the rest of the Design Tokens module. + * + * @since TBD + * + * @var string + */ + private const CACHE_GROUP = 'kb_design_tokens'; + + /** + * @var Token_Registry The registry the preset bindings are read from. + * + * @since TBD + */ + private Token_Registry $registry; + + /** + * @var Preset_Resolver Flattens each preset's bindings to resolved CSS values. + * + * @since TBD + */ + private Preset_Resolver $presets; + + /** + * @var Token_Store The store, read for the cache-busting version the collect memo keys on. + * + * @since TBD + */ + private Token_Store $store; + + /** + * Per-request memo of built CSS, keyed on the active library's object-cache key, so a write (which bumps the + * library's version) invalidates the affected entry on its own. + * + * @since TBD + * + * @var array + */ + private array $memo = []; + + /** + * Per-request memo of the collected preset structure, keyed on the library slug AND its store version, so the + * registry/resolver walk runs once per library even when several layers read it, yet a write (which bumps the + * version) produces a fresh collection rather than serving the pre-write structure. + * + * @since TBD + * + * @var array>}>> + */ + private array $collected = []; + + /** + * @since TBD + * + * @param Token_Registry $registry The token registry. + * @param Preset_Resolver $presets The preset resolver. + * @param Token_Store $store The store, for the cache-busting version. + */ + public function __construct( Token_Registry $registry, Preset_Resolver $presets, Token_Store $store ) { + $this->registry = $registry; + $this->presets = $presets; + $this->store = $store; + } + + /** + * Build the active library's preset CSS: the canonical preset-var definitions plus the scoped retarget + * rules. The pure, uncached assembler (its cached counterpart is css_for_version()). + * + * @since TBD + * + * @param string $active_slug The active library's slug. + * @param array $breakpoints Breakpoint => media-query string (e.g. + * "tablet" => "(max-width: 1024px)"), for the per-breakpoint + * redeclarations. Empty emits none. + * + * @return string The CSS, or an empty string when no block contributes a slot-targeted value. + */ + public function css( string $active_slug, array $breakpoints = [] ): string { + return $this->build( $active_slug, $breakpoints, false ); + } + + /** + * Build the EDITOR-scoped version of the active library's preset CSS. Identical to {@see self::css()} for + * every layer but the state rules: the canonical vars and the `--global-*` / `--kb-*` retargets carry no + * dependency on the markup's shape, so they are reused verbatim. A state binding declaring an + * `editor_css_state` has its rule re-scoped to the element the editor actually renders — the Section + * paints `.kadence-inner-column-inner` in the canvas and `.kt-inside-inner-col` on the front end — so the + * state lands in the preview too. + * + * @since TBD + * + * @param string $active_slug The active library's slug. + * @param array $breakpoints Breakpoint => media-query string. + * + * @return string The CSS, or an empty string when no block contributes a slot-targeted value. + */ + public function editor_css( string $active_slug, array $breakpoints = [] ): string { + return $this->build( $active_slug, $breakpoints, true ); + } + + /** + * Cached version of css(): assembles the active library's preset CSS from the object cache with a per-request + * memo. A write bumps the library's store version, which changes the cache key, so a fresh build is produced on + * the next request. + * + * The plugin version is folded into the cache key alongside the store version, so the cache also busts on a + * plugin build (shipped preset definitions and the baseline can change with it). + * + * @since TBD + * + * @param string $active_slug The active library's slug. + * @param string $version The store version the active library was built from. + * @param array $breakpoints Breakpoint => media-query string, for the per-breakpoint + * redeclarations. + * + * @return string + */ + public function css_for_version( string $active_slug, string $version, array $breakpoints = [] ): string { + return $this->for_version( $active_slug, $version, $breakpoints, false ); + } + + /** + * Cached version of editor_css(): same memo/object-cache mechanics as {@see self::css_for_version()}, but + * keyed under a distinct `editor` context so the editor-scoped string (which differs from the front-end + * one for any state binding declaring an `editor_css_state`) never collides with, or gets served in place + * of, the front-end cache entry. + * + * @since TBD + * + * @param string $active_slug The active library's slug. + * @param string $version The store version the active library was built from. + * @param array $breakpoints Breakpoint => media-query string. + * + * @return string + */ + public function editor_css_for_version( string $active_slug, string $version, array $breakpoints = [] ): string { + return $this->for_version( $active_slug, $version, $breakpoints, true ); + } + + /** + * The active library's canonical `--kb-token--preset--*` declarations, without a selector wrapper — the raw + * `--kb-token--preset------:;` list. The palette switch layer re-emits + * these under `[data-kb-palette]` so a per-block palette override forces each preset var to re-resolve + * against the subtree's re-tinted semantics (a preset that aliases a palette-changed color follows the + * chosen palette, so a preset Button re-skins with the rest of its subtree). + * + * @since TBD + * + * @param string $active_slug The active library's slug. + * + * @return string + */ + public function canonical_declarations( string $active_slug ): string { + return $this->declarations_of( $this->collect( $active_slug ) ); + } + + /** + * Shared cache/memo plumbing for {@see self::css_for_version()} and {@see self::editor_css_for_version()}. + * The context (front end vs editor) is folded into both the per-request memo key and the object-cache key + * so the two builds never share a cache slot. + * + * @since TBD + * + * @param string $active_slug The active library's slug. + * @param string $version The store version the active library was built from. + * @param array $breakpoints Breakpoint => media-query string. + * @param bool $editor Whether to build the editor-scoped CSS. + * + * @return string + */ + private function for_version( string $active_slug, string $version, array $breakpoints, bool $editor ): string { + $context = $editor ? 'editor' : 'front'; + $cache_key = 'preset_css_root_' . $context . '_' . KADENCE_BLOCKS_VERSION . '_' . $active_slug . '_' . $version . '_' . $this->breakpoint_signature( $breakpoints ); + + if ( isset( $this->memo[ $cache_key ] ) ) { + return $this->memo[ $cache_key ]; + } + + $cached = wp_cache_get( $cache_key, self::CACHE_GROUP, false, $found ); + + if ( $found && is_string( $cached ) ) { + return $this->memo[ $cache_key ] = $cached; + } + + $css = $this->build( $active_slug, $breakpoints, $editor ); + + wp_cache_set( $cache_key, $css, self::CACHE_GROUP, DAY_IN_SECONDS ); + + return $this->memo[ $cache_key ] = $css; + } + + /** + * Build (uncached) the active library's preset CSS: the canonical preset-var definitions followed by the + * per-preset scoped rules and the class-less $default rules. The single assembly definition shared by + * css()/editor_css() and their cached counterparts. + * + * @since TBD + * + * @param string $active_slug The active library slug. + * @param array $breakpoints Breakpoint => media-query string. + * @param bool $editor Whether to scope state rules to the editor's markup. + * + * @return string + */ + private function build( string $active_slug, array $breakpoints, bool $editor ): string { + $collected = $this->collect( $active_slug ); + + return $this->canonical_block( $collected ) + . $this->scoped_presets( $collected, $editor ) + . $this->scoped_default( $collected, $editor ) + . $this->responsive_blocks( $active_slug, $collected, $breakpoints ); + } + + /** + * Walk every (block, preset, property) that resolves to a slot-targeted value for a library, into a + * structure the layers below build from. The projected value keeps its var() target canonical, so an + * aliased preset chains to the library's canonical token. Memoized per slug for the request. + * + * @since TBD + * + * @param string $slug The library slug to resolve against. + * + * @return array>}> + */ + private function collect( string $slug ): array { + $key = $slug . '_' . $this->store->get_version( $slug ); + + if ( isset( $this->collected[ $key ] ) ) { + return $this->collected[ $key ]; + } + + $out = []; + + foreach ( $this->registry->preset_binding_blocks() as $block ) { + // A block may carry registered bindings before the document defines its presets; that is not an + // error, it simply contributes nothing yet, so skip a block whose preset bindings the registry never declared. + $bindings = $this->registry->for_block( $block ); + + if ( $bindings === null ) { + continue; + } + + try { + $names = $this->presets->names( $block, $slug ); + } catch ( RuntimeException $e ) { + continue; + } + + $presets = []; + + foreach ( $names as $preset ) { + try { + $values = $this->presets->resolve( $block, $preset, $slug ); + } catch ( RuntimeException $e ) { + continue; + } + + $properties = []; + + foreach ( $values as $property => $value ) { + $binding = $bindings->binding( $property ); + + if ( $binding === null ) { + continue; + } + + // Only a "dimension" kind binding ever carries a per-slot list (the write-time + // guard rejects one on any other kind); gating the slot split on this, rather than + // on the value's own shape, avoids a false-positive split of an unrelated value that + // happens to contain spaces (e.g. a shadow literal). + $dimension = $bindings->kind( $property ) === Preset_Bindings::get_kind_dimension(); + + // A state binding carries a declaration rather than a var retarget, and both of its selectors + // are collected so the front-end and editor builds share one memoized walk. It contributes + // nothing without a property to set, since the state rule IS that declaration. + if ( $binding->is_state() ) { + $prop = $binding->css_prop(); + + if ( $prop === null ) { + continue; + } + + $properties[ $property ] = [ + 'target' => null, + 'value' => $value, + 'dimension' => $dimension, + 'prop' => $prop, + 'state' => $binding->css_state(), + 'editor' => $binding->editor_css_state(), + ]; + + continue; + } + + $target = $this->target_var( $binding ); + + if ( $target === null ) { + continue; + } + + $properties[ $property ] = [ + 'target' => $target, + 'value' => $value, + 'dimension' => $dimension, + 'prop' => null, + 'state' => null, + 'editor' => null, + ]; + } + + if ( $properties !== [] ) { + $presets[ $preset ] = $properties; + } + } + + if ( $presets === [] ) { + continue; + } + + try { + $default = $this->presets->default_preset( $block, $slug ); + } catch ( RuntimeException $e ) { + $default = ''; + } + + $out[ $block ] = [ + 'selector' => $this->block_selector( $block ), + 'default' => $default, + 'presets' => $presets, + ]; + } + + return $this->collected[ $key ] = $out; + } + + /** + * Emit the canonical `--kb-token--preset--*` definitions from the active library's collected presets. The + * value preserves alias indirection canonically, so the preset chains to the active library's token. + * + * @since TBD + * + * @param array>}> $collected The active library's collected presets. + * + * @return string + */ + private function canonical_block( array $collected ): string { + $declarations = $this->declarations_of( $collected ); + + return $declarations === '' ? '' : Scope::root() . '{' . $declarations . '}'; + } + + /** + * The raw `--kb-token--preset--*:;` declaration list for the collected presets, shared by the + * `:root` canonical block and the palette switch layer's re-emission. + * + * A per-slot dimension property (border radius, padding, margin, border width) emits four extra + * slot-specific vars alongside its usual canonical var — see {@see self::property_declarations()}. + * Every other property emits exactly the single declaration it always has. + * + * @since TBD + * + * @param array>}> $collected The active library's collected presets. + * + * @return string + */ + private function declarations_of( array $collected ): string { + $declarations = ''; + + foreach ( $collected as $block => $data ) { + foreach ( $data['presets'] as $preset => $properties ) { + foreach ( $properties as $property => $info ) { + $declarations .= $this->property_declarations( $block, (string) $preset, (string) $property, $info ); + } + } + } + + return $declarations; + } + + /** + * The base declaration(s) for one preset property. + * + * A scalar value (any non-dimension property, or a dimension property whose value was not a + * four-slot shorthand) emits the single canonical declaration it always has: + * `--kb-token--preset------:;`. + * + * A per-slot dimension value instead emits four slot-specific vars — one per {@see self::SLOTS} + * suffix — plus the canonical var, now composed purely from `var()` references to those four: + * `--...--:var(--...--top) var(--...--right) var(--...--bottom) var(--...--left);`. The + * slot vars are new plumbing underneath an unchanged public contract: the composed var's name and + * resolved value are exactly what they always were, so every bridge (`--global-*`, `--kb-btn-radius`) + * that already points at it keeps working unchanged, and {@see self::responsive_blocks()} can redeclare + * a single touched slot without ever redeclaring the composed var itself. + * + * @since TBD + * + * @param string $block The block name. + * @param string $preset The preset slug. + * @param string $property The block property. + * @param array{target:?string, value:string, dimension:bool, prop:?string, state:?string, editor:?string} $info The property's collected target/value/kind. + * + * @return string + */ + private function property_declarations( string $block, string $preset, string $property, array $info ): string { + $slots = $this->slots_of( $info['value'], $info['dimension'] ); + + if ( $slots === null ) { + return $this->preset_var( $block, $preset, $property ) . ':' . $this->sanitize_value( $info['value'] ) . ';'; + } + + $declarations = ''; + $refs = []; + + foreach ( self::SLOTS as $index => $slot_suffix ) { + $slot_var = $this->slot_var( $block, $preset, $property, $slot_suffix ); + $declarations .= $slot_var . ':' . $this->sanitize_value( $slots[ $index ] ) . ';'; + $refs[] = 'var(' . $slot_var . ')'; + } + + return $declarations . $this->preset_var( $block, $preset, $property ) . ':' . implode( ' ', $refs ) . ';'; + } + + /** + * Split a property's projected value into its four slot values, or null when it isn't a per-slot + * dimension value. + * + * The split is lossless because {@see \KadenceWP\KadenceBlocks\Design_Tokens\Resolver\Preset_Resolver::project()} + * is the only place that joins a slot list with a bare space (`implode(' ', $projected)`), and + * `Dtcg_Validator` rejects any slot literal containing a space, so every segment `explode(' ', $value)` + * produces is exactly one slot — including the responsive-only `''` gap sentinel, which round-trips as + * an empty segment. The split is additionally gated on the property being a "dimension" kind binding + * (the only kind a slot list is meaningful for — see {@see Preset_Bindings::kind()}). + * + * @todo A slot list handed over as an array, rather than pre-joined into a string by the resolver, + * would remove the need to split it back apart here at all. + * + * @since TBD + * + * @param string $value The property's projected value. + * @param bool $dimension Whether the property is a "dimension" kind binding. + * + * @return string[]|null The four slot values (index 0-3 = top, right, bottom, left; a gap is `''`), + * or null when the value is not a four-part per-slot shorthand. + */ + private function slots_of( string $value, bool $dimension ): ?array { + if ( ! $dimension ) { + return null; + } + + $parts = explode( ' ', $value ); + + return count( $parts ) === count( self::SLOTS ) ? $parts : null; + } + + /** + * The per-slot var name for a (block, preset, property, slot): the canonical preset var with a + * "--" suffix, e.g. --kb-token--preset--kadence-singlebtn--hero--button-radius--top. + * + * @since TBD + * + * @param string $block The block name. + * @param string $preset The preset slug. + * @param string $property The block property. + * @param string $slot_suffix The slot suffix (one of {@see self::SLOTS}). + * + * @return string + */ + private function slot_var( string $block, string $preset, string $property, string $slot_suffix ): string { + return $this->preset_var( $block, $preset, $property ) . '--' . $slot_suffix; + } + + /** + * The `@media`-block declaration(s) for one breakpoint's override of one property. + * + * A scalar override (a non-dimension property, or a dimension property overridden with one uniform + * value) redeclares the canonical var itself, exactly like the pre-per-slot behavior. A per-slot + * override instead redeclares only the touched slot vars — a `''` gap slot is skipped so that slot + * keeps inheriting live — and never redeclares the composed var (see {@see self::responsive_blocks()}). + * + * @since TBD + * + * @param string $block The block name. + * @param string $preset The preset slug. + * @param string $property The block property. + * @param string $value The breakpoint's projected override value for the property. + * @param bool $dimension Whether the property is a "dimension" kind binding. + * + * @return string + */ + private function responsive_declarations( string $block, string $preset, string $property, string $value, bool $dimension ): string { + $slots = $this->slots_of( $value, $dimension ); + + if ( $slots === null ) { + return $this->preset_var( $block, $preset, $property ) . ':' . $this->sanitize_value( $value ) . ';'; + } + + $declarations = ''; + + foreach ( self::SLOTS as $index => $slot_suffix ) { + if ( $slots[ $index ] === '' ) { + continue; // A gap: not overridden at this breakpoint, keep inheriting live. + } + + $declarations .= $this->slot_var( $block, $preset, $property, $slot_suffix ) . ':' . $this->sanitize_value( $slots[ $index ] ) . ';'; + } + + return $declarations; + } + + /** + * Emit the per-preset scoped rules from the active library's collected presets: per (block, preset) a + * ".wp-block-.kb-preset--" rule pointing each --global- at the canonical preset + * var. + * + * @since TBD + * + * @param array>}> $collected The active library's collected presets. + * + * @return string + */ + private function scoped_presets( array $collected, bool $editor ): string { + $css = ''; + + foreach ( $collected as $block => $data ) { + foreach ( $data['presets'] as $preset => $properties ) { + $preset_class = '.' . Style::preset_class( (string) $preset ); + $declarations = $this->slot_declarations( $block, (string) $preset, $properties ); + + if ( $declarations !== '' ) { + $css .= $data['selector'] . $preset_class . '{' . $declarations . '}'; + } + + $css .= $this->state_rules( + $block, + (string) $preset, + $this->state_scope( $data['selector'], $preset_class ), + $properties, + $editor + ); + } + } + + return $css; + } + + /** + * Emit the class-less $default rules from the active library's collected presets: per block a + * ".wp-block-" rule re-emitting the $default preset's declarations so a block with no preset + * selected still shows its preset. Its lower specificity yields to the kb-preset-- rules (a selected + * preset) and to a per-instance edit, so it only fills the gap. + * + * @since TBD + * + * @param array>}> $collected The active library's collected presets. + * + * @return string + */ + private function scoped_default( array $collected, bool $editor ): string { + $css = ''; + + foreach ( $collected as $block => $data ) { + $default = $data['default']; + + if ( $default === '' || ! isset( $data['presets'][ $default ] ) ) { + continue; + } + + $properties = $data['presets'][ $default ]; + $declarations = $this->slot_declarations( $block, $default, $properties ); + + if ( $declarations !== '' ) { + $css .= $data['selector'] . '{' . $declarations . '}'; + } + + $css .= $this->state_rules( $block, $default, $this->state_scope( $data['selector'], null ), $properties, $editor ); + } + + return $css; + } + + /** + * The scope a state rule is emitted under: the whole block-and-preset qualification wrapped in `:where()`, + * so it matches exactly as it would unwrapped while contributing no specificity of its own. + * + * Every other layer of this projection writes custom properties, whose specificity never competes with a + * block's own declarations. A state rule writes a real declaration, so it does — and the layering rule the + * whole projection rests on is that a preset yields to the block's own CSS. Left un-neutralized, the block + * class plus the preset class would put a state rule two classes above the state's own weight, which is + * more than most blocks spend on their per-instance rules; a preset's hover would then beat a hover the + * user set on the block itself. + * + * With the qualification weightless, a state rule weighs exactly what the binding's `css_state` names — + * which is where a block's author states the weight that block needs, the only place that knows what the + * block's own rules cost. That also leaves a named preset's rule and the `$default`'s at the SAME weight, + * which is why the `$default`'s is qualified by "this block has no preset class" rather than by nothing: + * the two must never both match, since neither could then outrank the other. + * + * @since TBD + * + * @param string $selector The block's `.wp-block-*` selector. + * @param string|null $preset The preset class selector (leading dot included) for a named preset, or + * null for the `$default`'s rule. + * + * @return string + */ + private function state_scope( string $selector, ?string $preset ): string { + $qualifier = $preset !== null + ? $selector . $preset + : $selector . ':not([class*="' . Style::get_class_prefix() . '"])'; + + return ':where(' . $qualifier . ')'; + } + + /** + * Build the `--global-:var();` declarations for one preset's properties. + * + * @since TBD + * + * @param string $block The block name. + * @param string $preset The preset slug. + * @param array $properties The preset's collected properties. + * + * @return string + */ + private function slot_declarations( string $block, string $preset, array $properties ): string { + $declarations = ''; + + foreach ( $properties as $property => $info ) { + // A state property has no variable of the block's own to retarget; it is emitted as its own rule + // by state_rules() instead. + if ( $info['target'] === null ) { + continue; + } + + $declarations .= $info['target'] . ':var(' . $this->preset_var( $block, $preset, (string) $property ) . ');'; + } + + return $declarations; + } + + /** + * Emit one preset's state rules for a block: per distinct state suffix, a + * "{:var();}" rule. + * + * The scope is the caller's — the preset-classed selector for a named preset, the bare block selector for + * the $default one — so the same specificity relationship the var-retarget layers have is preserved: a + * selected preset's state outranks the $default's, and the block's own per-instance state rule outranks + * both. + * + * Grouped by suffix so a block with several state properties on the same element emits one rule, matching + * how the block-default-CSS layer groups its own descendant rules. + * + * A `css_state` may name several states at once, comma separated (`*.kb-button:hover,*.kb-button:focus`), + * for the many blocks whose own CSS treats hover and keyboard focus as one look. Each part is scoped + * independently — the scope is repeated per part rather than distributed over the group — because a + * selector list only applies its leading compound to its FIRST part, so a naive concatenation would leave + * every part after the first matching the whole document. + * + * @since TBD + * + * @param string $block The block name. + * @param string $preset The preset slug, for the canonical var name. + * @param string $scope The selector the state suffix is appended to. + * @param array $properties The preset's collected properties. + * @param bool $editor Whether to use each binding's editor state suffix. + * + * @return string + */ + private function state_rules( string $block, string $preset, string $scope, array $properties, bool $editor ): string { + $by_suffix = []; + + foreach ( $properties as $property => $info ) { + if ( $info['prop'] === null ) { + continue; + } + + $suffixes = $this->state_suffixes( $editor ? $info['editor'] : $info['state'] ); + + // An empty suffix list would put the declaration on the block root with no state at all, which is + // the block-default layer's job and would repaint every instance. A state binding whose suffix + // sanitizes away contributes nothing rather than silently becoming a resting-state rule. + if ( $suffixes === [] ) { + continue; + } + + $by_suffix[ implode( ',', $suffixes ) ][] = $info['prop'] . ':var(' . $this->preset_var( $block, $preset, (string) $property ) . ')'; + } + + $css = ''; + + foreach ( $by_suffix as $suffix => $declarations ) { + $parts = array_map( + static function ( string $part ) use ( $scope ): string { + return $scope . $part; + }, + explode( ',', (string) $suffix ) + ); + + $css .= implode( ',', $parts ) . '{' . implode( ';', $declarations ) . ';}'; + } + + return $css; + } + + /** + * Split a binding's raw state selector into its individual, composed suffixes, dropping any part that + * sanitizes away to nothing. + * + * @since TBD + * + * @param string|null $state The binding's raw `css_state` / `editor_css_state`. + * + * @return string[] The composed suffixes, empty when the binding names no usable state. + */ + private function state_suffixes( ?string $state ): array { + $suffixes = []; + + foreach ( explode( ',', (string) $state ) as $part ) { + $suffix = $this->selector_suffix( $part ); + + if ( $suffix !== '' ) { + $suffixes[] = $suffix; + } + } + + return $suffixes; + } + + /** + * The CSS custom property a selected preset sets for a binding, or null when the binding drives none. + * + * A binding that targets a Kadence palette slot resolves to `--global-` (the color path); a binding + * that declares a `css_var` resolves to `--` (e.g. `--kb-btn-radius` for border-radius, which has + * no palette slot). The preset's scoped rule sets this property to the per-preset value, so it can vary + * per preset while the block reads the same variable. + * + * @since TBD + * + * @param Binding $binding The preset binding. + * + * @return string|null The full custom-property name (e.g. "--global-palette-btn-bg", "--kb-btn-radius"), or null. + */ + private function target_var( Binding $binding ): ?string { + $slot = $this->global_slot( $binding ); + + if ( $slot !== null ) { + return '--global-' . $slot; + } + + $css_var = $binding->css_var(); + + if ( $css_var !== null ) { + return '--' . $css_var; + } + + return null; + } + + /** + * The Kadence global custom-property slot a binding targets, or null when it targets none. + * + * Recognizes the numbered palette slots (palette1..9 → --global-paletteN) and the named button + * slots in {@see NAMED_GLOBAL_SLOTS} (e.g. palette-btn-bg → --global-palette-btn-bg). Reads the + * binding's effective projections so a token-reference binding inherits the referenced token's + * slot and an inline binding declares its own; both reach the same --global-. + * + * @since TBD + * + * @param Binding $binding The preset binding. + * + * @return string|null The slot ("palette3", "palette-btn-bg"), or null. + */ + private function global_slot( Binding $binding ): ?string { + $slot = $this->registry->effective_projections( $binding )[ Binding::get_kadence_slot_key() ] ?? null; + + if ( ! is_string( $slot ) ) { + return null; + } + + if ( preg_match( '/^palette[1-9]$/', $slot ) === 1 || in_array( $slot, self::NAMED_GLOBAL_SLOTS, true ) ) { + return $slot; + } + + return null; + } + + /** + * The block's CSS class selector: a Kadence (or any namespaced) block => ".wp-block--". + * + * @since TBD + * + * @param string $block The block name. + * + * @return string + */ + private function block_selector( string $block ): string { + $parts = explode( '/', $block, 2 ); + $namespace = $parts[0]; + $name = $parts[1] ?? $namespace; + + return '.wp-block-' . self::sanitize_identifier( $namespace ) . '-' . self::sanitize_identifier( $name ); + } + + /** + * Redeclare each preset var that varies by breakpoint inside that breakpoint's `@media` block. + * + * For a scalar property (any non-dimension property, or a dimension property overridden uniformly), + * the canonical var itself is redeclared, exactly as before — the scoped `--global-*` / `--kb-*` + * bridges are untouched, because they already point at the preset var, so overriding it inside the + * media query is enough for every consumer to follow. Mirrors the token projection's + * {@see \KadenceWP\KadenceBlocks\Design_Tokens\Projection\Css_Var\Css_Builder} responsive layer: same + * media wrapper, same :root scope, same "redeclare the same custom property" approach. + * + * For a per-slot dimension property, ONLY the touched slot vars are redeclared — never the + * composed var. A gap slot (the responsive-only `''` sentinel {@see Preset_Resolver} keeps in place) is + * skipped entirely, so that slot keeps inheriting live from whatever the composed var's `var()` chain + * currently resolves to outside this media query, rather than freezing it. The composed var itself picks + * up a touched slot's new value automatically: browsers re-evaluate a `var()` reference live, so + * redeclaring one slot var here changes what the (untouched, never-redeclared) composed var resolves + * to for elements matching this breakpoint. + * + * @since TBD + * + * @param string $active_slug The active library's slug. + * @param array>}> $collected The collected preset structure, for the block/preset list. + * @param array $breakpoints Breakpoint => media-query string. + * + * @return string + */ + private function responsive_blocks( string $active_slug, array $collected, array $breakpoints ): string { + if ( $collected === [] || $breakpoints === [] ) { + return ''; + } + + $by_breakpoint = []; + + foreach ( $collected as $block => $data ) { + foreach ( $data['presets'] as $preset => $properties ) { + try { + $responsive = $this->presets->resolve_responsive( $block, (string) $preset, $active_slug ); + } catch ( RuntimeException $e ) { + continue; // A preset that stopped resolving contributes no overrides, like the flat layer. + } + + foreach ( $responsive as $breakpoint => $overrides ) { + foreach ( $overrides as $property => $value ) { + // Only a property the flat layer emitted has a var to override; skip anything else so a + // media block can never introduce a var the base projection never defined. + if ( ! isset( $properties[ $property ] ) ) { + continue; + } + + $declaration = $this->responsive_declarations( + $block, + (string) $preset, + (string) $property, + $value, + $properties[ $property ]['dimension'] + ); + + // An all-gap per-slot override declares nothing; keeping it out avoids an empty @media block. + if ( $declaration === '' ) { + continue; + } + + $by_breakpoint[ $breakpoint ][] = $declaration; + } + } + } + } + + $css = ''; + + foreach ( $breakpoints as $breakpoint => $query ) { + if ( $query === '' || empty( $by_breakpoint[ $breakpoint ] ) ) { + continue; + } + + $css .= '@media all and ' . $query . '{' . Scope::root() . '{' . implode( '', $by_breakpoint[ $breakpoint ] ) . '}}'; + } + + return $css; + } + + /** + * A stable signature for a breakpoint map, so the cache key changes when the filtered media queries do. + * + * @since TBD + * + * @param array $breakpoints Breakpoint => media-query string. + * + * @return string + */ + private function breakpoint_signature( array $breakpoints ): string { + if ( $breakpoints === [] ) { + return 'none'; + } + + ksort( $breakpoints ); + + return md5( (string) wp_json_encode( $breakpoints ) ); + } + + /** + * The canonical preset var name for a (block, preset, property): + * "--kb-token--preset------", e.g. + * --kb-token--preset--kadence-singlebtn--secondary--button-bg. + * + * @since TBD + * + * @param string $block The block name. + * @param string $preset The preset slug. + * @param string $property The block property. + * + * @return string + */ + private function preset_var( string $block, string $preset, string $property ): string { + return Css_Var::get_prefix() + . self::PRESET_SEGMENT + . self::sanitize_identifier( str_replace( '/', '-', $block ) ) . '--' + . self::sanitize_identifier( $preset ) . '--' + . self::sanitize_identifier( $property ); + } +} diff --git a/includes/resources/Design_Tokens/Projection/Preset/Projector.php b/includes/resources/Design_Tokens/Projection/Preset/Projector.php new file mode 100644 index 0000000000..e03b51fb06 --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Preset/Projector.php @@ -0,0 +1,182 @@ +registry = $registry; + $this->store = $store; + $this->active = $active; + $this->css_builder = $css_builder; + } + + /** + * Append the preset CSS to the front-end global-variables handle. + * + * @since TBD + * + * @return void + */ + public function enqueue_front_end(): void { + if ( ! $this->registry->is_active() ) { + return; + } + + $css = $this->css(); + + if ( $css !== '' ) { + wp_add_inline_style( 'kadence-blocks-global-variables', $css ); + } + } + + /** + * Append the preset CSS to the editor global-styles handle. + * + * Shares the Css_Var projector's editor gate (the same page check and filter), so the preset CSS and + * the token vars load together in the editor or not at all. + * + * @since TBD + * + * @return void + */ + public function enqueue_editor(): void { + if ( ! $this->registry->is_active() ) { + return; + } + + /** This filter is documented in includes/resources/Design_Tokens/Projection/Css_Var/Projector.php */ + if ( ! apply_filters( 'kadence_blocks_load_editor_token_vars', Location::is_block_editor() ) ) { + return; + } + + $css = $this->editor_css(); + + if ( $css !== '' ) { + wp_add_inline_style( 'kadence-blocks-global-editor-styles', $css ); + } + } + + /** + * Build the preset CSS for the single active token library, via the builder's fragment cache. + * + * The active library's presets are emitted as canonical --kb-token--preset--* vars plus the coercive scoped + * rules. Returns an empty string when the store version cannot be read or a preset cannot be resolved + * (e.g. an alias cycle from a direct DB write that bypassed the REST gate), so the page never crashes — + * the inline style is simply omitted and KB falls back to its $default look. + * + * @since TBD + * + * @return string + */ + public function css(): string { + try { + $active = $this->active->get(); + $version = $this->store->get_version( $active ); + + return $this->css_builder->css_for_version( $active, $version, $this->breakpoints() ); + } catch ( Throwable $e ) { + return ''; + } + } + + /** + * Build the EDITOR-scoped preset CSS for the single active token library. + * + * Overrides the base's "editor output equals front-end output" default because one layer is markup-aware: + * a state rule (a binding declaring a `css_state`) carries a selector suffix, and a block whose editor renders the + * bound element under a different class declares an `editor_css_state` for it. Every other layer — the + * canonical `:root` vars and the block-root var retargets — is reused verbatim. + * + * Degrades the same way {@see self::css()} does: an unreadable store version or an unresolvable preset + * yields an empty string rather than an exception, so the editor loads without the inline style. + * + * @since TBD + * + * @return string + */ + public function editor_css(): string { + try { + $active = $this->active->get(); + $version = $this->store->get_version( $active ); + + return $this->css_builder->editor_css_for_version( $active, $version, $this->breakpoints() ); + } catch ( Throwable $e ) { + return ''; + } + } + + /** + * The breakpoint => media-query map for the per-breakpoint preset redeclarations, resolved at emit time + * so the filterable KB breakpoints are final. Keyed to match the resolver's breakpoint keys, and reading + * the same filters the token projection does, so a site that moves its breakpoints moves both together. + * + * @since TBD + * + * @return array + */ + private function breakpoints(): array { + return [ + /** This filter is documented in includes/class-kadence-blocks-css.php */ + Responsive::get_tablet_key() => (string) apply_filters( 'kadence_tablet_media_query', '(max-width: 1024px)' ), + /** This filter is documented in includes/class-kadence-blocks-css.php */ + Responsive::get_mobile_key() => (string) apply_filters( 'kadence_mobile_media_query', '(max-width: 767px)' ), + ]; + } +} diff --git a/includes/resources/Design_Tokens/Projection/Preset/Provider.php b/includes/resources/Design_Tokens/Projection/Preset/Provider.php new file mode 100644 index 0000000000..a22b3755f8 --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Preset/Provider.php @@ -0,0 +1,41 @@ +container->singleton( Css_Builder::class ); + $this->container->singleton( Projector::class ); + + // Contribute this projector's editor CSS to the combined projected-CSS endpoint. + /** @var Css_Projectors $projectors */ + $projectors = $this->container->get( Css_Projectors::class ); + /** @var Projector $projector */ + $projector = $this->container->get( Projector::class ); + $projectors->add( $projector ); + + // Front end: append after the token vars (KB enqueues the handle at 90; the Css_Var projector at 100), + // so a preset override always follows the base token vars in source order and wins by cascade. + add_action( 'wp_enqueue_scripts', $this->container->callback( Projector::class, 'enqueue_front_end' ), 110 ); + + // Editor: append at admin_init priority 10, after the editor-styles handle is registered and after the + // Css_Var projector (priority 5), so the preset CSS follows the token vars on the same handle. + add_action( 'admin_init', $this->container->callback( Projector::class, 'enqueue_editor' ), 10 ); + } +} diff --git a/includes/resources/Design_Tokens/Projection/Preset/Renders_Preset_Classes.php b/includes/resources/Design_Tokens/Projection/Preset/Renders_Preset_Classes.php new file mode 100644 index 0000000000..6e473a3bdc --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Preset/Renders_Preset_Classes.php @@ -0,0 +1,40 @@ +` shape the projector's scoped CSS targets and the editor's + * preview/save filters emit for the block's `kbPreset` selection. The shape itself has a single source, + * {@see Style::preset_class()}; this trait is only the "read the attribute, produce the list" seam so every + * block does it identically. + * + * @since TBD + */ +trait Renders_Preset_Classes { + + /** + * The `kb-preset--` class a block's `kbPreset` selection outputs, as a single-element list (or + * an empty list when nothing is selected). A non-string or empty selection yields nothing, so a block can + * pass the raw attribute straight through. + * + * @since TBD + * + * @param mixed $kb_preset The block's `kbPreset` attribute (the selected preset slug). + * + * @return string[] + */ + protected function preset_classes( $kb_preset ): array { + $preset = is_string( $kb_preset ) ? $kb_preset : ''; + + if ( $preset === '' ) { + return []; + } + + return [ Style::preset_class( $preset ) ]; + } +} diff --git a/includes/resources/Design_Tokens/Projection/Preset/Style.php b/includes/resources/Design_Tokens/Projection/Preset/Style.php new file mode 100644 index 0000000000..a7c4f7191e --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Preset/Style.php @@ -0,0 +1,55 @@ + "kb-preset--secondary". Mirrors the JS + * kbPresetClassName() sanitizer so the class always matches the selector the projected CSS targets. + * + * @since TBD + * + * @param string $preset The preset slug. + * + * @return string + */ + public static function preset_class( string $preset ): string { + return self::CLASS_PREFIX . self::sanitize_identifier( $preset ); + } + + /** + * The class prefix every selected preset shares, e.g. "kb-preset--". Read by the projector to build the + * "no preset selected" test its `$default` state rule is scoped by. + * + * @since TBD + * + * @return string + */ + public static function get_class_prefix(): string { + return self::CLASS_PREFIX; + } +} diff --git a/includes/resources/Design_Tokens/Projection/Provider.php b/includes/resources/Design_Tokens/Projection/Provider.php new file mode 100644 index 0000000000..eedc4860ae --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Provider.php @@ -0,0 +1,52 @@ +[] + */ + private const PROVIDERS = [ + Css_Var\Provider::class, + Block_Preset\Provider::class, + Kadence_Option\Provider::class, + Preset\Provider::class, + Palette\Provider::class, + Block_Default_Css\Provider::class, + Adapter\Provider::class, + ]; + + /** + * @inheritDoc + * + * @since TBD + */ + public function register(): void { + // The shared collection each CSS projector's provider adds itself to; bound before the sub-providers so + // they can add to it as they register. + $this->container->singleton( Css_Projectors::class ); + + foreach ( self::PROVIDERS as $provider ) { + $this->container->register( $provider ); + } + + // Aggregates every CSS projector's editor CSS (from the collection above) for the projected-CSS REST + // endpoint. Autowired — a new editor-CSS projector joins from its own provider, not here. + $this->container->singleton( Editor_Css::class ); + } +} diff --git a/includes/resources/Design_Tokens/Projection/Scope.php b/includes/resources/Design_Tokens/Projection/Scope.php new file mode 100644 index 0000000000..8fec5cdff2 --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Scope.php @@ -0,0 +1,36 @@ +`, `+`, `~`, `.`, `:`, `#`, `[`, `&`) is used + * verbatim, so child combinators (`> img`), compound selectors (`.is-style-rounded`) and state + * selectors (`:hover .kb-svg-icon-wrap`) stay expressible. A descendant whose own selector opens with + * one of those characters asks for the space with a leading `*`, which adds no specificity of its own. + * Empty when the binding names none — the rule targets the block root. + * + * A leading `&` is expanded rather than passed through. It reads naturally to anyone used to SCSS, but + * this emits flat CSS, where `.wp-block-example&:hover` is not a selector at all and the browser drops + * the whole rule — a binding written that way would silently do nothing. The SCSS meaning is honored: + * `&:hover` attaches and `& .child` descends, which is exactly the distinction the whitespace after the + * `&` already carries. + * + * @since TBD + * + * @param string|null $selector The binding's raw `css_selector` / `css_state`, or null when it names none. + * + * @return string The selector suffix, ready to concatenate after the block class. + */ + private function selector_suffix( ?string $selector ): string { + $selector = trim( (string) $selector ); + + if ( $selector === '' ) { + return ''; + } + + if ( $selector[0] === '&' ) { + $rest = substr( $selector, 1 ); + + // A space after the `&` is the whole signal: `& .child` descends, `&:hover` attaches. Tested + // before trimming, so the combinator this inserts is the only whitespace that survives. + $descends = $rest !== ltrim( $rest ); + $rest = trim( $rest ); + + if ( $rest === '' ) { + return ''; + } + + return $descends ? ' ' . $rest : $rest; + } + + return strpbrk( $selector[0], '>+~.:#[' ) === false ? ' ' . $selector : $selector; + } +} diff --git a/includes/resources/Design_Tokens/Projection/Traits/Converts_Number_To_Px.php b/includes/resources/Design_Tokens/Projection/Traits/Converts_Number_To_Px.php new file mode 100644 index 0000000000..8fd16c62b6 --- /dev/null +++ b/includes/resources/Design_Tokens/Projection/Traits/Converts_Number_To_Px.php @@ -0,0 +1,41 @@ +" and control + * characters). Not esc_attr(), which would mangle legitimate CSS such as the quotes/commas in a + * font-family stack. + * + * @since TBD + * + * @param string $value The raw CSS value. + * + * @return string + */ + private function sanitize_value( string $value ): string { + $value = preg_replace( '/[\x00-\x1F\x7F]/', '', $value ) ?? ''; + + return str_replace( [ '{', '}', ';', '<', '>' ], '', $value ); + } +} diff --git a/includes/resources/Design_Tokens/Registry/Baseline/Always_Present_Baseline_Document.php b/includes/resources/Design_Tokens/Registry/Baseline/Always_Present_Baseline_Document.php new file mode 100644 index 0000000000..99bd36efcd --- /dev/null +++ b/includes/resources/Design_Tokens/Registry/Baseline/Always_Present_Baseline_Document.php @@ -0,0 +1,41 @@ + + */ + public function document(): array { + return []; + } +} diff --git a/includes/resources/Design_Tokens/Registry/Baseline/Empty_Baseline_Document.php b/includes/resources/Design_Tokens/Registry/Baseline/Empty_Baseline_Document.php new file mode 100644 index 0000000000..7935e8fc85 --- /dev/null +++ b/includes/resources/Design_Tokens/Registry/Baseline/Empty_Baseline_Document.php @@ -0,0 +1,40 @@ + + */ + public function document(): array { + return []; + } +} diff --git a/includes/resources/Design_Tokens/Registry/Baseline/Json_Baseline_Document.php b/includes/resources/Design_Tokens/Registry/Baseline/Json_Baseline_Document.php new file mode 100644 index 0000000000..b5bc605189 --- /dev/null +++ b/includes/resources/Design_Tokens/Registry/Baseline/Json_Baseline_Document.php @@ -0,0 +1,217 @@ +|null + * + * @since TBD + */ + private ?array $document = null; + + /** + * Memoised id index for this request: token dot-path id => true. Null until first built. + * + * @var array|null + * + * @since TBD + */ + private ?array $index = null; + + /** + * @since TBD + * + * @param string $path Absolute path to the shipped baseline.json. + * @param string $version Cache-busting version (pass the plugin version); the document cache is keyed + * on it so a new shipped baseline.json invalidates the cache automatically. + */ + public function __construct( string $path, string $version ) { + $this->path = $path; + $this->version = $version; + } + + /** + * Whether the baseline defines a token at the given dot-path id. + * + * @since TBD + * + * @param string $id A token DTCG dot-path id, e.g. "semantic.color.button-bg". + * + * @return bool + */ + public function has( string $id ): bool { + return isset( $this->index()[ $id ] ); + } + + /** + * The full decoded baseline document, loaded once per request and cached across requests on the + * version. + * + * @since TBD + * + * @return array + */ + public function document(): array { + if ( $this->document !== null ) { + return $this->document; + } + + $key = 'baseline_document_' . $this->version; + $cached = wp_cache_get( $key, self::CACHE_GROUP, false, $found ); + + if ( $found && is_array( $cached ) ) { + return $this->document = $cached; + } + + $document = $this->load(); + + // Only cache a successful load. A real baseline is never empty, so an empty result means the file + // was missing/unreadable/malformed. Caching that would pin the failure to this version's cache + // (keeping projection disabled) until the next version bump — so skip it and let the next request + // recover. It is still memoised on the instance for the current request. + if ( $document !== [] ) { + wp_cache_set( $key, $document, self::CACHE_GROUP ); + } + + return $this->document = $document; + } + + /** + * The flattened id index has() consults: every token leaf's dot-path id. Derived from the (cached) + * document and memoised per request. + * + * @since TBD + * + * @return array + */ + private function index(): array { + if ( $this->index !== null ) { + return $this->index; + } + + $document = $this->document(); + $index = []; + + foreach ( Layers::token_layers() as $layer ) { + if ( isset( $document[ $layer ] ) && is_array( $document[ $layer ] ) ) { + $this->collect_leaves( $document[ $layer ], $layer, $index ); + } + } + + return $this->index = $index; + } + + /** + * Walk a DTCG subtree depth-first, recording the dot-path of every token leaf (a node with $value). + * + * @since TBD + * + * @param array $node The current group node. + * @param string $prefix The dot-path accumulated so far. + * @param array $index The index being built, passed by reference. + * + * @return void + */ + private function collect_leaves( array $node, string $prefix, array &$index ): void { + foreach ( $node as $key => $child ) { + // Skip DTCG metadata keys ($description, $extensions, …); only group/token nodes have ids. + if ( is_string( $key ) && strpos( $key, '$' ) === 0 ) { + continue; + } + + if ( ! is_array( $child ) ) { + continue; + } + + $path = $prefix === '' ? (string) $key : $prefix . '.' . $key; + + // A node carrying $value is a token leaf (composite values such as shadow/typography are + // leaves too); record it and do not descend into its value sub-fields. + if ( array_key_exists( '$value', $child ) ) { + $index[ $path ] = true; + + continue; + } + + $this->collect_leaves( $child, $path, $index ); + } + } + + /** + * Decode the shipped baseline.json into an array. A missing or malformed file yields an empty + * document, so every has() returns false and the fail-closed guard keeps token projection off + * rather than acting on a partial baseline. + * + * @since TBD + * + * @return array + */ + private function load(): array { + if ( ! is_readable( $this->path ) ) { + return []; + } + + $raw = file_get_contents( $this->path ); + + if ( $raw === false ) { + return []; + } + + $decoded = json_decode( $raw, true ); + + return is_array( $decoded ) ? $decoded : []; + } +} diff --git a/includes/resources/Design_Tokens/Registry/Baseline/baseline.json b/includes/resources/Design_Tokens/Registry/Baseline/baseline.json new file mode 100644 index 0000000000..f6bc6513f3 --- /dev/null +++ b/includes/resources/Design_Tokens/Registry/Baseline/baseline.json @@ -0,0 +1,816 @@ +{ + "$description": "Shipped, read-only baseline DTCG document for the Kadence Blocks Design Tokens module. Defines a value for every token, a curated pool of foundation presets, a $default block preset for each alpha block, and the Button lead preset bindings. The stored document (kb_design_tokens table) is sparse overrides layered on top of this baseline; this file is versioned with the plugin and is NEVER mutated at runtime.", + "primitive": { + "color": { + "brand": { + "primary": { + "$type": "color", + "$value": "#3182CE" + }, + "secondary": { + "$type": "color", + "$value": "#2B6CB0" + }, + "accent": { + "$type": "color", + "$value": "#ED8936" + }, + "button": { + "$type": "color", + "$value": "#3633e1" + }, + "button-hover": { + "$type": "color", + "$value": "#2f2ffc" + } + }, + "neutral": { + "0": { + "$type": "color", + "$value": "#ffffff" + }, + "50": { + "$type": "color", + "$value": "#F7FAFC" + }, + "100": { + "$type": "color", + "$value": "#EDF2F7" + }, + "200": { + "$type": "color", + "$value": "#E2E8F0" + }, + "300": { + "$type": "color", + "$value": "#CBD5E0" + }, + "500": { + "$type": "color", + "$value": "#718096" + }, + "600": { + "$type": "color", + "$value": "#4A5568" + }, + "700": { + "$type": "color", + "$value": "#2D3748" + }, + "900": { + "$type": "color", + "$value": "#1A202C" + } + }, + "notice": { + "success": { + "$type": "color", + "$value": "#38A169" + }, + "warning": { + "$type": "color", + "$value": "#DD6B20" + }, + "error": { + "$type": "color", + "$value": "#E53E3E" + }, + "info": { + "$type": "color", + "$value": "#3182CE" + } + }, + "transparent": { + "$type": "color", + "$value": "transparent" + } + }, + "dimension": { + "spacing": { + "xxs": { + "$type": "dimension", + "$value": "0.5rem" + }, + "xs": { + "$type": "dimension", + "$value": "1rem" + }, + "sm": { + "$type": "dimension", + "$value": "1.5rem" + }, + "md": { + "$type": "dimension", + "$value": "2rem" + }, + "lg": { + "$type": "dimension", + "$value": "3rem" + }, + "xl": { + "$type": "dimension", + "$value": "4rem" + }, + "xxl": { + "$type": "dimension", + "$value": "5rem" + }, + "3xl": { + "$type": "dimension", + "$value": "6.5rem" + }, + "4xl": { + "$type": "dimension", + "$value": "8rem" + }, + "5xl": { + "$type": "dimension", + "$value": "10rem" + } + }, + "gap": { + "none": { + "$type": "dimension", + "$value": "0rem" + }, + "xs": { + "$type": "dimension", + "$value": "0.5rem" + }, + "sm": { + "$type": "dimension", + "$value": "1rem" + }, + "md": { + "$type": "dimension", + "$value": "2rem" + }, + "lg": { + "$type": "dimension", + "$value": "4rem" + } + }, + "font-size": { + "sm": { + "$type": "dimension", + "$value": "0.9rem", + "$extensions": { + "com.kadence.designTokens": { + "clamp": { + "min": "0.8rem", + "preferred": "0.73rem + 0.217vw", + "max": "0.9rem" + } + } + } + }, + "md": { + "$type": "dimension", + "$value": "1.25rem", + "$extensions": { + "com.kadence.designTokens": { + "clamp": { + "min": "1.1rem", + "preferred": "0.995rem + 0.326vw", + "max": "1.25rem" + } + } + } + }, + "lg": { + "$type": "dimension", + "$value": "2rem", + "$extensions": { + "com.kadence.designTokens": { + "clamp": { + "min": "1.75rem", + "preferred": "1.576rem + 0.543vw", + "max": "2rem" + } + } + } + }, + "xl": { + "$type": "dimension", + "$value": "3rem", + "$extensions": { + "com.kadence.designTokens": { + "clamp": { + "min": "2.25rem", + "preferred": "1.728rem + 1.63vw", + "max": "3rem" + } + } + } + }, + "xxl": { + "$type": "dimension", + "$value": "4rem", + "$extensions": { + "com.kadence.designTokens": { + "clamp": { + "min": "2.5rem", + "preferred": "1.456rem + 3.26vw", + "max": "4rem" + } + } + } + }, + "xxxl": { + "$type": "dimension", + "$value": "6rem", + "$extensions": { + "com.kadence.designTokens": { + "clamp": { + "min": "2.75rem", + "preferred": "0.489rem + 7.065vw", + "max": "6rem" + } + } + } + } + }, + "radius": { + "xs": { + "$type": "dimension", + "$value": "0.125rem" + }, + "sm": { + "$type": "dimension", + "$value": "0.25rem" + }, + "md": { + "$type": "dimension", + "$value": "0.375rem" + }, + "lg": { + "$type": "dimension", + "$value": "0.5rem" + }, + "xl": { + "$type": "dimension", + "$value": "0.75rem" + }, + "2xl": { + "$type": "dimension", + "$value": "1rem" + }, + "3xl": { + "$type": "dimension", + "$value": "1.5rem" + }, + "full": { + "$type": "dimension", + "$value": "9999px" + } + }, + "border-width": { + "sm": { + "$type": "dimension", + "$value": "1px" + }, + "md": { + "$type": "dimension", + "$value": "2px" + }, + "lg": { + "$type": "dimension", + "$value": "4px" + } + }, + "icon-size": { + "sm": { + "$type": "dimension", + "$value": "1rem" + }, + "md": { + "$type": "dimension", + "$value": "1.5rem" + }, + "lg": { + "$type": "dimension", + "$value": "2.25rem" + } + } + }, + "fontSize": { + "xs": { + "$type": "dimension", + "$value": "0.64rem" + }, + "sm": { + "$type": "dimension", + "$value": "0.8rem" + }, + "md": { + "$type": "dimension", + "$value": "1rem" + }, + "lg": { + "$type": "dimension", + "$value": "1.25rem" + }, + "xl": { + "$type": "dimension", + "$value": "1.563rem" + }, + "2xl": { + "$type": "dimension", + "$value": "1.953rem" + }, + "3xl": { + "$type": "dimension", + "$value": "2.441rem" + } + }, + "shadow": { + "xs": { + "$type": "shadow", + "$value": { + "color": "#1717171f", + "offsetX": "0px", + "offsetY": "1px", + "blur": "2px", + "spread": "0px" + } + }, + "sm": { + "$type": "shadow", + "$value": { + "color": "#1717171f", + "offsetX": "0px", + "offsetY": "2px", + "blur": "4px", + "spread": "0px" + } + }, + "md": { + "$type": "shadow", + "$value": { + "color": "#1717171f", + "offsetX": "0px", + "offsetY": "2px", + "blur": "8px", + "spread": "0px" + } + } + } + }, + "semantic": { + "color": { + "text": { + "$type": "color", + "$value": "{primitive.color.neutral.900}" + }, + "text-muted": { + "$type": "color", + "$value": "{primitive.color.neutral.500}" + }, + "surface": { + "$type": "color", + "$value": "{primitive.color.neutral.0}" + }, + "surface-alt": { + "$type": "color", + "$value": "{primitive.color.neutral.50}" + }, + "border": { + "$type": "color", + "$value": "{primitive.color.neutral.200}" + }, + "border-hover": { + "$type": "color", + "$value": "{primitive.color.neutral.200}" + }, + "link": { + "$type": "color", + "$value": "{primitive.color.brand.primary}" + }, + "button-bg": { + "$type": "color", + "$value": "{primitive.color.brand.button}" + }, + "button-text": { + "$type": "color", + "$value": "{primitive.color.neutral.0}" + }, + "button-bg-hover": { + "$type": "color", + "$value": "{primitive.color.brand.button-hover}" + }, + "button-text-hover": { + "$type": "color", + "$value": "{primitive.color.neutral.0}" + }, + "icon": { + "$type": "color", + "$value": "{primitive.color.brand.primary}" + }, + "icon-hover": { + "$type": "color", + "$value": "{primitive.color.brand.primary}" + }, + "rowlayout-bg": { + "$type": "color", + "$value": "{primitive.color.transparent}" + }, + "column-bg": { + "$type": "color", + "$value": "{primitive.color.transparent}" + }, + "column-bg-hover": { + "$type": "color", + "$value": "{primitive.color.transparent}" + }, + "image-bg": { + "$type": "color", + "$value": "{primitive.color.transparent}" + }, + "heading-bg": { + "$type": "color", + "$value": "{primitive.color.transparent}" + } + }, + "spacing": { + "inline": { + "$type": "dimension", + "$value": "{primitive.dimension.spacing.md}" + }, + "block": { + "$type": "dimension", + "$value": "{primitive.dimension.spacing.lg}" + }, + "section": { + "$type": "dimension", + "$value": "{primitive.dimension.spacing.xl}" + }, + "media-padding": { + "$type": "dimension", + "$value": "0" + }, + "heading-padding": { + "$type": "dimension", + "$value": "0" + } + }, + "radius": { + "control": { + "$type": "dimension", + "$value": "0.1875rem" + }, + "media": { + "$type": "dimension", + "$value": "0" + }, + "rowlayout": { + "$type": "dimension", + "$value": "0" + }, + "column": { + "$type": "dimension", + "$value": "0" + }, + "column-hover": { + "$type": "dimension", + "$value": "0" + }, + "heading": { + "$type": "dimension", + "$value": "0" + } + }, + "border-width": { + "default": { + "$type": "dimension", + "$value": "{primitive.dimension.border-width.sm}" + }, + "default-hover": { + "$type": "dimension", + "$value": "{primitive.dimension.border-width.sm}" + } + }, + "border-style": { + "default": { + "$type": "borderStyle", + "$value": "none" + }, + "default-hover": { + "$type": "borderStyle", + "$value": "none" + } + }, + "icon-size": { + "default": { + "$type": "dimension", + "$value": "{primitive.dimension.icon-size.md}" + } + }, + "font-size": { + "control": { + "$type": "dimension", + "$value": "1.125rem", + "$extensions": { + "com.kadence.designTokens": { + "responsive": { + "tablet": "1.0625rem", + "mobile": "1rem" + } + } + } + }, + "heading": { + "$type": "dimension", + "$value": "2rem" + } + }, + "font-weight": { + "control": { + "$type": "fontWeight", + "$value": "normal" + }, + "heading": { + "$type": "fontWeight", + "$value": "400" + } + }, + "line-height": { + "control": { + "$type": "lineHeight", + "$value": "normal" + }, + "heading": { + "$type": "lineHeight", + "$value": "1.125" + } + }, + "font-style": { + "control": { + "$type": "fontStyle", + "$value": "normal" + } + }, + "text-transform": { + "control": { + "$type": "textTransform", + "$value": "none" + }, + "heading": { + "$type": "textTransform", + "$value": "none" + } + }, + "letter-spacing": { + "control": { + "$type": "dimension", + "$value": "0" + }, + "heading": { + "$type": "dimension", + "$value": "0" + } + }, + "shadow": { + "card": { + "$type": "shadow", + "$value": { + "color": "{primitive.color.neutral.900}", + "offsetX": "0px", + "offsetY": "2px", + "blur": "8px", + "spread": "0px" + } + }, + "media": { + "$type": "shadow", + "$value": { + "color": "{primitive.color.transparent}", + "offsetX": "0px", + "offsetY": "0px", + "blur": "0px", + "spread": "0px" + } + }, + "button": { + "$type": "shadow", + "$value": { + "color": "{primitive.color.transparent}", + "offsetX": "0px", + "offsetY": "0px", + "blur": "0px", + "spread": "0px" + } + }, + "button-hover": { + "$type": "shadow", + "$value": { + "color": "{primitive.color.transparent}", + "offsetX": "0px", + "offsetY": "0px", + "blur": "0px", + "spread": "0px" + } + } + } + }, + "$extensions": { + "com.kadence.designTokens": { + "foundationPresets": { + "typeScale": { + "$default": "majorThird", + "minorThird": { + "label": "Minor Third", + "tokens": { + "primitive.fontSize.xs": "0.694rem", + "primitive.fontSize.sm": "0.833rem", + "primitive.fontSize.md": "1rem", + "primitive.fontSize.lg": "1.2rem", + "primitive.fontSize.xl": "1.44rem", + "primitive.fontSize.2xl": "1.728rem", + "primitive.fontSize.3xl": "2.074rem" + } + }, + "majorThird": { + "label": "Major Third", + "tokens": { + "primitive.fontSize.xs": "0.64rem", + "primitive.fontSize.sm": "0.8rem", + "primitive.fontSize.md": "1rem", + "primitive.fontSize.lg": "1.25rem", + "primitive.fontSize.xl": "1.563rem", + "primitive.fontSize.2xl": "1.953rem", + "primitive.fontSize.3xl": "2.441rem" + } + }, + "perfectFourth": { + "label": "Perfect Fourth", + "tokens": { + "primitive.fontSize.xs": "0.563rem", + "primitive.fontSize.sm": "0.75rem", + "primitive.fontSize.md": "1rem", + "primitive.fontSize.lg": "1.333rem", + "primitive.fontSize.xl": "1.777rem", + "primitive.fontSize.2xl": "2.369rem", + "primitive.fontSize.3xl": "3.157rem" + } + }, + "goldenRatio": { + "label": "Golden Ratio", + "tokens": { + "primitive.fontSize.xs": "0.382rem", + "primitive.fontSize.sm": "0.618rem", + "primitive.fontSize.md": "1rem", + "primitive.fontSize.lg": "1.618rem", + "primitive.fontSize.xl": "2.618rem", + "primitive.fontSize.2xl": "4.236rem", + "primitive.fontSize.3xl": "6.854rem" + } + } + } + }, + "colorPalettes": { + "$default": "default", + "$current": "default", + "default": { + "label": "Default", + "groups": [ + { + "id": "accent", + "label": "Accent", + "swatches": [ + { "token": "primitive.color.brand.primary", "label": "Main 1", "$value": "#3182CE" }, + { "token": "primitive.color.brand.secondary", "label": "Main 2", "$value": "#2B6CB0" }, + { "token": "primitive.color.brand.accent", "label": "Main 3", "$value": "#ED8936" }, + { "token": "primitive.color.brand.button", "label": "Button", "$value": "#3633e1" }, + { "token": "primitive.color.brand.button-hover", "label": "Button Hover", "$value": "#2f2ffc" } + ] + }, + { + "id": "contrast", + "label": "Contrast", + "swatches": [ + { "token": "primitive.color.neutral.900", "label": "Strongest", "$value": "#1A202C" }, + { "token": "primitive.color.neutral.700", "label": "Strong", "$value": "#2D3748" }, + { "token": "primitive.color.neutral.500", "label": "Medium", "$value": "#718096" }, + { "token": "primitive.color.neutral.300", "label": "Subtle", "$value": "#CBD5E0" }, + { "token": "primitive.color.neutral.200", "label": "Border", "$value": "#E2E8F0" } + ] + }, + { + "id": "background", + "label": "Background", + "swatches": [ + { "token": "primitive.color.neutral.100", "label": "Strongest", "$value": "#EDF2F7" }, + { "token": "primitive.color.neutral.50", "label": "Strong", "$value": "#F7FAFC" }, + { "token": "primitive.color.neutral.0", "label": "Medium", "$value": "#ffffff" } + ] + }, + { + "id": "notices", + "label": "Notices and Feedback", + "swatches": [ + { "token": "primitive.color.notice.success", "label": "Success", "$value": "#38A169" }, + { "token": "primitive.color.notice.warning", "label": "Warning", "$value": "#DD6B20" }, + { "token": "primitive.color.notice.error", "label": "Error", "$value": "#E53E3E" }, + { "token": "primitive.color.notice.info", "label": "Info", "$value": "#3182CE" } + ] + } + ] + } + }, + "presets": { + "kadence/rowlayout": { + "$default": "default", + "default": { + "label": "Default", + "tokens": { + "background": "{semantic.color.rowlayout-bg}", + "borderRadius": "{semantic.radius.rowlayout}" + } + } + }, + "kadence/column": { + "$default": "default", + "default": { + "label": "Default", + "tokens": { + "background": "{semantic.color.column-bg}", + "borderRadius": "{semantic.radius.column}" + } + } + }, + "kadence/image": { + "$default": "default", + "default": { + "label": "Default", + "tokens": { + "background": "{semantic.color.image-bg}", + "border": "{semantic.color.border}", + "borderWidth": "{semantic.border-width.default}", + "borderRadius": "{semantic.radius.media}", + "shadow": "{semantic.shadow.media}", + "padding": "{semantic.spacing.media-padding}" + } + } + }, + "kadence/singlebtn": { + "$default": "default", + "default": { + "label": "Default", + "tokens": { + "button-bg": "{semantic.color.button-bg}", + "button-text": "{semantic.color.button-text}", + "button-bg-hover": "{semantic.color.button-bg-hover}", + "button-text-hover": "{semantic.color.button-text-hover}", + "button-radius": "{semantic.radius.control}", + "button-border-width": "{semantic.border-width.default}", + "button-border-style": "{semantic.border-style.default}", + "button-border-color": "{semantic.color.border}", + "button-padding": [ + "0.4em", + "1em", + "0.4em", + "1em" + ], + "button-margin": [ + "0", + "0", + "0", + "0" + ] + } + } + }, + "kadence/single-icon": { + "$default": "default", + "default": { + "label": "Default", + "tokens": { + "color": "{semantic.color.icon}", + "size": "{semantic.icon-size.default}" + } + } + }, + "kadence/advancedheading": { + "$default": "default", + "default": { + "label": "Default", + "tokens": { + "color": "{semantic.color.text}", + "background": "{semantic.color.heading-bg}", + "fontSize": "{semantic.font-size.heading}", + "fontHeight": "{semantic.line-height.heading}", + "fontWeight": "{semantic.font-weight.heading}", + "letterSpacing": "{semantic.letter-spacing.heading}", + "textTransform": "{semantic.text-transform.heading}", + "padding": "{semantic.spacing.heading-padding}", + "borderColor": "{semantic.color.border}", + "borderWidth": "{semantic.border-width.default}", + "borderRadius": "{semantic.radius.heading}", + "borderStyle": "{semantic.border-style.default}" + } + } + } + } + } + } +} diff --git a/includes/resources/Design_Tokens/Registry/Baseline_Guard.php b/includes/resources/Design_Tokens/Registry/Baseline_Guard.php new file mode 100644 index 0000000000..22232b0dbd --- /dev/null +++ b/includes/resources/Design_Tokens/Registry/Baseline_Guard.php @@ -0,0 +1,145 @@ +registry = $registry; + $this->baseline = $baseline; + $this->logger = $logger; + $this->throw_on_missing = $throw_on_missing; + } + + /** + * Run the guard: log, then either throw (debug) or fail closed (production) on missing entries. + * + * @since TBD + * + * @throws Missing_Baseline_Entry When WP_DEBUG is on and any declared token lacks a baseline entry. + * + * @return void + */ + public function run(): void { + // TODO (SOFT-3377): this walks every declared token against the baseline on each run — O(n) per + // request once it runs against the real baseline. Cache the result and recompute only when a token + // is added/updated/removed so the common (unchanged-registry) path stays cheap. + $missing = $this->registry->missing_from_baseline( $this->baseline ); + + if ( empty( $missing ) ) { + return; + } + + $message = sprintf( + 'Design tokens disabled: %d declared token(s) have no baseline entry: %s', + count( $missing ), + implode( ', ', $missing ) + ); + + // TODO (SOFT-3377): the guard moves off `init` and runs against the real baseline, so this would + // otherwise log once per front-end/admin/REST/AJAX/cron request on a misconfigured site. A missing + // baseline entry is a deterministic deploy-time error (identical every request), so throttle to + // once per process with a static flag before this stops being a no-op. + $this->logger->error( $message ); + + if ( $this->should_throw() ) { + throw new Missing_Baseline_Entry( $message ); + } + + // Production: fail closed but stay up. + $this->registry->deactivate(); + $this->register_admin_notice( $missing ); + } + + /** + * Whether to throw on a misconfiguration. Honours an injected override, else defers to WP_DEBUG — + * the seam lets tests exercise both branches without redefining the WP_DEBUG constant. + * + * @since TBD + * + * @return bool + */ + private function should_throw(): bool { + if ( $this->throw_on_missing !== null ) { + return $this->throw_on_missing; + } + + return defined( 'WP_DEBUG' ) && WP_DEBUG; + } + + /** + * Register the production admin notice explaining why token projection is disabled. + * + * @since TBD + * + * @param string[] $missing The token ids missing a baseline entry. + * + * @return void + */ + private function register_admin_notice( array $missing ): void { + add_action( + 'admin_notices', + static function () use ( $missing ): void { + // Only surface the misconfiguration to users who could act on it, and avoid leaking + // internal token ids to lower-privileged admin-area users. + if ( ! current_user_can( 'manage_options' ) ) { + return; + } + + printf( + '

%s

', + esc_html( + sprintf( + /* translators: %s: comma-separated token ids. */ + __( 'Kadence Blocks design tokens are disabled because these tokens have no baseline entry: %s', 'kadence-blocks' ), + implode( ', ', $missing ) + ) + ) + ); + } + ); + } +} diff --git a/includes/resources/Design_Tokens/Registry/Binding.php b/includes/resources/Design_Tokens/Registry/Binding.php new file mode 100644 index 0000000000..0711857b78 --- /dev/null +++ b/includes/resources/Design_Tokens/Registry/Binding.php @@ -0,0 +1,673 @@ + 'semantic.color.button-bg']`. The property reuses that + * registered token's projections, so a preset retargets the exact variable the base property + * already feeds and there is no duplicated projection to drift. + * - **Inline target** — `['kadence_slot' => 'palette3']` (and/or `block_attr`, `css_var`, `css_prop`, + * `css_selector`). For a property that is not (yet) a registered token, or to add a target the token + * does not carry. + * - **Both** — e.g. `['token' => 'semantic.color.button-bg', 'block_attr' => 'background']`. The + * inline targets supplement (and override) the referenced token's projections, which is how a + * token-backed property still declares the `block_attr` a block preset needs. + * + * {@see Token_Registry::effective_projections()} merges the two. The projection vocabulary is the same + * one tokens use, with three additions — `block_attr`, `css_prop`, and `css_selector`, which tokens + * never carry. + * + * A binding may also declare `control_attr`, `responsive_attrs` and `axis` — editor-only metadata kept out + * of the projected bindings. See {@see Binding::control_attr()}, {@see Binding::responsive_attrs()} and + * {@see Binding::axis()}. + * + * @since TBD + */ +final class Binding { + + /** + * Declaration key selecting the token-reference form. + * + * @since TBD + * + * @var string + */ + private const TOKEN = 'token'; + + /** + * Inline target: a Kadence palette slot (palette1..9) → `--global-paletteN`. + * + * @since TBD + * + * @var string + */ + private const KADENCE_SLOT = 'kadence_slot'; + + /** + * Inline target: a block attribute, so a block preset can seed an attribute default. + * + * @since TBD + * + * @var string + */ + private const BLOCK_ATTR = 'block_attr'; + + /** + * Inline target: a KB-owned CSS custom property this property drives, named without the leading `--` + * (e.g. "kb-btn-radius" → `--kb-btn-radius`). For a property with no Kadence palette slot or WordPress + * preset bucket (e.g. border-radius): the block reads `var(--, )`, and a selected + * preset sets `--` on its scope so the value can vary per preset. + * + * @since TBD + * + * @var string + */ + private const CSS_VAR = 'css_var'; + + /** + * Inline target: a CSS property the block renders as a raw literal (e.g. "border-radius"), so the + * block-default-CSS projector can emit a low-specificity block-scoped rule pointing it at the bound + * token's variable. Used for the dimension families KB gives no ownable variable for (radius, icon + * size); see that projector's Css_Builder for the full rationale. + * + * @since TBD + * + * @var string + */ + private const CSS_PROP = 'css_prop'; + + /** + * Inline target: a selector suffix appended after the block's `.wp-block-*` class for the `css_prop` + * rule, when the property is rendered on a descendant rather than the block root (e.g. `img` for an + * image). A bare selector is treated as a descendant — the projector inserts the combinator space, so + * no load-bearing leading space is needed; a value that opens with a combinator or attachment character + * (`>`, `+`, `~`, `.`, `:`, `#`, `[`, `&`) is used verbatim. Optional; the rule targets the block root + * when omitted. + * + * @since TBD + * + * @var string + */ + private const CSS_SELECTOR = 'css_selector'; + + /** + * Inline target: the selector suffix to use instead of `css_selector` when the block-default-CSS + * projector is building for the editor canvas, for a block whose editor markup renders the bound + * property on a DIFFERENT descendant than its saved markup does (the Section renders + * `.kadence-inner-column-inner` while `save.js` renders `.kt-inside-inner-col`). Without it the + * front-end suffix is reused in the editor, where it matches nothing, and the property silently keeps + * its editor look while the front end follows the token. + * + * This is the per-property counterpart to {@see Preset_Bindings::$editor_selector}, which swaps the + * block ROOT rather than the descendant suffix. The two compose, and neither substitutes for the + * other: a block whose editor root differs declares that one, a block whose editor descendant differs + * declares this one. Optional; `css_selector` is reused in the editor when omitted, which is the + * right answer for every block whose two render paths agree. + * + * @since TBD + * + * @var string + */ + private const EDITOR_CSS_SELECTOR = 'editor_css_selector'; + + /** + * Inline target: the selector suffix — pseudo-class included — that scopes this property to a UI state + * rather than to the block's resting appearance, e.g. `:hover > .kt-inside-inner-col` for the Section's + * hover background. Declaring it makes the binding a STATE binding, which changes which projector + * renders it and how. + * + * A state binding is rendered only by the selected-preset projector, which emits a real declaration + * (`: var()`) scoped to `.wp-block-.kb-preset--` — and, + * for the block's `$default` preset, to the class-less `.wp-block-`. The + * block-default-CSS projector skips it entirely: that layer renders only the `$default` preset, so its + * rule would be present on every block whether or not a preset asked for a state, and any `:hover` rule + * outranks the block's own resting per-instance rule — a shipped state default would repaint content + * that never opted in. + * + * The whole suffix lives here, pseudo included, because which element carries the state differs per + * block: the Section and the Icon are hovered on the block root and paint a descendant + * (`:hover > .kt-inside-inner-col`), while the Button is hovered on the element it paints + * (`*.kb-button:hover`). It is composed exactly like {@see self::CSS_SELECTOR} — a bare selector gains + * the combinator space, one opening with a combinator or attachment character is used verbatim, and a + * leading `*` is how a descendant whose own selector starts with `.` asks for the space. + * + * Several states may be named at once, comma separated (`*.kb-button:hover,*.kb-button:focus`), for a + * block whose own CSS treats hover and keyboard focus as one look. The projector scopes each part on its + * own, so every part is qualified by the block and preset rather than only the first. + * + * @since TBD + * + * @var string + */ + private const CSS_STATE = 'css_state'; + + /** + * Inline target: the state selector suffix to use instead of `css_state` when the preset projector is + * building for the editor canvas, for a block whose editor markup renders the bound property on a + * different element than its saved markup does (the Section paints `.kadence-inner-column-inner` in the + * editor and `.kt-inside-inner-col` on the front end). + * + * The per-state counterpart to {@see self::EDITOR_CSS_SELECTOR}, and it behaves the same way: optional, + * with `css_state` reused in the editor when omitted, which is right for every block whose two render + * paths agree on the element. + * + * @since TBD + * + * @var string + */ + private const EDITOR_CSS_STATE = 'editor_css_state'; + + /** + * Editor-only target: the block attribute the editor control for this property writes, so the + * indicator layer can tell whether a control is bound to the active preset or has been overridden. + * Deliberately NOT a projection target — it is excluded from STRING_TARGETS / inline_targets(), so it + * never enters $projections and effective_projections() never emits it. That is what keeps a bound but + * untouched attribute EMPTY (nothing is seeded), which the editor's "empty = bound" detection relies on. + * + * @since TBD + * + * @var string + */ + private const CONTROL_ATTR = 'control_attr'; + + /** + * Declaration key naming the per-breakpoint block attributes an editor control writes, keyed by + * breakpoint. Editor-only metadata, like CONTROL_ATTR. + * + * @since TBD + * + * @var string + */ + private const RESPONSIVE_ATTRS = 'responsive_attrs'; + + /** + * Editor-only metadata naming the axis of a composite control this property edits, for the case where + * several properties share ONE `control_attr` whose stored value is a nested per-side/per-axis shape + * rather than a flat scalar (the border controls: width, style and color all live inside a single + * `[{top: [color, style, size], ...}, unit]` attribute). + * + * The generic kind classification cannot tell those apart — a width property reads as "dimension" and + * both style and color read as "color" — so the editor would compare the nested value as if it were + * flat and never match. Declaring the axis tells the indicator layer which slot of the composite this + * property owns. Omitted for the overwhelming majority of bindings, whose `control_attr` holds the + * property's own value directly. + * + * @since TBD + * + * @var string + */ + private const AXIS = 'axis'; + + /** + * The inline string targets and their validation: each, when present, must be a non-empty string. + * + * @since TBD + * + * @var string[] + */ + private const STRING_TARGETS = [ self::KADENCE_SLOT, self::BLOCK_ATTR, self::CSS_PROP, self::CSS_SELECTOR, self::EDITOR_CSS_SELECTOR, self::CSS_STATE, self::EDITOR_CSS_STATE, self::CSS_VAR ]; + + /** + * The block property this binding drives, e.g. "button-bg". Carried for error messages and so a + * binding can travel without its map key. + * + * @since TBD + * + * @var string + */ + public string $property; + + /** + * The referenced token id for the token-reference form, or null for an inline binding. + * + * @since TBD + * + * @var string|null + */ + public ?string $token; + + /** + * Inline projection targets (target key => value); empty for the token-reference form. + * + * @since TBD + * + * @var array + */ + public array $projections; + + /** + * The block attribute the editor control for this property writes, or null when the binding declares + * none. Editor-only metadata; kept out of $projections on purpose so no projector seeds it. + * + * @since TBD + * + * @var string|null + */ + public ?string $control_attr; + + /** + * The per-breakpoint block attributes this binding's editor control writes, keyed by breakpoint + * ("tablet" => "tabletBorderRadius"). Empty when the binding declares none. + * + * @since TBD + * + * @var array + */ + public array $responsive_attrs; + + /** + * The axis of a composite control this property edits ("border-width", "border-style", + * "border-color"), or null when the binding's control attribute holds this property's value directly. + * Editor-only metadata; kept out of $projections like control_attr. + * + * @since TBD + * + * @var string|null + */ + public ?string $axis; + + /** + * @since TBD + * + * @param string $property The block property this binding drives. + * @param string|null $token Referenced token id, or null when inline. + * @param array $projections Inline projection targets, empty when a token reference. + * @param string|null $control_attr The editor control attribute, or null when none declared. + * @param array $responsive_attrs Breakpoint => attribute, empty when none declared. + * @param string|null $axis The composite-control axis, or null when none declared. + */ + private function __construct( string $property, ?string $token, array $projections, ?string $control_attr, array $responsive_attrs = [], ?string $axis = null ) { + $this->property = $property; + $this->token = $token; + $this->projections = $projections; + $this->control_attr = $control_attr; + $this->responsive_attrs = $responsive_attrs; + $this->axis = $axis; + } + + /** + * Build a binding from its declaration, validating the token-reference XOR inline-target contract. + * + * @since TBD + * + * @param string $property The block property (the binding map key). + * @param array $spec The binding declaration. + * + * @throws InvalidArgumentException When the binding is neither a valid token reference nor a valid + * inline target, or mixes the two. + * + * @return self + */ + public static function from_array( string $property, array $spec ): self { + $inline = self::inline_targets( $property, $spec ); + $token = null; + + if ( array_key_exists( self::TOKEN, $spec ) ) { + $token = $spec[ self::TOKEN ]; + + if ( ! is_string( $token ) || $token === '' ) { + throw new InvalidArgumentException( + sprintf( 'Binding "%s" token reference must be a non-empty token id.', $property ) + ); + } + } + + // A binding must say *something* — reference a token, declare an inline target, or both. The two + // compose: a token reference contributes the token's projections, and inline targets supplement + // or override them (e.g. add a block_attr a token never carries). See effective_projections(). + if ( $token === null && $inline === [] ) { + throw new InvalidArgumentException( + sprintf( 'Binding "%s" must reference a token and/or declare at least one inline target.', $property ) + ); + } + + return new self( + $property, + $token, + $inline, + self::control_attr_of( $property, $spec ), + self::responsive_attrs_of( $property, $spec ), + self::axis_of( $property, $spec ) + ); + } + + /** + * The projection key for the Kadence palette-slot target ("kadence_slot"), used to read a binding's + * slot out of its effective projections. + * + * @since TBD + * + * @return string + */ + public static function get_kadence_slot_key(): string { + return self::KADENCE_SLOT; + } + + /** + * Whether this binding reuses a registered token's projections rather than declaring inline targets. + * + * @since TBD + * + * @return bool + */ + public function is_token_ref(): bool { + return $this->token !== null; + } + + /** + * The block attribute this binding seeds, or null when it declares none. Used by the block-preset + * projector to map a resolved preset value onto a block's default attribute. Always an inline target + * — tokens never carry a `block_attr` — so it is read straight off this binding. + * + * @since TBD + * + * @return string|null + */ + public function block_attr(): ?string { + $attribute = $this->projections[ self::BLOCK_ATTR ] ?? null; + + return is_string( $attribute ) ? $attribute : null; + } + + /** + * The block attribute the editor control for this property writes, or null when the binding declares + * none. Editor-only: read by the preset catalog so the indicator layer can key an override signal to a + * control. Unlike block_attr(), this is NOT a projection target and never seeds an attribute default. + * + * @since TBD + * + * @return string|null + */ + public function control_attr(): ?string { + return $this->control_attr; + } + + /** + * The per-breakpoint block attributes this binding's editor control writes, keyed by breakpoint, or an + * empty map when it declares none. + * + * A block names these by a prefix convention ("borderRadius" => "tabletBorderRadius"), which is a + * naming rule rather than something safely derivable across blocks, so it is declared. Editor-only, + * like control_attr(): never a projection target. + * + * @since TBD + * + * @return array Breakpoint => attribute name. + */ + public function responsive_attrs(): array { + return $this->responsive_attrs; + } + + /** + * The axis of the composite control this property edits, or null when the binding's control attribute + * holds this property's value directly. + * + * Read by the preset catalog so the editor's indicator layer knows which slot of a nested per-axis + * attribute to compare, instead of keying that off a hardcoded list of property names. Editor-only, + * like control_attr(): never a projection target. + * + * @since TBD + * + * @return string|null + */ + public function axis(): ?string { + return $this->axis; + } + + /** + * The CSS property this binding feeds a block-scoped default rule for, or null when it declares none. + * Read by the block-default-CSS projector to emit `: var(--kb-token--*)` for a dimension the + * block renders as a literal. Always an inline target — tokens never carry a `css_prop` — so it is read + * straight off this binding. + * + * @since TBD + * + * @return string|null + */ + public function css_prop(): ?string { + $property = $this->projections[ self::CSS_PROP ] ?? null; + + return is_string( $property ) ? $property : null; + } + + /** + * The selector suffix for this binding's `css_prop` rule (e.g. " img"), or null when the property is + * rendered on the block root. Inline only. + * + * @since TBD + * + * @return string|null + */ + public function css_selector(): ?string { + $selector = $this->projections[ self::CSS_SELECTOR ] ?? null; + + return is_string( $selector ) ? $selector : null; + } + + /** + * The selector suffix for this binding's `css_prop` rule in the EDITOR canvas: the declared + * `editor_css_selector` when the block's editor markup renders the property on a different descendant + * than its saved markup, and otherwise {@see self::css_selector()}, which is the right answer whenever + * the two render paths agree. Inline only. + * + * @since TBD + * + * @return string|null + */ + public function editor_css_selector(): ?string { + $selector = $this->projections[ self::EDITOR_CSS_SELECTOR ] ?? null; + + return is_string( $selector ) ? $selector : $this->css_selector(); + } + + /** + * The state selector suffix this binding's declaration is scoped to (e.g. ":hover > .kt-inside-inner-col"), + * or null when the binding drives the block's resting appearance. Its presence is what marks a binding as + * a state binding — see {@see self::CSS_STATE} for what that changes. Inline only. + * + * @since TBD + * + * @return string|null + */ + public function css_state(): ?string { + $selector = $this->projections[ self::CSS_STATE ] ?? null; + + return is_string( $selector ) ? $selector : null; + } + + /** + * The state selector suffix for the EDITOR canvas: the declared `editor_css_state` when the block's + * editor markup paints a different element than its saved markup, and otherwise {@see self::css_state()}, + * which is right whenever the two render paths agree. Inline only. + * + * @since TBD + * + * @return string|null + */ + public function editor_css_state(): ?string { + $selector = $this->projections[ self::EDITOR_CSS_STATE ] ?? null; + + return is_string( $selector ) ? $selector : $this->css_state(); + } + + /** + * Whether this binding scopes its property to a UI state rather than to the block's resting appearance. + * True exactly when it declares a `css_state`. + * + * @since TBD + * + * @return bool + */ + public function is_state(): bool { + return $this->css_state() !== null; + } + + /** + * The KB-owned CSS custom property this binding drives (named without the leading `--`, e.g. + * "kb-btn-radius"), or null when it declares none. Read by the preset projector to set that variable on a + * selected preset's scope so the value can vary per preset. Inline only. + * + * @since TBD + * + * @return string|null + */ + public function css_var(): ?string { + $name = $this->projections[ self::CSS_VAR ] ?? null; + + return is_string( $name ) ? $name : null; + } + + /** + * Extract and validate the inline projection targets from a binding declaration. + * + * @since TBD + * + * @param string $property The block property, for error messages. + * @param array $spec The binding declaration. + * + * @throws InvalidArgumentException When a present target carries an invalid value. + * + * @return array The recognised inline targets only. + */ + private static function inline_targets( string $property, array $spec ): array { + $inline = []; + + foreach ( self::STRING_TARGETS as $key ) { + if ( ! array_key_exists( $key, $spec ) ) { + continue; + } + + if ( ! is_string( $spec[ $key ] ) || $spec[ $key ] === '' ) { + throw new InvalidArgumentException( + sprintf( 'Binding "%s" target "%s" must be a non-empty string.', $property, $key ) + ); + } + + $inline[ $key ] = $spec[ $key ]; + } + + return $inline; + } + + /** + * Parse a binding's `responsive_attrs` declaration into a breakpoint => attribute map. + * + * Breakpoint keys are checked against {@see Responsive::get_breakpoint_keys()} at registration, so a + * typo fails loudly here rather than silently never capturing that device. + * + * @since TBD + * + * @param string $property The property the binding is for, for error messages. + * @param array $spec The binding declaration. + * + * @throws InvalidArgumentException When the map, a key, or a value is malformed. + * + * @return array Breakpoint => attribute, empty when the declaration omits it. + */ + private static function responsive_attrs_of( string $property, array $spec ): array { + if ( ! array_key_exists( self::RESPONSIVE_ATTRS, $spec ) ) { + return []; + } + + $declared = $spec[ self::RESPONSIVE_ATTRS ]; + + if ( ! is_array( $declared ) ) { + throw new InvalidArgumentException( + sprintf( 'Binding "%s" target "%s" must be a breakpoint => attribute map.', $property, self::RESPONSIVE_ATTRS ) + ); + } + + $allowed = Responsive::get_breakpoint_keys(); + $out = []; + + foreach ( $declared as $breakpoint => $attribute ) { + if ( ! in_array( (string) $breakpoint, $allowed, true ) ) { + throw new InvalidArgumentException( + sprintf( + 'Binding "%s" declares unknown responsive breakpoint "%s"; expected one of: %s.', + $property, + (string) $breakpoint, + implode( ', ', $allowed ) + ) + ); + } + + if ( ! is_string( $attribute ) || $attribute === '' ) { + throw new InvalidArgumentException( + sprintf( 'Binding "%s" responsive attribute for "%s" must be a non-empty string.', $property, (string) $breakpoint ) + ); + } + + $out[ (string) $breakpoint ] = $attribute; + } + + return $out; + } + + /** + * Extract and validate the editor-only control attribute from a binding declaration. Kept separate from + * inline_targets() on purpose: control_attr is NOT a projection target, so it must never reach + * $projections (and hence effective_projections()). + * + * @since TBD + * + * @param string $property The block property, for error messages. + * @param array $spec The binding declaration. + * + * @throws InvalidArgumentException When the control attribute is present but not a non-empty string. + * + * @return string|null The control attribute, or null when the declaration omits it. + */ + private static function control_attr_of( string $property, array $spec ): ?string { + if ( ! array_key_exists( self::CONTROL_ATTR, $spec ) ) { + return null; + } + + $value = $spec[ self::CONTROL_ATTR ]; + + if ( ! is_string( $value ) || $value === '' ) { + throw new InvalidArgumentException( + sprintf( 'Binding "%s" target "%s" must be a non-empty string.', $property, self::CONTROL_ATTR ) + ); + } + + return $value; + } + + /** + * Read and validate the optional composite-control axis, which must be a non-empty string when present. + * + * @since TBD + * + * @param string $property The block property (for the error message). + * @param array $spec The binding declaration. + * + * @throws InvalidArgumentException When the declared axis is not a non-empty string. + * + * @return string|null The axis, or null when the binding declares none. + */ + private static function axis_of( string $property, array $spec ): ?string { + if ( ! array_key_exists( self::AXIS, $spec ) ) { + return null; + } + + $value = $spec[ self::AXIS ]; + + if ( ! is_string( $value ) || $value === '' ) { + throw new InvalidArgumentException( + sprintf( 'Binding "%s" target "%s" must be a non-empty string.', $property, self::AXIS ) + ); + } + + return $value; + } +} diff --git a/includes/resources/Design_Tokens/Registry/Contracts/Baseline_Document.php b/includes/resources/Design_Tokens/Registry/Contracts/Baseline_Document.php new file mode 100644 index 0000000000..db42fa3288 --- /dev/null +++ b/includes/resources/Design_Tokens/Registry/Contracts/Baseline_Document.php @@ -0,0 +1,39 @@ + + */ + public function document(): array; +} diff --git a/includes/resources/Design_Tokens/Registry/Css_Var.php b/includes/resources/Design_Tokens/Registry/Css_Var.php new file mode 100644 index 0000000000..77ba663291 --- /dev/null +++ b/includes/resources/Design_Tokens/Registry/Css_Var.php @@ -0,0 +1,64 @@ +` rules. Preset bindings with no `label` are a preset / + * default look with NO picker: it seeds block attributes / low-specificity CSS through + * {@see \KadenceWP\KadenceBlocks\Design_Tokens\Projection\Block_Preset\Projector} and + * {@see \KadenceWP\KadenceBlocks\Design_Tokens\Projection\Block_Default_Css\Css_Builder} instead. + * + * It deliberately holds NO preset names, default or values, and no per-preset labels: those are document + * data (`$extensions.com.kadence.designTokens.presets.` — the `$default`, the preset keys, and + * each preset's `tokens`), read through the Preset_Resolver. Keeping them out of the registry means a + * single source of truth for the preset list (so a user-added preset in the store is honored) and no + * drift between a declaration and the document. The `label` is the one exception — it names the editor + * picker CONTROL, not a preset, so it is structural editor config declared here. + * + * Bindings are keyed by property (e.g. "button-bg" => {@see Binding}); every preset shares them, since + * "the button's background" maps to the same output slot whichever preset is active — only the value + * changes. + * + * The optional `style_library` section is a second, unrelated piece of structural config: the Style + * Library admin page's per-block presentation metadata (today, the BLOCK PRESETS nav label). It is + * intentionally distinct from `label` — that names the picker CONTROL rendered inside the block + * inspector, not the block itself, so it is the wrong string to show as a nav entry. + * + * @since TBD + */ +final class Preset_Bindings { + + /** + * The coarse input kind for a length-valued property — the only kind a per-corner slot list is + * meaningful for. + * + * @since TBD + * + * @var string + */ + private const KIND_DIMENSION = 'dimension'; + + /** + * The coarse input kind for a color-valued property. + * + * @since TBD + * + * @var string + */ + private const KIND_COLOR = 'color'; + + /** + * The fallback kind for a property that classifies as neither a dimension nor a color. + * + * @since TBD + * + * @var string + */ + private const KIND_TEXT = 'text'; + + /** + * The coarse input kind for a shadow-valued property. + * + * @since TBD + * + * @var string + */ + private const KIND_SHADOW = 'shadow'; + + /** + * The block name, e.g. "kadence/singlebtn". + * + * @since TBD + * + * @var string + */ + public string $block; + + /** + * The block's bindable surface, keyed by property name — the union of properties any preset may + * control. Shared by every preset; a preset defines values for any subset of these. + * + * @since TBD + * + * @var array + */ + public array $bindings; + + /** + * The editor picker's control label (e.g. "Style"), or null for preset bindings that show no picker. + * Names the CONTROL, not a preset. + * + * @since TBD + * + * @var string|null + */ + public ?string $label; + + /** + * The selector the {@see \KadenceWP\KadenceBlocks\Design_Tokens\Projection\Block_Default_Css\Css_Builder} + * targets IN PLACE OF the block's `.wp-block-*` root when it builds the editor-scoped version of the + * block-default CSS, or null when the block root is the right target in the editor too (the common + * case). Needed only when the block's editor markup does not put `.wp-block-*` on the element the + * bindings are meant to style — e.g. a wrapper `
` around the real rendered element — so the + * front-end selector would land the rule on the wrong node in the editor canvas. + * + * @since TBD + * + * @var string|null + */ + public ?string $editor_selector; + + /** + * The Style Library admin page's per-block presentation metadata, or null when the declaration + * omits the optional "style_library" section. Keyed for forward compatibility rather than a bare + * scalar: today it carries only "label" (the block's BLOCK PRESETS nav label — never the picker + * control's `$label`, which names the inspector control, not the block); a later per-block + * settings-field schema is expected to add sibling keys here without a breaking change. + * + * @since TBD + * + * @var array{label?: string}|null + */ + public ?array $style_library; + + /** + * @since TBD + * + * @param string $block The block name. + * @param array $bindings The block's bindable surface, keyed by property. + * @param string|null $label The picker control label, or null for preset bindings with no picker. + * @param string|null $editor_selector The editor-only selector override, or null to reuse the + * front-end selector in the editor too. + * @param array{label?: string}|null $style_library The Style Library admin page's per-block presentation + * metadata, or null when the declaration omits it. + */ + private function __construct( string $block, array $bindings, ?string $label, ?string $editor_selector, ?array $style_library ) { + $this->block = $block; + $this->bindings = $bindings; + $this->label = $label; + $this->editor_selector = $editor_selector; + $this->style_library = $style_library; + } + + /** + * Build a preset bindings object from its declaration array. + * + * @since TBD + * + * @param array $declaration The declaration: "block", optional "bindings" (property => + * {@see Binding::from_array()}), optional "label" (the picker control + * label; omit for preset bindings with no picker), optional + * "editor_selector" (see {@see self::$editor_selector}), and optional + * "style_library" (see {@see self::$style_library}). Preset names, + * default and values are document data, not declared here. + * + * @throws InvalidArgumentException When "block" is missing or a binding is malformed. + * + * @return self + */ + public static function from_array( array $declaration ): self { + // Require a present, non-empty string. Avoid empty() so a legitimate "0" block name is not + // mistaken for a missing value, matching Token_Definition::from_array(). + if ( ! isset( $declaration['block'] ) || ! is_string( $declaration['block'] ) || $declaration['block'] === '' ) { + throw new InvalidArgumentException( 'Preset-bindings declaration is missing required string "block".' ); + } + + return new self( + $declaration['block'], + self::bindings( $declaration['block'], $declaration['bindings'] ?? [] ), + isset( $declaration['label'] ) && is_string( $declaration['label'] ) ? $declaration['label'] : null, + isset( $declaration['editor_selector'] ) && is_string( $declaration['editor_selector'] ) ? $declaration['editor_selector'] : null, + self::style_library( $declaration['style_library'] ?? null ) + ); + } + + /** + * The binding for a property, or null when the set declares none. + * + * @since TBD + * + * @param string $property The block property, e.g. "button-bg". + * + * @return Binding|null + */ + public function binding( string $property ): ?Binding { + return $this->bindings[ $property ] ?? null; + } + + /** + * Report binding ↔ value mismatches against the properties the document's presets actually set. + * + * Pass the union of value properties across the block's presets (see + * Preset_Resolver::value_properties()). "unbound" are valued properties with no binding — they + * cannot reach output and are the harmful case; "unvalued" are bindings no preset ever sets — dead + * wiring. Well-formed preset bindings report neither. + * + * @since TBD + * + * @param string[] $value_properties Properties set by the block's presets in the document. + * + * @return array{unbound: string[], unvalued: string[]} + */ + public function consistency( array $value_properties ): array { + $bound = array_keys( $this->bindings ); + + return [ + 'unbound' => array_values( array_diff( $value_properties, $bound ) ), + 'unvalued' => array_values( array_diff( $bound, $value_properties ) ), + ]; + } + + /** + * Structure-only serialization for the admin UI feed: the bound properties and, per + * property, the token reference and inline projection targets. Values, preset names and the default + * are NOT here — those are document data read through the Preset_Resolver. Mirrors + * {@see Token_Registry::to_ui_schema()}. + * + * @since TBD + * + * @return array{bindings: array}>} + */ + public function to_ui_schema(): array { + $bindings = []; + + foreach ( $this->bindings as $property => $binding ) { + $bindings[ $property ] = [ + 'token' => $binding->token, + 'projections' => $binding->projections, + ]; + } + + return [ 'bindings' => $bindings ]; + } + + /** + * The coarse input kind for a length-valued property, the one kind a per-corner slot list is valid + * for. Read by the REST write guard, which cannot compare against the constant directly. + * + * @since TBD + * + * @return string + */ + public static function get_kind_dimension(): string { + return self::KIND_DIMENSION; + } + + /** + * The coarse input kind for a shadow-valued property. Read by the editor's token-picker lookup, + * which cannot compare against the constant directly. + * + * @since TBD + * + * @return string + */ + public static function get_kind_shadow(): string { + return self::KIND_SHADOW; + } + + /** + * A coarse input kind for a bound property — "color", "dimension", "shadow" or "text" — so the editor's + * preset form can render the right control per property. Read from the referenced token's group segment + * when the binding is a token reference (e.g. `semantic.radius.media` => "dimension", + * `semantic.shadow.button` => "shadow"), otherwise inferred from the property name (e.g. `button-bg` => + * "color", `button-radius` => "dimension"). Falls back to "text". + * + * @since TBD + * + * @param string $property The bound property, e.g. "button-bg". + * + * @return string One of "color", "dimension", "shadow" or "text". + */ + public function kind( string $property ): string { + $binding = $this->binding( $property ); + + if ( $binding !== null && $binding->token !== null ) { + $segments = explode( '.', $binding->token ); + $group = self::classify( $segments[1] ?? '' ); + + if ( $group !== '' ) { + return $group; + } + } + + $by_name = self::classify( $property ); + + return $by_name !== '' ? $by_name : self::KIND_TEXT; + } + + /** + * The Style Library BLOCK PRESETS nav label declared for this block, or null when the + * declaration has no "style_library" section or leaves "label" empty. Distinct from + * {@see self::$label}, which names the picker CONTROL rather than the block. + * + * @since TBD + * + * @return string|null + */ + public function style_library_label(): ?string { + $label = $this->style_library['label'] ?? null; + + return is_string( $label ) && $label !== '' ? $label : null; + } + + /** + * Build the property => Binding map from a declaration's "bindings". + * + * @since TBD + * + * @param string $block The block name, for error messages. + * @param mixed $declared The declared "bindings" value. + * + * @throws InvalidArgumentException When "bindings" is not a map of property => spec, or a binding is + * malformed. + * + * @return array + */ + private static function bindings( string $block, $declared ): array { + if ( ! is_array( $declared ) ) { + throw new InvalidArgumentException( + sprintf( 'Preset-bindings declaration for "%s" must have "bindings" as a map of property => target.', $block ) + ); + } + + $bindings = []; + + foreach ( $declared as $property => $spec ) { + if ( ! is_string( $property ) || $property === '' || ! is_array( $spec ) ) { + throw new InvalidArgumentException( + sprintf( 'Preset-bindings declaration for "%s" has a malformed binding; each must be "property" => target array.', $block ) + ); + } + + $bindings[ $property ] = Binding::from_array( $property, $spec ); + } + + return $bindings; + } + + /** + * Parse the optional "style_library" declaration section: the Style Library admin page's + * per-block presentation metadata. Lenient like "label" and "editor_selector" — a missing or + * malformed section yields null rather than throwing, since it is optional and its absence must + * not block registration of the block's preset bindings. + * + * @since TBD + * + * @param mixed $declared The declared "style_library" value. + * + * @return array{label?: string}|null + */ + private static function style_library( $declared ): ?array { + if ( ! is_array( $declared ) ) { + return null; + } + + $section = []; + + if ( isset( $declared['label'] ) && is_string( $declared['label'] ) && $declared['label'] !== '' ) { + $section['label'] = $declared['label']; + } + + return $section; + } + + /** + * Classify a term (a token group segment or a property name) into a coarse input kind, or "" when it + * matches none of shadow, dimension or color. Shadow is checked first since it collides with neither of + * the other lists; dimension is checked before color so "borderRadius" resolves to "dimension" rather + * than matching the "border" color term. + * + * @since TBD + * + * @param string $term The term to classify. + * + * @return string "shadow", "dimension", "color" or "". + */ + private static function classify( string $term ): string { + $term = strtolower( $term ); + + if ( strpos( $term, 'shadow' ) !== false ) { + return self::KIND_SHADOW; + } + + foreach ( [ 'radius', 'width', 'gap', 'spacing', 'space', 'padding', 'margin', 'size', 'height', 'dimension' ] as $needle ) { + if ( strpos( $term, $needle ) !== false ) { + return self::KIND_DIMENSION; + } + } + + foreach ( [ 'color', 'bg', 'background', 'text', 'border', 'fill', 'stroke' ] as $needle ) { + if ( strpos( $term, $needle ) !== false ) { + return self::KIND_COLOR; + } + } + + return ''; + } +} diff --git a/includes/resources/Design_Tokens/Registry/Provider.php b/includes/resources/Design_Tokens/Registry/Provider.php new file mode 100644 index 0000000000..ccd5bd9eb3 --- /dev/null +++ b/includes/resources/Design_Tokens/Registry/Provider.php @@ -0,0 +1,125 @@ +container->singleton( Token_Registry::class, Token_Registry::class ); + + // Bind the baseline contract to the shipped, read-only DTCG document (baseline.json). Every + // declared token must now have a matching baseline entry or the guard fails closed. The version + // keys the decoded-document cache, so a baseline shipped with a new plugin build invalidates it. + $this->container->singleton( + Baseline_Document::class, + new Json_Baseline_Document( __DIR__ . '/Baseline/baseline.json', KADENCE_BLOCKS_VERSION ) + ); + + $this->load_helper(); + + // Declarations carry __() labels/groups, so they must not be evaluated before init or WordPress + // fires the _load_textdomain_just_in_time notice. register() runs on plugins_loaded, so defer the + // declaration load (and the guard that runs once tokens are in) to init. Early priority keeps the + // registry populated before any consumer (admin UI, projectors, resolver) reads it. + // + // The guard validates the registered tokens, so it must run after register_declarations. The + // later priority makes that ordering explicit rather than relying on same-priority insertion order. + // + // The guard is one-shot at init:1 — v1 is central-declarations-only, so tokens declared by + // third parties on a later hook (init:2+) skip baseline validation and is_active() is not + // re-checked. Re-validating late registrations is out of scope until the real baseline lands. + add_action( 'init', [ $this, 'register_declarations' ], 0 ); + add_action( 'init', [ $this, 'sync_user_primitives' ], 0 ); + add_action( 'init', [ $this, 'guard_baseline' ], 1 ); + add_action( Token_Store::changed_action(), [ $this, 'sync_user_primitives_on_change' ], 0 ); + } + + /** + * Define the public global helper. Always safe — it only declares functions; third-party callers + * use it on their own hooks once the kadence_blocks() accessor exists. + * + * @since TBD + * + * @return void + */ + private function load_helper(): void { + require_once __DIR__ . '/../functions.php'; + } + + /** + * The single declaration point — registers each declared token / preset bindings against the registry. + * + * Reads declarations.php as data and registers via the container. Hooked on init (priority 0) because + * declarations carry __() strings that must not resolve before the textdomain is available. + * + * @since TBD + * + * @return void + */ + public function register_declarations(): void { + /** @var Token_Registry $registry */ + $registry = $this->container->get( Token_Registry::class ); + $declarations = require __DIR__ . '/declarations.php'; + + foreach ( $declarations['tokens'] as $token ) { + $registry->register( $token ); + } + + foreach ( $declarations['preset_bindings'] as $declaration ) { + $registry->register_preset_bindings( $declaration ); + } + } + + /** + * @since TBD + * + * @return void + */ + public function sync_user_primitives(): void { + /** @var User_Primitive_Registrar $registrar */ + $registrar = $this->container->get( User_Primitive_Registrar::class ); + $registrar->sync(); + } + + /** + * Every stored library is synced regardless of which one changed or which one is active — the + * multi-library projection renders every library, so every library's user primitives must stay + * registered. + * + * @since TBD + * + * @return void + */ + public function sync_user_primitives_on_change(): void { + /** @var User_Primitive_Registrar $registrar */ + $registrar = $this->container->get( User_Primitive_Registrar::class ); + $registrar->sync(); + } + + /** + * @since TBD + * + * @return void + */ + public function guard_baseline(): void { + /** @var Baseline_Guard $guard */ + $guard = $this->container->get( Baseline_Guard::class ); + $guard->run(); + } +} diff --git a/includes/resources/Design_Tokens/Registry/Token_Definition.php b/includes/resources/Design_Tokens/Registry/Token_Definition.php new file mode 100644 index 0000000000..5bb8cab8f4 --- /dev/null +++ b/includes/resources/Design_Tokens/Registry/Token_Definition.php @@ -0,0 +1,277 @@ + e.g. [ 'kadence_slot' => 'palette1' ] + */ + public array $projections; + + /** + * Whether this token was created by a user (not shipped with the plugin). + * + * @since TBD + * + * @var bool + */ + private bool $user_created; + + /** + * @param string $id DTCG dot-path id. + * @param string $type DTCG $type. + * @param string $label Human-readable label. + * @param string $group UI grouping bucket. + * @param string $css_var Canonical (or overridden) CSS custom-property name. + * @param array $projections Projection targets keyed by projection id. + * @param bool $user_created Whether the token was created by a user. + * @param string $group_key Stable machine key for the group. + */ + private function __construct( + string $id, + string $type, + string $label, + string $group, + string $css_var, + array $projections, + bool $user_created = false, + string $group_key = '' + ) { + $this->id = $id; + $this->type = $type; + $this->label = $label; + $this->group = $group; + $this->css_var = $css_var; + $this->projections = $projections; + $this->user_created = $user_created; + $this->group_key = $group_key; + } + + /** + * Build a token definition from its declaration array. + * + * @since TBD + * + * @param array $definition The token declaration. + * + * @throws InvalidArgumentException When required keys are missing or an optional key is the wrong type. + * + * @return self + */ + public static function from_array( array $definition ): self { + $id = self::require_string( $definition['id'] ?? null, 'id' ); + $type = self::require_string( $definition['type'] ?? null, 'type' ); + $label = self::require_string( $definition['label'] ?? null, 'label' ); + + // Guard the id charset at declaration time: it feeds Css_Var::from_id() which only swaps "." for + // "--", so an id with a space, slash, or uppercase letter would silently yield an invalid CSS + // custom-property name. Segments must be lowercase kebab-case (e.g. primitive.dimension.border-width.sm). + if ( ! preg_match( '/^[a-z0-9]+([.-][a-z0-9]+)*$/', $id ) ) { + throw new InvalidArgumentException( + sprintf( 'Design token id "%s" must be a dot-path of lowercase alphanumeric segments separated by "." or "-".', $id ) + ); + } + + $group = self::optional_string( $definition['group'] ?? null, 'group' ); + $css_var = self::optional_string( $definition['css_var'] ?? null, 'css_var' ); + + $group_key = self::optional_string( $definition['group_key'] ?? null, 'group_key' ); + if ( $group_key !== null && $group_key !== '' && ! preg_match( '/^[a-z0-9]+(-[a-z0-9]+)*$/', $group_key ) ) { + throw new InvalidArgumentException( + sprintf( 'Design token declaration "group_key" "%s" must be a lowercase kebab-case key.', $group_key ) + ); + } + + // Type-checked here so a bad declaration raises the documented InvalidArgumentException rather than + // a raw TypeError from the constructor's typed param — this is a public helper. + $projections = $definition['projections'] ?? []; + if ( ! is_array( $projections ) ) { + throw new InvalidArgumentException( 'Design token declaration "projections" must be an array.' ); + } + + return new self( + $id, + $type, + $label, + $group ?? '', + // css_var override is rare; default is derived and impossible to drift from the id. + $css_var ?? Css_Var::from_id( $id ), + $projections, + false, + $group_key ?? '' + ); + } + + /** + * The only factory that produces a user-created definition. + * + * @since TBD + * + * @param string $id Canonical dot-path id. + * @param string $type DTCG $type. + * @param string $label Display label; derived from the terminal slug when empty. + * @param string $group Already-resolved, current-locale group label. Empty for ungrouped. + * @param string $group_key Stable machine key the group label was resolved from. Empty for ungrouped. + * + * @throws \InvalidArgumentException When the id fails the charset check. + * + * @return self + */ + public static function from_user_primitive( string $id, string $type, string $label = '', string $group = '', string $group_key = '' ): self { + if ( ! preg_match( '/^[a-z0-9]+([.-][a-z0-9]+)*$/', $id ) ) { + throw new InvalidArgumentException( + sprintf( 'Design token id "%s" must be a dot-path of lowercase alphanumeric segments.', $id ) + ); + } + + if ( $label === '' ) { + $segments = explode( '.', $id ); + $label = ucwords( str_replace( '-', ' ', (string) end( $segments ) ) ); + } + + return new self( $id, $type, $label, $group, Css_Var::from_id( $id ), [], true, $group_key ); + } + + /** + * Require a declaration value to be a present, non-empty string. + * + * Avoid empty() so a legitimate "0" string is not mistaken for a missing value. + * + * @since TBD + * + * @param mixed $value The raw declaration value. + * @param string $key The declaration key, used for the error message. + * + * @throws InvalidArgumentException When the value is missing or not a non-empty string. + * + * @return string + */ + private static function require_string( $value, string $key ): string { + if ( ! is_string( $value ) || $value === '' ) { + throw new InvalidArgumentException( + sprintf( 'Design token declaration is missing required string "%s".', $key ) + ); + } + + return $value; + } + + /** + * Type-check an optional declaration value: a string when present, otherwise null. + * + * Validated here so a bad declaration raises the documented InvalidArgumentException rather than a + * raw TypeError from the constructor's typed params — this is a public helper. + * + * @since TBD + * + * @param mixed $value The raw declaration value. + * @param string $key The declaration key, used for the error message. + * + * @throws InvalidArgumentException When the value is present but not a string. + * + * @return string|null + */ + private static function optional_string( $value, string $key ): ?string { + if ( $value !== null && ! is_string( $value ) ) { + throw new InvalidArgumentException( + sprintf( 'Design token declaration "%s" must be a string.', $key ) + ); + } + + return $value; + } + + /** + * Whether this token was created by a user rather than shipped with the plugin. + * + * @since TBD + * + * @return bool + */ + public function is_user_created(): bool { + return $this->user_created; + } + + /** + * Whether the token declares the given projection target. + * + * @since TBD + * + * @param string $projection A projection id, e.g. "kadence_slot". + * + * @return bool + */ + public function has_projection( string $projection ): bool { + return array_key_exists( $projection, $this->projections ); + } +} diff --git a/includes/resources/Design_Tokens/Registry/Token_Registry.php b/includes/resources/Design_Tokens/Registry/Token_Registry.php new file mode 100644 index 0000000000..26fc4f74fd --- /dev/null +++ b/includes/resources/Design_Tokens/Registry/Token_Registry.php @@ -0,0 +1,446 @@ + Keyed by token id, insertion-ordered. */ + private array $tokens = []; + + /** @var array The preset bindings a block accepts, keyed by block name. */ + private array $preset_bindings = []; + + /** @var array Keyed by block name. */ + private array $adapters = []; + + /** + * Whether token projection is active. Flipped off by the fail-closed guard so projectors and the + * UI surface fall back to existing KB behavior rather than projecting a partial/broken set. + * + * @var bool + */ + private bool $active = true; + + /** + * Register a user-created primitive. Throws when the id is already held by a non-user-created token. + * + * $group must already be resolved to its current-locale label — this method never calls + * group_label_for() itself; see User_Primitive_Registrar::register_entry(), the one caller with + * a logger to report an unresolvable $group_key. + * + * @since TBD + * + * @param string $id + * @param string $type + * @param string $label + * @param string $group Already-resolved, current-locale group label. Empty for ungrouped. + * @param string $group_key Stable machine key the group label was resolved from. Empty for ungrouped. + * + * @throws \RuntimeException When the id belongs to a system registration. + * + * @return void + */ + public function register_user_primitive( string $id, string $type, string $label = '', string $group = '', string $group_key = '' ): void { + if ( isset( $this->tokens[ $id ] ) && ! $this->tokens[ $id ]->is_user_created() ) { + throw new \RuntimeException( + sprintf( 'Cannot register user primitive "%s": id is already registered as a system token.', $id ) + ); + } + + $this->tokens[ $id ] = Token_Definition::from_user_primitive( $id, $type, $label, $group, $group_key ); + } + + /** + * Remove a user-created primitive. Only removes the entry when it is user-created. + * No-op when the id is absent or belongs to a system token. + * + * @since TBD + * + * @param string $id + * + * @return void + */ + public function deregister_user_primitive( string $id ): void { + if ( isset( $this->tokens[ $id ] ) && $this->tokens[ $id ]->is_user_created() ) { + unset( $this->tokens[ $id ] ); + } + } + + /** + * @since TBD + * + * @return string[] + */ + public function user_created_ids(): array { + return array_keys( + array_filter( + $this->tokens, + static fn( Token_Definition $t ): bool => $t->is_user_created() + ) + ); + } + + /** + * Register a single token from its declaration array. + * + * @since TBD + * + * @param array $definition See Token_Definition::from_array(). + * + * @return void + */ + public function register( array $definition ): void { + $token = Token_Definition::from_array( $definition ); + + $this->tokens[ $token->id ] = $token; + } + + /** + * Register a block's preset bindings — its bindable surface and picker label. One preset-bindings registration per + * block; a later registration for the same block replaces the earlier one. + * + * @since TBD + * + * @param array $declaration See Preset_Bindings::from_array(). + * + * @return void + */ + public function register_preset_bindings( array $declaration ): void { + $preset_bindings = Preset_Bindings::from_array( $declaration ); + + $this->preset_bindings[ $preset_bindings->block ] = $preset_bindings; + } + + /** + * Register a per-block adapter — a named transform keyed to the Kadence Blocks block type it adapts. + * At most one adapter per block; a later registration for the same block replaces the earlier one. + * + * @since TBD + * + * @param Adapter_Interface $adapter The adapter to register. + * + * @throws InvalidArgumentException When the adapter declares no block (an empty BLOCK const). + * + * @return void + */ + public function register_adapter( Adapter_Interface $adapter ): void { + $block = $adapter->get_block(); + + // A concrete adapter that forgets to override BLOCK would register under the empty key and silently + // never match, so its apply() would never run. Fail loudly so the misconfiguration surfaces. + if ( $block === '' ) { + throw new InvalidArgumentException( + sprintf( 'Adapter %s must override the BLOCK constant with the block type it adapts.', get_class( $adapter ) ) + ); + } + + $this->adapters[ $block ] = $adapter; + } + + // ---- Lookups consumed by projectors and the UI ------------------------------------------------ + + /** + * All registered tokens, keyed by id in insertion order. + * + * @since TBD + * + * @return array + */ + public function all(): array { + return $this->tokens; + } + + /** + * A single token by id, or null when it is not registered. + * + * @since TBD + * + * @param string $id The token id. + * + * @return Token_Definition|null + */ + public function get( string $id ): ?Token_Definition { + return $this->tokens[ $id ] ?? null; + } + + /** + * Whether a token is registered for the given id. + * + * @since TBD + * + * @param string $id The token id. + * + * @return bool + */ + public function has( string $id ): bool { + return isset( $this->tokens[ $id ] ); + } + + /** + * @since TBD + * + * @param string $type DTCG $type, e.g. "color". + * + * @return array + */ + public function by_type( string $type ): array { + return array_filter( + $this->tokens, + static function ( Token_Definition $t ) use ( $type ): bool { + return $t->type === $type; + } + ); + } + + /** + * Tokens that declare a given projection target, e.g. all tokens with a "kadence_slot" projection. + * + * @since TBD + * + * @param string $projection Projection id. + * + * @return array + */ + public function by_projection( string $projection ): array { + return array_filter( + $this->tokens, + static function ( Token_Definition $t ) use ( $projection ): bool { + return $t->has_projection( $projection ); + } + ); + } + + /** + * The preset bindings a block registers, or null when it registers none. Both the + * picker-driven and the preset (no-picker) projectors read this; distinguish the two by their + * `label` (picker-driven preset bindings declare one, no-picker preset bindings do not). + * + * @since TBD + * + * @param string $block The block name, e.g. "kadence/singlebtn". + * + * @return Preset_Bindings|null + */ + public function for_block( string $block ): ?Preset_Bindings { + return $this->preset_bindings[ $block ] ?? null; + } + + /** + * All registered preset bindings, keyed by block name, in registration order. The admin UI feed + * iterates this to render per-block preset editors; mirrors all() for tokens. + * + * @since TBD + * + * @return array + */ + public function all_preset_bindings(): array { + return $this->preset_bindings; + } + + /** + * The adapter registered for a Kadence Blocks block, or null when the block has none (the default — + * its CSS vars already carry the tokens). + * + * @since TBD + * + * @param string $block The Kadence Blocks block name, e.g. "kadence/advancedheading". + * + * @return Adapter_Interface|null + */ + public function adapter_for_block( string $block ): ?Adapter_Interface { + return $this->adapters[ $block ] ?? null; + } + + /** + * All registered adapters, keyed by Kadence Blocks block name. + * + * @since TBD + * + * @return array + */ + public function adapters(): array { + return $this->adapters; + } + + /** + * The block names that have registered preset bindings, in registration order. Projectors walk + * these to emit each block's preset output; the preset values themselves come from the document via + * the Preset_Resolver. + * + * @since TBD + * + * @return string[] + */ + public function preset_binding_blocks(): array { + return array_keys( $this->preset_bindings ); + } + + /** + * The effective projection targets for a binding: a token reference contributes the referenced + * token's projections (so a preset reuses the variable the base property already feeds), and the + * binding's inline targets are merged on top, supplementing or overriding them (e.g. adding a + * block_attr the token never carries). A reference to an unregistered token contributes nothing, so + * a stale reference fails soft (its projections are skipped) rather than fatal. + * + * @since TBD + * + * @param Binding $binding The binding to resolve. + * + * @return array Projection target key => value. + */ + public function effective_projections( Binding $binding ): array { + $base = []; + + if ( $binding->is_token_ref() ) { + $token = $this->get( (string) $binding->token ); + $base = $token !== null ? $token->projections : []; + } + + return array_merge( $base, $binding->projections ); + } + + /** + * Convenience: the canonical css-var for an id, honouring any override. + * + * @since TBD + * + * @param string $id The token id. + * + * @return string + */ + public function css_var_for( string $id ): string { + $token = $this->get( $id ); + + return $token !== null ? $token->css_var : Css_Var::from_id( $id ); + } + + /** + * The schema the admin React app consumes. A token registered in PHP appears in the + * UI with no JS change. Values are NOT included here — the resolver supplies current values + * separately; this is structure only. + * + * @since TBD + * + * @return array{groups: array>>} + */ + public function to_ui_schema(): array { + $groups = []; + + foreach ( $this->tokens as $token ) { + $groups[ $token->group ][] = [ + 'id' => $token->id, + 'type' => $token->type, + 'label' => $token->label, + 'cssVar' => $token->css_var, + 'projections' => $token->projections, + 'userCreated' => $token->is_user_created(), + ]; + } + + return [ 'groups' => $groups ]; + } + + /** + * The current-locale group label a stable group_key resolves to, or null when no declared token + * carries that key. A pure accessor: it scans the already-registered declarations for the key and + * returns their translated group verbatim — it never calls __() itself, because the key is a + * variable and a dynamic string passed to __() is invisible to WP's static string extraction and + * would never be translated. The key only ever selects among labels that already exist as literal + * __() calls in declarations.php. + * + * @since TBD + * + * @param string $group_key The stable machine key, e.g. "border-radius". + * + * @return string|null + */ + public function group_label_for( string $group_key ): ?string { + if ( $group_key === '' ) { + return null; + } + + foreach ( $this->tokens as $token ) { + if ( $token->group_key === $group_key ) { + return $token->group; + } + } + + return null; + } + + // ---- Fail-closed activation guard ------------------------------------------------------------- + + /** + * Whether token projection is currently active. + * + * @since TBD + * + * @return bool + */ + public function is_active(): bool { + return $this->active; + } + + /** + * Validate that every declared token has a baseline entry. See the fail-closed policy. + * + * @since TBD + * + * @param Baseline_Document $baseline The baseline to validate declared tokens against. + * + * @return string[] The ids missing from the baseline (empty when valid). + */ + public function missing_from_baseline( Baseline_Document $baseline ): array { + $missing = []; + + foreach ( $this->tokens as $id => $token ) { + if ( $token->is_user_created() ) { + continue; + } + + if ( ! $baseline->has( $id ) ) { + $missing[] = $id; + } + } + + return $missing; + } + + /** + * Disable projection (fail-closed degraded mode). + * + * @since TBD + * + * @return void + */ + public function deactivate(): void { + $this->active = false; + } + + /** + * Re-enable projection after a previous deactivate() call. + * + * @since TBD + * + * @return void + */ + public function activate(): void { + $this->active = true; + } +} diff --git a/includes/resources/Design_Tokens/Registry/User_Primitive_Registrar.php b/includes/resources/Design_Tokens/Registry/User_Primitive_Registrar.php new file mode 100644 index 0000000000..e0c3c01c51 --- /dev/null +++ b/includes/resources/Design_Tokens/Registry/User_Primitive_Registrar.php @@ -0,0 +1,205 @@ +store = $store; + $this->registry = $registry; + $this->index = $index; + $this->logger = $logger; + } + + /** + * Deregister all current user primitives, then re-register from every stored library's committed + * document. Safe to call both at boot and from the change-action subscriber. + * + * @since TBD + * + * @return void + */ + public function sync(): void { + foreach ( $this->registry->user_created_ids() as $id ) { + $this->registry->deregister_user_primitive( $id ); + } + + foreach ( $this->slugs() as $slug ) { + $document = $this->store->get_decoded_document( $slug ); + + if ( $document === [] ) { + continue; + } + + foreach ( $this->index->all( $document ) as $id => $entry ) { + $this->register_entry( $slug, $document, (string) $id, $entry ); + } + } + } + + /** + * Every stored library's slug, the default library first so it wins any cross-library id collision. + * + * @since TBD + * + * @return string[] + */ + private function slugs(): array { + $slugs = array_column( $this->store->list_stores(), 'slug' ); + $slugs = array_values( array_diff( $slugs, [ Token_Store::default_slug() ] ) ); + + array_unshift( $slugs, Token_Store::default_slug() ); + + return $slugs; + } + + /** + * @since TBD + * + * @param string $slug The token library slug the entry was read from. + * @param array $document + * @param string $id + * @param array{label?: string, group?: string}|mixed $entry + * + * @return void + */ + private function register_entry( string $slug, array $document, string $id, $entry ): void { + if ( ! is_array( $entry ) ) { + $this->logger->warning( sprintf( 'User primitive "%s" in library "%s": malformed envelope entry — skipped.', $id, $slug ) ); + + return; + } + + $existing = $this->registry->get( $id ); + + if ( $existing !== null && $existing->is_user_created() ) { + $this->logger->warning( sprintf( 'User primitive "%s" in library "%s": already registered by another token library — skipped.', $id, $slug ) ); + + return; + } + + $type = $this->type_from_tree( $document, $id ); + + if ( $type === null ) { + $this->logger->warning( sprintf( 'User primitive "%s" in library "%s": no matching tree leaf — half-present record, skipped.', $id, $slug ) ); + + return; + } + + if ( ! Token_Type::is_valid( $type ) ) { + $this->logger->warning( sprintf( 'User primitive "%s" in library "%s": unknown $type "%s" — skipped.', $id, $slug, $type ) ); + + return; + } + + $label = is_string( $entry['label'] ?? null ) ? $entry['label'] : ''; + + $group_key = is_string( $entry['group'] ?? null ) ? $entry['group'] : ''; + $group = ''; + + if ( $group_key !== '' ) { + $resolved = $this->registry->group_label_for( $group_key ); + + if ( $resolved === null ) { + // The declaration that owned this key is gone (a downgrade, a removed group) — fail soft to + // ungrouped rather than a fatal; the token still surfaces, just without a home screen. + $this->logger->warning( sprintf( 'User primitive "%s" in library "%s": group key "%s" no longer resolves — registering ungrouped.', $id, $slug, $group_key ) ); + $group_key = ''; + } else { + $group = $resolved; + } + } + + try { + $this->registry->register_user_primitive( $id, $type, $label, $group, $group_key ); + } catch ( \RuntimeException $e ) { + $this->logger->warning( sprintf( 'User primitive "%s" in library "%s": %s', $id, $slug, $e->getMessage() ) ); + } catch ( \InvalidArgumentException $e ) { // @phpstan-ignore-line -- Token_Definition::from_user_primitive() throws this; Token_Registry::register_user_primitive() does not re-declare it. + $this->logger->warning( sprintf( 'User primitive "%s" in library "%s": invalid id — %s', $id, $slug, $e->getMessage() ) ); + } + } + + /** + * @since TBD + * + * @param array $node The document root, walked segment by segment as $id is traversed. + * @param string $id + * + * @return string|null + */ + private function type_from_tree( array $node, string $id ): ?string { + foreach ( explode( '.', $id ) as $segment ) { + if ( ! is_array( $node ) || ! array_key_exists( $segment, $node ) ) { + return null; + } + + $node = $node[ $segment ]; + } + + if ( ! is_array( $node ) ) { + return null; + } + + $type = $node[ Token_Type::get_type_key() ] ?? null; + + return is_string( $type ) && $type !== '' ? $type : null; + } +} diff --git a/includes/resources/Design_Tokens/Registry/declarations.php b/includes/resources/Design_Tokens/Registry/declarations.php new file mode 100644 index 0000000000..bbed35a10c --- /dev/null +++ b/includes/resources/Design_Tokens/Registry/declarations.php @@ -0,0 +1,1193 @@ + __( 'None', 'kadence-blocks' ), + 'xxs' => __( '2X Small', 'kadence-blocks' ), + 'xs' => __( 'Extra Small', 'kadence-blocks' ), + 'sm' => __( 'Small', 'kadence-blocks' ), + 'md' => __( 'Medium', 'kadence-blocks' ), + 'lg' => __( 'Large', 'kadence-blocks' ), + 'xl' => __( 'Extra Large', 'kadence-blocks' ), + 'xxl' => __( '2X Large', 'kadence-blocks' ), + '2xl' => __( '2X Large', 'kadence-blocks' ), + 'xxxl' => __( '3X Large', 'kadence-blocks' ), + '3xl' => __( '3X Large', 'kadence-blocks' ), + '4xl' => __( '4X Large', 'kadence-blocks' ), + '5xl' => __( '5X Large', 'kadence-blocks' ), + 'full' => __( 'Full', 'kadence-blocks' ), +]; + +/** + * Resolves a scale-step slug to its display label. + * + * @since TBD + * + * @param string $slug The scale-step slug (e.g. "sm"). + * + * @return string The step's label, or the uppercase slug when the step is unlisted — see the note above + * on why that fallback is a safety net rather than a supported end state. + */ +$scale_step_label = static function ( string $slug ) use ( $scale_step_labels ): string { + return $scale_step_labels[ $slug ] ?? strtoupper( $slug ); +}; + +// The spacing/gap scale steps are primitives (the slug IS a scale step), each claiming the Kadence Blocks +// slug it backs (class-kadence-blocks-css.php): the Css_Var builder redefines --global-kb-spacing- / +// --global-kb-gap- as the primitive token, so a block already storing that slug follows it and a site +// owner can retune each step. Usage-specific intent (semantic.spacing.section/.block/.inline) aliases the +// scale and is where intent-based delivery points — mirroring how semantic.radius.media aliases the radius +// scale. Defaults match KB's own values, so registering them changes nothing until overridden. ss-auto is +// omitted: it resolves to "auto", not a length. +$spacing_slugs = [ 'xxs', 'xs', 'sm', 'md', 'lg', 'xl', 'xxl', '3xl', '4xl', '5xl' ]; +$gap_slugs = [ 'none', 'xs', 'sm', 'md', 'lg' ]; + +$spacing_tokens = array_map( + static function ( string $slug ) use ( $scale_step_label ): array { + return [ + 'id' => 'primitive.dimension.spacing.' . $slug, + 'type' => 'dimension', + 'label' => $scale_step_label( $slug ), + 'group' => __( 'Spacing', 'kadence-blocks' ), + 'group_key' => 'spacing', + 'projections' => [ 'kb_spacing_slot' => $slug ], + ]; + }, + $spacing_slugs +); + +$gap_tokens = array_map( + static function ( string $slug ) use ( $scale_step_label ): array { + return [ + 'id' => 'primitive.dimension.gap.' . $slug, + 'type' => 'dimension', + 'label' => $scale_step_label( $slug ), + 'group' => __( 'Gap', 'kadence-blocks' ), + 'projections' => [ 'kb_gap_slot' => $slug ], + ]; + }, + $gap_slugs +); + +// The border-radius scale steps are primitives the Style Library's Border Radius screen lists and +// edits directly (semantic.radius.* already carries the projections that deliver these into blocks, +// so the scale declares none of its own). +// The step list mirrors the shipped baseline exactly: the screen renders whatever this group holds, and +// a step declared without a baseline entry would trip Baseline_Guard. +$radius_slugs = [ 'xs', 'sm', 'md', 'lg', 'xl', '2xl', '3xl', 'full' ]; + +$radius_tokens = array_map( + static function ( string $slug ) use ( $scale_step_label ): array { + return [ + 'id' => 'primitive.dimension.radius.' . $slug, + 'type' => 'dimension', + 'label' => $scale_step_label( $slug ), + 'group' => __( 'Border Radius', 'kadence-blocks' ), + 'group_key' => 'radius', + ]; + }, + $radius_slugs +); + +// The border-width scale steps are primitives the Style Library's Border Width screen lists and +// edits directly (semantic.border-width.default already carries the projection that delivers the +// "sm" step into the image block, so the scale declares none of its own). +$border_width_slugs = [ 'sm', 'md', 'lg' ]; + +$border_width_tokens = array_map( + static function ( string $slug ) use ( $scale_step_label ): array { + return [ + 'id' => 'primitive.dimension.border-width.' . $slug, + 'type' => 'dimension', + 'label' => $scale_step_label( $slug ), + 'group' => __( 'Border Width', 'kadence-blocks' ), + 'group_key' => 'border-width', + ]; + }, + $border_width_slugs +); + +// The icon-size scale steps are primitives the Style Library's Icon Sizes screen lists and edits +// directly (semantic.icon-size.default already carries the projection that delivers the "md" step +// into the icon block and the button's icon size, so the scale declares none of its own). +$icon_size_slugs = [ 'sm', 'md', 'lg' ]; + +$icon_size_tokens = array_map( + static function ( string $slug ) use ( $scale_step_label ): array { + return [ + 'id' => 'primitive.dimension.icon-size.' . $slug, + 'type' => 'dimension', + 'label' => $scale_step_label( $slug ), + 'group' => __( 'Icon Sizes', 'kadence-blocks' ), + 'group_key' => 'icon-size', + ]; + }, + $icon_size_slugs +); + +// The shadow scale steps are primitives the Style Library's Shadow screen lists and edits +// directly; the shadow semantics (semantic.shadow.card / .media) keep their own curated values and +// declare no projections onto this scale, so re-pointing a semantic at one of these primitives is +// deliberately not done here — semantic.shadow.card's color is aliased to a palette primitive, and +// re-pointing would detach it. +$shadow_slugs = [ 'xs', 'sm', 'md' ]; + +$shadow_tokens = array_map( + static function ( string $slug ) use ( $scale_step_label ): array { + return [ + 'id' => 'primitive.shadow.' . $slug, + 'type' => 'shadow', + 'label' => $scale_step_label( $slug ), + 'group' => __( 'Shadow', 'kadence-blocks' ), + 'group_key' => 'shadow', + ]; + }, + $shadow_slugs +); + +// The fluid font-size scale steps are primitives (the slug IS a scale step), each holding the shipped +// clamp() value from includes/init.php and claiming the Kadence Blocks font-size slug it backs +// (class-kadence-blocks-css.php): the Css_Var builder redefines --global-kb-font-size- as the +// primitive token, so a block already storing that slug follows it — mirroring spacing/gap. Defaults match +// KB's own values, so registering them changes nothing until overridden. The button's per-instance default +// font size is a separate token, semantic.font-size.control -- not a scale step. +$font_size_slugs = [ 'sm', 'md', 'lg', 'xl', 'xxl', 'xxxl' ]; + +$font_size_primitive_tokens = array_map( + static function ( string $slug ) use ( $scale_step_label ): array { + return [ + 'id' => 'primitive.dimension.font-size.' . $slug, + 'type' => 'dimension', + 'label' => $scale_step_label( $slug ), + 'group' => __( 'Font Size', 'kadence-blocks' ), + 'group_key' => 'font-size', + 'projections' => [ 'kb_font_size_slot' => $slug ], + ]; + }, + $font_size_slugs +); + +/** + * The brand + neutral primitives ARE the site's global color palette: each claims a Kadence palette slot + * (palette1..9), so --global-paletteN follows the primitive and the legacy kadence_blocks_colors palette + * stays in sync. Values mirror Kadence's default palette (brand at 1-2, a dark→light neutral ramp at 3-9, + * white at 9), so activation changes nothing until a primitive is overridden. Semantic colors deliberately + * do NOT claim a slot — they deliver at the block level — so writing a semantic never re-skins the palette. + */ +$palette_slots = [ + 'primitive.color.brand.primary' => [ 'palette1', __( 'Brand Primary', 'kadence-blocks' ) ], + 'primitive.color.brand.secondary' => [ 'palette2', __( 'Brand Secondary', 'kadence-blocks' ) ], + 'primitive.color.neutral.900' => [ 'palette3', __( 'Neutral 900', 'kadence-blocks' ) ], + 'primitive.color.neutral.700' => [ 'palette4', __( 'Neutral 700', 'kadence-blocks' ) ], + 'primitive.color.neutral.600' => [ 'palette5', __( 'Neutral 600', 'kadence-blocks' ) ], + 'primitive.color.neutral.500' => [ 'palette6', __( 'Neutral 500', 'kadence-blocks' ) ], + 'primitive.color.neutral.100' => [ 'palette7', __( 'Neutral 100', 'kadence-blocks' ) ], + 'primitive.color.neutral.50' => [ 'palette8', __( 'Neutral 50', 'kadence-blocks' ) ], + 'primitive.color.neutral.0' => [ 'palette9', __( 'Neutral 0', 'kadence-blocks' ) ], +]; + +$palette_tokens = []; +foreach ( $palette_slots as $token_id => $slot_label ) { + $palette_tokens[] = [ + 'id' => $token_id, + 'type' => 'color', + 'label' => $slot_label[1], + 'group' => __( 'Palette', 'kadence-blocks' ), + 'projections' => [ + 'kadence_slot' => $slot_label[0], + ], + ]; +} + +/** + * Button color semantics (resting + hover). The Button preset map references these by value and they + * carry no projections of their own — the Kadence button reads them through the preset's retarget + * bindings below, so overriding one recolors the preset without touching the global palette. + */ +$button_color_labels = [ + 'button-bg' => __( 'Button Background', 'kadence-blocks' ), + 'button-text' => __( 'Button Text', 'kadence-blocks' ), + 'button-bg-hover' => __( 'Button Background (Hover)', 'kadence-blocks' ), + 'button-text-hover' => __( 'Button Text (Hover)', 'kadence-blocks' ), +]; + +$button_color_tokens = []; +foreach ( $button_color_labels as $suffix => $label ) { + $button_color_tokens[] = [ + 'id' => 'semantic.color.' . $suffix, + 'type' => 'color', + 'label' => $label, + 'group' => __( 'Brand', 'kadence-blocks' ), + ]; +} + +/** + * Notice / feedback color primitives (success/warning/error/info). Registered so Css_Var emits each + * --kb-token--primitive--color--notice--* variable and the color palette's "Notices and Feedback" group + * can name them. Like the semantic colors, they claim NO Kadence palette slot — they deliver at the block + * level and never re-skin the global palette. + */ +$notice_color_labels = [ + 'success' => __( 'Success', 'kadence-blocks' ), + 'warning' => __( 'Warning', 'kadence-blocks' ), + 'error' => __( 'Error', 'kadence-blocks' ), + 'info' => __( 'Info', 'kadence-blocks' ), +]; + +$notice_color_tokens = []; +foreach ( $notice_color_labels as $suffix => $label ) { + $notice_color_tokens[] = [ + 'id' => 'primitive.color.notice.' . $suffix, + 'type' => 'color', + 'label' => $label, + 'group' => __( 'Notices', 'kadence-blocks' ), + ]; +} + +/** + * Brand + neutral color primitives a color palette exposes as swatches but that claim NO Kadence palette + * slot: the accent brand color, the button resting/hover colors (the button reads these through its + * semantics), and the two lighter neutral ramp steps (border / subtle surface). Like the semantic and + * notice colors they deliver at the block level and never re-skin the --global-paletteN palette. Registered + * so the palette write guard accepts an edit to them — the palette groups name these tokens, and a full-field + * palette save submits every swatch it shows, so an unregistered one would reject the whole write. + */ +$palette_delivery_color_tokens = [ + [ + 'id' => 'primitive.color.brand.accent', + 'type' => 'color', + 'label' => __( 'Brand Accent', 'kadence-blocks' ), + 'group' => __( 'Brand', 'kadence-blocks' ), + ], + [ + 'id' => 'primitive.color.brand.button', + 'type' => 'color', + 'label' => __( 'Brand Button', 'kadence-blocks' ), + 'group' => __( 'Brand', 'kadence-blocks' ), + ], + [ + 'id' => 'primitive.color.brand.button-hover', + 'type' => 'color', + 'label' => __( 'Brand Button (Hover)', 'kadence-blocks' ), + 'group' => __( 'Brand', 'kadence-blocks' ), + ], + [ + 'id' => 'primitive.color.neutral.300', + 'type' => 'color', + 'label' => __( 'Neutral 300', 'kadence-blocks' ), + 'group' => __( 'Palette', 'kadence-blocks' ), + ], + [ + 'id' => 'primitive.color.neutral.200', + 'type' => 'color', + 'label' => __( 'Neutral 200', 'kadence-blocks' ), + 'group' => __( 'Palette', 'kadence-blocks' ), + ], +]; + +/** + * The state selector every Button hover binding is scoped by, on the FRONT END. + * + * `:focus` rides along with `:hover` because the button's own CSS treats the two as one look — every rule it + * writes for hover it writes for focus in the same breath — so a preset that reached only `:hover` would leave + * a keyboard user on a button that never picks up the preset's border, radius or shadow. + * + * The repeated class is the weight, and it is load-bearing rather than a flourish. Preset\Css_Builder wraps a + * state rule's block-and-preset qualification in `:where()`, so this selector is the rule's ENTIRE specificity, + * and it has to land between two rules the button already writes: + * + * - above `.kb-button:not(.kb-btn-global-inherit):hover` (three classes), the SCSS default that resets + * box-shadow on hover and would otherwise silence a preset's shadow; + * - below `.wp-block-kadence-advancedbtn .kb-btn.kb-button:hover` (four classes), the button's own + * per-instance hover, so a hover the user set on the block still wins. + * + * Four classes ties that second one, and the tie breaks on source order: the preset CSS rides an enqueued + * handle and the per-instance CSS is printed after it, so the button's own value wins. Four also clears the + * per-instance RESTING rule (three classes), which is the point — a preset that says what hover looks like + * should say it even for a button carrying its own resting radius. + * + * On the front end `.wp-block-kadence-singlebtn` and `.kb-button` are the SAME element (the block renders + * through get_block_wrapper_attributes()), so the classes compound rather than descend. + * + * @var string + */ +$button_hover_state = '.kb-button.kb-button.kb-button:hover,.kb-button.kb-button.kb-button:focus'; + +/** + * The same selector for the EDITOR canvas, where the button is a DESCENDANT: useBlockProps() puts + * `.wp-block-kadence-singlebtn` on a wrapper div and the button itself carries `.kt-button`. The leading `*` + * is how a suffix that would otherwise read as a compound asks for the descendant combinator. + * + * It spends one class less than its front-end twin because the editor spends one less on the rules it has to + * sit between: BackendStyles writes `.kb-single-btn- .kt-button-:hover` (three classes) where the + * front end writes four, and the editor SCSS has no hover reset to clear. Matching the front end's four would + * put a preset's hover ABOVE the block's own, so the canvas would disagree with the page it previews. + * + * @var string + */ +$button_hover_state_editor = '*.kt-button.kt-button:hover,*.kt-button.kt-button:focus'; + +return [ + 'tokens' => array_merge( + [ + [ + // Registered so Css_Var emits its --kb-token--semantic--radius--media variable; the block-default + // CSS projector points kadence/image's border-radius at that variable as a low-specificity default. + 'id' => 'semantic.radius.media', + 'type' => 'dimension', + 'label' => __( 'Media Radius', 'kadence-blocks' ), + 'group' => __( 'Brand', 'kadence-blocks' ), + ], + [ + /** + * Control radius (buttons, inputs). Registered so Css_Var emits + * --kb-token--semantic--radius--control; the button's own default border-radius rule references + * that variable directly (the button is never empty, so the low-specificity block-default CSS + * mechanism can't reach it). Resolves to the radius scale's "sm" step, which carries the + * button's long-standing 3px radius, so an existing site that never set a radius renders + * unchanged. A user's explicit radius still wins by specificity. + */ + 'id' => 'semantic.radius.control', + 'type' => 'dimension', + 'label' => __( 'Control Radius', 'kadence-blocks' ), + 'group' => __( 'Brand', 'kadence-blocks' ), + ], + [ + /** + * Default icon size. Registered so Css_Var emits --kb-token--semantic--icon-size--default; the + * button's --kb-button-icon-size default references it, so a button icon follows the token while + * an explicit per-button icon size still wins. + */ + 'id' => 'semantic.icon-size.default', + 'type' => 'dimension', + 'label' => __( 'Icon Size', 'kadence-blocks' ), + 'group' => __( 'Brand', 'kadence-blocks' ), + ], + [ + // Block-specific radius defaults, mirroring semantic.radius.media for the image. Each holds a literal + // 0 in baseline.json (resolves to 0), so a fresh Row Layout / Column stays square — KB's own default — + // while a site owner can round one block type by overriding its token. + 'id' => 'semantic.radius.rowlayout', + 'type' => 'dimension', + 'label' => __( 'Row Layout Radius', 'kadence-blocks' ), + 'group' => __( 'Layout', 'kadence-blocks' ), + ], + [ + 'id' => 'semantic.radius.column', + 'type' => 'dimension', + 'label' => __( 'Column Radius', 'kadence-blocks' ), + 'group' => __( 'Layout', 'kadence-blocks' ), + ], + [ + // The hover twin of the token above. A state binding needs a semantic of its own or a preset + // that set the resting radius would move the hover one with it; both ship resolving to the same + // value, so a column that never asked for a hover radius keeps the one it has. + 'id' => 'semantic.radius.column-hover', + 'type' => 'dimension', + 'label' => __( 'Column Radius (Hover)', 'kadence-blocks' ), + 'group' => __( 'Layout', 'kadence-blocks' ), + ], + [ + // Block-specific background defaults for the block-default CSS projector. Each aliases the + // transparent primitive (see baseline), so a fresh Row Layout / Column stays transparent — KB's + // own default — while a site owner can brand one block type's background by overriding its token, + // without touching the shared surface colors or the transparent primitive. Registered here only + // so Css_Var emits each --kb-token--* variable the low-specificity rule points at. + 'id' => 'semantic.color.rowlayout-bg', + 'type' => 'color', + 'label' => __( 'Row Layout Background', 'kadence-blocks' ), + 'group' => __( 'Layout', 'kadence-blocks' ), + ], + [ + 'id' => 'semantic.color.column-bg', + 'type' => 'color', + 'label' => __( 'Column Background', 'kadence-blocks' ), + 'group' => __( 'Layout', 'kadence-blocks' ), + ], + [ + // The hover twin of the token above; see semantic.radius.column-hover for why a state gets its + // own semantic rather than sharing the resting one. + 'id' => 'semantic.color.column-bg-hover', + 'type' => 'color', + 'label' => __( 'Column Background (Hover)', 'kadence-blocks' ), + 'group' => __( 'Layout', 'kadence-blocks' ), + ], + [ + 'id' => 'semantic.color.border', + 'type' => 'color', + 'label' => __( 'Border', 'kadence-blocks' ), + 'group' => __( 'Brand', 'kadence-blocks' ), + ], + [ + 'id' => 'semantic.color.border-hover', + 'type' => 'color', + 'label' => __( 'Border (Hover)', 'kadence-blocks' ), + 'group' => __( 'Brand', 'kadence-blocks' ), + ], + [ + // Image background default for the block-default CSS projector, mirroring rowlayout-bg/column-bg. + // Aliases the transparent primitive, so a fresh image stays transparent (KB's own default) until a + // site owner brands it. Registered so Css_Var emits --kb-token--semantic--color--image-bg. + 'id' => 'semantic.color.image-bg', + 'type' => 'color', + 'label' => __( 'Image Background', 'kadence-blocks' ), + 'group' => __( 'Media', 'kadence-blocks' ), + ], + [ + // Border width, shared with the brand border color. Registered so Css_Var emits + // --kb-token--semantic--border-width--default; the block-default CSS projector points the image's + // border-width at it. Resolves to 1px but stays invisible until a border style is set, so a fresh + // image is unchanged while a site owner can retune image border thickness by overriding the token. + 'id' => 'semantic.border-width.default', + 'type' => 'dimension', + 'label' => __( 'Border Width', 'kadence-blocks' ), + 'group' => __( 'Brand', 'kadence-blocks' ), + ], + [ + 'id' => 'semantic.border-width.default-hover', + 'type' => 'dimension', + 'label' => __( 'Border Width (Hover)', 'kadence-blocks' ), + 'group' => __( 'Brand', 'kadence-blocks' ), + ], + [ + // Image shadow default. Registered so Css_Var emits --kb-token--semantic--shadow--media; the + // block-default CSS projector points kadence/image's box-shadow at it. Resolves to an invisible + // (transparent, zero) shadow, matching KB's default (box shadow is off by default), while a site + // owner can give every image a shadow by overriding the token. + 'id' => 'semantic.shadow.media', + 'type' => 'shadow', + 'label' => __( 'Media Shadow', 'kadence-blocks' ), + 'group' => __( 'Brand', 'kadence-blocks' ), + ], + [ + // Image padding default. Registered so Css_Var emits --kb-token--semantic--spacing--media-padding; + // the block-default CSS projector points the image wrapper's padding at it. Resolves to 0 (KB's + // default) so a fresh image is unchanged; a site owner can add image padding by overriding it. + 'id' => 'semantic.spacing.media-padding', + 'type' => 'dimension', + 'label' => __( 'Media Padding', 'kadence-blocks' ), + 'group' => __( 'Media', 'kadence-blocks' ), + ], + [ + // Button shadow default for the block-default CSS projector, mirroring semantic.shadow.media. + // Registered so Css_Var emits --kb-token--semantic--shadow--button; the projector points + // kadence/singlebtn's box-shadow at it. Resolves to an invisible (transparent, zero) shadow, + // matching KB's default (a button carries no shadow until a preset or the user sets one). + 'id' => 'semantic.shadow.button', + 'type' => 'shadow', + 'label' => __( 'Button Shadow', 'kadence-blocks' ), + 'group' => __( 'Brand', 'kadence-blocks' ), + ], + [ + 'id' => 'semantic.shadow.button-hover', + 'type' => 'shadow', + 'label' => __( 'Button Shadow (Hover)', 'kadence-blocks' ), + 'group' => __( 'Brand', 'kadence-blocks' ), + ], + ], + $button_color_tokens, + $notice_color_tokens, + $palette_delivery_color_tokens, + $palette_tokens, + $spacing_tokens, + $gap_tokens, + $font_size_primitive_tokens, + $radius_tokens, + $border_width_tokens, + $icon_size_tokens, + $shadow_tokens + ), + /** + * Preset bindings for the Button block: that it accepts presets, plus the per-property bindings (a + * token reference where the property is already a registered token, an inline target otherwise). + * The preset NAMES, the default ($default) and the values all live in the baseline document under + * $extensions…presets.; this declares only the structural wiring. + */ + 'preset_bindings' => [ + [ + /** + * The preset lives on the child Single Button (each button in a group is skinned individually), + * not the advancedbtn container. Presets are a pure COLOR axis: they retarget the Kadence theme's + * button-specific palette vars (the exact custom properties the button's render path already + * consumes), so a preset composes with the block's existing "Button Inherit Styles" shape (Fill / + * Outline / Theme Base) instead of fighting it — Fill reads --global-palette-btn-bg / -btn for its + * background + text, Outline reads --global-palette-btn-bg for border + text, and both read the + * matching -hover slots on :hover/:focus, so one color preset skins every shape and state. Each + * binding names only the slot it retargets; the per-preset VALUE comes from the preset's token + * map (which references the button-color semantics), so every preset is shaped the same way and + * each is overridable on its own semantic. Picking a preset re-skins a button with + * zero changes to its render path; a fresh button follows the $default. + */ + 'block' => 'kadence/singlebtn', + 'label' => __( 'Style', 'kadence-blocks' ), // a picker-driven set; this is the editor control's label. + 'style_library' => [ + // The Style Library BLOCK PRESETS nav label — distinct from "label" above, which names the + // inspector's picker control, not the block. + 'label' => __( 'Button', 'kadence-blocks' ), + ], + 'bindings' => [ + 'button-bg' => [ + 'kadence_slot' => 'palette-btn-bg', + 'control_attr' => 'background', + ], + 'button-text' => [ + 'kadence_slot' => 'palette-btn', + 'control_attr' => 'color', + ], + 'button-bg-hover' => [ + 'kadence_slot' => 'palette-btn-bg-hover', + 'control_attr' => 'backgroundHover', + ], + 'button-text-hover' => [ + 'kadence_slot' => 'palette-btn-hover', + 'control_attr' => 'colorHover', + ], + 'button-radius' => [ + 'css_var' => 'kb-btn-radius', // drives --kb-btn-radius so a preset can vary the radius. + 'control_attr' => 'borderRadius', + // The block names its per-device radius attributes by a prefix convention, which is a naming + // rule rather than something safely derivable, so the editor is told them rather than + // guessing. Lets a captured preset carry a different radius per breakpoint. + 'responsive_attrs' => [ + 'tablet' => 'tabletBorderRadius', + 'mobile' => 'mobileBorderRadius', + ], + ], + // Padding and margin carry no preset value by default, and that omission is the point: a + // button's spacing comes from its size class today, so shipping a value here would restyle + // every existing button and take padding away from the Button Size control. The binding + // exists so a preset CAN set them; until one does, the property resolves to nothing and no + // declaration is emitted. + 'button-padding' => [ + 'css_var' => 'kb-btn-padding', + 'control_attr' => 'padding', + 'responsive_attrs' => [ + 'tablet' => 'tabletPadding', + 'mobile' => 'mobilePadding', + ], + ], + 'button-margin' => [ + 'css_var' => 'kb-btn-margin', + 'control_attr' => 'margin', + 'responsive_attrs' => [ + 'tablet' => 'tabletMargin', + 'mobile' => 'mobileMargin', + ], + ], + // Border and shadow reuse the brand-wide tokens (and, for shadow, a button-scoped one), + // mirroring button-padding/button-margin/button-radius's css_var shape above rather than a + // css_prop shape: a css_prop binding only ever reaches Block_Default_Css\Css_Builder, which + // resolves exclusively the block's $default preset and can never reflect a *selected* + // preset's value. css_var is what lets Preset\Css_Builder (the named-preset projector) emit a + // scoped variable a selected preset can actually vary. + // + // The three border properties below share ONE control_attr ('borderStyle'), unlike padding/ + // margin/radius's one-property-per-attribute shape: the native block attribute + // ([{top:[color,style,size],...},unit]) is a single nested per-side/per-axis shape that + // EditorBorderControl edits as one control with no per-axis reset, so width/style/color all + // point at the same attribute rather than three that don't exist. Each declares the 'axis' it + // owns within that nested value, because the generic kind classification cannot tell them + // apart — width reads as a plain dimension and both style and color read as a plain color, so + // the editor would compare the nested shape as a flat one and never match. token-indicators + // reads the declared axis and combines the three into one bound/overridden state entry. + 'button-border-width' => [ + 'token' => 'semantic.border-width.default', + 'css_var' => 'kb-btn-border-width', + 'control_attr' => 'borderStyle', + 'axis' => 'border-width', + ], + 'button-border-style' => [ + 'token' => 'semantic.border-style.default', + 'css_var' => 'kb-btn-border-style', + 'control_attr' => 'borderStyle', + 'axis' => 'border-style', + ], + 'button-border-color' => [ + 'token' => 'semantic.color.border', + 'css_var' => 'kb-btn-border-color', + 'control_attr' => 'borderStyle', + 'axis' => 'border-color', + ], + // No baseline default: an unstyled button carries no shadow, so the preset's $default omits + // this property entirely and the projector emits no box-shadow rule until a preset (or the + // user) sets one. + 'button-shadow' => [ + 'token' => 'semantic.shadow.button', + 'css_var' => 'kb-btn-shadow', + ], + + // The hover half of the same four properties. These take the css_state shape rather than the + // css_var shape their resting counterparts use, because a state has no variable of the block's + // own to point at: the button reads --kb-btn-radius and friends in its resting rules only and + // paints its hover look straight from its own attributes, so there is nothing for a preset to + // redirect. Preset\Css_Builder supplies the whole rule instead, and only for a preset that + // actually sets the property, so a button whose preset carries no hover keeps the hover it has. + // + // $button_hover_state / $button_hover_state_editor carry the selectors; the weight they spend is + // load-bearing, and the note above them says what it buys. + 'button-radius-hover' => [ + 'css_prop' => 'border-radius', + 'css_state' => $button_hover_state, + 'editor_css_state' => $button_hover_state_editor, + 'control_attr' => 'borderHoverRadius', + 'responsive_attrs' => [ + 'tablet' => 'tabletBorderHoverRadius', + 'mobile' => 'mobileBorderHoverRadius', + ], + ], + + // The hover border trio mirrors the resting one: three properties sharing ONE control_attr + // ('borderHoverStyle'), each declaring the axis it owns within that nested value. The KEY shape + // is what the Style Library's Border field derives its three paths from — it appends + // `-width`/`-style`/`-color` to its own path — so these read `button-border-hover-*` rather than + // the `button-border-*-hover` the resting trio's names would suggest. + 'button-border-hover-width' => [ + 'token' => 'semantic.border-width.default-hover', + 'css_prop' => 'border-width', + 'css_state' => $button_hover_state, + 'editor_css_state' => $button_hover_state_editor, + 'control_attr' => 'borderHoverStyle', + 'axis' => 'border-width', + ], + 'button-border-hover-style' => [ + 'token' => 'semantic.border-style.default-hover', + 'css_prop' => 'border-style', + 'css_state' => $button_hover_state, + 'editor_css_state' => $button_hover_state_editor, + 'control_attr' => 'borderHoverStyle', + 'axis' => 'border-style', + ], + 'button-border-hover-color' => [ + 'token' => 'semantic.color.border-hover', + 'css_prop' => 'border-color', + 'css_state' => $button_hover_state, + 'editor_css_state' => $button_hover_state_editor, + 'control_attr' => 'borderHoverStyle', + 'axis' => 'border-color', + ], + + // No control_attr, matching button-shadow: the block's shadow control carries no indicator, and + // giving the hover one an attribute its resting twin does not have would make the pair read + // inconsistently in the inspector. + 'button-shadow-hover' => [ + 'token' => 'semantic.shadow.button-hover', + 'css_prop' => 'box-shadow', + 'css_state' => $button_hover_state, + 'editor_css_state' => $button_hover_state_editor, + ], + ], + ], + [ + // Image color/border/shadow/radius: low-specificity block-default-CSS rules on the rendered + // ``, where KB paints background, border, box-shadow, and border-radius. The projector groups + // these into one `.wp-block-kadence-image img { ... }` rule (padding gets its own descendant rule + // below). Each token is seeded to KB's existing default (transparent background, invisible border + // until a style is set, no shadow, square corners), so a fresh image is unchanged; any value the + // user sets renders at higher specificity (the `.kb-image` instance selector) and still wins. + // + // The `border` and `borderWidth` bindings below stay declared -- they feed the block-default rules + // that seed an image's border color and width from the tokens -- but the Style Library screen + // deliberately offers neither as a preset field. The image binds no border STYLE, so a preset + // cannot turn a border on: with the block's style unset render_border_styles() emits nothing and + // `border-style` stays `none`. Once a site owner sets one, the block emits a `border-` + // shorthand that overrides the color, and the single shape that would leave the width to a preset + // (style and color set, width blank) renders no border in the EDITOR at all, because + // getBorderStyle() returns an empty string without a width. + // + // @todo SOFT-4234: give the image a preset-able border trio. + 'block' => 'kadence/image', + 'label' => __( 'Style', 'kadence-blocks' ), // a picker-driven set; this is the editor control's label. + 'style_library' => [ + // The Style Library BLOCK PRESETS nav label — distinct from "label" above, which names the + // inspector's picker control, not the block. + 'label' => __( 'Advanced Image', 'kadence-blocks' ), + ], + 'bindings' => [ + 'background' => [ + 'token' => 'semantic.color.image-bg', + 'css_prop' => 'background-color', + 'css_selector' => 'img', + 'css_var' => 'kb-img-bg', + 'control_attr' => 'backgroundColor', + ], + // Border color and width are two axes of ONE control: the image migrates its legacy + // `borderColor`/`borderWidthDesktop` attributes into the nested `borderStyle` composite + // ([{top:[color,style,size],...},unit]) that EditorBorderControl edits, so both point at that + // attribute and each names the axis it owns. Same shape as the Button's border trio; the + // image binds no border STYLE, so only two of the three axes are present. + 'border' => [ + 'token' => 'semantic.color.border', + 'css_prop' => 'border-color', + 'css_selector' => 'img', + 'css_var' => 'kb-img-border-color', + 'control_attr' => 'borderStyle', + 'axis' => 'border-color', + 'responsive_attrs' => [ + 'tablet' => 'tabletBorderStyle', + 'mobile' => 'mobileBorderStyle', + ], + ], + 'borderWidth' => [ + 'token' => 'semantic.border-width.default', + 'css_prop' => 'border-width', + 'css_selector' => 'img', + 'css_var' => 'kb-img-border-width', + 'control_attr' => 'borderStyle', + 'axis' => 'border-width', + 'responsive_attrs' => [ + 'tablet' => 'tabletBorderStyle', + 'mobile' => 'mobileBorderStyle', + ], + ], + 'borderRadius' => [ + 'token' => 'semantic.radius.media', + 'css_prop' => 'border-radius', + 'css_selector' => 'img', + 'css_var' => 'kb-img-radius', + 'control_attr' => 'borderRadius', + 'responsive_attrs' => [ + 'tablet' => 'tabletBorderRadius', + 'mobile' => 'mobileBorderRadius', + ], + ], + 'shadow' => [ + 'token' => 'semantic.shadow.media', + 'css_prop' => 'box-shadow', + 'css_selector' => 'img', + 'css_var' => 'kb-img-shadow', + 'control_attr' => 'boxShadow', + ], + // Padding is rendered on the `.kb-img` wrapper, a descendant of the block root. The leading `*` + // forces Css_Builder::selector_suffix() to treat `.kb-img` as a descendant (a bare `.kb-img` + // would compound onto the root and never match) — see the icon color binding for the rationale. + // + // The image spells its per-device padding attributes `paddingDesktop`/`paddingTablet`/ + // `paddingMobile` rather than the bare-plus-prefix convention the Button and the radius binding + // above use, which is exactly why responsive_attrs is declared rather than derived. + 'padding' => [ + 'token' => 'semantic.spacing.media-padding', + 'css_prop' => 'padding', + 'css_selector' => '*.kb-img', + 'css_var' => 'kb-img-padding', + 'control_attr' => 'paddingDesktop', + 'responsive_attrs' => [ + 'tablet' => 'paddingTablet', + 'mobile' => 'paddingMobile', + ], + ], + ], + ], + [ + // Row Layout: low-specificity block-default rules on the block root (where KB renders both). + // Background follows the block's own rowlayout-bg token, which aliases the transparent + // primitive — so an uncustomized row stays transparent (KB's own default) unless a site owner brands + // that token. Border color follows the brand border token (invisible until a border is added). A + // value the user sets is a per-instance rule of equal specificity but later source order, so it still + // wins. + // + // Padding is not a preset property here. It could be one, but not in the css_prop shape the three + // bindings below use: the row's `padding` attribute ships a non-empty default of Kadence spacing + // slugs ([ 'sm', '', 'sm', '' ]), so every row emits its own per-instance padding rule and a + // low-specificity block-default rule would lose to it on every row ever published. Presetting it + // needs the button's css_var bridge shape instead (see render_preset_spacing() on the Single + // Button block class), plus a gate the button does not need: the row's default padding IS an + // attribute value, so an untouched row and a row deliberately set to "sm" are indistinguishable + // server-side, and the bridge would have to compare against the shipped default to know whether a + // preset may supply padding at all. Until that exists the row's padding follows the spacing + // tokens through the slug bridge, which a token-backed padding control also rides — that control + // stores its token in the attribute (render_measure_output already resolves a variable value + // there) and needs no binding here. + // + // @todo SOFT-4233: give the row's padding the css_var bridge so a preset can set it. + 'block' => 'kadence/rowlayout', + 'label' => __( 'Style', 'kadence-blocks' ), // a picker-driven set; this is the editor control's label. + 'style_library' => [ + // The Style Library BLOCK PRESETS nav label — distinct from "label" above, which names the + // inspector's picker control, not the block. + 'label' => __( 'Row Layout', 'kadence-blocks' ), + ], + 'bindings' => [ + // The row names its background attribute `bgColor`, not `background` — the binding key is the + // preset property id and need not match the attribute, which is what control_attr is for. + 'background' => [ + 'token' => 'semantic.color.rowlayout-bg', + 'css_prop' => 'background-color', + 'css_var' => 'kb-row-bg', + 'control_attr' => 'bgColor', + ], + // Border color is NOT a preset property here, and a color-only binding could never become one. + // The row calls Kadence_Blocks_CSS::render_border_styles() WITHOUT $single_styles, which takes + // the shorthand path: with a border width set it emits `border-top: