@mildastudio/milda 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -1,724 +0,0 @@
-type Id = string;
-interface TypeRef {
-    kind: 'ref';
-    ref: Id;
-}
-type TypeExpr = {
-    kind: 'string';
-} | {
-    kind: 'number';
-    min?: number;
-    max?: number;
-} | {
-    kind: 'boolean';
-} | {
-    kind: 'enum';
-    values: string[];
-} | {
-    kind: 'union';
-    members: TypeExpr[];
-} | TypeRef | {
-    kind: 'array';
-    item: TypeExpr;
-} | {
-    kind: 'object';
-    fields: ObjectField[];
-} | {
-    kind: 'component';
-    componentIds?: Id[];
-};
-interface ObjectField {
-    id: Id;
-    name: string;
-    type: TypeExpr;
-    required: boolean;
-    description?: string;
-}
-type PropValue = string | number | boolean | PropValue[] | {
-    [key: string]: PropValue;
-};
-interface SharedType {
-    id: Id;
-    name: string;
-    description?: string;
-    definition: TypeExpr;
-}
-type ParamBinding = {
-    prop: Id;
-} | {
-    static: PropValue;
-};
-interface DocumentMeta {
-    id: Id;
-    name: string;
-    version: string;
-    description?: string;
-    createdAt?: string;
-    updatedAt?: string;
-}
-type DocumentKind = 'prelude' | 'design-system';
-interface MildaDocumentBase {
-    milda: string;
-    kind: DocumentKind;
-    prelude: string;
-    meta: DocumentMeta;
-}
-
-interface TokenRef {
-    ref: Id;
-}
-type PrimitiveTokenType = 'color' | 'spacing' | 'radius' | 'size' | 'shadow' | 'typography' | 'fontFamily' | 'duration' | 'opacity' | 'blur' | 'tonal' | 'border';
-type FacetTokenType = 'elevation' | 'ring' | 'backdrop' | 'none';
-type TokenType$1 = PrimitiveTokenType | FacetTokenType;
-type ColorSpace = 'srgb' | 'display-p3' | 'oklch' | 'hsl';
-interface ColorValue {
-    space: ColorSpace;
-    channels: number[];
-    alpha?: number;
-}
-type DimensionUnit = 'scaled' | 'fixed' | 'percent' | 'em';
-interface DimensionValue {
-    value: number;
-    unit: DimensionUnit;
-}
-type ColorOrRef = ColorValue | TokenRef;
-type DimensionOrRef = DimensionValue | TokenRef;
-interface ShadowLayer {
-    offsetX: DimensionValue;
-    offsetY: DimensionValue;
-    blur: DimensionValue;
-    spread: DimensionValue;
-    color: ColorOrRef;
-    inset: boolean;
-}
-interface ShadowValue {
-    layers: ShadowLayer[];
-}
-type FontCategory = 'sans' | 'serif' | 'mono' | 'display';
-interface FontFamilyValue {
-    family: string;
-    fallback: string[];
-    category: FontCategory;
-    assetId?: Id | null;
-}
-interface TypographyValue {
-    family: TokenRef | FontFamilyValue;
-    size: DimensionValue;
-    weight: number;
-    lineHeight: DimensionValue | {
-        ratio: number;
-    };
-    letterSpacing: DimensionValue;
-    italic?: boolean;
-    uppercase?: boolean;
-}
-interface DurationValue {
-    ms: number;
-}
-interface OpacityValue {
-    value: number;
-}
-interface BlurValue {
-    radius: DimensionValue;
-}
-interface TonalValue {
-    level: number;
-}
-type BorderWidth = 'hairline' | 'thin' | 'thick' | DimensionValue;
-type BorderStyle = 'solid' | 'dashed' | 'dotted' | 'none';
-interface BorderValue {
-    width: BorderWidth;
-    style: BorderStyle;
-    color: ColorOrRef;
-}
-interface NoneValue {
-    none: true;
-}
-interface TokenValueSchemaByType {
-    color: ColorValue;
-    spacing: DimensionValue;
-    radius: DimensionValue;
-    size: DimensionValue;
-    shadow: ShadowValue;
-    typography: TypographyValue;
-    fontFamily: FontFamilyValue;
-    duration: DurationValue;
-    opacity: OpacityValue;
-    blur: BlurValue;
-    tonal: TonalValue;
-    border: BorderValue;
-    elevation: NoneValue;
-    ring: NoneValue;
-    backdrop: NoneValue;
-    none: NoneValue;
-}
-type AnyTokenValue = TokenValueSchemaByType[TokenType$1];
-interface RawTokenValue<T extends TokenType$1 = TokenType$1> {
-    kind: 'raw';
-    value: TokenValueSchemaByType[T];
-}
-interface AliasTokenValue {
-    kind: 'alias';
-    by: Id;
-    refs: Record<string, Id>;
-}
-interface EscapeTokenValue {
-    kind: 'escape';
-    raw: string;
-    note?: string;
-}
-type TokenValue<T extends TokenType$1 = TokenType$1> = RawTokenValue<T> | AliasTokenValue | EscapeTokenValue;
-interface Token$1<T extends TokenType$1 = TokenType$1> {
-    id: Id;
-    name: string;
-    type: T;
-    value: TokenValue<T>;
-    description?: string;
-}
-interface Layer {
-    id: Id;
-    name: string;
-    order: number;
-    tokens: Token$1[];
-}
-interface Context {
-    id: Id;
-    name: string;
-}
-interface ContextGroup {
-    id: Id;
-    name: string;
-    contexts: Context[];
-}
-declare const TOKEN_VALUE_KIND: Record<TokenType$1, 'color' | 'dimension' | 'shadow' | 'typography' | 'fontFamily' | 'duration' | 'opacity' | 'blur' | 'tonal' | 'border' | 'facet'>;
-
-type FacetName = 'fill' | 'ink' | 'border' | 'corner' | 'inset' | 'gap' | 'text' | 'textClamp' | 'textWrap' | 'elevation' | 'overlay' | 'opacity' | 'ring' | 'backdrop';
-type InsetValue = {
-    block?: Id;
-    inline?: Id;
-} | {
-    top?: Id;
-    right?: Id;
-    bottom?: Id;
-    left?: Id;
-} | {
-    all: Id;
-};
-type FacetValue = {
-    token: Id;
-} | {
-    literal: string | number | boolean;
-} | {
-    inset: InsetValue;
-} | {
-    raw: string;
-};
-type FacetMap = Partial<Record<FacetName, FacetValue>>;
-type StackAxis = 'row' | 'column' | 'layers';
-type AxisIntent = 'fit' | 'fill' | {
-    weight: number;
-} | {
-    fixed: Id;
-} | {
-    ratio: {
-        w: number;
-        h: number;
-    };
-};
-interface AxisSize {
-    intent: AxisIntent;
-    min?: Id;
-    max?: Id;
-}
-type AxisSizeValue = AxisIntent | AxisSize;
-type Distribute = 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly';
-type Align = 'start' | 'center' | 'end' | 'stretch' | 'baseline';
-type Position = 'flow' | 'overlay' | {
-    pinned: 'top' | 'bottom' | 'left' | 'right' | 'all';
-};
-interface LayoutSpec {
-    stack?: StackAxis;
-    grid?: {
-        cols: number;
-        rows: number;
-    };
-    flow?: boolean;
-    gap?: Id;
-    inset?: InsetValue;
-    distribute?: Distribute;
-    align?: Align;
-    size?: {
-        width?: AxisSizeValue;
-        height?: AxisSizeValue;
-    };
-    position?: Position;
-}
-type StateName = 'pressed' | 'hovered' | 'focused' | 'active' | 'selected' | 'checked' | 'expanded' | 'open' | 'disabled' | 'readonly' | 'loading' | 'error' | 'success' | 'invalid' | 'valid' | 'indeterminate' | 'dragging' | 'empty' | 'complete' | 'first' | 'last' | 'odd' | 'even';
-type Capability = 'input.keyboard' | 'input.pointer' | 'input.touch' | 'input.remote' | 'input.voice' | 'motion.haptic' | 'runtime.dynamic-color' | 'display.density' | 'a11y.screenreader' | 'platform.web' | 'platform.ios' | 'platform.android' | 'platform.tvos';
-
-interface ProjectMetadataEntry {
-    id: Id;
-    key: string;
-    type: TypeExpr;
-    value?: PropValue;
-}
-interface Foundations {
-    contextGroups: ContextGroup[];
-    layers: Layer[];
-    sharedTypes: SharedType[];
-    metadata: ProjectMetadataEntry[];
-}
-
-interface AtomParam {
-    name: string;
-    bind?: boolean;
-}
-interface AtomContextVar {
-    name: string;
-    type?: string;
-    init?: string;
-}
-interface AtomStateNode {
-    id: string;
-    initial?: boolean;
-}
-interface AtomEvent {
-    name: string;
-    args?: string[];
-}
-interface Emit {
-    event: string;
-    arg?: string | boolean | number;
-}
-interface Assignment {
-    target: string;
-    expr: string;
-}
-type TransitionTarget = string | {
-    expr: string;
-};
-interface Transition {
-    from: string;
-    on?: string;
-    after?: string;
-    when?: string;
-    to?: TransitionTarget;
-    ctx?: Assignment[];
-    emit?: Emit;
-    do?: string;
-    note?: string;
-}
-interface Expose {
-    state: string;
-    when: string;
-    arg?: string;
-}
-interface RequiresClause {
-    anyOf: Capability[];
-    when?: string;
-}
-interface Atom {
-    kind: 'atom';
-    name: string;
-    doc?: string;
-    requires?: RequiresClause[];
-    params?: AtomParam[];
-    context?: AtomContextVar[];
-    states?: AtomStateNode[];
-    events?: AtomEvent[];
-    transitions: Transition[];
-    exposes?: Expose[];
-    emits?: {
-        name: string;
-    }[];
-    modes?: string[];
-    note?: string;
-}
-type CoordEntry = {
-    kind: 'wire';
-    from: string;
-    to: string;
-    arg?: string;
-    when?: string;
-} | {
-    kind: 'gate';
-    machine: string;
-    activeWhen: string;
-} | {
-    kind: 'broadcast';
-    set: string;
-    event: string;
-} | {
-    kind: 'aggregate';
-    op: 'all' | 'any' | 'count' | 'first';
-    set: string;
-    pred: string;
-    as?: string;
-    then?: string;
-} | {
-    kind: 'arena';
-    over: string[];
-    exclusive: boolean;
-} | {
-    kind: 'requiresFail';
-    gesture: string;
-    failsAfter: string;
-};
-interface UsesClause {
-    atom: string;
-    as: string;
-    params?: Record<string, string>;
-}
-interface CompositeBehavior {
-    kind: 'composite';
-    name: string;
-    builtFrom: string[];
-    uses?: UsesClause[];
-    composition?: CoordEntry[];
-    note?: string;
-}
-type ArchetypeGroup = 'Actions' | 'Inputs' | 'Disclosure' | 'Navigation' | 'Collections' | 'Feedback' | 'Media';
-interface ContentCategory {
-    level: 'phrase' | 'region';
-    interactive: boolean;
-}
-interface ArchetypeRealize {
-    target: string;
-    when?: string;
-    surface?: string;
-    browse?: string;
-    commit?: 'explicit' | 'continuous';
-    drop?: string[];
-    wire?: {
-        from: string;
-        to: string;
-        arg?: string;
-    }[];
-    note?: string;
-}
-type PartRole = 'container' | 'item' | 'text' | 'control' | 'input' | 'icon' | 'content';
-interface AnatomyPart {
-    name: string;
-    role: PartRole;
-    optional?: boolean;
-    children?: AnatomyPart[];
-}
-interface ArchetypeDef {
-    kind: 'archetype';
-    name: string;
-    group: ArchetypeGroup;
-    contract: string;
-    produces: ContentCategory;
-    anatomy?: AnatomyPart[];
-    composes: string[];
-    uses?: UsesClause[];
-    composition?: CoordEntry[];
-    exposes?: Expose[];
-    emits?: {
-        name: string;
-        from?: string;
-    }[];
-    realize?: ArchetypeRealize[];
-    realizationNote?: string;
-}
-interface FacetDef {
-    name: FacetName;
-    covers: string;
-    divergence?: string;
-}
-interface StateDef {
-    name: StateName;
-    from: string;
-}
-interface CapabilityDef {
-    name: Capability;
-    note?: string;
-    status?: 'aspirational';
-}
-interface TaxonomyNote {
-    name: string;
-    note: string;
-}
-interface PreludeDocument extends MildaDocumentBase {
-    kind: 'prelude';
-    atoms: Atom[];
-    composites: CompositeBehavior[];
-    archetypes: ArchetypeDef[];
-    facets: FacetDef[];
-    states: StateDef[];
-    capabilities: CapabilityDef[];
-    decorations: TaxonomyNote[];
-    nonBehaviors: TaxonomyNote[];
-}
-
-interface PropDef {
-    id: Id;
-    name: string;
-    type: TypeExpr;
-    default?: PropValue;
-    required?: boolean;
-    description?: string;
-    binding?: string;
-}
-interface EventDef {
-    id?: Id;
-    name: string;
-    from?: string;
-    payload?: TypeExpr;
-    description?: string;
-}
-interface Contract {
-    params: Record<string, ParamBinding>;
-    props: PropDef[];
-    events: EventDef[];
-}
-interface PartState {
-    layout?: LayoutSpec;
-    facets?: FacetMap;
-}
-interface PartVariant {
-    when?: RealizeCond;
-    states?: StateName[];
-    facets?: FacetMap;
-    layout?: LayoutSpec;
-}
-interface Part {
-    layout?: LayoutSpec;
-    facets?: FacetMap;
-    states?: Partial<Record<StateName, PartState>>;
-    variants?: PartVariant[];
-}
-type Anatomy = Record<string, Part>;
-interface RealizeCond {
-    prop: string;
-    eq: string | number | boolean;
-}
-interface Wire {
-    from: string;
-    to: string;
-    arg?: string;
-    when?: RealizeCond;
-}
-interface PresentationRealize {
-    surface?: string;
-    place?: string;
-    flip?: boolean;
-    matchWidth?: boolean;
-}
-interface BrowseRealize {
-    mode?: string;
-    orient?: 'horizontal' | 'vertical';
-    wrap?: boolean;
-}
-interface CommitRealize {
-    mode: 'explicit' | 'continuous';
-    on?: string[];
-}
-interface Realization {
-    target: string;
-    when: RealizeCond | null;
-    presentation?: PresentationRealize;
-    browse?: BrowseRealize;
-    commit?: CommitRealize;
-    surface?: string;
-    drop?: string[];
-    wire?: Wire[];
-    note?: string;
-}
-interface Composition {
-    uses: UsesClause[];
-    coordination: CoordEntry[];
-}
-interface Component {
-    id: Id;
-    name: string;
-    description?: string;
-    archetype: string;
-    contract: Contract;
-    anatomy: Anatomy;
-    realize: Realization[];
-    composition?: Composition;
-}
-
-type AssetKind = 'font' | 'image' | 'svg' | 'video' | 'animation';
-interface BaseAsset {
-    id: string;
-    name: string;
-    kind: AssetKind;
-    mimeType: string;
-    sizeBytes: number;
-    uploadedAt: string;
-    url: string;
-    tags: string[];
-    folderId: string | null;
-}
-interface FontAsset extends BaseAsset {
-    kind: 'font';
-    fontFamily: string;
-    fontStyle: 'normal' | 'italic';
-    fontWeight: number;
-    formats: Array<'woff2' | 'woff' | 'ttf' | 'otf'>;
-}
-interface ImageAsset extends BaseAsset {
-    kind: 'image';
-    width: number;
-    height: number;
-    alt: string;
-}
-interface SvgAsset extends BaseAsset {
-    kind: 'svg';
-    viewBox: string;
-    width: number;
-    height: number;
-}
-interface VideoAsset extends BaseAsset {
-    kind: 'video';
-    width: number;
-    height: number;
-    durationMs: number;
-    poster?: string;
-}
-type AnimationFormat = 'lottie' | 'rive' | 'css';
-interface AnimationAsset extends BaseAsset {
-    kind: 'animation';
-    format: AnimationFormat;
-    durationMs: number;
-    loop: boolean;
-}
-type Asset = FontAsset | ImageAsset | SvgAsset | VideoAsset | AnimationAsset;
-type AssetByKind = {
-    font: FontAsset;
-    image: ImageAsset;
-    svg: SvgAsset;
-    video: VideoAsset;
-    animation: AnimationAsset;
-};
-interface AssetFolder {
-    id: string;
-    name: string;
-    parentId: string | null;
-    createdAt: string;
-}
-interface AssetRegistry {
-    assets: Record<string, Asset>;
-    folders: Record<string, AssetFolder>;
-}
-
-interface Project extends MildaDocumentBase {
-    kind: 'design-system';
-    foundations: Foundations;
-    assets: AssetRegistry;
-    components: Component[];
-}
-
-declare const preludeV0: PreludeDocument;
-declare const atomsByName: Record<string, Atom>;
-declare const archetypesByName: Record<string, ArchetypeDef>;
-
-type ResolvedToken = {
-    kind: 'value';
-    type: TokenType$1;
-    value: AnyTokenValue;
-} | {
-    kind: 'escape';
-    raw: string;
-    note?: string;
-} | null;
-declare function resolveToken(tokenId: string, contextIds: string | readonly string[], layers: Layer[], _depth?: number): ResolvedToken;
-declare function findToken(tokenId: string, layers: Layer[]): {
-    token: Token$1;
-    layerId: string;
-} | null;
-declare function allTokensOfType(type: TokenType$1, layers: Layer[]): Array<{
-    token: Token$1;
-    layerId: string;
-    layerName: string;
-}>;
-
-interface ResolveFacetsInput {
-    part: Part;
-    activeStates: ReadonlySet<StateName>;
-    stateOrder?: StateName[];
-}
-declare function resolveFacets(input: ResolveFacetsInput): FacetMap;
-declare function resolveLayout(input: ResolveFacetsInput): LayoutSpec | undefined;
-declare function collectActiveStates(flags: Partial<Record<StateName, boolean>>): ReadonlySet<StateName>;
-
-interface ValidationIssue {
-    severity: 'error' | 'warning';
-    code: string;
-    message: string;
-    where?: string;
-}
-declare function validate(doc: Project, prelude: PreludeDocument): ValidationIssue[];
-
-interface Hole {
-    kind: 'facet' | 'layout' | 'behavior';
-    name: string;
-    where: string;
-    reason: string;
-}
-interface Substitution {
-    behavior: string;
-    via: string;
-}
-interface ConformanceReport {
-    target: string;
-    complete: boolean;
-    holes: Hole[];
-    substitutions: Substitution[];
-}
-interface ConformanceOptions {
-    target: string;
-    contextIds: string[];
-    layers: Layer[];
-}
-declare function conformance(comp: Component, opts: ConformanceOptions): ConformanceReport;
-
-interface DesignSystemDocument {
-    milda: string;
-    kind: 'design-system';
-    prelude: string;
-    meta: {
-        id: string;
-        name: string;
-        version: string;
-        description?: string;
-    };
-    foundations: Foundations;
-    components: Component[];
-}
-interface ParseIssue {
-    severity: 'error' | 'warning';
-    code: string;
-    message: string;
-    line: number;
-    col: number;
-}
-interface ParseResult {
-    document: DesignSystemDocument;
-    issues: ParseIssue[];
-}
-interface ParseOptions {
-    name?: string;
-    milda?: string;
-    prelude?: string;
-}
-declare function parseMildaDocument(src: string, opts?: ParseOptions): ParseResult;
-
-type TokenType = 'word' | 'string' | 'lbrace' | 'rbrace' | 'lparen' | 'rparen' | 'lt' | 'gt' | 'colon' | 'equals' | 'comma' | 'semi' | 'question' | 'arrow' | 'newline' | 'eof';
-interface Token {
-    type: TokenType;
-    value: string;
-    pos: number;
-    line: number;
-    col: number;
-}
-declare class LexError extends Error {
-    line: number;
-    col: number;
-    constructor(message: string, line: number, col: number);
-}
-declare function lex(src: string): Token[];
-
-export { type AliasTokenValue, type Align, type Anatomy, type AnatomyPart, type AnimationAsset, type AnimationFormat, type AnyTokenValue, type ArchetypeDef, type ArchetypeGroup, type ArchetypeRealize, type Asset, type AssetByKind, type AssetFolder, type AssetKind, type AssetRegistry, type Assignment, type Atom, type AtomContextVar, type AtomEvent, type AtomParam, type AtomStateNode, type AxisIntent, type AxisSize, type AxisSizeValue, type BlurValue, type BorderStyle, type BorderValue, type BorderWidth, type BrowseRealize, type Capability, type CapabilityDef, type ColorOrRef, type ColorSpace, type ColorValue, type CommitRealize, type Component, type CompositeBehavior, type Composition, type ConformanceOptions, type ConformanceReport, type ContentCategory, type Context, type ContextGroup, type Contract, type CoordEntry, type DesignSystemDocument, type DimensionOrRef, type DimensionUnit, type DimensionValue, type Distribute, type DocumentKind, type DocumentMeta, type Token as DslToken, type DurationValue, type Emit, type EscapeTokenValue, type EventDef, type Expose, type FacetDef, type FacetMap, type FacetName, type FacetTokenType, type FacetValue, type FontAsset, type FontCategory, type FontFamilyValue, type Foundations, type Hole, type Id, type ImageAsset, type InsetValue, type Layer, type LayoutSpec, LexError, type MildaDocumentBase, type NoneValue, type ObjectField, type OpacityValue, type ParamBinding, type ParseIssue, type ParseOptions, type ParseResult, type Part, type PartRole, type PartState, type PartVariant, type Position, type PreludeDocument, type PresentationRealize, type PrimitiveTokenType, type Project, type DocumentMeta as ProjectMeta, type ProjectMetadataEntry, type PropDef, type PropValue, type RawTokenValue, type Realization, type RealizeCond, type RequiresClause, type ResolveFacetsInput, type ResolvedToken, type ShadowLayer, type ShadowValue, type SharedType, type StackAxis, type StateDef, type StateName, type Substitution, type SvgAsset, TOKEN_VALUE_KIND, type TaxonomyNote, type Token$1 as Token, type TokenRef, type TokenType$1 as TokenType, type TokenValue, type TokenValueSchemaByType, type TonalValue, type Transition, type TransitionTarget, type TypeExpr, type TypeRef, type TypographyValue, type UsesClause, type ValidationIssue, type VideoAsset, type Wire, allTokensOfType, archetypesByName, atomsByName, collectActiveStates, conformance, findToken, lex, parseMildaDocument, preludeV0, resolveFacets, resolveLayout, resolveToken, validate };