@wp-typia/project-tools 0.20.2 → 0.22.0

package/dist/runtime/built-in-block-code-templates/interactivity.js

@@ -4,6 +4,7 @@ import { useBlockProps, InspectorControls, RichText, BlockControls, AlignmentToo
 import { PanelBody, RangeControl, Button, Notice } from '@wordpress/components';
 import { useState } from '@wordpress/element';
 import currentManifest from './manifest-document';
+import { {{slugCamelCase}}Store } from './interactivity-store';
 import {
   InspectorFromManifest,
   useEditorFields,
@@ -84,17 +85,22 @@ export default function Edit({ attributes, setAttributes, isSelected }: EditProp
 
   const blockProps = useBlockProps({
     className: \`{{cssClassName}} {{cssClassName}}--\${interactiveMode}\`,
-    'data-wp-interactive': '{{slugKebabCase}}',
-    'data-wp-context': JSON.stringify({
-      clicks: clickCount,
-      isAnimating,
-      isVisible,
-      animation,
-      maxClicks,
-    })
+    'data-wp-interactive': {{slugCamelCase}}Store.directive.interactive,
+    'data-wp-context': JSON.stringify(
+      {{slugCamelCase}}Store.createContext({
+        clicks: clickCount,
+        isAnimating,
+        isVisible,
+        animation,
+        maxClicks,
+      })
+    )
   });
   const previewContentStyle = { textAlign: alignmentValue };
   const progressBarStyle = { width: \`\${(clickCount / maxClicks) * 100}%\` };
+  const clicksDirective = {{slugCamelCase}}Store.directive.state('clicks');
+  const isAnimatingDirective = {{slugCamelCase}}Store.directive.state('isAnimating');
+  const progressDirective = {{slugCamelCase}}Store.directive.state('progress') + " + '%'";
 
   const resetCounter = () => {
     updateField('clickCount', 0);
@@ -191,9 +197,9 @@ export default function Edit({ attributes, setAttributes, isSelected }: EditProp
         <div
           className={\`{{cssClassName}}__content \${isAnimating ? 'is-animating' : ''}\`}
           style={previewContentStyle}
-          data-wp-on--click={isPreviewing ? 'actions.handleClick' : undefined}
-          data-wp-on--mouseenter={isPreviewing && interactiveMode === 'hover' ? 'actions.handleMouseEnter' : undefined}
-          data-wp-on--mouseleave={isPreviewing && interactiveMode === 'hover' ? 'actions.handleMouseLeave' : undefined}
+          data-wp-on--click={isPreviewing ? {{slugCamelCase}}Store.directive.action('handleClick') : undefined}
+          data-wp-on--mouseenter={isPreviewing && interactiveMode === 'hover' ? {{slugCamelCase}}Store.directive.action('handleMouseEnter') : undefined}
+          data-wp-on--mouseleave={isPreviewing && interactiveMode === 'hover' ? {{slugCamelCase}}Store.directive.action('handleMouseLeave') : undefined}
         >
           <RichText
             tagName="p"
@@ -222,7 +228,7 @@ export default function Edit({ attributes, setAttributes, isSelected }: EditProp
               </span>
               <span
                 className="{{cssClassName}}__counter-value"
-                data-wp-text="state.clicks"
+                data-wp-text={clicksDirective}
               >
                 {clickCount}
               </span>
@@ -234,7 +240,7 @@ export default function Edit({ attributes, setAttributes, isSelected }: EditProp
               <div
                 className="{{cssClassName}}__progress-bar"
                 style={progressBarStyle}
-                data-wp-style--width="state.progress + '%'"
+                data-wp-style--width={progressDirective}
               />
             </div>
           )}
@@ -242,7 +248,7 @@ export default function Edit({ attributes, setAttributes, isSelected }: EditProp
           {animation !== 'none' && (
             <div
               className={\`{{cssClassName}}__animation \${isAnimating ? 'is-active' : ''}\`}
-              data-wp-class--is-active="state.isAnimating"
+              data-wp-class--is-active={isAnimatingDirective}
             >
               {animation}
             </div>
@@ -255,6 +261,7 @@ export default function Edit({ attributes, setAttributes, isSelected }: EditProp
 `;
 export const INTERACTIVITY_SAVE_TEMPLATE = `import { useBlockProps, RichText } from '@wordpress/block-editor';
 import { __ } from '@wordpress/i18n';
+import { {{slugCamelCase}}Store } from './interactivity-store';
 import type { {{pascalCase}}Attributes } from './types';
 
 export default function Save({ attributes }: { attributes: {{pascalCase}}Attributes }) {
@@ -266,27 +273,41 @@ export default function Save({ attributes }: { attributes: {{pascalCase}}Attribu
   const maxClicks = attributes.maxClicks ?? 0;
   const showCounter = attributes.showCounter ?? true;
   const contentStyle = { textAlign: attributes.alignment };
+  const clickActionDirective = {{slugCamelCase}}Store.directive.action('handleClick');
+  const visibilityHiddenDirective = {{slugCamelCase}}Store.directive.negate(
+    {{slugCamelCase}}Store.directive.state('isVisible')
+  );
+  const clicksDirective = {{slugCamelCase}}Store.directive.state('clicks');
+  const clampedClicksDirective = {{slugCamelCase}}Store.directive.state('clampedClicks');
+  const isAnimatingDirective = {{slugCamelCase}}Store.directive.state('isAnimating');
+  const completionHiddenDirective = {{slugCamelCase}}Store.directive.negate(
+    {{slugCamelCase}}Store.directive.state('isComplete')
+  );
+  const resetActionDirective = {{slugCamelCase}}Store.directive.action('reset');
   const blockProps = useBlockProps.save({
     className: \`{{cssClassName}} {{cssClassName}}--\${interactiveMode}\`,
-    'data-wp-interactive': '{{slugKebabCase}}',
-    'data-wp-context': JSON.stringify({
-      clicks: clickCount,
-      isAnimating,
-      isVisible,
-      animation,
-      maxClicks,
-    })
+    'data-wp-interactive': {{slugCamelCase}}Store.directive.interactive,
+    'data-wp-context': JSON.stringify(
+      {{slugCamelCase}}Store.createContext({
+        clicks: clickCount,
+        isAnimating,
+        isVisible,
+        animation,
+        maxClicks,
+      })
+    )
   });
+  const progressDirective = {{slugCamelCase}}Store.directive.state('progress') + " + '%'";
 
   return (
     <div {...blockProps}>
       <div
         className={\`{{cssClassName}}__content \${isAnimating ? 'is-animating' : ''}\`}
         style={contentStyle}
-        data-wp-on--click="actions.handleClick"
-        data-wp-on--mouseenter={interactiveMode === 'hover' ? 'actions.handleMouseEnter' : undefined}
-        data-wp-on--mouseleave={interactiveMode === 'hover' ? 'actions.handleMouseLeave' : undefined}
-        data-wp-bind--hidden="!state.isVisible"
+        data-wp-on--click={clickActionDirective}
+        data-wp-on--mouseenter={interactiveMode === 'hover' ? {{slugCamelCase}}Store.directive.action('handleMouseEnter') : undefined}
+        data-wp-on--mouseleave={interactiveMode === 'hover' ? {{slugCamelCase}}Store.directive.action('handleMouseLeave') : undefined}
+        data-wp-bind--hidden={visibilityHiddenDirective}
       >
         <RichText.Content
           tagName="p"
@@ -306,7 +327,7 @@ export default function Save({ attributes }: { attributes: {{pascalCase}}Attribu
             </span>
             <span
               className="{{cssClassName}}__counter-value"
-              data-wp-text="state.clicks"
+              data-wp-text={clicksDirective}
             >
               {clickCount}
             </span>
@@ -322,8 +343,8 @@ export default function Save({ attributes }: { attributes: {{pascalCase}}Attribu
               aria-valuemin={0}
               aria-valuemax={maxClicks}
               aria-valuenow={Math.min(clickCount, maxClicks)}
-              data-wp-bind--aria-valuenow="state.clampedClicks"
-              data-wp-style--width="state.progress + '%'"
+              data-wp-bind--aria-valuenow={clampedClicksDirective}
+              data-wp-style--width={progressDirective}
             />
           </div>
         )}
@@ -331,7 +352,7 @@ export default function Save({ attributes }: { attributes: {{pascalCase}}Attribu
         <div
           className={\`{{cssClassName}}__animation \${animation}\`}
           aria-hidden="true"
-          data-wp-class--is-active="state.isAnimating"
+          data-wp-class--is-active={isAnimatingDirective}
         />
 
         {maxClicks > 0 && (
@@ -340,7 +361,7 @@ export default function Save({ attributes }: { attributes: {{pascalCase}}Attribu
             role="status"
             aria-live="polite"
             aria-atomic="true"
-            data-wp-bind--hidden="!state.isComplete"
+            data-wp-bind--hidden={completionHiddenDirective}
           >
             { __( '🎉 Complete!', '{{textDomain}}' ) }
           </div>
@@ -348,7 +369,7 @@ export default function Save({ attributes }: { attributes: {{pascalCase}}Attribu
 
         <button
           className="{{cssClassName}}__reset"
-          data-wp-on--click="actions.reset"
+          data-wp-on--click={resetActionDirective}
           aria-label={ __( 'Reset counter', '{{textDomain}}' ) }
         >
           <span aria-hidden="true">↻</span>
@@ -398,20 +419,214 @@ const registration = buildScaffoldBlockRegistration(
 
 registerScaffoldBlockType(registration.name, registration.settings);
 `;
+export const INTERACTIVITY_STORE_TEMPLATE = `import type {
+  {{pascalCase}}Context,
+  {{pascalCase}}State,
+} from './types';
+
+type InteractivityActionShape = object;
+type InteractivityCallbackShape = object;
+type InteractivityContextShape = object;
+type InteractivityStateShape = object;
+type InteractivityCallable = Function;
+type InteractivityKey<T extends object> = Extract<keyof T, string>;
+type InteractivityMethodKey<T extends object> = {
+  [Key in InteractivityKey<T>]: T[Key] extends InteractivityCallable ? Key : never;
+}[InteractivityKey<T>];
+
+type InteractivityDirectivePath<
+  Root extends string,
+  Key extends string,
+> = \`\${Root}.\${Key}\`;
+
+type NegatedInteractivityDirectivePath<Path extends string> = \`!\${Path}\`;
+
+export interface TypedInteractivityDirectiveHelpers<
+  State extends InteractivityStateShape,
+  Context extends InteractivityContextShape,
+  Actions extends InteractivityActionShape,
+  Callbacks extends InteractivityCallbackShape,
+  Namespace extends string,
+> {
+  readonly interactive: Namespace;
+  action<Key extends InteractivityMethodKey<Actions>>(
+    key: Key,
+  ): InteractivityDirectivePath<'actions', Key>;
+  callback<Key extends InteractivityMethodKey<Callbacks>>(
+    key: Key,
+  ): InteractivityDirectivePath<'callbacks', Key>;
+  state<Key extends InteractivityKey<State>>(
+    key: Key,
+  ): InteractivityDirectivePath<'state', Key>;
+  context<Key extends InteractivityKey<Context>>(
+    key: Key,
+  ): InteractivityDirectivePath<'context', Key>;
+  negate<Path extends string>(
+    path: Path,
+  ): NegatedInteractivityDirectivePath<Path>;
+}
+
+export interface TypedInteractivityStore<
+  Namespace extends string,
+  State extends InteractivityStateShape,
+  Context extends InteractivityContextShape,
+  Actions extends InteractivityActionShape,
+  Callbacks extends InteractivityCallbackShape,
+> {
+  readonly namespace: Namespace;
+  readonly state: State;
+  readonly context: Context;
+  readonly actions: Actions;
+  readonly callbacks: Callbacks;
+  readonly directive: TypedInteractivityDirectiveHelpers<
+    State,
+    Context,
+    Actions,
+    Callbacks,
+    Namespace
+  >;
+  createContext(value: Context): Context;
+}
+
+export function defineInteractivityStore<
+  Namespace extends string,
+  State extends InteractivityStateShape,
+  Context extends InteractivityContextShape,
+  Actions extends InteractivityActionShape,
+  Callbacks extends InteractivityCallbackShape,
+>(config: {
+  readonly namespace: Namespace;
+  readonly state: State;
+  readonly context: Context;
+  readonly actions: Actions;
+  readonly callbacks: Callbacks;
+}): TypedInteractivityStore<Namespace, State, Context, Actions, Callbacks> {
+  return {
+    namespace: config.namespace,
+    state: config.state,
+    context: config.context,
+    actions: config.actions,
+    callbacks: config.callbacks,
+    directive: {
+      interactive: config.namespace,
+      action<Key extends InteractivityMethodKey<Actions>>(key: Key) {
+        return \`actions.\${key}\` as InteractivityDirectivePath<'actions', Key>;
+      },
+      callback<Key extends InteractivityMethodKey<Callbacks>>(key: Key) {
+        return \`callbacks.\${key}\` as InteractivityDirectivePath<'callbacks', Key>;
+      },
+      state<Key extends InteractivityKey<State>>(key: Key) {
+        return \`state.\${key}\` as InteractivityDirectivePath<'state', Key>;
+      },
+      context<Key extends InteractivityKey<Context>>(key: Key) {
+        return \`context.\${key}\` as InteractivityDirectivePath<'context', Key>;
+      },
+      negate<Path extends string>(path: Path) {
+        return \`!\${path}\` as NegatedInteractivityDirectivePath<Path>;
+      },
+    },
+    createContext(value) {
+      return value;
+    },
+  };
+}
+
+type InteractivityActionHandler = Function;
+
+export interface {{pascalCase}}StoreActions {
+  handleClick: InteractivityActionHandler;
+  handleMouseEnter: InteractivityActionHandler;
+  handleMouseLeave: InteractivityActionHandler;
+  reset: InteractivityActionHandler;
+}
+
+export interface {{pascalCase}}StoreCallbacks {}
+
+export const {{slugCamelCase}}Store = defineInteractivityStore({
+  namespace: '{{slugKebabCase}}',
+  state: {} as {{pascalCase}}State,
+  context: {} as {{pascalCase}}Context,
+  actions: {} as {{pascalCase}}StoreActions,
+  callbacks: {} as {{pascalCase}}StoreCallbacks,
+});
+`;
 export const INTERACTIVITY_SCRIPT_TEMPLATE = `/**
  * WordPress Interactivity API implementation for {{title}} block
  */
 import { store, getContext, getElement, withSyncEvent } from '@wordpress/interactivity';
-import type { {{pascalCase}}Context } from './types';
+import {
+  {{slugCamelCase}}Store,
+  type {{pascalCase}}StoreActions,
+} from './interactivity-store';
+import type { {{pascalCase}}Context, {{pascalCase}}State } from './types';
 
 function getBlockContext() {
   return getContext<{{pascalCase}}Context>();
 }
 
-// Store configuration
-store('{{slugKebabCase}}', {
-  // State - reactive data that updates the UI
-  state: {
+const actions: {{pascalCase}}StoreActions = {
+  // Handle block click
+  handleClick: () => {
+    const context = getBlockContext();
+    const { ref } = getElement();
+
+    if (!ref) {
+      return;
+    }
+
+    if (context.maxClicks > 0 && context.clicks >= context.maxClicks) {
+      return;
+    }
+
+    const previousClicks = context.clicks;
+
+    // Increment click counter
+    context.clicks += 1;
+
+    // Trigger animation
+    if (context.animation !== 'none') {
+      context.isAnimating = true;
+      setTimeout(() => {
+        context.isAnimating = false;
+      }, 1000);
+    }
+
+    // Emit custom event
+    ref.dispatchEvent(new CustomEvent('{{slugKebabCase}}:click', {
+      detail: { clicks: context.clicks }
+    }));
+
+    // Check if max clicks reached
+    if (context.maxClicks > 0 && previousClicks < context.maxClicks && context.clicks === context.maxClicks) {
+      ref.dispatchEvent(new CustomEvent('{{slugKebabCase}}:complete', {
+        detail: { totalClicks: context.clicks }
+      }));
+    }
+  },
+
+  // Handle hover events
+  handleMouseEnter: () => {
+    const context = getBlockContext();
+    if (context.animation === 'none') return;
+    context.isAnimating = true;
+  },
+
+  handleMouseLeave: () => {
+    const context = getBlockContext();
+    if (context.animation === 'none') return;
+    context.isAnimating = false;
+  },
+
+  // Reset counter
+  reset: withSyncEvent((event: Event) => {
+    event.stopPropagation();
+    const context = getBlockContext();
+    context.clicks = 0;
+    context.isAnimating = false;
+  })
+};
+
+const state = {
     get clicks() {
       return getBlockContext().clicks;
     },
@@ -439,70 +654,14 @@ store('{{slugKebabCase}}', {
       const context = getBlockContext();
       return context.clicks >= context.maxClicks && context.maxClicks > 0;
     }
-  },
-
-  // Actions - user interactions
-  actions: {
-    // Handle block click
-    handleClick: () => {
-      const context = getBlockContext();
-      const { ref } = getElement();
-
-      if (!ref) {
-        return;
-      }
-
-      if (context.maxClicks > 0 && context.clicks >= context.maxClicks) {
-        return;
-      }
-
-      const previousClicks = context.clicks;
-
-      // Increment click counter
-      context.clicks += 1;
+} satisfies {{pascalCase}}State;
 
-      // Trigger animation
-      if (context.animation !== 'none') {
-        context.isAnimating = true;
-        setTimeout(() => {
-          context.isAnimating = false;
-        }, 1000);
-      }
-
-      // Emit custom event
-      ref.dispatchEvent(new CustomEvent('{{slugKebabCase}}:click', {
-        detail: { clicks: context.clicks }
-      }));
-
-      // Check if max clicks reached
-      if (context.maxClicks > 0 && previousClicks < context.maxClicks && context.clicks === context.maxClicks) {
-        ref.dispatchEvent(new CustomEvent('{{slugKebabCase}}:complete', {
-          detail: { totalClicks: context.clicks }
-        }));
-      }
-    },
-
-    // Handle hover events
-    handleMouseEnter: () => {
-      const context = getBlockContext();
-      if (context.animation === 'none') return;
-      context.isAnimating = true;
-    },
-
-    handleMouseLeave: () => {
-      const context = getBlockContext();
-      if (context.animation === 'none') return;
-      context.isAnimating = false;
-    },
-
-    // Reset counter
-    reset: withSyncEvent((event: Event) => {
-      event.stopPropagation();
-      const context = getBlockContext();
-      context.clicks = 0;
-      context.isAnimating = false;
-    })
-  }
+// Store configuration
+store({{slugCamelCase}}Store.namespace, {
+  // State - reactive data that updates the UI
+  state,
+  actions,
+  callbacks: {{slugCamelCase}}Store.callbacks,
 });
 `;
 export const INTERACTIVITY_VALIDATORS_TEMPLATE = `import typia from 'typia';

package/dist/runtime/built-in-block-code-templates.d.ts

@@ -4,7 +4,7 @@
  */
 export { BLOCK_METADATA_WRAPPER_TEMPLATE, MANIFEST_DEFAULTS_DOCUMENT_WRAPPER_TEMPLATE, MANIFEST_DOCUMENT_WRAPPER_TEMPLATE, SHARED_HOOKS_TEMPLATE, } from "./built-in-block-code-templates/shared.js";
 export { BASIC_EDIT_TEMPLATE, BASIC_INDEX_TEMPLATE, BASIC_SAVE_TEMPLATE, BASIC_VALIDATORS_TEMPLATE, } from "./built-in-block-code-templates/basic.js";
-export { INTERACTIVITY_EDIT_TEMPLATE, INTERACTIVITY_INDEX_TEMPLATE, INTERACTIVITY_SAVE_TEMPLATE, INTERACTIVITY_SCRIPT_TEMPLATE, INTERACTIVITY_VALIDATORS_TEMPLATE, } from "./built-in-block-code-templates/interactivity.js";
+export { INTERACTIVITY_EDIT_TEMPLATE, INTERACTIVITY_INDEX_TEMPLATE, INTERACTIVITY_SAVE_TEMPLATE, INTERACTIVITY_SCRIPT_TEMPLATE, INTERACTIVITY_STORE_TEMPLATE, INTERACTIVITY_VALIDATORS_TEMPLATE, } from "./built-in-block-code-templates/interactivity.js";
 export { PERSISTENCE_EDIT_TEMPLATE, PERSISTENCE_INDEX_TEMPLATE, PERSISTENCE_INTERACTIVITY_TEMPLATE, PERSISTENCE_SAVE_TEMPLATE, PERSISTENCE_VALIDATORS_TEMPLATE, } from "./built-in-block-code-templates/persistence.js";
 export { QUERY_LOOP_INDEX_TEMPLATE, } from "./built-in-block-code-templates/query-loop.js";
 export { COMPOUND_CHILD_EDIT_TEMPLATE, COMPOUND_CHILD_INDEX_TEMPLATE, COMPOUND_CHILDREN_TEMPLATE, COMPOUND_CHILD_SAVE_TEMPLATE, COMPOUND_CHILD_VALIDATORS_TEMPLATE, COMPOUND_LOCAL_HOOKS_TEMPLATE, COMPOUND_PARENT_EDIT_TEMPLATE, COMPOUND_PARENT_INDEX_TEMPLATE, COMPOUND_PARENT_SAVE_TEMPLATE, COMPOUND_PARENT_VALIDATORS_TEMPLATE, COMPOUND_PERSISTENCE_PARENT_EDIT_TEMPLATE, COMPOUND_PERSISTENCE_PARENT_INTERACTIVITY_TEMPLATE, COMPOUND_PERSISTENCE_PARENT_SAVE_TEMPLATE, COMPOUND_PERSISTENCE_PARENT_VALIDATORS_TEMPLATE, } from "./built-in-block-code-templates/compound.js";

package/dist/runtime/built-in-block-code-templates.js

@@ -4,7 +4,7 @@
  */
 export { BLOCK_METADATA_WRAPPER_TEMPLATE, MANIFEST_DEFAULTS_DOCUMENT_WRAPPER_TEMPLATE, MANIFEST_DOCUMENT_WRAPPER_TEMPLATE, SHARED_HOOKS_TEMPLATE, } from "./built-in-block-code-templates/shared.js";
 export { BASIC_EDIT_TEMPLATE, BASIC_INDEX_TEMPLATE, BASIC_SAVE_TEMPLATE, BASIC_VALIDATORS_TEMPLATE, } from "./built-in-block-code-templates/basic.js";
-export { INTERACTIVITY_EDIT_TEMPLATE, INTERACTIVITY_INDEX_TEMPLATE, INTERACTIVITY_SAVE_TEMPLATE, INTERACTIVITY_SCRIPT_TEMPLATE, INTERACTIVITY_VALIDATORS_TEMPLATE, } from "./built-in-block-code-templates/interactivity.js";
+export { INTERACTIVITY_EDIT_TEMPLATE, INTERACTIVITY_INDEX_TEMPLATE, INTERACTIVITY_SAVE_TEMPLATE, INTERACTIVITY_SCRIPT_TEMPLATE, INTERACTIVITY_STORE_TEMPLATE, INTERACTIVITY_VALIDATORS_TEMPLATE, } from "./built-in-block-code-templates/interactivity.js";
 export { PERSISTENCE_EDIT_TEMPLATE, PERSISTENCE_INDEX_TEMPLATE, PERSISTENCE_INTERACTIVITY_TEMPLATE, PERSISTENCE_SAVE_TEMPLATE, PERSISTENCE_VALIDATORS_TEMPLATE, } from "./built-in-block-code-templates/persistence.js";
 export { QUERY_LOOP_INDEX_TEMPLATE, } from "./built-in-block-code-templates/query-loop.js";
 export { COMPOUND_CHILD_EDIT_TEMPLATE, COMPOUND_CHILD_INDEX_TEMPLATE, COMPOUND_CHILDREN_TEMPLATE, COMPOUND_CHILD_SAVE_TEMPLATE, COMPOUND_CHILD_VALIDATORS_TEMPLATE, COMPOUND_LOCAL_HOOKS_TEMPLATE, COMPOUND_PARENT_EDIT_TEMPLATE, COMPOUND_PARENT_INDEX_TEMPLATE, COMPOUND_PARENT_SAVE_TEMPLATE, COMPOUND_PARENT_VALIDATORS_TEMPLATE, COMPOUND_PERSISTENCE_PARENT_EDIT_TEMPLATE, COMPOUND_PERSISTENCE_PARENT_INTERACTIVITY_TEMPLATE, COMPOUND_PERSISTENCE_PARENT_SAVE_TEMPLATE, COMPOUND_PERSISTENCE_PARENT_VALIDATORS_TEMPLATE, } from "./built-in-block-code-templates/compound.js";

package/dist/runtime/cli-add-shared.d.ts

@@ -5,7 +5,7 @@ export { normalizeBlockSlug, } from "./scaffold-identifiers.js";
 /**
  * Supported top-level `wp-typia add` kinds exposed by the canonical CLI.
  */
-export declare const ADD_KIND_IDS: readonly ["block", "variation", "pattern", "binding-source", "rest-resource", "ability", "ai-feature", "hooked-block", "editor-plugin"];
+export declare const ADD_KIND_IDS: readonly ["admin-view", "block", "variation", "style", "transform", "pattern", "binding-source", "rest-resource", "ability", "ai-feature", "hooked-block", "editor-plugin"];
 export type AddKindId = (typeof ADD_KIND_IDS)[number];
 /**
  * Supported plugin-level REST resource methods accepted by
@@ -14,10 +14,18 @@ export type AddKindId = (typeof ADD_KIND_IDS)[number];
 export declare const REST_RESOURCE_METHOD_IDS: readonly ["list", "read", "create", "update", "delete"];
 export type RestResourceMethodId = (typeof REST_RESOURCE_METHOD_IDS)[number];
 /**
- * Supported editor-plugin shell slots accepted by `wp-typia add editor-plugin --slot`.
+ * Supported editor-plugin shell surfaces accepted by
+ * `wp-typia add editor-plugin --slot`.
  */
-export declare const EDITOR_PLUGIN_SLOT_IDS: readonly ["PluginSidebar"];
+export declare const EDITOR_PLUGIN_SLOT_IDS: readonly ["sidebar", "document-setting-panel"];
 export type EditorPluginSlotId = (typeof EDITOR_PLUGIN_SLOT_IDS)[number];
+export declare const EDITOR_PLUGIN_SLOT_ALIASES: {
+    readonly PluginDocumentSettingPanel: "document-setting-panel";
+    readonly PluginSidebar: "sidebar";
+    readonly "document-setting-panel": "document-setting-panel";
+    readonly sidebar: "sidebar";
+};
+export declare function resolveEditorPluginSlotAlias(slot: string): EditorPluginSlotId | undefined;
 /**
  * Supported built-in block families accepted by `wp-typia add block --template`.
  */
@@ -29,11 +37,45 @@ export interface RunAddVariationCommandOptions {
     cwd?: string;
     variationName: string;
 }
+/**
+ * Options for `wp-typia add style`.
+ *
+ * @property blockName Existing workspace block slug that owns the style.
+ * @property cwd Working directory used to resolve the nearest official workspace.
+ * Defaults to `process.cwd()`.
+ * @property styleName Human-entered style name that will be normalized into the
+ * generated style slug.
+ */
+export interface RunAddBlockStyleCommandOptions {
+    blockName: string;
+    cwd?: string;
+    styleName: string;
+}
+/**
+ * Options for `wp-typia add transform`.
+ *
+ * @property cwd Working directory used to resolve the nearest official workspace.
+ * Defaults to `process.cwd()`.
+ * @property fromBlockName Full `namespace/block` source block name accepted by
+ * WordPress block transform definitions.
+ * @property toBlockName Existing workspace block slug or full block name that
+ * owns the generated transform.
+ * @property transformName Human-entered transform name that will be normalized
+ * into the generated transform slug.
+ */
+export interface RunAddBlockTransformCommandOptions {
+    cwd?: string;
+    fromBlockName: string;
+    toBlockName: string;
+    transformName: string;
+}
 export interface RunAddPatternCommandOptions {
     cwd?: string;
     patternName: string;
 }
 export interface RunAddBindingSourceCommandOptions {
+    attributeName?: string;
+    blockName?: string;
     bindingSourceName: string;
     cwd?: string;
 }
@@ -43,6 +85,23 @@ export interface RunAddRestResourceCommandOptions {
     namespace?: string;
     restResourceName: string;
 }
+/**
+ * Options for `wp-typia add admin-view`.
+ *
+ * @property adminViewName Human-entered admin screen name that will be
+ * normalized into the generated slug.
+ * @property cwd Working directory used to resolve the nearest official workspace.
+ * Defaults to `process.cwd()`.
+ * @property source Optional data source locator. `rest-resource:<slug>` wires
+ * the generated screen to an existing list-capable REST resource.
+ * `core-data:<kind>/<name>` binds the screen to a supported WordPress-owned
+ * entity collection such as `core-data:postType/post`.
+ */
+export interface RunAddAdminViewCommandOptions {
+    adminViewName: string;
+    cwd?: string;
+    source?: string;
+}
 /**
  * Options for `wp-typia add ability`.
  *
@@ -73,7 +132,7 @@ export interface RunAddHookedBlockCommandOptions {
  * Defaults to `process.cwd()`.
  * @property editorPluginName Human-entered editor plugin name that will be
  * normalized into the generated slug.
- * @property slot Optional editor shell slot. Defaults to `PluginSidebar`.
+ * @property slot Optional editor shell slot. Defaults to `sidebar`.
  */
 export interface RunAddEditorPluginCommandOptions {
     cwd?: string;
@@ -143,7 +202,7 @@ export declare function assertValidHookAnchor(anchorBlockName: string): string;
 /**
  * Validate and normalize the editor plugin shell slot.
  *
- * @param slot Optional shell slot. Defaults to `PluginSidebar`.
+ * @param slot Optional shell slot. Defaults to `sidebar`.
  * @returns The canonical editor plugin slot id.
  * @throws {Error} When the slot is not supported by the workspace scaffold.
  */
@@ -157,6 +216,16 @@ export declare function assertVariationDoesNotExist(projectDir: string, blockSlu
 export declare function assertPatternDoesNotExist(projectDir: string, patternSlug: string, inventory: WorkspaceInventory): void;
 export declare function assertBindingSourceDoesNotExist(projectDir: string, bindingSourceSlug: string, inventory: WorkspaceInventory): void;
 export declare function assertRestResourceDoesNotExist(projectDir: string, restResourceSlug: string, inventory: WorkspaceInventory): void;
+/**
+ * Ensure a DataViews admin screen scaffold does not already exist on disk or in
+ * the workspace inventory.
+ *
+ * @param projectDir Workspace root directory.
+ * @param adminViewSlug Normalized admin screen slug.
+ * @param inventory Parsed workspace inventory.
+ * @throws {Error} When the directory, PHP bootstrap, or inventory entry already exists.
+ */
+export declare function assertAdminViewDoesNotExist(projectDir: string, adminViewSlug: string, inventory: WorkspaceInventory): void;
 /**
  * Ensure a workflow ability scaffold does not already exist on disk or in the
  * workspace inventory.