nine-9 1.8.0 → 1.9.0

package/dist/index.d.ts

@@ -17,6 +17,7 @@ type KebabToCamel<S extends string> = S extends `${infer First}-${infer Rest}` ?
 type ObjectToEntryUnion<T> = {
     [K in keyof T]: [K, T[K]];
 }[keyof T];
+declare function defineTemplate<T = void>(): T;
 
 type Wrapper<T> = {
     get(): T;
@@ -24,6 +25,7 @@ type Wrapper<T> = {
     updateOnly(): void;
     event: EventSubcriber<[T, T]>;
 };
+declare function normalizeWrap<T>(data: T | Wrapper<T>): Wrapper<T>;
 declare function wrap<T>(initialData: T, wrapperOptions?: Partial<Wrapper<T>>): Wrapper<T>;
 declare function sync<R>(effectRenderer: () => R, dependencies?: unknown[]): Wrapper<R>;
 declare function when(condition: Wrapper<boolean> | (() => boolean), tree: () => SourceTree, dependencies?: unknown[]): Wrapper<SourceTree[]>;
@@ -70,30 +72,13 @@ type HostTree<E extends SupportedHTMLElements = SupportedHTMLElements, T = HTMLE
 };
 declare function tree<E extends SupportedHTMLElements>(data: E | Node): HostTree<E, HTMLElementTagNameMap[E], SupportedHTMLRawAttributes[E]>;
 
-type RawSlotInput = SourceTree | (() => SourceTree);
-type SlotInput = RawSlotInput | Wrapper<RawSlotInput>;
-type SlotOutput = () => Wrapper<SourceTree>;
-declare function pipeExtract(input: SlotInput): SlotOutput;
+declare function camelToHyphen<T extends string>(str: T): T;
+declare function hyphenToCamel<T extends string>(str: T): T;
 
-type EventDescriptor<T, N extends string> = {
-    name: N;
-} & EventOptions<T>;
-interface EventOptions<T> {
-    bubbleable?: boolean;
-    template?: T;
-}
-declare function defineEvent<T, N extends string>(name: N, options?: EventOptions<T>): EventDescriptor<T, N>;
+declare function typedIsArray<T>(arr: unknown[]): arr is T[];
+declare function putIntoArray<T>(data: T): T extends (infer R)[] ? R[] : [T];
+declare function createArray<T>(length: number, filler: () => T): T[];
 
-interface ComponentRenderEntry<P extends ComponentPropertyStore, E extends ComponentEventStore> {
-    (props?: ComponentPropertyInputDict<P>, slot?: SlotInput): ComponentInstance<E>;
-}
-interface ComponentInternalRender<P extends ComponentPropertyStore, E extends ComponentEventStore> {
-    (options: ComponentPropertyOutputDict<P>, slot: SlotOutput, emit: <D extends E[number], K extends D["name"]>(key: K, data: D extends infer R extends EventDescriptor<unknown, string> ? R["name"] extends K ? R["template"] : never : never) => void): SourceTree;
-}
-type Component<P extends ComponentPropertyStore, E extends ComponentEventStore> = ComponentRenderEntry<P, E> & ComponentOption<P, E>;
-interface PropertyTransformer<I, O> {
-    (data: I): O;
-}
 interface ComponentPropertyDescriptor<I = unknown, O = unknown, R extends boolean = boolean> {
     validate?: (data: I) => boolean;
     transform: PropertyTransformer<I, O>;
@@ -102,8 +87,6 @@ interface ComponentPropertyDescriptor<I = unknown, O = unknown, R extends boolea
     downloadable?: boolean;
     uploadable?: boolean;
 }
