Add renderer-independent canvas model, transactions and view sessions
This commit is contained in:
@@ -0,0 +1,51 @@
|
||||
import type { Capability, CapabilityHandler, ComponentDefinition, Data, ElementRecord, Feature, Registry, ReadonlyValueSet } from './types.ts';
|
||||
import { clone, fault, freeze, readMap, readSet, validJson } from './values.ts';
|
||||
|
||||
export function defineFeature(id: string, handlers: Partial<Record<Capability, CapabilityHandler>>): Feature {
|
||||
if (!id || !Object.values(handlers).length || Object.values(handlers).some(value => typeof value !== 'function')) throw fault('invalid_feature');
|
||||
return freeze({ id, handlers: { ...handlers } });
|
||||
}
|
||||
export function defineComponent(definition: ComponentDefinition): ComponentDefinition {
|
||||
if (!definition.id || !Number.isSafeInteger(definition.dataVersion) || definition.dataVersion < 1 || typeof definition.validate !== 'function') throw fault('invalid_component');
|
||||
return freeze({ ...definition, features: definition.features.map(feature => defineFeature(feature.id, feature.handlers)), migrations: definition.migrations ? { ...definition.migrations } : undefined, resourceFields: [...definition.resourceFields || []] });
|
||||
}
|
||||
export function createRegistry(definitions: readonly ComponentDefinition[]): Registry {
|
||||
const components = new Map<string, ComponentDefinition>(), capabilities = new Map<string, ReadonlyValueSet<Capability>>(), handlers = new Map<string, ReadonlyMap<Capability, CapabilityHandler>>();
|
||||
for (const input of definitions) {
|
||||
const definition = defineComponent(input);
|
||||
if (components.has(definition.id)) throw fault('duplicate_component', [definition.id]);
|
||||
const found = new Map<Capability, CapabilityHandler>(), features = new Set<string>();
|
||||
for (const feature of definition.features) {
|
||||
if (features.has(feature.id)) throw fault('duplicate_feature', [feature.id]);
|
||||
features.add(feature.id);
|
||||
for (const [key, handler] of Object.entries(feature.handlers)) {
|
||||
const capability = key as Capability;
|
||||
if (!handler) throw fault('invalid_feature');
|
||||
if (found.has(capability)) throw fault('duplicate_capability', [definition.id, capability]);
|
||||
found.set(capability, handler);
|
||||
}
|
||||
}
|
||||
components.set(definition.id, definition); capabilities.set(definition.id, readSet(found.keys())); handlers.set(definition.id, readMap(found));
|
||||
}
|
||||
const resolve: Registry['resolve'] = element => {
|
||||
const definition = components.get(element.componentId);
|
||||
if (!definition) return 'unknown-component';
|
||||
if (definition.dataVersion !== element.dataVersion) return 'unsupported-version';
|
||||
return 'known';
|
||||
};
|
||||
return Object.freeze({ components: readMap(components), capabilities: readMap(capabilities), handlers: readMap(handlers), resolve,
|
||||
supports: (element: ElementRecord, capability: Capability) => resolve(element) === 'known' && !!capabilities.get(element.componentId)?.has(capability) });
|
||||
}
|
||||
export function migrateElement(element: ElementRecord, registry: Registry): ElementRecord {
|
||||
const definition = registry.components.get(element.componentId);
|
||||
if (!definition || element.dataVersion > definition.dataVersion) return element;
|
||||
let data: Data = freeze(clone(element.data)), version = element.dataVersion;
|
||||
while (version < definition.dataVersion) {
|
||||
const migrate = definition.migrations?.[version];
|
||||
if (!migrate) throw fault('missing_migration', [element.id]);
|
||||
data = freeze(clone(migrate(data))); version++;
|
||||
if (!validJson(data)) throw fault('invalid_migration', [element.id]);
|
||||
}
|
||||
if (!definition.validate(data)) throw fault('invalid_component_data', [element.id]);
|
||||
return freeze({ ...element, dataVersion: version, data });
|
||||
}
|
||||
Reference in New Issue
Block a user