@memberjunction/ng-dashboards 6.2.0-edge.3 → 6.2.0-edge.4

package/dist/DashboardBrowser/dashboard-library-filter.d.ts

@@ -0,0 +1,116 @@
+/**
+ * @fileoverview Pure logic for the Library page of the Dashboards app: the order of its dashboards,
+ * the list each rail item shows, the empty state of each list, the rail sections and their counts,
+ * the rail item ids, and the `lib` / `category` query params.
+ *
+ * Every Library filter and Uncategorized is a flat list; only a category opens as a folder. Counts
+ * follow the same rules as `mj-dashboard-browser`, so a rail badge equals the number of dashboard
+ * cards the browser shows when that item is clicked: only Config dashboards count, and a category
+ * or Uncategorized shows the dashboards whose effective category it is.
+ */
+import type { MJDashboardCategoryEntity, MJDashboardEntity } from '@memberjunction/core-entities';
+import type { MJLeftNavSection } from '@memberjunction/ng-ui-components';
+/** The Library filters, in rail order. */
+export declare const DASHBOARD_LIBRARY_FILTERS: readonly ["all", "mine", "shared", "favorites", "recent"];
+/** A Library filter in the Library rail. */
+export type DashboardLibraryFilter = (typeof DASHBOARD_LIBRARY_FILTERS)[number];
+/** True when `value` is one of the Library filters (exact, case-sensitive). */
+export declare function IsDashboardLibraryFilter(value: unknown): value is DashboardLibraryFilter;
+/** What the Library filters need to know about the current user. */
+export interface LibraryFilterContext {
+    CurrentUserId: string;
+    FavoriteIds: string[];
+    /** Recently opened dashboard ids, most recent first. */
+    RecentIds: string[];
+}
+/** Where the Library is: a Library filter, or (with the All filter) a category or Uncategorized. */
+export interface BrowseLocation {
+    Filter: DashboardLibraryFilter;
+    /** The selected category, UNCATEGORIZED_CATEGORY_ID for Uncategorized, or null for none. */
+    CategoryId: string | null;
+}
+/** The `category` value of the Uncategorized list: the dashboards in no category. */
+export declare const UNCATEGORIZED_CATEGORY_ID = "uncategorized";
+/** Category counts for the rail, keyed by the category's own id. */
+export interface CategoryCounts {
+    ByCategory: Map<string, number>;
+    Uncategorized: number;
+}
+/** The dashboards a Library filter keeps, in the order given. `recent` follows the recents order. */
+export declare function FilterDashboardsForLibrary(dashboards: MJDashboardEntity[], filter: DashboardLibraryFilter, ctx: LibraryFilterContext): MJDashboardEntity[];
+/** True for the dashboards `mj-dashboard-browser` shows: Config dashboards. */
+export declare function IsBrowsableDashboard(dashboard: MJDashboardEntity): boolean;
+/** For each Library filter, the number of dashboards the browser shows for it. */
+export declare function CountLibraryDashboards(dashboards: MJDashboardEntity[], ctx: LibraryFilterContext): Record<DashboardLibraryFilter, number>;
+/**
+ * The category a dashboard shows under. A dashboard in `effectiveCategoryMap` (a shared one) uses
+ * the mapped value, where null means the root; any other dashboard uses its own CategoryID.
+ */
+export declare function EffectiveCategoryId(dashboard: MJDashboardEntity, effectiveCategoryMap: Map<string, string | null>): string | null;
+/**
+ * The Library's default order: favorites first, then the dashboards the user opened, the most recent
+ * open first, then the rest. Within each group a dashboard opened more recently comes first;
+ * dashboards never opened follow, the most recently updated first, then by name. Returns a new array.
+ */
+export declare function OrderLibraryDashboards(dashboards: readonly MJDashboardEntity[], ctx: LibraryFilterContext): MJDashboardEntity[];
+/** True when a location shows one category's folder; every other location is a flat list. */
+export declare function IsCategoryFolderLocation(location: BrowseLocation): boolean;
+/**
+ * The dashboards the Library gives the browser for a location, in display order (see
+ * OrderLibraryDashboards; Recently opened keeps the order of the last opens). Uncategorized keeps the
+ * dashboards in no category. A category folder gets every dashboard: the browser shows the folder's own.
+ */
+export declare function VisibleLibraryDashboards(dashboards: readonly MJDashboardEntity[], location: BrowseLocation, ctx: LibraryFilterContext, effectiveCategoryMap: Map<string, string | null>): MJDashboardEntity[];
+/** What an empty flat Library list shows. */
+export interface LibraryEmptyStateText {
+    Icon: string;
+    Title: string;
+    Message: string;
+    /** True for the whole library: the browser shows its first-run welcome instead. */
+    Welcome: boolean;
+}
+/** The empty state of a flat Library list. */
+export declare function LibraryEmptyState(location: BrowseLocation): LibraryEmptyStateText;
+/**
+ * Counts the browsable dashboards directly in each category, and those at the root. A dashboard
+ * whose category is not in `categories` is not counted, as the browser cannot reach it.
+ */
+export declare function CountDashboardsByCategory(dashboards: MJDashboardEntity[], categories: MJDashboardCategoryEntity[], effectiveCategoryMap: Map<string, string | null>): CategoryCounts;
+/**
+ * The rail's two sections: Dashboards (one item per Library filter) and Categories (the category
+ * tree, then Uncategorized). A category whose parent is not in `categories` shows at the top level.
+ */
+export declare function BuildLibraryRailSections(counts: Record<DashboardLibraryFilter, number>, categories: MJDashboardCategoryEntity[], categoryCounts: Map<string, number>, uncategorizedCount: number): MJLeftNavSection[];
+/** The Library filter named by a `lib` query param; `all` for anything else. */
+export declare function ParseLibraryFilter(value: string | null | undefined): DashboardLibraryFilter;
+/**
+ * The location named by the `lib` and `category` query params, or null when they name none.
+ * A category wins over a Library filter, since a category is only shown under All.
+ */
+export declare function ResolveBrowseLocation(params: Record<string, string>): BrowseLocation | null;
+/** True when two locations have the same Library filter and the same category (or both none). */
+export declare function SameBrowseLocation(a: BrowseLocation, b: BrowseLocation): boolean;
+/** The `lib` and `category` query params for a location. All and the root write null. */
+export declare function LocationQueryParams(location: BrowseLocation): {
+    lib: DashboardLibraryFilter | null;
+    category: string | null;
+};
+/** The rail item id for a Library filter. */
+export declare function LibraryRailItemId(filter: DashboardLibraryFilter): string;
+/** The rail item id for a category. */
+export declare function CategoryRailItemId(categoryId: string): string;
+/** The location a rail item opens, or null for an id the rail never builds. */
+export declare function ParseRailItemId(id: string): BrowseLocation | null;
+/**
+ * The rail item to mark active: Uncategorized, or the selected category, written with the
+ * category's own id so the rail's exact id match finds it, else the Library filter.
+ */
+export declare function RailActiveItemId(location: BrowseLocation, categories: MJDashboardCategoryEntity[]): string;
+/** `expandedIds` with `id` added when missing, or removed when present. */
+export declare function ToggleExpandedId(expandedIds: string[], id: string): string[];
+/**
+ * `expandedIds` with every folder above `categoryId` expanded, so the rail shows that category.
+ * Returns `expandedIds` itself when nothing changes.
+ */
+export declare function WithExpandedAncestors(expandedIds: string[], categoryId: string | null, categories: MJDashboardCategoryEntity[]): string[];
+//# sourceMappingURL=dashboard-library-filter.d.ts.map

