@damarkuncoro/meta-architecture-style-engine 0.1.0 → 0.1.1

package/lib/cjs/index.d.ts

@@ -56,7 +56,6 @@ interface StyleResolutionResult {
     readonly valid: boolean;
     readonly nodes: ReadonlyArray<SemanticNode>;
     readonly violations: ReadonlyArray<StyleViolation>;
-    readonly className: string;
 }
 
 /**
@@ -80,6 +79,29 @@ interface ITokenRegistry {
     getAllTokens(): Readonly<Record<string, Token$1>>;
 }
 
+/**
+ * TokenRegistry
+ * Concrete implementation of ITokenRegistry.
+ * Provides immutable access to token definitions.
+ */
+declare class TokenRegistry implements ITokenRegistry {
+    private readonly tokens;
+    constructor(tokens?: Record<string, Token$1>);
+    /**
+     * Get token by ID
+     * @throws Error if token not found
+     */
+    getToken(id: string): Token$1;
+    /**
+     * Check if token exists
+     */
+    hasToken(id: string): boolean;
+    /**
+     * Get all tokens (immutable)
+     */
+    getAllTokens(): Readonly<Record<string, Token$1>>;
+}
+
 /**
  * IThemeResolver
  * Abstraction for theme-aware value resolution.
@@ -105,67 +127,22 @@ interface IThemeResolver {
 }
 
 /**
- * IValidationStrategy
- * Strategy pattern for validation logic.
- * Each strategy handles a specific validation concern.
- */
-interface IValidationStrategy {
-    /**
-     * Validate a single property against a rule
-     * @param property - Property name being validated
-     * @param value - Token ID being validated
-     * @param rule - Style rule to validate against
-     * @param context - Optional style context
-     * @returns Violation if validation fails, null if passes
-     */
-    validate(property: string, value: string, rule: StyleRule, context?: StyleContext): StyleViolation | null;
-    /**
-     * Get strategy name for debugging and logging
-     */
-    getName(): string;
-}
-
-/**
- * StyleResolutionEngine (REFACTORED)
- *
- * Refactored to follow SOLID principles:
- * - SRP: Only handles resolution logic
- * - DIP: Depends on abstractions (ITokenRegistry, IThemeResolver)
- * - OCP: Extensible via validation strategies
- *
- * Responsibilities:
- * - Contract validation against constitution
- * - Semantic node generation
- * - Materialization (temporary, will move to SME)
+ * ThemeResolver
+ * Concrete implementation of IThemeResolver.
+ * Handles theme-aware value resolution.
  */
-declare class StyleResolutionEngine {
-    private readonly tokenRegistry;
-    private readonly themeResolver;
-    private readonly validators;
-    constructor(tokenRegistry: ITokenRegistry, themeResolver: IThemeResolver, validators?: ReadonlyArray<IValidationStrategy>);
-    /**
-     * resolve()
-     * Main function: Validates style contract against constitution
-     *
-     * @param contract - Style contract definition
-     * @param constitution - Component constitution
-     * @param context - Optional style context
-     * @returns Resolution result with nodes, violations, and className
-     */
-    resolve(contract: StyleContractDefinition, constitution: ComponentConstitution, context?: StyleContext): StyleResolutionResult;
+declare class ThemeResolver implements IThemeResolver {
     /**
-     * validateAndResolve()
-     * Internal helper to validate and resolve a single token
+     * Resolve theme value based on current theme
      */
-    private validateAndResolve;
+    resolve(value: ThemeValue, theme: StyleTheme): string;
     /**
-     * materializeToken()
-     * Resolve token value based on context (Theme/Breakpoint)
-     *
-     * NOTE: This is temporary materialization logic.
-     * In Phase 5, this will be replaced by StyleMaterializationEngine (SME).
+     * Get current theme from context
+     * Defaults to 'light' if not specified
      */
-    private materializeToken;
+    getCurrentTheme(context?: {
+        theme?: StyleTheme;
+    }): StyleTheme;
 }
 
 /**
@@ -383,6 +360,61 @@ declare class ContextBinder {
     static createDefaultRules(): ContextBindingRule[];
 }
 
+/**
+ * IValidationStrategy
+ * Strategy pattern for validation logic.
+ * Each strategy handles a specific validation concern.
+ */
+interface IValidationStrategy {
+    /**
+     * Validate a single property against a rule
+     * @param property - Property name being validated
+     * @param value - Token ID being validated
+     * @param rule - Style rule to validate against
+     * @param context - Optional style context
+     * @returns Violation if validation fails, null if passes
+     */
+    validate(property: string, value: string, rule: StyleRule, context?: StyleContext): StyleViolation | null;
+    /**
+     * Get strategy name for debugging and logging
+     */
+    getName(): string;
+}
+
+/**
+ * StyleResolutionEngine (REFACTORED)
+ *
+ * Refactored to follow SOLID principles:
+ * - SRP: Only handles resolution logic
+ * - DIP: Depends on abstractions (ITokenRegistry, IThemeResolver)
+ * - OCP: Extensible via validation strategies
+ *
+ * Responsibilities:
+ * - Contract validation against constitution
+ * - Semantic node generation
+ */
+declare class StyleResolutionEngine {
+    private readonly tokenRegistry;
+    private readonly themeResolver;
+    private readonly validators;
+    constructor(tokenRegistry: ITokenRegistry, themeResolver: IThemeResolver, validators?: ReadonlyArray<IValidationStrategy>);
+    /**
+     * resolve()
+     * Main function: Validates style contract against constitution
+     *
+     * @param contract - Style contract definition
+     * @param constitution - Component constitution
+     * @param context - Optional style context
+     * @returns Resolution result with nodes and violations
+     */
+    resolve(contract: StyleContractDefinition, constitution: ComponentConstitution, context?: StyleContext): StyleResolutionResult;
+    /**
+     * validateAndResolve()
+     * Internal helper to validate and resolve a single token
+     */
+    private validateAndResolve;
+}
+
 /**
  * ViolationAction
  * Action to take when a violation is detected.
@@ -487,6 +519,7 @@ declare class ViolationEngine {
      */
     setDefaultAction(action: ViolationAction): void;
 }
