@asteby/metacore-ui 2.0.1 → 2.1.0

package/dist/layout/addon-nav.d.ts

@@ -0,0 +1,64 @@
+import { type LucideIcon } from 'lucide-react';
+import type { NavCollapsibleItem } from './types';
+/**
+ * Generic, host-agnostic helpers that make ANY installed addon render as a
+ * first-class, polished sidebar module — with zero effort from the addon
+ * author. The whole metacore ecosystem inherits these defaults:
+ *
+ *   - icons resolve against the full Lucide set (no hand-maintained allowlist),
+ *     falling back to a neutral glyph so a nav entry is NEVER icon-less;
+ *   - untranslated namespaced i18n keys (`customers.nav.invoices`) degrade to a
+ *     humanized label ("Invoices") instead of leaking the raw key;
+ *   - an addon nav group becomes a single collapsible parent item (icon +
+ *     chevron, children indented) — the shape `<NavGroup>` renders as a
+ *     dropdown — so installed addons look like native modules.
+ */
+/** Neutral fallback icon for a group/module header that declares none. */
+export declare const FALLBACK_GROUP_ICON: LucideIcon;
+/** Neutral fallback icon for a child nav item that declares none. */
+export declare const FALLBACK_ITEM_ICON: LucideIcon;
+/**
+ * Resolve any icon name against the full Lucide icon set. Names match
+ * case-insensitively after normalising separators, so manifests may use
+ * `shopping-cart`, `shopping_cart`, or `ShoppingCart` interchangeably.
+ * Returns `fallback` for missing/unknown names so something always renders.
+ */
+export declare function resolveIconName(name?: string, fallback?: LucideIcon): LucideIcon;
+/**
+ * Humanize the last segment of a (possibly namespaced) i18n key:
+ *   `customers.nav.invoices` → "Invoices"
+ *   `sales_orders`           → "Sales Orders"
+ */
+export declare function humanizeNavKey(key: string): string;
+/**
+ * Translate a nav title with a generic safety net: run it through `t()`, and
+ * if the result is unchanged (key not found — common for a third-party addon
+ * whose i18n bundle hasn't loaded) AND it looks namespaced, fall back to the
+ * humanized last segment so the UI never shows a raw `a.b.c` key.
+ */
+export declare function translateNavTitle(title: string, t: (key: string) => string): string;
+/** Minimal shape of an addon-declared nav item (subset of the manifest type). */
+export interface AddonNavItemLike {
+    title: string;
+    icon?: string;
+    url?: string;
+    items?: AddonNavItemLike[];
+}
+/** Minimal shape of an addon-declared nav group (subset of the manifest type). */
+export interface AddonNavGroupLike {
+    title: string;
+    icon?: string;
+    items: AddonNavItemLike[];
+}
+/**
+ * Convert an addon nav group into a single collapsible parent item — the shape
+ * `<NavGroup>` renders as a dropdown (icon + chevron, indented children).
+ *
+ * `resolveUrl` maps an addon item to a host-routable URL (the host owns route
+ * layout / model→table resolution). Icons fall back to neutral defaults on both
+ * the parent and every child, so a bare third-party addon still looks polished.
+ * The parent's `url` points at its first child for active-state matching and
+ * for the collapsed (icon-only) dropdown trigger.
+ */
+export declare function addonGroupToCollapsibleItem(group: AddonNavGroupLike, resolveUrl: (item: AddonNavItemLike) => string): NavCollapsibleItem;
+//# sourceMappingURL=addon-nav.d.ts.map

package/dist/layout/addon-nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addon-nav.d.ts","sourceRoot":"","sources":["../../src/layout/addon-nav.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,KAAK,UAAU,EAAE,MAAM,cAAc,CAAA;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAe,MAAM,SAAS,CAAA;AAE9D;;;;;;;;;;;;GAYG;AAEH,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB,EAAE,UAAgB,CAAA;AAClD,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,EAAE,UAAmB,CAAA;AAIpD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,CAAC,EAAE,MAAM,EACb,QAAQ,GAAE,UAA+B,GACxC,UAAU,CAYZ;AAKD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASlD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GACzB,MAAM,CAKR;AAED,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAA;CAC3B;AAED,kFAAkF;AAClF,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,gBAAgB,EAAE,CAAA;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,iBAAiB,EACxB,UAAU,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,MAAM,GAC7C,kBAAkB,CAYpB"}