package/dist/DashboardBrowser/dashboard-library-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-library-filter.d.ts","sourceRoot":"","sources":["../../src/DashboardBrowser/dashboard-library-filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElG,OAAO,KAAK,EAAiB,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAExF,0CAA0C;AAC1C,eAAO,MAAM,yBAAyB,2DAA4D,CAAC;AAEnG,4CAA4C;AAC5C,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhF,+EAA+E;AAC/E,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,sBAAsB,CAExF;AAED,oEAAoE;AACpE,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,wDAAwD;IACxD,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,oGAAoG;AACpG,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,sBAAsB,CAAC;IAC/B,4FAA4F;IAC5F,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,qFAAqF;AACrF,eAAO,MAAM,yBAAyB,kBAAkB,CAAC;AAEzD,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;CACvB;AAcD,qGAAqG;AACrG,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,oBAAoB,GACxB,iBAAiB,EAAE,CAarB;AAiBD,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAE1E;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,GAAG,EAAE,oBAAoB,GACxB,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAIxC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAKjI;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,EAAE,GAAG,EAAE,oBAAoB,GAAG,iBAAiB,EAAE,CAO/H;AA6CD,6FAA6F;AAC7F,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAE1E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,SAAS,iBAAiB,EAAE,EACxC,QAAQ,EAAE,cAAc,EACxB,GAAG,EAAE,oBAAoB,EACzB,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAC/C,iBAAiB,EAAE,CAMrB;AAED,6CAA6C;AAC7C,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,OAAO,EAAE,OAAO,CAAC;CAClB;AAiBD,8CAA8C;AAC9C,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,qBAAqB,CAEjF;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,UAAU,EAAE,yBAAyB,EAAE,EACvC,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAC/C,cAAc,CAgBhB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC,EAC9C,UAAU,EAAE,yBAAyB,EAAE,EACvC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,kBAAkB,EAAE,MAAM,GACzB,gBAAgB,EAAE,CAYpB;AAOD,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,sBAAsB,CAE3F;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,cAAc,GAAG,IAAI,CAQ3F;AAED,iGAAiG;AACjG,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,cAAc,GAAG,OAAO,CAEhF;AAED,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG;IAAE,GAAG,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAK7H;AAED,6CAA6C;AAC7C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAExE;AAED,uCAAuC;AACvC,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAYjE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,yBAAyB,EAAE,GAAG,MAAM,CAS1G;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAE5E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EAAE,EACrB,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,UAAU,EAAE,yBAAyB,EAAE,GACtC,MAAM,EAAE,CAcV"}

package/dist/DashboardBrowser/dashboard-library-filter.js

