npm - @zolomedia/bifrost-client - Versions diffs - 1.7.74 - Mend

@zolomedia/bifrost-client 1.7.74

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (140) hide show

package/L1_Foundation/L1_Foundation.js +13 -0
package/L1_Foundation/bootstrap/bootstrap.js +11 -0
package/L1_Foundation/bootstrap/bootstrap_hooks.js +123 -0
package/L1_Foundation/bootstrap/bootstrap_index.js +15 -0
package/L1_Foundation/bootstrap/bootstrap_logger.js +135 -0
package/L1_Foundation/bootstrap/cdn_loader.js +217 -0
package/L1_Foundation/bootstrap/module_registry.js +102 -0
package/L1_Foundation/bootstrap/prism_loader.js +164 -0
package/L1_Foundation/config/client_config.js +110 -0
package/L1_Foundation/config/config.js +7 -0
package/L1_Foundation/connection/connection.js +8 -0
package/L1_Foundation/connection/websocket_connection.js +122 -0
package/L1_Foundation/constants/bifrost_constants.js +284 -0
package/L1_Foundation/constants/constants.js +7 -0
package/L1_Foundation/logger/logger.js +10 -0
package/L2_Handling/L2_Handling.js +15 -0
package/L2_Handling/cache/cache.js +22 -0
package/L2_Handling/cache/cache_constants.js +69 -0
package/L2_Handling/cache/orchestration/cache_manager.js +299 -0
package/L2_Handling/cache/orchestration/cache_orchestrator.js +260 -0
package/L2_Handling/cache/orchestration/orchestration.js +12 -0
package/L2_Handling/cache/storage/session_manager.js +289 -0
package/L2_Handling/cache/storage/storage.js +10 -0
package/L2_Handling/cache/storage/storage_manager.js +590 -0
package/L2_Handling/display/composite/composite.js +13 -0
package/L2_Handling/display/composite/dashboard_renderer.js +221 -0
package/L2_Handling/display/composite/swiper_renderer.js +564 -0
package/L2_Handling/display/composite/terminal_renderer.js +922 -0
package/L2_Handling/display/composite/wizard_conditional_renderer.js +274 -0
package/L2_Handling/display/display.js +30 -0
package/L2_Handling/display/feedback/feedback.js +11 -0
package/L2_Handling/display/feedback/progressbar_renderer.js +418 -0
package/L2_Handling/display/feedback/spinner_renderer.js +246 -0
package/L2_Handling/display/inputs/button_renderer.js +634 -0
package/L2_Handling/display/inputs/form_renderer.js +583 -0
package/L2_Handling/display/inputs/input_renderer.js +658 -0
package/L2_Handling/display/inputs/inputs.js +12 -0
package/L2_Handling/display/navigation/menu_renderer.js +206 -0
package/L2_Handling/display/navigation/navigation.js +11 -0
package/L2_Handling/display/navigation/navigation_renderer.js +703 -0
package/L2_Handling/display/orchestration/orchestration.js +11 -0
package/L2_Handling/display/orchestration/renderer.js +430 -0
package/L2_Handling/display/orchestration/zdisplay_orchestrator.js +1759 -0
package/L2_Handling/display/outputs/alert_renderer.js +161 -0
package/L2_Handling/display/outputs/audio_renderer.js +94 -0
package/L2_Handling/display/outputs/card_renderer.js +229 -0
package/L2_Handling/display/outputs/code_renderer.js +66 -0
package/L2_Handling/display/outputs/dl_renderer.js +131 -0
package/L2_Handling/display/outputs/header_renderer.js +162 -0
package/L2_Handling/display/outputs/icon_renderer.js +107 -0
package/L2_Handling/display/outputs/image_renderer.js +145 -0
package/L2_Handling/display/outputs/list_renderer.js +190 -0
package/L2_Handling/display/outputs/outputs.js +19 -0
package/L2_Handling/display/outputs/table_renderer.js +765 -0
package/L2_Handling/display/outputs/text_renderer.js +818 -0
package/L2_Handling/display/outputs/typography_renderer.js +293 -0
package/L2_Handling/display/outputs/video_renderer.js +116 -0
package/L2_Handling/display/primitives/document_structure_primitives.js +319 -0
package/L2_Handling/display/primitives/form_primitives.js +526 -0
package/L2_Handling/display/primitives/generic_containers.js +109 -0
package/L2_Handling/display/primitives/interactive_primitives.js +305 -0
package/L2_Handling/display/primitives/link_primitives.js +552 -0
package/L2_Handling/display/primitives/lists_primitives.js +262 -0
package/L2_Handling/display/primitives/media_primitives.js +383 -0
package/L2_Handling/display/primitives/primitives.js +19 -0
package/L2_Handling/display/primitives/semantic_element_primitive.js +226 -0
package/L2_Handling/display/primitives/table_primitives.js +528 -0
package/L2_Handling/display/primitives/typography_primitives.js +175 -0
package/L2_Handling/display/specialized/input_request_renderer.js +467 -0
package/L2_Handling/display/specialized/specialized.js +10 -0
package/L2_Handling/hooks/hooks.js +9 -0
package/L2_Handling/hooks/menu_integration.js +57 -0
package/L2_Handling/hooks/widget_hook_manager.js +292 -0
package/L2_Handling/message/message.js +8 -0
package/L2_Handling/message/message_handler.js +701 -0
package/L2_Handling/navigation/navigation.js +8 -0
package/L2_Handling/navigation/navigation_manager.js +403 -0
package/L2_Handling/zhooks/features/cache_live.js +287 -0
package/L2_Handling/zhooks/features/crumbs_live.js +292 -0
package/L2_Handling/zhooks/zhooks_manager.js +65 -0
package/L2_Handling/zvaf/zvaf.js +8 -0
package/L2_Handling/zvaf/zvaf_manager.js +334 -0
package/L3_Abstraction/L3_Abstraction.js +12 -0
package/L3_Abstraction/orchestrator/container_unwrapper.js +101 -0
package/L3_Abstraction/orchestrator/group_renderer.js +698 -0
package/L3_Abstraction/orchestrator/input_event_handler.js +797 -0
package/L3_Abstraction/orchestrator/metadata_processor.js +249 -0
package/L3_Abstraction/orchestrator/navbar_builder.js +201 -0
package/L3_Abstraction/orchestrator/orchestrator.js +13 -0
package/L3_Abstraction/orchestrator/wizard_gate_handler.js +360 -0
package/L3_Abstraction/renderer/renderer.js +1 -0
package/L3_Abstraction/session/session.js +1 -0
package/L4_Orchestration/L4_Orchestration.js +11 -0
package/L4_Orchestration/client/client.js +1 -0
package/L4_Orchestration/facade/facade.js +9 -0
package/L4_Orchestration/facade/manager_registry.js +118 -0
package/L4_Orchestration/facade/renderer_registry.js +274 -0
package/L4_Orchestration/lifecycle/asset_loader.js +255 -0
package/L4_Orchestration/lifecycle/initializer.js +135 -0
package/L4_Orchestration/lifecycle/lifecycle.js +8 -0
package/L4_Orchestration/rendering/facade.js +94 -0
package/L4_Orchestration/rendering/rendering.js +7 -0
package/LICENSE +21 -0
package/README.md +82 -0
package/bifrost_client.js +204 -0
package/bifrost_core.js +1686 -0
package/docs/ARCHITECTURE.md +111 -0
package/docs/PROTOCOL.md +106 -0
package/docs/RENDERERS.md +101 -0
package/docs/SECURITY.md +92 -0
package/package.json +24 -0
package/syntax/prism-zconfig.js +41 -0
package/syntax/prism-zenv.js +69 -0
package/syntax/prism-zolo-theme.css +288 -0
package/syntax/prism-zolo.js +380 -0
package/syntax/prism-zschema.js +38 -0
package/syntax/prism-zspark.js +25 -0
package/syntax/prism-zui.js +68 -0
package/zSys/accessibility/accessibility.js +10 -0
package/zSys/accessibility/emoji_accessibility.js +173 -0
package/zSys/dom/block_utils.js +122 -0
package/zSys/dom/container_utils.js +370 -0
package/zSys/dom/dom.js +13 -0
package/zSys/dom/dom_utils.js +328 -0
package/zSys/dom/encoding_utils.js +117 -0
package/zSys/dom/style_utils.js +71 -0
package/zSys/errors/error_display.js +299 -0
package/zSys/errors/errors.js +10 -0
package/zSys/theme/color_utils.js +274 -0
package/zSys/theme/dark_mode_utils.js +272 -0
package/zSys/theme/size_utils.js +256 -0
package/zSys/theme/spacing_utils.js +405 -0
package/zSys/theme/theme.js +14 -0
package/zSys/theme/zbase.css +1735 -0
package/zSys/theme/zbase_inject.js +161 -0
package/zSys/theme/ztheme_utils.js +305 -0
package/zSys/validation/error_boundary.js +201 -0
package/zSys/validation/validation.js +11 -0
package/zSys/validation/validation_utils.js +238 -0
package/zSys/zSys.js +14 -0

