@deneb-ui/cli 2.0.97 → 2.0.99

package/README.md

@@ -60,11 +60,20 @@ npm install -D @deneb-ui/cli
 | `deneb zip` | Create upload-ready `fivora-template.zip` |
 | `deneb doctor` | Environment, dependency, and export diagnostics |
 | `deneb add <component>` | Copy DENEB UI components into your project |
-| `deneb lab` | Launch local visual editing preview lab |
+| `deneb lab` | Launch the local visual editor, preview changes, and save them to the declared `siteDataFile` |
 | `deneb update` | Update `@deneb-ui/*` packages and synced components |
 
 Full reference: [deneb.fivora.site/docs/cli](https://deneb.fivora.site/docs/cli)
 
+### Local preview before upload
+
+Run `deneb lab .` in a template project, then paste the printed controller URL
+and token into **Developer Portal → Local Test Lab**. Content and style edits are
+applied to the preview immediately. Use **Save local** to persist the current
+editor state to the `siteDataFile` declared in `fivora-template.json`; the write
+stays on your machine and no template files are uploaded. Run **Test** after
+saving to perform the same local preflight checks used before packaging.
+
 ---
 
 ## What `deneb init` does (ARC)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deneb-ui/cli",
-  "version": "2.0.97",
+  "version": "2.0.99",
   "description": "Official DENEB CLI — scaffold, convert, validate, and package Fivora-ready storefront templates.",
   "bin": {
     "deneb": "bin/index.js",
@@ -49,7 +49,7 @@
   "license": "MIT",
   "dependencies": {
     "@babel/parser": "^7.28.0",
-    "@deneb-ui/core": "^2.0.97",
+    "@deneb-ui/core": "^2.0.99",
     "@octokit/rest": "^22.0.1",
     "adm-zip": "^0.6.0",
     "dotenv": "^17.4.2",

package/src/arc/__tests__/arc.test.cjs

@@ -12,7 +12,13 @@ const { scanProject, buildDependencyGraph } = require('../scanner.cjs');
 const { analyzeFile } = require('../semantic.cjs');
 const { planTransformations } = require('../planner.cjs');
 const { applyFilePlan } = require('../transformer.cjs');
-const { buildFieldPath, inferFieldName, isListActionCtaKey } = require('../field-paths.cjs');
+const {
+  buildFieldPath,
+  classifyFieldType,
+  inferFieldName,
+  isListActionCtaKey,
+} = require('../field-paths.cjs');
+const { normalizeFieldType } = require('../fivora-schema-authority.cjs');
 const { enrichSchemasFromContent } = require('../manifest.cjs');
 const { runDenebArc } = require('../index.cjs');
 const { parseSource } = require('../ast.cjs');
@@ -67,6 +73,16 @@ test('field-paths recognizes list action CTA keys', () => {
   assert.equal(isListActionCtaKey('features'), false);
 });
 
+test('price fields use numeric data while currency and formatted prices stay text', () => {
+  assert.equal(normalizeFieldType('price', 'price'), 'number');
+  assert.equal(normalizeFieldType('currency', 'currency'), 'text');
+  assert.equal(classifyFieldType('text', 1000, 'price'), 'number');
+  assert.equal(classifyFieldType('text', '1000', 'price'), 'number');
+  assert.equal(classifyFieldType('text', '1000.50', 'amount'), 'number');
+  assert.equal(classifyFieldType('text', 'Rs. 1,000', 'price'), 'text');
+  assert.equal(classifyFieldType('text', 'LKR 1000', 'price'), 'text');
+});
+
 test('manifest enrichSchemasFromContent registers list CTA and paired directions fields', () => {
   const sections = [
     {
@@ -447,10 +463,30 @@ test('static-array collections become list contracts without changing render log
   const products = home.fields.find((f) => f.key === 'products');
   assert.equal(products.type, 'list');
   assert.deepEqual(products.fields.map((f) => f.key).sort(), ['description', 'image', 'price', 'title']);
+  assert.equal(products.fields.find((field) => field.key === 'price').type, 'text');
   assert.equal(siteData.content.home.products.length, 3);
   assert.equal(siteData.content.home.products[0].title, 'Minimalist Smart Watch');
 });
 
+test('numeric catalog prices stay numbers in generated site data and editor schema', () => {
+  const dir = copyOf(STOREFRONT_FIXTURE);
+  const gridPath = path.join(dir, 'src', 'components', 'ProductGrid.tsx');
+  const grid = fs
+    .readFileSync(gridPath, 'utf8')
+    .replace(/price: '\$(\d+)\.00'/g, 'price: $1');
+  fs.writeFileSync(gridPath, grid, 'utf8');
+
+  silence(() => runDenebArc(dir, 'numeric-price-store', { telemetry: 'off' }));
+  const { manifest, siteData } = auditFivora(dir);
+  const home = manifest.editorSchema.sections.find((section) => section.id === 'home');
+  const products = home.fields.find((field) => field.key === 'products');
+  const price = products.fields.find((field) => field.key === 'price');
+
+  assert.equal(price.type, 'number');
+  assert.equal(siteData.content.home.products[0].price, 249);
+  assert.equal(typeof siteData.content.home.products[0].price, 'number');
+});
+
 test('collections holding component references still bind primitive item fields', () => {
   const dir = copyOf(STOREFRONT_FIXTURE);
   silence(() => runDenebArc(dir, 'acme-store', { telemetry: 'off' }));
@@ -3923,4 +3959,3 @@ test('ARC v3 Phase 18: formatBlockedExplanationTerminal renders actionable remed
 
 
 
-

package/src/arc/field-paths.cjs

@@ -181,7 +181,14 @@ function classifyFieldType(kind, value, fieldName = '') {
     /price|amount|rating|count|score|stars|qty|quantity|discount|fee|cost/i.test(name)
   ) {
     if (typeof value === 'string' && /\$|lkr|usd|rs\.?\s*\d/i.test(value)) return 'text';
-    return typeof value === 'number' ? 'number' : 'text';
+    if (typeof value === 'number') return 'number';
+    if (
+      typeof value === 'string' &&
+      /^[+-]?(?:\d+\.?\d*|\.\d+)$/.test(value.trim())
+    ) {
+      return 'number';
+    }
+    return 'text';
   }
   if (typeof value === 'boolean' || /enabled|visible|show|active/i.test(name)) return 'boolean';
   if (kind === 'textarea' || (typeof value === 'string' && (value.length > 70 || value.includes('\n')))) return 'textarea';

package/src/arc/fivora-schema-authority.cjs

@@ -25,8 +25,8 @@ const PLATFORM_ALLOWED_TYPES = new Set([
 ]);
 
 const TYPE_COERCION_MAP = {
-  currency: 'text', // In Fivora storefronts, prices with symbols (e.g. '$249' or 'LKR 5,000') must be text or number
-  price: 'text',
+  currency: 'text',
+  price: 'number',
   richtext: 'textarea',
   phone: 'tel',
   link: 'url',

package/src/arc/manifest.cjs

@@ -370,7 +370,12 @@ const PLATFORM_CONTROLLED_PATHS = new Set(
 );
 
 function slimListItems(items, itemFields) {
-  const keys = (itemFields || []).map((field) => field.key).filter(Boolean);
+  const fieldsByKey = new Map(
+    (itemFields || [])
+      .filter((field) => field?.key)
+      .map((field) => [field.key, field]),
+  );
+  const keys = [...fieldsByKey.keys()];
   if (!keys.length || !Array.isArray(items)) return items || [];
   return items.map((item) => {
     if (!item || typeof item !== 'object' || Array.isArray(item)) return item;
@@ -378,7 +383,14 @@ function slimListItems(items, itemFields) {
     for (const key of keys) {
       if (!(key in item)) continue;
       if (Array.isArray(item[key])) continue;
-      out[key] = item[key];
+      const field = fieldsByKey.get(key);
+      const value = item[key];
+      out[key] =
+        field?.type === 'number' &&
+        typeof value === 'string' &&
+        /^[+-]?(?:\d+\.?\d*|\.\d+)$/.test(value.trim())
+          ? Number(value)
+          : value;
     }
     return Object.keys(out).length ? out : item;
   });

package/src/arc/semantic.cjs

@@ -33,6 +33,7 @@ const { resolveImportSpecifier } = require('./scanner.cjs');
 const { resolvePublicAssetUrl } = require('./ir-builder.cjs');
 const { analyzeElementFragments } = require('./text-fragment-analyzer.cjs');
 const { BROAD_CONTENT_CONTAINERS } = require('./fivora-contract.cjs');
+const { classifyFieldType } = require('./field-paths.cjs');
 
 const TECHNICAL_TEXT_RE = /^(true|false|null|undefined|px|rem|em|auto|hidden|flex|grid|sr-only)$/i;
 const ARIA_ONLY_RE = /^(aria-|data-state|data-slot|data-orientation)/;
@@ -1105,6 +1106,21 @@ function analyzeFile(optionsOrFile, codeArg, profileArg) {
         const stringItems = arr.items.every((item) => item.type === 'string');
         const rootTagName = getJsxName(mapInfo.rootElement);
         const isChildCustomComponent = /^[A-Z]/.test(rootTagName);
+        const sampleItem = objectItems
+          ? arr.items.find((item) => item?.value && typeof item.value === 'object')?.value
+          : null;
+
+        // JSX text positions alone look like generic text, but commerce values
+        // such as a bare numeric `price` must remain numeric for catalog range
+        // filters, sorting, totals, and database persistence. Formatted values
+        // such as "$249" intentionally remain text for legacy templates.
+        if (sampleItem) {
+          for (const [key, role] of itemUsage) {
+            if (role !== 'text') continue;
+            const inferredRole = classifyFieldType('text', sampleItem[key], key);
+            if (inferredRole !== 'text') itemUsage.set(key, inferredRole);
+          }
+        }
 
         // If the map returns a custom child component (e.g. <ProductCard product={item} />),
         // derive item fields from the sample object items if direct JSX member usage was empty
@@ -1112,13 +1128,7 @@ function analyzeFile(optionsOrFile, codeArg, profileArg) {
           const sampleObj = arr.items[0].value;
           for (const key of Object.keys(sampleObj)) {
             if (/^(id|_id|key|slug)$/i.test(key)) continue;
-            const role = /image|photo|avatar|icon|thumb|img/i.test(key)
-              ? 'image'
-              : /price|cost|amount|count|rating|stars/i.test(key)
-                ? 'number'
-                : /url|link|href/i.test(key)
-                  ? 'url'
-                  : 'text';
+            const role = classifyFieldType('text', sampleObj[key], key);
             itemUsage.set(key, role);
           }
         }
@@ -1207,4 +1217,3 @@ module.exports = {
   isStaticSkipText,
   resolveChildText,
 };
-