-type ComponentEventStore = EventDescriptor<unknown, string>[];
-type ComponentPropertyStore = Record<string, ComponentPropertyDescriptor>;
 type ComponentPropertyInputDict<P extends ComponentPropertyStore> = {
     [K in keyof P as P[K]["required"] extends true ? K : never]: P[K] extends ComponentPropertyDescriptor<unknown, infer R> ? R | Wrapper<R> : never;
 } & {
@@ -112,14 +95,67 @@ type ComponentPropertyInputDict<P extends ComponentPropertyStore> = {
 type ComponentPropertyOutputDict<P extends ComponentPropertyStore> = {
     [K in keyof P]: P[K] extends ComponentPropertyDescriptor<unknown, infer R> ? Wrapper<R> : never;
 };
-interface ComponentOption<P extends ComponentPropertyStore, E extends ComponentEventStore> {
+declare function rawProperty<T>(): PropertyTransformer<unknown, T>;
+declare function normalizePropertyDescriptor<I, O, R extends boolean>(descriptor: ComponentPropertyDescriptor<I, O, R>): Required<ComponentPropertyDescriptor<I, O, R>>;
+declare function validateStore(store: ComponentPropertyStore): void;
+declare function hostdown<T extends ComponentPropertyStore>(upstream?: ComponentPropertyInputDict<T>, store?: T): ComponentPropertyOutputDict<T>;
+
+type SlotDescriptor<T = unknown, N extends string = string, R extends boolean = boolean> = {
+    name: N;
+} & SlotOptions<T, R>;
+interface SlotOptions<T, R extends boolean> {
+    template: T;
+    required?: R;
+    defaultValue?: SourceTree;
+}
+type SlotInput<T> = (data: Wrapper<T>) => SourceTree | Wrapper<SourceTree>;
+type SlotOutput<T> = (data: T | Wrapper<T>) => Wrapper<SourceTree>;
+type ComponentSlotInputDict<T extends ComponentSlotStore> = {
+    [K in T[number] as K["name"]]?: SlotInput<K["template"]>;
+};
+type ComponentSlotOutputDict<T extends ComponentSlotStore> = {
+    [K in T[number] as K["name"]]-?: SlotOutput<K["template"]>;
+};
+declare function extractInput<T>(render: SlotInput<T>): SlotOutput<T>;
+declare function renderSlots<T extends ComponentSlotStore>(rawInput?: ComponentSlotInputDict<T>, store?: T): ComponentSlotOutputDict<T>;
+declare function defineSlot<N extends string, R extends boolean, T>(name: N, options: SlotOptions<T, R>): {
+    template: T;
+    required?: R | undefined;
+    defaultValue?: SourceTree;
+    name: N;
+};
+
+type EventDescriptor<T = unknown, N extends string = string> = {
+    name: N;
+} & EventOptions<T>;
+interface EventOptions<T> {
+    bubbleable?: boolean;
+    template?: T;
+}
+declare function defineEvent<T, N extends string>(name: N, options?: EventOptions<T>): EventDescriptor<T, N>;
+
+interface ComponentRenderEntry<P extends ComponentPropertyStore, E extends ComponentEventStore, S extends ComponentSlotStore> {
+    (props?: ComponentPropertyInputDict<P>, slot?: ComponentSlotInputDict<S>): ComponentInstance<E>;
+}
+interface ComponentInternalRender<P extends ComponentPropertyStore, E extends ComponentEventStore, S extends ComponentSlotStore> {
+    (options: ComponentPropertyOutputDict<P>, slot: ComponentSlotOutputDict<S>, emit: <D extends E[number], K extends D["name"]>(key: K, data: D extends infer R extends EventDescriptor ? R["name"] extends K ? R["template"] : never : never) => void): SourceTree;
+}
+type Component<P extends ComponentPropertyStore, E extends ComponentEventStore, S extends ComponentSlotStore> = ComponentRenderEntry<P, E, S> & ComponentOption<P, E, S>;
+interface PropertyTransformer<I, O> {
+    (data: I): O;
+}
+type ComponentPropertyStore = Record<string, ComponentPropertyDescriptor>;
+type ComponentEventStore = EventDescriptor[];
+type ComponentSlotStore = SlotDescriptor[];
+interface ComponentOption<P extends ComponentPropertyStore, E extends ComponentEventStore, S extends ComponentSlotStore> {
     props?: P;
     events?: E;
     styles?: StyleSet[];
+    slots?: S;
 }
 type ComponentInstance<E extends ComponentEventStore = ComponentEventStore> = {
     mount(to: string | HTMLElement): void;
-    on<D extends E[number], K extends D["name"]>(key: K, data: (data: D extends infer R extends EventDescriptor<unknown, string> ? R["name"] extends K ? R["template"] : never : never) => void): ComponentInstance<E>;
+    on<D extends E[number], K extends D["name"]>(key: K, data: (data: D extends infer R extends EventDescriptor ? R["name"] extends K ? R["template"] : never : never) => void): ComponentInstance<E>;
     $: HostTree;
 };
 type RawSourceTree = [
@@ -136,19 +172,7 @@ declare function render(nodeTree: SourceTree): HostTree;
 declare function $<T>(data: Wrapper<T>): Wrapper<SourceTree>;
 declare function flagment<T extends string>(uuid: T): `nine_${string}`;
 declare function attachUUID(root: Node, uuid: string): Node;
-declare function createComponent<P extends ComponentPropertyStore, E extends EventDescriptor<unknown, string>>(options: ComponentOption<P, E[]>, internalRenderer: ComponentInternalRender<P, E[]>): Component<P, E[]>;
-
-declare function rawProperty<T>(): PropertyTransformer<unknown, T>;
-declare function normalizePropertyDescriptor<I, O, R extends boolean>(descriptor: ComponentPropertyDescriptor<I, O, R>): Required<ComponentPropertyDescriptor<I, O, R>>;
-declare function validateStore(store: ComponentPropertyStore): void;
-declare function hostdown<T extends ComponentPropertyStore>(upstream?: ComponentPropertyInputDict<T>, store?: T): ComponentPropertyOutputDict<T>;
-
-declare function camelToHyphen<T extends string>(str: T): T;
-declare function hyphenToCamel<T extends string>(str: T): T;
-
-declare function typedIsArray<T>(arr: unknown[]): arr is T[];
-declare function putIntoArray<T>(data: T): T extends (infer R)[] ? R[] : [T];
-declare function createArray<T>(length: number, filler: () => T): T[];
+declare function createComponent<P extends ComponentPropertyStore, E extends EventDescriptor, S extends SlotDescriptor>(options: ComponentOption<P, E[], S[]>, internalRenderer: ComponentInternalRender<P, E[], S[]>): Component<P, E[], S[]>;
 
 declare namespace logo {
   export {  };
@@ -189,4 +213,4 @@ declare const _default: {
     }, (EventDescriptor<number, "select"> | EventDescriptor<boolean, "toggleState">)[]>;
 };
 
-export { $, type Component, type ComponentEventStore, type ComponentInstance, type ComponentInternalRender, type ComponentOption, type ComponentPropertyDescriptor, type ComponentPropertyInputDict, type ComponentPropertyOutputDict, type ComponentPropertyStore, type ComponentRenderEntry, type EmptyValue, type EventDescriptor, type EventOptions, EventSubcriber, type HostTree, type HostTreeHookStore, type HostTreeHooks, type KebabToCamel, type Normalize, type ObjectToEntryUnion, type PropertyTransformer, type RawSlotInput, type RawSourceTree, type SlotInput, type SlotOutput, type SourceTree, type StyleSet, type Valueof, type Wrapper, index as assets, attachUUID, camelToHyphen, createArray, createComponent, defineEvent, _default as examples, flagment, hostdown, hyphenToCamel, normalizePropertyDescriptor, pipeExtract, putIntoArray, rawProperty, render, styleSet, sync, tree, typedIsArray, validateStore, when, wrap };
+export { $, type Component, type ComponentEventStore, type ComponentInstance, type ComponentInternalRender, type ComponentOption, type ComponentPropertyDescriptor, type ComponentPropertyInputDict, type ComponentPropertyOutputDict, type ComponentPropertyStore, type ComponentRenderEntry, type ComponentSlotInputDict, type ComponentSlotOutputDict, type ComponentSlotStore, type EmptyValue, type EventDescriptor, type EventOptions, EventSubcriber, type HostTree, type HostTreeHookStore, type HostTreeHooks, type KebabToCamel, type Normalize, type ObjectToEntryUnion, type PropertyTransformer, type RawSourceTree, type SlotDescriptor, type SlotInput, type SlotOptions, type SlotOutput, type SourceTree, type StyleSet, type Valueof, type Wrapper, index as assets, attachUUID, camelToHyphen, createArray, createComponent, defineEvent, defineSlot, defineTemplate, _default as examples, extractInput, flagment, hostdown, hyphenToCamel, normalizePropertyDescriptor, normalizeWrap, putIntoArray, rawProperty, render, renderSlots, styleSet, sync, tree, typedIsArray, validateStore, when, wrap };