package/dist/layout/addon-nav.js

@@ -0,0 +1,95 @@
+import { Box, Circle, icons as lucideIcons } from 'lucide-react';
+/**
+ * Generic, host-agnostic helpers that make ANY installed addon render as a
+ * first-class, polished sidebar module — with zero effort from the addon
+ * author. The whole metacore ecosystem inherits these defaults:
+ *
+ *   - icons resolve against the full Lucide set (no hand-maintained allowlist),
+ *     falling back to a neutral glyph so a nav entry is NEVER icon-less;
+ *   - untranslated namespaced i18n keys (`customers.nav.invoices`) degrade to a
+ *     humanized label ("Invoices") instead of leaking the raw key;
+ *   - an addon nav group becomes a single collapsible parent item (icon +
+ *     chevron, children indented) — the shape `<NavGroup>` renders as a
+ *     dropdown — so installed addons look like native modules.
+ */
+/** Neutral fallback icon for a group/module header that declares none. */
+export const FALLBACK_GROUP_ICON = Box;
+/** Neutral fallback icon for a child nav item that declares none. */
+export const FALLBACK_ITEM_ICON = Circle;
+const ICONS = lucideIcons;
+/**
+ * Resolve any icon name against the full Lucide icon set. Names match
+ * case-insensitively after normalising separators, so manifests may use
+ * `shopping-cart`, `shopping_cart`, or `ShoppingCart` interchangeably.
+ * Returns `fallback` for missing/unknown names so something always renders.
+ */
+export function resolveIconName(name, fallback = FALLBACK_ITEM_ICON) {
+    if (!name)
+        return fallback;
+    const direct = ICONS[name];
+    if (direct)
+        return direct;
+    const pascal = name
+        .replace(/[\s_-]+/g, ' ')
+        .trim()
+        .split(' ')
+        .filter(Boolean)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join('');
+    return ICONS[pascal] ?? fallback;
+}
+/** Matches a namespaced i18n key like `customers.nav.invoices` (≥1 dot). */
+const NAMESPACED_KEY_RE = /^[a-z0-9_]+(\.[a-z0-9_]+)+$/i;
+/**
+ * Humanize the last segment of a (possibly namespaced) i18n key:
+ *   `customers.nav.invoices` → "Invoices"
+ *   `sales_orders`           → "Sales Orders"
+ */
+export function humanizeNavKey(key) {
+    const last = key.split('.').pop() ?? key;
+    return last
+        .replace(/[_-]+/g, ' ')
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(' ');
+}
+/**
+ * Translate a nav title with a generic safety net: run it through `t()`, and
+ * if the result is unchanged (key not found — common for a third-party addon
+ * whose i18n bundle hasn't loaded) AND it looks namespaced, fall back to the
+ * humanized last segment so the UI never shows a raw `a.b.c` key.
+ */
+export function translateNavTitle(title, t) {
+    const translated = t(title);
+    if (translated !== title)
+        return translated;
+    if (NAMESPACED_KEY_RE.test(title))
+        return humanizeNavKey(title);
+    return title;
+}
+/**
+ * Convert an addon nav group into a single collapsible parent item — the shape
+ * `<NavGroup>` renders as a dropdown (icon + chevron, indented children).
+ *
+ * `resolveUrl` maps an addon item to a host-routable URL (the host owns route
+ * layout / model→table resolution). Icons fall back to neutral defaults on both
+ * the parent and every child, so a bare third-party addon still looks polished.
+ * The parent's `url` points at its first child for active-state matching and
+ * for the collapsed (icon-only) dropdown trigger.
+ */
+export function addonGroupToCollapsibleItem(group, resolveUrl) {
+    const items = group.items.map((item) => ({
+        title: item.title,
+        url: resolveUrl(item),
+        icon: resolveIconName(item.icon, FALLBACK_ITEM_ICON),
+    }));
+    return {
+        title: group.title,
+        url: items[0]?.url ?? '#',
+        icon: resolveIconName(group.icon, FALLBACK_GROUP_ICON),
+        items,
+    };
+}
+//# sourceMappingURL=addon-nav.js.map

