webentor-core

Reusable Webentor core functionality for PHP and JS runtimes.

Packages

• Composer: webikon/webentor-core
• npm: @webikon/webentor-core

Requirements

• PHP >= 8.2
• Node >= 20
• pnpm >= 10

Development

composer install
pnpm install
pnpm build

JS Package Exports

This package exports raw TypeScript source so the consumer's Vite pipeline compiles it together with the rest of the project. Consumer projects using Vite 7+ must enable the TypeScript-aware config loader:

// package.json scripts
"dev": "vite --configLoader runner",
"build": "vite build --configLoader runner"

Available subpath imports:

import { debounce } from '@webikon/webentor-core';
import { Alpine } from '@webikon/webentor-core/_alpine';
import { SliderComponent } from '@webikon/webentor-core/_slider';
import { WebentorButton } from '@webikon/webentor-core/blocks-components';
import { initResponsiveSettings } from '@webikon/webentor-core/blocks-filters';
import { buildSafelist, webentorDefaultConfig } from '@webikon/webentor-core/config';
import type { WebentorConfig } from '@webikon/webentor-core/types';

WP-CLI

Use the responsive attributes migration command on an existing project when you want to scan or migrate block content without opening the WordPress admin.

wp webentor migrate-responsive-attributes
wp webentor migrate-responsive-attributes --migrate
wp webentor migrate-responsive-attributes --cleanup
wp webentor migrate-responsive-attributes --site-id=7 --cleanup

By default the command only scans and reports how many posts and blocks still need migration or cleanup. --migrate writes v2 attributes while keeping legacy keys, and --cleanup removes the legacy keys after backfilling the v2 shape. On multisite, --site-id=<id> runs the command against a specific site.

Linting

Core consumes shared presets from @webikon/webentor-configs to keep lint behavior aligned across repositories.