@object-ui/core 3.1.5 → 3.3.1

package/src/protocols/ResponsiveProtocol.ts

@@ -1,210 +0,0 @@
-/**
- * ObjectUI
- * Copyright (c) 2024-present ObjectStack Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-/**
- * @object-ui/core - Responsive Protocol Bridge
- *
- * Converts spec-aligned ResponsiveConfig schemas into Tailwind CSS
- * utility classes for visibility, grid columns, and ordering across
- * breakpoints. Also provides runtime width-based visibility checks.
- *
- * @module protocols/ResponsiveProtocol
- * @packageDocumentation
- */
-
-import type { SpecResponsiveConfig } from '@object-ui/types';
-
-// ============================================================================
-// Breakpoint Definitions
-// ============================================================================
-
-/** Breakpoint name type matching Tailwind defaults. */
-export type BreakpointKey = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
-
-/** Breakpoint minimum pixel widths aligned with Tailwind CSS defaults. */
-export const BREAKPOINT_VALUES: Record<BreakpointKey, number> = {
-  xs: 0,
-  sm: 640,
-  md: 768,
-  lg: 1024,
-  xl: 1280,
-  '2xl': 1536,
-};
-
-/** Ordered breakpoint keys from smallest to largest. */
-const BREAKPOINT_ORDER: BreakpointKey[] = ['xs', 'sm', 'md', 'lg', 'xl', '2xl'];
-
-// ============================================================================
-// Resolved Types
-// ============================================================================
-
-/** Fully resolved responsive configuration. */
-export interface ResolvedResponsiveConfig {
-  breakpoint?: BreakpointKey;
-  hiddenOn: BreakpointKey[];
-  columns: Partial<Record<BreakpointKey, number>>;
-  order: Partial<Record<BreakpointKey, number>>;
-}
-
-// ============================================================================
-// Config Resolution
-// ============================================================================
-
-/**
- * Resolve a responsive configuration by applying defaults.
- *
- * @param config - SpecResponsiveConfig from the spec
- * @returns Fully resolved responsive configuration
- */
-export function resolveResponsiveConfig(config: SpecResponsiveConfig): ResolvedResponsiveConfig {
-  return {
-    breakpoint: config.breakpoint as BreakpointKey | undefined,
-    hiddenOn: (config.hiddenOn ?? []) as BreakpointKey[],
-    columns: (config.columns ?? {}) as Partial<Record<BreakpointKey, number>>,
-    order: (config.order ?? {}) as Partial<Record<BreakpointKey, number>>,
-  };
-}
-
-// ============================================================================
-// Visibility Classes
-// ============================================================================
-
-/**
- * Generate Tailwind CSS classes for responsive visibility.
- *
- * If `breakpoint` is set, the element is hidden below that breakpoint
- * (e.g. breakpoint "md" → `['hidden', 'md:block']`).
- *
- * If `hiddenOn` contains breakpoints, the element is hidden at those
- * specific sizes (e.g. hiddenOn: ["sm", "lg"] → `['sm:hidden', 'md:block', 'lg:hidden', 'xl:block']`).
- *
- * @param config - SpecResponsiveConfig from the spec
- * @returns Array of Tailwind CSS class strings
- */
-export function getVisibilityClasses(config: SpecResponsiveConfig): string[] {
-  const classes: string[] = [];
-
-  // Minimum breakpoint visibility
-  if (config.breakpoint) {
-    const bp = config.breakpoint as BreakpointKey;
-    if (bp !== 'xs') {
-      classes.push('hidden');
-      classes.push(`${bp}:block`);
-    }
-  }
-
-  // Per-breakpoint hidden overrides
-  const hiddenOn = (config.hiddenOn ?? []) as BreakpointKey[];
-  if (hiddenOn.length > 0) {
-    for (let i = 0; i < BREAKPOINT_ORDER.length; i++) {
-      const bp = BREAKPOINT_ORDER[i];
-      const isHidden = hiddenOn.includes(bp);
-      const prevHidden = i > 0 ? hiddenOn.includes(BREAKPOINT_ORDER[i - 1]) : false;
-
-      if (isHidden && !prevHidden) {
-        classes.push(bp === 'xs' ? 'hidden' : `${bp}:hidden`);
-      } else if (!isHidden && prevHidden) {
-        classes.push(bp === 'xs' ? 'block' : `${bp}:block`);
-      }
-    }
-  }
-
-  return classes;
-}
-
-// ============================================================================
-// Column Classes
-// ============================================================================
-
-/**
- * Generate Tailwind grid-cols classes for responsive column layouts.
- *
- * @param config - SpecResponsiveConfig from the spec
- * @returns Array of Tailwind CSS grid column class strings
- */
-export function getColumnClasses(config: SpecResponsiveConfig): string[] {
-  const classes: string[] = [];
-  const columns = (config.columns ?? {}) as Partial<Record<BreakpointKey, number>>;
-
-  for (const bp of BREAKPOINT_ORDER) {
-    const cols = columns[bp];
-    if (cols == null) continue;
-    const prefix = bp === 'xs' ? '' : `${bp}:`;
-    classes.push(`${prefix}grid-cols-${cols}`);
-  }
-
-  return classes;
-}
-
-// ============================================================================
-// Order Classes
-// ============================================================================
-
-/**
- * Generate Tailwind order utility classes for responsive ordering.
- *
- * @param config - SpecResponsiveConfig from the spec
- * @returns Array of Tailwind CSS order class strings
- */
-export function getOrderClasses(config: SpecResponsiveConfig): string[] {
-  const classes: string[] = [];
-  const order = (config.order ?? {}) as Partial<Record<BreakpointKey, number>>;
-
-  for (const bp of BREAKPOINT_ORDER) {
-    const ord = order[bp];
-    if (ord == null) continue;
-    const prefix = bp === 'xs' ? '' : `${bp}:`;
-    classes.push(`${prefix}order-${ord}`);
-  }
-
-  return classes;
-}
-
-// ============================================================================
-// Runtime Width Check
-// ============================================================================
-
-/**
- * Determine whether a component should be hidden at a given viewport width.
- *
- * Checks both the minimum `breakpoint` threshold and the `hiddenOn` list.
- *
- * @param config - SpecResponsiveConfig from the spec
- * @param width - Current viewport width in pixels
- * @returns `true` if the component should be hidden at the given width
- */
-export function shouldHideAtBreakpoint(config: SpecResponsiveConfig, width: number): boolean {
-  // Check minimum breakpoint
-  if (config.breakpoint) {
-    const minWidth = BREAKPOINT_VALUES[config.breakpoint as BreakpointKey];
-    if (minWidth !== undefined && width < minWidth) {
-      return true;
-    }
-  }
-
-  // Check hiddenOn list
-  const hiddenOn = (config.hiddenOn ?? []) as BreakpointKey[];
-  if (hiddenOn.length > 0) {
-    const currentBp = getCurrentBreakpoint(width);
-    return hiddenOn.includes(currentBp);
-  }
-
-  return false;
-}
-
-/**
- * Determine the current breakpoint name for a given width.
- */
-function getCurrentBreakpoint(width: number): BreakpointKey {
-  for (let i = BREAKPOINT_ORDER.length - 1; i >= 0; i--) {
-    if (width >= BREAKPOINT_VALUES[BREAKPOINT_ORDER[i]]) {
-      return BREAKPOINT_ORDER[i];
-    }
-  }
-  return 'xs';
-}

