bead 0.1.0__py3-none-any.whl

bead/deployment/jspsych/ui/styles.py

@@ -0,0 +1,411 @@
+"""Material Design CSS generation for jsPsych experiments.
+
+This module provides the MaterialDesignStylesheet class for generating
+Material Design 3 CSS for bead jsPsych experiments.
+"""
+
+from __future__ import annotations
+
+from typing import Literal
+
+
+class MaterialDesignStylesheet:
+    """Generator for Material Design 3 CSS.
+
+    Generates Material Design 3 compliant CSS for jsPsych experiments.
+
+    Features
+    --------
+    - Color theming (light/dark/auto)
+    - Typography (Roboto font family)
+    - Elevation (shadows)
+    - Ripple effects for buttons
+    - Form controls (inputs, dropdowns, radio buttons)
+
+    See Also
+    --------
+    generate_css : Generate complete Material Design CSS with theme options.
+
+    Examples
+    --------
+    >>> stylesheet = MaterialDesignStylesheet()
+    >>> css = stylesheet.generate_css(theme="light")
+    >>> print(css[:100])
+    """
+
+    def __init__(self) -> None:
+        pass
+
+    def generate_css(
+        self,
+        theme: Literal["light", "dark", "auto"] = "light",
+        primary_color: str = "#6200EE",
+        secondary_color: str = "#03DAC6",
+    ) -> str:
+        """Generate complete Material Design CSS.
+
+        Parameters
+        ----------
+        theme : Literal["light", "dark", "auto"]
+            Color theme (light, dark, or auto).
+        primary_color : str
+            Primary color as hex code.
+        secondary_color : str
+            Secondary color as hex code.
+
+        Returns
+        -------
+        str
+            Complete CSS stylesheet as string.
+
+        Examples
+        --------
+        >>> stylesheet = MaterialDesignStylesheet()
+        >>> css = stylesheet.generate_css(theme="light", primary_color="#1976D2")
+        >>> "--primary-color" in css
+        True
+        """
+        # determine theme colors
+        if theme == "light":
+            background = "#FFFFFF"
+            surface = "#FFFFFF"
+            on_surface = "#000000"
+            on_primary = "#FFFFFF"
+        elif theme == "dark":
+            background = "#121212"
+            surface = "#1E1E1E"
+            on_surface = "#FFFFFF"
+            on_primary = "#000000"
+        else:  # auto
+            # use CSS media query for system preference
+            background = "#FFFFFF"
+            surface = "#FFFFFF"
+            on_surface = "#000000"
+            on_primary = "#FFFFFF"
+
+        css = f"""
+/* Material Design 3 Stylesheet for bead jsPsych Experiments */
+/* Theme: {theme} */
+
+@import url('https://fonts.googleapis.com/css2?family=Roboto:wght@300;400;500;700&display=swap');
+
+:root {{
+  /* Color palette */
+  --primary-color: {primary_color};
+  --secondary-color: {secondary_color};
+  --background: {background};
+  --surface: {surface};
+  --on-surface: {on_surface};
+  --on-primary: {on_primary};
+  --error: #B00020;
+  --on-error: #FFFFFF;
+
+  /* Typography */
+  --font-family: 'Roboto', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+  --font-size-body: 16px;
+  --font-size-title: 24px;
+  --font-size-label: 14px;
+
+  /* Spacing */
+  --spacing-xs: 4px;
+  --spacing-sm: 8px;
+  --spacing-md: 16px;
+  --spacing-lg: 24px;
+  --spacing-xl: 32px;
+
+  /* Elevation shadows */
+  --elevation-1: 0 1px 3px rgba(0, 0, 0, 0.12), 0 1px 2px rgba(0, 0, 0, 0.24);
+  --elevation-2: 0 3px 6px rgba(0, 0, 0, 0.16), 0 3px 6px rgba(0, 0, 0, 0.23);
+  --elevation-3: 0 10px 20px rgba(0, 0, 0, 0.19), 0 6px 6px rgba(0, 0, 0, 0.23);
+
+  /* Border radius */
+  --radius-sm: 4px;
+  --radius-md: 8px;
+  --radius-lg: 12px;
+  --radius-full: 9999px;
+}}
+
+/* Dark theme media query for auto mode */
+@media (prefers-color-scheme: dark) {{
+  :root {{
+    --background: #121212;
+    --surface: #1E1E1E;
+    --on-surface: #FFFFFF;
+    --on-primary: #000000;
+  }}
+}}
+
+/* Base styles */
+body {{
+  font-family: var(--font-family);
+  font-size: var(--font-size-body);
+  color: var(--on-surface);
+  background-color: var(--background);
+  margin: 0;
+  padding: 0;
+  line-height: 1.5;
+}}
+
+/* Button styles */
+.bead-button {{
+  font-family: var(--font-family);
+  font-size: var(--font-size-body);
+  font-weight: 500;
+  padding: 10px 24px;
+  border: none;
+  border-radius: var(--radius-sm);
+  background-color: var(--primary-color);
+  color: var(--on-primary);
+  cursor: pointer;
+  box-shadow: var(--elevation-2);
+  transition: box-shadow 0.2s, background-color 0.2s;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+}}
+
+.bead-button:hover {{
+  box-shadow: var(--elevation-3);
+}}
+
+.bead-button:active {{
+  box-shadow: var(--elevation-1);
+}}
+
+.bead-button:disabled {{
+  background-color: rgba(0, 0, 0, 0.12);
+  color: rgba(0, 0, 0, 0.38);
+  box-shadow: none;
+  cursor: not-allowed;
+}}
+
+/* Rating scale styles */
+.bead-rating-container {{
+  max-width: 800px;
+  margin: 0 auto;
+  padding: var(--spacing-xl);
+}}
+
+.bead-rating-prompt {{
+  font-size: var(--font-size-title);
+  font-weight: 500;
+  margin-bottom: var(--spacing-lg);
+  text-align: center;
+}}
+
+.bead-rating-scale {{
+  display: flex;
+  justify-content: center;
+  gap: var(--spacing-sm);
+  margin: var(--spacing-lg) 0;
+}}
+
+.bead-rating-option {{
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: var(--spacing-xs);
+}}
+
+.bead-rating-button {{
+  width: 48px;
+  height: 48px;
+  border: 2px solid var(--primary-color);
+  border-radius: var(--radius-full);
+  background-color: transparent;
+  color: var(--primary-color);
+  font-size: var(--font-size-body);
+  font-weight: 500;
+  cursor: pointer;
+  transition: background-color 0.2s, color 0.2s;
+}}
+
+.bead-rating-button:hover {{
+  background-color: rgba(98, 0, 238, 0.08);
+}}
+
+.bead-rating-button.selected {{
+  background-color: var(--primary-color);
+  color: var(--on-primary);
+}}
+
+.bead-rating-label {{
+  font-size: var(--font-size-label);
+  color: var(--on-surface);
+  text-align: center;
+  max-width: 80px;
+}}
+
+.bead-rating-button-container {{
+  display: flex;
+  justify-content: center;
+  margin-top: var(--spacing-xl);
+}}
+
+/* Text field styles */
+.bead-text-field {{
+  font-family: var(--font-family);
+  font-size: var(--font-size-body);
+  padding: 12px 16px;
+  border: 1px solid rgba(0, 0, 0, 0.38);
+  border-radius: var(--radius-sm);
+  background-color: transparent;
+  color: var(--on-surface);
+  transition: border-color 0.2s;
+}}
+
+.bead-text-field:focus {{
+  outline: none;
+  border-color: var(--primary-color);
+  border-width: 2px;
+}}
+
+/* Dropdown styles */
+.bead-dropdown {{
+  font-family: var(--font-family);
+  font-size: var(--font-size-body);
+  padding: 12px 16px;
+  border: 1px solid rgba(0, 0, 0, 0.38);
+  border-radius: var(--radius-sm);
+  background-color: var(--surface);
+  color: var(--on-surface);
+  cursor: pointer;
+  transition: border-color 0.2s;
+}}
+
+.bead-dropdown:focus {{
+  outline: none;
+  border-color: var(--primary-color);
+  border-width: 2px;
+}}
+
+/* Radio group styles */
+.bead-radio-group {{
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-sm);
+}}
+
+.bead-radio-option {{
+  display: flex;
+  align-items: center;
+  gap: var(--spacing-sm);
+  padding: var(--spacing-sm);
+  border-radius: var(--radius-sm);
+  cursor: pointer;
+  transition: background-color 0.2s;
+}}
+
+.bead-radio-option:hover {{
+  background-color: rgba(0, 0, 0, 0.04);
+}}
+
+/* Card styles */
+.bead-card {{
+  background-color: var(--surface);
+  border-radius: var(--radius-md);
+  padding: var(--spacing-md);
+  box-shadow: var(--elevation-1);
+  transition: box-shadow 0.2s;
+}}
+
+.bead-card:hover {{
+  box-shadow: var(--elevation-2);
+}}
+
+/* Progress indicator styles */
+.bead-progress {{
+  width: 100%;
+  height: 4px;
+  background-color: rgba(98, 0, 238, 0.12);
+  position: fixed;
+  top: 0;
+  left: 0;
+  z-index: 1000;
+}}
+
+.bead-progress-bar {{
+  height: 100%;
+  background-color: var(--primary-color);
+  transition: width 0.3s;
+}}
+
+/* Cloze task styles */
+.bead-cloze-container {{
+  max-width: 900px;
+  margin: 0 auto;
+  padding: var(--spacing-xl);
+}}
+
+.bead-cloze-text {{
+  font-size: var(--font-size-body);
+  line-height: 2;
+  margin: var(--spacing-lg) 0;
+}}
+
+.bead-cloze-field {{
+  min-width: 120px;
+  margin: 0 var(--spacing-xs);
+  display: inline-block;
+}}
+
+.bead-cloze-button-container {{
+  display: flex;
+  justify-content: center;
+  margin-top: var(--spacing-xl);
+}}
+
+/* Forced choice styles */
+.bead-forced-choice-container {{
+  max-width: 1000px;
+  margin: 0 auto;
+  padding: var(--spacing-xl);
+}}
+
+.bead-forced-choice-prompt {{
+  font-size: var(--font-size-title);
+  font-weight: 500;
+  margin-bottom: var(--spacing-lg);
+  text-align: center;
+}}
+
+.bead-forced-choice-alternatives {{
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: var(--spacing-lg);
+  margin: var(--spacing-lg) 0;
+}}
+
+.bead-alternative {{
+  padding: var(--spacing-lg);
+  transition: transform 0.2s, box-shadow 0.2s;
+}}
+
+.bead-alternative:hover {{
+  transform: translateY(-2px);
+}}
+
+.bead-alternative.selected {{
+  border: 2px solid var(--primary-color);
+  box-shadow: var(--elevation-3);
+}}
+
+.bead-alternative-label {{
+  font-size: var(--font-size-label);
+  font-weight: 700;
+  color: var(--primary-color);
+  text-transform: uppercase;
+  letter-spacing: 1px;
+  margin-bottom: var(--spacing-sm);
+}}
+
+.bead-alternative-content {{
+  font-size: var(--font-size-body);
+  margin-bottom: var(--spacing-md);
+  min-height: 60px;
+}}
+
+.bead-choice-button {{
+  width: 100%;
+}}
+"""
+        return css