+
 /**
  * DefaultViolationHandlers
  * Common violation handlers for typical scenarios.
@@ -515,45 +548,52 @@ declare class DefaultViolationHandlers {
 }
 
 /**
- * TokenRegistry
- * Concrete implementation of ITokenRegistry.
- * Provides immutable access to token definitions.
+ * AllowedTokenValidator
+ * Validates that token is in the allowed list for a rule.
  */
-declare class TokenRegistry implements ITokenRegistry {
-    private readonly tokens;
-    constructor(tokens?: Record<string, Token$1>);
+declare class AllowedTokenValidator implements IValidationStrategy {
     /**
-     * Get token by ID
-     * @throws Error if token not found
+     * Validate that token is allowed
      */
-    getToken(id: string): Token$1;
+    validate(property: string, tokenId: string, rule: StyleRule, context?: StyleContext): StyleViolation | null;
     /**
-     * Check if token exists
+     * Get strategy name
      */
-    hasToken(id: string): boolean;
+    getName(): string;
+}
+
+/**
+ * DomainValidator
+ * Validates that token domain matches rule domain.
+ */
+declare class DomainValidator implements IValidationStrategy {
+    private readonly tokenRegistry;
+    constructor(tokenRegistry: ITokenRegistry);
     /**
-     * Get all tokens (immutable)
+     * Validate that token domain matches rule domain
      */
-    getAllTokens(): Readonly<Record<string, Token$1>>;
+    validate(property: string, tokenId: string, rule: StyleRule, context?: StyleContext): StyleViolation | null;
+    /**
+     * Get strategy name
+     */
+    getName(): string;
 }
 
 /**
- * ThemeResolver
- * Concrete implementation of IThemeResolver.
- * Handles theme-aware value resolution.
+ * TokenExistenceValidator
+ * Validates that a token exists in the registry.
  */
-declare class ThemeResolver implements IThemeResolver {
+declare class TokenExistenceValidator implements IValidationStrategy {
+    private readonly tokenRegistry;
+    constructor(tokenRegistry: ITokenRegistry);
     /**
-     * Resolve theme value based on current theme
+     * Validate that token exists
      */
-    resolve(value: ThemeValue, theme: StyleTheme): string;
+    validate(property: string, tokenId: string, rule: StyleRule, context?: StyleContext): StyleViolation | null;
     /**
-     * Get current theme from context
-     * Defaults to 'light' if not specified
+     * Get strategy name
      */
-    getCurrentTheme(context?: {
-        theme?: StyleTheme;
-    }): StyleTheme;
+    getName(): string;
 }
 
 /**
@@ -665,6 +705,26 @@ declare class StyleContract {
     toJSON(): Record<string, any>;
 }
 
+interface PlatformAdapter {
+    /**
+     * Platform identifier
+     */
+    readonly platform: 'web' | 'native' | 'canvas';
+    /**
+     * Get initial device type based on environment
+     */
+    getInitialDevice(): 'mobile' | 'tablet' | 'desktop';
+    /**
+     * Subscribe to dimension/resize updates
+     * @returns Unsubscribe function
+     */
+    subscribeToResize(callback: (device: 'mobile' | 'tablet' | 'desktop') => void): () => void;
+    /**
+     * Apply theme side-effects (e.g., adding class to body/html)
+     */
+    applyTheme(theme: 'light' | 'dark'): void;
+}
+
 interface StyleContextState extends StyleContext {
     toggleTheme: () => void;
     setTheme: (theme: StyleTheme) => void;
@@ -672,10 +732,37 @@ interface StyleContextState extends StyleContext {
 interface StyleProviderProps {
     children: ReactNode;
     initialTheme?: StyleTheme;
+    /**
+     * Platform adapter for device detection and theme application.
+     * Defaults to WebPlatformAdapter if not provided.
+     */
+    adapter?: PlatformAdapter;
 }
 declare const StyleProvider: React.FC<StyleProviderProps>;
 declare const useStyleContext: () => StyleContextState;
 
+declare class WebPlatformAdapter implements PlatformAdapter {
+    readonly platform: "web";
+    getInitialDevice(): 'mobile' | 'tablet' | 'desktop';
+    subscribeToResize(callback: (device: 'mobile' | 'tablet' | 'desktop') => void): () => void;
+    applyTheme(theme: 'light' | 'dark'): void;
+}
+
+/**
+ * NativePlatformAdapter
+ *
+ * Implementation for React Native / Native environments.
+ * Currently a stub as we are primarily Web-first, but ensures architecture is ready.
+ *
+ * TODO: Implement with React Native Dimensions/Appearance API
+ */
+declare class NativePlatformAdapter implements PlatformAdapter {
+    readonly platform: "native";
+    getInitialDevice(): 'mobile' | 'tablet' | 'desktop';
+    subscribeToResize(callback: (device: 'mobile' | 'tablet' | 'desktop') => void): () => void;
+    applyTheme(theme: 'light' | 'dark'): void;
+}
+
 interface ValidationPluginMetadata {
     name: string;
     version: string;
@@ -701,18 +788,6 @@ interface ValidationPlugin {
         message?: string;
     }>;
 }
-/**
- * MaseValidationRule
- * Adapts MASE's StyleResolutionEngine to Meta Architecture's ValidationRule interface.
- * Allows "Style Audits" to be run as part of the broader governance pipeline.
- */
-declare class MaseValidationRule implements ValidationRule<any> {
-    name: string;
-    description: string;
-    category: "business";
-    severity: "error";
-    validate(target: any, context: ValidationContext): Promise<ValidationError$1 | null>;
-}
 /**
  * MasePlugin
  * The entry point for Meta Architecture to load MASE capabilities.
@@ -728,15 +803,6 @@ declare class MaseGraphValidationPlugin implements ValidationPlugin {
     }>;
 }
 
-/**
- * Factory untuk membuat pipeline validasi yang sudah dikonfigurasi dengan MASE Plugin.
- * Ini mensimulasikan "System Boot" di environment Enterprise/Server-side.
- */
-declare class CompliancePipelineFactory {
-    static createPipeline(): Promise<ValidationPipeline>;
-    static createMockTargets(): any[];
-}
-
 declare class MaseValidationError extends Error {
     code: string;
     field?: string;
@@ -765,6 +831,28 @@ declare class MaseGovernanceRule implements ValidationRule<MaseContractTarget> {
     validate(target: MaseContractTarget, _context: ValidationContext): Promise<MaseValidationError | null>;
 }
 
+/**
+ * MaseValidationRule
+ * Adapts MASE's StyleResolutionEngine to Meta Architecture's ValidationRule interface.
+ * Allows "Style Audits" to be run as part of the broader governance pipeline.
+ */
+declare class MaseValidationRule implements ValidationRule<any> {
+    name: string;
+    description: string;
+    category: "business";
+    severity: "error";
+    validate(target: any, context: ValidationContext): Promise<ValidationError$1 | null>;
+}
+
+/**
+ * Factory untuk membuat pipeline validasi yang sudah dikonfigurasi dengan MASE Plugin.
+ * Ini mensimulasikan "System Boot" di environment Enterprise/Server-side.
+ */
+declare class CompliancePipelineFactory {
+    static createPipeline(): Promise<ValidationPipeline>;
+    static createMockTargets(): any[];
+}
+
 declare const TOKENS: Record<string, Token$1>;
 
 declare const ButtonConstitution: ComponentConstitution;
@@ -1006,6 +1094,11 @@ declare class ContractDSLParser {
      * @returns Identifier value
      */
     private expectIdentifier;
+    /**
+     * Expect domain token
+     * @returns Domain value
+     */
+    private expectDomain;
     /**
      * Expect context token
      * @returns Context value
@@ -1027,6 +1120,11 @@ declare class ContractDSLParser {
     private advance;
 }
 
+declare class ValidationError extends Error {
+    readonly path: string;
+    constructor(message: string, path: string);
+}
+
 /**
  * Contract DSL Validator
  *
@@ -1044,14 +1142,6 @@ declare class ContractDSLParser {
  * - DDD: Domain-specific validation rules
  */
 
-/**
- * ValidationError
- * Error during validation.
- */
-declare class ValidationError extends Error {
-    readonly path: string;
-    constructor(message: string, path: string);
-}
 /**
  * ValidationResult
  * Result of validation.
@@ -1280,6 +1370,7 @@ interface Materializer<T> {
      */
     materialize(nodes: readonly SemanticNode[], context: MaterializationContext): MaterializationResult<T>;
 }
+
 /**
  * MaterializationError
  * Error during materialization.
@@ -1506,4 +1597,4 @@ declare class PDFMaterializer implements Materializer<PDFStyle> {
     private toCamelCase;
 }
 
-export { type BoundContext, ButtonConstitution, type CSGEdge, type CSGNode, CSSMaterializer, CanonicalStyleGraph, CardConstitution, CompliancePipelineFactory, type ComponentConstitution, type ConstraintRule, ContextBinder, type ContextBindingRule, ContextFactory, ContractDSLCompiler, ContractDSLParser, ContractDSLTokenizer, ContractDSLValidator, DefaultViolationHandlers, type GraphValidation, type MaseContractTarget, MaseGovernanceRule, MaseGraphValidationPlugin, MaseValidationError, MaseValidationRule, type MaterializationContext, MaterializationError, type MaterializationResult, type Materializer, PDFMaterializer, RNMaterializer, type ResponsiveValue, type SemanticNode, type StyleBreakpoint, type StyleContext, StyleContract, type StyleContractDefinition, type StyleDomain, StyleProvider, StyleResolutionEngine, type StyleResolutionResult, type StyleRule, type StyleTheme, type StyleViolation, TOKENS, ThemeResolver, type ThemeValue, type Token$1 as Token, TokenRegistry, type ValidationPlugin, type ValidationPluginConfig, type ValidationPluginMetadata, type ViolationAction, ViolationEngine, type ViolationHandler, type ViolationOutcome, type ViolationSeverity, useStyleContext };
+export { AllowedTokenValidator, type BoundContext, ButtonConstitution, type CSGEdge, type CSGNode, CSSMaterializer, CanonicalStyleGraph, CardConstitution, CompliancePipelineFactory, type ComponentConstitution, type ConstraintRule, ContextBinder, type ContextBindingRule, ContextFactory, ContractDSLCompiler, ContractDSLParser, ContractDSLTokenizer, ContractDSLValidator, DefaultViolationHandlers, DomainValidator, type GraphValidation, type IThemeResolver, type ITokenRegistry, type IValidationStrategy, type MaseContractTarget, MaseGovernanceRule, MaseGraphValidationPlugin, MaseValidationError, MaseValidationRule, type MaterializationContext, MaterializationError, type MaterializationResult, type Materializer, NativePlatformAdapter, PDFMaterializer, type PlatformAdapter, RNMaterializer, type ResponsiveValue, type SemanticNode, type StyleBreakpoint, type StyleContext, StyleContract, type StyleContractDefinition, type StyleDomain, StyleProvider, StyleResolutionEngine, type StyleResolutionResult, type StyleRule, type StyleTheme, type StyleViolation, TOKENS, ThemeResolver, type ThemeValue, type Token$1 as Token, TokenExistenceValidator, TokenRegistry, type ViolationAction, ViolationEngine, type ViolationHandler, type ViolationOutcome, type ViolationSeverity, WebPlatformAdapter, useStyleContext };