@deneb-ui/ui 2.0.54 → 2.0.56

package/dist/PlatformAdditionalPages.d.ts

@@ -0,0 +1,52 @@
+/**
+ * PlatformAdditionalPages
+ * ────────────────────────
+ * Drop this component once inside your layout (or footer). It renders the
+ * `additionalPages` list with all the correct Fivora visual-editing markers
+ * so the editor can add, reorder, and rename pages via the control panel.
+ *
+ * WHY THIS EXISTS
+ * ───────────────
+ * The strict visual-editing contract requires:
+ *   - data-preview-list-path   on the container
+ *   - data-preview-item-path   on each <li>
+ *   - data-preview-field-path  on each editable field (label)
+ *   - data-preview-static      on navigation buttons (to cover the href)
+ *   - field-path items must NOT be inside a data-preview-static ancestor
+ *
+ * This exact nesting is non-obvious and easy to get wrong. Putting it here
+ * means every template gets it right with ONE import — no template should
+ * need to know these rules.
+ *
+ * USAGE (in layout.tsx or footer.tsx)
+ * ─────────────────────────────────────
+ *   import { PlatformAdditionalPages } from '@deneb-ui/ui';
+ *
+ *   // Inside your Footer or Layout (renders as a styled nav):
+ *   <PlatformAdditionalPages
+ *     basePath={basePath}
+ *     className="space-y-2.5 text-sm text-muted-foreground"
+ *     linkClassName="hover:text-primary transition-colors text-left bg-transparent border-0 p-0 cursor-pointer"
+ *   />
+ *
+ * The component is invisible when additionalPages is empty (default state).
+ * It only renders when the platform has assigned additional pages to this site.
+ */
+import React from 'react';
+export interface PlatformAdditionalPagesProps {
+    /** Base path prefix for navigation (e.g. from withBasePath). Defaults to ''. */
+    basePath?: string;
+    /** Optional className applied to the outer <ul> list container. */
+    className?: string;
+    /** Optional className applied to each navigation <button> element. */
+    linkClassName?: string;
+    /** Optional wrapper function for the route (e.g. withBasePath). */
+    resolveRoute?: (route: string) => string;
+}
+export declare function PlatformAdditionalPages({ basePath, className, linkClassName, resolveRoute, }: PlatformAdditionalPagesProps): React.JSX.Element | null;
+/**
+ * @deprecated Use PlatformAdditionalPages instead.
+ * Kept for backwards compatibility with templates that imported this under
+ * the older name before it was standardised.
+ */
+export declare const AdditionalPagesNav: typeof PlatformAdditionalPages;

package/dist/PlatformAdditionalPages.js

@@ -0,0 +1,37 @@
+"use strict";
+'use client';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdditionalPagesNav = void 0;
+exports.PlatformAdditionalPages = PlatformAdditionalPages;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const SiteDataProvider_1 = require("./SiteDataProvider");
+function PlatformAdditionalPages({ basePath = '', className = '', linkClassName = 'hover:text-primary transition-colors text-left bg-transparent border-0 p-0 cursor-pointer text-sm', resolveRoute, }) {
+    const siteData = (0, SiteDataProvider_1.useSiteData)();
+    const additionalPages = (0, SiteDataProvider_1.contentList)((0, SiteDataProvider_1.contentObject)(siteData.content).additionalPages);
+    if (additionalPages.length === 0)
+        return null;
+    function toHref(route) {
+        const r = (0, SiteDataProvider_1.contentText)(route) || '/';
+        if (resolveRoute)
+            return resolveRoute(r);
+        return `${basePath}${r}`.replace(/\/+/g, '/') || '/';
+    }
+    return ((0, jsx_runtime_1.jsx)("ul", { className: className, "data-preview-list-path": "additionalPages", children: additionalPages.map((page, index) => (
+        /*
+         * Marker nesting rules (enforced by strict contract):
+         *   - data-preview-item-path  } both on the <li> — item is also a concrete field
+         *   - data-preview-field-path }
+         *   - label span WRAPS the button so field-path is ABOVE data-preview-static
+         *   - button has data-preview-static to cover its onClick/href without
+         *     claiming the label text as a non-editable string
+         */
+        (0, jsx_runtime_1.jsx)("li", { "data-preview-item-path": `additionalPages[${index}]`, "data-preview-field-path": `additionalPages[${index}]`, children: (0, jsx_runtime_1.jsx)("span", { "data-preview-field-path": `additionalPages[${index}].label`, children: (0, jsx_runtime_1.jsx)("button", { type: "button", "data-preview-static": "Additional page navigation button", className: linkClassName, onClick: () => {
+                        window.location.href = toHref(page['route']);
+                    }, children: (0, SiteDataProvider_1.contentText)(page['label']) }) }) }, page['id'] != null ? String(page['id']) : index))) }));
+}
+/**
+ * @deprecated Use PlatformAdditionalPages instead.
+ * Kept for backwards compatibility with templates that imported this under
+ * the older name before it was standardised.
+ */
+exports.AdditionalPagesNav = PlatformAdditionalPages;

package/dist/index.d.ts

@@ -83,6 +83,7 @@ export { EditableAnnouncementBar as AnnouncementBar } from './EditableAnnounceme
 export { EditableCategoryPills as CategoryPills } from './EditableCategoryPills';
 export { EditableCartDrawer as CartDrawer } from './EditableCartDrawer';
 export { EditableFilterSidebar as FilterSidebar } from './EditableFilterSidebar';
