element-book 22.2.2 → 23.0.0

package/dist/data/book-entry/book-root.d.ts

@@ -1,7 +1,12 @@
 import { Overwrite } from '@augment-vir/common';
-import { BaseBookEntry } from './base-book-entry';
-import { BookEntryTypeEnum } from './book-entry-type';
+import { BaseBookEntry } from './base-book-entry.js';
+import { BookEntryType } from './book-entry-type.js';
+/**
+ * The root of a book tree.
+ *
+ * @category Internal
+ */
 export type BookRoot = Overwrite<BaseBookEntry, {
-    entryType: BookEntryTypeEnum.Root;
+    entryType: BookEntryType.Root;
     parent: undefined;
 }>;

package/dist/data/book-entry/url-breadcrumbs.d.ts

@@ -1,6 +1,22 @@
-import { BookEntry } from './book-entry';
+import { BookEntry } from './book-entry.js';
+/**
+ * Create a list of URL breadcrumbs for the given element-book entry.
+ *
+ * @internal
+ */
 export declare function listUrlBreadcrumbs(entry: BookEntry, includeSelf: boolean): string[];
+/**
+ * Convert an element-book entry's title to a URL-safe breadcrumb title.
+ *
+ * @internal
+ */
 export declare function titleToUrlBreadcrumb(title: string): string;
