@gtkx/runtime 1.0.0-rc.3 → 1.0.0

package/dist/properties.js

@@ -1,73 +1,336 @@
-import { camelCase } from "@gtkx/utils";
+import { camelCase, kebabCase } from "@gtkx/utils";
 import { bind } from "./bind.js";
+import { biguint64T, stringT, structT, voidT } from "./descriptors.js";
 import { LIB, PARAM_T, VALUE_T } from "./library.js";
-import { getHandle } from "./registry.js";
-import { fromValue, intoValue } from "./value.js";
+import { getParamFlags, getParamValueType, isParamConstructOnly, isParamLaxlyValidated, isParamWritable, valueGuardFor, wasParamValueModified, } from "./param-spec.js";
+import { getHandle, getInterfaceProperties, instanceClassName } from "./registry.js";
+import { typeName } from "./type.js";
+import { fromValue, intoValue, newValueForType, valueWriterFor } from "./value.js";
 const FIRST_PROPERTY_ID = 1;
+const GET_PROPERTY_VFUNC = "vfuncGetProperty";
+const SET_PROPERTY_VFUNC = "vfuncSetProperty";
+const READ_ONLY_REASON = "the property is read-only";
+const CONSTRUCT_ONLY_REASON = "the property can only be set when the object is constructed";
+const CLASS_T = structT("borrowed");
+const interfaceStorages = new Map();
 const paramSpecDefaultValue = bind(LIB, "g_param_spec_get_default_value", [PARAM_T], VALUE_T);
+const paramSpecName = bind(LIB, "g_param_spec_get_name", [PARAM_T], stringT("borrowed"));
+const typeClassRef = bind(LIB, "g_type_class_ref", [biguint64T], CLASS_T);
+const typeClassUnref = bind(LIB, "g_type_class_unref", [CLASS_T], voidT);
+const classFindProperty = bind(LIB, "g_object_class_find_property", [CLASS_T, stringT("borrowed")], PARAM_T);
+const getPropertyName = (pspec) => paramSpecName(getHandle(pspec));
 const underscoreCase = (name) => name.replaceAll("-", "_");
+const canonicalCase = (name) => kebabCase(name).replaceAll("_", "-");
 const accessorNames = (name) => [...new Set([name, underscoreCase(name), camelCase(name)])];
+const typeLabel = (type) => typeName(type) ?? String(type);
+const defaultValueFor = (handle) => paramSpecDefaultValue(handle);
+const holdsReason = (check) => `the property holds values of type '${typeLabel(check.valueType)}'`;
+function checkFor(handle, name) {
+    const valueType = getParamValueType(handle);
+    return {
+        name,
+        propertyName: paramSpecName(handle),
+        handle,
+        flags: getParamFlags(handle),
+        valueType,
+        canHoldValue: valueGuardFor(valueType),
+    };
+}
+function findPropertySpec(klass, name) {
+    const found = classFindProperty(klass, name);
+    return found ?? classFindProperty(klass, canonicalCase(name));
+}
+function describeValue(value) {
+    if (typeof value === "string") {
+        return JSON.stringify(value);
+    }
+    if (typeof value === "object" && value !== null) {
+        return instanceClassName(value);
+    }
+    return String(value);
+}
+function propertyMessage(instance, check, tail) {
+    return `${instanceClassName(instance)}.${check.name}: ${tail}`;
+}
+function refusalTail(check, value, reason) {
+    return `cannot set property '${check.propertyName}' to ${describeValue(value)}; ${reason}`;
+}
+function serveTail(check, value) {
+    return `cannot serve property '${check.propertyName}' from ${describeValue(value)}; ${holdsReason(check)}`;
+}
+function assertValueFits(instance, check, value) {
+    if (check.canHoldValue(value)) {
+        return;
+    }
+    const tail = refusalTail(check, value, holdsReason(check));
+    throw new TypeError(propertyMessage(instance, check, tail));
+}
+function assertValueServes(instance, check, value) {
+    if (check.canHoldValue(value)) {
+        return;
+    }
+    throw new TypeError(propertyMessage(instance, check, serveTail(check, value)));
+}
+function assertValueValidates(instance, check, value, gValue) {
+    if (!wasParamValueModified(check.handle, gValue) || isParamLaxlyValidated(check.flags)) {
+        return;
+    }
+    const reason = `the value is invalid or out of range for type '${typeLabel(check.valueType)}', ` +
+        `and GObject would put ${describeValue(fromValue(gValue))} in its place`;
+    throw new RangeError(propertyMessage(instance, check, refusalTail(check, value, reason)));
+}
+function assertWritable(instance, check, value) {
+    if (isParamWritable(check.flags)) {
+        return;
+    }
+    throw new TypeError(propertyMessage(instance, check, refusalTail(check, value, READ_ONLY_REASON)));
+}
+function fillCheckedValue(instance, check, gValue, value) {
+    assertValueFits(instance, check, value);
+    check.write ??= valueWriterFor(check.valueType);
+    check.write(gValue, value);
+    assertValueValidates(instance, check, value, gValue);
+}
+function checkedValueFor(instance, check, value) {
+    const gValue = newValueForType(check.valueType);
+    fillCheckedValue(instance, check, gValue, value);
+    return gValue;
+}
+function assertValueAccepted(instance, check, value) {
+    check.scratch ??= newValueForType(check.valueType);
+    fillCheckedValue(instance, check, check.scratch, value);
+}
+function constructValueFor(wrapper, check, value) {
+    assertWritable(wrapper, check, value);
+    return { name: check.propertyName, value: checkedValueFor(wrapper, check, value) };
+}
+function constructPropertyFor(gtype, name, value, wrapper) {
+    const klass = typeClassRef(gtype);
+    try {
+        const pspec = findPropertySpec(klass, name);
+        return pspec === null ? undefined : constructValueFor(wrapper, checkFor(pspec, name), value);
+    }
+    finally {
+        typeClassUnref(klass);
+    }
+}
 function readStored(instance, accessor) {
     if (!Object.hasOwn(instance, accessor.storage)) {
-        const defaults = paramSpecDefaultValue(getHandle(accessor.pspec));
-        instance[accessor.storage] = fromValue(defaults);
+        instance[accessor.storage] = fromValue(defaultValueFor(accessor.handle));
     }
     return instance[accessor.storage];
 }
