@wp-typia/block-types 0.1.0 → 0.1.3

package/README.md

@@ -29,7 +29,15 @@ Shared WordPress block semantic types derived from Gutenberg source and unoffici
 ## Current v1 areas
 
 - block editor alignment and content-position values
+- color and dimensions helper types
 - layout and flex vocabulary
 - spacing sides and axes
 - typography enums used by core block supports
 - block support keys used by `block.json`
+
+## Typia pipeline notes
+
+- `CssColorValue` and `MinHeightValue` are richer DX aliases that currently rely on template literal types.
+- imported template literal aliases are not yet consumed by the `sync-types` metadata pipeline
+- when a type must round-trip through `types.ts` -> `typia.manifest.json` -> `typia-validator.php`, prefer pipeline-compatible aliases such as `CssNamedColor` and `MinHeightKeyword`
+- for broader CSS-like string shapes in `types.ts`, prefer native Typia constraints on `string`, for example `string & tags.Pattern<"..."> & tags.MaxLength<...>`

package/dist/block-editor/color.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Practical CSS color vocabulary used by block editor controls and theme.json values.
+ *
+ * This is primarily a type-level DX helper today. Typia metadata generation does
+ * not yet consume template literal aliases like `#${string}` or `rgb(${string})`
+ * when they are imported into `types.ts`.
+ */
+export type CssColorValue = `#${string}` | `rgb(${string})` | `rgba(${string})` | `hsl(${string})` | `hsla(${string})` | `var(${string})` | `color-mix(${string})` | "transparent" | "currentColor";
+/**
+ * Pipeline-compatible named-color subset for use in `types.ts`.
+ *
+ * Prefer this alias when the value needs to flow through `sync-types`,
+ * `typia.manifest.json`, and the generated PHP validator unchanged.
+ */
+export type CssNamedColor = "transparent" | "currentColor" | "inherit" | "initial" | "unset";
+export declare const CSS_NAMED_COLORS: readonly ["transparent", "currentColor", "inherit", "initial", "unset"];
+/**
+ * Derived from Gutenberg duotone preset structures.
+ */
+export interface DuotonePalette {
+    colors: readonly [CssColorValue, CssColorValue];
+    name?: string;
+    slug?: string;
+}

package/dist/block-editor/color.js

@@ -0,0 +1,7 @@
+export const CSS_NAMED_COLORS = [
+    "transparent",
+    "currentColor",
+    "inherit",
+    "initial",
+    "unset",
+];

package/dist/block-editor/dimensions.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Derived from Gutenberg aspect ratio presets and dimensions controls.
+ */
+export type AspectRatio = "auto" | "1" | "1/1" | "4/3" | "3/4" | "3/2" | "2/3" | "16/9" | "9/16" | "21/9";
+export declare const ASPECT_RATIOS: readonly ["auto", "1", "1/1", "4/3", "3/4", "3/2", "2/3", "16/9", "9/16", "21/9"];
+/**
+ * Practical min-height value surface for WordPress dimension controls.
+ *
+ * This is primarily a type-level DX helper today. Typia metadata generation does
+ * not yet consume imported template literal aliases such as `${number}px`.
+ */
+export type MinHeightValue = `${number}px` | `${number}rem` | `${number}em` | `${number}%` | `${number}vh` | `${number}vw` | `var(${string})` | `clamp(${string})` | `min(${string})` | `max(${string})`;
+/**
+ * Pipeline-compatible min-height keyword subset for use in `types.ts`.
+ */
+export type MinHeightKeyword = "auto" | "inherit" | "initial" | "unset";
+export declare const MIN_HEIGHT_KEYWORDS: readonly ["auto", "inherit", "initial", "unset"];

package/dist/block-editor/dimensions.js

@@ -0,0 +1,18 @@
+export const ASPECT_RATIOS = [
+    "auto",
+    "1",
+    "1/1",
+    "4/3",
+    "3/4",
+    "3/2",
+    "2/3",
+    "16/9",
+    "9/16",
+    "21/9",
+];
+export const MIN_HEIGHT_KEYWORDS = [
+    "auto",
+    "inherit",
+    "initial",
+    "unset",
+];

package/dist/block-editor/index.d.ts

@@ -1,4 +1,6 @@
 export * from "./alignment";
+export * from "./color";
+export * from "./dimensions";
 export * from "./layout";
 export * from "./spacing";
 export * from "./typography";

package/dist/block-editor/index.js

@@ -1,4 +1,6 @@
 export * from "./alignment";
+export * from "./color";
+export * from "./dimensions";
 export * from "./layout";
 export * from "./spacing";
 export * from "./typography";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/block-types",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "Shared WordPress block semantic types derived from Gutenberg and unofficial declarations",
   "type": "module",
   "main": "dist/index.js",
@@ -21,6 +21,16 @@
       "import": "./dist/block-editor/alignment.js",
       "default": "./dist/block-editor/alignment.js"
     },
+    "./block-editor/color": {
+      "types": "./dist/block-editor/color.d.ts",
+      "import": "./dist/block-editor/color.js",
+      "default": "./dist/block-editor/color.js"
+    },
+    "./block-editor/dimensions": {
+      "types": "./dist/block-editor/dimensions.d.ts",
+      "import": "./dist/block-editor/dimensions.js",
+      "default": "./dist/block-editor/dimensions.js"
+    },
     "./block-editor/layout": {
       "types": "./dist/block-editor/layout.d.ts",
       "import": "./dist/block-editor/layout.js",
@@ -72,7 +82,11 @@
   "publishConfig": {
     "access": "public"
   },
-  "dependencies": {},
+  "engines": {
+    "node": ">=20.0.0",
+    "npm": ">=10.0.0",
+    "bun": ">=1.3.10"
+  },
   "devDependencies": {
     "@types/react": "^18.3.12",
     "@types/wordpress__block-editor": "^11.5.17",