@almadar/ui 2.22.2 → 2.24.0

package/dist/components/atoms/PatternTile.d.ts

@@ -0,0 +1,41 @@
+/**
+ * PatternTile Atom
+ *
+ * Mathematically correct Islamic geometric pattern tiles using the
+ * Polygons-in-Contact (PIC) method (Hankin 1925, formalized by Kaplan 2005).
+ *
+ * Construction: A regular polygon tiling is overlaid with star motifs.
+ * Each motif touches the enclosing polygon at EDGE MIDPOINTS only.
+ * Two rays emanate from each midpoint into the polygon at a specific
+ * CONTACT ANGLE (theta). Where rays from adjacent midpoints intersect,
+ * they form the star points. Gap tiles (squares, triangles) between
+ * polygons receive inferred geometry by extending boundary rays inward.
+ *
+ * Variants:
+ *   star8  — 8-fold star-and-cross on 4.8.8 tiling (theta = 67.5 deg)
+ *   star6  — 6-fold star on hexagonal tiling (theta = 60 deg)
+ *   khatam — 8-fold rosette with interlocking kites (theta = 72 deg)
+ *   star10 — 10-fold girih on decagonal tiling (theta = 72 deg)
+ *   star12 — 12-fold on dodecagonal tiling (theta = 75 deg)
+ *
+ * All tiles use stroke only (no fill), rendering as transparent overlays.
+ */
+import React from 'react';
+export type PatternVariant = 'star8' | 'star6' | 'khatam' | 'star10' | 'star12' | 'rosette-double' | 'rosette-filled' | 'seigaiha' | 'greek-key' | 'celtic-knot' | 'kolam' | 'arch' | 'arabesque-vine' | 'arabesque-net';
+export interface PatternTileProps {
+    /** Which geometric pattern to render */
+    variant?: PatternVariant;
+    /** Tile unit size in SVG units */
+    size?: number;
+    /** Stroke color (CSS variable or hex) */
+    color?: string;
+    /** Line thickness */
+    strokeWidth?: number;
+    className?: string;
+}
+export declare const PatternTile: React.FC<PatternTileProps>;
+/** Returns the tile dimensions for a given variant and size */
+export declare function getTileDimensions(variant: PatternVariant, size: number): {
+    width: number;
+    height: number;
+};

package/dist/components/atoms/avl/AvlEffect.d.ts

@@ -4,5 +4,7 @@ export interface AvlEffectProps extends AvlBaseProps {
     effectType: AvlEffectType;
     size?: number;
     label?: string;
+    /** V2: Render a category-colored background circle behind the icon. */
+    showBackground?: boolean;
 }
 export declare const AvlEffect: React.FC<AvlEffectProps>;

package/dist/components/atoms/avl/AvlState.d.ts

@@ -1,10 +1,15 @@
 import React from 'react';
 import type { AvlBaseProps } from './types';
+import { type StateRole } from './types';
 export interface AvlStateProps extends AvlBaseProps {
     name?: string;
     isInitial?: boolean;
     isTerminal?: boolean;
     width?: number;
     height?: number;
+    /** V2: Role-based fill color. When set, overrides monochrome rendering. */
+    role?: StateRole;
+    /** V2: Number of transitions touching this state. Drives proportional width. */
+    transitionCount?: number;
 }
 export declare const AvlState: React.FC<AvlStateProps>;

package/dist/components/atoms/avl/index.d.ts

@@ -1,5 +1,7 @@
 export type { AvlBaseProps, AvlEffectType, AvlFieldTypeKind, AvlPersistenceKind, AvlOperatorNamespace, } from './types';
 export { AVL_OPERATOR_COLORS, AVL_FIELD_TYPE_SHAPES } from './types';
+export type { StateRole, EffectCategory } from './types';
+export { STATE_COLORS, EFFECT_CATEGORY_COLORS, EFFECT_TYPE_TO_CATEGORY, CONNECTION_COLORS, getStateRole } from './types';
 export { AvlOrbital, type AvlOrbitalProps } from './AvlOrbital';
 export { AvlEntity, type AvlEntityProps } from './AvlEntity';
 export { AvlTrait, type AvlTraitProps } from './AvlTrait';

package/dist/components/atoms/avl/types.d.ts

@@ -17,3 +17,37 @@ export type AvlPersistenceKind = 'persistent' | 'runtime' | 'singleton' | 'insta
 export type AvlOperatorNamespace = 'arithmetic' | 'comparison' | 'logic' | 'string' | 'collection' | 'time' | 'control' | 'async';
 export declare const AVL_OPERATOR_COLORS: Record<AvlOperatorNamespace, string>;
 export declare const AVL_FIELD_TYPE_SHAPES: Record<AvlFieldTypeKind, string>;
+export type StateRole = 'initial' | 'terminal' | 'hub' | 'error' | 'default';
+export declare const STATE_COLORS: Record<StateRole, {
+    fill: string;
+    border: string;
+}>;
+export type EffectCategory = 'ui' | 'data' | 'communication' | 'lifecycle' | 'control';
+export declare const EFFECT_CATEGORY_COLORS: Record<EffectCategory, {
+    color: string;
+    bg: string;
+}>;
+export declare const EFFECT_TYPE_TO_CATEGORY: Record<AvlEffectType, EffectCategory>;
+export declare const CONNECTION_COLORS: {
+    readonly forward: {
+        readonly color: "#1E293B";
+        readonly width: 2;
+        readonly dash: "none";
+    };
+    readonly backward: {
+        readonly color: "#94A3B8";
+        readonly width: 1.5;
+        readonly dash: "6 3";
+    };
+    readonly selfLoop: {
+        readonly color: "#CBD5E1";
+        readonly width: 1;
+        readonly dash: "3 2";
+    };
+    readonly emitListen: {
+        readonly color: "#F97316";
+        readonly width: 1.5;
+        readonly dash: "4 3";
+    };
+};
+export declare function getStateRole(name: string, isInitial?: boolean, isTerminal?: boolean, transitionCount?: number, maxTransitionCount?: number): StateRole;

package/dist/components/atoms/index.d.ts

@@ -37,4 +37,5 @@ export { TypewriterText, type TypewriterTextProps } from "./TypewriterText";
 export { SectionHeader, type SectionHeaderProps } from "./SectionHeader";
 export { MarketingStatCard, type StatCardProps as MarketingStatCardProps, type StatCardSize } from "./StatCard";
 export { ContentSection, type ContentSectionProps, type ContentSectionBackground, type ContentSectionPadding, } from "./ContentSection";
+export { PatternTile, getTileDimensions, type PatternTileProps, type PatternVariant } from "./PatternTile";
 export * from "./game";