package/L2_Handling/display/primitives/document_structure_primitives.js ADDED Viewed

@@ -0,0 +1,319 @@
+/**
+ *
+ * Document Structure Primitives - Semantic HTML5 Landmarks
+ *
+ *
+ * Semantic HTML5 elements that define document structure and meaning.
+ * These provide accessibility landmarks and improve SEO.
+ *
+ * @module rendering/document_structure_primitives
+ * @layer 0.0 (RAWEST - semantic structure)
+ * @pattern Pure Factory Functions
+ *
+ * Philosophy:
+ * - Semantic structure over generic divs
+ * - Accessibility landmarks (ARIA roles implicit)
+ * - SEO and screen reader optimization
+ * - NO styling, NO classes (dress up later)
+ *
+ * Semantic Meaning:
+ * - <header>: Introductory content or navigation (implicit role="banner" at top-level)
+ * - <footer>: Footer content, copyright (implicit role="contentinfo" at top-level)
+ * - <main>: Primary content (implicit role="main", ONE per page)
+ * - <nav>: Navigation links (implicit role="navigation")
+ * - <section>: Thematic grouping with heading (implicit role="region" if labeled)
+ * - <article>: Self-contained content (implicit role="article")
+ * - <aside>: Tangentially related content (implicit role="complementary")
+ *
+ * zReboot Context:
+ * - <main> has flex: 1 (for sticky footer layouts)
+ *
+ * Dependencies:
+ * - utils/dom_utils.js (createElement, setAttributes)
+ *
+ * Exports:
+ * - createHeader(attributes) → HTMLElement
+ * - createFooter(attributes) → HTMLElement
+ * - createMain(attributes) → HTMLElement
+ * - createNav(attributes) → HTMLElement
+ * - createSection(attributes) → HTMLElement
+ * - createArticle(attributes) → HTMLElement
+ * - createAside(attributes) → HTMLElement
+ *
+ * Example:
+ * ```javascript
+ * import { createHeader, createMain, createFooter } from './document_structure_primitives.js';
+ *
+ * const header = createHeader({ id: 'site-header' });
+ * const main = createMain({ id: 'main-content' });
+ * const footer = createFooter({ id: 'site-footer' });
+ *
+ * document.body.appendChild(header);
+ * document.body.appendChild(main);
+ * document.body.appendChild(footer);
+ * ```
+ */
+// ─────────────────────────────────────────────────────────────────
+// Imports
+// ─────────────────────────────────────────────────────────────────
+// Layer 2: Utilities
+import { createElement, setAttributes } from '../../../zSys/dom/dom_utils.js';
+//
+// Top-Level Structural Elements
+//
+/**
+ * Create a <header> element
+ *
+ * Represents introductory content or navigational aids.
+ * Typically contains logo, site title, navigation, search.
+ * When used at top level (direct child of <body>), has implicit role="banner".
+ *
+ * Common Uses:
+ * - Site-wide header (logo, nav, search)
+ * - Article/section headers (title, metadata)
+ * - Modal/dialog headers
+ *
+ * @param {Object} [attributes={}] - HTML attributes (id, class, data-*, etc.)
+ * @returns {HTMLElement} The created header element
+ *
+ * @example
+ * // Site-wide header
+ * const siteHeader = createHeader({ id: 'site-header', class: 'sticky-header' });
+ *
+ * // Article header
+ * const articleHeader = createHeader({ class: 'article-header' });
+ */
+export function createHeader(attributes = {}) {
+  const header = createElement('header');
+  if (Object.keys(attributes).length > 0) {
+    setAttributes(header, attributes);
+  }
+  return header;
+}
+/**
+ * Create a <footer> element
+ *
+ * Represents footer content for its nearest sectioning content or root.
+ * Typically contains copyright, links, contact info.
+ * When used at top level (direct child of <body>), has implicit role="contentinfo".
+ *
+ * Common Uses:
+ * - Site-wide footer (copyright, links, social)
+ * - Article/section footers (author, tags, share)
+ * - Modal/dialog footers (action buttons)
+ *
+ * @param {Object} [attributes={}] - HTML attributes (id, class, data-*, etc.)
+ * @returns {HTMLElement} The created footer element
+ *
+ * @example
+ * // Site-wide footer
+ * const siteFooter = createFooter({ id: 'site-footer', class: 'sticky-footer' });
+ *
+ * // Article footer
+ * const articleFooter = createFooter({ class: 'article-footer' });
+ */
+export function createFooter(attributes = {}) {
+  const footer = createElement('footer');
+  if (Object.keys(attributes).length > 0) {
+    setAttributes(footer, attributes);
+  }
+  return footer;
+}
+/**
+ * Create a <main> element
+ *
+ * Represents the dominant/primary content of the <body>.
+ * Should be UNIQUE in the document (only ONE <main> per page).
+ * Has implicit role="main" for accessibility.
+ *
+ * zReboot: Sets flex: 1 (allows main to grow in flexbox layouts for sticky footer).
+ *
+ * Best Practice:
+ * - Use once per page
+ * - Contains the primary content (skip nav, sidebars, ads)
+ * - Helps screen readers jump to main content
+ *
+ * @param {Object} [attributes={}] - HTML attributes (id, class, data-*, etc.)
+ * @returns {HTMLElement} The created main element
+ *
+ * @example
+ * // Primary content area
+ * const mainContent = createMain({ id: 'main-content', role: 'main' });
+ *
+ * // In a SPA, might toggle aria-busy during loading
+ * const main = createMain({ 'aria-busy': 'true' });
+ */
+export function createMain(attributes = {}) {
+  const main = createElement('main');
+  if (Object.keys(attributes).length > 0) {
+    setAttributes(main, attributes);
+  }
+  return main;
+}
+/**
+ * Create a <nav> element
+ *
+ * Represents a section with navigation links.
+ * Has implicit role="navigation" for accessibility.
+ * Can have multiple <nav> elements per page (site nav, TOC, breadcrumbs).
+ *
+ * Best Practice:
+ * - Use for major navigation blocks
+ * - Consider aria-label to distinguish multiple navs
+ * - Not every link group needs <nav>, just primary navigation
+ *
+ * @param {Object} [attributes={}] - HTML attributes (id, class, aria-label, etc.)
+ * @returns {HTMLElement} The created nav element
+ *
+ * @example
+ * // Primary site navigation
+ * const mainNav = createNav({ id: 'main-nav', 'aria-label': 'Main navigation' });
+ *
+ * // Table of contents
+ * const tocNav = createNav({ id: 'toc', 'aria-label': 'Table of contents' });
+ *
+ * // Breadcrumb navigation
+ * const breadcrumb = createNav({ 'aria-label': 'Breadcrumb' });
+ */
+export function createNav(attributes = {}) {
+  const nav = createElement('nav');
+  if (Object.keys(attributes).length > 0) {
+    setAttributes(nav, attributes);
+  }
+  return nav;
+}
+//
+// Content Sectioning Elements
+//
+/**
+ * Create a <section> element
+ *
+ * Represents a thematic grouping of content, typically with a heading.
+ * Groups related content together (features, testimonials, chapters).
+ * Has implicit role="region" if it has an accessible name (aria-label/aria-labelledby).
+ *
+ * Best Practice:
+ * - Should have a heading (h1-h6) as a child
+ * - Use when content doesn't fit <article>, <nav>, or <aside>
+ * - Think: "Would this appear in a table of contents?"
+ *
+ * @param {Object} [attributes={}] - HTML attributes (id, class, aria-labelledby, etc.)
+ * @returns {HTMLElement} The created section element
+ *
+ * @example
+ * // Features section
+ * const features = createSection({ id: 'features', 'aria-labelledby': 'features-heading' });
+ *
+ * // Chapter in a document
+ * const chapter = createSection({ class: 'chapter', 'data-chapter': '1' });
+ */
+export function createSection(attributes = {}) {
+  const section = createElement('section');
+  if (Object.keys(attributes).length > 0) {
+    setAttributes(section, attributes);
+  }
+  return section;
+}
+/**
+ * Create an <article> element
+ *
+ * Represents self-contained, independently distributable content.
+ * Think: blog post, news article, forum post, product card, comment.
+ * Has implicit role="article" for accessibility.
+ *
+ * Best Practice:
+ * - Should make sense on its own (syndication test)
+ * - Typically has a heading
+ * - Can be nested (e.g., blog post with comments)
+ *
+ * @param {Object} [attributes={}] - HTML attributes (id, class, data-*, etc.)
+ * @returns {HTMLElement} The created article element
+ *
+ * @example
+ * // Blog post
+ * const post = createArticle({ id: 'post-123', class: 'blog-post' });
+ *
+ * // Product card in e-commerce
+ * const product = createArticle({ 'data-product-id': '456', class: 'product-card' });
+ *
+ * // Comment
+ * const comment = createArticle({ id: 'comment-789', class: 'comment' });
+ */
+export function createArticle(attributes = {}) {
+  const article = createElement('article');
+  if (Object.keys(attributes).length > 0) {
+    setAttributes(article, attributes);
+  }
+  return article;
+}
+/**
+ * Create an <aside> element
+ *
+ * Represents content tangentially related to the main content.
+ * Think: sidebars, callouts, pull quotes, related links.
+ * Has implicit role="complementary" when not nested in <article> or <section>.
+ *
+ * Best Practice:
+ * - Content is related but not essential
+ * - Could be moved to a sidebar without breaking flow
+ * - Not for unrelated content (use <div> or other semantics)
+ *
+ * @param {Object} [attributes={}] - HTML attributes (id, class, aria-label, etc.)
+ * @returns {HTMLElement} The created aside element
+ *
+ * @example
+ * // Sidebar with related content
+ * const sidebar = createAside({ id: 'sidebar', 'aria-label': 'Related articles' });
+ *
+ * // Pull quote in an article
+ * const pullQuote = createAside({ class: 'pull-quote' });
+ *
+ * // Call-to-action box
+ * const cta = createAside({ class: 'cta-box', 'data-cta': 'newsletter' });
+ */
+export function createAside(attributes = {}) {
+  const aside = createElement('aside');
+  if (Object.keys(attributes).length > 0) {
+    setAttributes(aside, attributes);
+  }
+  return aside;
+}
+//
+// Default Export (for convenience)
+//
+export default {
+  createHeader,
+  createFooter,
+  createMain,
+  createNav,
+  createSection,
+  createArticle,
+  createAside
+};