@@ -0,0 +1,277 @@
+import { FilterByUUIDs, IndexByUUID, NormalizeUUID, UUIDsEqual } from '@memberjunction/global';
+/** The Library filters, in rail order. */
+export const DASHBOARD_LIBRARY_FILTERS = ['all', 'mine', 'shared', 'favorites', 'recent'];
+/** True when `value` is one of the Library filters (exact, case-sensitive). */
+export function IsDashboardLibraryFilter(value) {
+    return typeof value === 'string' && DASHBOARD_LIBRARY_FILTERS.includes(value);
+}
+/** The `category` value of the Uncategorized list: the dashboards in no category. */
+export const UNCATEGORIZED_CATEGORY_ID = 'uncategorized';
+const LIBRARY_RAIL_PREFIX = 'lib:';
+const CATEGORY_RAIL_PREFIX = 'cat:';
+const UNCATEGORIZED_RAIL_ID = 'cat:unc';
+const LIBRARY_ITEMS = [
+    ['all', 'All dashboards', 'fa-solid fa-layer-group'],
+    ['mine', 'My dashboards', 'fa-solid fa-user'],
+    ['shared', 'Shared with me', 'fa-solid fa-inbox'],
+    ['favorites', 'Favorites', 'fa-solid fa-star'],
+    ['recent', 'Recently opened', 'fa-solid fa-clock-rotate-left'],
+];
+/** The dashboards a Library filter keeps, in the order given. `recent` follows the recents order. */
+export function FilterDashboardsForLibrary(dashboards, filter, ctx) {
+    switch (filter) {
+        case 'mine':
+            return dashboards.filter(d => UUIDsEqual(d.UserID, ctx.CurrentUserId));
+        case 'shared':
+            return dashboards.filter(d => !UUIDsEqual(d.UserID, ctx.CurrentUserId));
+        case 'favorites':
+            return FilterByUUIDs(dashboards, ctx.FavoriteIds);
+        case 'recent':
+            return pickInOrder(dashboards, ctx.RecentIds);
+        default:
+            return dashboards;
+    }
+}
+/** The dashboards named by `ids`, in that order, each once. Unknown ids are skipped. */
+function pickInOrder(dashboards, ids) {
+    const byID = IndexByUUID(dashboards);
+    const picked = [];
+    const seen = new Set();
+    for (const id of ids) {
+        const hit = byID.Get(id);
+        if (hit && !seen.has(hit)) {
+            seen.add(hit);
+            picked.push(hit);
+        }
+    }
+    return picked;
+}
+/** True for the dashboards `mj-dashboard-browser` shows: Config dashboards. */
+export function IsBrowsableDashboard(dashboard) {
+    return dashboard.Type === 'Config';
+}
+/** For each Library filter, the number of dashboards the browser shows for it. */
+export function CountLibraryDashboards(dashboards, ctx) {
+    const browsable = dashboards.filter(IsBrowsableDashboard);
+    const count = (filter) => FilterDashboardsForLibrary(browsable, filter, ctx).length;
+    return { all: count('all'), mine: count('mine'), shared: count('shared'), favorites: count('favorites'), recent: count('recent') };
+}
+/**
+ * The category a dashboard shows under. A dashboard in `effectiveCategoryMap` (a shared one) uses
+ * the mapped value, where null means the root; any other dashboard uses its own CategoryID.
+ */
+export function EffectiveCategoryId(dashboard, effectiveCategoryMap) {
+    if (effectiveCategoryMap.has(dashboard.ID)) {
+        return effectiveCategoryMap.get(dashboard.ID) || null;
+    }
+    return dashboard.CategoryID || null;
+}
+/**
+ * The Library's default order: favorites first, then the dashboards the user opened, the most recent
+ * open first, then the rest. Within each group a dashboard opened more recently comes first;
+ * dashboards never opened follow, the most recently updated first, then by name. Returns a new array.
+ */
+export function OrderLibraryDashboards(dashboards, ctx) {
+    const favorites = new Set(ctx.FavoriteIds.map(id => NormalizeUUID(id)));
+    const ranks = recentRanks(ctx.RecentIds);
+    return dashboards
+        .map(dashboard => ({ dashboard, key: libraryOrderKey(dashboard, favorites, ranks) }))
+        .sort((a, b) => compareLibraryOrderKeys(a.key, b.key))
+        .map(entry => entry.dashboard);
+}
+function libraryOrderKey(dashboard, favorites, ranks) {
+    const id = NormalizeUUID(dashboard.ID);
+    return {
+        Favorite: favorites.has(id),
+        RecentRank: ranks.get(id) ?? Number.POSITIVE_INFINITY,
+        UpdatedAt: timeOf(dashboard.__mj_UpdatedAt),
+        Name: dashboard.Name ?? '',
+    };
+}
+function compareLibraryOrderKeys(a, b) {
+    if (a.Favorite !== b.Favorite)
+        return a.Favorite ? -1 : 1;
+    if (a.RecentRank !== b.RecentRank)
+        return a.RecentRank < b.RecentRank ? -1 : 1;
+    if (a.UpdatedAt !== b.UpdatedAt)
+        return b.UpdatedAt - a.UpdatedAt;
+    return a.Name.localeCompare(b.Name);
+}
+/** Each recent id's first position, keyed by the normalized id. */
+function recentRanks(recentIds) {
+    const ranks = new Map();
+    recentIds.forEach((id, index) => {
+        const key = NormalizeUUID(id);
+        if (!ranks.has(key))
+            ranks.set(key, index);
+    });
+    return ranks;
+}
+/** Milliseconds since the epoch, or 0 for a missing or invalid date. */
+function timeOf(value) {
+    const time = value ? new Date(value).getTime() : Number.NaN;
+    return Number.isNaN(time) ? 0 : time;
+}
+/** True when a location shows one category's folder; every other location is a flat list. */
+export function IsCategoryFolderLocation(location) {
+    return !!location.CategoryId && location.CategoryId !== UNCATEGORIZED_CATEGORY_ID;
+}
+/**
+ * The dashboards the Library gives the browser for a location, in display order (see
+ * OrderLibraryDashboards; Recently opened keeps the order of the last opens). Uncategorized keeps the
+ * dashboards in no category. A category folder gets every dashboard: the browser shows the folder's own.
+ */
+export function VisibleLibraryDashboards(dashboards, location, ctx, effectiveCategoryMap) {
+    const ordered = OrderLibraryDashboards(dashboards, ctx);
+    if (location.CategoryId === UNCATEGORIZED_CATEGORY_ID) {
+        return ordered.filter(d => !EffectiveCategoryId(d, effectiveCategoryMap));
+    }
+    return FilterDashboardsForLibrary(ordered, location.Filter, ctx);
+}
+const LIBRARY_EMPTY_STATES = {
+    all: { Icon: 'fa-solid fa-gauge-high', Title: 'Welcome to Dashboards', Message: '', Welcome: true },
+    mine: { Icon: 'fa-solid fa-user', Title: 'You have no dashboards yet', Message: 'Create one with New.', Welcome: false },
+    shared: { Icon: 'fa-solid fa-inbox', Title: 'Nothing shared with you yet', Message: 'Dashboards other people share with you appear here.', Welcome: false },
+    favorites: { Icon: 'fa-solid fa-star', Title: 'No favorites yet', Message: 'Star a dashboard to keep it here.', Welcome: false },
+    recent: { Icon: 'fa-solid fa-clock-rotate-left', Title: 'Nothing opened yet', Message: 'Open a dashboard and it appears here.', Welcome: false },
+};
+const UNCATEGORIZED_EMPTY_STATE = {
+    Icon: 'fa-solid fa-folder-open',
+    Title: 'No uncategorized dashboards',
+    Message: 'Every dashboard is in a category.',
+    Welcome: false,
+};
+/** The empty state of a flat Library list. */
+export function LibraryEmptyState(location) {
+    return location.CategoryId === UNCATEGORIZED_CATEGORY_ID ? UNCATEGORIZED_EMPTY_STATE : LIBRARY_EMPTY_STATES[location.Filter];
+}
+/**
+ * Counts the browsable dashboards directly in each category, and those at the root. A dashboard
+ * whose category is not in `categories` is not counted, as the browser cannot reach it.
+ */
+export function CountDashboardsByCategory(dashboards, categories, effectiveCategoryMap) {
+    const byCategory = new Map();
+    const categoriesByID = IndexByUUID(categories);
+    let uncategorized = 0;
+    for (const dashboard of dashboards.filter(IsBrowsableDashboard)) {
+        const categoryId = EffectiveCategoryId(dashboard, effectiveCategoryMap);
+        if (!categoryId) {
+            uncategorized++;
+            continue;
+        }
+        const category = categoriesByID.Get(categoryId);
+        if (category) {
+            byCategory.set(category.ID, (byCategory.get(category.ID) ?? 0) + 1);
+        }
+    }
+    return { ByCategory: byCategory, Uncategorized: uncategorized };
+}
+/**
+ * The rail's two sections: Dashboards (one item per Library filter) and Categories (the category
+ * tree, then Uncategorized). A category whose parent is not in `categories` shows at the top level.
+ */
+export function BuildLibraryRailSections(counts, categories, categoryCounts, uncategorizedCount) {
+    const library = LIBRARY_ITEMS.map(([key, label, icon]) => ({ id: LibraryRailItemId(key), label, icon, badge: counts[key] }));
+    const toItem = (c) => {
+        const children = categories.filter(k => k.ParentID != null && UUIDsEqual(k.ParentID, c.ID)).map(toItem);
+        return { id: CategoryRailItemId(c.ID), label: c.Name, icon: 'fa-solid fa-folder', badge: categoryCounts.get(c.ID) ?? 0, ...(children.length ? { children } : {}) };
+    };
+    const roots = categories.filter(c => isTopLevel(c, categories)).map(toItem);
+    roots.push({ id: UNCATEGORIZED_RAIL_ID, label: 'Uncategorized', icon: 'fa-solid fa-folder-open', badge: uncategorizedCount });
+    return [
+        { label: 'Dashboards', items: library },
+        { label: 'Categories', items: roots },
+    ];
+}
+/** True when a category has no parent, or its parent is not in `categories`. */
+function isTopLevel(category, categories) {
+    return category.ParentID == null || !categories.some(c => UUIDsEqual(c.ID, category.ParentID));
+}
+/** The Library filter named by a `lib` query param; `all` for anything else. */
+export function ParseLibraryFilter(value) {
+    return IsDashboardLibraryFilter(value) ? value : 'all';
+}
+/**
+ * The location named by the `lib` and `category` query params, or null when they name none.
+ * A category wins over a Library filter, since a category is only shown under All.
+ */
+export function ResolveBrowseLocation(params) {
+    if (params['category']) {
+        return { Filter: 'all', CategoryId: params['category'] };
+    }
+    if (params['lib']) {
+        return { Filter: ParseLibraryFilter(params['lib']), CategoryId: null };
+    }
+    return null;
+}
+/** True when two locations have the same Library filter and the same category (or both none). */
+export function SameBrowseLocation(a, b) {
+    return a.Filter === b.Filter && UUIDsEqual(a.CategoryId, b.CategoryId);
+}
+/** The `lib` and `category` query params for a location. All and the root write null. */
+export function LocationQueryParams(location) {
+    return {
+        lib: location.Filter === 'all' ? null : location.Filter,
+        category: location.CategoryId || null,
+    };
+}
+/** The rail item id for a Library filter. */
+export function LibraryRailItemId(filter) {
+    return `${LIBRARY_RAIL_PREFIX}${filter}`;
+}
+/** The rail item id for a category. */
+export function CategoryRailItemId(categoryId) {
+    return `${CATEGORY_RAIL_PREFIX}${categoryId}`;
+}
+/** The location a rail item opens, or null for an id the rail never builds. */
+export function ParseRailItemId(id) {
+    if (id === UNCATEGORIZED_RAIL_ID) {
+        return { Filter: 'all', CategoryId: UNCATEGORIZED_CATEGORY_ID };
+    }
+    if (id.startsWith(CATEGORY_RAIL_PREFIX)) {
+        return { Filter: 'all', CategoryId: id.slice(CATEGORY_RAIL_PREFIX.length) };
+    }
+    if (id.startsWith(LIBRARY_RAIL_PREFIX)) {
+        const filter = id.slice(LIBRARY_RAIL_PREFIX.length);
+        return IsDashboardLibraryFilter(filter) ? { Filter: filter, CategoryId: null } : null;
+    }
+    return null;
+}
+/**
+ * The rail item to mark active: Uncategorized, or the selected category, written with the
+ * category's own id so the rail's exact id match finds it, else the Library filter.
+ */
+export function RailActiveItemId(location, categories) {
+    if (location.CategoryId === UNCATEGORIZED_CATEGORY_ID) {
+        return UNCATEGORIZED_RAIL_ID;
+    }
+    if (!location.CategoryId) {
+        return LibraryRailItemId(location.Filter);
+    }
+    const category = categories.find(c => UUIDsEqual(c.ID, location.CategoryId));
+    return CategoryRailItemId(category?.ID ?? location.CategoryId);
+}
+/** `expandedIds` with `id` added when missing, or removed when present. */
+export function ToggleExpandedId(expandedIds, id) {
+    return expandedIds.includes(id) ? expandedIds.filter(x => x !== id) : [...expandedIds, id];
+}
+/**
+ * `expandedIds` with every folder above `categoryId` expanded, so the rail shows that category.
+ * Returns `expandedIds` itself when nothing changes.
+ */
+export function WithExpandedAncestors(expandedIds, categoryId, categories) {
+    const missing = [];
+    const seen = new Set();
+    let current = categoryId ? categories.find(c => UUIDsEqual(c.ID, categoryId)) : undefined;
+    while (current?.ParentID && !seen.has(current)) {
+        seen.add(current);
+        const parentId = current.ParentID;
+        const parent = categories.find(c => UUIDsEqual(c.ID, parentId));
+        if (parent && !expandedIds.includes(CategoryRailItemId(parent.ID))) {
+            missing.unshift(CategoryRailItemId(parent.ID));
+        }
+        current = parent;
+    }
+    return missing.length ? [...expandedIds, ...missing] : expandedIds;
+}
+//# sourceMappingURL=dashboard-library-filter.js.map