package/src/protocols/SharingProtocol.ts

@@ -1,185 +0,0 @@
-/**
- * ObjectUI
- * Copyright (c) 2024-present ObjectStack Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-/**
- * @object-ui/core - Sharing Protocol Bridge
- *
- * Converts spec-aligned SharingConfig and EmbedConfig schemas into
- * runtime-usable configurations. Provides embed code generation and
- * configuration validation.
- *
- * @module protocols/SharingProtocol
- * @packageDocumentation
- */
-
-import type { SharingConfig, EmbedConfig } from '@object-ui/types';
-
-// ============================================================================
-// Resolved Types
-// ============================================================================
-
-/** Fully resolved sharing configuration. */
-export interface ResolvedSharingConfig {
-  enabled: boolean;
-  publicLink?: string;
-  password?: string;
-  allowedDomains: string[];
-  expiresAt?: string;
-  allowAnonymous: boolean;
-}
-
-/** Fully resolved embed configuration. */
-export interface ResolvedEmbedConfig {
-  enabled: boolean;
-  allowedOrigins: string[];
-  width: string;
-  height: string;
-  showHeader: boolean;
-  showNavigation: boolean;
-  responsive: boolean;
-}
-
-/** Validation result for sharing configuration. */
-export interface SharingValidationResult {
-  valid: boolean;
-  errors: string[];
-}
-
-// ============================================================================
-// Sharing Config Resolution
-// ============================================================================
-
-/**
- * Resolve a sharing configuration by applying spec defaults.
- *
- * @param config - Partial SharingConfig from the spec
- * @returns Fully resolved sharing configuration
- */
-export function resolveSharingConfig(config: Partial<SharingConfig>): ResolvedSharingConfig {
-  return {
-    enabled: config.enabled ?? false,
-    publicLink: config.publicLink,
-    password: config.password,
-    allowedDomains: config.allowedDomains ?? [],
-    expiresAt: config.expiresAt,
-    allowAnonymous: config.allowAnonymous ?? false,
-  };
-}
-
-// ============================================================================
-// Embed Config Resolution
-// ============================================================================
-
-/**
- * Resolve an embed configuration by applying spec defaults.
- *
- * @param config - Partial EmbedConfig from the spec
- * @returns Fully resolved embed configuration
- */
-export function resolveEmbedConfig(config: Partial<EmbedConfig>): ResolvedEmbedConfig {
-  return {
-    enabled: config.enabled ?? false,
-    allowedOrigins: config.allowedOrigins ?? [],
-    width: config.width ?? '100%',
-    height: config.height ?? '600px',
-    showHeader: config.showHeader ?? true,
-    showNavigation: config.showNavigation ?? false,
-    responsive: config.responsive ?? true,
-  };
-}
-
-// ============================================================================
-// Embed Code Generation
-// ============================================================================
-
-/**
- * Generate an HTML iframe embed snippet from an EmbedConfig and URL.
- *
- * @param config - EmbedConfig from the spec
- * @param url - The URL to embed
- * @returns HTML string containing an iframe element
- */
-export function generateEmbedCode(config: EmbedConfig, url: string): string {
-  const resolved = resolveEmbedConfig(config);
-  const sanitizedUrl = escapeHtmlAttr(url);
-  const title = 'Embedded content';
-
-  const parts = [
-    `<iframe`,
-    `  src="${sanitizedUrl}"`,
-    `  width="${escapeHtmlAttr(resolved.width)}"`,
-    `  height="${escapeHtmlAttr(resolved.height)}"`,
-    `  title="${title}"`,
-    `  frameborder="0"`,
-    `  allowfullscreen`,
-  ];
-
-  if (resolved.responsive) {
-    parts.push(`  style="max-width: 100%; border: none;"`);
-  } else {
-    parts.push(`  style="border: none;"`);
-  }
-
-  parts.push(`></iframe>`);
-
-  return parts.join('\n');
-}
-
-/**
- * Escape a string for safe use in an HTML attribute value.
- */
-function escapeHtmlAttr(value: string): string {
-  return value
-    .replace(/&/g, '&amp;')
-    .replace(/"/g, '&quot;')
-    .replace(/</g, '&lt;')
-    .replace(/>/g, '&gt;');
-}
-
-// ============================================================================
-// Sharing Config Validation
-// ============================================================================
-
-/**
- * Validate a sharing configuration and return any errors.
- *
- * @param config - SharingConfig to validate
- * @returns Validation result with `valid` flag and error messages
- */
-export function validateSharingConfig(config: SharingConfig): SharingValidationResult {
-  const errors: string[] = [];
-
-  if (config.enabled && !config.publicLink) {
-    errors.push('A public link is required when sharing is enabled.');
-  }
-
-  if (config.expiresAt) {
-    const expiryDate = new Date(config.expiresAt);
-    if (isNaN(expiryDate.getTime())) {
-      errors.push('expiresAt must be a valid ISO 8601 date string.');
-    }
-  }
-
-  if (config.allowedDomains) {
-    for (const domain of config.allowedDomains) {
-      if (!domain || domain.trim().length === 0) {
-        errors.push('allowedDomains contains an empty or whitespace-only entry.');
-        break;
-      }
-    }
-  }
-
-  if (config.password !== undefined && config.password.length === 0) {
-    errors.push('Password must not be an empty string when provided.');
-  }
-
-  return {
-    valid: errors.length === 0,
-    errors,
-  };
-}

package/src/protocols/index.ts

@@ -1,13 +0,0 @@
-/**
- * ObjectUI
- * Copyright (c) 2024-present ObjectStack Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-export * from './DndProtocol.js';
-export * from './KeyboardProtocol.js';
-export * from './NotificationProtocol.js';
-export * from './ResponsiveProtocol.js';
-export * from './SharingProtocol.js';

package/src/query/__tests__/query-ast.test.ts

@@ -1,211 +0,0 @@
-/**
- * @object-ui/core - Query AST Builder Tests
- */
-
-import { describe, it, expect } from 'vitest';
-import { QueryASTBuilder } from '../query-ast';
-import type { QuerySchema } from '@object-ui/types';
-
-describe('QueryASTBuilder', () => {
-  const builder = new QueryASTBuilder();
-
-  describe('Basic Query Building', () => {
-    it('should build simple SELECT query', () => {
-      const query: QuerySchema = {
-        object: 'users',
-        fields: ['id', 'name', 'email'],
-      };
-
-      const ast = builder.build(query);
-
-      expect(ast.select.type).toBe('select');
-      expect(ast.select.fields).toHaveLength(3);
-      expect(ast.from.table).toBe('users');
-    });
-
-    it('should build SELECT * when no fields specified', () => {
-      const query: QuerySchema = {
-        object: 'users',
-      };
-
-      const ast = builder.build(query);
-
-      expect(ast.select.fields).toHaveLength(1);
-      expect(ast.select.fields[0]).toMatchObject({
-        type: 'field',
-        name: '*',
-      });
-    });
-
-    it('should build query with WHERE clause', () => {
-      const query: QuerySchema = {
-        object: 'users',
-        fields: ['id', 'name'],
-        filter: {
-          conditions: [
-            {
-              field: 'status',
-              operator: 'equals',
-              value: 'active',
-            },
-          ],
-        },
-      };
-
-      const ast = builder.build(query);
-
-      expect(ast.where).toBeDefined();
-      expect(ast.where?.type).toBe('where');
-      expect(ast.where?.condition.type).toBe('operator');
-    });
-
-    it('should build query with ORDER BY', () => {
-      const query: QuerySchema = {
-        object: 'users',
-        fields: ['id', 'name'],
-        sort: [
-          { field: 'created_at', order: 'desc' },
-          { field: 'name', order: 'asc' },
-        ],
-      };
-
-      const ast = builder.build(query);
-
-      expect(ast.order_by).toBeDefined();
-      expect(ast.order_by?.fields).toHaveLength(2);
-      expect(ast.order_by?.fields[0].direction).toBe('desc');
-    });
-
-    it('should build query with LIMIT and OFFSET', () => {
-      const query: QuerySchema = {
-        object: 'users',
-        fields: ['id', 'name'],
-        limit: 10,
-        offset: 20,
-      };
-
-      const ast = builder.build(query);
-
-      expect(ast.limit).toBeDefined();
-      expect(ast.limit?.value).toBe(10);
-      expect(ast.offset).toBeDefined();
-      expect(ast.offset?.value).toBe(20);
-    });
-  });
-
-  describe('Advanced Query Building', () => {
-    it('should build query with JOIN', () => {
-      const query: QuerySchema = {
-        object: 'users',
-        fields: ['id', 'name', 'orders.total'],
-        joins: [
-          {
-            type: 'left',
-            object: 'orders',
-            on: {
-              local_field: 'id',
-              foreign_field: 'user_id',
-            },
-          },
-        ],
-      };
-
-      const ast = builder.build(query);
-
-      expect(ast.joins).toBeDefined();
-      expect(ast.joins).toHaveLength(1);
-      expect(ast.joins?.[0].join_type).toBe('left');
-      expect(ast.joins?.[0].table).toBe('orders');
-    });
-
-    it('should build query with aggregations', () => {
-      const query: QuerySchema = {
-        object: 'orders',
-        aggregations: [
-          {
-            function: 'count',
-            alias: 'total_count',
-          },
-          {
-            function: 'sum',
-            field: 'amount',
-            alias: 'total_amount',
-          },
-        ],
-      };
-
-      const ast = builder.build(query);
-
-      expect(ast.select.fields).toHaveLength(2);
-      expect(ast.select.fields[0]).toMatchObject({
-        type: 'aggregate',
-        function: 'count',
-        alias: 'total_count',
-      });
-    });
-
-    it('should build query with GROUP BY', () => {
-      const query: QuerySchema = {
-        object: 'orders',
-        fields: ['user_id'],
-        group_by: ['user_id'],
-        aggregations: [
-          {
-            function: 'count',
-            alias: 'order_count',
-          },
-        ],
-      };
-
-      const ast = builder.build(query);
-
-      expect(ast.group_by).toBeDefined();
-      expect(ast.group_by?.fields).toHaveLength(1);
-      expect(ast.group_by?.fields[0]).toMatchObject({
-        type: 'field',
-        name: 'user_id',
-      });
-    });
-  });
-
-  describe('Complex Filters', () => {
-    it('should build query with nested AND/OR filters', () => {
-      const query: QuerySchema = {
-        object: 'users',
-        filter: {
-          operator: 'and',
-          conditions: [
-            {
-              field: 'status',
-              operator: 'equals',
-              value: 'active',
-            },
-          ],
-          groups: [
-            {
-              operator: 'or',
-              conditions: [
-                {
-                  field: 'role',
-                  operator: 'equals',
-                  value: 'admin',
-                },
-                {
-                  field: 'role',
-                  operator: 'equals',
-                  value: 'moderator',
-                },
-              ],
-            },
-          ],
-        },
-      };
-
-      const ast = builder.build(query);
-
-      expect(ast.where).toBeDefined();
-      expect(ast.where?.condition.operator).toBe('and');
-      expect(ast.where?.condition.operands.length).toBeGreaterThan(0);
-    });
-  });
-});