@gtkx/runtime 1.6.0 → 2.0.0-beta.2

package/dist/register-class.d.ts

@@ -1,310 +1,188 @@
 import { type AnyClass } from "@gtkx/utils";
 import { type PropertySpec } from "./properties.js";
+import { descriptorFreePropertySpec, propertyMapOverride, writablePropertyMapOverride } from "./property-brand.js";
+import { classSignalMember, naturalSignalMember, signalEmitMapOverride, signalMapOverride } from "./signal-brand.js";
 import { type TypedClass } from "./type.js";
-/**
- * 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 & {
+/** A generated interface value, such as `Gio.ListModel`, accepted by {@link registerClass}. */
+type Interface<TImpl, TInstance = object> = AnyClass & {
     /** Type-level slot holding the interface's `Impl` type; no value ever carries it. */
-    __impl__: (impl: Partial<TImpl> & object) => void;
+    __impl__: (impl: Partial<TImpl> & object) => TInstance;
 };
-/**
- * One key of `RegisterClassOptions.properties` with every underscore turned into the dash a canonical
- * GObject property name separates its words with.
- */
+/** Converts underscores in a property name to canonical dashes. */
 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.
- */
+/** Converts a dashed property name to its JavaScript spelling. */
 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 spelling 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.
- */
+/** Property-map keys in the camelCase spelling hooks use. */
 type InstalledNames<TProperties> = string extends keyof TProperties ? never : Camelized<Dashed<keyof TProperties & string>>;
-/**
- * The base names the signal surface takes for the signals `RegisterClassOptions.signals` declares:
- * each name as written, plus its canonical spelling with underscores turned into dashes, which
- * GObject knows the signal by too.
- */
+/** Declared signal names in their original and canonical spellings. */
 type DeclaredSignalBase<TSignals> = (keyof TSignals & string) | Dashed<keyof TSignals & string>;
-/**
- * The names `connect` and `emit` take for one of the signals `RegisterClassOptions.signals`
- * declares: each spelling of each name, plus its detailed form for a signal emitted with a
- * `::detail` suffix.
- */
+/** Declared signal names, including detailed forms. */
 type DeclaredSignalName<TSignals> = DeclaredSignalBase<TSignals> | `${DeclaredSignalBase<TSignals>}::${string}`;