package/dist/DashboardBrowser/dashboard-library-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-library-filter.js","sourceRoot":"","sources":["../../src/DashboardBrowser/dashboard-library-filter.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview Pure logic for the Library page of the Dashboards app: the order of its dashboards,\n * the list each rail item shows, the empty state of each list, the rail sections and their counts,\n * the rail item ids, and the `lib` / `category` query params.\n *\n * Every Library filter and Uncategorized is a flat list; only a category opens as a folder. Counts\n * follow the same rules as `mj-dashboard-browser`, so a rail badge equals the number of dashboard\n * cards the browser shows when that item is clicked: only Config dashboards count, and a category\n * or Uncategorized shows the dashboards whose effective category it is.\n */\nimport type { MJDashboardCategoryEntity, MJDashboardEntity } from '@memberjunction/core-entities';\nimport { FilterByUUIDs, IndexByUUID, NormalizeUUID, UUIDsEqual } from '@memberjunction/global';\nimport type { MJLeftNavItem, MJLeftNavSection } from '@memberjunction/ng-ui-components';\n\n/** The Library filters, in rail order. */\nexport const DASHBOARD_LIBRARY_FILTERS = ['all', 'mine', 'shared', 'favorites', 'recent'] as const;\n\n/** A Library filter in the Library rail. */\nexport type DashboardLibraryFilter = (typeof DASHBOARD_LIBRARY_FILTERS)[number];\n\n/** True when `value` is one of the Library filters (exact, case-sensitive). */\nexport function IsDashboardLibraryFilter(value: unknown): value is DashboardLibraryFilter {\n  return typeof value === 'string' && (DASHBOARD_LIBRARY_FILTERS as readonly string[]).includes(value);\n}\n\n/** What the Library filters need to know about the current user. */\nexport interface LibraryFilterContext {\n  CurrentUserId: string;\n  FavoriteIds: string[];\n  /** Recently opened dashboard ids, most recent first. */\n  RecentIds: string[];\n}\n\n/** Where the Library is: a Library filter, or (with the All filter) a category or Uncategorized. */\nexport interface BrowseLocation {\n  Filter: DashboardLibraryFilter;\n  /** The selected category, UNCATEGORIZED_CATEGORY_ID for Uncategorized, or null for none. */\n  CategoryId: string | null;\n}\n\n/** The `category` value of the Uncategorized list: the dashboards in no category. */\nexport const UNCATEGORIZED_CATEGORY_ID = 'uncategorized';\n\n/** Category counts for the rail, keyed by the category's own id. */\nexport interface CategoryCounts {\n  ByCategory: Map<string, number>;\n  Uncategorized: number;\n}\n\nconst LIBRARY_RAIL_PREFIX = 'lib:';\nconst CATEGORY_RAIL_PREFIX = 'cat:';\nconst UNCATEGORIZED_RAIL_ID = 'cat:unc';\n\nconst LIBRARY_ITEMS: Array<[DashboardLibraryFilter, string, string]> = [\n  ['all', 'All dashboards', 'fa-solid fa-layer-group'],\n  ['mine', 'My dashboards', 'fa-solid fa-user'],\n  ['shared', 'Shared with me', 'fa-solid fa-inbox'],\n  ['favorites', 'Favorites', 'fa-solid fa-star'],\n  ['recent', 'Recently opened', 'fa-solid fa-clock-rotate-left'],\n];\n\n/** The dashboards a Library filter keeps, in the order given. `recent` follows the recents order. */\nexport function FilterDashboardsForLibrary(\n  dashboards: MJDashboardEntity[],\n  filter: DashboardLibraryFilter,\n  ctx: LibraryFilterContext\n): MJDashboardEntity[] {\n  switch (filter) {\n    case 'mine':\n      return dashboards.filter(d => UUIDsEqual(d.UserID, ctx.CurrentUserId));\n    case 'shared':\n      return dashboards.filter(d => !UUIDsEqual(d.UserID, ctx.CurrentUserId));\n    case 'favorites':\n      return FilterByUUIDs(dashboards, ctx.FavoriteIds);\n    case 'recent':\n      return pickInOrder(dashboards, ctx.RecentIds);\n    default:\n      return dashboards;\n  }\n}\n\n/** The dashboards named by `ids`, in that order, each once. Unknown ids are skipped. */\nfunction pickInOrder(dashboards: MJDashboardEntity[], ids: string[]): MJDashboardEntity[] {\n  const byID = IndexByUUID(dashboards);\n  const picked: MJDashboardEntity[] = [];\n  const seen = new Set<MJDashboardEntity>();\n  for (const id of ids) {\n    const hit = byID.Get(id);\n    if (hit && !seen.has(hit)) {\n      seen.add(hit);\n      picked.push(hit);\n    }\n  }\n  return picked;\n}\n\n/** True for the dashboards `mj-dashboard-browser` shows: Config dashboards. */\nexport function IsBrowsableDashboard(dashboard: MJDashboardEntity): boolean {\n  return dashboard.Type === 'Config';\n}\n\n/** For each Library filter, the number of dashboards the browser shows for it. */\nexport function CountLibraryDashboards(\n  dashboards: MJDashboardEntity[],\n  ctx: LibraryFilterContext\n): Record<DashboardLibraryFilter, number> {\n  const browsable = dashboards.filter(IsBrowsableDashboard);\n  const count = (filter: DashboardLibraryFilter): number => FilterDashboardsForLibrary(browsable, filter, ctx).length;\n  return { all: count('all'), mine: count('mine'), shared: count('shared'), favorites: count('favorites'), recent: count('recent') };\n}\n\n/**\n * The category a dashboard shows under. A dashboard in `effectiveCategoryMap` (a shared one) uses\n * the mapped value, where null means the root; any other dashboard uses its own CategoryID.\n */\nexport function EffectiveCategoryId(dashboard: MJDashboardEntity, effectiveCategoryMap: Map<string, string | null>): string | null {\n  if (effectiveCategoryMap.has(dashboard.ID)) {\n    return effectiveCategoryMap.get(dashboard.ID) || null;\n  }\n  return dashboard.CategoryID || null;\n}\n\n/**\n * The Library's default order: favorites first, then the dashboards the user opened, the most recent\n * open first, then the rest. Within each group a dashboard opened more recently comes first;\n * dashboards never opened follow, the most recently updated first, then by name. Returns a new array.\n */\nexport function OrderLibraryDashboards(dashboards: readonly MJDashboardEntity[], ctx: LibraryFilterContext): MJDashboardEntity[] {\n  const favorites = new Set(ctx.FavoriteIds.map(id => NormalizeUUID(id)));\n  const ranks = recentRanks(ctx.RecentIds);\n  return dashboards\n    .map(dashboard => ({ dashboard, key: libraryOrderKey(dashboard, favorites, ranks) }))\n    .sort((a, b) => compareLibraryOrderKeys(a.key, b.key))\n    .map(entry => entry.dashboard);\n}\n\n/** What the Library sorts a dashboard by. */\ninterface LibraryOrderKey {\n  Favorite: boolean;\n  /** Position in the recents (0 = opened last); Infinity when never opened. */\n  RecentRank: number;\n  /** Last update in ms since the epoch; 0 when unknown. */\n  UpdatedAt: number;\n  Name: string;\n}\n\nfunction libraryOrderKey(dashboard: MJDashboardEntity, favorites: ReadonlySet<string>, ranks: ReadonlyMap<string, number>): LibraryOrderKey {\n  const id = NormalizeUUID(dashboard.ID);\n  return {\n    Favorite: favorites.has(id),\n    RecentRank: ranks.get(id) ?? Number.POSITIVE_INFINITY,\n    UpdatedAt: timeOf(dashboard.__mj_UpdatedAt),\n    Name: dashboard.Name ?? '',\n  };\n}\n\nfunction compareLibraryOrderKeys(a: LibraryOrderKey, b: LibraryOrderKey): number {\n  if (a.Favorite !== b.Favorite) return a.Favorite ? -1 : 1;\n  if (a.RecentRank !== b.RecentRank) return a.RecentRank < b.RecentRank ? -1 : 1;\n  if (a.UpdatedAt !== b.UpdatedAt) return b.UpdatedAt - a.UpdatedAt;\n  return a.Name.localeCompare(b.Name);\n}\n\n/** Each recent id's first position, keyed by the normalized id. */\nfunction recentRanks(recentIds: readonly string[]): Map<string, number> {\n  const ranks = new Map<string, number>();\n  recentIds.forEach((id, index) => {\n    const key = NormalizeUUID(id);\n    if (!ranks.has(key)) ranks.set(key, index);\n  });\n  return ranks;\n}\n\n/** Milliseconds since the epoch, or 0 for a missing or invalid date. */\nfunction timeOf(value: Date | null | undefined): number {\n  const time = value ? new Date(value).getTime() : Number.NaN;\n  return Number.isNaN(time) ? 0 : time;\n}\n\n/** True when a location shows one category's folder; every other location is a flat list. */\nexport function IsCategoryFolderLocation(location: BrowseLocation): boolean {\n  return !!location.CategoryId && location.CategoryId !== UNCATEGORIZED_CATEGORY_ID;\n}\n\n/**\n * The dashboards the Library gives the browser for a location, in display order (see\n * OrderLibraryDashboards; Recently opened keeps the order of the last opens). Uncategorized keeps the\n * dashboards in no category. A category folder gets every dashboard: the browser shows the folder's own.\n */\nexport function VisibleLibraryDashboards(\n  dashboards: readonly MJDashboardEntity[],\n  location: BrowseLocation,\n  ctx: LibraryFilterContext,\n  effectiveCategoryMap: Map<string, string | null>\n): MJDashboardEntity[] {\n  const ordered = OrderLibraryDashboards(dashboards, ctx);\n  if (location.CategoryId === UNCATEGORIZED_CATEGORY_ID) {\n    return ordered.filter(d => !EffectiveCategoryId(d, effectiveCategoryMap));\n  }\n  return FilterDashboardsForLibrary(ordered, location.Filter, ctx);\n}\n\n/** What an empty flat Library list shows. */\nexport interface LibraryEmptyStateText {\n  Icon: string;\n  Title: string;\n  Message: string;\n  /** True for the whole library: the browser shows its first-run welcome instead. */\n  Welcome: boolean;\n}\n\nconst LIBRARY_EMPTY_STATES: Record<DashboardLibraryFilter, LibraryEmptyStateText> = {\n  all: { Icon: 'fa-solid fa-gauge-high', Title: 'Welcome to Dashboards', Message: '', Welcome: true },\n  mine: { Icon: 'fa-solid fa-user', Title: 'You have no dashboards yet', Message: 'Create one with New.', Welcome: false },\n  shared: { Icon: 'fa-solid fa-inbox', Title: 'Nothing shared with you yet', Message: 'Dashboards other people share with you appear here.', Welcome: false },\n  favorites: { Icon: 'fa-solid fa-star', Title: 'No favorites yet', Message: 'Star a dashboard to keep it here.', Welcome: false },\n  recent: { Icon: 'fa-solid fa-clock-rotate-left', Title: 'Nothing opened yet', Message: 'Open a dashboard and it appears here.', Welcome: false },\n};\n\nconst UNCATEGORIZED_EMPTY_STATE: LibraryEmptyStateText = {\n  Icon: 'fa-solid fa-folder-open',\n  Title: 'No uncategorized dashboards',\n  Message: 'Every dashboard is in a category.',\n  Welcome: false,\n};\n\n/** The empty state of a flat Library list. */\nexport function LibraryEmptyState(location: BrowseLocation): LibraryEmptyStateText {\n  return location.CategoryId === UNCATEGORIZED_CATEGORY_ID ? UNCATEGORIZED_EMPTY_STATE : LIBRARY_EMPTY_STATES[location.Filter];\n}\n\n/**\n * Counts the browsable dashboards directly in each category, and those at the root. A dashboard\n * whose category is not in `categories` is not counted, as the browser cannot reach it.\n */\nexport function CountDashboardsByCategory(\n  dashboards: MJDashboardEntity[],\n  categories: MJDashboardCategoryEntity[],\n  effectiveCategoryMap: Map<string, string | null>\n): CategoryCounts {\n  const byCategory = new Map<string, number>();\n  const categoriesByID = IndexByUUID(categories);\n  let uncategorized = 0;\n  for (const dashboard of dashboards.filter(IsBrowsableDashboard)) {\n    const categoryId = EffectiveCategoryId(dashboard, effectiveCategoryMap);\n    if (!categoryId) {\n      uncategorized++;\n      continue;\n    }\n    const category = categoriesByID.Get(categoryId);\n    if (category) {\n      byCategory.set(category.ID, (byCategory.get(category.ID) ?? 0) + 1);\n    }\n  }\n  return { ByCategory: byCategory, Uncategorized: uncategorized };\n}\n\n/**\n * The rail's two sections: Dashboards (one item per Library filter) and Categories (the category\n * tree, then Uncategorized). A category whose parent is not in `categories` shows at the top level.\n */\nexport function BuildLibraryRailSections(\n  counts: Record<DashboardLibraryFilter, number>,\n  categories: MJDashboardCategoryEntity[],\n  categoryCounts: Map<string, number>,\n  uncategorizedCount: number\n): MJLeftNavSection[] {\n  const library: MJLeftNavItem[] = LIBRARY_ITEMS.map(([key, label, icon]) => ({ id: LibraryRailItemId(key), label, icon, badge: counts[key] }));\n  const toItem = (c: MJDashboardCategoryEntity): MJLeftNavItem => {\n    const children = categories.filter(k => k.ParentID != null && UUIDsEqual(k.ParentID, c.ID)).map(toItem);\n    return { id: CategoryRailItemId(c.ID), label: c.Name, icon: 'fa-solid fa-folder', badge: categoryCounts.get(c.ID) ?? 0, ...(children.length ? { children } : {}) };\n  };\n  const roots = categories.filter(c => isTopLevel(c, categories)).map(toItem);\n  roots.push({ id: UNCATEGORIZED_RAIL_ID, label: 'Uncategorized', icon: 'fa-solid fa-folder-open', badge: uncategorizedCount });\n  return [\n    { label: 'Dashboards', items: library },\n    { label: 'Categories', items: roots },\n  ];\n}\n\n/** True when a category has no parent, or its parent is not in `categories`. */\nfunction isTopLevel(category: MJDashboardCategoryEntity, categories: MJDashboardCategoryEntity[]): boolean {\n  return category.ParentID == null || !categories.some(c => UUIDsEqual(c.ID, category.ParentID));\n}\n\n/** The Library filter named by a `lib` query param; `all` for anything else. */\nexport function ParseLibraryFilter(value: string | null | undefined): DashboardLibraryFilter {\n  return IsDashboardLibraryFilter(value) ? value : 'all';\n}\n\n/**\n * The location named by the `lib` and `category` query params, or null when they name none.\n * A category wins over a Library filter, since a category is only shown under All.\n */\nexport function ResolveBrowseLocation(params: Record<string, string>): BrowseLocation | null {\n  if (params['category']) {\n    return { Filter: 'all', CategoryId: params['category'] };\n  }\n  if (params['lib']) {\n    return { Filter: ParseLibraryFilter(params['lib']), CategoryId: null };\n  }\n  return null;\n}\n\n/** True when two locations have the same Library filter and the same category (or both none). */\nexport function SameBrowseLocation(a: BrowseLocation, b: BrowseLocation): boolean {\n  return a.Filter === b.Filter && UUIDsEqual(a.CategoryId, b.CategoryId);\n}\n\n/** The `lib` and `category` query params for a location. All and the root write null. */\nexport function LocationQueryParams(location: BrowseLocation): { lib: DashboardLibraryFilter | null; category: string | null } {\n  return {\n    lib: location.Filter === 'all' ? null : location.Filter,\n    category: location.CategoryId || null,\n  };\n}\n\n/** The rail item id for a Library filter. */\nexport function LibraryRailItemId(filter: DashboardLibraryFilter): string {\n  return `${LIBRARY_RAIL_PREFIX}${filter}`;\n}\n\n/** The rail item id for a category. */\nexport function CategoryRailItemId(categoryId: string): string {\n  return `${CATEGORY_RAIL_PREFIX}${categoryId}`;\n}\n\n/** The location a rail item opens, or null for an id the rail never builds. */\nexport function ParseRailItemId(id: string): BrowseLocation | null {\n  if (id === UNCATEGORIZED_RAIL_ID) {\n    return { Filter: 'all', CategoryId: UNCATEGORIZED_CATEGORY_ID };\n  }\n  if (id.startsWith(CATEGORY_RAIL_PREFIX)) {\n    return { Filter: 'all', CategoryId: id.slice(CATEGORY_RAIL_PREFIX.length) };\n  }\n  if (id.startsWith(LIBRARY_RAIL_PREFIX)) {\n    const filter = id.slice(LIBRARY_RAIL_PREFIX.length);\n    return IsDashboardLibraryFilter(filter) ? { Filter: filter, CategoryId: null } : null;\n  }\n  return null;\n}\n\n/**\n * The rail item to mark active: Uncategorized, or the selected category, written with the\n * category's own id so the rail's exact id match finds it, else the Library filter.\n */\nexport function RailActiveItemId(location: BrowseLocation, categories: MJDashboardCategoryEntity[]): string {\n  if (location.CategoryId === UNCATEGORIZED_CATEGORY_ID) {\n    return UNCATEGORIZED_RAIL_ID;\n  }\n  if (!location.CategoryId) {\n    return LibraryRailItemId(location.Filter);\n  }\n  const category = categories.find(c => UUIDsEqual(c.ID, location.CategoryId));\n  return CategoryRailItemId(category?.ID ?? location.CategoryId);\n}\n\n/** `expandedIds` with `id` added when missing, or removed when present. */\nexport function ToggleExpandedId(expandedIds: string[], id: string): string[] {\n  return expandedIds.includes(id) ? expandedIds.filter(x => x !== id) : [...expandedIds, id];\n}\n\n/**\n * `expandedIds` with every folder above `categoryId` expanded, so the rail shows that category.\n * Returns `expandedIds` itself when nothing changes.\n */\nexport function WithExpandedAncestors(\n  expandedIds: string[],\n  categoryId: string | null,\n  categories: MJDashboardCategoryEntity[]\n): string[] {\n  const missing: string[] = [];\n  const seen = new Set<MJDashboardCategoryEntity>();\n  let current = categoryId ? categories.find(c => UUIDsEqual(c.ID, categoryId)) : undefined;\n  while (current?.ParentID && !seen.has(current)) {\n    seen.add(current);\n    const parentId = current.ParentID;\n    const parent = categories.find(c => UUIDsEqual(c.ID, parentId));\n    if (parent && !expandedIds.includes(CategoryRailItemId(parent.ID))) {\n      missing.unshift(CategoryRailItemId(parent.ID));\n    }\n    current = parent;\n  }\n  return missing.length ? [...expandedIds, ...missing] : expandedIds;\n}\n"]}

