@portel/photon-core 1.5.0 → 2.1.0

package/dist/rendering/field-renderers.js

@@ -0,0 +1,317 @@
+/**
+ * Field Renderers - Type-specific value rendering
+ *
+ * Provides specialized renderers for different field types:
+ * - Email (mailto link)
+ * - URL (clickable link)
+ * - Date (formatted)
+ * - Currency ($X.XX)
+ * - Boolean (checkmark)
+ * - Badge (status pill)
+ * - Code (syntax highlighted)
+ */
+/**
+ * Render a field value based on its type
+ */
+export function renderField(value, type, options) {
+    const { escapeHtml, locale = 'en-US', currency = 'USD', dateFormat = 'medium' } = options;
+    if (value === null || value === undefined) {
+        return '<span class="field-empty">—</span>';
+    }
+    switch (type) {
+        case 'email':
+            return renderEmail(value, escapeHtml);
+        case 'url':
+        case 'link':
+            return renderUrl(value, escapeHtml);
+        case 'date':
+            return renderDate(value, dateFormat, locale);
+        case 'currency':
+            return renderCurrency(value, currency, locale);
+        case 'boolean':
+            return renderBoolean(value);
+        case 'badge':
+            return renderBadge(value, escapeHtml);
+        case 'code':
+            return renderCode(value, escapeHtml);
+        case 'image':
+            return renderImage(value, escapeHtml);
+        case 'text':
+        default:
+            return escapeHtml(String(value));
+    }
+}
+/**
+ * Render email as mailto link
+ */
+export function renderEmail(value, escapeHtml) {
+    const email = String(value);
+    return `<a href="mailto:${escapeHtml(email)}" class="field-email">${escapeHtml(email)}</a>`;
+}
+/**
+ * Render URL as clickable link
+ */
+export function renderUrl(value, escapeHtml) {
+    const url = String(value);
+    // Add protocol if missing
+    const href = url.startsWith('http') ? url : `https://${url}`;
+    // Display shortened URL
+    const display = url.replace(/^https?:\/\//, '').replace(/\/$/, '');
+    return `<a href="${escapeHtml(href)}" target="_blank" rel="noopener" class="field-url">${escapeHtml(display)}</a>`;
+}
+/**
+ * Render date with formatting
+ */
+export function renderDate(value, format, locale) {
+    try {
+        const date = new Date(value);
+        if (isNaN(date.getTime())) {
+            return `<span class="field-date">${String(value)}</span>`;
+        }
+        if (format === 'relative') {
+            const diff = Date.now() - date.getTime();
+            const seconds = Math.floor(diff / 1000);
+            const minutes = Math.floor(seconds / 60);
+            const hours = Math.floor(minutes / 60);
+            const days = Math.floor(hours / 24);
+            let text;
+            if (days > 30) {
+                text = date.toLocaleDateString(locale);
+            }
+            else if (days > 0) {
+                text = `${days}d ago`;
+            }
+            else if (hours > 0) {
+                text = `${hours}h ago`;
+            }
+            else if (minutes > 0) {
+                text = `${minutes}m ago`;
+            }
+            else {
+                text = 'just now';
+            }
+            return `<span class="field-date" title="${date.toISOString()}">${text}</span>`;
+        }
+        const options = format === 'short'
+            ? { month: 'numeric', day: 'numeric', year: '2-digit' }
+            : format === 'long'
+                ? { month: 'long', day: 'numeric', year: 'numeric', hour: 'numeric', minute: '2-digit' }
+                : { month: 'short', day: 'numeric', year: 'numeric' };
+        return `<span class="field-date">${date.toLocaleDateString(locale, options)}</span>`;
+    }
+    catch {
+        return `<span class="field-date">${String(value)}</span>`;
+    }
+}
+/**
+ * Render number as currency
+ */
+export function renderCurrency(value, currency, locale) {
+    const num = typeof value === 'number' ? value : parseFloat(String(value));
+    if (isNaN(num)) {
+        return `<span class="field-currency">${String(value)}</span>`;
+    }
+    const formatted = new Intl.NumberFormat(locale, {
+        style: 'currency',
+        currency,
+    }).format(num);
+    return `<span class="field-currency">${formatted}</span>`;
+}
+/**
+ * Render boolean as checkmark
+ */
+export function renderBoolean(value) {
+    const bool = Boolean(value);
+    const icon = bool ? '✓' : '✗';
+    const className = bool ? 'field-boolean true' : 'field-boolean false';
+    return `<span class="${className}">${icon}</span>`;
+}
+/**
+ * Render value as status badge
+ */
+export function renderBadge(value, escapeHtml) {
+    const text = String(value);
+    const lower = text.toLowerCase();
+    let statusClass = '';
+    if (/active|success|complete|done|enabled|yes|true|approved/.test(lower)) {
+        statusClass = 'status-success';
+    }
+    else if (/inactive|error|failed|disabled|no|false|rejected|cancelled/.test(lower)) {
+        statusClass = 'status-error';
+    }
+    else if (/pending|warning|waiting|processing|review/.test(lower)) {
+        statusClass = 'status-warning';
+    }
+    else if (/draft|new|created/.test(lower)) {
+        statusClass = 'status-info';
+    }
+    return `<span class="field-badge ${statusClass}">${escapeHtml(text)}</span>`;
+}
+/**
+ * Render value as code
+ */
+export function renderCode(value, escapeHtml) {
+    const code = typeof value === 'object' ? JSON.stringify(value, null, 2) : String(value);
+    return `<code class="field-code">${escapeHtml(code)}</code>`;
+}
+/**
+ * Render value as image
+ */
+export function renderImage(value, escapeHtml) {
+    const url = String(value);
+    return `<img src="${escapeHtml(url)}" class="field-image" alt="" loading="lazy">`;
+}
+/**
+ * Generate CSS for field renderers
+ */
+export function generateFieldRendererCSS() {
+    return `
+/* Field Renderers */
+.field-empty {
+  color: var(--text-tertiary);
+}
+
+.field-email,
+.field-url {
+  color: var(--accent-color);
+  text-decoration: none;
+}
+
+.field-email:hover,
+.field-url:hover {
+  text-decoration: underline;
+}
+
+.field-date {
+  color: var(--text-secondary);
+}
+
+.field-currency {
+  font-variant-numeric: tabular-nums;
+  font-weight: 500;
+}
+
+.field-boolean {
+  font-weight: 600;
+}
+
+.field-boolean.true {
+  color: #22c55e;
+}
+
+.field-boolean.false {
+  color: #ef4444;
+}
+
+.field-badge {
+  display: inline-block;
+  padding: 2px 8px;
+  border-radius: 12px;
+  font-size: 0.75rem;
+  font-weight: 500;
+  text-transform: capitalize;
+  background: var(--bg-tertiary);
+  color: var(--text-primary);
+}
+
+.field-badge.status-success {
+  background: #dcfce7;
+  color: #166534;
+}
+
+.field-badge.status-error {
+  background: #fee2e2;
+  color: #991b1b;
+}
+
+.field-badge.status-warning {
+  background: #fef3c7;
+  color: #92400e;
+}
+
+.field-badge.status-info {
+  background: #dbeafe;
+  color: #1e40af;
+}
+
+.field-code {
+  font-family: var(--font-mono);
+  font-size: 0.875em;
+  padding: 2px 6px;
+  background: var(--bg-tertiary);
+  border-radius: 4px;
+}
+
+.field-image {
+  max-width: 100%;
+  max-height: 200px;
+  border-radius: 8px;
+  object-fit: cover;
+}
+`;
+}
+/**
+ * Generate JavaScript for field renderers (to embed in HTML)
+ */
+export function generateFieldRenderersJS() {
+    return `
+// Field Renderers
+
+function renderFieldByType(value, type) {
+  if (value === null || value === undefined) {
+    return '<span class="field-empty">—</span>';
+  }
+
+  switch (type) {
+    case 'email':
+      return '<a href="mailto:' + escapeHtml(value) + '" class="field-email">' + escapeHtml(value) + '</a>';
+
+    case 'url':
+    case 'link':
+      const href = String(value).startsWith('http') ? value : 'https://' + value;
+      const display = String(value).replace(/^https?:\\/\\//, '').replace(/\\/$/, '');
+      return '<a href="' + escapeHtml(href) + '" target="_blank" rel="noopener" class="field-url">' + escapeHtml(display) + '</a>';
+
+    case 'date':
+      try {
+        const date = new Date(value);
+        if (isNaN(date.getTime())) return escapeHtml(String(value));
+        return '<span class="field-date">' + date.toLocaleDateString() + '</span>';
+      } catch {
+        return escapeHtml(String(value));
+      }
+
+    case 'currency':
+      const num = typeof value === 'number' ? value : parseFloat(value);
+      if (isNaN(num)) return escapeHtml(String(value));
+      return '<span class="field-currency">$' + num.toFixed(2) + '</span>';
+
+    case 'boolean':
+      const bool = Boolean(value);
+      return '<span class="field-boolean ' + (bool ? 'true' : 'false') + '">' + (bool ? '✓' : '✗') + '</span>';
+
+    case 'badge':
+      const text = String(value);
+      const lower = text.toLowerCase();
+      let statusClass = '';
+      if (/active|success|complete|done|enabled|yes|true|approved/.test(lower)) statusClass = 'status-success';
+      else if (/inactive|error|failed|disabled|no|false|rejected|cancelled/.test(lower)) statusClass = 'status-error';
+      else if (/pending|warning|waiting|processing|review/.test(lower)) statusClass = 'status-warning';
+      else if (/draft|new|created/.test(lower)) statusClass = 'status-info';
+      return '<span class="field-badge ' + statusClass + '">' + escapeHtml(text) + '</span>';
+
+    case 'code':
+      const code = typeof value === 'object' ? JSON.stringify(value, null, 2) : String(value);
+      return '<code class="field-code">' + escapeHtml(code) + '</code>';
+
+    case 'image':
+      return '<img src="' + escapeHtml(String(value)) + '" class="field-image" alt="" loading="lazy">';
+
+    case 'text':
+    default:
+      return escapeHtml(String(value));
+  }
+}
+`;
+}
+//# sourceMappingURL=field-renderers.js.map

package/dist/rendering/field-renderers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-renderers.js","sourceRoot":"","sources":["../../src/rendering/field-renderers.ts"],"names":[],"mappings":"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"}

package/dist/rendering/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Smart Rendering Module
+ *
+ * iOS-inspired, React Admin-influenced rendering system that:
+ * - Convention over configuration - works beautifully with zero annotations
+ * - Smart field detection - guesses meaning from field names and types
+ * - Progressive customization - JSDoc annotations for fine-tuning
+ * - List-centric paradigm - everything renders as configurable list items
+ *
+ * Design System based on:
+ * - Material Design 3 tokens: https://m3.material.io/foundations/design-tokens
+ * - Apple HIG (8pt grid): https://developer.apple.com/design/human-interface-guidelines/layout
+ */
+export * from './field-analyzer.js';
+export * from './layout-selector.js';
+export * from './components.js';
+export * from './field-renderers.js';
+export * from './template-engine.js';
+export * from '../design-system/index.js';
+/**
+ * Generate all JavaScript code for embedding in HTML
+ */
+export declare function generateSmartRenderingJS(): string;
+/**
+ * Generate all CSS for embedding in HTML
+ */
+export declare function generateSmartRenderingCSS(): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/rendering/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rendering/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAS1C;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAmBjD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAOlD"}

package/dist/rendering/index.js

@@ -0,0 +1,60 @@
+/**
+ * Smart Rendering Module
+ *
+ * iOS-inspired, React Admin-influenced rendering system that:
+ * - Convention over configuration - works beautifully with zero annotations
+ * - Smart field detection - guesses meaning from field names and types
+ * - Progressive customization - JSDoc annotations for fine-tuning
+ * - List-centric paradigm - everything renders as configurable list items
+ *
+ * Design System based on:
+ * - Material Design 3 tokens: https://m3.material.io/foundations/design-tokens
+ * - Apple HIG (8pt grid): https://developer.apple.com/design/human-interface-guidelines/layout
+ */
+export * from './field-analyzer.js';
+export * from './layout-selector.js';
+export * from './components.js';
+export * from './field-renderers.js';
+export * from './template-engine.js';
+export * from '../design-system/index.js';
+import { generateFieldAnalyzerJS } from './field-analyzer.js';
+import { generateLayoutSelectorJS } from './layout-selector.js';
+import { generateComponentsJS, generateComponentCSS } from './components.js';
+import { generateFieldRenderersJS, generateFieldRendererCSS } from './field-renderers.js';
+import { generateTemplateEngineJS, generateTemplateEngineCSS } from './template-engine.js';
+import { generateDesignSystemCSS, generateDesignSystemJS } from '../design-system/index.js';
+/**
+ * Generate all JavaScript code for embedding in HTML
+ */
+export function generateSmartRenderingJS() {
+    return [
+        '// ==========================================================================',
+        '// Photon Design System + Smart Rendering',
+        '// Based on Material Design 3 + Apple HIG',
+        '// ==========================================================================',
+        '',
+        generateDesignSystemJS(),
+        '',
+        generateFieldAnalyzerJS(),
+        '',
+        generateLayoutSelectorJS(),
+        '',
+        generateFieldRenderersJS(),
+        '',
+        generateComponentsJS(),
+        '',
+        generateTemplateEngineJS(),
+    ].join('\n');
+}
+/**
+ * Generate all CSS for embedding in HTML
+ */
+export function generateSmartRenderingCSS() {
+    return [
+        generateDesignSystemCSS(),
+        generateComponentCSS(),
+        generateFieldRendererCSS(),
+        generateTemplateEngineCSS(),
+    ].join('\n');
+}
+//# sourceMappingURL=index.js.map

package/dist/rendering/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rendering/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAE1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAC3F,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAE5F;;GAEG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,+EAA+E;QAC/E,2CAA2C;QAC3C,2CAA2C;QAC3C,+EAA+E;QAC/E,EAAE;QACF,sBAAsB,EAAE;QACxB,EAAE;QACF,uBAAuB,EAAE;QACzB,EAAE;QACF,wBAAwB,EAAE;QAC1B,EAAE;QACF,wBAAwB,EAAE;QAC1B,EAAE;QACF,oBAAoB,EAAE;QACtB,EAAE;QACF,wBAAwB,EAAE;KAC3B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,uBAAuB,EAAE;QACzB,oBAAoB,EAAE;QACtB,wBAAwB,EAAE;QAC1B,yBAAyB,EAAE;KAC5B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/rendering/layout-selector.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Layout Selector - Auto-detect best layout for data
+ *
+ * Determines the optimal component/layout to render data based on:
+ * 1. Explicit @format annotation (highest priority)
+ * 2. Data shape (array vs object vs primitive)
+ * 3. Data content (has images -> grid, etc.)
+ */
+export type LayoutType = 'text' | 'card' | 'list' | 'grid' | 'tree' | 'kv' | 'chips' | 'table' | 'markdown' | 'mermaid' | 'code' | 'json' | 'html';
+export interface LayoutHints {
+    title?: string;
+    subtitle?: string;
+    icon?: string;
+    badge?: string;
+    detail?: string;
+    image?: string;
+    style?: string;
+    accessory?: string;
+    columns?: number;
+    fields?: string[];
+}
+/**
+ * Select the best layout type for given data
+ */
+export declare function selectLayout(data: any, format?: string, hints?: LayoutHints): LayoutType;
+/**
+ * Check if object has fields that look like actual images (not just icon characters)
+ * We need to verify the VALUE looks like an image URL, not just the field name
+ */
+export declare function hasImageFields(obj: object): boolean;
+/**
+ * Check if object is nested (has object/array values)
+ */
+export declare function isNested(obj: object, depth?: number): boolean;
+/**
+ * Check if string contains markdown syntax
+ */
+export declare function hasMarkdownSyntax(text: string): boolean;
+/**
+ * Parse layout hints from nested JSDoc syntax
+ * Example: {@title name, @subtitle email, @style inset}
+ */
+export declare function parseLayoutHints(hintsString: string): LayoutHints;
+/**
+ * Generate JavaScript code for layout selector (to embed in HTML)
+ */
+export declare function generateLayoutSelectorJS(): string;
+//# sourceMappingURL=layout-selector.d.ts.map

package/dist/rendering/layout-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-selector.d.ts","sourceRoot":"","sources":["../../src/rendering/layout-selector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,MAAM,GACN,MAAM,GACN,MAAM,GACN,MAAM,GACN,IAAI,GACJ,OAAO,GACP,OAAO,GACP,UAAU,GACV,SAAS,GACT,MAAM,GACN,MAAM,GACN,MAAM,CAAC;AAEX,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAoBD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,GAAG,EACT,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,WAAW,GAClB,UAAU,CAoFZ;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CA0BnD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAahE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAavD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAmCjE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAiIjD"}