+export { PlatformAdditionalPages, AdditionalPagesNav } from './PlatformAdditionalPages';
 /**
  * DENEB UI Framework Metadata
  * Developed by Chamika Gayashan & Induranga Kawishwara

package/dist/index.js

@@ -19,7 +19,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ContactForm = exports.FAQ = exports.Accordion = exports.Testimonials = exports.TestimonialSection = exports.TestimonialCard = exports.PricingCard = exports.ServiceCard = exports.GoogleFeedback = exports.CustomerReviews = exports.ProductDetail = exports.ProductGrid = exports.ProductCard = exports.List = exports.Box = exports.Section = exports.Grid = exports.Map = exports.Image = exports.Quote = exports.Badge = exports.Paragraph = exports.Heading = exports.Text = exports.Dialog = exports.Card = exports.Button = exports.collectStyleTargetsFromHtml = exports.validateStyleTree = exports.styleToCssVariables = exports.patchStyleByPath = exports.patchElementStyle = exports.STYLE_TYPE_ATTRIBUTE = exports.STYLE_TARGET_ATTRIBUTE = exports.DENEB_STYLE_PATCH_MESSAGE = exports.STYLE_PATCH_MESSAGE = exports.formatResponsiveFontSize = exports.resolveInstallableFont = exports.normalizeFontId = exports.lookupFontDefinition = exports.listFontsByCategory = exports.collectFontIdsFromSiteData = exports.buildGoogleFontsStylesheetUrl = exports.DENEB_GOOGLE_FONT_COUNT = exports.DENEB_FONT_REGISTRY = exports.useDenebFonts = exports.DENEB_FONTS_LINK_ID = exports.FontLoader = exports.DenebComponentStyles = exports.ResponsiveBaseStyles = void 0;
-exports.DENEB_AUTHOR = exports.DENEB_FRAMEWORK_VERSION = exports.DENEB_FRAMEWORK_NAME = exports.FilterSidebar = exports.CartDrawer = exports.CategoryPills = exports.AnnouncementBar = exports.HeroSplit = exports.Hero = exports.Footer = exports.Header = exports.Navbar = void 0;
+exports.DENEB_AUTHOR = exports.DENEB_FRAMEWORK_VERSION = exports.DENEB_FRAMEWORK_NAME = exports.AdditionalPagesNav = exports.PlatformAdditionalPages = exports.FilterSidebar = exports.CartDrawer = exports.CategoryPills = exports.AnnouncementBar = exports.HeroSplit = exports.Hero = exports.Footer = exports.Header = exports.Navbar = void 0;
 __exportStar(require("./PreviewField"), exports);
 __exportStar(require("./EditableText"), exports);
 __exportStar(require("./EditableImage"), exports);
@@ -162,6 +162,9 @@ var EditableCartDrawer_1 = require("./EditableCartDrawer");
 Object.defineProperty(exports, "CartDrawer", { enumerable: true, get: function () { return EditableCartDrawer_1.EditableCartDrawer; } });
 var EditableFilterSidebar_1 = require("./EditableFilterSidebar");
 Object.defineProperty(exports, "FilterSidebar", { enumerable: true, get: function () { return EditableFilterSidebar_1.EditableFilterSidebar; } });
+var PlatformAdditionalPages_1 = require("./PlatformAdditionalPages");
+Object.defineProperty(exports, "PlatformAdditionalPages", { enumerable: true, get: function () { return PlatformAdditionalPages_1.PlatformAdditionalPages; } });
+Object.defineProperty(exports, "AdditionalPagesNav", { enumerable: true, get: function () { return PlatformAdditionalPages_1.AdditionalPagesNav; } });
 /**
  * DENEB UI Framework Metadata
  * Developed by Chamika Gayashan & Induranga Kawishwara

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deneb-ui/ui",
-  "version": "2.0.54",
+  "version": "2.0.56",
   "description": "Visual-first React component library for editable commerce storefronts. Built for Next.js and Fivora.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -19,7 +19,8 @@
   "files": [
     "dist",
     "scripts",
-    "README.md"
+    "README.md",
+    "platform-contract.json"
   ],
   "scripts": {
     "build": "tsc",
@@ -49,7 +50,7 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@deneb-ui/core": "^2.0.54"
+    "@deneb-ui/core": "^2.0.56"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
@@ -59,5 +60,14 @@
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "typescript": "^5.0.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./platform-contract": "./platform-contract.json"
   }
 }

package/platform-contract.json

@@ -0,0 +1,39 @@
+{
+  "_comment": "Platform-managed field paths for Fivora templates. These are written by the Fivora platform (AI agent, site builder) and must NEVER require data-preview-field-path HTML markers. The CLI merges these into every template's controlOnlyPaths automatically — templates do not need to declare them.",
+  "version": 1,
+  "platformControlledPaths": [
+    "__fivoraIntake.tone",
+    "__fivoraIntake.outputLanguage",
+    "__fivoraIntake.businessSummary",
+    "__fivoraIntake.additionalBusinessDetails",
+    "__fivoraIntake.referenceWebsiteUrl",
+    "additionalPages[*].id",
+    "additionalPages[*].route",
+    "common.currency",
+    "common.whatsappNumber",
+    "common.whatsapp",
+    "common.email",
+    "common.address",
+    "common.contactNumber",
+    "common.openingHours",
+    "common.newsletterTitle",
+    "common.newsletterDescription",
+    "contact.contactNumber",
+    "contact.googleMapLink",
+    "contact.whatsapp",
+    "products[*].id",
+    "products[*].isAvailable",
+    "products[*].measurement",
+    "products[*].unit",
+    "testimonials[*].id",
+    "categories[*].slug"
+  ],
+  "platformSiteDataKeys": [
+    "__fivoraIntake",
+    "additionalPages"
+  ],
+  "forbiddenNextConfigKeys": [
+    "outputFileTracingRoot",
+    "experimental.outputFileTracingRoot"
+  ]
+}