package/dist/DashboardBrowser/dashboard-share-dialog.component.d.ts

@@ -6,7 +6,7 @@ import { DashboardShareAdapter } from './dashboard-share-adapter';
 import * as i0 from "@angular/core";
 /**
  * Public re-export kept for backward compatibility with existing call sites
- * ({@link DashboardBrowserResourceComponent}, `DashboardResource` wrapper).
+ * (the `DashboardResource` wrapper in `@memberjunction/ng-explorer-core`).
  * The new abstraction lives in `@memberjunction/ng-resource-permissions`.
  */
 export type ShareDialogResult = ResourceShareDialogResult & {

package/dist/DashboardBrowser/dashboard-share-dialog.component.js.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard-share-dialog.component.js","sourceRoot":"","sources":["../../src/DashboardBrowser/dashboard-share-dialog.component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAMvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;;;AASlE;;;;;;GAMG;AAaH,MAAM,OAAO,6BAA8B,SAAQ,oBAAoB;IAC1D,OAAO,GAAG,KAAK,CAAC;IACzB,IACI,SAAS,CAAC,KAA+B;QACzC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,KAAK;YAChB,CAAC,CAAC;gBACI,UAAU,EAAE,KAAK,CAAC,EAAE;gBACpB,YAAY,EAAE,KAAK,CAAC,IAAI,IAAI,UAAU;gBACtC,WAAW,EAAE,KAAK,CAAC,MAAM;gBACzB,gBAAgB,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK;aACxC;YACH,CAAC,CAAC,IAAI,CAAC;IACf,CAAC;IACD,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IACS,MAAM,GAAG,IAAI,YAAY,EAAqB,CAAC;IAElD,OAAO,GAAgC,IAAI,CAAC;IAC5C,OAAO,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAE7C,uCAAuC;IACvC,IAAW,OAAO;QACd,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IACD,uCAAuC;IACvC,IAAW,OAAO,CAAC,KAAK;QACpB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACzB,CAAC;IAEO,UAAU,GAA6B,IAAI,CAAC;IAEpD;QACI,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC;IAC/C,CAAC;IAED,QAAQ,CAAC,MAAiC;QACtC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACb,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,MAAM,CAAC,MAAM,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;SACvF,CAAC,CAAC;IACP,CAAC;IAED,wCAAwC;IACxC,QAAQ,CAAC,MAAiC;QACtC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;uHAhDQ,6BAA6B;6DAA7B,6BAA6B;YARlC,mDAIgC;YAA5B,oIAAU,oBAAgB,IAAC;YAC/B,iBAA2B;;YAFvB,AADA,AADA,qCAAmB,wBACA,wBACA;;;iFAKlB,6BAA6B;cAZzC,SAAS;eAAC;gBACP,UAAU,EAAE,KAAK;gBACjB,QAAQ,EAAE,2BAA2B;gBACrC,QAAQ,EAAE;;;;;;;KAOT;aACJ;;kBAEI,KAAK;;kBACL,KAAK;;kBAeL,MAAM;;kFAjBE,6BAA6B","sourcesContent":["import { Component, Input, Output, EventEmitter } from '@angular/core';\nimport { MJDashboardEntity } from '@memberjunction/core-entities';\nimport {\n    ResourceShareContext,\n    ResourceShareDialogResult\n} from '@memberjunction/ng-resource-permissions';\nimport { BaseAngularComponent } from '@memberjunction/ng-base-types';\nimport { DashboardShareAdapter } from './dashboard-share-adapter';\n\n/**\n * Public re-export kept for backward compatibility with existing call sites\n * ({@link DashboardBrowserResourceComponent}, `DashboardResource` wrapper).\n * The new abstraction lives in `@memberjunction/ng-resource-permissions`.\n */\nexport type ShareDialogResult = ResourceShareDialogResult & { Dashboard?: MJDashboardEntity };\n\n/**\n * Thin wrapper that maps a `MJDashboardEntity` + the Dashboard-specific\n * permission model onto the generic `mj-resource-share-dialog`. Existing call\n * sites (`<mj-dashboard-share-dialog [Dashboard]=... [Visible]=... (Result)=... />`)\n * continue to work unchanged — this component just constructs the context +\n * adapter and delegates.\n */\n@Component({\n    standalone: false,\n    selector: 'mj-dashboard-share-dialog',\n    template: `\n        <mj-resource-share-dialog\n            [Visible]=\"Visible\"\n            [Context]=\"context\"\n            [Adapter]=\"adapter\"\n            (Result)=\"onResult($event)\">\n        </mj-resource-share-dialog>\n    `\n})\nexport class DashboardShareDialogComponent extends BaseAngularComponent {\n    @Input() Visible = false;\n    @Input()\n    set Dashboard(value: MJDashboardEntity | null) {\n        this._dashboard = value;\n        this.context = value\n            ? {\n                  ResourceID: value.ID,\n                  ResourceName: value.Name ?? 'Untitled',\n                  OwnerUserID: value.UserID,\n                  OwnerDisplayName: value.User ?? 'You'\n              }\n            : null;\n    }\n    get Dashboard(): MJDashboardEntity | null {\n        return this._dashboard;\n    }\n    @Output() Result = new EventEmitter<ShareDialogResult>();\n\n    public context: ResourceShareContext | null = null;\n    public Adapter = new DashboardShareAdapter();\n\n    /** @deprecated Use {@link Adapter}. */\n    public get adapter() {\n        return this.Adapter;\n    }\n    /** @deprecated Use {@link Adapter}. */\n    public set adapter(value) {\n        this.Adapter = value;\n    }\n\n    private _dashboard: MJDashboardEntity | null = null;\n\n    constructor() {\n        super();\n        this.Adapter.Provider = this.ProviderToUse;\n    }\n\n    OnResult(result: ResourceShareDialogResult): void {\n        this.Result.emit({\n            Action: result.Action,\n            Dashboard: result.Action === 'save' && this._dashboard ? this._dashboard : undefined\n        });\n    }\n\n    /** @deprecated Use {@link OnResult}. */\n    onResult(result: ResourceShareDialogResult): void {\n        return this.OnResult(result);\n    }\n}\n"]}
+{"version":3,"file":"dashboard-share-dialog.component.js","sourceRoot":"","sources":["../../src/DashboardBrowser/dashboard-share-dialog.component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAMvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;;;AASlE;;;;;;GAMG;AAaH,MAAM,OAAO,6BAA8B,SAAQ,oBAAoB;IAC1D,OAAO,GAAG,KAAK,CAAC;IACzB,IACI,SAAS,CAAC,KAA+B;QACzC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,KAAK;YAChB,CAAC,CAAC;gBACI,UAAU,EAAE,KAAK,CAAC,EAAE;gBACpB,YAAY,EAAE,KAAK,CAAC,IAAI,IAAI,UAAU;gBACtC,WAAW,EAAE,KAAK,CAAC,MAAM;gBACzB,gBAAgB,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK;aACxC;YACH,CAAC,CAAC,IAAI,CAAC;IACf,CAAC;IACD,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IACS,MAAM,GAAG,IAAI,YAAY,EAAqB,CAAC;IAElD,OAAO,GAAgC,IAAI,CAAC;IAC5C,OAAO,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAE7C,uCAAuC;IACvC,IAAW,OAAO;QACd,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IACD,uCAAuC;IACvC,IAAW,OAAO,CAAC,KAAK;QACpB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACzB,CAAC;IAEO,UAAU,GAA6B,IAAI,CAAC;IAEpD;QACI,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC;IAC/C,CAAC;IAED,QAAQ,CAAC,MAAiC;QACtC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACb,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,MAAM,CAAC,MAAM,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;SACvF,CAAC,CAAC;IACP,CAAC;IAED,wCAAwC;IACxC,QAAQ,CAAC,MAAiC;QACtC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;uHAhDQ,6BAA6B;6DAA7B,6BAA6B;YARlC,mDAIgC;YAA5B,oIAAU,oBAAgB,IAAC;YAC/B,iBAA2B;;YAFvB,AADA,AADA,qCAAmB,wBACA,wBACA;;;iFAKlB,6BAA6B;cAZzC,SAAS;eAAC;gBACP,UAAU,EAAE,KAAK;gBACjB,QAAQ,EAAE,2BAA2B;gBACrC,QAAQ,EAAE;;;;;;;KAOT;aACJ;;kBAEI,KAAK;;kBACL,KAAK;;kBAeL,MAAM;;kFAjBE,6BAA6B","sourcesContent":["import { Component, Input, Output, EventEmitter } from '@angular/core';\nimport { MJDashboardEntity } from '@memberjunction/core-entities';\nimport {\n    ResourceShareContext,\n    ResourceShareDialogResult\n} from '@memberjunction/ng-resource-permissions';\nimport { BaseAngularComponent } from '@memberjunction/ng-base-types';\nimport { DashboardShareAdapter } from './dashboard-share-adapter';\n\n/**\n * Public re-export kept for backward compatibility with existing call sites\n * (the `DashboardResource` wrapper in `@memberjunction/ng-explorer-core`).\n * The new abstraction lives in `@memberjunction/ng-resource-permissions`.\n */\nexport type ShareDialogResult = ResourceShareDialogResult & { Dashboard?: MJDashboardEntity };\n\n/**\n * Thin wrapper that maps a `MJDashboardEntity` + the Dashboard-specific\n * permission model onto the generic `mj-resource-share-dialog`. Existing call\n * sites (`<mj-dashboard-share-dialog [Dashboard]=... [Visible]=... (Result)=... />`)\n * continue to work unchanged — this component just constructs the context +\n * adapter and delegates.\n */\n@Component({\n    standalone: false,\n    selector: 'mj-dashboard-share-dialog',\n    template: `\n        <mj-resource-share-dialog\n            [Visible]=\"Visible\"\n            [Context]=\"context\"\n            [Adapter]=\"adapter\"\n            (Result)=\"onResult($event)\">\n        </mj-resource-share-dialog>\n    `\n})\nexport class DashboardShareDialogComponent extends BaseAngularComponent {\n    @Input() Visible = false;\n    @Input()\n    set Dashboard(value: MJDashboardEntity | null) {\n        this._dashboard = value;\n        this.context = value\n            ? {\n                  ResourceID: value.ID,\n                  ResourceName: value.Name ?? 'Untitled',\n                  OwnerUserID: value.UserID,\n                  OwnerDisplayName: value.User ?? 'You'\n              }\n            : null;\n    }\n    get Dashboard(): MJDashboardEntity | null {\n        return this._dashboard;\n    }\n    @Output() Result = new EventEmitter<ShareDialogResult>();\n\n    public context: ResourceShareContext | null = null;\n    public Adapter = new DashboardShareAdapter();\n\n    /** @deprecated Use {@link Adapter}. */\n    public get adapter() {\n        return this.Adapter;\n    }\n    /** @deprecated Use {@link Adapter}. */\n    public set adapter(value) {\n        this.Adapter = value;\n    }\n\n    private _dashboard: MJDashboardEntity | null = null;\n\n    constructor() {\n        super();\n        this.Adapter.Provider = this.ProviderToUse;\n    }\n\n    OnResult(result: ResourceShareDialogResult): void {\n        this.Result.emit({\n            Action: result.Action,\n            Dashboard: result.Action === 'save' && this._dashboard ? this._dashboard : undefined\n        });\n    }\n\n    /** @deprecated Use {@link OnResult}. */\n    onResult(result: ResourceShareDialogResult): void {\n        return this.OnResult(result);\n    }\n}\n"]}

package/dist/DashboardBrowser/dashboards-agent-tools.d.ts

@@ -0,0 +1,26 @@
+import { type AgentToolResult } from '../shared/agent-tool-validation';
+/** An agent client tool, in the shape `NavigationService.SetAgentClientTools` takes. */
+export interface DashboardsAgentClientTool {
+    Name: string;
+    Description: string;
+    ParameterSchema: Record<string, unknown>;
+    Handler: (params: Record<string, unknown>) => Promise<unknown>;
+}
+/** The item an agent named, or the failure result to return to the agent. */
+export type AgentLookup<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    result: AgentToolResult;
+};
+/**
+ * Finds the item an agent named: an exact ID match first, then an exact name match that ignores
+ * case. `kind` names the item in messages, for example "dashboard". When nothing matches, the
+ * failure lists up to 25 available names.
+ */
+export declare function ResolveByIdOrName<T extends {
+    ID: string;
+    Name: string;
+}>(items: readonly T[], raw: unknown, kind: string): AgentLookup<T>;
+//# sourceMappingURL=dashboards-agent-tools.d.ts.map

package/dist/DashboardBrowser/dashboards-agent-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboards-agent-tools.d.ts","sourceRoot":"","sources":["../../src/DashboardBrowser/dashboards-agent-tools.ts"],"names":[],"mappings":"AAYA,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEtF,wFAAwF;AACxF,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAChE;AAED,6EAA6E;AAC7E,MAAM,MAAM,WAAW,CAAC,CAAC,IACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACtB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC;AAE3C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAYzI"}

package/dist/DashboardBrowser/dashboards-agent-tools.js

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview Agent tool parts for the Categories page of the Dashboards app: the tool shape and
+ * the id-or-name lookup its handlers use. Handlers never throw; a bad parameter returns a failure
+ * result the agent can act on.
+ *
+ * 🔒 SAFETY BOUNDARY: the Categories page gives the AI agent ONLY read-only / navigational tools, as
+ * the Library does. Mutating operations — create / delete / save / share / move a dashboard or a
+ * category — are intentionally NOT exposed; the user performs them from the UI. Do NOT add a
+ * mutating tool builder here without revisiting this boundary (the page's agent section lists its
+ * tools).
+ */
+import { UUIDsEqual } from '@memberjunction/global';
+import { BoundNameList } from '../shared/agent-tool-validation';
+/**
+ * Finds the item an agent named: an exact ID match first, then an exact name match that ignores
+ * case. `kind` names the item in messages, for example "dashboard". When nothing matches, the
+ * failure lists up to 25 available names.
+ */
+export function ResolveByIdOrName(items, raw, kind) {
+    const value = typeof raw === 'string' ? raw.trim() : '';
+    if (!value) {
+        return { ok: false, result: { Success: false, ErrorMessage: `A ${kind} ID or name is required.` } };
+    }
+    const lowered = value.toLowerCase();
+    const match = items.find(i => UUIDsEqual(i.ID, value)) ?? items.find(i => (i.Name ?? '').toLowerCase() === lowered);
+    if (match) {
+        return { ok: true, value: match };
+    }
+    const available = BoundNameList(items.map(i => i.Name)).join(', ') || '(none)';
+    return { ok: false, result: { Success: false, ErrorMessage: `No ${kind} named or identified by "${value}". Available: ${available}.` } };
+}
+//# sourceMappingURL=dashboards-agent-tools.js.map

package/dist/DashboardBrowser/dashboards-agent-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboards-agent-tools.js","sourceRoot":"","sources":["../../src/DashboardBrowser/dashboards-agent-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAwB,MAAM,iCAAiC,CAAC;AAetF;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAyC,KAAmB,EAAE,GAAY,EAAE,IAAY;IACvH,MAAM,KAAK,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,IAAI,0BAA0B,EAAE,EAAE,CAAC;IACtG,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,CAAC;IACpH,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACpC,CAAC;IACD,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;IAC/E,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,4BAA4B,KAAK,iBAAiB,SAAS,GAAG,EAAE,EAAE,CAAC;AAC3I,CAAC","sourcesContent":["/**\n * @fileoverview Agent tool parts for the Categories page of the Dashboards app: the tool shape and\n * the id-or-name lookup its handlers use. Handlers never throw; a bad parameter returns a failure\n * result the agent can act on.\n *\n * 🔒 SAFETY BOUNDARY: the Categories page gives the AI agent ONLY read-only / navigational tools, as\n * the Library does. Mutating operations — create / delete / save / share / move a dashboard or a\n * category — are intentionally NOT exposed; the user performs them from the UI. Do NOT add a\n * mutating tool builder here without revisiting this boundary (the page's agent section lists its\n * tools).\n */\nimport { UUIDsEqual } from '@memberjunction/global';\nimport { BoundNameList, type AgentToolResult } from '../shared/agent-tool-validation';\n\n/** An agent client tool, in the shape `NavigationService.SetAgentClientTools` takes. */\nexport interface DashboardsAgentClientTool {\n  Name: string;\n  Description: string;\n  ParameterSchema: Record<string, unknown>;\n  Handler: (params: Record<string, unknown>) => Promise<unknown>;\n}\n\n/** The item an agent named, or the failure result to return to the agent. */\nexport type AgentLookup<T> =\n  | { ok: true; value: T }  // case-violation-ok-legacy-back-compat: matches the { ok, value } / { ok, result } result of ValidateStringParam (agent-tool-validation.ts)\n  | { ok: false; result: AgentToolResult };  // case-violation-ok-legacy-back-compat: matches the { ok, value } / { ok, result } result of ValidateStringParam (agent-tool-validation.ts)\n\n/**\n * Finds the item an agent named: an exact ID match first, then an exact name match that ignores\n * case. `kind` names the item in messages, for example \"dashboard\". When nothing matches, the\n * failure lists up to 25 available names.\n */\nexport function ResolveByIdOrName<T extends { ID: string; Name: string }>(items: readonly T[], raw: unknown, kind: string): AgentLookup<T> {\n  const value = typeof raw === 'string' ? raw.trim() : '';\n  if (!value) {\n    return { ok: false, result: { Success: false, ErrorMessage: `A ${kind} ID or name is required.` } };\n  }\n  const lowered = value.toLowerCase();\n  const match = items.find(i => UUIDsEqual(i.ID, value)) ?? items.find(i => (i.Name ?? '').toLowerCase() === lowered);\n  if (match) {\n    return { ok: true, value: match };\n  }\n  const available = BoundNameList(items.map(i => i.Name)).join(', ') || '(none)';\n  return { ok: false, result: { Success: false, ErrorMessage: `No ${kind} named or identified by \"${value}\". Available: ${available}.` } };\n}\n"]}

package/dist/DashboardBrowser/dashboards-categories-resource.component.d.ts

@@ -0,0 +1,58 @@
+import { ChangeDetectorRef, OnDestroy, OnInit } from '@angular/core';
+import { MJDashboardCategoryEntity, ResourceData } from '@memberjunction/core-entities';
+import { BaseResourceComponent } from '@memberjunction/ng-shared';
+import { CategoryRow } from './dashboards-categories.helpers';
+import * as i0 from "@angular/core";
+/**
+ * Categories page of the Dashboards app: the user's category tree with dashboard and sub-category
+ * counts, a New category box, Delete, after a confirm, for an empty category the user owns, and Open,
+ * which shows the category on the Library page. The agent tools are read-only; see the SAFETY
+ * BOUNDARY in the agent section below.
+ */
+export declare class DashboardsCategoriesResourceComponent extends BaseResourceComponent implements OnInit, OnDestroy {
+    private cdr;
+    private appManager;
+    private notifications;
+    private confirmService;
+    /** True until the categories have loaded. */
+    IsLoading: boolean;
+    /** True while a category is being created or deleted. */
+    IsSaving: boolean;
+    /** The category tree, one row per category, depth first. */
+    Rows: CategoryRow[];
+    /** The name typed in the New category box. */
+    NewName: string;
+    /** The longest category name the box accepts. */
+    readonly MaxNameLength = 100;
+    constructor(cdr: ChangeDetectorRef);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    GetResourceDisplayName(_data: ResourceData): Promise<string>;
+    GetResourceIconClass(_data: ResourceData): Promise<string>;
+    /** True when the New category box holds a name and nothing is being saved. */
+    get CanCreate(): boolean;
+    /** The row's summary line, for example "3 dashboards · 1 sub-category". */
+    Summary(row: CategoryRow): string;
+    /** Creates a top-level category owned by the user from the New category box, then reloads the tree. */
+    Create(): Promise<void>;
+    /** Deletes an empty category the user owns, after the user confirms. */
+    Delete(category: MJDashboardCategoryEntity): Promise<void>;
+    /** Shows the category on the Library page of the Dashboards app. */
+    OpenInLibrary(category: MJDashboardCategoryEntity): Promise<void>;
+    private load;
+    /**
+     * Reloads the dashboard cache from the server, rebuilds the rows and reports them to the agent.
+     * Returns false when the reload fails.
+     */
+    private reload;
+    private onCacheChanged;
+    private rebuildRows;
+    private openInLibrary;
+    private setSaving;
+    private emitAgentContext;
+    private buildAgentTools;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DashboardsCategoriesResourceComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DashboardsCategoriesResourceComponent, "mj-dashboards-categories-resource", never, {}, {}, never, never, false, never>;
+}
+export declare function LoadDashboardsCategoriesResource(): void;
+//# sourceMappingURL=dashboards-categories-resource.component.d.ts.map