bead/dsl/__init__.py

@@ -0,0 +1,80 @@
+"""Domain-Specific Language (DSL) for constraint expressions.
+
+Supports boolean operators (and, or, not), comparison operators, membership
+tests, arithmetic, function calls, attribute access, and list literals.
+"""
+
+from typing import Any
+
+from bead.dsl.ast import (
+    ASTNode,
+    AttributeAccess,
+    BinaryOp,
+    FunctionCall,
+    ListLiteral,
+    Literal,
+    UnaryOp,
+    Variable,
+)
+from bead.dsl.context import EvaluationContext
+from bead.dsl.errors import DSLError, EvaluationError, ParseError
+from bead.dsl.evaluator import Evaluator
+from bead.dsl.parser import parse
+from bead.dsl.stdlib import SIMULATION_FUNCTIONS, STDLIB_FUNCTIONS, register_stdlib
+
+__all__ = [
+    # AST nodes
+    "ASTNode",
+    "Literal",
+    "Variable",
+    "BinaryOp",
+    "UnaryOp",
+    "FunctionCall",
+    "ListLiteral",
+    "AttributeAccess",
+    # Errors
+    "DSLError",
+    "ParseError",
+    "EvaluationError",
+    # Parser
+    "parse",
+    # Evaluation
+    "Evaluator",
+    "EvaluationContext",
+    "evaluate",
+    # Standard library
+    "STDLIB_FUNCTIONS",
+    "SIMULATION_FUNCTIONS",
+    "register_stdlib",
+]
+
+
+# Convenience function
+def evaluate(node: ASTNode, context: EvaluationContext, use_cache: bool = True) -> Any:
+    """Evaluate a constraint expression.
+
+    Parameters
+    ----------
+    node : ASTNode
+        Parsed AST node to evaluate.
+    context : EvaluationContext
+        Evaluation context with variables and functions.
+    use_cache : bool
+        Whether to use caching.
+
+    Returns
+    -------
+    Any
+        Result of evaluation.
+
+    Examples
+    --------
+    >>> from bead.dsl import parse, EvaluationContext
+    >>> ctx = EvaluationContext()
+    >>> ctx.set_variable("x", 10)
+    >>> node = parse("x > 5")
+    >>> evaluate(node, ctx)
+    True
+    """
+    evaluator = Evaluator(use_cache=use_cache)
+    return evaluator.evaluate(node, context)

