@deneb-ui/core 2.0.24

package/dist/types/protocol.d.ts

@@ -0,0 +1,10 @@
+import type { StyleKind, StyleProperties } from './styles';
+export declare const STYLE_PATCH_MESSAGE = "FIVORA_PREVIEW_STYLE_PATCH";
+export declare const DENEB_STYLE_PATCH_MESSAGE = "DENEB_PREVIEW_STYLE_PATCH";
+export interface StylePatchPayload {
+    type: typeof STYLE_PATCH_MESSAGE | typeof DENEB_STYLE_PATCH_MESSAGE;
+    targetPath: string;
+    styleType: StyleKind;
+    properties: Partial<StyleProperties>;
+}
+export declare function isStylePatchPayload(value: unknown): value is StylePatchPayload;

package/dist/types/protocol.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DENEB_STYLE_PATCH_MESSAGE = exports.STYLE_PATCH_MESSAGE = void 0;
+exports.isStylePatchPayload = isStylePatchPayload;
+exports.STYLE_PATCH_MESSAGE = 'FIVORA_PREVIEW_STYLE_PATCH';
+exports.DENEB_STYLE_PATCH_MESSAGE = 'DENEB_PREVIEW_STYLE_PATCH';
+function isStylePatchPayload(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const payload = value;
+    const type = payload.type;
+    if (type !== exports.STYLE_PATCH_MESSAGE && type !== exports.DENEB_STYLE_PATCH_MESSAGE) {
+        return false;
+    }
+    return (typeof payload.targetPath === 'string' &&
+        typeof payload.styleType === 'string' &&
+        typeof payload.properties === 'object' &&
+        payload.properties !== null);
+}

package/dist/types/styles.d.ts

@@ -0,0 +1,90 @@
+export interface BaseStyleProperties {
+    marginTop?: string | number;
+    marginBottom?: string | number;
+    marginLeft?: string | number;
+    marginRight?: string | number;
+    /** Legacy Fivora field-style alias */
+    spacingTop?: string | number;
+    spacingBottom?: string | number;
+    spacingLeft?: string | number;
+    spacingRight?: string | number;
+}
+export interface TextStyleProperties extends BaseStyleProperties {
+    fontFamily?: string;
+    fontSize?: string | number;
+    /** When true, px/rem font sizes become responsive clamp() values */
+    responsiveFontSize?: boolean;
+    fontWeight?: string | number;
+    lineHeight?: string | number;
+    letterSpacing?: string;
+    color?: string;
+    textAlign?: 'left' | 'center' | 'right' | 'justify';
+    textTransform?: 'none' | 'uppercase' | 'lowercase' | 'capitalize';
+}
+export interface CardStyleProperties extends BaseStyleProperties {
+    width?: string | number;
+    minWidth?: string | number;
+    maxWidth?: string | number;
+    height?: string | number;
+    aspectRatio?: string;
+    paddingTop?: string | number;
+    paddingBottom?: string | number;
+    paddingLeft?: string | number;
+    paddingRight?: string | number;
+    borderRadius?: string | number;
+    borderWidth?: string | number;
+    borderStyle?: 'solid' | 'dashed' | 'dotted' | 'none';
+    borderColor?: string;
+    backgroundColor?: string;
+    backgroundGradient?: string;
+    boxShadow?: string;
+    backdropBlur?: string | number;
+    gap?: string | number;
+}
+export interface ButtonStyleProperties extends BaseStyleProperties {
+    variant?: 'solid' | 'outline' | 'ghost' | 'soft';
+    size?: 'sm' | 'md' | 'lg' | 'xl';
+    borderRadius?: string | number;
+    paddingX?: string | number;
+    paddingY?: string | number;
+    backgroundColor?: string;
+    textColor?: string;
+    borderColor?: string;
+    hoverBackgroundColor?: string;
+    hoverTextColor?: string;
+}
+export interface GridStyleProperties {
+    columns?: number | 'auto-fit' | 'auto-fill';
+    minCardWidth?: string;
+    gapX?: string | number;
+    gapY?: string | number;
+    equalHeight?: boolean;
+}
+export interface SectionStyleProperties {
+    paddingTop?: string | number;
+    paddingBottom?: string | number;
+    paddingX?: string | number;
+    maxWidth?: string;
+    backgroundColor?: string;
+    backgroundImage?: string;
+    backgroundOverlayColor?: string;
+    backgroundOverlayOpacity?: number;
+}
+export type StyleKind = 'text' | 'card' | 'button' | 'grid' | 'section';
+export type ComponentStyle = {
+    kind: 'text';
+    style: TextStyleProperties;
+} | {
+    kind: 'card';
+    style: CardStyleProperties;
+} | {
+    kind: 'button';
+    style: ButtonStyleProperties;
+} | {
+    kind: 'grid';
+    style: GridStyleProperties;
+} | {
+    kind: 'section';
+    style: SectionStyleProperties;
+};
+export type StyleProperties = TextStyleProperties | CardStyleProperties | ButtonStyleProperties | GridStyleProperties | SectionStyleProperties;

