@xyo-network/react-schema 2.23.7

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.
Files changed (124) hide show
  1. package/LICENSE +165 -0
  2. package/README.md +69 -0
  3. package/babel.config.json +5 -0
  4. package/dist/cjs/components/SelectEx/SchemaSelectEx.d.ts +4 -0
  5. package/dist/cjs/components/SelectEx/SchemaSelectEx.js +24 -0
  6. package/dist/cjs/components/SelectEx/SchemaSelectEx.js.map +1 -0
  7. package/dist/cjs/components/SelectEx/index.d.ts +1 -0
  8. package/dist/cjs/components/SelectEx/index.js +5 -0
  9. package/dist/cjs/components/SelectEx/index.js.map +1 -0
  10. package/dist/cjs/components/index.d.ts +1 -0
  11. package/dist/cjs/components/index.js +5 -0
  12. package/dist/cjs/components/index.js.map +1 -0
  13. package/dist/cjs/contexts/Schema/Context.d.ts +3 -0
  14. package/dist/cjs/contexts/Schema/Context.js +6 -0
  15. package/dist/cjs/contexts/Schema/Context.js.map +1 -0
  16. package/dist/cjs/contexts/Schema/Hooks/index.d.ts +3 -0
  17. package/dist/cjs/contexts/Schema/Hooks/index.js +7 -0
  18. package/dist/cjs/contexts/Schema/Hooks/index.js.map +1 -0
  19. package/dist/cjs/contexts/Schema/Hooks/useSchemaDefinitions.d.ts +2 -0
  20. package/dist/cjs/contexts/Schema/Hooks/useSchemaDefinitions.js +27 -0
  21. package/dist/cjs/contexts/Schema/Hooks/useSchemaDefinitions.js.map +1 -0
  22. package/dist/cjs/contexts/Schema/Hooks/useSchemaList.d.ts +2 -0
  23. package/dist/cjs/contexts/Schema/Hooks/useSchemaList.js +26 -0
  24. package/dist/cjs/contexts/Schema/Hooks/useSchemaList.js.map +1 -0
  25. package/dist/cjs/contexts/Schema/Hooks/useSchemaStats.d.ts +2 -0
  26. package/dist/cjs/contexts/Schema/Hooks/useSchemaStats.js +26 -0
  27. package/dist/cjs/contexts/Schema/Hooks/useSchemaStats.js.map +1 -0
  28. package/dist/cjs/contexts/Schema/Provider/Memory.d.ts +4 -0
  29. package/dist/cjs/contexts/Schema/Provider/Memory.js +16 -0
  30. package/dist/cjs/contexts/Schema/Provider/Memory.js.map +1 -0
  31. package/dist/cjs/contexts/Schema/Provider/Props.d.ts +4 -0
  32. package/dist/cjs/contexts/Schema/Provider/Props.js +3 -0
  33. package/dist/cjs/contexts/Schema/Provider/Props.js.map +1 -0
  34. package/dist/cjs/contexts/Schema/Provider/Route.d.ts +4 -0
  35. package/dist/cjs/contexts/Schema/Provider/Route.js +51 -0
  36. package/dist/cjs/contexts/Schema/Provider/Route.js.map +1 -0
  37. package/dist/cjs/contexts/Schema/Provider/index.d.ts +3 -0
  38. package/dist/cjs/contexts/Schema/Provider/index.js +7 -0
  39. package/dist/cjs/contexts/Schema/Provider/index.js.map +1 -0
  40. package/dist/cjs/contexts/Schema/State.d.ts +12 -0
  41. package/dist/cjs/contexts/Schema/State.js +3 -0
  42. package/dist/cjs/contexts/Schema/State.js.map +1 -0
  43. package/dist/cjs/contexts/Schema/index.d.ts +5 -0
  44. package/dist/cjs/contexts/Schema/index.js +9 -0
  45. package/dist/cjs/contexts/Schema/index.js.map +1 -0
  46. package/dist/cjs/contexts/Schema/use.d.ts +2 -0
  47. package/dist/cjs/contexts/Schema/use.js +10 -0
  48. package/dist/cjs/contexts/Schema/use.js.map +1 -0
  49. package/dist/cjs/contexts/index.d.ts +1 -0
  50. package/dist/cjs/contexts/index.js +5 -0
  51. package/dist/cjs/contexts/index.js.map +1 -0
  52. package/dist/cjs/index.d.ts +2 -0
  53. package/dist/cjs/index.js +6 -0
  54. package/dist/cjs/index.js.map +1 -0
  55. package/dist/docs.json +695 -0
  56. package/dist/esm/components/SelectEx/SchemaSelectEx.d.ts +4 -0
  57. package/dist/esm/components/SelectEx/SchemaSelectEx.js +18 -0
  58. package/dist/esm/components/SelectEx/SchemaSelectEx.js.map +1 -0
  59. package/dist/esm/components/SelectEx/index.d.ts +1 -0
  60. package/dist/esm/components/SelectEx/index.js +2 -0
  61. package/dist/esm/components/SelectEx/index.js.map +1 -0
  62. package/dist/esm/components/index.d.ts +1 -0
  63. package/dist/esm/components/index.js +2 -0
  64. package/dist/esm/components/index.js.map +1 -0
  65. package/dist/esm/contexts/Schema/Context.d.ts +3 -0
  66. package/dist/esm/contexts/Schema/Context.js +3 -0
  67. package/dist/esm/contexts/Schema/Context.js.map +1 -0
  68. package/dist/esm/contexts/Schema/Hooks/index.d.ts +3 -0
  69. package/dist/esm/contexts/Schema/Hooks/index.js +4 -0
  70. package/dist/esm/contexts/Schema/Hooks/index.js.map +1 -0
  71. package/dist/esm/contexts/Schema/Hooks/useSchemaDefinitions.d.ts +2 -0
  72. package/dist/esm/contexts/Schema/Hooks/useSchemaDefinitions.js +22 -0
  73. package/dist/esm/contexts/Schema/Hooks/useSchemaDefinitions.js.map +1 -0
  74. package/dist/esm/contexts/Schema/Hooks/useSchemaList.d.ts +2 -0
  75. package/dist/esm/contexts/Schema/Hooks/useSchemaList.js +21 -0
  76. package/dist/esm/contexts/Schema/Hooks/useSchemaList.js.map +1 -0
  77. package/dist/esm/contexts/Schema/Hooks/useSchemaStats.d.ts +2 -0
  78. package/dist/esm/contexts/Schema/Hooks/useSchemaStats.js +21 -0
  79. package/dist/esm/contexts/Schema/Hooks/useSchemaStats.js.map +1 -0
  80. package/dist/esm/contexts/Schema/Provider/Memory.d.ts +4 -0
  81. package/dist/esm/contexts/Schema/Provider/Memory.js +10 -0
  82. package/dist/esm/contexts/Schema/Provider/Memory.js.map +1 -0
  83. package/dist/esm/contexts/Schema/Provider/Props.d.ts +4 -0
  84. package/dist/esm/contexts/Schema/Provider/Props.js +2 -0
  85. package/dist/esm/contexts/Schema/Provider/Props.js.map +1 -0
  86. package/dist/esm/contexts/Schema/Provider/Route.d.ts +4 -0
  87. package/dist/esm/contexts/Schema/Provider/Route.js +45 -0
  88. package/dist/esm/contexts/Schema/Provider/Route.js.map +1 -0
  89. package/dist/esm/contexts/Schema/Provider/index.d.ts +3 -0
  90. package/dist/esm/contexts/Schema/Provider/index.js +4 -0
  91. package/dist/esm/contexts/Schema/Provider/index.js.map +1 -0
  92. package/dist/esm/contexts/Schema/State.d.ts +12 -0
  93. package/dist/esm/contexts/Schema/State.js +2 -0
  94. package/dist/esm/contexts/Schema/State.js.map +1 -0
  95. package/dist/esm/contexts/Schema/index.d.ts +5 -0
  96. package/dist/esm/contexts/Schema/index.js +6 -0
  97. package/dist/esm/contexts/Schema/index.js.map +1 -0
  98. package/dist/esm/contexts/Schema/use.d.ts +2 -0
  99. package/dist/esm/contexts/Schema/use.js +6 -0
  100. package/dist/esm/contexts/Schema/use.js.map +1 -0
  101. package/dist/esm/contexts/index.d.ts +1 -0
  102. package/dist/esm/contexts/index.js +2 -0
  103. package/dist/esm/contexts/index.js.map +1 -0
  104. package/dist/esm/index.d.ts +2 -0
  105. package/dist/esm/index.js +3 -0
  106. package/dist/esm/index.js.map +1 -0
  107. package/package.json +138 -0
  108. package/src/components/SelectEx/SchemaSelectEx.tsx +39 -0
  109. package/src/components/SelectEx/index.ts +1 -0
  110. package/src/components/index.ts +1 -0
  111. package/src/contexts/Schema/Context.ts +5 -0
  112. package/src/contexts/Schema/Hooks/index.ts +3 -0
  113. package/src/contexts/Schema/Hooks/useSchemaDefinitions.tsx +28 -0
  114. package/src/contexts/Schema/Hooks/useSchemaList.tsx +25 -0
  115. package/src/contexts/Schema/Hooks/useSchemaStats.tsx +26 -0
  116. package/src/contexts/Schema/Provider/Memory.tsx +13 -0
  117. package/src/contexts/Schema/Provider/Props.tsx +4 -0
  118. package/src/contexts/Schema/Provider/Route.tsx +62 -0
  119. package/src/contexts/Schema/Provider/index.ts +3 -0
  120. package/src/contexts/Schema/State.ts +13 -0
  121. package/src/contexts/Schema/index.ts +5 -0
  122. package/src/contexts/Schema/use.ts +8 -0
  123. package/src/contexts/index.ts +1 -0
  124. package/src/index.ts +2 -0