bead/dsl/ast.py

@@ -0,0 +1,168 @@
+"""Abstract Syntax Tree node definitions for constraint DSL.
+
+This module defines the AST nodes that represent parsed constraint expressions.
+Each node type corresponds to a construct in the constraint DSL grammar.
+"""
+
+from __future__ import annotations
+
+from bead.data.base import BeadBaseModel
+
+
+class ASTNode(BeadBaseModel):
+    """Base class for all AST nodes.
+
+    All AST nodes inherit from BeadBaseModel to get:
+    - Automatic validation
+    - Serialization support
+    - Metadata tracking
+    """
+
+    pass
+
+
+class Literal(ASTNode):
+    """Literal value node (string, number, boolean).
+
+    Examples
+    --------
+    >>> node = Literal(value="hello")
+    >>> node.value
+    'hello'
+    >>> node = Literal(value=42)
+    >>> node.value
+    42
+    """
+
+    value: str | int | float | bool
+
+
+class Variable(ASTNode):
+    """Variable reference node.
+
+    References a variable in the evaluation context (e.g., item attributes).
+
+    Examples
+    --------
+    >>> node = Variable(name="lemma")
+    >>> node.name
+    'lemma'
+    """
+
+    name: str
+
+
+class BinaryOp(ASTNode):
+    """Binary operation node.
+
+    Represents operations like: a == b, x > y, p and q
+
+    Attributes
+    ----------
+    operator : str
+        The operator (==, !=, <, >, <=, >=, and, or, in, etc.)
+    left : ASTNode
+        Left operand
+    right : ASTNode
+        Right operand
+
+    Examples
+    --------
+    >>> left = Variable(name="pos")
+    >>> right = Literal(value="VERB")
+    >>> node = BinaryOp(operator="==", left=left, right=right)
+    >>> node.operator
+    '=='
+    """
+
+    operator: str
+    left: ASTNode
+    right: ASTNode
+
+
+class UnaryOp(ASTNode):
+    """Unary operation node.
+
+    Represents operations like: not x, -y
+
+    Examples
+    --------
+    >>> operand = Variable(name="is_transitive")
+    >>> node = UnaryOp(operator="not", operand=operand)
+    >>> node.operator
+    'not'
+    """
+
+    operator: str
+    operand: ASTNode
+
+
+class FunctionCall(ASTNode):
+    """Function call node.
+
+    Represents function calls and method calls like:
+    - len(x), startswith("pre")
+    - obj.method(arg)
+
+    Examples
+    --------
+    >>> func = Variable(name="len")
+    >>> arg = Variable(name="lemma")
+    >>> node = FunctionCall(function=func, arguments=[arg])
+    >>> node.function.name
+    'len'
+    """
+
+    function: ASTNode  # Variable for functions, AttributeAccess for methods
+    arguments: list[ASTNode]
+
+
+class ListLiteral(ASTNode):
+    """List literal node.
+
+    Represents list literals like: ["a", "b", "c"]
+
+    Examples
+    --------
+    >>> elements = [Literal(value="a"), Literal(value="b")]
+    >>> node = ListLiteral(elements=elements)
+    >>> len(node.elements)
+    2
+    """
+
+    elements: list[ASTNode]
+
+
+class AttributeAccess(ASTNode):
+    """Attribute access node.
+
+    Represents attribute access like: item.lemma, obj.property
+
+    Examples
+    --------
+    >>> obj = Variable(name="item")
+    >>> node = AttributeAccess(object=obj, attribute="lemma")
+    >>> node.attribute
+    'lemma'
+    """
+
+    object: ASTNode
+    attribute: str
+
+
+class Subscript(ASTNode):
+    """Subscript access node.
+
+    Represents subscript access like: item['key'], obj[0]
+
+    Examples
+    --------
+    >>> obj = Variable(name="item")
+    >>> key = Literal(value="key")
+    >>> node = Subscript(object=obj, index=key)
+    >>> node.index.value
+    'key'
+    """
+
+    object: ASTNode
+    index: ASTNode