npm - @almadar/ui - Versions diffs - 5.79.0 → 5.79.1 - Mend

@almadar/ui 5.79.0 → 5.79.1

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 (689) hide show

package/dist/lib/getNestedValue.d.ts DELETED Viewed

@@ -1,34 +0,0 @@
-import type { EventPayload, FieldValue } from '@almadar/core';
-/**
- * Get Nested Value Utility
- *
- * Safely retrieves nested values from objects using dot-notation paths.
- * Used by display components to support relation field access like "company.name".
- *
- * @packageDocumentation
- */
-/**
- * Get a nested value from an object using dot-notation path.
- *
- * @param obj - The object to traverse
- * @param path - Dot-notation path (e.g., "company.name", "address.city")
- * @returns The value at the path, or undefined if not found
- *
- * @example
- * const data = { company: { name: "Acme Corp", address: { city: "NYC" } } };
- * getNestedValue(data, "company.name");         // => "Acme Corp"
- * getNestedValue(data, "company.address.city"); // => "NYC"
- * getNestedValue(data, "company.missing");      // => undefined
- */
-export declare function getNestedValue(obj: EventPayload | Record<string, FieldValue | undefined> | null | undefined, path: string): FieldValue | undefined;
-/**
- * Format a nested field path as a human-readable label.
- *
- * @param path - Dot-notation path (e.g., "company.name")
- * @returns Formatted label (e.g., "Company Name")
- *
- * @example
- * formatFieldLabel("company.name");    // => "Company Name"
- * formatFieldLabel("address.zipCode"); // => "Address Zip Code"
- */
-export declare function formatNestedFieldLabel(path: string): string;

package/dist/lib/guardRegistry.d.ts DELETED Viewed

@@ -1,33 +0,0 @@
-/**
- * Guard Registry - Tracks guard evaluations for debugging
- *
- * @packageDocumentation
- */
-import type { FieldValue } from '@almadar/core';
-export interface GuardContext {
-    traitName?: string;
-    type?: "transition" | "tick";
-    transitionFrom?: string;
-    transitionTo?: string;
-    tickName?: string;
-    [key: string]: FieldValue | undefined;
-}
-export interface GuardEvaluation {
-    id: string;
-    traitName: string;
-    guardName: string;
-    expression: string;
-    result: boolean;
-    context: GuardContext;
-    timestamp: number;
-    /** Input values used in guard evaluation */
-    inputs: Record<string, FieldValue>;
-}
-type ChangeListener = () => void;
-export declare function recordGuardEvaluation(evaluation: Omit<GuardEvaluation, "id" | "timestamp">): void;
-export declare function getGuardHistory(): GuardEvaluation[];
-export declare function getRecentGuardEvaluations(count: number): GuardEvaluation[];
-export declare function getGuardEvaluationsForTrait(traitName: string): GuardEvaluation[];
-export declare function subscribeToGuardChanges(listener: ChangeListener): () => void;
-export declare function clearGuardHistory(): void;
-export {};

package/dist/lib/iconFamily.d.ts DELETED Viewed

@@ -1,41 +0,0 @@
-/**
- * Icon family runtime resolver (Layer 1 Iconography axis).
- *
- * Reads the active `--icon-family` CSS variable from the document element and
- * dispatches a canonical icon name (kebab-case, matching lucide's vocabulary)
- * to the equivalent component in the active family. Subscribes to data-theme
- * attribute changes via MutationObserver so a theme switch re-renders icons
- * into the new family without a page reload.
- *
- * Canonical name = lucide name. Per-family alias tables resolve cross-family
- * naming differences (e.g. lucide's `search` is phosphor's `MagnifyingGlass`).
- * For names not mapped in the active family, falls back to lucide and logs a
- * console.warn — preserves semantic over family purity.
- *
- * See `docs/Almadar_Std_Variations.md` §2 and `themes/_contract.md`.
- */
-import React from 'react';
-import type { IconFamily as IconFamilyType } from '@almadar/core';
-export type IconFamily = IconFamilyType;
-/** Adapter props that EVERY family-specific icon component accepts at this layer. */
-export interface RenderedIconProps {
-    className?: string;
-    strokeWidth?: number;
-    size?: number;
-    style?: React.CSSProperties;
-}
-/** Read --icon-family from <html> at runtime. Returns 'lucide' on SSR. */
-export declare function getCurrentIconFamily(): IconFamily;
-/** React hook: returns the active icon family, re-renders on theme switch. */
-export declare function useIconFamily(): IconFamily;
-/**
- * Dispatch a canonical icon name to the right family component.
- * Falls back to lucide (with console.warn) when the family has no mapping.
- */
-export declare function resolveIconForFamily(name: string, family: IconFamily): React.ComponentType<RenderedIconProps>;
-/**
- * Resolve a canonical icon name to a family-aware component. The returned
- * component re-renders the icon into the active family's library on theme
- * switch (via useIconFamily's MutationObserver subscription).
- */
-export declare function useResolvedIcon(name: string): React.ComponentType<RenderedIconProps>;