@rasamjs/core 0.2.0 → 0.3.1

package/dist/changes.js

@@ -29,6 +29,7 @@ export function beginChangeGroup(drawing, metadata = {}) {
     const owner = drawing.context.root;
     let id;
     let changes = [];
+    const targets = new Set();
     let invalidated = false;
     // Subscribe before groupstart so edits made by start observers are captured too.
     const unsubscribe = observeChanges(drawing, (event) => {
@@ -36,8 +37,21 @@ export function beginChangeGroup(drawing, metadata = {}) {
             invalidated = true;
         if (id === undefined && event.type === 'groupstart')
             id = event.group;
-        if (event.type === 'change' && event.group === id && !event.temporary)
-            changes = combineChanges([...changes, ...event.changes]);
+        if (event.type !== 'change')
+            return;
+        if (event.group === id && !event.temporary) {
+            for (const change of event.changes) {
+                changes.push(change);
+                targets.add(change.target);
+            }
+        }
+        else if (event.changes.some((change) => targets.has(change.target))) {
+            // A net-zero field must release its old baseline before an outside edit.
+            changes = [...combineChanges(changes)];
+            targets.clear();
+            for (const change of changes)
+                targets.add(change.target);
+        }
     });
     let group;
     try {
@@ -58,6 +72,7 @@ export function beginChangeGroup(drawing, metadata = {}) {
     const finish = (cancelled, restored = false) => {
         active = false;
         changes = [];
+        targets.clear();
         unsubscribe();
         group.end(cancelled, restored);
     };
@@ -89,8 +104,9 @@ export function beginChangeGroup(drawing, metadata = {}) {
             const failures = [];
             try {
                 try {
-                    if (changes.length)
-                        restoreChanges(owner, changes, 'undo');
+                    const combined = combineChanges(changes);
+                    if (combined.length)
+                        restoreChanges(owner, combined, 'undo');
                 }
                 catch (error) {
                     if (error instanceof ChangeObserverError)

package/dist/changes.js.map

@@ -1 +1 @@
-{"version":3,"file":"changes.js","sourceRoot":"","sources":["../src/changes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"changes.js","sourceRoot":"","sources":["../src/changes.ts"],"names":[],"mappings":"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"}

package/dist/components/changes.d.ts

@@ -0,0 +1,34 @@
+import type { AnyNode } from '../core/types.js';
+export interface Binding {
+    readonly node: AnyNode;
+    derive(): void;
+    replay(): void;
+    paint(): void;
+}
+interface Discovery {
+    added(node: AnyNode): void;
+    identityChanged(node: AnyNode): void;
+}
+/** Routes work by changed node, independent of the number of components in a drawing. */
+export declare class ComponentChanges {
+    private readonly bindings;
+    private readonly discovery;
+    private bindingCount;
+    private readonly dirty;
+    private cancelFrame?;
+    private readonly stopDerive;
+    private readonly stopObserve;
+    private readonly context;
+    static for(node: AnyNode): ComponentChanges;
+    private constructor();
+    bind(binding: Binding): () => void;
+    discover(discovery: Discovery): () => void;
+    private release;
+    /** Live state from every instance renders in one shared frame, as one temporary change. */
+    schedule(binding: Binding): void;
+    /** Renders without an undo step; failures surface after every other instance rendered. */
+    paint(bindings: Iterable<Binding>): void;
+    private dispatch;
+}
+export {};
+//# sourceMappingURL=changes.d.ts.map

package/dist/components/changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes.d.ts","sourceRoot":"","sources":["../../src/components/changes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAIhD,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,MAAM,IAAI,IAAI,CAAC;IACf,MAAM,IAAI,IAAI,CAAC;IACf,KAAK,IAAI,IAAI,CAAC;CACf;AACD,UAAU,SAAS;IACjB,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;CACtC;AAGD,yFAAyF;AACzF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IAEzC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAO1C;IAED,OAAO,eAQN;IAED,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,IAAI,CASjC;IAED,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,IAAI,CAGzC;IAED,OAAO,CAAC,OAAO;IAef,2FAA2F;IAC3F,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAM/B;IAED,0FAA0F;IAC1F,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI,CAevC;IAED,OAAO,CAAC,QAAQ;CA0BjB"}

package/dist/components/changes.js

@@ -0,0 +1,119 @@
+import { deriveChanges, observeChanges, withChanges } from '../changes.js';
+const drawings = new WeakMap();
+/** Routes work by changed node, independent of the number of components in a drawing. */
+export class ComponentChanges {
+    bindings = new WeakMap();
+    discovery = new Set();
+    bindingCount = 0;
+    dirty = new Set();
+    cancelFrame;
+    stopDerive;
+    stopObserve;
+    context;
+    static for(node) {
+        let changes = drawings.get(node.context);
+        if (!changes) {
+            changes = new ComponentChanges(node);
+            drawings.set(node.context, changes);
+        }
+        return changes;
+    }
+    constructor(drawing) {
+        this.context = drawing.context;
+        this.stopDerive = deriveChanges(drawing, ({ nodes }) => {
+            for (const node of nodes)
+                this.bindings.get(node)?.derive();
+        });
+        this.stopObserve = observeChanges(drawing, (event) => {
+            if (event.type === 'change')
+                this.dispatch(event);
+        });
+    }
+    bind(binding) {
+        if (this.bindings.has(binding.node))
+            throw new Error('Component is already observing changes');
+        this.bindings.set(binding.node, binding);
+        this.bindingCount++;
+        return this.release(() => {
+            this.bindings.delete(binding.node);
+            this.dirty.delete(binding);
+            this.bindingCount--;
+        });
+    }
+    discover(discovery) {
+        this.discovery.add(discovery);
+        return this.release(() => this.discovery.delete(discovery));
+    }
+    release(cleanup) {
+        let active = true;
+        return () => {
+            if (!active)
+                return;
+            active = false;
+            cleanup();
+            if (!this.bindingCount && !this.discovery.size) {
+                this.cancelFrame?.();
+                this.stopDerive();
+                this.stopObserve();
+                drawings.delete(this.context);
+            }
+        };
+    }
+    /** Live state from every instance renders in one shared frame, as one temporary change. */
+    schedule(binding) {
+        this.dirty.add(binding);
+        this.cancelFrame ??= this.context.dom.requestFrame(() => {
+            this.cancelFrame = undefined;
+            this.paint(this.dirty);
+        });
+    }
+    /** Renders without an undo step; failures surface after every other instance rendered. */
+    paint(bindings) {
+        const list = [...bindings].filter((binding) => !binding.node.isDestroyed);
+        for (const binding of list)
+            this.dirty.delete(binding);
+        if (!list.length)
+            return;
+        const failures = [];
+        withChanges(list[0].node, { source: 'components', temporary: true }, () => {
+            for (const binding of list)
+                try {
+                    binding.paint();
+                }
+                catch (error) {
+                    failures.push(error);
+                }
+        });
+        if (failures.length > 1)
+            throw new AggregateError(failures, 'Component renders failed');
+        if (failures.length)
+            throw failures[0];
+    }
+    dispatch(event) {
+        // Replay skips rendered children, so restored and recreated instances redraw together.
+        const replayed = new Set();
+        for (const change of event.changes) {
+            const node = change.target.node, binding = this.bindings.get(node);
+            if (binding &&
+                event.source === 'replay' &&
+                ((change.domain === 'property' && change.attribute === 'data-rasam-props') ||
+                    (change.domain === 'existence' && change.after)))
+                replayed.add(binding);
+            if (!this.discovery.size)
+                continue;
+            if ((change.domain === 'placement' && change.after.parent && !change.before.parent) ||
+                (change.domain === 'existence' && change.after))
+                for (const subscriber of this.discovery)
+                    subscriber.added(node);
+            else if (change.domain === 'property' && change.attribute === 'data-rasam-component')
+                for (const subscriber of this.discovery)
+                    subscriber.identityChanged(node);
+        }
+        if (!replayed.size)
+            return;
+        for (const binding of replayed)
+            binding.replay();
+        this.paint(replayed);
+    }
+}
+//# sourceMappingURL=changes.js.map

package/dist/components/changes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes.js","sourceRoot":"","sources":["../../src/components/changes.ts"],"names":[],"mappings":"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"}

package/dist/components/component.d.ts

@@ -0,0 +1,62 @@
+import { Group } from '../elements/group.js';
+import type { DrawingContext } from '../services/context.js';
+import type { SvgTemplate } from '../template/svg-tag.js';
+import { derivesChildren } from '../changes/derived.js';
+import { initializeElement } from '../services/initialization.js';
+import type { AttributeValue, Length, PortDefinition } from '../types/common.js';
+import type { creationOptions } from '../services/types.js';
+import type { ActionDefinition, ComponentDefinition, ComponentProps, PropDefinition, PropOptions, ComponentFields } from './types.js';
+export declare const installField: unique symbol;
+export declare const assertField: unique symbol;
+export declare const editComponent: unique symbol;
+export declare const registerAction: unique symbol;
+/** A closed rasam group whose children are rendered from decorated props and live state. */
+export declare abstract class Component extends Group {
+    #private;
+    readonly [creationOptions]: ComponentFields<this>;
+    static readonly ownsChildren = true;
+    /** @internal History restores props; the component redraws its children after replay. */
+    static readonly [derivesChildren] = true;
+    constructor(context: DrawingContext, input?: ComponentProps, existing?: SVGGElement);
+    get componentDefinition(): ComponentDefinition;
+    get editRules(): Readonly<{
+        rotate: NonNullable<number | "free" | false>;
+        flip: boolean;
+        resize: NonNullable<"props" | "scale" | false>;
+    }>;
+    get propDefinitions(): readonly PropDefinition[];
+    /** `@action` methods with their undo labels, in declaration order; overrides relabel. */
+    get actionDefinitions(): readonly ActionDefinition[];
+    /** @internal The `@action` decorator records each method once per instance. */
+    [registerAction](name: string, label: string): void;
+    render(): SvgTemplate;
+    /**
+     * Override to declare connection points, in local coordinates at 0°, from props and
+     * the saved size. Live state never moves a port. Defaults to none.
+     */
+    ports(): readonly PortDefinition[];
+    /** Validated, frozen `ports()`, computed again only when the saved props change. */
+    get portDefinitions(): readonly PortDefinition[];
+    created(): void;
+    destroyed(): void;
+    changed(_name: string): void;
+    validateAttribute(name: string, value: AttributeValue): void;
+    setAttributeValue(name: string, value: AttributeValue): this;
+    attrs(values: Parameters<Group['attrs']>[0]): this;
+    width(): Length | null;
+    width(value: Length): this;
+    height(): Length | null;
+    height(value: Length): this;
+    /** For `resize: 'props'`, one undo step that redraws at once, so callers read new bounds. */
+    size(width: Length, height?: Length): this;
+    resetState(): void;
+    /** @internal Called after decorated fields and reconstructed children are available. */
+    [initializeElement](): void;
+    /** @internal Field decorators install accessors after their initializers execute. */
+    [assertField](name: string): void;
+    /** @internal Field decorators install accessors after their initializers execute. */
+    [installField](name: string, kind: 'prop' | 'state', options: PropOptions, initial: unknown): void;
+    /** @internal Actions share one change group across nested calls and instances. */
+    [editComponent]<Result>(label: string, callback: () => Result): Result;
+}
+//# sourceMappingURL=component.d.ts.map

package/dist/components/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/components/component.ts"],"names":[],"mappings":"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"}

package/dist/components/component.js

@@ -0,0 +1,355 @@
+import { Group } from '../elements/group.js';
+import { beginChangeGroup } from '../changes.js';
+import { derivesChildren, markDerived } from '../changes/derived.js';
+import { initializeElement } from '../services/initialization.js';
+import { definition, isSize, validatePorts, validateProp } from './metadata.js';
+import { ComponentView } from './view.js';
+import { ComponentChanges } from './changes.js';
+import { Attributes } from '../dom/attributes.js';
+export const installField = Symbol('installComponentField');
+export const assertField = Symbol('assertComponentField');
+export const editComponent = Symbol('editComponent');
+export const registerAction = Symbol('registerComponentAction');
+const restoredHooks = new WeakSet();
+const sizes = ['width', 'height'];
+const copy = (value) => value && typeof value === 'object' ? structuredClone(value) : value;
+/** A closed rasam group whose children are rendered from decorated props and live state. */
+export class Component extends Group {
+    static ownsChildren = true;
+    /** @internal History restores props; the component redraws its children after replay. */
+    static [derivesChildren] = true;
+    #fields = new Map();
+    #view = new ComponentView(this);
+    #initialized = false;
+    #constructing = true;
+    #schedule;
+    #observedProps = {};
+    #propsCache;
+    #propDefinitions;
+    #actions = new Map();
+    #ports;
+    #readingPorts = false;
+    #input;
+    #reserved;
+    constructor(context, input = {}, existing) {
+        super(context, {}, existing);
+        this.#input = input;
+        this.#reserved = new Set(Object.getOwnPropertyNames(this));
+    }
+    get componentDefinition() {
+        return definition(this.constructor);
+    }
+    get editRules() {
+        const { rotate, flip, resize } = this.componentDefinition;
+        return Object.freeze({ rotate, flip, resize });
+    }
+    get propDefinitions() {
+        return (this.#propDefinitions ??= Object.freeze([...this.#fields]
+            .filter(([, field]) => field.kind === 'prop')
+            .map(([name, field]) => Object.freeze({ ...field.options, name, initial: field.initial }))));
+    }
+    /** `@action` methods with their undo labels, in declaration order; overrides relabel. */
+    get actionDefinitions() {
+        return Object.freeze([...this.#actions].map(([name, label]) => Object.freeze({ name, label })));
+    }
+    /** @internal The `@action` decorator records each method once per instance. */
+    [registerAction](name, label) {
+        this.#actions.set(name, label);
+    }
+    render() {
+        throw new TypeError('Components must implement render()');
+    }
+    /**
+     * Override to declare connection points, in local coordinates at 0°, from props and
+     * the saved size. Live state never moves a port. Defaults to none.
+     */
+    ports() {
+        return [];
+    }
+    /** Validated, frozen `ports()`, computed again only when the saved props change. */
+    get portDefinitions() {
+        const props = this.#readProps();
+        if (this.#ports?.props === props)
+            return this.#ports.ports;
+        this.#readingPorts = true;
+        try {
+            const ports = validatePorts(this.ports());
+            this.#ports = { props, ports };
+            return ports;
+        }
+        finally {
+            this.#readingPorts = false;
+        }
+    }
+    created() { }
+    destroyed() { }
+    changed(_name) { }
+    validateAttribute(name, value) {
+        super.validateAttribute(name, value);
+        if (Attributes.normalizeName(name) === 'data-rasam-props' &&
+            #initialized in this &&
+            this.#initialized)
+            this.#assertProps(parseProps(value));
+    }
+    setAttributeValue(name, value) {
+        if (restoredHooks.has(this) && Attributes.normalizeName(name) === 'data-rasam-props')
+            return this;
+        return super.setAttributeValue(name, value);
+    }
+    attrs(values) {
+        if (restoredHooks.has(this))
+            values = Object.fromEntries(Object.entries(values).filter(([name]) => Attributes.normalizeName(name) !== 'data-rasam-props'));
+        return super.attrs(values);
+    }
+    /** `resize: 'props'` components keep their size as saved `width` and `height` props. */
+    get #sized() {
+        return this.componentDefinition.resize === 'props';
+    }
+    width(value) {
+        if (!this.#sized)
+            return value === undefined ? super.width() : super.width(value);
+        return value === undefined ? this.#size('width') : this.size(value, this.#size('height'));
+    }
+    height(value) {
+        if (!this.#sized)
+            return value === undefined ? super.height() : super.height(value);
+        return value === undefined ? this.#size('height') : this.size(this.#size('width'), value);
+    }
+    /** For `resize: 'props'`, one undo step that redraws at once, so callers read new bounds. */
+    size(width, height) {
+        if (!this.#sized)
+            return super.size(width, height);
+        this.assertLive();
+        const next = {
+            width: toSize(width),
+            height: height === undefined ? undefined : toSize(height),
+        };
+        const target = {
+            width: next.width,
+            height: next.height ?? (next.width * this.#size('height')) / this.#size('width'),
+        };
+        if (restoredHooks.has(this))
+            return this;
+        if (target.width === this.#size('width') && target.height === this.#size('height'))
+            return this;
+        this[editComponent](`Resize ${this.componentDefinition.name}`, () => {
+            this.setAttributeValue('data-rasam-props', JSON.stringify({ ...this.#readProps(), ...target }));
+        });
+        if (this.#initialized && this.#notifyProps())
+            this.#redraw();
+        return this;
+    }
+    #size(name) {
+        const saved = this.#readProps()[name] ?? this.#input[name];
+        return isSize(saved) ? saved : this.componentDefinition[name];
+    }
+    resetState() {
+        this.assertLive();
+        for (const [name, field] of this.#fields)
+            if (field.kind === 'state')
+                Reflect.set(this, name, copy(field.initial));
+    }
+    /** @internal Called after decorated fields and reconstructed children are available. */
+    [initializeElement]() {
+        if (this.#initialized)
+            return;
+        const metadata = this.componentDefinition;
+        const saved = this.#readProps();
+        const rawVersion = this.getAttributeValue('data-rasam-version');
+        const version = rawVersion === undefined ? metadata.version : Number(rawVersion);
+        if (!Number.isInteger(version) || version < 1 || version > metadata.version)
+            throw new TypeError(`Unsupported ${metadata.type} component version: ${rawVersion}`);
+        if (version < metadata.version && !metadata.migrate)
+            throw new TypeError(`No migration for ${metadata.type} version ${version}`);
+        const values = version < metadata.version ? metadata.migrate(saved, version) : saved;
+        this.#assertProps(values);
+        this.#assertProps(this.#input);
+        const props = {};
+        for (const [name, field] of this.#fields)
+            if (field.kind === 'prop') {
+                const value = Object.hasOwn(this.#input, name)
+                    ? this.#input[name]
+                    : Object.hasOwn(values, name)
+                        ? values[name]
+                        : field.initial;
+                validateProp(value, field.initial, field.options, name);
+                props[name] = value;
+            }
+        if (metadata.resize === 'props')
+            for (const name of sizes)
+                props[name] = (this.#input[name] ?? values[name] ?? metadata[name]);
+        this.#initialized = true;
+        if (!this.context.changes.replaying) {
+            this.setAttributeValue('data-rasam-version', metadata.version);
+            this.setAttributeValue('data-rasam-props', JSON.stringify(props));
+            this.#redraw();
+        }
+        this.#observedProps = this.#readProps();
+        const changes = ComponentChanges.for(this);
+        const binding = {
+            node: this,
+            derive: () => {
+                if (this.#notifyProps())
+                    this.#redraw();
+            },
+            replay: () => {
+                this.#notifyProps();
+            },
+            paint: () => this.#redraw(),
+        };
+        const stop = changes.bind(binding);
+        this.#schedule = () => changes.schedule(binding);
+        this.onDispose(() => {
+            stop();
+            this.destroyed();
+        });
+        this.context.changes.local(() => {
+            if (this.adopting)
+                restoredHooks.add(this);
+            try {
+                this.created();
+            }
+            finally {
+                restoredHooks.delete(this);
+                this.#constructing = false;
+            }
+            // A newly constructed, detached node is not eligible for change derivation yet.
+            if (this.#readProps() !== this.#observedProps && this.#notifyProps())
+                this.#redraw();
+        });
+    }
+    /** @internal Field decorators install accessors after their initializers execute. */
+    [assertField](name) {
+        if (name in Component.prototype || this.#fields.has(name) || this.#reserved.has(name))
+            throw new TypeError(`Component field conflicts with an inherited rasam member: ${name}`);
+    }
+    /** @internal Field decorators install accessors after their initializers execute. */
+    [installField](name, kind, options, initial) {
+        this[assertField](name);
+        if (kind === 'prop')
+            validateProp(initial, initial, options, name);
+        const field = {
+            kind,
+            options: Object.freeze({
+                ...options,
+                ...(options.options ? { options: Object.freeze([...options.options]) } : {}),
+            }),
+            initial: copy(initial),
+            value: initial,
+        };
+        this.#fields.set(name, field);
+        this.#propDefinitions = undefined;
+        Object.defineProperty(this, name, {
+            enumerable: true,
+            configurable: false,
+            get: () => {
+                if (kind === 'state') {
+                    if (this.#readingPorts)
+                        throw new TypeError(`ports() cannot read live state: ${name}`);
+                    return field.value;
+                }
+                const props = this.#readProps();
+                return Object.hasOwn(props, name)
+                    ? props[name]
+                    : Object.hasOwn(this.#input, name)
+                        ? this.#input[name]
+                        : initial;
+            },
+            set: (value) => {
+                this.assertLive();
+                if (kind === 'state') {
+                    if (Object.is(field.value, value))
+                        return;
+                    field.value = value;
+                    if (this.#initialized) {
+                        this.changed(name);
+                        this.#schedule?.();
+                    }
+                    return;
+                }
+                if (restoredHooks.has(this))
+                    return;
+                validateProp(value, initial, options, name);
+                if (Object.is(Reflect.get(this, name), value))
+                    return;
+                this[editComponent](`Set ${options.label ?? name}`, () => {
+                    this.setAttributeValue('data-rasam-props', JSON.stringify({ ...this.#readProps(), [name]: value }));
+                });
+            },
+        });
+    }
+    /** @internal Actions share one change group across nested calls and instances. */
+    [editComponent](label, callback) {
+        this.assertLive();
+        if (this.#constructing || this.context.changes.currentGroup !== undefined)
+            return callback();
+        const group = beginChangeGroup(this, { source: 'components', label });
+        try {
+            const result = group.run(callback);
+            if (result && typeof result.then === 'function')
+                throw new TypeError('Component actions must be synchronous');
+            group.end();
+            return result;
+        }
+        catch (error) {
+            try {
+                group.cancel();
+            }
+            catch (rollback) {
+                throw new AggregateError([error, rollback], 'Component edit and rollback failed');
+            }
+            throw error;
+        }
+    }
+    #readProps() {
+        // Retain ordinary field-read semantics for destroyed() and post-disposal inspection.
+        const raw = this.attributes.get('data-rasam-props');
+        if (this.#propsCache && this.#propsCache.raw === raw)
+            return this.#propsCache.props;
+        this.#propsCache = { raw, props: Object.freeze(parseProps(raw)) };
+        return this.#propsCache.props;
+    }
+    #assertProps(props) {
+        if (!props || typeof props !== 'object' || Array.isArray(props))
+            throw new TypeError('Component props must be an object');
+        for (const [name, value] of Object.entries(props)) {
+            if (this.#sized && sizes.includes(name)) {
+                if (!isSize(value))
+                    throw new RangeError(`Component ${name} must be a positive number`);
+                continue;
+            }
+            const field = this.#fields.get(name);
+            if (!field || field.kind !== 'prop')
+                throw new TypeError(`Unknown component prop: ${name}`);
+            validateProp(value, field.initial, field.options, name);
+        }
+    }
+    #notifyProps() {
+        const props = this.#readProps(), previous = this.#observedProps;
+        if (props === previous)
+            return false;
+        this.#observedProps = props;
+        const names = [...this.propDefinitions.map((field) => field.name), ...sizes].filter((name) => !Object.is(previous[name], props[name]));
+        for (const name of names)
+            this.changed(name);
+        return names.length > 0;
+    }
+    #redraw() {
+        this.withOwnChildren(() => this.#view.render(this.render()));
+        markDerived(this);
+    }
+}
+/** Sizes are user units of at least 1, so a collapsing resize never reaches zero. */
+function toSize(value) {
+    const size = typeof value === 'number' ? value : Number(value);
+    if (!Number.isFinite(size) || size < 0)
+        throw new RangeError('Component sizes must be finite non-negative numbers');
+    return Math.max(size, 1);
+}
+function parseProps(raw) {
+    const props = raw == null ? {} : JSON.parse(String(raw));
+    if (!props || typeof props !== 'object' || Array.isArray(props))
+        throw new TypeError('Component props must be a JSON object');
+    return props;
+}
+//# sourceMappingURL=component.js.map