-function defineAccessor(prototype, accessor, alias) {
-    if (Object.getOwnPropertyDescriptor(prototype, alias) !== undefined) {
+function storeValue(instance, accessor, value) {
+    instance[accessor.storage] = value;
+}
+function writeStored(instance, accessor, value) {
+    if (readStored(instance, accessor) === value) {
         return;
     }
-    Object.defineProperty(prototype, alias, {
-        configurable: true,
-        enumerable: true,
-        get() {
-            return readStored(this, accessor);
-        },
-        set(value) {
-            if (readStored(this, accessor) === value) {
-                return;
-            }
-            this[accessor.storage] = value;
-            this.notify?.(accessor.name);
-        },
-    });
+    storeValue(instance, accessor, value);
+    instance.notify?.(accessor.propertyName);
+}
+function writeProperty(instance, accessor, value) {
+    const stored = instance;
+    if (readStored(stored, accessor) === value) {
+        return;
+    }
+    assertValueAccepted(instance, accessor, value);
+    storeValue(stored, accessor, value);
+    instance.notify?.(accessor.propertyName);
+}
+function storedGetter(accessor) {
+    return function get() {
+        return readStored(this, accessor);
+    };
+}
+function memberGetter(accessor) {
+    return function get() {
+        return this[accessor.memberName];
+    };
+}
+function memberSetter(accessor) {
+    return function set(value) {
+        this[accessor.memberName] = value;
+    };
+}
+function refusalFor(accessor, reason) {
+    return function set(value) {
+        throw new TypeError(propertyMessage(this, accessor, refusalTail(accessor, value, reason)));
+    };
+}
+function checkedSetter(accessor) {
+    if (!isParamWritable(accessor.flags)) {
+        return refusalFor(accessor, READ_ONLY_REASON);
+    }
+    if (isParamConstructOnly(accessor.flags)) {
+        return refusalFor(accessor, CONSTRUCT_ONLY_REASON);
+    }
+    return function set(value) {
+        writeProperty(this, accessor, value);
+    };
+}
+function hasOwnMember(prototype, alias) {
+    return Object.getOwnPropertyDescriptor(prototype, alias) !== undefined;
+}
+function defineAccessor(prototype, descriptor, alias) {
+    if (hasOwnMember(prototype, alias)) {
+        return;
+    }
+    Object.defineProperty(prototype, alias, descriptor);
 }
 function installAccessors(klass, accessor) {
     const prototype = klass.prototype;
+    accessor.hasGeneratedMember = !hasOwnMember(prototype, accessor.memberName);
+    const descriptor = {
+        configurable: true,
+        enumerable: true,
+        get: accessor.hasGeneratedMember ? storedGetter(accessor) : memberGetter(accessor),
+        set: accessor.hasGeneratedMember ? checkedSetter(accessor) : memberSetter(accessor),
+    };
     for (const alias of accessorNames(accessor.name)) {
-        defineAccessor(prototype, accessor, alias);
+        defineAccessor(prototype, descriptor, alias);
     }
 }
-function resolveAccessor(accessors, propertyId) {
-    const accessor = accessors[propertyId - FIRST_PROPERTY_ID];
-    if (accessor === undefined) {
-        throw new RangeError(`registerClass: no property registered for id ${String(propertyId)}`);
+function storageFor(propertyName) {
+    const existing = interfaceStorages.get(propertyName);
+    if (existing !== undefined) {
+        return existing;
+    }
+    const created = Symbol(`gtkx:property:${propertyName}`);
+    interfaceStorages.set(propertyName, created);
+    return created;
+}
+function interfaceAccessorFor(dispatch, pspec) {
+    const handle = getHandle(pspec);
+    const propertyName = paramSpecName(handle);
+    const delegate = dispatch.delegates.get(propertyName);
+    const accessor = {
+        ...checkFor(handle, propertyName),
+        memberName: camelCase(propertyName),
+        storage: storageFor(propertyName),
+        hasGeneratedMember: false,
+        isInterfaceProperty: true,
+    };
+    if (delegate !== undefined) {
+        accessor.delegate = delegate;
     }
     return accessor;
 }
-function makeGetProperty(accessors) {
-    return function getProperty(propertyId, value) {
-        const accessor = resolveAccessor(accessors, propertyId);
-        const current = this[camelCase(accessor.name)];
+function resolveAccessor(dispatch, propertyId, pspec) {
+    const accessor = dispatch.accessors[propertyId - FIRST_PROPERTY_ID];
+    if (accessor !== undefined) {
+        return accessor;
+    }
+    const created = interfaceAccessorFor(dispatch, pspec);
+    dispatch.accessors[propertyId - FIRST_PROPERTY_ID] = created;
+    return created;
+}
+function callMember(instance, member, args) {
+    const fn = instance[member];
+    if (typeof fn !== "function") {
+        throw new TypeError(`registerClass: ${instanceClassName(instance)} has no '${member}' member`);
+    }
+    return fn.apply(instance, args);
+}
+function backingMemberFor(instance, accessor) {
+    if (accessor.hasGeneratedMember && !Object.hasOwn(instance, accessor.memberName)) {
+        return undefined;
+    }
+    return accessor.memberName;
+}
+function readCurrent(instance, accessor) {
+    const getter = accessor.delegate?.getter;
+    if (getter !== undefined) {
+        return callMember(instance, getter, []);
+    }
+    if (accessor.isInterfaceProperty === true) {
+        return readStored(instance, accessor);
+    }
+    const member = backingMemberFor(instance, accessor);
+    return member === undefined
+        ? readStored(instance, accessor)
+        : instance[member];
+}
+function writeCurrent(instance, accessor, value) {
+    const setter = accessor.delegate?.setter;
+    if (setter !== undefined) {
+        callMember(instance, setter, [value]);
+        return;
+    }
+    if (accessor.isInterfaceProperty === true) {
+        writeStored(instance, accessor, value);
+        return;
+    }
+    const member = backingMemberFor(instance, accessor);
+    if (member === undefined) {
+        storeValue(instance, accessor, value);
+        return;
+    }
+    instance[member] = value;
+}
+function makeGetProperty(dispatch) {
+    return function getProperty(propertyId, value, pspec) {
+        const accessor = resolveAccessor(dispatch, propertyId, pspec);
+        const current = readCurrent(this, accessor);
+        assertValueServes(this, accessor, current);
         intoValue(getHandle(value), current);
     };
 }
-function makeSetProperty(accessors) {
-    return function setProperty(propertyId, value) {
-        const accessor = resolveAccessor(accessors, propertyId);
-        const jsValue = fromValue(getHandle(value));
-        this[camelCase(accessor.name)] = jsValue;
+function makeSetProperty(dispatch) {
+    return function setProperty(propertyId, value, pspec) {
+        const accessor = resolveAccessor(dispatch, propertyId, pspec);
+        writeCurrent(this, accessor, fromValue(getHandle(value)));
     };
 }
-function buildAccessors(klass, properties) {
-    const accessors = [];
+function assertCanonicalName(klass, name, propertyName) {
+    const canonical = canonicalCase(name);
+    if (propertyName === canonical) {
+        return;
+    }
+    throw new TypeError(`registerClass: ${klass.name} keys the property '${name}' to a GObject.ParamSpec named ` +
+        `'${propertyName}', which is the name GObject notifies under; name the ParamSpec '${canonical}'`);
+}
+function assertCanonicalNames(klass, properties) {
     for (const [name, pspec] of Object.entries(properties)) {
-        const accessor = { name, storage: Symbol(`gtkx:property:${name}`), pspec };
-        installAccessors(klass, accessor);
-        accessors.push(accessor);
+        assertCanonicalName(klass, name, getPropertyName(pspec));
     }
-    return accessors;
+}
+function buildAccessor(klass, name, pspec) {
+    const accessor = {
+        ...checkFor(getHandle(pspec), name),
+        memberName: camelCase(name),
+        storage: Symbol(`gtkx:property:${name}`),
+        hasGeneratedMember: false,
+    };
+    installAccessors(klass, accessor);
+    return accessor;
+}
+function buildAccessors(source) {
+    const { klass, properties } = source;
+    assertCanonicalNames(klass, properties);
+    return Object.entries(properties).map(([name, pspec]) => buildAccessor(klass, name, pspec));
+}
+function addInterfaceDelegates(delegates, gtype) {
+    const properties = getInterfaceProperties(gtype) ?? {};
+    for (const [name, delegate] of Object.entries(properties)) {
+        if (!delegates.has(name)) {
+            delegates.set(name, delegate);
+        }
+    }
+}
+function interfaceDelegatesFor(adoptedTypes) {
+    const delegates = new Map();
+    for (const gtype of adoptedTypes) {
+        addInterfaceDelegates(delegates, gtype);
+    }
+    return delegates;
+}
+function buildPropertyDispatch(source) {
+    return {
+        accessors: buildAccessors(source),
+        delegates: interfaceDelegatesFor(source.adoptedTypes),
+    };
 }
 function toNativeProperties(properties) {
     return Object.values(properties).map((pspec, index) => ({
@@ -75,5 +338,5 @@ function toNativeProperties(properties) {
         pspec: getHandle(pspec),
     }));
 }
-export { buildAccessors, makeGetProperty, makeSetProperty, toNativeProperties, };
+export { buildPropertyDispatch, constructPropertyFor, GET_PROPERTY_VFUNC, makeGetProperty, makeSetProperty, SET_PROPERTY_VFUNC, toNativeProperties, };
 //# sourceMappingURL=properties.js.map

package/dist/properties.js.map

@@ -1 +1 @@
-{"version":3,"file":"properties.js","sourceRoot":"","sources":["../src/properties.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExternalObject, Handle, RegisterClassProperty } from \"@gtkx/native\";\nimport type { AnyClass } from \"@gtkx/utils\";\nimport { camelCase } from \"@gtkx/utils\";\nimport { bind } from \"./bind.js\";\nimport { LIB, PARAM_T, VALUE_T } from \"./library.js\";\nimport { getHandle } from \"./registry.js\";\nimport { fromValue, intoValue } from \"./value.js\";\n\ntype PropertyAccessor = {\n    name: string;\n    storage: symbol;\n    pspec: object;\n};\n\ntype PropertySpec = object;\ntype NotifyingObject = { notify?: (propertyName: string) => void };\n\nconst FIRST_PROPERTY_ID = 1;\nconst paramSpecDefaultValue = bind(LIB, \"g_param_spec_get_default_value\", [PARAM_T], VALUE_T);\n\nconst underscoreCase = (name: string): string => name.replaceAll(\"-\", \"_\");\nconst accessorNames = (name: string): string[] => [...new Set([name, underscoreCase(name), camelCase(name)])];\n\nfunction readStored(instance: Record<symbol, unknown>, accessor: PropertyAccessor): unknown {\n    if (!Object.hasOwn(instance, accessor.storage)) {\n        const defaults = paramSpecDefaultValue(getHandle(accessor.pspec)) as ExternalObject<Handle>;\n        instance[accessor.storage] = fromValue(defaults);\n    }\n\n    return instance[accessor.storage];\n}\n\nfunction defineAccessor(prototype: object, accessor: PropertyAccessor, alias: string): void {\n    if (Object.getOwnPropertyDescriptor(prototype, alias) !== undefined) {\n        return;\n    }\n\n    Object.defineProperty(prototype, alias, {\n        configurable: true,\n        enumerable: true,\n        get(this: Record<symbol, unknown>) {\n            return readStored(this, accessor);\n        },\n        set(this: Record<symbol, unknown>, value: unknown) {\n            if (readStored(this, accessor) === value) {\n                return;\n            }\n\n            this[accessor.storage] = value;\n            (this as NotifyingObject).notify?.(accessor.name);\n        },\n    });\n}\n\nfunction installAccessors(klass: AnyClass, accessor: PropertyAccessor): void {\n    const prototype = (klass as { prototype: object }).prototype;\n\n    for (const alias of accessorNames(accessor.name)) {\n        defineAccessor(prototype, accessor, alias);\n    }\n}\n\nfunction resolveAccessor(accessors: PropertyAccessor[], propertyId: number): PropertyAccessor {\n    const accessor = accessors[propertyId - FIRST_PROPERTY_ID];\n\n    if (accessor === undefined) {\n        throw new RangeError(`registerClass: no property registered for id ${String(propertyId)}`);\n    }\n\n    return accessor;\n}\n\nfunction makeGetProperty(accessors: PropertyAccessor[]) {\n    return function getProperty(this: object, propertyId: number, value: object): void {\n        const accessor = resolveAccessor(accessors, propertyId);\n        const current = (this as Record<string, unknown>)[camelCase(accessor.name)];\n        intoValue(getHandle(value), current);\n    };\n}\n\nfunction makeSetProperty(accessors: PropertyAccessor[]) {\n    return function setProperty(this: object, propertyId: number, value: object): void {\n        const accessor = resolveAccessor(accessors, propertyId);\n        const jsValue = fromValue(getHandle(value));\n        (this as Record<string, unknown>)[camelCase(accessor.name)] = jsValue;\n    };\n}\n\nfunction buildAccessors(klass: AnyClass, properties: Record<string, PropertySpec>): PropertyAccessor[] {\n    const accessors: PropertyAccessor[] = [];\n\n    for (const [name, pspec] of Object.entries(properties)) {\n        const accessor: PropertyAccessor = { name, storage: Symbol(`gtkx:property:${name}`), pspec };\n        installAccessors(klass, accessor);\n        accessors.push(accessor);\n    }\n\n    return accessors;\n}\n\nfunction toNativeProperties(properties: Record<string, PropertySpec>): RegisterClassProperty[] {\n    return Object.values(properties).map((pspec, index) => ({\n        id: index + FIRST_PROPERTY_ID,\n        pspec: getHandle(pspec),\n    }));\n}\n\nexport {\n    buildAccessors,\n    makeGetProperty,\n    makeSetProperty,\n    toNativeProperties,\n    type PropertyAccessor,\n    type PropertySpec,\n};\n"]}
+{"version":3,"file":"properties.js","sourceRoot":"","sources":["../src/properties.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExternalObject, Handle, RegisterClassProperty } from \"@gtkx/native\";\nimport type { AnyClass } from \"@gtkx/utils\";\nimport { camelCase, kebabCase } from \"@gtkx/utils\";\nimport { bind } from \"./bind.js\";\nimport { biguint64T, stringT, structT, voidT } from \"./descriptors.js\";\nimport { LIB, PARAM_T, VALUE_T } from \"./library.js\";\nimport {\n    getParamFlags,\n    getParamValueType,\n    isParamConstructOnly,\n    isParamLaxlyValidated,\n    isParamWritable,\n    type ValueGuard,\n    valueGuardFor,\n    wasParamValueModified,\n} from \"./param-spec.js\";\nimport { getHandle, getInterfaceProperties, instanceClassName, type InterfaceProperty } from \"./registry.js\";\nimport { typeName } from \"./type.js\";\nimport { fromValue, intoValue, newValueForType, type ValueWriter, valueWriterFor } from \"./value.js\";\n\ntype PropertyCheck = {\n    name: string;\n    propertyName: string;\n    handle: ExternalObject<Handle>;\n    flags: number;\n    valueType: bigint;\n    canHoldValue: ValueGuard;\n    write?: ValueWriter;\n    scratch?: ExternalObject<Handle>;\n};\n\ntype PropertyAccessor = PropertyCheck & {\n    memberName: string;\n    storage: symbol;\n    hasGeneratedMember: boolean;\n    isInterfaceProperty?: boolean;\n    delegate?: InterfaceProperty;\n};\n\n/** A `GObject.ParamSpec` wrapper describing one property's name, type, flags and default. */\ntype PropertySpec = object;\n\ntype PropertyDispatch = {\n    accessors: PropertyAccessor[];\n    delegates: Map<string, InterfaceProperty>;\n};\n\ntype PropertyDispatchSource = {\n    klass: AnyClass;\n    properties: Record<string, PropertySpec>;\n    adoptedTypes: bigint[];\n};\n\ntype ConstructProperty = {\n    name: string;\n    value: ExternalObject<Handle>;\n};\n\ntype NotifyingObject = { notify?: (propertyName: string) => void };\n\nconst FIRST_PROPERTY_ID = 1;\nconst GET_PROPERTY_VFUNC = \"vfuncGetProperty\";\nconst SET_PROPERTY_VFUNC = \"vfuncSetProperty\";\nconst READ_ONLY_REASON = \"the property is read-only\";\nconst CONSTRUCT_ONLY_REASON = \"the property can only be set when the object is constructed\";\nconst CLASS_T = structT(\"borrowed\");\nconst interfaceStorages: Map<string, symbol> = new Map();\nconst paramSpecDefaultValue = bind(LIB, \"g_param_spec_get_default_value\", [PARAM_T], VALUE_T);\nconst paramSpecName = bind(LIB, \"g_param_spec_get_name\", [PARAM_T], stringT(\"borrowed\"));\nconst typeClassRef = bind(LIB, \"g_type_class_ref\", [biguint64T], CLASS_T);\nconst typeClassUnref = bind(LIB, \"g_type_class_unref\", [CLASS_T], voidT);\nconst classFindProperty = bind(LIB, \"g_object_class_find_property\", [CLASS_T, stringT(\"borrowed\")], PARAM_T);\n\nconst getPropertyName = (pspec: PropertySpec): string => paramSpecName(getHandle(pspec)) as string;\nconst underscoreCase = (name: string): string => name.replaceAll(\"-\", \"_\");\nconst canonicalCase = (name: string): string => kebabCase(name).replaceAll(\"_\", \"-\");\nconst accessorNames = (name: string): string[] => [...new Set([name, underscoreCase(name), camelCase(name)])];\nconst typeLabel = (type: bigint): string => typeName(type) ?? String(type);\n\nconst defaultValueFor = (handle: ExternalObject<Handle>): ExternalObject<Handle> =>\n    paramSpecDefaultValue(handle) as ExternalObject<Handle>;\n\nconst holdsReason = (check: PropertyCheck): string =>\n    `the property holds values of type '${typeLabel(check.valueType)}'`;\n\nfunction checkFor(handle: ExternalObject<Handle>, name: string): PropertyCheck {\n    const valueType = getParamValueType(handle);\n\n    return {\n        name,\n        propertyName: paramSpecName(handle) as string,\n        handle,\n        flags: getParamFlags(handle),\n        valueType,\n        canHoldValue: valueGuardFor(valueType),\n    };\n}\n\nfunction findPropertySpec(klass: ExternalObject<Handle>, name: string): ExternalObject<Handle> | null {\n    const found = classFindProperty(klass, name) as ExternalObject<Handle> | null;\n\n    return found ?? (classFindProperty(klass, canonicalCase(name)) as ExternalObject<Handle> | null);\n}\n\nfunction describeValue(value: unknown): string {\n    if (typeof value === \"string\") {\n        return JSON.stringify(value);\n    }\n\n    if (typeof value === \"object\" && value !== null) {\n        return instanceClassName(value);\n    }\n\n    return String(value);\n}\n\nfunction propertyMessage(instance: object, check: PropertyCheck, tail: string): string {\n    return `${instanceClassName(instance)}.${check.name}: ${tail}`;\n}\n\nfunction refusalTail(check: PropertyCheck, value: unknown, reason: string): string {\n    return `cannot set property '${check.propertyName}' to ${describeValue(value)}; ${reason}`;\n}\n\nfunction serveTail(check: PropertyCheck, value: unknown): string {\n    return `cannot serve property '${check.propertyName}' from ${describeValue(value)}; ${holdsReason(check)}`;\n}\n\nfunction assertValueFits(instance: object, check: PropertyCheck, value: unknown): void {\n    if (check.canHoldValue(value)) {\n        return;\n    }\n\n    const tail = refusalTail(check, value, holdsReason(check));\n    throw new TypeError(propertyMessage(instance, check, tail));\n}\n\nfunction assertValueServes(instance: object, check: PropertyCheck, value: unknown): void {\n    if (check.canHoldValue(value)) {\n        return;\n    }\n\n    throw new TypeError(propertyMessage(instance, check, serveTail(check, value)));\n}\n\nfunction assertValueValidates(\n    instance: object,\n    check: PropertyCheck,\n    value: unknown,\n    gValue: ExternalObject<Handle>,\n): void {\n    if (!wasParamValueModified(check.handle, gValue) || isParamLaxlyValidated(check.flags)) {\n        return;\n    }\n\n    const reason =\n        `the value is invalid or out of range for type '${typeLabel(check.valueType)}', ` +\n        `and GObject would put ${describeValue(fromValue(gValue))} in its place`;\n\n    throw new RangeError(propertyMessage(instance, check, refusalTail(check, value, reason)));\n}\n\nfunction assertWritable(instance: object, check: PropertyCheck, value: unknown): void {\n    if (isParamWritable(check.flags)) {\n        return;\n    }\n\n    throw new TypeError(propertyMessage(instance, check, refusalTail(check, value, READ_ONLY_REASON)));\n}\n\nfunction fillCheckedValue(\n    instance: object,\n    check: PropertyCheck,\n    gValue: ExternalObject<Handle>,\n    value: unknown,\n): void {\n    assertValueFits(instance, check, value);\n    check.write ??= valueWriterFor(check.valueType);\n    check.write(gValue, value);\n    assertValueValidates(instance, check, value, gValue);\n}\n\nfunction checkedValueFor(instance: object, check: PropertyCheck, value: unknown): ExternalObject<Handle> {\n    const gValue = newValueForType(check.valueType);\n    fillCheckedValue(instance, check, gValue, value);\n\n    return gValue;\n}\n\nfunction assertValueAccepted(instance: object, check: PropertyCheck, value: unknown): void {\n    check.scratch ??= newValueForType(check.valueType);\n    fillCheckedValue(instance, check, check.scratch, value);\n}\n\nfunction constructValueFor(wrapper: object, check: PropertyCheck, value: unknown): ConstructProperty {\n    assertWritable(wrapper, check, value);\n\n    return { name: check.propertyName, value: checkedValueFor(wrapper, check, value) };\n}\n\nfunction constructPropertyFor(\n    gtype: bigint,\n    name: string,\n    value: unknown,\n    wrapper: object,\n): ConstructProperty | undefined {\n    const klass = typeClassRef(gtype) as ExternalObject<Handle>;\n\n    try {\n        const pspec = findPropertySpec(klass, name);\n\n        return pspec === null ? undefined : constructValueFor(wrapper, checkFor(pspec, name), value);\n    } finally {\n        typeClassUnref(klass);\n    }\n}\n\nfunction readStored(instance: Record<symbol, unknown>, accessor: PropertyAccessor): unknown {\n    if (!Object.hasOwn(instance, accessor.storage)) {\n        instance[accessor.storage] = fromValue(defaultValueFor(accessor.handle));\n    }\n\n    return instance[accessor.storage];\n}\n\nfunction storeValue(instance: Record<symbol, unknown>, accessor: PropertyAccessor, value: unknown): void {\n    instance[accessor.storage] = value;\n}\n\nfunction writeStored(instance: Record<symbol, unknown>, accessor: PropertyAccessor, value: unknown): void {\n    if (readStored(instance, accessor) === value) {\n        return;\n    }\n\n    storeValue(instance, accessor, value);\n    (instance as NotifyingObject).notify?.(accessor.propertyName);\n}\n\nfunction writeProperty(instance: object, accessor: PropertyAccessor, value: unknown): void {\n    const stored = instance as Record<symbol, unknown>;\n\n    if (readStored(stored, accessor) === value) {\n        return;\n    }\n\n    assertValueAccepted(instance, accessor, value);\n    storeValue(stored, accessor, value);\n    (instance as NotifyingObject).notify?.(accessor.propertyName);\n}\n\nfunction storedGetter(accessor: PropertyAccessor): (this: object) => unknown {\n    return function get(this: object) {\n        return readStored(this as Record<symbol, unknown>, accessor);\n    };\n}\n\nfunction memberGetter(accessor: PropertyAccessor): (this: object) => unknown {\n    return function get(this: object) {\n        return (this as Record<string, unknown>)[accessor.memberName];\n    };\n}\n\nfunction memberSetter(accessor: PropertyAccessor): (this: object, value: unknown) => void {\n    return function set(this: object, value: unknown) {\n        (this as Record<string, unknown>)[accessor.memberName] = value;\n    };\n}\n\nfunction refusalFor(accessor: PropertyAccessor, reason: string): (this: object, value: unknown) => void {\n    return function set(this: object, value: unknown) {\n        throw new TypeError(propertyMessage(this, accessor, refusalTail(accessor, value, reason)));\n    };\n}\n\nfunction checkedSetter(accessor: PropertyAccessor): (this: object, value: unknown) => void {\n    if (!isParamWritable(accessor.flags)) {\n        return refusalFor(accessor, READ_ONLY_REASON);\n    }\n\n    if (isParamConstructOnly(accessor.flags)) {\n        return refusalFor(accessor, CONSTRUCT_ONLY_REASON);\n    }\n\n    return function set(this: object, value: unknown) {\n        writeProperty(this, accessor, value);\n    };\n}\n\nfunction hasOwnMember(prototype: object, alias: string): boolean {\n    return Object.getOwnPropertyDescriptor(prototype, alias) !== undefined;\n}\n\nfunction defineAccessor(prototype: object, descriptor: PropertyDescriptor, alias: string): void {\n    if (hasOwnMember(prototype, alias)) {\n        return;\n    }\n\n    Object.defineProperty(prototype, alias, descriptor);\n}\n\nfunction installAccessors(klass: AnyClass, accessor: PropertyAccessor): void {\n    const prototype = (klass as { prototype: object }).prototype;\n    accessor.hasGeneratedMember = !hasOwnMember(prototype, accessor.memberName);\n\n    const descriptor: PropertyDescriptor = {\n        configurable: true,\n        enumerable: true,\n        get: accessor.hasGeneratedMember ? storedGetter(accessor) : memberGetter(accessor),\n        set: accessor.hasGeneratedMember ? checkedSetter(accessor) : memberSetter(accessor),\n    };\n\n    for (const alias of accessorNames(accessor.name)) {\n        defineAccessor(prototype, descriptor, alias);\n    }\n}\n\nfunction storageFor(propertyName: string): symbol {\n    const existing = interfaceStorages.get(propertyName);\n\n    if (existing !== undefined) {\n        return existing;\n    }\n\n    const created = Symbol(`gtkx:property:${propertyName}`);\n    interfaceStorages.set(propertyName, created);\n\n    return created;\n}\n\nfunction interfaceAccessorFor(dispatch: PropertyDispatch, pspec: PropertySpec): PropertyAccessor {\n    const handle = getHandle(pspec);\n    const propertyName = paramSpecName(handle) as string;\n    const delegate = dispatch.delegates.get(propertyName);\n\n    const accessor: PropertyAccessor = {\n        ...checkFor(handle, propertyName),\n        memberName: camelCase(propertyName),\n        storage: storageFor(propertyName),\n        hasGeneratedMember: false,\n        isInterfaceProperty: true,\n    };\n\n    if (delegate !== undefined) {\n        accessor.delegate = delegate;\n    }\n\n    return accessor;\n}\n\nfunction resolveAccessor(\n    dispatch: PropertyDispatch,\n    propertyId: number,\n    pspec: PropertySpec,\n): PropertyAccessor {\n    const accessor = dispatch.accessors[propertyId - FIRST_PROPERTY_ID];\n\n    if (accessor !== undefined) {\n        return accessor;\n    }\n\n    const created = interfaceAccessorFor(dispatch, pspec);\n    dispatch.accessors[propertyId - FIRST_PROPERTY_ID] = created;\n\n    return created;\n}\n\nfunction callMember(instance: object, member: string, args: unknown[]): unknown {\n    const fn: unknown = (instance as Record<string, unknown>)[member];\n\n    if (typeof fn !== \"function\") {\n        throw new TypeError(`registerClass: ${instanceClassName(instance)} has no '${member}' member`);\n    }\n\n    return (fn as (...values: unknown[]) => unknown).apply(instance, args);\n}\n\nfunction backingMemberFor(instance: object, accessor: PropertyAccessor): string | undefined {\n    if (accessor.hasGeneratedMember && !Object.hasOwn(instance, accessor.memberName)) {\n        return undefined;\n    }\n\n    return accessor.memberName;\n}\n\nfunction readCurrent(instance: object, accessor: PropertyAccessor): unknown {\n    const getter = accessor.delegate?.getter;\n\n    if (getter !== undefined) {\n        return callMember(instance, getter, []);\n    }\n\n    if (accessor.isInterfaceProperty === true) {\n        return readStored(instance as Record<symbol, unknown>, accessor);\n    }\n\n    const member = backingMemberFor(instance, accessor);\n\n    return member === undefined\n        ? readStored(instance as Record<symbol, unknown>, accessor)\n        : (instance as Record<string, unknown>)[member];\n}\n\nfunction writeCurrent(instance: object, accessor: PropertyAccessor, value: unknown): void {\n    const setter = accessor.delegate?.setter;\n\n    if (setter !== undefined) {\n        callMember(instance, setter, [value]);\n\n        return;\n    }\n\n    if (accessor.isInterfaceProperty === true) {\n        writeStored(instance as Record<symbol, unknown>, accessor, value);\n\n        return;\n    }\n\n    const member = backingMemberFor(instance, accessor);\n\n    if (member === undefined) {\n        storeValue(instance as Record<symbol, unknown>, accessor, value);\n\n        return;\n    }\n\n    (instance as Record<string, unknown>)[member] = value;\n}\n\nfunction makeGetProperty(dispatch: PropertyDispatch) {\n    return function getProperty(this: object, propertyId: number, value: object, pspec: PropertySpec): void {\n        const accessor = resolveAccessor(dispatch, propertyId, pspec);\n        const current = readCurrent(this, accessor);\n        assertValueServes(this, accessor, current);\n        intoValue(getHandle(value), current);\n    };\n}\n\nfunction makeSetProperty(dispatch: PropertyDispatch) {\n    return function setProperty(this: object, propertyId: number, value: object, pspec: PropertySpec): void {\n        const accessor = resolveAccessor(dispatch, propertyId, pspec);\n        writeCurrent(this, accessor, fromValue(getHandle(value)));\n    };\n}\n\nfunction assertCanonicalName(klass: AnyClass, name: string, propertyName: string): void {\n    const canonical = canonicalCase(name);\n\n    if (propertyName === canonical) {\n        return;\n    }\n\n    throw new TypeError(\n        `registerClass: ${klass.name} keys the property '${name}' to a GObject.ParamSpec named ` +\n        `'${propertyName}', which is the name GObject notifies under; name the ParamSpec '${canonical}'`,\n    );\n}\n\nfunction assertCanonicalNames(klass: AnyClass, properties: Record<string, PropertySpec>): void {\n    for (const [name, pspec] of Object.entries(properties)) {\n        assertCanonicalName(klass, name, getPropertyName(pspec));\n    }\n}\n\nfunction buildAccessor(klass: AnyClass, name: string, pspec: PropertySpec): PropertyAccessor {\n    const accessor: PropertyAccessor = {\n        ...checkFor(getHandle(pspec), name),\n        memberName: camelCase(name),\n        storage: Symbol(`gtkx:property:${name}`),\n        hasGeneratedMember: false,\n    };\n\n    installAccessors(klass, accessor);\n\n    return accessor;\n}\n\nfunction buildAccessors(source: PropertyDispatchSource): PropertyAccessor[] {\n    const { klass, properties } = source;\n    assertCanonicalNames(klass, properties);\n\n    return Object.entries(properties).map(([name, pspec]) => buildAccessor(klass, name, pspec));\n}\n\nfunction addInterfaceDelegates(delegates: Map<string, InterfaceProperty>, gtype: bigint): void {\n    const properties = getInterfaceProperties(gtype) ?? {};\n\n    for (const [name, delegate] of Object.entries(properties)) {\n        if (!delegates.has(name)) {\n            delegates.set(name, delegate);\n        }\n    }\n}\n\nfunction interfaceDelegatesFor(adoptedTypes: bigint[]): Map<string, InterfaceProperty> {\n    const delegates: Map<string, InterfaceProperty> = new Map();\n\n    for (const gtype of adoptedTypes) {\n        addInterfaceDelegates(delegates, gtype);\n    }\n\n    return delegates;\n}\n\nfunction buildPropertyDispatch(source: PropertyDispatchSource): PropertyDispatch {\n    return {\n        accessors: buildAccessors(source),\n        delegates: interfaceDelegatesFor(source.adoptedTypes),\n    };\n}\n\nfunction toNativeProperties(properties: Record<string, PropertySpec>): RegisterClassProperty[] {\n    return Object.values(properties).map((pspec, index) => ({\n        id: index + FIRST_PROPERTY_ID,\n        pspec: getHandle(pspec),\n    }));\n}\n\nexport {\n    buildPropertyDispatch,\n    constructPropertyFor,\n    GET_PROPERTY_VFUNC,\n    makeGetProperty,\n    makeSetProperty,\n    SET_PROPERTY_VFUNC,\n    toNativeProperties,\n    type ConstructProperty,\n    type PropertyDispatch,\n    type PropertySpec,\n};\n"]}

package/dist/register-class.d.ts

@@ -1,25 +1,130 @@
 import { type AnyClass } from "@gtkx/utils";
 import { type PropertySpec } from "./properties.js";
-type RegisterClassOptions = {
+/**
+ * A generated interface value, such as `Gio.ListModel`, in the form {@link registerClass} takes it.
+ * `__impl__` exists only in the type system: it carries the interface's `Impl` type, of which a class
+ * has to match every member it declares itself, which rejects a class value and a member whose
+ * signature does not fit the slot it fills. Leaving a slot to the interface is not rejected,
+ * because `registerClass` does not reject it either: every member of an `Impl` type is optional,
+ * and the `Partial` holds that open whatever the type declares. The `object` beside it keeps
+ * TypeScript from also demanding one member in common. An interface that introspection describes
+ * no vtable for carries `unknown`, since it has no slot a class could fill.
+ */
+type Interface<TImpl> = AnyClass & {
+    /** Type-level slot holding the interface's `Impl` type; no value ever carries it. */
+    __impl__: (impl: Partial<TImpl> & object) => void;
+};
+/**
+ * One key of `RegisterClassOptions.properties` with every underscore turned into the dash a canonical
+ * GObject property name separates its words with.
+ */
+type Dashed<TName extends string> = TName extends `${infer THead}_${infer TTail}` ? Dashed<`${THead}-${TTail}`> : TName;
+/**
+ * One dashed key in the camelCase spelling the accessors {@link registerClass} installs carry, which is
+ * the spelling the hooks that address a property by name take.
+ */
+type Camelized<TName extends string> = TName extends `${infer THead}-${infer TTail}` ? `${THead}${Capitalize<Camelized<TTail>>}` : TName;
+/**
+ * The names a registered class carries in its property map: every key of
+ * `RegisterClassOptions.properties` in camelCase, whichever of the three spellings it was written in.
+ * A `properties` object given a type of its own rather than left to inference has `string` for its key
+ * type and names nothing, because a name only known as `string` addresses no member in particular.
+ */
+type InstalledNames<TProperties> = string extends keyof TProperties ? never : Camelized<Dashed<keyof TProperties & string>>;
+/**
+ * An instance of a registered class: everything the class itself declares, plus the property map the
+ * hooks that address a property by name, such as `useProperty` from `@gtkx/react`, read the installed
+ * names off. Each name is typed with the value type the class declares for the member of that name,
+ * so a property the class does not `declare` contributes nothing.
+ */
+type RegisteredInstance<TInstance, TProperties> = TInstance & {
+    /** Type-level map from installed property name to value type; no value ever carries it. */
+    __properties__: Pick<TInstance, InstalledNames<TProperties> & keyof TInstance>;
+};
+/**
+ * The construct signature and prototype a registered class carries, both giving
+ * {@link RegisteredInstance}. The signature stays abstract for as long as the class itself is, so
+ * registering an abstract base leaves it as impossible to construct as it was.
+ */
+type RegisteredConstructor<TClass, TArgs extends unknown[], TInstance> = {
+    /** Object the class's instances inherit from. */
+    prototype: TInstance;
+} & (TClass extends new (...args: never) => unknown ? new (...args: TArgs) => TInstance : abstract new (...args: TArgs) => TInstance);
+/**
+ * The class {@link registerClass} hands back: the same class, with the same statics, whose instances
+ * carry the properties `RegisterClassOptions.properties` installed. Binding the call to a name, rather
+ * than discarding it, is what carries those names into the type system.
+ */
+type RegisteredClass<TClass extends AnyClass, TProperties> = TClass extends abstract new (...args: infer TArgs) => infer TInstance ? Omit<TClass, "prototype"> & RegisteredConstructor<TClass, TArgs, RegisteredInstance<TInstance, TProperties>> : never;
+/** What {@link registerClass} adds to the new GType beyond the vtable slots it discovers on the class. */
+type RegisterClassOptions<TInstance extends object, TProperties extends Record<string, PropertySpec>> = {
+    /** Name to register the new GType under, defaulting to the class's own name. */
     typeName?: string;
     /**
-     * Properties to install on the new type, keyed by canonical property name. Each value is the
-     * `GObject.ParamSpec` describing it, for example `GObject.paramSpecString(...)`. Accessors are
-     * generated on the prototype for the dashed, underscored and camelCased spellings of the name
-     * unless the class already defines one, and writing through them emits `notify`.
+     * Interfaces the new type implements on top of the ones it inherits, given as the interface values
+     * themselves, such as `Gio.ListModel`. Their vtable slots are filled from the `vfunc`-prefixed methods on
+     * the class's prototype chain, each of which has to match the interface's `Impl` type, such as
+     * `Gio.ListModelImpl`.
      */
-    properties?: Record<string, PropertySpec>;
+    implements?: Interface<TInstance>[];
+    /**
+     * Properties to install on the new type, keyed by the name JavaScript addresses each one by and
+     * valued with the `GObject.ParamSpec` describing it. A key is read in camelCase however it is
+     * written, so `dewPoint`, `dew_point` and `dew-point` all name the same member, and the ParamSpec
+     * has to carry the canonical spelling of that name, `dew-point`, or registration throws: the
+     * ParamSpec's name is the one GObject emits `notify` with, and a name the key does not spell
+     * reaches nothing that listens for it. Every property gains prototype accessors, one for the key
+     * as written, one for it with dashes turned into underscores and one for it in camelCase, each
+     * unless the class already defines that name. They serve the value from storage of their own on
+     * the instance, which is also what the type's `get_property` and `set_property` slots read and
+     * write, so a value set from JavaScript, from `g_object_set_property` and at construction all
+     * land in the same place.
+     *
+     * A write the ParamSpec would refuse throws rather than reaching GObject, which reports such a
+     * write as a GLib critical and drops it: a `TypeError` for a read-only or construct-only
+     * property and for a value of a type the property cannot hold, and a `RangeError` for a value
+     * the ParamSpec rejects. The same two checks run over a value handed to the constructor, where
+     * a construct-only property is the one that is writable. An accepted write emits one `notify`,
+     * which a `freeze_notify` batch collects; a write of the value the property already holds is
+     * dropped and emits none.
+     *
+     * A class that defines the camelCase member itself owns the property: its own accessor decides
+     * what a write means, the other two spellings forward to it, and the type's property slots read
+     * and write it rather than the generated storage.
+     */
+    properties?: TProperties;
 };
 /**
- * Registers a subclass of a wrapper class as a new GType, wiring up any class and
- * inherited-interface virtual functions it overrides. Throws if the class does not
- * extend a registered wrapper class, has no derivable type name, or overrides an
- * unsupported construct-time vtable slot.
+ * Registers a subclass of a wrapper class as a new GType, wiring up any class and interface
+ * virtual functions it overrides, both for the interfaces it inherits and for the ones
+ * `RegisterClassOptions.implements` names.
+ *
+ * Throws when the class does not extend a registered wrapper class, when it has no derivable type
+ * name, when an entry in `RegisterClassOptions.implements` is not a registered interface, when a
+ * listed interface has a prerequisite that neither the parent type nor another listed interface meets,
+ * and when an entry in `RegisterClassOptions.properties` names its `GObject.ParamSpec` something other
+ * than the canonical spelling of the key it sits under.
+ *
+ * A slot is filled from the `vfunc`-prefixed methods on the class's prototype chain, up to but not
+ * including the registered ancestor the class extends, so a method an intermediate base class
+ * declares fills a slot the same way one the class itself declares does. A slot nothing on that
+ * chain fills is left untouched.
+ *
+ * Declare every slot as a method: a class field holding a function, such as `vfuncGetNItems = () => 1`,
+ * is assigned to each instance after registration and never reaches the vtable.
+ *
+ * An override of `vfuncConstructed` runs from inside the base constructor, before JavaScript
+ * installs the subclass's field initializers and runs its constructor body, so a field still
+ * reads `undefined` there and reading a `#private` field throws. Declare state the override
+ * touches without an initializer, and assign private state from the constructor body after
+ * `super()`. An instance a native caller creates, through `GObject.newv` or `Gtk.Builder`,
+ * never runs the subclass constructor at all, so its declared fields stay uninitialized for
+ * the object's whole life.
  *
  * @param klass The subclass to register.
- * @param options Registration options, such as an explicit type name.
- * @returns The same class, now registered.
+ * @param options What the new GType gains beyond the vtable slots the class overrides.
+ * @returns The same class, now registered, with every name in `options.properties` in its property map.
  */
-declare function registerClass<T extends AnyClass>(klass: T, options?: RegisterClassOptions): T;
-export { registerClass };
+declare function registerClass<T extends AnyClass, TProperties extends Record<string, PropertySpec> = Record<never, PropertySpec>>(klass: T, options?: RegisterClassOptions<T["prototype"], TProperties>): RegisteredClass<T, TProperties>;
+export { type Interface, registerClass };
 //# sourceMappingURL=register-class.d.ts.map

package/dist/register-class.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register-class.d.ts","sourceRoot":"","sources":["../src/register-class.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,QAAQ,EAAkC,MAAM,aAAa,CAAC;AAE5E,OAAO,EAKH,KAAK,YAAY,EAEpB,MAAM,iBAAiB,CAAC;AAUzB,KAAK,oBAAoB,GAAG;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC7C,CAAC;AAWF;;;;;;;;;GASG;AACH,iBAAS,aAAa,CAAC,CAAC,SAAS,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,GAAE,oBAAyB,GAAG,CAAC,CAuB1F;AAkOD,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"register-class.d.ts","sourceRoot":"","sources":["../src/register-class.ts"],"names":[],"mappings":"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"}