-/**
- * The `connect` and `emit` signatures instances gain for the signals
- * `RegisterClassOptions.signals` declares, widening the inherited ones, which take only the names
- * introspection knows. A class declaring no signals gains nothing, since no name reaches the
- * added signatures.
- */
-type DeclaredSignalMethods<TSignals> = {
-    /**
-     * Type-level map from declared signal name to handler signature, feeding the hooks that
-     * address a signal by name, such as `useSignal` from `@gtkx/react`; no value ever carries it.
-     */
-    __signals__?: Record<DeclaredSignalBase<TSignals>, (...args: never[]) => unknown>;
-    /** Connects a handler to a signal `RegisterClassOptions.signals` declared. */
+/** Signal methods added for declared names. */
+type DeclaredSignalMethods<TSignals, TBlockedMembers extends PropertyKey> = {
+    /** Type-level map used by signal hooks. */
+    __signals__?: Record<DeclaredSignalName<TSignals>, (...args: never[]) => unknown>;
+} & Pick<{
     connect(signal: DeclaredSignalName<TSignals>, handler: (...args: never[]) => unknown, isAfter?: boolean): number;
-    /** Emits a signal `RegisterClassOptions.signals` declared. */
     emit(sigName: DeclaredSignalName<TSignals>, ...args: unknown[]): unknown;
-    /** Connects a handler to a signal `RegisterClassOptions.signals` declared, for `off` to take off. */
-    on(sigName: DeclaredSignalName<TSignals>, callback: (...args: unknown[]) => unknown, isAfter?: boolean): unknown;
-    /** Connects a handler to a signal `RegisterClassOptions.signals` declared for one emission. */
-    once(sigName: DeclaredSignalName<TSignals>, callback: (...args: unknown[]) => unknown, isAfter?: boolean): unknown;
-    /** Disconnects a handler `on` or `once` connected to a signal `RegisterClassOptions.signals` declared. */
-    off(sigName: DeclaredSignalName<TSignals>, callback: (...args: unknown[]) => unknown): unknown;
+    on(sigName: DeclaredSignalName<TSignals>, callback: (...args: never[]) => unknown, isAfter?: boolean): unknown;
+    once(sigName: DeclaredSignalName<TSignals>, callback: (...args: never[]) => unknown, isAfter?: boolean): unknown;
+    off(sigName: DeclaredSignalName<TSignals>, callback: (...args: never[]) => unknown): unknown;
+}, Exclude<"connect" | "emit" | "off" | "on" | "once", TBlockedMembers>>;
+/** A registered instance with declared signal methods and property metadata. */
+type RegisteredInstance<TInstance, TProperties, TSignals, TInterfaces extends readonly Interface<TInstance>[], TRemainingInterfaces extends readonly Interface<TInstance>[] = TInterfaces, TMemberSurface = object, TSignalSurface = TInstance extends {
+    [signalMapOverride]?: infer TResolver;
+} ? TResolver extends () => infer TMap ? NonNullable<TMap> : TInstance extends {
+    __signals__?: infer TMap;
+} ? NonNullable<TMap> : object : TInstance extends {
+    __signals__?: infer TMap;
+} ? NonNullable<TMap> : object, TSignalEmitSurface = TInstance extends {
+    [signalEmitMapOverride]?: infer TResolver;
+} ? TResolver extends () => infer TMap ? NonNullable<TMap> : TInstance extends {
+    __signalEmit__?: infer TMap;
+} ? NonNullable<TMap> : object : TInstance extends {
+    __signalEmit__?: infer TMap;
+} ? NonNullable<TMap> : object, TPropertySurface = TInstance extends {
+    [propertyMapOverride]?: infer TResolver;
+} ? TResolver extends () => infer TMap ? NonNullable<TMap> : TInstance extends {
+    __properties__?: infer TMap;
+} ? NonNullable<TMap> : object : TInstance extends {
+    __properties__?: infer TMap;
+} ? NonNullable<TMap> : object, TWritablePropertySurface = TInstance extends {
+    [writablePropertyMapOverride]?: infer TResolver;
+} ? TResolver extends () => infer TMap ? NonNullable<TMap> : TInstance extends {
+    __writableProperties__?: infer TMap;
+} ? NonNullable<TMap> : object : TInstance extends {
+    __writableProperties__?: infer TMap;
+} ? NonNullable<TMap> : object, TNaturalInstanceMembers extends PropertyKey = TInstance extends {
+    [naturalSignalMember]?: infer TMembers;
+} ? keyof NonNullable<TMembers> : never, TClassInstanceSignals extends PropertyKey = TInstance extends {
+    [classSignalMember]?: infer TMembers;
+} ? keyof NonNullable<TMembers> : never, TLegacySignalMembers extends PropertyKey = "connect" | "disconnect" | "emit" | "off" | "on" | "once", TInstalledPropertyCandidate = TInstance & TMemberSurface, TRegisteredPropertySurface = Omit<TPropertySurface, InstalledNames<TProperties>> & Pick<TInstalledPropertyCandidate, (string extends keyof TProperties ? never : {
+    [K in keyof TProperties & string]: TProperties[K] extends {
+        readonly [descriptorFreePropertySpec]: true;
+    } ? Camelized<Dashed<K>> : never;
+}[keyof TProperties & string]) & {
+    [K in keyof TInstalledPropertyCandidate]-?: Extract<TInstalledPropertyCandidate[K], (...args: never[]) => unknown> extends never ? K : never;
+}[keyof TInstalledPropertyCandidate]>, TRegisteredWritablePropertySurface = Omit<TWritablePropertySurface, InstalledNames<TProperties>> & Pick<TInstalledPropertyCandidate, (string extends keyof TProperties ? never : {
+    [K in keyof TProperties & string]: TProperties[K] extends {
+        readonly [descriptorFreePropertySpec]: true;
+    } ? Camelized<Dashed<K>> : never;
+}[keyof TProperties & string]) & {
+    [K in keyof TInstalledPropertyCandidate]-?: Extract<TInstalledPropertyCandidate[K], (...args: never[]) => unknown> extends never ? (<U>(probe: U) => U extends {
+        [P in K]: TInstalledPropertyCandidate[P];
+    } ? 1 : 2) extends (<U>(probe: U) => U extends {
+        -readonly [P in K]: TInstalledPropertyCandidate[P];
+    } ? 1 : 2) ? K : never : never;
+}[keyof TInstalledPropertyCandidate]>> = TRemainingInterfaces extends readonly [
+    infer TInterface extends Interface<TInstance>,
+    ...infer TRest extends readonly Interface<TInstance>[]
+] ? (ReturnType<TInterface["__impl__"]> extends infer TInterfaceInstance extends object ? RegisteredInstance<TInstance, TProperties, TSignals, TInterfaces, TRest, TMemberSurface & Omit<TInterfaceInstance, keyof TInstance | keyof TMemberSurface | "__properties__" | "__writableProperties__" | "__signalEmit__" | "__signals__" | TLegacySignalMembers> & {
+    [K in Extract<TInterfaceInstance extends {
+        [naturalSignalMember]?: infer TMembers;
+    } ? keyof NonNullable<TMembers> : never, TLegacySignalMembers> as K extends TNaturalInstanceMembers | keyof TMemberSurface ? never : K]: K extends keyof TInterfaceInstance ? TInterfaceInstance[K] : never;
+}, TInterfaceInstance extends {
+    __signals__?: infer TNextSignalMap;
+} ? Omit<TSignalSurface, keyof {
+    [K in keyof NonNullable<TNextSignalMap> as K extends string ? Dashed<K extends `${infer TBase}::${string}` ? TBase : K> extends TClassInstanceSignals | Dashed<keyof TSignals & string> ? never : K : K]: NonNullable<TNextSignalMap>[K];
+}> & {
+    [K in keyof NonNullable<TNextSignalMap> as K extends string ? Dashed<K extends `${infer TBase}::${string}` ? TBase : K> extends TClassInstanceSignals | Dashed<keyof TSignals & string> ? never : K : K]: NonNullable<TNextSignalMap>[K];
+} : TSignalSurface, TInterfaceInstance extends {
+    __signalEmit__?: infer TNextSignalEmitMap;
+} ? Omit<TSignalEmitSurface, keyof {
+    [K in keyof NonNullable<TNextSignalEmitMap> as K extends string ? Dashed<K extends `${infer TBase}::${string}` ? TBase : K> extends TClassInstanceSignals | Dashed<keyof TSignals & string> ? never : K : K]: NonNullable<TNextSignalEmitMap>[K];
+}> & {
+    [K in keyof NonNullable<TNextSignalEmitMap> as K extends string ? Dashed<K extends `${infer TBase}::${string}` ? TBase : K> extends TClassInstanceSignals | Dashed<keyof TSignals & string> ? never : K : K]: NonNullable<TNextSignalEmitMap>[K];
+} : TSignalEmitSurface, TPropertySurface & Omit<TInterfaceInstance extends {
+    [propertyMapOverride]?: infer TResolver;
+} ? TResolver extends () => infer TMap ? NonNullable<TMap> : TInterfaceInstance extends {
+    __properties__?: infer TMap;
+} ? NonNullable<TMap> : object : TInterfaceInstance extends {
+    __properties__?: infer TMap;
+} ? NonNullable<TMap> : object, keyof TPropertySurface>, TWritablePropertySurface & Omit<TInterfaceInstance extends {
+    [writablePropertyMapOverride]?: infer TResolver;
+} ? TResolver extends () => infer TMap ? NonNullable<TMap> : TInterfaceInstance extends {
+    __writableProperties__?: infer TMap;
+} ? NonNullable<TMap> : object : TInterfaceInstance extends {
+    __writableProperties__?: infer TMap;
+} ? NonNullable<TMap> : object, keyof TWritablePropertySurface>, TNaturalInstanceMembers, TClassInstanceSignals, TLegacySignalMembers> : never) : TInstance & TMemberSurface & DeclaredSignalMethods<TSignals, TNaturalInstanceMembers | Extract<keyof TMemberSurface, TLegacySignalMembers>> & {
+    [naturalSignalMember]?: Record<TNaturalInstanceMembers | Extract<keyof TMemberSurface, TLegacySignalMembers>, true>;
+    [classSignalMember]?: Record<TClassInstanceSignals | Dashed<keyof TSignals & string>, true>;
+    [signalMapOverride]?: () => Omit<TSignalSurface, DeclaredSignalName<TSignals>> & Record<DeclaredSignalName<TSignals>, (...args: never[]) => unknown>;
+    [signalEmitMapOverride]?: () => Omit<TSignalEmitSurface, DeclaredSignalName<TSignals>> & Record<DeclaredSignalName<TSignals>, {
+        args: unknown[];
+        result: unknown;
+    }>;
+    [propertyMapOverride]?: () => TRegisteredPropertySurface;
+    [writablePropertyMapOverride]?: () => TRegisteredWritablePropertySurface;
+    __properties__: TRegisteredPropertySurface;
+    __writableProperties__: TRegisteredWritablePropertySurface;
 };
-/**
- * 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, TSignals> = TInstance & DeclaredSignalMethods<TSignals> & {
-    /** 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.
- */
+/** A registered class's construct signature and prototype. */
 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 statics a registered class keeps from the class it was, joined with {@link RegisteredConstructor}. */
 type RegisteredParts<TClass, TArgs extends unknown[], TInstance> = Omit<TClass, "prototype"> & RegisteredConstructor<TClass, TArgs, TInstance>;
-/**
- * The class {@link registerClass} hands back: the same class, with the same statics, whose instances
- * carry the properties `RegisterClassOptions.properties` installed and take the signals
- * `RegisterClassOptions.signals` declares by name. 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, TSignals> = TClass extends abstract new (...args: infer TArgs) => infer TInstance ? RegisteredParts<TClass, TArgs, RegisteredInstance<TInstance, TProperties, TSignals>> : never;
-/**
- * A GType in the form `RegisterClassOptions.signals` takes one: the numeric GType itself, such as
- * `TYPE_STRING` from `@gtkx/gi/gobject`, or a class carrying one, which is any generated wrapper
- * class and any class an earlier {@link registerClass} call registered.
- */
+/** The registered class with its declared properties and signals. */
+type RegisteredClass<TClass extends AnyClass, TProperties, TSignals, TInterfaces extends readonly Interface<TClass["prototype"]>[]> = TClass extends abstract new (...args: infer TArgs) => infer TInstance ? RegisteredParts<TClass, TArgs, RegisteredInstance<TInstance, TProperties, TSignals, TInterfaces>> : never;
+/** A numeric GType or a generated or registered wrapper class. */
 type SignalGType = bigint | AnyClass<TypedClass>;
-/**
- * One signal `RegisterClassOptions.signals` creates on the new type, sitting under the signal's
- * name. Every part is optional: `{}` declares a signal with no arguments and no return value that
- * runs its handlers in the default `RUN_FIRST` stage.
- */
+/** A signal installed by {@link registerClass}. */
 type SignalSpec = {
-    /**
-     * `GObject.SignalFlags` bit mask for the signal, defaulting to `RUN_FIRST`. `DETAILED` lets
-     * handlers connect to and emissions name a `::detail` suffix.
-     */
+    /** `GObject.SignalFlags` bit mask, defaulting to `RUN_FIRST`. */
     flags?: number;
-    /** GType of each argument an emission carries, defaulting to none. */
+    /** Argument GTypes, defaulting to none. */
     paramTypes?: SignalGType[];
-    /** GType of the value an emission returns, defaulting to none. */
+    /** Return GType, defaulting to none. */
     returnType?: SignalGType;
-    /**
-     * How the emission combines what its handlers return, limited to the accumulators GObject
-     * ships: `"first-wins"` stops the emission at the first handler and keeps its result, and
-     * `"true-handled"` runs handlers until one returns `true`, which requires a boolean
-     * `returnType`. Without one, every handler runs and the last result stands.
-     */
+    /** Combines handler results; omitted means the last result wins. */
     accumulator?: "first-wins" | "true-handled";
 };
 /** 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>, TSignals extends Record<string, SignalSpec>> = {
-    /**
-     * Name to register the new GType under, defaulting to the class's own name. Either way the
-     * name has to be a valid GType name: at least three characters, starting with a letter or
-     * underscore, the rest letters, digits, `-`, `_` or `+`. Any other name throws a `TypeError`.
-     */
+type RegisterClassOptions<TInstance extends object, TProperties extends Record<string, PropertySpec>, TSignals extends Record<string, SignalSpec>, TInterfaces extends readonly Interface<TInstance>[]> = {
+    /** Registered GType name, defaulting to the class name. */
     typeName?: string;
-    /**
-     * Registers the new GType abstract, the way `G_TYPE_FLAG_ABSTRACT` marks a C type: the class
-     * still serves as a parent for further registered subclasses, which instantiate as usual, but
-     * constructing it directly throws, whether from JavaScript or from a native caller.
-     */
+    /** Prevents direct construction while allowing registered subclasses. */
     abstract?: boolean;
-    /**
-     * Name instances of the new type carry in CSS, applied through `gtk_widget_class_set_css_name`
-     * from inside the type's `class_init`, so every instance is born with it, wherever it is
-     * created from. Requires the class to extend `Gtk.Widget`; registering a non-widget with a
-     * `cssName` throws.
-     */
+    /** CSS node name for a `Gtk.Widget` subclass. */
     cssName?: string;
     /**
-     * Hook run once, synchronously, while `registerClass` registers the type, after its
-     * `class_init` has installed the vfuncs, properties and signals declared here. It receives the
-     * new type's class struct wrapped in its generated GTypeStruct wrapper, so class-level setup
-     * calls such as `Gtk.WidgetClass.installAction`, `Gtk.WidgetClass.addShortcut` and
-     * `Gtk.WidgetClass.setLayoutManagerType` have somewhere to land. The wrapper serves the
-     * members of every struct in the parent chain on one object: a widget subclass sees
-     * `Gtk.WidgetClass` and `GObject.ObjectClass` members alike, so the parameter can be declared
-     * as whichever of those types the hook needs. The class struct belongs to the type system for
-     * the life of the process, so keeping the wrapper around past the hook is safe, if rarely
-     * useful. An exception the hook throws propagates out of `registerClass`, with the type
-     * already registered: GObject offers no way to unregister a static type.
+     * Runs once after registration with the wrapped class struct. An exception propagates after
+     * the static GType has already been registered and cannot be undone.
      */
     classInit?(typeStruct: object): void;
+    /** Interfaces implemented through matching `vfunc` methods. */
+    implements?: TInterfaces;
     /**
-     * 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`.
-     */
-    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 a name that reads back as that same member, such as `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. A word starting with a digit is a word of its
-     * own on either side of that reading, so `level2Depth` takes a ParamSpec named `level-2-depth`
-     * as readily as one named `level2-depth`, the way `WebKit.Settings` names
-     * `enable-2d-canvas-acceleration` for its `enable2dCanvasAcceleration` member. An uppercase
-     * letter in the ParamSpec's own name is refused, since GObject notifies under that spelling
-     * and nothing else reads it back. 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 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.
-     *
-     * `null` and `undefined` both mean NULL, and mean it only where the ParamSpec's own type holds
-     * NULL, which is a string, string-array, boxed, object, interface, param, variant or pointer
-     * property. Such a property holds the `null` either spelling wrote, so the member, the type's
-     * `get_property` slot and `g_object_get_property` serve the same thing, and writing the other
-     * spelling over it emits no `notify`. Every other property, so every integer, floating-point,
-     * boolean, enum, flags and GType one, refuses both with the same `TypeError` it refuses a
-     * string with, and keeps the value it already holds. It refuses them for what it holds rather
-     * than for its range, whatever that range is: the type is checked before the range, so a
-     * `gint` whose range excludes 0 answers a nullish with that same `TypeError` and never with
-     * the `RangeError` that names the value GObject would put in its place. The one place
-     * `undefined` means something else is the constructor, which reads it as the property not
-     * being given at all and leaves it at the ParamSpec's default, so a property is never handed a
-     * value it cannot serve back.
-     *
-     * A floating-point property takes every JavaScript number, `NaN` and both infinities
-     * included, and its ParamSpec alone rules on which of them the range admits: a `gdouble`
-     * bounded by `-Infinity` and `Infinity` holds either infinity, and a magnitude a bounded
-     * one excludes, like any `NaN`, comes back as the `RangeError` that names what GObject
-     * would put in its place rather than as the `TypeError` a type the property cannot hold
-     * earns. A `gfloat` property holds what GObject narrows the double to, so it serves `0.1`
-     * back as `0.10000000149011612` and a finite magnitude no `gfloat` reaches as an infinity,
-     * which the range then rules on in turn. That narrowing belongs to the property alone: the
-     * same magnitude written to a `gfloat` through a generated binding, a signal argument or a
-     * closure return is refused outright rather than narrowed.
-     *
-     * A generated property of a wrapped type answers a nullish differently, and the two halves of
-     * the API disagree here: that property marshals what it is written through its descriptor
-     * rather than through the checks above, so `new Gtk.Label({ widthRequest: null })` and a later
-     * write of `null` to that member both land 0, where a `gint` installed here refuses both.
-     *
-     * A class that defines the camelCase member itself owns the property: its own accessor decides
-     * what a write means, the other spellings forward to it, and the type's property slots read
-     * and write it rather than the generated storage.
+     * ParamSpecs keyed by their JavaScript property names. Keys and ParamSpec names must canonicalize
+     * to the same member. Writes validate flags, types, and ranges and notify only on changes.
+     * Nullish values require a nullable GType; constructor `undefined` means omitted. An existing
+     * camelCase accessor remains authoritative.
      */
     properties?: TProperties;
     /**
-     * Signals to create on the new type, keyed by signal name and valued with the
-     * {@link SignalSpec} describing each one. A name has to start with a lowercase letter, continue
-     * in lowercase letters, digits, `-` and `_`, and be new to the type: one an ancestor type or a
-     * listed interface already carries throws, and so does one carrying an uppercase letter, which
-     * GObject would carry under that exact spelling, out of reach of both its dashed spelling and
-     * its `on<SignalName>` default handler. Either word separator spells the same signal, so a
-     * signal declared as `data_changed` is connected to and emitted as `data-changed` too.
-     *
-     * Instances connect and emit by name through the same `connect`, `on`, `once`, `off` and
-     * `emit` surface inherited signals use: `registerClass` wraps `connect` and `emit` on the
-     * class's prototype to serve the declared names, unless the class defines the member itself,
-     * and hands every other name to the inherited implementation. A handler receives the
-     * emission's arguments without the leading emitter, matching a generated signal, and what it
-     * returns becomes the emission's return value when the signal declares one.
-     *
-     * The declared parameter GTypes rule the emission: `emit` takes exactly one argument per
-     * declared parameter, throwing a `TypeError` for any other count, and converts each argument
-     * into a `GValue` of the declared type, throwing for a value that type cannot hold. The signals
-     * are created with no class closure of their own, but a method named `on<SignalName>`
-     * becomes the signal's default handler, the way every `on`-prefixed method that names a
-     * signal the type carries does; see {@link registerClass}.
+     * New canonical signal names and specs. Declared GTypes validate emissions, and a matching
+     * `on<SignalName>` method becomes the default handler.
      */
     signals?: TSignals;
 };
 /**
- * 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 or the name is not a valid GType 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,
- * when the list names `Gio.AsyncInitable` as an interface the parent type does not already
- * implement and no method on the chain fills `vfuncInitAsync`, since the default `init_async`
- * would run `vfuncInit` on a worker thread, when an entry in
- * `RegisterClassOptions.properties` names its `GObject.ParamSpec` something the key it sits under
- * does not spell, when an entry in `RegisterClassOptions.signals` carries an invalid name, a name
- * spelled with an uppercase letter rather than dashed, a name the type already knows, a GType
- * that cannot hold a value, or an accumulator the spec does not admit, and when
- * `RegisterClassOptions.cssName` is
- * given for a class that does not extend `Gtk.Widget`. An exception thrown by
- * `RegisterClassOptions.classInit` also propagates, after the type has already been registered.
- *
- * 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.
- *
- * A method named `on<SignalName>` — the signal's name in camelCase after the `on`, so `onClicked`
- * for `clicked` and `onItemsChanged` for `items-changed` — becomes that signal's default handler
- * when the type carries the signal, whether an ancestor type or an implemented interface brings it
- * or `RegisterClassOptions.signals` declares it. The method is installed as a class-closure
- * override, so it runs on every emission, on the instances a native caller creates included, in
- * the stage the signal's flags name rather than alongside connected handlers. It receives the
- * emission's arguments without the leading emitter, with `this` bound to the emitter, and what it
- * returns becomes the emission's result when the signal declares one. The same discovery walks the
- * prototype chain vfunc discovery walks, and a subclass registering its own `on<SignalName>`
- * replaces the handler for its instances, where `super.on<SignalName>()` reaches the replaced one.
- * An `on`-prefixed method naming no signal the type carries is left alone as the ordinary method
- * it is.
+ * Registers a wrapper subclass as a GType with discovered vfuncs, properties, signals, and interfaces.
+ * Vfuncs must be prototype methods; function-valued fields never reach the vtable. A matching
+ * `on<SignalName>` method becomes the signal's default handler.
  *
- * 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.
+ * `vfuncConstructed` runs before field initializers and the constructor body. Native-created
+ * instances never run the JavaScript constructor, so native-required state belongs in properties
+ * or `vfuncConstructed`. A new `Gio.AsyncInitable` must implement `vfuncInitAsync`.
  *
- * @param klass The subclass to register.
- * @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.
+ * @param klass The wrapper subclass to register.
+ * @param options Additional GType configuration.
+ * @returns The registered class with declared properties and signals in its type.
+ * @throws For invalid parents, names, interfaces, vfuncs, properties, signals, or widget options.
+ * A `classInit` exception propagates after the static type has been registered and cannot be undone.
  */
-declare function registerClass<T extends AnyClass, TProperties extends Record<string, PropertySpec> = Record<never, PropertySpec>, TSignals extends Record<string, SignalSpec> = Record<never, SignalSpec>>(klass: T, options?: RegisterClassOptions<T["prototype"], TProperties, TSignals>): RegisteredClass<T, TProperties, TSignals>;
+declare function registerClass<T extends AnyClass, TProperties extends Record<string, PropertySpec> = Record<never, PropertySpec>, TSignals extends Record<string, SignalSpec> = Record<never, SignalSpec>, const TInterfaces extends readonly Interface<T["prototype"]>[] = readonly Interface<T["prototype"]>[]>(klass: T, options?: RegisterClassOptions<T["prototype"], TProperties, TSignals, TInterfaces>): RegisteredClass<T, TProperties, TSignals, TInterfaces>;
 export { type Interface, registerClass, type SignalGType, type SignalSpec };
 //# 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":"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"}
+{"version":3,"file":"register-class.d.ts","sourceRoot":"","sources":["../src/register-class.ts"],"names":[],"mappings":"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"}

package/dist/register-class.js

@@ -3,8 +3,10 @@ import { getParentClass, kebabCase, walkClassChain } from "@gtkx/utils";
 import { wrapCallback } from "./callback.js";
 import { insertMixinLayer } from "./mixin.js";
 import { buildPropertyDispatch, GET_PROPERTY_VFUNC, makeGetProperty, makeSetProperty, SET_PROPERTY_VFUNC, toNativeProperties, } from "./properties.js";
+import { descriptorFreePropertySpec, propertyMapOverride, writablePropertyMapOverride, } from "./property-brand.js";
 import { getClassStructClass, getClassType, getInterfaceMixin, getTypeClassHandle, markDerivedClass, registerClassType, wrapHandle, } from "./registry.js";
-import { connectClosureSignal, emitDeclaredSignal, getSignalBaseName, overrideSignalClassClosure, signalForHandlerName, signalIdFor, } from "./signal.js";
+import { classSignalMember, naturalSignalMember, signalEmitMapOverride, signalMapOverride, } from "./signal-brand.js";
+import { canonicalSignalName, connectClosureSignal, emitDeclaredSignal, installSignalDispatch, overrideSignalClassClosure, signalForHandlerName, signalIdFor, } from "./signal.js";
 import { TYPE_INTERFACE, TYPE_INVALID, TYPE_NONE, typeFundamental, typeInterfacePrerequisites, typeInterfaces, typeIsA, typeName, } from "./type.js";
 import { findClassVfuncDescriptor, findInterfaceVfuncDescriptor } from "./vfunc.js";
 const INSTANCE_ARG_INDEX = 0;
@@ -49,7 +51,7 @@ function registerClass(klass, options = {}) {
     markDerivedClass(klass);
     installSignalOverrides(newType, methods);
     applyInterfaceMixins(klass, adoptedTypes, inheritedNames);
-    installDeclaredSignalMethods(klass, signals.table, members.names);
+    installDeclaredSignalMethods(klass, signals.table);
     invokeClassInit(options, newType);
     return klass;
 }
@@ -261,7 +263,6 @@ function buildPropertyVfunc(klass, methodName, fn, isValueOut) {
         fn: wrapVfunc(fn, argDescriptors, descriptor),
     };
 }
-const canonicalSignalName = (name) => name.replaceAll("_", "-");
 function assertLowerCaseSignalName(klass, name) {
     if (!UPPER_CASE_PATTERN.test(name)) {
         return;
@@ -333,43 +334,24 @@ function resolveDeclaredSignals(klass, signals) {
     }
     return { native, table };
 }
-function inheritedSignalMethod(inherited, signal) {
-    if (inherited === undefined) {
-        throw new Error(`Unknown signal '${signal}'`);
-    }
-    return inherited;
-}
-function installDeclaredConnect(proto, findDeclared) {
-    const inheritedConnect = proto.connect;
-    proto.connect = function connect(signal, handler, isAfter) {
-        if (findDeclared(signal) === undefined) {
-            return inheritedSignalMethod(inheritedConnect, signal).call(this, signal, handler, isAfter);
-        }
-        return connectClosureSignal(this, signal, handler, isAfter ?? false);
-    };
-}
-function installDeclaredEmit(proto, findDeclared) {
-    const inheritedEmit = proto.emit;
-    proto.emit = function emit(sigName, ...args) {
-        const declared = findDeclared(sigName);
-        if (declared === undefined) {
-            return inheritedSignalMethod(inheritedEmit, sigName).call(this, sigName, ...args);
-        }
-        return emitDeclaredSignal(this, sigName, declared, args);
-    };
-}
-function installDeclaredSignalMethods(klass, table, definedNames) {
+function installDeclaredSignalMethods(klass, table) {
     if (table.size === 0) {
         return;
     }
-    const proto = klass.prototype;
-    const findDeclared = (signal) => table.get(canonicalSignalName(getSignalBaseName(signal)));
-    if (!definedNames.has("connect")) {
-        installDeclaredConnect(proto, findDeclared);
-    }
-    if (!definedNames.has("emit")) {
-        installDeclaredEmit(proto, findDeclared);
-    }
+    const findDeclared = (signal) => table.get(canonicalSignalName(signal));
+    installSignalDispatch(klass, table.keys().toArray(), {
+        connect(instance, signal, handler, isAfter) {
+            findDeclared(signal);
+            return connectClosureSignal(instance, signal, handler, isAfter ?? false);
+        },
+        emit(instance, signal, args) {
+            const declared = findDeclared(signal);
+            if (declared === undefined) {
+                throw new Error(`Unknown signal '${signal}'`);
+            }
+            return emitDeclaredSignal(instance, signal, declared, args);
+        },
+    });
 }
 function toNativeInterface(binding) {
     const nativeInterface = {