@@ -0,0 +1,13 @@
1
+ import { WithChildren } from '@xylabs/sdk-react'
2
+ import { useState } from 'react'
3
+
4
+ import { SchemaContext } from '../Context'
5
+ import { useSchemaList } from '../Hooks'
6
+ import { SchemaProviderProps } from './Props'
7
+
8
+ export const SchemaMemoryProvider: React.FC<WithChildren<SchemaProviderProps>> = ({ defaultSchema, knownSchemaList = [], ...props }) => {
9
+ const [schema, setSchema] = useState(defaultSchema)
10
+ const [schemaList, setSchemaList] = useSchemaList(knownSchemaList)
11
+
12
+ return <SchemaContext.Provider value={{ provided: true, schema, schemaList, setSchema, setSchemaList }} {...props} />
13
+ }
@@ -0,0 +1,4 @@
1
+ export interface SchemaProviderProps {
2
+ defaultSchema?: string
3
+ knownSchemaList?: string[]
4
+ }
@@ -0,0 +1,62 @@
1
+ import { WithChildren } from '@xylabs/sdk-react'
2
+ import { useCallback, useEffect } from 'react'
3
+ import { useSearchParams } from 'react-router-dom'
4
+
5
+ import { SchemaContext } from '../Context'
6
+ import { useSchema } from '../use'
7
+ import { SchemaMemoryProvider } from './Memory'
8
+ import { SchemaProviderProps } from './Props'
9
+
10
+ const SchemaRouteProviderInner: React.FC<WithChildren> = ({ children }) => {
11
+ const { schema, setSchema, schemaList } = useSchema()
12
+
13
+ const [params, setParams] = useSearchParams()
14
+
15
+ const routeSchema = params.get('schema')
16
+
17
+ //update the network stored in the route
18
+ const setSchemaParam = useCallback(
19
+ (schema?: string) => {
20
+ if (schema) {
21
+ params.set('schema', schema)
22
+ setParams(params, { replace: true })
23
+ setSchema?.(schema)
24
+ } else {
25
+ params.delete('network')
26
+ }
27
+ },
28
+ [params, setParams, setSchema]
29
+ )
30
+
31
+ //if the network is actively changed, update both memory and route
32
+ const setSchemaLocal = useCallback(
33
+ (schema: string) => {
34
+ setSchemaParam(schema)
35
+ setSchema?.(schema)
36
+ },
37
+ [setSchemaParam, setSchema]
38
+ )
39
+
40
+ //sync memory and route storage of network
41
+ useEffect(() => {
42
+ if (routeSchema !== schema) {
43
+ if (routeSchema === undefined && schema !== undefined) {
44
+ //if the route does not have a network selected, use what is in the memory context
45
+ setSchemaLocal(schema)
46
+ } else if (routeSchema) {
47
+ //if the route has a selection and it is different from memory, update memory
48
+ setSchema?.(routeSchema)
49
+ }
50
+ }
51
+ }, [routeSchema, schema, setSchemaParam, setSchema, setSchemaLocal])
52
+
53
+ return <SchemaContext.Provider value={{ provided: true, schema, schemaList, setSchema: setSchemaLocal }}>{children}</SchemaContext.Provider>
54
+ }
55
+
56
+ export const SchemaRouteProvider: React.FC<WithChildren<SchemaProviderProps>> = ({ knownSchemaList, defaultSchema, ...props }) => {
57
+ return (
58
+ <SchemaMemoryProvider knownSchemaList={knownSchemaList} defaultSchema={defaultSchema}>
59
+ <SchemaRouteProviderInner {...props} />
60
+ </SchemaMemoryProvider>
61
+ )
62
+ }
@@ -0,0 +1,3 @@
1
+ export * from './Memory'
2
+ export * from './Props'
3
+ export * from './Route'
@@ -0,0 +1,13 @@
1
+ import { ContextExState } from '@xyo-network/react-shared'
2
+ import { Dispatch } from 'react'
3
+
4
+ export interface SchemaContextState extends ContextExState {
5
+ /** @field The currently selected XYO Schema */
6
+ schema?: string
7
+ /** @field The list of known available schema */
8
+ schemaList?: string[]
9
+ /** @field Function to set the selected Schema */
10
+ setSchema?: Dispatch<string>
11
+ /** @field Function to set the list of known available schema */
12
+ setSchemaList?: Dispatch<string[]>
13
+ }
@@ -0,0 +1,5 @@
1
+ export * from './Context'
2
+ export * from './Hooks'
3
+ export * from './Provider'
4
+ export * from './State'
5
+ export * from './use'
@@ -0,0 +1,8 @@
1
+ import { useContextEx } from '@xyo-network/react-shared'
2
+
3
+ import { SchemaContext } from './Context'
4
+ import { SchemaContextState } from './State'
5
+
6
+ export const useSchema = (required = false) => {
7
+ return useContextEx<SchemaContextState>(SchemaContext, 'Schema', required)
8
+ }
@@ -0,0 +1 @@
1
+ export * from './Schema'
package/src/index.ts ADDED
@@ -0,0 +1,2 @@
1
+ export * from './components'
2
+ export * from './contexts'