package/dist/types/styles.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/validation/styleSchemaValidator.d.ts

@@ -0,0 +1,8 @@
+import type { StyleKind } from '../types/styles';
+export interface StyleValidationIssue {
+    path: string;
+    message: string;
+}
+export declare function isValidStyleKind(value: unknown): value is StyleKind;
+export declare function validateStyleTree(styles: unknown, knownTargets?: Set<string>): StyleValidationIssue[];
+export declare function collectStyleTargetsFromHtml(html: string): Set<string>;

package/dist/validation/styleSchemaValidator.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidStyleKind = isValidStyleKind;
+exports.validateStyleTree = validateStyleTree;
+exports.collectStyleTargetsFromHtml = collectStyleTargetsFromHtml;
+const STYLE_KINDS = new Set(['text', 'card', 'button', 'grid', 'section']);
+function isValidStyleKind(value) {
+    return typeof value === 'string' && STYLE_KINDS.has(value);
+}
+function validateStyleTree(styles, knownTargets) {
+    const issues = [];
+    if (styles === undefined || styles === null)
+        return issues;
+    if (typeof styles !== 'object' || Array.isArray(styles)) {
+        issues.push({ path: 'styles', message: 'styles must be an object' });
+        return issues;
+    }
+    for (const [path, value] of Object.entries(styles)) {
+        if (!path.trim()) {
+            issues.push({ path: 'styles', message: 'style path cannot be empty' });
+            continue;
+        }
+        if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+            issues.push({ path: `styles.${path}`, message: 'style entry must be an object' });
+            continue;
+        }
+        if (knownTargets && !knownTargets.has(path)) {
+            issues.push({
+                path: `styles.${path}`,
+                message: 'no matching data-preview-style-target marker in template',
+            });
+        }
+    }
+    return issues;
+}
+function collectStyleTargetsFromHtml(html) {
+    const targets = new Set();
+    const attrPattern = /data-preview-style-target=["']([^"']+)["']/g;
+    let match;
+    while ((match = attrPattern.exec(html)) !== null) {
+        targets.add(match[1]);
+    }
+    return targets;
+}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@deneb-ui/core",
+  "version": "2.0.24",
+  "description": "Headless style engine for real-time Fivora visual editing — CSS variables, DOM patcher, and preview protocol.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./install-fonts": {
+      "types": "./dist/fonts/installProject.d.ts",
+      "default": "./dist/fonts/installProject.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deneb-ui/core.git",
+    "directory": "packages/deneb-core"
+  },
+  "homepage": "https://deneb.fivora.site",
+  "bugs": {
+    "url": "https://github.com/deneb-ui/core/issues"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "npm run build && node --test src/fonts/__tests__/fonts.test.cjs",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "deneb",
+    "deneb-ui",
+    "fivora",
+    "visual-editing",
+    "css-variables",
+    "style-engine"
+  ],
+  "author": "Chamika Gayashan & Induranga Kawishwara",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.0.0"
+  }
+}