package/dist/layout/addon-nav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addon-nav.js","sourceRoot":"","sources":["../../src/layout/addon-nav.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI,WAAW,EAAmB,MAAM,cAAc,CAAA;AAGjF;;;;;;;;;;;;GAYG;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,mBAAmB,GAAe,GAAG,CAAA;AAClD,qEAAqE;AACrE,MAAM,CAAC,MAAM,kBAAkB,GAAe,MAAM,CAAA;AAEpD,MAAM,KAAK,GAAG,WAAyC,CAAA;AAEvD;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAa,EACb,WAAuB,kBAAkB;IAEzC,IAAI,CAAC,IAAI;QAAE,OAAO,QAAQ,CAAA;IAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;IAC1B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IACzB,MAAM,MAAM,GAAG,IAAI;SAChB,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,IAAI,EAAE;SACN,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClD,IAAI,CAAC,EAAE,CAAC,CAAA;IACX,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAA;AAClC,CAAC;AAED,4EAA4E;AAC5E,MAAM,iBAAiB,GAAG,8BAA8B,CAAA;AAExD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,GAAG,CAAA;IACxC,OAAO,IAAI;SACR,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,IAAI,EAAE;SACN,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClD,IAAI,CAAC,GAAG,CAAC,CAAA;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAa,EACb,CAA0B;IAE1B,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,CAAA;IAC3B,IAAI,UAAU,KAAK,KAAK;QAAE,OAAO,UAAU,CAAA;IAC3C,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,cAAc,CAAC,KAAK,CAAC,CAAA;IAC/D,OAAO,KAAK,CAAA;AACd,CAAC;AAiBD;;;;;;;;;GASG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAwB,EACxB,UAA8C;IAE9C,MAAM,KAAK,GAAkB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACtD,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC;QACrB,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,kBAAkB,CAAC;KACrD,CAAC,CAAC,CAAA;IACH,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,GAAG;QACzB,IAAI,EAAE,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,mBAAmB,CAAC;QACtD,KAAK;KACN,CAAA;AACH,CAAC"}

package/dist/layout/index.d.ts

@@ -5,5 +5,6 @@ export { NavUser } from './nav-user';
 export { NavGroup, type NavLinkComponent, type NavGroupProps } from './nav-group';
 export { TeamSwitcher } from './team-switcher';
 export { ProfileDropdown } from './profile-dropdown';
+export { resolveIconName, humanizeNavKey, translateNavTitle, addonGroupToCollapsibleItem, FALLBACK_GROUP_ICON, FALLBACK_ITEM_ICON, type AddonNavItemLike, type AddonNavGroupLike, } from './addon-nav';
 export type { NavItem, NavLinkItem, NavCollapsibleItem, NavGroupData, LayoutUser, } from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/layout/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,YAAY,EACV,OAAO,EACP,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,UAAU,GACX,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/layout/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,2BAA2B,EAC3B,mBAAmB,EACnB,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,OAAO,EACP,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,UAAU,GACX,MAAM,SAAS,CAAA"}

package/dist/layout/index.js

@@ -5,4 +5,5 @@ export { NavUser } from './nav-user';
 export { NavGroup } from './nav-group';
 export { TeamSwitcher } from './team-switcher';
 export { ProfileDropdown } from './profile-dropdown';
+export { resolveIconName, humanizeNavKey, translateNavTitle, addonGroupToCollapsibleItem, FALLBACK_GROUP_ICON, FALLBACK_ITEM_ICON, } from './addon-nav';
 //# sourceMappingURL=index.js.map

package/dist/layout/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/layout/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,OAAO,EAAE,QAAQ,EAA6C,MAAM,aAAa,CAAA;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/layout/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,OAAO,EAAE,QAAQ,EAA6C,MAAM,aAAa,CAAA;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,2BAA2B,EAC3B,mBAAmB,EACnB,kBAAkB,GAGnB,MAAM,aAAa,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/metacore-ui",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description": "Metacore UI kit — data-table, layout shell, command-menu, hooks y primitives shadcn reutilizables",
   "license": "Apache-2.0",
   "repository": {