solid-js 1.4.8 → 1.5.0-beta.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/dev.cjs +119 -134
- package/dist/dev.js +119 -134
- package/dist/server.cjs +98 -49
- package/dist/server.js +98 -49
- package/dist/solid.cjs +119 -132
- package/dist/solid.js +119 -132
- package/h/jsx-runtime/types/jsx.d.ts +8 -1401
- package/h/types/hyperscript.d.ts +17 -0
- package/html/types/lit.d.ts +37 -0
- package/package.json +103 -41
- package/store/dist/dev.cjs +40 -22
- package/store/dist/dev.js +41 -23
- package/store/dist/store.cjs +40 -22
- package/store/dist/store.js +40 -22
- package/store/types/index.d.ts +4 -4
- package/store/types/mutable.d.ts +1 -1
- package/store/types/server.d.ts +1 -1
- package/store/types/store.d.ts +1 -1
- package/types/index.d.ts +8 -8
- package/types/jsx.d.ts +196 -1580
- package/types/reactive/array.d.ts +1 -1
- package/types/reactive/observable.d.ts +1 -1
- package/types/reactive/signal.d.ts +69 -34
- package/types/render/Suspense.d.ts +1 -1
- package/types/render/component.d.ts +22 -7
- package/types/render/flow.d.ts +2 -2
- package/types/render/index.d.ts +4 -4
- package/types/server/index.d.ts +3 -3
- package/types/server/reactive.d.ts +8 -3
- package/types/server/rendering.d.ts +11 -6
- package/universal/dist/dev.cjs +0 -0
- package/universal/dist/dev.js +0 -0
- package/universal/dist/universal.cjs +0 -0
- package/universal/dist/universal.js +0 -0
- package/universal/types/index.d.ts +1 -1
- package/web/dist/dev.cjs +3 -3
- package/web/dist/dev.js +3 -3
- package/web/dist/server.cjs +66 -90
- package/web/dist/server.js +66 -90
- package/web/dist/web.cjs +3 -3
- package/web/dist/web.js +3 -3
- package/web/types/client.d.ts +1 -1
- package/web/types/core.d.ts +3 -3
- package/web/types/index.d.ts +8 -9
- package/web/types/jsx.d.ts +1 -1
- package/web/types/server-mock.d.ts +4 -2
- package/web/types/server.d.ts +70 -0
- package/h/README.md +0 -99
- package/h/jsx-runtime/package.json +0 -8
- package/h/package.json +0 -8
- package/html/README.md +0 -84
- package/html/package.json +0 -8
- package/store/README.md +0 -23
- package/store/package.json +0 -35
- package/universal/README.md +0 -102
- package/universal/package.json +0 -18
- package/web/README.md +0 -7
- package/web/package.json +0 -35
package/web/dist/web.cjs
CHANGED
|
@@ -518,12 +518,12 @@ function renderToStream(fn, options) {
|
|
|
518
518
|
throwInBrowser(renderToStream);
|
|
519
519
|
}
|
|
520
520
|
function ssr(template, ...nodes) {}
|
|
521
|
-
function
|
|
521
|
+
function ssrElement(name, props, children, needsId) {}
|
|
522
522
|
function ssrClassList(value) {}
|
|
523
523
|
function ssrStyle(value) {}
|
|
524
|
-
function ssrSpread(accessor) {}
|
|
525
524
|
function ssrAttribute(key, value) {}
|
|
526
525
|
function ssrHydrationKey() {}
|
|
526
|
+
function resolveSSRNode(node) {}
|
|
527
527
|
function escape(html) {}
|
|
528
528
|
function generateHydrationScript() {}
|
|
529
529
|
|
|
@@ -681,8 +681,8 @@ exports.spread = spread;
|
|
|
681
681
|
exports.ssr = ssr;
|
|
682
682
|
exports.ssrAttribute = ssrAttribute;
|
|
683
683
|
exports.ssrClassList = ssrClassList;
|
|
684
|
+
exports.ssrElement = ssrElement;
|
|
684
685
|
exports.ssrHydrationKey = ssrHydrationKey;
|
|
685
|
-
exports.ssrSpread = ssrSpread;
|
|
686
686
|
exports.ssrStyle = ssrStyle;
|
|
687
687
|
exports.style = style;
|
|
688
688
|
exports.template = template;
|
package/web/dist/web.js
CHANGED
|
@@ -515,12 +515,12 @@ function renderToStream(fn, options) {
|
|
|
515
515
|
throwInBrowser(renderToStream);
|
|
516
516
|
}
|
|
517
517
|
function ssr(template, ...nodes) {}
|
|
518
|
-
function
|
|
518
|
+
function ssrElement(name, props, children, needsId) {}
|
|
519
519
|
function ssrClassList(value) {}
|
|
520
520
|
function ssrStyle(value) {}
|
|
521
|
-
function ssrSpread(accessor) {}
|
|
522
521
|
function ssrAttribute(key, value) {}
|
|
523
522
|
function ssrHydrationKey() {}
|
|
523
|
+
function resolveSSRNode(node) {}
|
|
524
524
|
function escape(html) {}
|
|
525
525
|
function generateHydrationScript() {}
|
|
526
526
|
|
|
@@ -587,4 +587,4 @@ function Dynamic(props) {
|
|
|
587
587
|
});
|
|
588
588
|
}
|
|
589
589
|
|
|
590
|
-
export { Aliases, Assets, ChildProperties, DOMElements, DelegatedEvents, Dynamic, Assets as HydrationScript, NoHydration, Portal, PropAliases, Properties, SVGElements, SVGNamespace, addEventListener, assign, classList, className, clearDelegatedEvents, delegateEvents, dynamicProperty, escape, generateHydrationScript, getHydrationKey, getNextElement, getNextMarker, getNextMatch, hydrate, innerHTML, insert, isServer, memo, render, renderToStream, renderToString, renderToStringAsync, resolveSSRNode, runHydrationEvents, setAttribute, setAttributeNS, spread, ssr, ssrAttribute, ssrClassList,
|
|
590
|
+
export { Aliases, Assets, ChildProperties, DOMElements, DelegatedEvents, Dynamic, Assets as HydrationScript, NoHydration, Portal, PropAliases, Properties, SVGElements, SVGNamespace, addEventListener, assign, classList, className, clearDelegatedEvents, delegateEvents, dynamicProperty, escape, generateHydrationScript, getHydrationKey, getNextElement, getNextMarker, getNextMatch, hydrate, innerHTML, insert, isServer, memo, render, renderToStream, renderToString, renderToStringAsync, resolveSSRNode, runHydrationEvents, setAttribute, setAttributeNS, spread, ssr, ssrAttribute, ssrClassList, ssrElement, ssrHydrationKey, ssrStyle, style, template };
|
package/web/types/client.d.ts
CHANGED
package/web/types/core.d.ts
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import { createRoot, createRenderEffect, createComponent, getOwner, sharedConfig } from "
|
|
2
|
-
declare function memo<T>(fn: () => T, equals: boolean): import("
|
|
3
|
-
export { getOwner, createComponent, createRoot as root, createRenderEffect as effect, memo, sharedConfig };
|
|
1
|
+
import { createRoot, createRenderEffect, createComponent, getOwner, sharedConfig, untrack } from "solid-js";
|
|
2
|
+
declare function memo<T>(fn: () => T, equals: boolean): import("solid-js").Accessor<T>;
|
|
3
|
+
export { getOwner, createComponent, createRoot as root, createRenderEffect as effect, memo, sharedConfig, untrack };
|
package/web/types/index.d.ts
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
import { hydrate as hydrateCore } from "./client";
|
|
2
|
-
import {
|
|
3
|
-
export * from "./client";
|
|
4
|
-
export { For, Show, Suspense, SuspenseList, Switch, Match, Index, ErrorBoundary, mergeProps } from "
|
|
5
|
-
export * from "./server-mock";
|
|
1
|
+
import { hydrate as hydrateCore } from "./client.js";
|
|
2
|
+
import { JSX, Accessor, ComponentProps, ValidComponent } from "solid-js";
|
|
3
|
+
export * from "./client.js";
|
|
4
|
+
export { For, Show, Suspense, SuspenseList, Switch, Match, Index, ErrorBoundary, mergeProps } from "solid-js";
|
|
5
|
+
export * from "./server-mock.js";
|
|
6
6
|
export declare const isServer = false;
|
|
7
7
|
export declare const hydrate: typeof hydrateCore;
|
|
8
8
|
/**
|
|
@@ -21,9 +21,8 @@ export declare function Portal<T extends boolean = false, S extends boolean = fa
|
|
|
21
21
|
} : {}) & (S extends true ? SVGGElement : HTMLDivElement)) => void);
|
|
22
22
|
children: JSX.Element;
|
|
23
23
|
}): Text;
|
|
24
|
-
declare type DynamicProps<T> = T & {
|
|
25
|
-
|
|
26
|
-
component?: Component<T> | string | keyof JSX.IntrinsicElements;
|
|
24
|
+
declare type DynamicProps<T extends ValidComponent> = ComponentProps<T> & {
|
|
25
|
+
component: T | undefined;
|
|
27
26
|
};
|
|
28
27
|
/**
|
|
29
28
|
* renders an arbitrary custom or native component and passes the other props
|
|
@@ -32,4 +31,4 @@ declare type DynamicProps<T> = T & {
|
|
|
32
31
|
* ```
|
|
33
32
|
* @description https://www.solidjs.com/docs/latest/api#%3Cdynamic%3E
|
|
34
33
|
*/
|
|
35
|
-
export declare function Dynamic<T>(props: DynamicProps<T>): Accessor<JSX.Element>;
|
|
34
|
+
export declare function Dynamic<T extends ValidComponent>(props: DynamicProps<T>): Accessor<JSX.Element>;
|
package/web/types/jsx.d.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export { JSX } from "
|
|
1
|
+
export type { JSX } from "../../types/jsx.js";
|
|
@@ -25,16 +25,18 @@ export declare function renderToStream<T>(fn: () => T, options?: {
|
|
|
25
25
|
export declare function ssr(template: string[] | string, ...nodes: any[]): {
|
|
26
26
|
t: string;
|
|
27
27
|
};
|
|
28
|
-
export declare function
|
|
28
|
+
export declare function ssrElement(name: string, props: any, children: any, needsId: boolean): {
|
|
29
|
+
t: string;
|
|
30
|
+
};
|
|
29
31
|
export declare function ssrClassList(value: {
|
|
30
32
|
[k: string]: boolean;
|
|
31
33
|
}): string;
|
|
32
34
|
export declare function ssrStyle(value: {
|
|
33
35
|
[k: string]: string;
|
|
34
36
|
}): string;
|
|
35
|
-
export declare function ssrSpread(accessor: any): () => string;
|
|
36
37
|
export declare function ssrAttribute(key: string, value: boolean): string;
|
|
37
38
|
export declare function ssrHydrationKey(): string;
|
|
39
|
+
export declare function resolveSSRNode(node: any): string;
|
|
38
40
|
export declare function escape(html: string): string;
|
|
39
41
|
export declare function generateHydrationScript(): string;
|
|
40
42
|
export declare type LegacyResults = {
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
export function renderToString<T>(
|
|
2
|
+
fn: () => T,
|
|
3
|
+
options?: {
|
|
4
|
+
nonce?: string;
|
|
5
|
+
renderId?: string;
|
|
6
|
+
}
|
|
7
|
+
): string;
|
|
8
|
+
export function renderToStringAsync<T>(
|
|
9
|
+
fn: () => T,
|
|
10
|
+
options?: {
|
|
11
|
+
timeoutMs?: number;
|
|
12
|
+
nonce?: string;
|
|
13
|
+
renderId?: string;
|
|
14
|
+
}
|
|
15
|
+
): Promise<string>;
|
|
16
|
+
export function renderToStream<T>(
|
|
17
|
+
fn: () => T,
|
|
18
|
+
options?: {
|
|
19
|
+
nonce?: string;
|
|
20
|
+
renderId?: string;
|
|
21
|
+
onCompleteShell?: (info: { write: (v: string) => void }) => void;
|
|
22
|
+
onCompleteAll?: (info: { write: (v: string) => void }) => void;
|
|
23
|
+
}
|
|
24
|
+
): {
|
|
25
|
+
pipe: (writable: { write: (v: string) => void }) => void;
|
|
26
|
+
pipeTo: (writable: WritableStream) => void;
|
|
27
|
+
};
|
|
28
|
+
|
|
29
|
+
export function Assets(props: { children?: JSX.Element }): JSX.Element;
|
|
30
|
+
export function HydrationScript(props: { nonce?: string; eventNames?: string[] }): JSX.Element;
|
|
31
|
+
export function NoHydration(props: { children?: JSX.Element }): JSX.Element;
|
|
32
|
+
export function ssr(template: string[] | string, ...nodes: any[]): { t: string };
|
|
33
|
+
export function ssrElement(name: string, props: any, children: any, needsId: boolean): { t: string };
|
|
34
|
+
export function ssrClassList(value: { [k: string]: boolean }): string;
|
|
35
|
+
export function ssrStyle(value: { [k: string]: string }): string;
|
|
36
|
+
export function ssrAttribute(key: string, value: any, isBoolean: boolean): string;
|
|
37
|
+
export function ssrHydrationKey(): string;
|
|
38
|
+
export function resolveSSRNode(node: any): string;
|
|
39
|
+
export function escape(html: string): string;
|
|
40
|
+
export function getHydrationKey(): string;
|
|
41
|
+
export function effect<T>(fn: (prev?: T) => T, init?: T): void;
|
|
42
|
+
export function memo<T>(fn: () => T, equal: boolean): () => T;
|
|
43
|
+
export function createComponent<T>(Comp: (props: T) => JSX.Element, props: T): JSX.Element;
|
|
44
|
+
export function mergeProps(...sources: unknown[]): unknown;
|
|
45
|
+
export function getOwner(): unknown;
|
|
46
|
+
export function generateHydrationScript(options: { nonce?: string; eventNames?: string[] }): string;
|
|
47
|
+
|
|
48
|
+
// deprecated
|
|
49
|
+
export type LegacyResults = {
|
|
50
|
+
write: (text: string) => void;
|
|
51
|
+
startWriting: () => void;
|
|
52
|
+
};
|
|
53
|
+
export function pipeToWritable<T>(
|
|
54
|
+
fn: () => T,
|
|
55
|
+
writable: WritableStream,
|
|
56
|
+
options?: {
|
|
57
|
+
nonce?: string;
|
|
58
|
+
onReady?: (res: LegacyResults) => void;
|
|
59
|
+
onCompleteAll?: () => void;
|
|
60
|
+
}
|
|
61
|
+
): void;
|
|
62
|
+
export function pipeToNodeWritable<T>(
|
|
63
|
+
fn: () => T,
|
|
64
|
+
writable: { write: (v: string) => void },
|
|
65
|
+
options?: {
|
|
66
|
+
nonce?: string;
|
|
67
|
+
onReady?: (res: LegacyResults) => void;
|
|
68
|
+
onCompleteAll?: () => void;
|
|
69
|
+
}
|
|
70
|
+
): void;
|
package/h/README.md
DELETED
|
@@ -1,99 +0,0 @@
|
|
|
1
|
-
# Solid HyperScript
|
|
2
|
-
|
|
3
|
-
This sub module provides a HyperScript method for Solid. This is useful to use Solid in non-compiled environments or in some environments where you can only use a standard JSX transform. This method can be used as the JSX factory function.
|
|
4
|
-
|
|
5
|
-
HyperScript function takes a few forms. The 2nd props argument is optional. Children may be passed as either an array to the 2nd/3rd argument or as every argument past the 2nd.
|
|
6
|
-
|
|
7
|
-
```js
|
|
8
|
-
// create an element with a title attribute
|
|
9
|
-
h("button", { title: "My button" }, "Click Me")
|
|
10
|
-
|
|
11
|
-
// create a component with a title prop
|
|
12
|
-
h(Button, { title: "My button" }, "Click Me")
|
|
13
|
-
|
|
14
|
-
// create an element with many children
|
|
15
|
-
h("div", { title: "My button" }, h("span", "1"), h("span", "2"), h("span", "3"))
|
|
16
|
-
```
|
|
17
|
-
|
|
18
|
-
This is the least efficient way to use Solid as it requires a slightly larger runtime that isn't treeshakebable, and cannot leverage anything in the way of analysis, so it requires manual wrapping of expressions and has a few other caveats (see below).
|
|
19
|
-
|
|
20
|
-
## Example
|
|
21
|
-
|
|
22
|
-
```js
|
|
23
|
-
import { render } from "solid-js/web";
|
|
24
|
-
import h from "solid-js/h";
|
|
25
|
-
import { createSignal } from "solid-js";
|
|
26
|
-
|
|
27
|
-
function Button(props) {
|
|
28
|
-
return h("button.btn-primary", props)
|
|
29
|
-
}
|
|
30
|
-
|
|
31
|
-
function Counter() {
|
|
32
|
-
const [count, setCount] = createSignal(0);
|
|
33
|
-
const increment = (e) => setCount(c => c + 1);
|
|
34
|
-
|
|
35
|
-
return h(Button, { type: "button", onClick: increment }, count);
|
|
36
|
-
}
|
|
37
|
-
|
|
38
|
-
render(Counter, document.getElementById("app"));
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
## Differences from JSX
|
|
42
|
-
|
|
43
|
-
There are a few differences from Solid's JSX that are important to note. And also apply when attempting use any transformation that would compile to HyperScript.
|
|
44
|
-
|
|
45
|
-
1. Reactive expression must be manually wrapped in functions to be reactive.
|
|
46
|
-
|
|
47
|
-
```js
|
|
48
|
-
// jsx
|
|
49
|
-
<div id={props.id}>{firstName() + lastName()}</div>
|
|
50
|
-
|
|
51
|
-
// hyperscript
|
|
52
|
-
h("div", { id: () => props.id }, () => firstName() + lastName())
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
2. Merging spreads requires using the merge props helper to keep reactivity
|
|
56
|
-
|
|
57
|
-
```js
|
|
58
|
-
// jsx
|
|
59
|
-
<div class={selectedClass()} {...props} />
|
|
60
|
-
|
|
61
|
-
// hyperscript
|
|
62
|
-
import { mergeProps } from "solid-js"
|
|
63
|
-
|
|
64
|
-
h("div", mergeProps({ class: selectedClass }, props))
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
3. Events on components require explicit event in the arguments
|
|
68
|
-
|
|
69
|
-
Solid's HyperScript automatically wraps functions passed to props of components with no arguments in getters so you need to provide one to prevent this. The same applies to render props like in the `<For>` component.
|
|
70
|
-
|
|
71
|
-
```js
|
|
72
|
-
// good
|
|
73
|
-
h(Button, { onClick: (e) => console.log("Hi")});
|
|
74
|
-
|
|
75
|
-
// bad
|
|
76
|
-
h(Button, { onClick: () => console.log("Hi")})
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
4. All refs are callback form
|
|
80
|
-
|
|
81
|
-
We can't do the compiled assigment trick so only the callback form is supported.
|
|
82
|
-
|
|
83
|
-
```js
|
|
84
|
-
let myEl;
|
|
85
|
-
|
|
86
|
-
h(div, { ref: (el) => myEl = el });
|
|
87
|
-
```
|
|
88
|
-
|
|
89
|
-
5. There is a shorthand for static id and classes
|
|
90
|
-
|
|
91
|
-
```js
|
|
92
|
-
h("div#some-id.my-class")
|
|
93
|
-
```
|
|
94
|
-
|
|
95
|
-
6. Fragments are just arrays
|
|
96
|
-
|
|
97
|
-
```js
|
|
98
|
-
[h("span", "1"), h("span", "2")]
|
|
99
|
-
```
|
package/h/package.json
DELETED
package/html/README.md
DELETED
|
@@ -1,84 +0,0 @@
|
|
|
1
|
-
# Solid Tagged Template Literals
|
|
2
|
-
|
|
3
|
-
This sub module provides a Tagged Template Literal `html` method for Solid. This is useful to use Solid in non-compiled environments. This method can be used as replacement for JSX.
|
|
4
|
-
|
|
5
|
-
`html` uses `${}` to escape into JavaScript expressions. Components are closed with `<//>`
|
|
6
|
-
|
|
7
|
-
```js
|
|
8
|
-
// create an element with a title attribute
|
|
9
|
-
html`<button title="My button">Click Me</button>`
|
|
10
|
-
|
|
11
|
-
// create a component with a title prop
|
|
12
|
-
html`<${Button} title="My button">Click me<//>`
|
|
13
|
-
|
|
14
|
-
// create an element with dynamic attribute and spread
|
|
15
|
-
html`<div title=${() => selectedClass()} ...${props} />`
|
|
16
|
-
```
|
|
17
|
-
|
|
18
|
-
Using `html` is slightly less efficient than JSX(but more than HyperScript), requires a larger runtime that isn't treeshakebable, and cannot leverage expression analysis, so it requires manual wrapping of expressions and has a few other caveats (see below).
|
|
19
|
-
|
|
20
|
-
## Example
|
|
21
|
-
|
|
22
|
-
```js
|
|
23
|
-
import { render } from "solid-js/web";
|
|
24
|
-
import html from "solid-js/html";
|
|
25
|
-
import { createSignal } from "solid-js";
|
|
26
|
-
|
|
27
|
-
function Button(props) {
|
|
28
|
-
return html`<button class="btn-primary" ...${props} />`;
|
|
29
|
-
}
|
|
30
|
-
|
|
31
|
-
function Counter() {
|
|
32
|
-
const [count, setCount] = createSignal(0);
|
|
33
|
-
const increment = (e) => setCount((c) => c + 1);
|
|
34
|
-
|
|
35
|
-
return html`<${Button} type="button" onClick=${increment}>${count}<//>`;
|
|
36
|
-
}
|
|
37
|
-
|
|
38
|
-
render(Counter, document.getElementById("app"));
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
## Differences from JSX
|
|
42
|
-
|
|
43
|
-
There are a few differences from Solid's JSX that are important to note.
|
|
44
|
-
|
|
45
|
-
1. Reactive expression must be manually wrapped in functions to be reactive.
|
|
46
|
-
|
|
47
|
-
```js
|
|
48
|
-
// jsx
|
|
49
|
-
<div id={props.id}>{firstName() + lastName()}</div>
|
|
50
|
-
|
|
51
|
-
// hyperscript
|
|
52
|
-
html`<div id=${() => props.id}>${() => firstName() + lastName()}</div>`
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
2. Events on components require explicit event in the arguments
|
|
56
|
-
|
|
57
|
-
Solid's Tagged Template Literals automatically wraps functions passed to props of components with no arguments in getters so you need to provide one to prevent this. The same applies to render props like in the `<For>` component.
|
|
58
|
-
|
|
59
|
-
```js
|
|
60
|
-
// good
|
|
61
|
-
html`<${Button} onClick=${(e) => console.log("Hi")} />`;
|
|
62
|
-
|
|
63
|
-
// bad
|
|
64
|
-
html`<${Button} onClick=${() => console.log("Hi")} />`;
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
4. All refs are callback form
|
|
68
|
-
|
|
69
|
-
We can't do the compiled assigment trick so only the callback form is supported.
|
|
70
|
-
|
|
71
|
-
```js
|
|
72
|
-
let myEl;
|
|
73
|
-
html`<div ref=${(el) => myEl = el} />`;
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
5. There can be multiple top level elements
|
|
77
|
-
|
|
78
|
-
No need for fragments just:
|
|
79
|
-
```js
|
|
80
|
-
html`
|
|
81
|
-
<div>1</div>
|
|
82
|
-
<div>2</div>
|
|
83
|
-
`
|
|
84
|
-
```
|
package/html/package.json
DELETED
package/store/README.md
DELETED
|
@@ -1,23 +0,0 @@
|
|
|
1
|
-
# Solid Store
|
|
2
|
-
|
|
3
|
-
This submodules contains the means for handling deeps nested reactivity. It provides 2 main primitives `createStore` and `createMutable` which leverage proxies to create dynamic nested reactive structures.
|
|
4
|
-
|
|
5
|
-
This also contains helper methods `produce` and `reconcile` which augment the behavior of the store setter method to allow for localized mutation and data diffing.
|
|
6
|
-
|
|
7
|
-
For full documentation, check out the [website](https://www.solidjs.com/docs/latest/api).
|
|
8
|
-
|
|
9
|
-
## Example
|
|
10
|
-
|
|
11
|
-
```js
|
|
12
|
-
import { createStore } from "solid-js/store";
|
|
13
|
-
|
|
14
|
-
const [store, setStore] = createStore({
|
|
15
|
-
user: {
|
|
16
|
-
firstName: "John",
|
|
17
|
-
lastName: "Smith"
|
|
18
|
-
}
|
|
19
|
-
});
|
|
20
|
-
|
|
21
|
-
// update store.user.firstName
|
|
22
|
-
setStore("user", "firstName", "Will");
|
|
23
|
-
```
|
package/store/package.json
DELETED
|
@@ -1,35 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "solid-js/store",
|
|
3
|
-
"main": "./dist/server.cjs",
|
|
4
|
-
"module": "./dist/server.js",
|
|
5
|
-
"browser": {
|
|
6
|
-
"./dist/server.cjs": "./dist/store.cjs",
|
|
7
|
-
"./dist/server.js": "./dist/store.js"
|
|
8
|
-
},
|
|
9
|
-
"unpkg": "./dist/store.cjs",
|
|
10
|
-
"types": "./types/index.d.ts",
|
|
11
|
-
"type": "module",
|
|
12
|
-
"sideEffects": false,
|
|
13
|
-
"exports": {
|
|
14
|
-
".": {
|
|
15
|
-
"browser": {
|
|
16
|
-
"development": {
|
|
17
|
-
"import": "./dist/dev.js",
|
|
18
|
-
"require": "./dist/dev.cjs"
|
|
19
|
-
},
|
|
20
|
-
"import": "./dist/store.js",
|
|
21
|
-
"require": "./dist/store.cjs"
|
|
22
|
-
},
|
|
23
|
-
"node": {
|
|
24
|
-
"import": "./dist/server.js",
|
|
25
|
-
"require": "./dist/server.cjs"
|
|
26
|
-
},
|
|
27
|
-
"development": {
|
|
28
|
-
"import": "./dist/dev.js",
|
|
29
|
-
"require": "./dist/dev.cjs"
|
|
30
|
-
},
|
|
31
|
-
"import": "./dist/store.js",
|
|
32
|
-
"require": "./dist/store.cjs"
|
|
33
|
-
}
|
|
34
|
-
}
|
|
35
|
-
}
|
package/universal/README.md
DELETED
|
@@ -1,102 +0,0 @@
|
|
|
1
|
-
# Solid Universal
|
|
2
|
-
|
|
3
|
-
This contains the means to create the runtime for a custom renderer for Solid. This can enable using Solid to render to different platforms like native mobile and desktop, canvas or WebGL, or even the terminal. It relies on custom compilation from `babel-preset-solid` and exporting the result of `createRenderer` at a referenceable location.
|
|
4
|
-
|
|
5
|
-
## Example
|
|
6
|
-
|
|
7
|
-
To use a custom renderer available in the (fictional) `solid-custom-dom` package you'd configure your babelrc as:
|
|
8
|
-
```json
|
|
9
|
-
{
|
|
10
|
-
"presets": [
|
|
11
|
-
[
|
|
12
|
-
"babel-preset-solid",
|
|
13
|
-
{
|
|
14
|
-
"moduleName": "solid-custom-dom",
|
|
15
|
-
"generate": "universal"
|
|
16
|
-
}
|
|
17
|
-
]
|
|
18
|
-
]
|
|
19
|
-
}
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
To create a custom renderer you must implement certain methods and export (as named exports) the results. You may also want to forward `solid-js` control flow to allow them to be auto imported as well.
|
|
23
|
-
|
|
24
|
-
```js
|
|
25
|
-
// example custom dom renderer
|
|
26
|
-
import { createRenderer } from "solid-js/universal";
|
|
27
|
-
|
|
28
|
-
const PROPERTIES = new Set(["className", "textContent"]);
|
|
29
|
-
|
|
30
|
-
export const {
|
|
31
|
-
render,
|
|
32
|
-
effect,
|
|
33
|
-
memo,
|
|
34
|
-
createComponent,
|
|
35
|
-
createElement,
|
|
36
|
-
createTextNode,
|
|
37
|
-
insertNode,
|
|
38
|
-
insert,
|
|
39
|
-
spread,
|
|
40
|
-
setProp,
|
|
41
|
-
mergeProps
|
|
42
|
-
} = createRenderer({
|
|
43
|
-
createElement(string) {
|
|
44
|
-
return document.createElement(string);
|
|
45
|
-
},
|
|
46
|
-
createTextNode(value) {
|
|
47
|
-
return document.createTextNode(value);
|
|
48
|
-
},
|
|
49
|
-
replaceText(textNode, value) {
|
|
50
|
-
textNode.data = value;
|
|
51
|
-
},
|
|
52
|
-
setProperty(node, name, value) {
|
|
53
|
-
if (name === "style") Object.assign(node.style, value);
|
|
54
|
-
else if (name.startsWith("on")) node[name.toLowerCase()] = value;
|
|
55
|
-
else if (PROPERTIES.has(name)) node[name] = value;
|
|
56
|
-
else node.setAttribute(name, value);
|
|
57
|
-
},
|
|
58
|
-
insertNode(parent, node, anchor) {
|
|
59
|
-
parent.insertBefore(node, anchor);
|
|
60
|
-
},
|
|
61
|
-
isTextNode(node) {
|
|
62
|
-
return node.type === 3;
|
|
63
|
-
},
|
|
64
|
-
removeNode(parent, node) {
|
|
65
|
-
parent.removeChild(node);
|
|
66
|
-
},
|
|
67
|
-
getParentNode(node) {
|
|
68
|
-
return node.parentNode;
|
|
69
|
-
},
|
|
70
|
-
getFirstChild(node) {
|
|
71
|
-
return node.firstChild;
|
|
72
|
-
},
|
|
73
|
-
getNextSibling(node) {
|
|
74
|
-
return node.nextSibling;
|
|
75
|
-
}
|
|
76
|
-
});
|
|
77
|
-
|
|
78
|
-
// Forward Solid control flow
|
|
79
|
-
export {
|
|
80
|
-
For,
|
|
81
|
-
Show,
|
|
82
|
-
Suspense,
|
|
83
|
-
SuspenseList,
|
|
84
|
-
Switch,
|
|
85
|
-
Match,
|
|
86
|
-
Index,
|
|
87
|
-
ErrorBoundary
|
|
88
|
-
} from "solid-js";
|
|
89
|
-
```
|
|
90
|
-
|
|
91
|
-
Then to consume:
|
|
92
|
-
```js
|
|
93
|
-
import { render } from "solid-custom-dom";
|
|
94
|
-
|
|
95
|
-
function App() {
|
|
96
|
-
// the skies the limits
|
|
97
|
-
}
|
|
98
|
-
|
|
99
|
-
render(() => <App />, mountNode)
|
|
100
|
-
```
|
|
101
|
-
|
|
102
|
-
> Note: For TypeScript support of non-standard JSX you will need to provide your own types at a jsx-runtime entry on your package so that it can be set as the `jsxImportSource`. If mixing and matching different JSX implementations you will need use the per file pragmas.
|
package/universal/package.json
DELETED
|
@@ -1,18 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "solid-js/universal",
|
|
3
|
-
"main": "./dist/universal.cjs",
|
|
4
|
-
"module": "./dist/universal.js",
|
|
5
|
-
"types": "./types/index.d.ts",
|
|
6
|
-
"type": "module",
|
|
7
|
-
"sideEffects": false,
|
|
8
|
-
"exports": {
|
|
9
|
-
".": {
|
|
10
|
-
"development": {
|
|
11
|
-
"import": "./dist/dev.js",
|
|
12
|
-
"require": "./dist/dev.cjs"
|
|
13
|
-
},
|
|
14
|
-
"import": "./dist/universal.js",
|
|
15
|
-
"require": "./dist/universal.cjs"
|
|
16
|
-
}
|
|
17
|
-
}
|
|
18
|
-
}
|
package/web/README.md
DELETED
|
@@ -1,7 +0,0 @@
|
|
|
1
|
-
# Solid Web
|
|
2
|
-
|
|
3
|
-
This submodule contains the web specific APIs for Solid that are mostly internal methods imported during compilation. It has all the code to render for the web on the server and the browser.
|
|
4
|
-
|
|
5
|
-
In addition this modules provides the primary entry point methods `render`, `hydrate`, `renderToString`, `renderToStringAsync`, `pipeToNodeWritable`, and `pipeToWritable`. As well as a few web specific control flow components `<Portal>` and `<Dynamic>`.
|
|
6
|
-
|
|
7
|
-
Refer to the [website](https://www.solidjs.com/docs/latest/api) for documentation.
|
package/web/package.json
DELETED
|
@@ -1,35 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "solid-js/web",
|
|
3
|
-
"main": "./dist/server.cjs",
|
|
4
|
-
"module": "./dist/server.js",
|
|
5
|
-
"browser": {
|
|
6
|
-
"./dist/server.cjs": "./dist/web.cjs",
|
|
7
|
-
"./dist/server.js": "./dist/web.js"
|
|
8
|
-
},
|
|
9
|
-
"unpkg": "./dist/web.cjs",
|
|
10
|
-
"types": "./types/index.d.ts",
|
|
11
|
-
"type": "module",
|
|
12
|
-
"sideEffects": false,
|
|
13
|
-
"exports": {
|
|
14
|
-
".": {
|
|
15
|
-
"browser": {
|
|
16
|
-
"development": {
|
|
17
|
-
"import": "./dist/dev.js",
|
|
18
|
-
"require": "./dist/dev.cjs"
|
|
19
|
-
},
|
|
20
|
-
"import": "./dist/web.js",
|
|
21
|
-
"require": "./dist/web.cjs"
|
|
22
|
-
},
|
|
23
|
-
"node": {
|
|
24
|
-
"import": "./dist/server.js",
|
|
25
|
-
"require": "./dist/server.cjs"
|
|
26
|
-
},
|
|
27
|
-
"development": {
|
|
28
|
-
"import": "./dist/dev.js",
|
|
29
|
-
"require": "./dist/dev.cjs"
|
|
30
|
-
},
|
|
31
|
-
"import": "./dist/web.js",
|
|
32
|
-
"require": "./dist/web.cjs"
|
|
33
|
-
}
|
|
34
|
-
}
|
|
35
|
-
}
|