+/**
+ * Check if a full list of URL breadcrumbs (`searchIn`) starts with the subset list of URL
+ * breadcrumbs (`searchFor`).
+ *
+ * @internal
+ */
 export declare function doBreadcrumbsStartWith({ searchFor, searchIn, }: {
     searchIn: ReadonlyArray<string>;
     searchFor: ReadonlyArray<string>;

package/dist/data/book-entry/url-breadcrumbs.js

@@ -1,4 +1,9 @@
 import { collapseWhiteSpace } from '@augment-vir/common';
+/**
+ * Create a list of URL breadcrumbs for the given element-book entry.
+ *
+ * @internal
+ */
 export function listUrlBreadcrumbs(entry, includeSelf) {
     const entryBreadcrumb = titleToUrlBreadcrumb(entry.title);
     if (entry.parent) {
@@ -14,9 +19,20 @@ export function listUrlBreadcrumbs(entry, includeSelf) {
         return [];
     }
 }
+/**
+ * Convert an element-book entry's title to a URL-safe breadcrumb title.
+ *
+ * @internal
+ */
 export function titleToUrlBreadcrumb(title) {
     return collapseWhiteSpace(title).toLowerCase().replaceAll(/\s/g, '-');
 }
+/**
+ * Check if a full list of URL breadcrumbs (`searchIn`) starts with the subset list of URL
+ * breadcrumbs (`searchFor`).
+ *
+ * @internal
+ */
 export function doBreadcrumbsStartWith({ searchFor, searchIn, }) {
     return searchFor.every((breadcrumb, index) => {
         return searchIn[index] === breadcrumb;

package/dist/data/book-entry/verify-book-entry.d.ts

@@ -1,6 +1,3 @@
-import { BookEntry } from './book-entry';
-export declare const bookEntryVerifiers: {
-    "element-example": (entry: BookEntry) => Error[];
-    page: (entry: BookEntry) => Error[];
-    root: (entry: BookEntry) => Error[];
-};
+import { BookEntryType } from './book-entry-type.js';
+import { BookEntry } from './book-entry.js';
+export declare const bookEntryVerifiers: { [EntryType in BookEntryType]: (entry: BookEntry) => Error[]; };

package/dist/data/book-entry/verify-book-entry.js

@@ -1,18 +1,18 @@
-import { isTruthy } from '@augment-vir/common';
-import { BookEntryTypeEnum } from './book-entry-type';
-import { checkControls } from './book-page/book-page-controls';
+import { check } from '@augment-vir/assert';
+import { BookEntryType } from './book-entry-type.js';
+import { checkControls } from './book-page/book-page-controls.js';
 export const bookEntryVerifiers = {
-    [BookEntryTypeEnum.ElementExample]: () => {
+    [BookEntryType.ElementExample]: () => {
         // currently all element example checking happens on page definition
         return [];
     },
-    [BookEntryTypeEnum.Page]: (bookPage) => {
+    [BookEntryType.Page]: (bookPage) => {
         return [
             !bookPage.title && new Error(`Cannot define an element-book page with an empty title.`),
             ...checkControls(bookPage.controls, bookPage.title),
-        ].filter(isTruthy);
+        ].filter(check.isTruthy);
     },
-    [BookEntryTypeEnum.Root]: () => {
+    [BookEntryType.Root]: () => {
         return [];
     },
 };

package/dist/data/book-tree/book-tree-node.d.ts

@@ -1,8 +1,18 @@
-import { PropertyValueType } from '@augment-vir/common';
-import { BookEntry } from '../book-entry/book-entry';
-import { AnyBookEntryType, BookEntryTypeEnum } from '../book-entry/book-entry-type';
+import { Values } from '@augment-vir/common';
+import { AnyBookEntryType, BookEntryType } from '../book-entry/book-entry-type.js';
+import { BookEntry } from '../book-entry/book-entry.js';
+/**
+ * Property used to mark tree nodes.
+ *
+ * @category Internal
+ */
 export declare const isBookTreeNodeMarker = "_isBookTreeNode";
-type InternalBookTreeNodeType<Entry> = {
+/**
+ * The base tree node type for {@link BookTreeNode}.
+ *
+ * @category Internal
+ */
+export type InternalBookTreeNodeType<Entry> = {
     [isBookTreeNodeMarker]: true;
     entry: Entry;
     /** UrlBreadcrumb is different from entry.title because it's modified to support URLs. */
@@ -15,13 +25,22 @@ type InternalBookTreeNodeType<Entry> = {
      */
     manuallyAdded: boolean;
 };
-export type BookTreeNode<EntryTypes extends BookEntryTypeEnum = AnyBookEntryType> = PropertyValueType<{
+/**
+ * Any element-book tree node.
+ *
+ * @category Internal
+ */
+export type BookTreeNode<EntryTypes extends BookEntryType = AnyBookEntryType> = Values<{
     [EntryType in EntryTypes]: InternalBookTreeNodeType<Extract<BookEntry, {
         entryType: EntryType;
     }>>;
 }> | (AnyBookEntryType extends EntryTypes ? InternalBookTreeNodeType<BookEntry> : never);
+/**
+ * The full element-book app tree for representing page structure.
+ *
+ * @category Internal
+ */
 export type BookTree = Readonly<{
-    tree: Readonly<BookTreeNode<BookEntryTypeEnum.Root>>;
+    tree: Readonly<BookTreeNode<BookEntryType.Root>>;
     flattenedNodes: ReadonlyArray<Readonly<BookTreeNode>>;
 }>;
-export {};

package/dist/data/book-tree/book-tree-node.js

@@ -1 +1,6 @@
+/**
+ * Property used to mark tree nodes.
+ *
+ * @category Internal
+ */
 export const isBookTreeNodeMarker = '_isBookTreeNode';

package/dist/data/book-tree/book-tree.d.ts

@@ -1,10 +1,10 @@
-import { BookEntry } from '../book-entry/book-entry';
-import { BookEntryTypeEnum } from '../book-entry/book-entry-type';
-import { BookTree, BookTreeNode } from './book-tree-node';
-export declare function doesNodeHaveEntryType<const EntryType extends BookEntryTypeEnum>(node: BookTreeNode<any>, entryType: EntryType): node is BookTreeNode<EntryType>;
-export declare function isBookTreeNode<const SpecificType extends BookEntryTypeEnum>(input: unknown, entryType: SpecificType): input is BookTreeNode<SpecificType>;
-export declare function isAnyBookTreeNode(input: unknown): input is BookTreeNode<BookEntryTypeEnum>;
-export declare function createEmptyBookTreeRoot(): BookTreeNode<BookEntryTypeEnum.Root>;
+import { BookEntryType } from '../book-entry/book-entry-type.js';
+import { BookEntry } from '../book-entry/book-entry.js';
+import { BookTree, BookTreeNode } from './book-tree-node.js';
+export declare function doesNodeHaveEntryType<const EntryType extends BookEntryType>(node: unknown, entryType: EntryType): node is BookTreeNode<EntryType>;
+export declare function isBookTreeNode<const SpecificType extends BookEntryType>(input: unknown, entryType: SpecificType): input is BookTreeNode<SpecificType>;
+export declare function isAnyBookTreeNode(input: unknown): input is BookTreeNode<BookEntryType>;
+export declare function createEmptyBookTreeRoot(): BookTreeNode<BookEntryType.Root>;
 export declare function createBookTreeFromEntries({ entries, debug, }: {
     entries: ReadonlyArray<BookEntry>;
     debug: boolean;

package/dist/data/book-tree/book-tree.js

@@ -1,18 +1,20 @@
-import { typedHasProperties } from '@augment-vir/common';
-import { isBookEntry } from '../book-entry/book-entry';
-import { BookEntryTypeEnum } from '../book-entry/book-entry-type';
-import { listUrlBreadcrumbs, titleToUrlBreadcrumb } from '../book-entry/url-breadcrumbs';
-import { bookEntryVerifiers } from '../book-entry/verify-book-entry';
-import { isBookTreeNodeMarker } from './book-tree-node';
-import { addTreeToCache, getTreeFromCache } from './tree-cache';
+import { check } from '@augment-vir/assert';
+import { BookEntryType } from '../book-entry/book-entry-type.js';
+import { isBookEntry } from '../book-entry/book-entry.js';
+import { listUrlBreadcrumbs, titleToUrlBreadcrumb } from '../book-entry/url-breadcrumbs.js';
+import { bookEntryVerifiers } from '../book-entry/verify-book-entry.js';
+import { isBookTreeNodeMarker } from './book-tree-node.js';
+import { addTreeToCache, getTreeFromCache } from './tree-cache.js';
 export function doesNodeHaveEntryType(node, entryType) {
-    return node.entry.entryType === entryType;
+    return (check.hasKey(node, 'entry') &&
+        check.isObject(node.entry) &&
+        node.entry.entryType === entryType);
 }
 export function isBookTreeNode(input, entryType) {
     return !!(isAnyBookTreeNode(input) && input.entry.entryType === entryType);
 }
 export function isAnyBookTreeNode(input) {
-    return !!(typedHasProperties(input, [
+    return !!(check.hasKeys(input, [
         isBookTreeNodeMarker,
         'entry',
     ]) && input[isBookTreeNodeMarker]);
@@ -21,7 +23,7 @@ export function createEmptyBookTreeRoot() {
     const rootNode = {
         [isBookTreeNodeMarker]: true,
         entry: {
-            entryType: BookEntryTypeEnum.Root,
+            entryType: BookEntryType.Root,
             title: '',
             parent: undefined,
             errors: [],
@@ -66,7 +68,7 @@ function getOrAddImmediateParent(tree, entry, debug) {
     addEntryToTree({ tree, newEntry: entry.parent, debug, manuallyAdded: false });
     const immediateParentAfterAdding = traverseToImmediateParent(entry, tree);
     if (!immediateParentAfterAdding) {
-        throw new Error(`Failed to find node despite having just added it: ${listUrlBreadcrumbs(entry, false)}`);
+        throw new Error(`Failed to find node despite having just added it: ${listUrlBreadcrumbs(entry, false).join(' > ')}`);
     }
     return immediateParentAfterAdding;
 }
@@ -101,10 +103,9 @@ function addEntryToTree({ tree, newEntry, debug, manuallyAdded, }) {
         manuallyAdded,
     };
     immediateParent.children[newEntryUrlBreadcrumb] = newNode;
-    bookEntryVerifiers;
-    if (isBookEntry(newEntry, BookEntryTypeEnum.Page) &&
-        Object.values(newEntry.elementExamples ?? {}).length) {
-        Object.values(newEntry.elementExamples ?? {}).forEach((elementExample) => addEntryToTree({ tree, newEntry: elementExample, debug, manuallyAdded }));
+    if (isBookEntry(newEntry, BookEntryType.Page) &&
+        Object.values(newEntry.elementExamples).length) {
+        Object.values(newEntry.elementExamples).forEach((elementExample) => addEntryToTree({ tree, newEntry: elementExample, debug, manuallyAdded }));
     }
 }
 export function traverseToImmediateParent(entryOrNode, currentTree) {

package/dist/data/book-tree/search-nodes.d.ts

@@ -1,4 +1,4 @@
-import { BookTreeNode } from './book-tree-node';
+import { BookTreeNode } from './book-tree-node.js';
 export declare function searchFlattenedNodes({ flattenedNodes, searchQuery, }: {
     flattenedNodes: ReadonlyArray<BookTreeNode>;
     searchQuery: string;

package/dist/data/book-tree/search-nodes.js

@@ -1,6 +1,6 @@
+import { check } from '@augment-vir/assert';
 import { randomString } from '@augment-vir/common';
-import { isRunTimeType } from 'run-time-assertions';
-import { fuzzySearch } from '../../util/fuzzy-search';
+import { fuzzySearch } from '../../util/fuzzy-search.js';
 const searchJoin = randomString(32);
 function createBreadcrumbsSearchKey(breadcrumbs) {
     return breadcrumbs.join(searchJoin);
@@ -58,8 +58,8 @@ export function searchFlattenedNodes({ flattenedNodes, searchQuery, }) {
     return flattenedNodes.filter((treeNode) => {
         const inSearchResultsKey = createBreadcrumbsSearchKey(treeNode.fullUrlBreadcrumbs);
         const shouldInclude = includeInSearchResults[inSearchResultsKey];
-        if (!isRunTimeType(shouldInclude, 'boolean')) {
-            throw new Error(`Failed to find '${treeNode.fullUrlBreadcrumbs.join(' > ')}' in includeInSearchResults.`);
+        if (!check.isBoolean(shouldInclude)) {
+            throw new TypeError(`Failed to find '${treeNode.fullUrlBreadcrumbs.join(' > ')}' in includeInSearchResults.`);
         }
         return shouldInclude;
     });

package/dist/data/book-tree/tree-cache.d.ts

@@ -1,4 +1,4 @@
-import { BookEntry } from '../book-entry/book-entry';
-import { BookTree } from './book-tree-node';
+import { BookEntry } from '../book-entry/book-entry.js';
+import { BookTree } from './book-tree-node.js';
 export declare function getTreeFromCache(entries: ReadonlyArray<BookEntry>): BookTree | undefined;
 export declare function addTreeToCache(entries: ReadonlyArray<BookEntry>, tree: BookTree): void;

package/dist/index.d.ts

@@ -1,10 +1,18 @@
-export * from './data/book-entry/book-entry';
-export * from './data/book-entry/book-entry-type';
-export * from './data/book-entry/book-page/book-page';
-export * from './data/book-entry/book-page/book-page-controls';
-export * from './data/book-entry/book-page/define-book-page';
-export * from './data/book-entry/url-breadcrumbs';
-export * from './ui/elements/element-book-app/element-book-app-slots';
-export * from './ui/elements/element-book-app/element-book-app.element';
-export * from './ui/elements/element-book-app/element-book-config';
-export * from './ui/elements/element-book-app/global-values';
+export * from './data/book-entry/base-book-entry.js';
+export * from './data/book-entry/book-entry-type.js';
+export * from './data/book-entry/book-entry.js';
+export * from './data/book-entry/book-page/book-page-controls.js';
+export * from './data/book-entry/book-page/book-page.js';
+export * from './data/book-entry/book-page/controls-wrapper.js';
+export * from './data/book-entry/book-page/define-book-page.js';
+export * from './data/book-entry/book-root.js';
+export * from './data/book-entry/url-breadcrumbs.js';
+export * from './data/book-tree/book-tree-node.js';
+export * from './routing/book-routing.js';
+export * from './ui/color-theme/color-theme.js';
+export * from './ui/color-theme/create-color-theme.js';
+export * from './ui/elements/element-book-app/element-book-app-slots.js';
+export * from './ui/elements/element-book-app/element-book-app.element.js';
+export * from './ui/elements/element-book-app/element-book-config.js';
+export * from './ui/elements/element-book-app/global-values.js';
+export * from './util/type.js';

package/dist/index.js

@@ -1,10 +1,18 @@
-export * from './data/book-entry/book-entry';
-export * from './data/book-entry/book-entry-type';
-export * from './data/book-entry/book-page/book-page';
-export * from './data/book-entry/book-page/book-page-controls';
-export * from './data/book-entry/book-page/define-book-page';
-export * from './data/book-entry/url-breadcrumbs';
-export * from './ui/elements/element-book-app/element-book-app-slots';
-export * from './ui/elements/element-book-app/element-book-app.element';
-export * from './ui/elements/element-book-app/element-book-config';
-export * from './ui/elements/element-book-app/global-values';
+export * from './data/book-entry/base-book-entry.js';
+export * from './data/book-entry/book-entry-type.js';
+export * from './data/book-entry/book-entry.js';
+export * from './data/book-entry/book-page/book-page-controls.js';
+export * from './data/book-entry/book-page/book-page.js';
+export * from './data/book-entry/book-page/controls-wrapper.js';
+export * from './data/book-entry/book-page/define-book-page.js';
+export * from './data/book-entry/book-root.js';
+export * from './data/book-entry/url-breadcrumbs.js';
+export * from './data/book-tree/book-tree-node.js';
+export * from './routing/book-routing.js';
+export * from './ui/color-theme/color-theme.js';
+export * from './ui/color-theme/create-color-theme.js';
+export * from './ui/elements/element-book-app/element-book-app-slots.js';
+export * from './ui/elements/element-book-app/element-book-app.element.js';
+export * from './ui/elements/element-book-app/element-book-config.js';
+export * from './ui/elements/element-book-app/global-values.js';
+export * from './util/type.js';

package/dist/routing/book-router.d.ts

@@ -1,4 +1,4 @@
 import { SpaRouter } from 'spa-router-vir';
-import { ValidBookPaths } from './book-routing';
+import { ValidBookPaths } from './book-routing.js';
 export declare function createBookRouter(basePath: string | undefined): SpaRouter<ValidBookPaths, undefined, undefined>;
 export type BookRouter = ReturnType<typeof createBookRouter>;

package/dist/routing/book-router.js

@@ -1,6 +1,6 @@
-import { isEnumValue } from '@augment-vir/common';
+import { check } from '@augment-vir/assert';
 import { SpaRouter } from 'spa-router-vir';
-import { BookMainRoute, defaultBookFullRoute } from './book-routing';
+import { BookMainRoute, defaultBookFullRoute } from './book-routing.js';
 export function createBookRouter(basePath) {
     return new SpaRouter({
         basePath: basePath,
@@ -16,7 +16,7 @@ export function createBookRouter(basePath) {
 }
 function sanitizePaths(paths) {
     const firstPath = paths[0];
-    if (!isEnumValue(firstPath, BookMainRoute)) {
+    if (!check.isEnumValue(firstPath, BookMainRoute)) {
         return defaultBookFullRoute.paths;
     }
     else if (firstPath === BookMainRoute.Book) {

package/dist/routing/book-routing.d.ts

@@ -1,9 +1,34 @@
 import { FullRoute } from 'spa-router-vir';
+/**
+ * Top level routes supported by the element-book app.
+ *
+ * @category Internal
+ */
 export declare enum BookMainRoute {
     Search = "search",
     Book = "book"
 }
+/**
+ * Valid route paths for the element-book app.
+ *
+ * @category Internal
+ */
 export type ValidBookPaths = [BookMainRoute.Search, string] | [BookMainRoute.Book, ...string[]];
+/**
+ * A full element-book app route. Only paths are supported.
+ *
+ * @category Internal
+ */
 export type BookFullRoute = Required<Readonly<FullRoute<ValidBookPaths, undefined, undefined>>>;
+/**
+ * Extract the current search query from the current route paths.
+ *
+ * @category Internal
+ */
 export declare function extractSearchQuery(paths: Readonly<ValidBookPaths>): string;
+/**
+ * The default element-book app route.
+ *
+ * @category Internal
+ */
 export declare const defaultBookFullRoute: Readonly<BookFullRoute>;

package/dist/routing/book-routing.js

@@ -1,8 +1,18 @@
+/**
+ * Top level routes supported by the element-book app.
+ *
+ * @category Internal
+ */
 export var BookMainRoute;
 (function (BookMainRoute) {
     BookMainRoute["Search"] = "search";
     BookMainRoute["Book"] = "book";
 })(BookMainRoute || (BookMainRoute = {}));
+/**
+ * Extract the current search query from the current route paths.
+ *
+ * @category Internal
+ */
 export function extractSearchQuery(paths) {
     if (paths[0] === BookMainRoute.Book) {
         return '';
@@ -11,6 +21,11 @@ export function extractSearchQuery(paths) {
         return paths[1] ? decodeURIComponent(paths[1]) : '';
     }
 }
+/**
+ * The default element-book app route.
+ *
+ * @category Internal
+ */
 export const defaultBookFullRoute = {
     hash: undefined,
     paths: [BookMainRoute.Book],

package/dist/ui/color-theme/color-theme.d.ts

@@ -1,8 +1,18 @@
 import { CSSResult } from 'element-vir';
+/**
+ * A single background and foreground color pairing.
+ *
+ * @category Internal
+ */
 export type ColorPair = {
     background: CSSResult;
     foreground: CSSResult;
 };
+/**
+ * Color pairs for everything used by the element-book app.
+ *
+ * @category Internal
+ */
 export type ColorTheme = {
     nav: {
         hover: ColorPair;
@@ -19,19 +29,29 @@ export type ColorTheme = {
         foregroundFaint2: CSSResult;
     };
 };
+/**
+ * All color theme CSS vars for the element-book app.
+ *
+ * @category Internal
+ */
 export declare const colorThemeCssVars: import("lit-css-vars").CssVarDefinitions<{
-    'element-book-nav-hover-background-color': string;
-    'element-book-nav-hover-foreground-color': string;
-    'element-book-nav-active-background-color': string;
-    'element-book-nav-active-foreground-color': string;
-    'element-book-nav-selected-background-color': string;
-    'element-book-nav-selected-foreground-color': string;
-    'element-book-accent-icon-color': string;
-    'element-book-page-background-color': string;
-    'element-book-page-background-faint-level-1-color': string;
-    'element-book-page-background-faint-level-2-color': string;
-    'element-book-page-foreground-color': string;
-    'element-book-page-foreground-faint-level-1-color': string;
-    'element-book-page-foreground-faint-level-2-color': string;
+    readonly 'element-book-nav-hover-background-color': "magenta";
+    readonly 'element-book-nav-hover-foreground-color': "magenta";
+    readonly 'element-book-nav-active-background-color': "magenta";
+    readonly 'element-book-nav-active-foreground-color': "magenta";
+    readonly 'element-book-nav-selected-background-color': "magenta";
+    readonly 'element-book-nav-selected-foreground-color': "magenta";
+    readonly 'element-book-accent-icon-color': "magenta";
+    readonly 'element-book-page-background-color': "magenta";
+    readonly 'element-book-page-background-faint-level-1-color': "magenta";
+    readonly 'element-book-page-background-faint-level-2-color': "magenta";
+    readonly 'element-book-page-foreground-color': "magenta";
+    readonly 'element-book-page-foreground-faint-level-1-color': "magenta";
+    readonly 'element-book-page-foreground-faint-level-2-color': "magenta";
 }>;
+/**
+ * Sets a new color theme's CSS vars on the given HTML element for the element-book app.
+ *
+ * @category Internal
+ */
 export declare function setThemeCssVars(element: HTMLElement, theme: ColorTheme): void;

package/dist/ui/color-theme/color-theme.js

@@ -1,6 +1,10 @@
-import { typedHasProperties, typedHasProperty } from '@augment-vir/common';
+import { check } from '@augment-vir/assert';
 import { defineCssVars, setCssVarValue } from 'lit-css-vars';
-import { isRunTimeType } from 'run-time-assertions';
+/**
+ * All color theme CSS vars for the element-book app.
+ *
+ * @category Internal
+ */
 export const colorThemeCssVars = defineCssVars({
     'element-book-nav-hover-background-color': 'magenta',
     'element-book-nav-hover-foreground-color': 'magenta',
@@ -43,19 +47,24 @@ const colorThemeCssVarMapping = {
         foregroundFaint2: colorThemeCssVars['element-book-page-foreground-faint-level-2-color'],
     },
 };
+/**
+ * Sets a new color theme's CSS vars on the given HTML element for the element-book app.
+ *
+ * @category Internal
+ */
 export function setThemeCssVars(element, theme) {
     recursiveSetThemeCssVars(element, theme, colorThemeCssVarMapping);
 }
 function isCssResult(input) {
-    return typedHasProperty(input, '_$cssResult$');
+    return check.hasKey(input, '_$cssResult$');
 }
 function isCssVarDefinition(input) {
-    return (typedHasProperties(input, [
+    return (check.hasKeys(input, [
         'name',
         'value',
         'default',
     ]) &&
-        isRunTimeType(input.default, 'string') &&
+        check.isString(input.default) &&
         isCssResult(input.name) &&
         isCssResult(input.value));
 }

package/dist/ui/color-theme/create-color-theme.d.ts

@@ -1,12 +1,32 @@
-import { PartialAndUndefined } from '@augment-vir/common';
-import { ColorTheme } from './color-theme';
+import { PartialWithUndefined } from '@augment-vir/common';
+import { ColorTheme } from './color-theme.js';
+/**
+ * The default theme color.
+ *
+ * @category Internal
+ */
 export declare const defaultThemeStartColor = "dodgerblue";
+/**
+ * Theme style options for the element-book app.
+ *
+ * @category Internal
+ */
 export declare enum ThemeStyle {
     Dark = "dark",
     Light = "light"
 }
-export type ThemeConfig = PartialAndUndefined<{
+/**
+ * Theme configuration options for the element-book app.
+ *
+ * @category Internal
+ */
+export type ThemeConfig = PartialWithUndefined<{
     themeColor: string;
     themeStyle: ThemeStyle;
 }>;
+/**
+ * Creates a theme from the given theme configuration.
+ *
+ * @category Internal
+ */
 export declare function createTheme({ themeColor: inputThemeColor, themeStyle, }?: ThemeConfig): ColorTheme;

package/dist/ui/color-theme/create-color-theme.js

@@ -11,6 +11,11 @@ function colorsObjectToCssResult(colors) {
         }
     });
 }
+/**
+ * The default theme color.
+ *
+ * @category Internal
+ */
 export const defaultThemeStartColor = 'dodgerblue';
 function calculateTextColorString(color) {
     const onWhite = Math.abs(color.contrast('white', 'APCA'));
@@ -24,6 +29,11 @@ function createColorPair({ background, foreground, }) {
         foreground: foreground ?? new Color(calculateTextColorString(background)),
     };
 }
+/**
+ * Theme style options for the element-book app.
+ *
+ * @category Internal
+ */
 export var ThemeStyle;
 (function (ThemeStyle) {
     ThemeStyle["Dark"] = "dark";
@@ -52,6 +62,11 @@ const faintBackgroundColors = {
         backgroundFaint2: new Color('#fafafa'),
     },
 };
+/**
+ * Creates a theme from the given theme configuration.
+ *
+ * @category Internal
+ */
 export function createTheme({ themeColor: inputThemeColor = defaultThemeStartColor, themeStyle = ThemeStyle.Light, } = {}) {
     const themeColor = new Color(inputThemeColor);
     const backgroundColor = new Color(themeStyle === ThemeStyle.Dark ? 'black' : 'white');

package/dist/ui/elements/book-breadcrumbs.element.d.ts

@@ -1,6 +1,6 @@
-import { BookRouter } from '../../routing/book-router';
-import { BookFullRoute } from '../../routing/book-routing';
+import { BookRouter } from '../../routing/book-router.js';
+import { BookFullRoute } from '../../routing/book-routing.js';
 export declare const BookBreadcrumbs: import("element-vir").DeclarativeElementDefinition<"book-breadcrumbs", {
     currentRoute: Readonly<BookFullRoute>;
     router: Readonly<BookRouter> | undefined;
-}, {}, {}, `book-breadcrumbs-${string}`, `book-breadcrumbs-${string}`, readonly string[]>;
+}, {}, {}, "book-breadcrumbs-", "book-breadcrumbs-", readonly []>;

package/dist/ui/elements/book-breadcrumbs.element.js

@@ -1,7 +1,7 @@
 import { css, html } from 'element-vir';
-import { BookMainRoute } from '../../routing/book-routing';
-import { BookRouteLink } from './common/book-route-link.element';
-import { defineBookElement } from './define-book-element';
+import { BookMainRoute } from '../../routing/book-routing.js';
+import { BookRouteLink } from './common/book-route-link.element.js';
+import { defineBookElement } from './define-book-element.js';
 export const BookBreadcrumbs = defineBookElement()({
     tagName: 'book-breadcrumbs',
     styles: css `
@@ -14,7 +14,7 @@ export const BookBreadcrumbs = defineBookElement()({
             padding: 0 4px;
         }
     `,
-    renderCallback: ({ inputs }) => {
+    render: ({ inputs }) => {
         const bookPaths = inputs.currentRoute.paths.slice(1);
         if (!bookPaths.length) {
             return html `