spacefn-docs 0.0.0-stage → 0.11.1

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 (366) hide show
  1. package/LICENSE +200 -0
  2. package/README.md +15 -2
  3. package/assets/reader.css +1131 -0
  4. package/assets/reader.js +324 -0
  5. package/content/1-getting-started.md +107 -0
  6. package/content/2-conventions.md +138 -0
  7. package/content/3-best-practices.md +68 -0
  8. package/content/4-folders/1-app/1-entry.md +48 -0
  9. package/content/4-folders/1-app/2-routes.md +92 -0
  10. package/content/4-folders/1-app/3-db.md +81 -0
  11. package/content/4-folders/1-app/4-queues.md +46 -0
  12. package/content/4-folders/1-app/5-crons.md +30 -0
  13. package/content/4-folders/1-app/6-assets.md +53 -0
  14. package/content/4-folders/1-app/7-durable-objects.md +60 -0
  15. package/content/4-folders/1-app/8-workflows.md +46 -0
  16. package/content/4-folders/1-app/index.md +43 -0
  17. package/content/4-folders/2-modules.md +71 -0
  18. package/content/4-folders/3-lib.md +60 -0
  19. package/content/4-folders/4-public.md +24 -0
  20. package/content/4-folders/5-docs.md +23 -0
  21. package/content/4-folders/6-configs.md +57 -0
  22. package/content/4-folders/7-space.md +34 -0
  23. package/content/4-folders/8-env.md +35 -0
  24. package/content/4-folders/9-package-json.md +37 -0
  25. package/content/4-folders/index.md +50 -0
  26. package/content/5-deployment/1-cloudflare.md +70 -0
  27. package/content/5-deployment/2-bun.md +68 -0
  28. package/content/5-deployment/3-infrastructure.md +67 -0
  29. package/content/5-deployment/4-ci-cd.md +179 -0
  30. package/content/5-deployment/index.md +48 -0
  31. package/content/6-guides/1-entry.md +113 -0
  32. package/content/6-guides/2-routes.md +162 -0
  33. package/content/6-guides/3-pages.md +148 -0
  34. package/content/6-guides/4-frontend.md +232 -0
  35. package/content/6-guides/5-database.md +178 -0
  36. package/content/6-guides/6-services.md +125 -0
  37. package/content/6-guides/7-jobs.md +61 -0
  38. package/content/6-guides/8-auth.md +111 -0
  39. package/content/6-guides/9-testing.md +70 -0
  40. package/content/6-guides/index.md +21 -0
  41. package/content/7-reference/1-config.md +67 -0
  42. package/content/7-reference/2-cli.md +45 -0
  43. package/content/7-reference/3-writing-docs.md +206 -0
  44. package/content/7-reference/index.md +15 -0
  45. package/content/index.md +49 -0
  46. package/content/logo.svg +12 -0
  47. package/dist/index.d.mts +72 -0
  48. package/dist/index.mjs +713 -0
  49. package/examples/README.md +18 -0
  50. package/examples/datastar/.env.example +2 -0
  51. package/examples/datastar/README.md +17 -0
  52. package/examples/datastar/app/assets/main.ts +4 -0
  53. package/examples/datastar/app/assets/site.css +3 -0
  54. package/examples/datastar/app/db/main/config.json +5 -0
  55. package/examples/datastar/app/db/main/migrations/0001_votes.sql +8 -0
  56. package/examples/datastar/app/db/main/queries/add-vote.sql +3 -0
  57. package/examples/datastar/app/db/main/queries/tally.sql +1 -0
  58. package/examples/datastar/app/entry.ts +28 -0
  59. package/examples/datastar/app/routes/_middleware.ts +4 -0
  60. package/examples/datastar/app/routes/health.ts +7 -0
  61. package/examples/datastar/app/routes/index.ts +43 -0
  62. package/examples/datastar/configs/env.ts +6 -0
  63. package/examples/datastar/configs/infra.ts +88 -0
  64. package/examples/datastar/configs/tsconfig.json +15 -0
  65. package/examples/datastar/configs/vite.ts +4 -0
  66. package/examples/datastar/configs/vitest.ts +9 -0
  67. package/examples/datastar/lib/types/rocket.d.ts +30 -0
  68. package/examples/datastar/lib/ui/base.css +17 -0
  69. package/examples/datastar/lib/ui/layout.ts +27 -0
  70. package/examples/datastar/modules/poll/client/poll-meter.ts +39 -0
  71. package/examples/datastar/modules/poll/poll.css +13 -0
  72. package/examples/datastar/modules/poll/poll.test.ts +48 -0
  73. package/examples/datastar/modules/poll/poll.ts +62 -0
  74. package/examples/datastar/modules/poll/views.ts +52 -0
  75. package/examples/datastar/package.json +33 -0
  76. package/examples/datastar/tsconfig.json +4 -0
  77. package/examples/lightningcss/.env.example +1 -0
  78. package/examples/lightningcss/README.md +15 -0
  79. package/examples/lightningcss/app/assets/site.css +3 -0
  80. package/examples/lightningcss/app/entry.ts +28 -0
  81. package/examples/lightningcss/app/routes/_middleware.ts +4 -0
  82. package/examples/lightningcss/app/routes/health.ts +7 -0
  83. package/examples/lightningcss/app/routes/index.ts +12 -0
  84. package/examples/lightningcss/configs/Dockerfile +26 -0
  85. package/examples/lightningcss/configs/Dockerfile.dockerignore +9 -0
  86. package/examples/lightningcss/configs/env.ts +4 -0
  87. package/examples/lightningcss/configs/infra.ts +55 -0
  88. package/examples/lightningcss/configs/tsconfig.json +15 -0
  89. package/examples/lightningcss/configs/vite.ts +19 -0
  90. package/examples/lightningcss/configs/vitest.ts +9 -0
  91. package/examples/lightningcss/lib/ui/layout.ts +17 -0
  92. package/examples/lightningcss/lib/ui/tokens.css +23 -0
  93. package/examples/lightningcss/modules/releases/releases.css +20 -0
  94. package/examples/lightningcss/modules/releases/releases.test.ts +18 -0
  95. package/examples/lightningcss/modules/releases/releases.ts +21 -0
  96. package/examples/lightningcss/modules/releases/views.ts +25 -0
  97. package/examples/lightningcss/package.json +33 -0
  98. package/examples/lightningcss/tsconfig.json +4 -0
  99. package/examples/mini-shopify/.env.example +6 -0
  100. package/examples/mini-shopify/README.md +19 -0
  101. package/examples/mini-shopify/app/assets/site.css +2 -0
  102. package/examples/mini-shopify/app/db/platform/config.json +5 -0
  103. package/examples/mini-shopify/app/db/platform/migrations/0001_shops.sql +10 -0
  104. package/examples/mini-shopify/app/db/platform/queries/add-shop.sql +4 -0
  105. package/examples/mini-shopify/app/db/platform/queries/find-shop.sql +3 -0
  106. package/examples/mini-shopify/app/db/platform/queries/list-shops.sql +1 -0
  107. package/examples/mini-shopify/app/db/shop/config.json +6 -0
  108. package/examples/mini-shopify/app/db/shop/migrations/0001_products.sql +11 -0
  109. package/examples/mini-shopify/app/db/shop/queries/add-product.sql +4 -0
  110. package/examples/mini-shopify/app/db/shop/queries/list-products.sql +1 -0
  111. package/examples/mini-shopify/app/db/shop/queries/sell-product.sql +2 -0
  112. package/examples/mini-shopify/app/entry.ts +25 -0
  113. package/examples/mini-shopify/app/routes/_middleware.ts +4 -0
  114. package/examples/mini-shopify/app/routes/health.ts +7 -0
  115. package/examples/mini-shopify/app/routes/index.ts +26 -0
  116. package/examples/mini-shopify/app/routes/s/[shop]/_middleware.ts +6 -0
  117. package/examples/mini-shopify/app/routes/s/[shop]/index.ts +32 -0
  118. package/examples/mini-shopify/configs/Dockerfile +26 -0
  119. package/examples/mini-shopify/configs/Dockerfile.dockerignore +9 -0
  120. package/examples/mini-shopify/configs/env.ts +14 -0
  121. package/examples/mini-shopify/configs/infra.ts +55 -0
  122. package/examples/mini-shopify/configs/tsconfig.json +15 -0
  123. package/examples/mini-shopify/configs/vite.ts +4 -0
  124. package/examples/mini-shopify/configs/vitest.ts +9 -0
  125. package/examples/mini-shopify/lib/ui/base.css +19 -0
  126. package/examples/mini-shopify/lib/ui/layout.ts +17 -0
  127. package/examples/mini-shopify/modules/catalog/catalog.ts +31 -0
  128. package/examples/mini-shopify/modules/catalog/views.ts +39 -0
  129. package/examples/mini-shopify/modules/shops/host.test.ts +38 -0
  130. package/examples/mini-shopify/modules/shops/host.ts +73 -0
  131. package/examples/mini-shopify/modules/shops/shops.test.ts +63 -0
  132. package/examples/mini-shopify/modules/shops/shops.ts +64 -0
  133. package/examples/mini-shopify/modules/shops/views.ts +28 -0
  134. package/examples/mini-shopify/package.json +35 -0
  135. package/examples/mini-shopify/tsconfig.json +4 -0
  136. package/examples/react/.env.example +2 -0
  137. package/examples/react/README.md +18 -0
  138. package/examples/react/app/assets/site.css +3 -0
  139. package/examples/react/app/entry.ts +28 -0
  140. package/examples/react/app/routes/_middleware.ts +4 -0
  141. package/examples/react/app/routes/about.ts +10 -0
  142. package/examples/react/app/routes/health.ts +7 -0
  143. package/examples/react/app/routes/index.ts +12 -0
  144. package/examples/react/configs/Dockerfile +26 -0
  145. package/examples/react/configs/Dockerfile.dockerignore +9 -0
  146. package/examples/react/configs/env.ts +6 -0
  147. package/examples/react/configs/infra.ts +55 -0
  148. package/examples/react/configs/tsconfig.json +16 -0
  149. package/examples/react/configs/vite.ts +7 -0
  150. package/examples/react/configs/vitest.ts +9 -0
  151. package/examples/react/lib/ui/base.css +12 -0
  152. package/examples/react/lib/ui/layout.ts +18 -0
  153. package/examples/react/modules/about/views.ts +8 -0
  154. package/examples/react/modules/shop/products.ts +18 -0
  155. package/examples/react/modules/shop/shop.css +13 -0
  156. package/examples/react/modules/shop/shop.test.ts +28 -0
  157. package/examples/react/modules/shop/shop.ts +13 -0
  158. package/examples/react/modules/shop/ui/Cart.island.tsx +31 -0
  159. package/examples/react/modules/shop/views.ts +16 -0
  160. package/examples/react/package.json +38 -0
  161. package/examples/react/tsconfig.json +4 -0
  162. package/examples/services-bun/README.md +10 -0
  163. package/examples/services-bun/app/assets/main.ts +4 -0
  164. package/examples/services-bun/app/assets/style.css +1 -0
  165. package/examples/services-bun/app/crons/nightly.ts +5 -0
  166. package/examples/services-bun/app/entry.ts +9 -0
  167. package/examples/services-bun/app/queues/jobs.ts +5 -0
  168. package/examples/services-bun/app/routes/index.ts +10 -0
  169. package/examples/services-bun/app/routes/runtime.ts +5 -0
  170. package/examples/services-bun/app/routes/send.ts +8 -0
  171. package/examples/services-bun/app/routes/version.ts +5 -0
  172. package/examples/services-bun/configs/Dockerfile +10 -0
  173. package/examples/services-bun/configs/Dockerfile.dockerignore +4 -0
  174. package/examples/services-bun/configs/infra.ts +28 -0
  175. package/examples/services-bun/configs/tsconfig.json +15 -0
  176. package/examples/services-bun/configs/vite.ts +4 -0
  177. package/examples/services-bun/lib/ui/base.css +3 -0
  178. package/examples/services-bun/lib/ui/layout.ts +13 -0
  179. package/examples/services-bun/modules/status/client/ready.ts +4 -0
  180. package/examples/services-bun/modules/status/status.ts +20 -0
  181. package/examples/services-bun/modules/status/views.ts +4 -0
  182. package/examples/services-bun/package.json +30 -0
  183. package/examples/services-bun/public/robots.txt +1 -0
  184. package/examples/services-bun/tsconfig.json +4 -0
  185. package/examples/services-cloudflare/README.md +9 -0
  186. package/examples/services-cloudflare/app/assets/main.ts +4 -0
  187. package/examples/services-cloudflare/app/crons/nightly.ts +5 -0
  188. package/examples/services-cloudflare/app/db/main/config.json +4 -0
  189. package/examples/services-cloudflare/app/db/main/migrations/0001_notes.sql +2 -0
  190. package/examples/services-cloudflare/app/db/main/queries/add-note.sql +1 -0
  191. package/examples/services-cloudflare/app/db/main/queries/count-notes.sql +3 -0
  192. package/examples/services-cloudflare/app/entry.ts +10 -0
  193. package/examples/services-cloudflare/app/queues/jobs.ts +5 -0
  194. package/examples/services-cloudflare/app/routes/files.ts +5 -0
  195. package/examples/services-cloudflare/app/routes/index.ts +10 -0
  196. package/examples/services-cloudflare/app/routes/limited.ts +7 -0
  197. package/examples/services-cloudflare/app/routes/send.ts +8 -0
  198. package/examples/services-cloudflare/configs/env.ts +3 -0
  199. package/examples/services-cloudflare/configs/infra.ts +88 -0
  200. package/examples/services-cloudflare/configs/tsconfig.json +15 -0
  201. package/examples/services-cloudflare/configs/vite.ts +4 -0
  202. package/examples/services-cloudflare/lib/ui/layout.ts +12 -0
  203. package/examples/services-cloudflare/modules/files/files.ts +9 -0
  204. package/examples/services-cloudflare/modules/status/client/ready.ts +4 -0
  205. package/examples/services-cloudflare/modules/status/status.ts +27 -0
  206. package/examples/services-cloudflare/modules/status/views.ts +8 -0
  207. package/examples/services-cloudflare/package.json +30 -0
  208. package/examples/services-cloudflare/public/robots.txt +1 -0
  209. package/examples/services-cloudflare/tsconfig.json +4 -0
  210. package/examples/solid/.env.example +2 -0
  211. package/examples/solid/README.md +18 -0
  212. package/examples/solid/app/assets/site.css +3 -0
  213. package/examples/solid/app/entry.ts +28 -0
  214. package/examples/solid/app/routes/_middleware.ts +4 -0
  215. package/examples/solid/app/routes/about.ts +10 -0
  216. package/examples/solid/app/routes/health.ts +7 -0
  217. package/examples/solid/app/routes/index.ts +12 -0
  218. package/examples/solid/configs/Dockerfile +26 -0
  219. package/examples/solid/configs/Dockerfile.dockerignore +9 -0
  220. package/examples/solid/configs/env.ts +6 -0
  221. package/examples/solid/configs/infra.ts +55 -0
  222. package/examples/solid/configs/tsconfig.json +17 -0
  223. package/examples/solid/configs/vite.ts +7 -0
  224. package/examples/solid/configs/vitest.ts +12 -0
  225. package/examples/solid/lib/ui/base.css +12 -0
  226. package/examples/solid/lib/ui/layout.ts +18 -0
  227. package/examples/solid/modules/about/views.ts +8 -0
  228. package/examples/solid/modules/shop/products.ts +18 -0
  229. package/examples/solid/modules/shop/shop.css +13 -0
  230. package/examples/solid/modules/shop/shop.test.ts +28 -0
  231. package/examples/solid/modules/shop/shop.ts +13 -0
  232. package/examples/solid/modules/shop/ui/Cart.island.tsx +31 -0
  233. package/examples/solid/modules/shop/views.ts +16 -0
  234. package/examples/solid/package.json +35 -0
  235. package/examples/solid/tsconfig.json +4 -0
  236. package/examples/starter-bun/.env.example +2 -0
  237. package/examples/starter-bun/AGENTS.md +9 -0
  238. package/examples/starter-bun/README.md +47 -0
  239. package/examples/starter-bun/app/assets/site.css +3 -0
  240. package/examples/starter-bun/app/db/main/config.json +5 -0
  241. package/examples/starter-bun/app/db/main/migrations/0001_todos.sql +9 -0
  242. package/examples/starter-bun/app/db/main/queries/add-todo.sql +2 -0
  243. package/examples/starter-bun/app/db/main/queries/list-todos.sql +2 -0
  244. package/examples/starter-bun/app/db/main/queries/toggle-todo.sql +2 -0
  245. package/examples/starter-bun/app/entry.ts +28 -0
  246. package/examples/starter-bun/app/routes/_middleware.ts +4 -0
  247. package/examples/starter-bun/app/routes/health.ts +7 -0
  248. package/examples/starter-bun/app/routes/index.ts +44 -0
  249. package/examples/starter-bun/configs/Dockerfile +26 -0
  250. package/examples/starter-bun/configs/Dockerfile.dockerignore +9 -0
  251. package/examples/starter-bun/configs/env.ts +6 -0
  252. package/examples/starter-bun/configs/infra.ts +55 -0
  253. package/examples/starter-bun/configs/tsconfig.json +15 -0
  254. package/examples/starter-bun/configs/vite.ts +4 -0
  255. package/examples/starter-bun/configs/vitest.ts +9 -0
  256. package/examples/starter-bun/docs/index.md +5 -0
  257. package/examples/starter-bun/lib/ui/base.css +17 -0
  258. package/examples/starter-bun/lib/ui/layout.ts +22 -0
  259. package/examples/starter-bun/modules/todos/todos.css +16 -0
  260. package/examples/starter-bun/modules/todos/todos.test.ts +33 -0
  261. package/examples/starter-bun/modules/todos/todos.ts +31 -0
  262. package/examples/starter-bun/modules/todos/views.ts +38 -0
  263. package/examples/starter-bun/package.json +32 -0
  264. package/examples/starter-bun/public/favicon.svg +1 -0
  265. package/examples/starter-bun/tsconfig.json +4 -0
  266. package/examples/starter-cloudflare/.env.example +2 -0
  267. package/examples/starter-cloudflare/AGENTS.md +9 -0
  268. package/examples/starter-cloudflare/README.md +47 -0
  269. package/examples/starter-cloudflare/app/assets/site.css +3 -0
  270. package/examples/starter-cloudflare/app/db/main/config.json +5 -0
  271. package/examples/starter-cloudflare/app/db/main/migrations/0001_todos.sql +9 -0
  272. package/examples/starter-cloudflare/app/db/main/queries/add-todo.sql +2 -0
  273. package/examples/starter-cloudflare/app/db/main/queries/list-todos.sql +2 -0
  274. package/examples/starter-cloudflare/app/db/main/queries/toggle-todo.sql +2 -0
  275. package/examples/starter-cloudflare/app/entry.ts +28 -0
  276. package/examples/starter-cloudflare/app/routes/_middleware.ts +4 -0
  277. package/examples/starter-cloudflare/app/routes/health.ts +7 -0
  278. package/examples/starter-cloudflare/app/routes/index.ts +44 -0
  279. package/examples/starter-cloudflare/configs/env.ts +6 -0
  280. package/examples/starter-cloudflare/configs/infra.ts +88 -0
  281. package/examples/starter-cloudflare/configs/tsconfig.json +15 -0
  282. package/examples/starter-cloudflare/configs/vite.ts +4 -0
  283. package/examples/starter-cloudflare/configs/vitest.ts +9 -0
  284. package/examples/starter-cloudflare/docs/index.md +5 -0
  285. package/examples/starter-cloudflare/lib/ui/base.css +17 -0
  286. package/examples/starter-cloudflare/lib/ui/layout.ts +22 -0
  287. package/examples/starter-cloudflare/modules/todos/todos.css +16 -0
  288. package/examples/starter-cloudflare/modules/todos/todos.test.ts +33 -0
  289. package/examples/starter-cloudflare/modules/todos/todos.ts +31 -0
  290. package/examples/starter-cloudflare/modules/todos/views.ts +38 -0
  291. package/examples/starter-cloudflare/package.json +35 -0
  292. package/examples/starter-cloudflare/public/favicon.svg +1 -0
  293. package/examples/starter-cloudflare/tsconfig.json +4 -0
  294. package/examples/svelte/.env.example +2 -0
  295. package/examples/svelte/README.md +18 -0
  296. package/examples/svelte/app/assets/site.css +3 -0
  297. package/examples/svelte/app/entry.ts +28 -0
  298. package/examples/svelte/app/routes/_middleware.ts +4 -0
  299. package/examples/svelte/app/routes/about.ts +10 -0
  300. package/examples/svelte/app/routes/health.ts +7 -0
  301. package/examples/svelte/app/routes/index.ts +12 -0
  302. package/examples/svelte/configs/env.ts +6 -0
  303. package/examples/svelte/configs/infra.ts +88 -0
  304. package/examples/svelte/configs/tsconfig.json +15 -0
  305. package/examples/svelte/configs/vite.ts +9 -0
  306. package/examples/svelte/configs/vitest.ts +9 -0
  307. package/examples/svelte/lib/types/svelte.d.ts +8 -0
  308. package/examples/svelte/lib/ui/base.css +12 -0
  309. package/examples/svelte/lib/ui/layout.ts +18 -0
  310. package/examples/svelte/modules/about/views.ts +8 -0
  311. package/examples/svelte/modules/shop/products.ts +18 -0
  312. package/examples/svelte/modules/shop/shop.css +13 -0
  313. package/examples/svelte/modules/shop/shop.test.ts +28 -0
  314. package/examples/svelte/modules/shop/shop.ts +13 -0
  315. package/examples/svelte/modules/shop/ui/Cart.island.svelte +23 -0
  316. package/examples/svelte/modules/shop/views.ts +16 -0
  317. package/examples/svelte/package.json +35 -0
  318. package/examples/svelte/tsconfig.json +4 -0
  319. package/examples/tailwind/.env.example +2 -0
  320. package/examples/tailwind/README.md +16 -0
  321. package/examples/tailwind/app/assets/site.css +2 -0
  322. package/examples/tailwind/app/entry.ts +28 -0
  323. package/examples/tailwind/app/routes/_middleware.ts +4 -0
  324. package/examples/tailwind/app/routes/health.ts +7 -0
  325. package/examples/tailwind/app/routes/index.ts +30 -0
  326. package/examples/tailwind/configs/Dockerfile +26 -0
  327. package/examples/tailwind/configs/Dockerfile.dockerignore +9 -0
  328. package/examples/tailwind/configs/env.ts +6 -0
  329. package/examples/tailwind/configs/infra.ts +55 -0
  330. package/examples/tailwind/configs/tsconfig.json +15 -0
  331. package/examples/tailwind/configs/vite.ts +7 -0
  332. package/examples/tailwind/configs/vitest.ts +9 -0
  333. package/examples/tailwind/lib/ui/components.ts +21 -0
  334. package/examples/tailwind/lib/ui/layout.ts +21 -0
  335. package/examples/tailwind/lib/ui/theme.css +10 -0
  336. package/examples/tailwind/modules/team/team.test.ts +30 -0
  337. package/examples/tailwind/modules/team/team.ts +34 -0
  338. package/examples/tailwind/modules/team/views.ts +45 -0
  339. package/examples/tailwind/package.json +35 -0
  340. package/examples/tailwind/tsconfig.json +4 -0
  341. package/examples/vue/.env.example +2 -0
  342. package/examples/vue/README.md +18 -0
  343. package/examples/vue/app/assets/site.css +3 -0
  344. package/examples/vue/app/entry.ts +28 -0
  345. package/examples/vue/app/routes/_middleware.ts +4 -0
  346. package/examples/vue/app/routes/about.ts +10 -0
  347. package/examples/vue/app/routes/health.ts +7 -0
  348. package/examples/vue/app/routes/index.ts +12 -0
  349. package/examples/vue/configs/env.ts +6 -0
  350. package/examples/vue/configs/infra.ts +88 -0
  351. package/examples/vue/configs/tsconfig.json +15 -0
  352. package/examples/vue/configs/vite.ts +7 -0
  353. package/examples/vue/configs/vitest.ts +9 -0
  354. package/examples/vue/lib/types/vue.d.ts +8 -0
  355. package/examples/vue/lib/ui/base.css +12 -0
  356. package/examples/vue/lib/ui/layout.ts +18 -0
  357. package/examples/vue/modules/about/views.ts +8 -0
  358. package/examples/vue/modules/shop/products.ts +18 -0
  359. package/examples/vue/modules/shop/shop.css +13 -0
  360. package/examples/vue/modules/shop/shop.test.ts +28 -0
  361. package/examples/vue/modules/shop/shop.ts +13 -0
  362. package/examples/vue/modules/shop/ui/Cart.island.vue +27 -0
  363. package/examples/vue/modules/shop/views.ts +16 -0
  364. package/examples/vue/package.json +35 -0
  365. package/examples/vue/tsconfig.json +4 -0
  366. package/package.json +44 -3
@@ -0,0 +1,45 @@
1
+ ---
2
+ icon: terminal-2
3
+ ---
4
+
5
+ # CLI
6
+
7
+ `space` comes with `spacefn`. Run it with `npx space <command>`, or through the app's scripts (`npm run dev`).
8
+
9
+ | Command | What it does |
10
+ | ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
11
+ | `space dev [--port N]` | Runs the app locally and regenerates `.space/` on every change. Cloudflare: workerd through Alchemy. Bun: Vite inside Bun, with queues and crons in the same process. |
12
+ | `space build` | `vite build` with `configs/vite.ts`, into `dist/` (Bun). Cloudflare builds during `deploy`. |
13
+ | `space deploy [--stage S] [--yes]` | `alchemy deploy configs/infra.ts` for stage `S` (default `prod`). `--yes` skips the approval. |
14
+ | `space destroy [--stage S] [--yes]` | `alchemy destroy configs/infra.ts`: deletes everything stage `S` deployed, its data included. |
15
+ | `space gen [--watch] [--prod]` | Writes `.space/` from `app/` and `configs/`. `--prod` takes `.prod.ts` files instead of `.dev.ts`. |
16
+ | `space db status\|migrate\|rollback [--db name] [--steps N]` | Migrations of libSQL databases. See [Database](../6-guides/5-database.md). |
17
+ | `space doctor` | Checks Node, the config, `.space/`, the target's tools, the bindings in `configs/infra.ts` and `configs/env.ts`, and says what to fix. |
18
+ | `space upgrade` | Updates spacefn and what moves with it, then regenerates. See [Upgrading](#upgrading). |
19
+ | `space docs [--port N]` | Serves your `docs/` and spacefn's docs at `http://localhost:4321/`. `space dev` serves them too, at `/__space/docs/`. See [Writing docs](3-writing-docs.md). |
20
+ | `space clean` | Deletes generated files and builds. Keeps local data. |
21
+
22
+ ## Upgrading
23
+
24
+ `space upgrade` reads the latest release from the registry, prints each change as `old → new`, and installs them at once with the app's package manager:
25
+
26
+ | Package | Moves to |
27
+ | --------------------------- | ---------------------------------------------- |
28
+ | `spacefn`, `spacefn-docs` | the latest release |
29
+ | `alchemy` and its providers | the exact version that release is built on |
30
+ | `effect`, `vite` | what that release needs, if the app's is older |
31
+ | everything else | stays: the app's choice |
32
+
33
+ An exact version stays exact. If the install fails or you stop it, `package.json` and the lockfile are put back and installed again. A version it can't edit, such as `catalog:` or `workspace:`, stops it before anything changes. It needs `npm` to read the registry, whichever package manager the app uses.
34
+
35
+ > [!IMPORTANT]
36
+ > In spacefn 0.11.0, `space upgrade` updates only spacefn. From that version, upgrade with the latest one's instead: `npx spacefn@latest upgrade`.
37
+
38
+ ## Errors
39
+
40
+ Every command prints errors with a code, the file and a hint, for example:
41
+
42
+ ```txt
43
+ [CRON_SCHEDULE_LITERAL] app/crons/nightly.ts: The schedule must be a string literal
44
+ hint: Write it in the file: export default cron("0 3 * * *", job). The infra reads it without running the file.
45
+ ```
@@ -0,0 +1,206 @@
1
+ ---
2
+ description: Markdown, HTML, code groups, callouts and diagrams in the docs reader
3
+ icon: pencil
4
+ ---
5
+
6
+ # Writing docs
7
+
8
+ `space docs` shows your app's `docs/` folder next to spacefn's docs, and `space dev` serves the same reader at `/__space/docs/`. Pages are Markdown files; edit one and the open page reloads.
9
+
10
+ ## Pages and the sidebar
11
+
12
+ Every `.md` file in `docs/` is a page, and every folder is a group in the sidebar. A folder's `index.md` (or `README.md`) is its first page and names the group. Groups collapse: the one with the open page starts open, and the reader remembers the ones you open or close.
13
+
14
+ Number files and folders to put them in reading order. The number orders the sidebar and is left out everywhere else: `2-runbooks/1-deploys.md` is "Deploys" in "Runbooks", at `/runbooks/deploys.md`.
15
+
16
+ ```txt
17
+ docs/
18
+ ├── index.md the home page
19
+ ├── 1-architecture.md /architecture.md
20
+ └── 2-runbooks/
21
+ ├── index.md "Runbooks", the group's title
22
+ ├── 1-deploys.md /runbooks/deploys.md
23
+ └── 2-incidents.md /runbooks/incidents.md
24
+ ```
25
+
26
+ Without numbers, pages are in name order. Frontmatter `order` overrides the number, and `title` the first `# heading`:
27
+
28
+ ```md [docs/1-architecture.md]
29
+ ---
30
+ title: How it fits together
31
+ order: 2
32
+ description: One line, shown on the folder's cards
33
+ icon: building-bridge
34
+ ---
35
+
36
+ # Architecture
37
+ ```
38
+
39
+ `icon` puts a [Tabler icon](https://tabler.io/icons) before the page in the sidebar: its name as on the site, such as `rocket`, or `heart-filled` for the filled one. A folder's `index.md` gives the folder its icon. A page without `icon` has none. The icons load from a CDN, like Mermaid, so they're missing offline.
40
+
41
+ Link between pages by their file names, as you would on GitHub: `[deploys](2-runbooks/1-deploys.md)`. The reader sends such a link to the page's URL. Put images next to the pages and link them the same way. Don't give two files in a folder the same name apart from the number, such as `deploys.md` and `1-deploys.md`: only the one without a number is reachable.
42
+
43
+ ## Code
44
+
45
+ Fenced code is highlighted by [Shiki](https://shiki.style). Name the file in brackets after the language, and list lines to highlight in braces:
46
+
47
+ ````md
48
+ ```ts [app/routes/health.ts] {3}
49
+ import { Effect } from "effect";
50
+
51
+ export const GET = () => Effect.succeed(Response.json({ ok: true }));
52
+ ```
53
+ ````
54
+
55
+ ```ts [app/routes/health.ts] {3}
56
+ import { Effect } from "effect";
57
+
58
+ export const GET = () => Effect.succeed(Response.json({ ok: true }));
59
+ ```
60
+
61
+ Comments mark lines too, and the comment is left out of the page: `// [!code ++]` and `// [!code --]` for a diff, `// [!code highlight]`, `// [!code focus]`, and `// [!code error]` or `// [!code warning]`.
62
+
63
+ ```ts
64
+ const limit = 10; // [!code --]
65
+ const limit = 50; // [!code ++]
66
+ const page = yield * Pages.list({ limit }); // [!code focus]
67
+ ```
68
+
69
+ ### Code groups
70
+
71
+ Wrap blocks in `<code-group>` to show them as tabs. Each tab is named by the block's `[title]`. Choosing a tab chooses it in every group on the page that has one with that name, and the reader remembers it:
72
+
73
+ ````md
74
+ <code-group>
75
+
76
+ ```sh [npm]
77
+ npm create spacefn@latest my-app
78
+ ```
79
+
80
+ ```sh [pnpm]
81
+ pnpm create spacefn my-app
82
+ ```
83
+
84
+ </code-group>
85
+ ````
86
+
87
+ <code-group>
88
+
89
+ ```sh [npm]
90
+ npm create spacefn@latest my-app
91
+ ```
92
+
93
+ ```sh [pnpm]
94
+ pnpm create spacefn my-app
95
+ ```
96
+
97
+ ```sh [bun]
98
+ bun create spacefn my-app
99
+ ```
100
+
101
+ </code-group>
102
+
103
+ Leave a blank line after `<code-group>` and before `</code-group>`, so the blocks inside are read as Markdown.
104
+
105
+ ## Callouts
106
+
107
+ GitHub's alerts become callouts. Text after the kind names it:
108
+
109
+ ```md
110
+ > [!TIP] Run it in CI
111
+ > `space db status` exits non-zero when a migration is pending.
112
+ ```
113
+
114
+ > [!NOTE]
115
+ > Notes add something worth knowing.
116
+
117
+ > [!TIP] Run it in CI
118
+ > `space db status` exits non-zero when a migration is pending.
119
+
120
+ > [!IMPORTANT]
121
+ > Important is what readers must not miss.
122
+
123
+ > [!WARNING]
124
+ > Warnings are about something that can go wrong.
125
+
126
+ > [!CAUTION]
127
+ > Caution is about something that can't be undone.
128
+
129
+ ## Diagrams
130
+
131
+ A `mermaid` block draws a [Mermaid](https://mermaid.js.org) diagram, in the page's light or dark theme and the code font. The browser loads Mermaid when a page has one; offline, the diagram's source shows instead.
132
+
133
+ ````md
134
+ ```mermaid
135
+ sequenceDiagram
136
+ Browser->>Worker: POST /todos
137
+ Worker->>D1: insert
138
+ Worker-->>Browser: 303 to /todos
139
+ ```
140
+ ````
141
+
142
+ ```mermaid
143
+ sequenceDiagram
144
+ Browser->>Worker: POST /todos
145
+ Worker->>D1: insert
146
+ Worker-->>Browser: 303 to /todos
147
+ ```
148
+
149
+ ## HTML
150
+
151
+ HTML in a page is kept as written, so a page can have anything Markdown lacks. Markdown inside an HTML block works when a blank line follows the opening tag:
152
+
153
+ ```html
154
+ <details>
155
+ <summary>What's in .space/?</summary>
156
+
157
+ Generated code: the route table, typed queries, and the Worker or server entry.
158
+ </details>
159
+ ```
160
+
161
+ <details>
162
+ <summary>What's in .space/?</summary>
163
+
164
+ Generated code: the route table, typed queries, and the Worker or server entry.
165
+
166
+ </details>
167
+
168
+ A few classes are styled for you:
169
+
170
+ | Markup | Shows |
171
+ | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
172
+ | `<span class="badge tip">new</span>` | A badge: <span class="badge">note</span> <span class="badge tip">tip</span> <span class="badge warning">warning</span> <span class="badge caution">caution</span> |
173
+ | `<div class="callout tip">` | A callout, like `> [!TIP]`, for content an alert can't hold |
174
+ | `<div class="steps">` around `###` headings | Numbered steps |
175
+ | `<div class="cards">` around a list of links | A grid of cards |
176
+ | `<kbd>⌘</kbd> <kbd>K</kbd>` | Keys: <kbd>⌘</kbd> <kbd>K</kbd> |
177
+
178
+ <div class="steps">
179
+
180
+ ### Write the migration
181
+
182
+ Add `app/db/main/migrations/0002_add_done.sql`.
183
+
184
+ ### Write the query
185
+
186
+ Add `app/db/main/queries/todos/mark-done.sql`; `space gen` types it.
187
+
188
+ ### Call it
189
+
190
+ `yield* MainDb.todos.markDone({ id })` in a route or a page action.
191
+
192
+ </div>
193
+
194
+ <div class="cards">
195
+
196
+ - [Database](../6-guides/5-database.md)<br>Migrations and typed queries
197
+ - [Pages](../6-guides/3-pages.md)<br>Server-rendered pages and forms
198
+ - [Testing](../6-guides/9-testing.md)<br>Pages, routes and queries in memory
199
+
200
+ </div>
201
+
202
+ A page can also have a `<style>` or a `<script>` of its own, for a small live example.
203
+
204
+ ## Searching
205
+
206
+ <kbd>⌘</kbd> <kbd>K</kbd> or <kbd>/</kbd> searches both doc sets: page titles, headings, and the text under each heading.
@@ -0,0 +1,15 @@
1
+ ---
2
+ icon: books
3
+ ---
4
+
5
+ # Reference
6
+
7
+ The settings, commands and file formats, to look up.
8
+
9
+ | Page | What it covers |
10
+ | --------------------------------- | --------------------------------------------------------------------- |
11
+ | [Configuration](1-config.md) | `configs/vite.ts`, `configs/env.ts`, `.env` files, `configs/infra.ts` |
12
+ | [CLI](2-cli.md) | Every `space` command, and its errors |
13
+ | [Writing docs](3-writing-docs.md) | Your app's own `docs/`, in the same reader |
14
+
15
+ For what each folder of an app holds, see [Folders](../4-folders/index.md).
@@ -0,0 +1,49 @@
1
+ ---
2
+ icon: home
3
+ ---
4
+
5
+ # Introduction
6
+
7
+ spacefn builds full-stack TypeScript apps from folders of convention files, on [Effect](https://effect.website). The same app runs on **Cloudflare Workers** or on **Bun** (in Docker). You write routes, pages, SQL and jobs; spacefn generates the wiring into `.space/`, and the `space` CLI runs, builds and deploys it.
8
+
9
+ Start with [Getting started](1-getting-started.md) and [Conventions](2-conventions.md), then read what you need. [Best practices](3-best-practices.md) says how to keep an app easy to change as it grows.
10
+
11
+ **Folders.** A page for each folder and file of an app, to browse like a map: [`app/`](4-folders/1-app/index.md) and its [`entry.ts`](4-folders/1-app/1-entry.md), [`routes/`](4-folders/1-app/2-routes.md), [`db/`](4-folders/1-app/3-db.md), [`queues/`](4-folders/1-app/4-queues.md), [`crons/`](4-folders/1-app/5-crons.md), [`assets/`](4-folders/1-app/6-assets.md), [`durable-objects/`](4-folders/1-app/7-durable-objects.md) and [`workflows/`](4-folders/1-app/8-workflows.md); then [`modules/`](4-folders/2-modules.md), [`lib/`](4-folders/3-lib.md), [`public/`](4-folders/4-public.md), [`docs/`](4-folders/5-docs.md), [`configs/`](4-folders/6-configs.md), [`.space/`](4-folders/7-space.md), [`.env`](4-folders/8-env.md) and [`package.json`](4-folders/9-package-json.md). [See them all](4-folders/index.md).
12
+
13
+ **Deployment**
14
+
15
+ | Page | What it covers |
16
+ | -------------------------------------------------- | -------------------------------------------------------------------------- |
17
+ | [Deployment](5-deployment/index.md) | `space deploy`, stages, telemetry |
18
+ | [Cloudflare](5-deployment/1-cloudflare.md) | What a deploy creates, domains, local dev |
19
+ | [Bun](5-deployment/2-bun.md) | The processes, the image, servers, more than one machine |
20
+ | [Infrastructure](5-deployment/3-infrastructure.md) | `configs/infra.ts`, `#space/infra.ts`, `variables`, state |
21
+ | [CI/CD](5-deployment/4-ci-cd.md) | Cloudflare tokens and dashboard, GitHub Actions, GitLab CI, preview stages |
22
+
23
+ **Guides**
24
+
25
+ | Page | What it covers |
26
+ | --------------------------------------------- | --------------------------------------------------------------------- |
27
+ | [The entry](6-guides/1-entry.md) | `app/entry.ts`: services, middleware, extra routes, `onError` |
28
+ | [Routes and middleware](6-guides/2-routes.md) | HTTP endpoints, reading input, errors, middleware, CSRF |
29
+ | [Pages](6-guides/3-pages.md) | Server-rendered pages, form actions, live updates with Datastar |
30
+ | [Frontend](6-guides/4-frontend.md) | Asset entries, `public/`, CSS, framework islands, Datastar components |
31
+ | [Database](6-guides/5-database.md) | Migrations, typed SQL queries, drivers, a database per tenant |
32
+ | [Services](6-guides/6-services.md) | Kv, Blob, Queue, Bus and RateLimiter, and what backs them per target |
33
+ | [Queues and crons](6-guides/7-jobs.md) | Background jobs and scheduled jobs |
34
+ | [Auth](6-guides/8-auth.md) | Passwords, sessions, rate limiting, TOTP, signed tokens, OAuth |
35
+ | [Testing](6-guides/9-testing.md) | Testing modules, pages and routes in memory |
36
+
37
+ **Reference**
38
+
39
+ | Page | What it covers |
40
+ | --------------------------------------------- | --------------------------------------------------------------------- |
41
+ | [Configuration](7-reference/1-config.md) | `configs/vite.ts`, `configs/env.ts`, `.env` files, `configs/infra.ts` |
42
+ | [CLI](7-reference/2-cli.md) | Every `space` command |
43
+ | [Writing docs](7-reference/3-writing-docs.md) | Your app's own `docs/`, in the same reader |
44
+
45
+ **Examples.** Every convention here is shown in full by an app in the repo's `examples/`, tested and shipped with these docs in `node_modules/spacefn-docs/examples/`: the starters, Datastar with Rocket, Tailwind, Lightning CSS, React, Vue, Solid and Svelte islands, and a database per shop.
46
+
47
+ You need to know a little Effect: handlers are `Effect`s, and you get a service with `yield*` inside `Effect.gen`. Effect's own docs cover the rest.
48
+
49
+ The VS Code extension (`wai-lin.vscode-spacefn`) checks SQL against your migrations, in query files and in `` sql`...` `` templates, validates Datastar attributes in `` html`...` ``, and checks and completes the CSS in their `<style>` tags.
@@ -0,0 +1,12 @@
1
+ <?xml version="1.0" encoding="UTF-8" standalone="no"?>
2
+ <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
3
+ <svg width="100%" height="100%" viewBox="0 0 595 353" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;">
4
+ <g transform="matrix(1,0,0,1,-32.119507,-90.998334)">
5
+ <g transform="matrix(1,-0,-0,1,32.119507,90.998334)">
6
+ <use xlink:href="#_Image1" x="0" y="0" width="595px" height="353px"/>
7
+ </g>
8
+ </g>
9
+ <defs>
10
+ <image id="_Image1" width="595px" height="353px" xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlMAAAFhCAYAAABUGy/TAAAACXBIWXMAAA7EAAAOxAGVKw4bAAAgAElEQVR4nOzdd5xcZdXA8V8SIKETOooUQaQ4DJERXnqTqiAicJe77OzQi1SlqCCiKAjSi3SYnWUueaQ36YiA1CvhOiBFepUuvSQk7x/PbNiE7O7cNufOzPl+PpGQzH3OkWR3zjzlPKNQeDVvFLAZsBWwETAH8NGgH88DdwJ3ujn3dZkslVJKqXRV7fvhqsA2wKbA14FFgNHY98LngHsB051znxVKM3NGSScgzat53wbOxhZRjZgE/Aa43s2501JLTCmllGqias37HnAKsE6DjzwInABc2d3h74cdXUx5Ne9nwHHYmaiw/g7s7ubcp5PNSimllGqeas0bA5wIHBRxiDuBA7tz7r8SS6rFdGQxVV/W+y3w65hDvQps7ObcJ+NnpZRSSjVXteaNBSrAjjGHmgocCpzSibNUo6UTaLZ6IXUC8QspgK8Bd3o1b9EExlJKKaWa7WTiF1Jg64mTgHOrNW/2BMZrKR1VTHk1bzRwBnBIgsMuDvwxwfGUUkqp1FVr3pbAvgkPuwdwY7XmzZnwuJnWMct8nl0TPhfYLaUQ33Vz7qSUxlZKKaUSU7WTC08Cy6cU4jKgqzvnTk1p/EzpiJkpr+bNBvSRXiEFsGuKYyullFJJ2oT0CimAHYDfpzh+prR9MVVf2qsC3SmH2qk++6WUUkplXTMmAH5ZrXmlJsQR1/bFFHAEyWyuG8lCwLebEEcppZSKa40mxflz1fZzbGttXUx5NW8LbAuEZvluE2MppZRSoVVr3lzAsk0KNydwSbuf8GvbYsqrecsCHs3dZK/FlFJKqaxbmua+NxaAo5oYr+naspjyat444HJgfJNDazGllFIq6z4ViPmras1bSyBuU7RlMQWciUxh85FATKWUUiqMDwRijgb6qzVvHoHYqWu7YsqrebuTbguE4fhCcZVSSqlGvQ98IRB3OexFym2nrYopz954fZZgCg8JxlZKKaVG1J1zP0fuw//u1Zq3jVDs1LRNMeXVvIWx+6TmEEphKvCgUGyllFIqjL8Jxr6gWvMWE4yfuLYopurNMj1gKcE0rnFz7huC8ZVSSqlGSRZTiwAXVmte21xp1xbFFHAgsKlwDqcLx1dKKaUadQfwgmD8HwB7CsZPVMsXU17NWx74g3Aa/wL+LpyDUkop1ZDunDsF+c3gJ1dr3grCOSSipYup+r17FwDjhFP5nZtzpwnnoJRSSoVxIfA/wfhzYdsltHx39JYupoC9gA2Ec7jCzblXCOeglFJKhdKdcz8E/iScxhrYO3RbWssWU17NWxo4QTiNd4H9hHNQSimlovoTMEk4hyOrNW9N4RxiacliyrMnAM4DpDupHujm3P8K56CUUkpF0p1zJwMlYLJgGmOwp/ukWhvF1pLFFPYPfjPhHP4KXCKcg1JKKRVLd879F3CMcBqrAD8XziGyliumvJr3NeRPIHwA7K2bzpVSSrWJPyJ/i8dR1Zq3nHAOkbRUMVVf3jsHmF84lUPcnPuScA5KKaVUIurLfTsDHwumMQ44uxWbebZUMQV0AVsL53AHcL5wDkoppVSiunPuU8DBwmlsCuwknENoLVNMeTVvUeAM4TTeBHp0eU8ppVSbOh+4TjiHU6o1b0HhHEJpmWIKW0gtJBh/GrCzm3NfFcxBKaWUSk23nSzYHZC8a3ZR7B6ultESxZRX8zYBdhRO4zg3594inINSSimVqu6c+wawq3Aae1Rr3rrCOTQs88WUV/NmA04VTuNu4DfCOSillFJN0Z1zbwDOFk7j3FbpPZX5Ygo73fgdwfhvA65rL4VUSimlOsUhwJOC8Veu55B5mT5+6NW8BYD/AAsLprGVm3NvFIyvlFJKiajWvAJwHzCbUAqfArnunPu0UPyGZH1m6tfIFlInaCGllFKqU3XnXB/ZbS4t0Xsqs8WUV/NWAA4QTOF+4EjB+EoppVQWHA/8QzD+9wFXMP6IMltMASciN604GdjNtR1hlVJKqY7VnXO/AHqwV6lJyXTvqUwWU17N2xTZTufHuzn334LxlVJKqczozrnPAfsLprAIdutPJmVuDbLeCuER7A3SEp4GVnVz7idC8ZXqSOWgMgoYA4wF5hj0z8E/nx376fgd4N1Svvi5TLZKdZ76vqW/ANsLpTAZWDmLm9GzWEztC5wlmMKmbs69TTC+Um2jHFRGA4sBSwHfqP9z8M+XBObiy4Ip7Pekj7CF1TvAu4N+PvjXXgIeBV4u5Yt6FZRSMVRr3kJADVhCKIUrunOuVDE3pEwVU17NG49thSB1bcwlbs7tEYqtVMsqB5WFgdWBArAiMxZLswumNtj7wL+xhdVjg/75Xy2ylGpcteZ1A5cIprBud86V3BD/FVkrpk4BDhIK/w6wkmvb6CulhlAOKuP5snAa+LG0aFLxvIMtqgYKrEeBh0r54seiWSmVUfXlvn8Aawml8ACwVv0ewUzITDHl1bxvY7+JSZ3g283NuRcJxVYqk8pBZQywJrA2XxZOy4km1RyfYa+Rurn+41GdvVLqS/Vmng8JptDVnXONYPwZZKmYug74oVD4u4AN3QxVuUpJKQeVRYHNga3q/xwvm1EmvAbcgi2sbi3li28J56OUuGrNuwjYRSj888CK3Tn3M6H4M8hEMeXVvLWAe4XCTwbybs59XCi+UqLqm8QL2OJpq/rPM/G9IaOmAQ/z5azVfaV8UXvSqY5TrXmLY/c5zyOUwiHdOfckodgzyMQ3TK/m3QxsJhT+FDfn/kwotlIiykFlHuxM8FbAFtgeLiqaD4HbsRtyr9V2DaqTVGveYdgO6RL+ByzfnXPfFoo/nXgx5dW8dYB7hMK/Cyzv5tx3hOIr1TT1GagNgRLwE2xLApWst4AKcGEpX9TGv6rtVWveWOzhDam9lKd151ypg2vTZaGYug3YRCj8z9yce4pQbKWaohxUvgX0Yq+DWEo4nU5yL3ABcFkpX/xQOhml0lKtedsA1wiFn4Jt5PkfofiA3Mk5ALyatx5yhdSzwJ+FYiuVqnJQWQDYEVtErS2cTqdau/7jtHJQmYgtrB7SU4GqDV0H3ApsKhB7NuA45LqyA8IzU17NuwPYSCj8Dm7OvVwotlKpKAeVtbD3Z/0YGCecjvqqGraouqSUL+r2AtU2qjVvFSDAXgklQbSRp1gx5dW8DYA7hcLfB6yjrRBUO6jvhdoaOBRYRzgd1ZjPgCuBP5XyxUnSySiVhGrNOx25y5DvB9aWauQ5WiJo3W8FY/9cCynV6spBZVw5qOyBvSLlarSQaiVjgZ2Ah8tB5YpyUPmOdEJKJeBo7I0CEv4Pua4AMjNTXs3bCLhDIjZwnZtztxGKrVRs5aCyILAP9hPgYsLpqGRMAyYCR5fyxaekk1EqqmrN2xc4Syj8P4D1JGanmr4B3bN3+kjOSv1eMLZSkZWDypLYpbzdgLmF01HJGoWdqXLKQaUC/K6ULz4nnFNLmjhp4jjsqdU5sfsGX+ya0PWabFYd5Tzshz2J2dZ1sO1f/tbswE2fmfJq3vexu/4l3OrmXLFpQKWiqJ/M+yVwALqpvFNMAS4Cfl/KF1+STibrJk6aOBZ7cvVH2ENNc870kgC7FH5i14QubVORsmrN2xjbyFbCnd05t+kH25paTNVnpe5B7qj2Bm7OvUsotlKhlIPKOOCnwBHo/Xid6nPgXOC4Ur6osyuzMHHSxB8ApwLLN/DyF4C9uyZ03ZRuVqpa867EniqWsF53zm1qM/BmF1ObYe+yknC3m3PXF4qtVMPqp/Nc7JL00sLpqGz4BLsP5YRSvvimdDJZMXHSxCOItnXjmK4JXUeFfcj4Zjlsb8QxwPuDfnww079/5hScjj7kVK15eeARofC3dOfczZsZsGnFVH1W6l7sjnsJm7s59xah2Eo1pBxUNgVOAFaTzkVl0kfAH4ATO/1y5YmTJv4WCF0QDXJE14SuYxt5ofFNAXtN0EoNjj0Fe6rtQeBu4C7gn07B6ag/s2rNuwF7/6eENbtz7oPNCtbMYmpzQGpq9SFgTW2HoLKqfuXLmQge7VUtJQB2K+WL/5RORMLESROT2nu7T9eErnOGe4Hxzc7A+cTfr/gxthfSXfUfDzgF5+OYY2Zateatiy0mJVzfnXO3blawZhZTtwMbNyveTH7k5txrhWIrNaRyUJkdOAT4Dbb3kFKN+gI4GdtOoa3flAebOGniPNjeat9IYLiPgBW6JnS9OqvfNL75P2yT5zR8AvQBpzgFp23bYVRr3t3AukLhv9udc5vSFLcpTTu9mrcqcoXUv4DrhWIrNaRyUFkD8IFj0UJKhTcG2yojKAeVDWVTaaoiyRRSYFuMHDfM7x+YUJxZmRPYG3jC+OYa45sVU4wlabj/vmk7slmBmtUBPc2/kCM51s25UwXjKzWDclCZpxxUTsVO+a8qnY9qecsDfysHlXPLQWV+6WTSNHHSxFHAfgkPW5w4aeJQexS/lXCsWRkFbAMExje/Mr6ZvQkxm+lG7LK0hO2qNa8p/a5SL6a8mrco0J12nCE8BehlxiozykFlK+Ax7AcM0YvGVdvZE/h3Oai08w0P36DxTeBh/HCIX38yhVhDmQN7uOB+45vFmxg3VfVu5H8UTOGIZgRpxszU3sgtYRzr5twvhGIrNV05qMxXDir9wA3Y7sxKpeFrwDXloGLKQaUdrxpaJqVxh2ryODGleMP5LnCP8c2yArHTcjnwjFBsp1rzUl9CTbWY8mreWGDfNGMM43nAE4qt1HTloLI68DCws3QuqmPsCDxeDirFclBppxnQtAqMtetd1GfgFJzrgMtSijmc5bAF1dcFYieuO+dOwbZ8kTAK+FnaQdKemXKQu4j1j27O7aieHipbykFlVDmoHIQ9DbScdD6q44zHnha7qRxUlhHOJSnLpDTuOIZ+PywC38N+GNoLO0FwAPYN+ijsicqLgauAO4GXE8rpa8AlxjdjEhpPWh8g1cV/52rNWzDNAKlddFxv0nlwWuOP4FWgLBRbKcpBZSHs3WrtvH9FtYbNgEnloLJTKV9s9WtUlklp3He7JnR9MqvfcArOp9hTt36jgxnfLIEtwL4HrIFtVj1fhLw2BH6B3UvV0rpz7mfVmncy8CeB8HMCuwInphUgtelfr+ZtgK3SJRzk5tzThGKrDlcOKusClwJLSuei1CDTsBdmn1DKF1uygfHESRPPIp2tI491TehK7dSX8c1cwE7Yk4hhbzf4BFjKKThvJZ5Yk1Vr3rzAi8ACAuGfA77VndI+6jSX+Q5KcezhvIntVqtUU9WX9Q7FfojQQkplzSjsqaqJ5aAyt3QyET2e0riPpTQuAE7B+dgpOBdiN5fvg20W2qg5sReet7zunPsB9qYHCcuS4tU2qRRTXs1bDvhRGmM34Fw353ZMN2CVDfVO5udjN1m2yx4H1Z52BO4tB5VWPC32QApjTiPaZcmhOQVnmlNwzsH2l3s+xKP7G9/MkU5WTXc6drZNwv5pDZzWzNT+yPTQmQqcJxBXdbByUFkA25huN+lclGrQqoBfDiqbSCcSko+9SiZJl3RN6KolPOawnILzLLAl8G6DjywEFNLLqHm6c67k6tGmabVJSLyY8mrefNiNXhKud3PuS0KxVQeqf7q/F2i1NyWlFgRuLgeVg1qlfULXhK5pJLtM9Dn2RF7TOQXnCezpwEatn1YuAk4CpgjFTmXJNI2ZqV2BeVMYtxFnC8VVHagcVNbEXgmTRkdmpZphDHAKcE45qDTrerG4ziWZw00fAVt3Teh6PoGxorqSxptZSl0WnLjunPsicIlQ+FLVTvokKtEvHq/mjcH235DwLHCLUGzVYcpBZVvsN/RFhVNRKgl7AheWg0rm9/t1Teiaiu39FKej9hvABl0TukTfM5yC8wVwVoMvb4sGnoP8WSjuPEBv0oMm/Unkh6TXoXYk5+qFxqoZ6nefXYZt9KdUuygBlXJQSa3/YFK6JnS9BKwJ/D3C408Da3dN6PpnsllF9nCDrxufahbN55PyKcph7FeteYnWP0kXU6WEx2vU59gOtEqlqhxUtsAWUpl/w1EqAhfw6qdTM61rQtfb2L2K2wJ3j/Dy17HXi+0KrNk1oUvqnrhZea7B16XawbvZ6hcgl4XCrwB8P8kBE3tD8GrewsAPkhovpMtce0JAqdTUTz5djb3dXal2tQMwezmoOKV88XPpZIbTNaHrC+Aa4JqJkyYugt2/uBL2a/Qd4G1sk8jH65vXs+jVBl+XSrNJYZdge59JLC/vT4JbgxI7weHVvP2AM5IaL6R13Zz7D6HYqgOUg8r6wE3YBnpKdYIbgO1L+eKn0om0M+ObhbHNpkfyH6fgrJB2Ps1WrXnXAlsLhJ4GLFPfDB9bkst8xQTHCqOGPZquVCrKQWUt7BuLFlKqk/wAuLocVPTvfbqWbvB1b6SahRypLTqjgO6kBkukmPJq3krYCx0lnO3atVelElcOKgXsjNQ80rkoJWBz4IpW2EPVwhotpv6bahZybgCk7h3sqda8RFbokpqZ6klonLA+Rq5XhWpz5aCyGnZNPfGeJEq1kC2Bs1ulsWcLWqXB1420yb4ldefcz4GqUPiVgNWTGCh2MeXZ44VSxdRVrr04UalElYPKd4Bbab/jyEpFsRtwpHQSbarRe2zbuY+i5Gn8ROqXJGamNgSWTGCcKDyhuKqNlYPKt4HbgIWlc1EqQ35XDiol6STaifHNUjQ2M/Iy8ETK6YjpzrkBMEko/E7Vmhd7GTuJYirxTqINegs7c6BUYspBZTngDmAx6VyUyqDzy0FlM+kk2siPG3zdrU7Bafe9wVKzU4sAsf9OxyqmvJo3D/CTuElE9Bc3504Wiq3aUDmoLI0tpL4mnYtSGTUbcHl9P6GKr9H3z3Ze4hvgAVLv6bGX+uLOTP0YmDtuEhHpEp9KTDmoLIEtpJaSzkWpjJsX+Gs5qOjXSgzGN6sD6zX48tvTzCULunPu28C1QuG3rda8+eMMELeYkuot9QJwn1Bs1WbKQWUO4HLgm9K5KNUilgBuKAcVbRkS3S8bfN3DTsHplBs+pJb6xgLbxxkgcjHl1bwlsfciSfD0UmOVoJOAtaWTUKrFfAe7h0pbJoRkfLMSsF2DL785zVwy5mbgNaHYsZb64sxM7UyC19GEpEt8KhHloLIzsJ90Hkq1qC7sHWcqnMNp7P1zCnB2yrlkRnfOnQL0C4XfoFrzGm2g+hWRiinPdgwVuz7GzbmPCsVWbaQcVPLAedJ5KNXiTioHlXWkk2gVxjdL0/g1JhWn4LyUZj4ZJNlzKvL1MlFnpnLYzqESdFZKxVYOKuOBK9H79pSKazbgsnJQWVw6kRZxAva/2UimAcennEvmdOfcJ4D7hcK7UR+MWkxtGTVgAi4VjK3aQDmojMZeQ6QbzpVKxhLAxHJQaaRI6FjGN5sBOzb48sucgvNUmvlk2BVCcVep1rzlojzYasXUPW7OfUEotmofRwFbSSehVJvZADhOOomsMr4ZC5wZ4pFO/m95g2DsraM8FLqY8mrefIDU+rgu8alYykHlh8BvpPNQqk0dUg4q20gnkVGHAN9q8LV/dQrOI2kmk3FPAM8JxW70rsQZRJmZ+j6NrfcmbRq2F5BSkZSDyvLY5T2lVHrOLwcVvddyEOObZQl3UfSxaeXSCrpz7jTkZqfWq9a8BcM+FKWY2iLCM0l4wM25ndK4TCWsHFTmxm44j9XlVik1okUJt5zVCU4DxjX42rucgvOPNJNpEVLF1BgibAMJVUzVWyJI7ZeSXENVLazeVPA87ClUpVT6nHJQ2UE6iSwwvtmGcPtwOnpWapC/A58IxQ69VB12ZmoVYMmwQRLyV6G4qvXtT4wjr0qpSM4uB5XFpJOQZHwzH3B6iEeuoTMuNR5Rd879BLk7Cbes1ryxYR4IW0xJzUq9BkwSiq1aWDmorAj8SToPpTrQQtiCqpOvmzkLaLSr9vvAT52CMy3FfFqN1IrUPMCGYR4IW0xJ7Ze60bUb0pRqWP2b+DnAHNK5KNWhfgzsJJ2EBOObnbHXrjXqEKfgvJJWPi1KckUq1Km+hospr+bNC6wXOp1k6H4pFUUJ2/tGKSXnzHJQ+Zp0Es1kfLMc4e7UuxO4IJ1sWld3zn0RqAmF36Zq94k3JMzM1MbA7OHziW0ycJtAXNXCykFlEeBE6TyUUowHzuuU5T7jm9mxPRHnafCRT4E9dHlvSFKTKV8HJjT64jDFlNR+qbvdnPu+UGzVuk4EQvcKUUql4gdAr3QSTfI7YI0Qrz/KKThPp5VMG5BcmWp4qa+hYqreEkFqv5Qu8alQykFlE6AonYdSaganlYPKN6STSJPxzcbA4SEe+SdwSkrptIv7gXeFYm/W6AsbnZlakcZPJCRNWyKohpWDyjjspnOlVLbMB1zQrst9xjcLA/1Ao///pgC7OQVnSnpZtb7unDsFuEko/PeqNa+h5dpGiympJb5ngSeFYqvWdASwvHQSSqlZ2gzYVTqJpBnfjAH6gDAb7Y93Ck6QUkrtRmpSZQywbiMvzHoxdYO2RFCNKgeVlQk3xa6Uar4/loPKeOkkEnYs4a4geRL4fUq5tKObsPfzStiwkReNWEx5NW9uYP242USkS3yqIeWgMho4F5kTp0qpxi0MHC2dRFKMb3qAw0I88gnQ5RScT1NKqe1059y3sHunJGzYyIsamZnaCJmmh59ge28o1YhdaXA6Vikl7qfloPId6STiMr5ZEzg/5GN7OAXnkTTyaXNSh9EKVdtnc1iNFFNSS3y3uzlXK3c1ovr9X3pljFKtYwz2dF/LbkY3vlkSuBoIc4fbaU7BqaaUUruTKqYa2jc1bDFVb4kgVUzdKRRXtZ5jgQWkk1BKhbIxsJ10ElEY38yFLaQWD/HYXcCh6WTUEWrAB0KxNxrpBSPNTH0LWDaZXEK7VyiuaiHloLIsndMMUKl2c3I5qMwlnUQYxjejgIuA1UM89gqwo1NwJqeTVfvrzrlfAL5Q+A1HesFIxdTmyeQR2ufAw0KxVWv5BXYaVinVepYCfi6dREhHAE6I138O/MQpOK+nlE8neVAo7urVmjffcC8YqZgK0xI/Sf90c+5nQrFViygHlaWAXaTzUErFcmj9Ls3MM77ZHjgm5GP7OQXngTTy6UBSxdRoYL2RXjCcMNOYSdIlPtWIw9FWCEq1unmBX0knMZL6VTFhN4+f7xScsKf91NAki9INh/vNIYspz7ZQXzHpbBqkxZQaVjmofB3YXToPpVQi9i0HFakry0ZkfFMAriFcm6AHgP3TyagzdefcV4BXhcIP229zuJmp1Wj8jqGk3ScUV7WOQ5Hpf6aUSt4cwO+kk5gV45tvAzcCDd3RVvcGsL1TcHS7SvKklvry1Zo35ErIcMWU1BLf827OfU0otmoB5aCyOLCXdB5KqUT1lINKTjqJweq9pG7Bdm1v1BRgB6fgvJxOVh1PaqlvLLDyUL+ZxWJKl/jUSH4OjJNOQimVqFHAH6STGGB8sxBwM/bEYRh7OgXnrhRSUpbUzBQMUxcNV0x9N4VEGqHFlBpS/dTPvtJ5KKVSsXU5qKwqnYTxzdzA9QwzEzGEQ5yCc3EKKakv+chdelwY6jdmWUzVLzdeKbV0hqfFlBrOwUBLNflTSoUS5tLgxBnfzAFcAfxfyEf/6BSck1JISQ3SnXPfBx4XCh96Zio/zO+l6SNsy3ilvqIcVBZET8co1e66ykFlGYnAxjdjgDLhG1afTwu0d2gjmduEPlTBJLVf6kE3504Riq2yb3/CnahRSrWeMQh0RTe+mR3oB3YK+egVwD5OwZFaeupEUsXUkJvQs1ZM6RKfmqVyUBkD7CGdh1KqKXZrZld045uxwF8IX0jdDnQ7BeeL5LNSw5Bs3jnL+kiLKdUqNga+Lp2EUqop5qRJS/rGN3MBVwPbhnz0IeDH2ktKRA2Q+u/eWDHl1by5CH+CISn3C8VV2dcrnYBSqqn2KweVsWkGML6ZF7gB2CLko48DWzkF54Pks1Ij6c65k4GHhcI3PDMltfn8CTfnviMQV2VcOajMB2wnnYdSqqnGA5ukNbjxzQLYhpwbhnz0RWAzp+C8lXhSKgyppb7VZrUJfVZFk9QS3yShuCr7dsBO+yulOkvYpbeGGN8sDNxB+PYHb2ILKe1uLk9yE/pX7i3OUjEl1TdCZZ8u8SnVmX5UP3ySGOObJYA7gQkhH/0A2NIpOE8mmY+KTLIT+rdn/oUsFVNPCMVVGVYOKssB60nnoZQSsSiwVlKDGd8sBdwFrBLy0c+AbZyC88+kclGxPQu8LxR7hZl/YYZiyqt5cyK3+VyrfTUrRekElFKiElnqM75ZDrgbWD7ko59iT+3dmUQeKhndOXcatqCSMOLM1KrYhmnNNg34j0BclWHloDIaLaaU6nSbxR3A+GYlbCEV9tLij7BLezfGzUGl4hmhuCMWU1JLfC+4OfcTodgqu9YHlpFOQiklaoE4Dxvf5IG/A0uEfPQ9YFOdkco0sWKqWvNGDf6FrBRTul9KzYpuPFdKRW7VY3yzBnazedhu6m8DGzsF576osVVTSC3zLQAsPPgXZv5LGnZTXlK0mFIzKAeVuYHtpfNQSonri/KQ8c16wG2En9l6HdjQKThSTSFV46RmpmCmpb6Zi6mw68lJ0c3namYboZcaK9XprgSODfuQ8c2mwM3AvCEffRlY3yk4j4aNqURkr5jyat5Ywq8pJ0VnptTMvi+dgFJK1LHADqV88aMwDxnfbA1cT/hGv88C6zkF56mQzyk5LwFThGIPOTO1ZJMTGUyLKTWzTaUTUEqJ+BwolvLFI0r54tQwDxrf7IidzZojZMwnsDNSz4d8TgnqzrlTgBeEws/Qa2pwMSW1xPc+do1aKQDKQeVryPU7U0rJeRPYuJQv9od90PimF7gUmC3kowGwgVNwXgkbU2VCJtojZKGYesK1zbeUGqBLfEp1nseANUr54j/CPGR8M8r45jdAmfAn/x7Cntp7I+RzKjukiqMPalwAACAASURBVKllBrdHGFzBixVTQnFVdukSn1Kd5a/ATqV8MdT1IMY3cwIXAV0RYt4N/NApOFJXkqhkSLVHGAfMDXwI2ZiZ0pN8arpyUBmFzkwp1UlOBbaJUEgtDvyNaIXUrdjO5lpItT7JE32LDvxEZ6ZU1qwCLC6dhFIqdVOAn5byxfPCPljvan4d8I0Ica8DdnQKzqcRnlXZI11MPQszzkwtLZOLFlNqBrrEp1T7exfYPGIhtQ3wD6IVUucDP9FCqq08Jxh7+szUaADPbqKSmJmaimxVqbJHl/iUam9PAf9XyhfvCPNQfaP5ocDV2L0qYR0O7OUUnMkRnlUZ1Z1zPwCkDhB8ZZlvIcI3OEvCc27O/UwgrsqgclCZA9hAOg+lVGpuxzbifDfMQ8Y3cwBnA7tGiPkZUHQKzl8iPKtawzMMKmyaaMaZKeT2S70kFFdl05pE+8SplMq+c4AtIxRSCwG3EK2QGriwWAup9ia1wvWVmSmpYuotobgqm1aXTkAplbipwMHAGaV8MVRPQeObFbFXwywXIe5/gK2cgvN0hGdVa5Fqj7DIwE+0mFJZsqp0AkqpRL0LdJfyxRvDPmh8sxnwF2D+CHHvAbZ1Cs7bEZ5VrUd8ZmpgmU/qJN+bQnFVNuWkE1BKJeZBYELEQmpfbCPPKIXUpcCmWkh1lBeF4uoyn8qWclAZg+0xpZRqfacCh5fyxc/DPGR8MxtwCrBfxLh/AI5yCk6oC5JVy/ufUFwtplTmfBOZE6VKqeS8B+xSyhevCvug8c38gAE2jxB3CrbtwUURnlWt7z2huItUa97o7pw7VbqY0mU+NUD3SynV2v4J7FjKF0NvBja+WQ7bmXylCHHfxzbivC3Cs6o9SM1MjQHGA2+P9mreWOSu79CZKTVA90sp1brOBNaJWEitBzxAtELqJWAdLaQ6nuQdi4uA3YC+pGASWkypAVpMKdV6PsDORu1fyhdDN2A2vilhG3kuFCH2w8CaTsF5NMKzqo1059wvgA+Fwi8Kds/UwkIJgBZT6ku6zKdUa3kE2808dB8n45vRwHHAYRFjXwfs5BScjyI+r9rP/4B5BOIuCnZmai6B4AAfuTn3E6HYKkPKQWVuojXlU0rJOAdYK2IhNR57v17UQupU4MdaSKmZSG1Cnz4zJVVM6ayUGrAyMEo6CaXUiD4E9izli5dGedj45nvYRpzLRHj8E2BPp+BcEiW2anvixZTUXWh6kk8N+JZ0AkqpEdWwy3pPhn3Q+GYUtnfUScDsEWI/j52NeiTCs6oziPaaklzm05kpNUDqNKlSqjEXAGtGLKTmx85GnU60QuoWYHUtpNQIxHpNgezMlBZTasAS0gkopWbpY2CvUr4YaWnN+GYCcBnR90Qei+1o/kXE51XnEJ2Z0j1TKgt0Zkqp7HkMu6z3eNgH68t6e2E3i4+NEPsDoNcpOKE7qauOJT4zJVVM6Z4pNUCLKaWypQzsV8oXQ5+YM76ZFzgX2Cli7Cew+6OeiPi86kxSxdRsA/+jy3xKmhZTSmXDB9giqhLlYeObHHA5sELE+FcBJafgSHa0Vq1JaplvNOgyn8oG3TOllLy7gWIpX3w+7IP1Zb1dgLOAcRFiTwOOAI53Cs7UCM8rJTUzNb2Y0tYISkw5qMxBtKsklFLJmAz8GjixlC+G3uhtfDM38GegGDH+u9hu5jdHfF4p6OCZKe1eq6B+EkIpJeLfwM6lfHFSlIeNb1bGntZbOWL8ALs/6rkwD/UF/bMD+wKP9OZ7/h4xtmovojNTo5GbmZomFFdliy7xKSXjVGD1GIVUD/AQ0QupKrB2hEJqSeBv2Pyv6Av6R0eMr9qL+DKf1MyUXh+iQDefK9VsrwC9pXzx9igPG9/MiW3AuXvE+FOAnwFnOgUn1IfqvqB/FeB2YLH6Ly2EvSRdG3oqqWW+MSBbTCkFMJ90Akp1kInAvqV88d0oDxvfrIBd1ls1YvzXgR2dgnNX2Af7gv5VsYXUwjP91iZoMaVA6gSo+AZ0nZlSAHNIJ6BUB3gP2CfqBcUAxjcO9lqZeSIOcT+wvVNwXgn7YF/QvxpwG7M+rBK1u7pqL1Jbh8SX+ZSCaHd1KaUadwdQKuWLL0V52PhmHHAysE+MHP4EHOkUnM/DPtgX9K8O3AqMH+IlY2LkpdrHbEJxdWZKZYLOTCmVjs+AXwKnlfLFSL2bjG+Ww15S/N2IObwB9DgF55YoD/cF/T/EblQfbjuAFlMKMlBM6cyUkqTFlFLJ+xfQXcoXH406gPHNdsDFRN/XeAtQdArO62Ef7Av6R2ELwd8z8gdvLaYUdHAxpTNTCnSZT6kkTcMuqR1Vyhc/izJA/W69U4DdIuYwBfgVcFKUbuZ9Qf/cwEXAjg0+osWUggwUU0pJ0pkppZLxIvY6mMhNLI1v1gMqwDIRh3gW2838wSgP9wX9SwNXA6uFeEyLKQVy9cz01gifEP10Rhw6M6VAiymlklABDijli5EaFxrfjAWOAQ4h+vfmS4G9o15S3Bf0b4C9JHnm1gcj0UkBBRmYmfoUmWJKKdBiSqk43gH2KuWLl0cdwPhmNaAf+E7EIT4G9gPKYZtwwvT9UXtjG4FGeUPUmSkFGSimPhFKQCnQPVNKRXUTsFspX3w1ysPGN2OAw4DfEv3rMAC6nILzRJSH+4L+OYAzgT0ixgctppQlXkx9KpSALvMp0DsalQrrf8DBQF8pX4z09WN8szzQB6wdI4/TgcOdghPpPaQv6F8MuAJYJ0YOoMWUssSLKZ2ZUpI+kk5AqRZyNfY6mNeiPGx8MwrYEziJ6D0G3wZ2cQrOdRGfpy/o3wwok8xF51J3sqlskSqmRlVr3iidmVLStJhSamRvYvclXRZjNmoJ4EJgyxh5/B3ojnIlDEBf0D8n8EfggBg5zCx0HyvVliQPIozSmSkl7UPpBJTKOA84sJQvvhV1AOObHYBzgAUjDjEVOBo41ik4X0QZoH6/XhVYOWIOQ9FiSkEHF1M6M6VAZ6aUGsqrwN6lfDHycprxzXjgDKA7Rh4vAa5TcO6J8nBf0D8G+Dm2m3kaB07eSGFM1XqkiqlPu3PuF5LLfEqBFlNKzcqFwCGlfDHyfiDjm02x18F8PUYeVwG7OwXnnSgP15tw9gEbxMhhJDozpUCumHp/ILjOTClJWkwp9aUXgD1K+eKtUQcwvpkLOB67xyqqT7EnBs+N0jsKoC/o7wb+TPS7/RqlxZQCuWLqg4HgOjOlJOmeKaVsi5AzgV+V8sXIXxPGN2tgG3CuECOXh4Bep+A8HuXhvqB/PLaI6oqRQxhaTCno4Jmp0UJxVbbozJTqdE9hm29G2pMEYHwzO3AkcATR+y5Nxm4yP8EpOFOiDNAX9G+MXdZbMmIOUbzZxFgqu8SLKamZqXmF4qps0R4xqlNNBU4Eji7li5E/1BrfrISdjVo9Ri4BdjYqiPJwX9A/FvgDdqN5M73dm++JVPiptiO+zCc1MzVeKK7KlpexSxy6h051khqwaylf9KMOYHwzGtgf27dpXMRhvgCOA45xCs7nUQboC/pz2JYHuYg5xKFLfGpAx85MaTGlKOWLn5WDyis0d1lAKSmTsTM4x5XyxUjFC4DxzVLYk3obx8jlCaDoFJyHojzcF/SPBg7EFnNSF5ZrMaUGRP1AEZfOTKnMeB4tplT787GzUbWoA9Rno3bFXgcT9ZTcNOBk4NdOwYn0/b8v6F8Sex3MJhFzSIoWU2rAokJxdWZKZcZzwLrSSSiVkk+Bo4BTSvli5P09xjffBs4D1o+Ry7PYvVGRN7v3Bf07AucCC8TIIylaTKkBiwvF1ZkplRnPSSegVEruwZ7UeyrqAMY3cwCHY0/rxVlO+zNwuFNwIrVe6Av658d2U++JkUPStPu5GiBVTE2fmYrU2TYBWkypAc9LJ6BUwv4H/AI4v5QvTo06iPHNWsD5wCoxcnkJ2NUpOLdFHaAv6N8cuIDsLcfrzJQaIF5MvSqUgBZTaoDOTKl20o+9CibyrInxzXzYU3b7EO+k68XAwU7BeS/Kw/XZqJOA3WLkkCYtptQA8WW+V4QSyMJ6u8qG56UTUCoBTwD7lvLFv8UZxPhmW2w39Dh36v0X2MMpONdHHSDDs1GDvSydgMqMxYTiTp+Zeh3bPK7ZHcl1ZkoNeBnb7yZq52alJH0KHAOcGLPdwdewe5K2i5nPRGA/p+C8HeXhFpiNGjANeFI6CSWvWvPGAgsKhbczU27OneLVvNeBJZqcgBZTCoBSvjilHFReBJaVzkWpkG4E9ivli89GHaDe7mBP7OXEcS4FfhvYxyk4l0UdoEVmowY825vvkTpApbJFqi0C1GemBmajJPZNzevVvLkF4qpsel46AaVCeBXYHvhBzEJqJeDvwNnEK6SuAVaJWkj1Bf3z9wX9FwA30RqFFMC/pRNQmSG1XwoGLfOB3TcV516nqJZEp2mV9RywkXQSSo1gKnA6cFQpX/wg6iDGN2OBXwK/AmaPkc972CtlLnEKzrQoA7TYbNRgj0snoDJDspiavgEd5E70aTGlBjwvnYBSI3gA2KeUL06KM4jxzbrYdgcrxsznr8BeTsGJtAm7hfZGDUVnptQAyWLqQ5hxZkrCN4TiquzR9ggqq5LqGbUA9h67vWLm8xpwAHBFB85GDabFlBogdZLvne6cOwXkZ6a0mFIDtJhSWdQPHFrKFyP3MzK+GYU9oXcG8Q76TMN2MT+ijftGhfGEdAIqM6Rmpl4b+In0zFQrfypSyQqQadGh1Kw8iV3Si9szaklsz6gfxcwnAPZ0Cs6DUQdok9moAS/25nsi71lTbSczxZTOTClRpXzxw3JQqQF56VxUR/sU+D22Z9RnUQeptzvYB9vFfN4Y+XwM/Bo43Sk4kS5JbrPZqAG6xKcGkyqmptdOOjOlsuQ+tJhScm7C9ox6Js4gxjffAc4D1oqZz3XA/k7BeSHqAG02GzWYnuRTg2VmZupd4DNgbJMT0ZkpNdh9wN7SSaiO8ypwIHBFKV+MtKEbwPhmHHAEcDjx2h28gm13cHWMDebtOBs12H3SCahMkdqAPr2YGg3g5txpyMxOLeDVvHkE4qps0m+Qqpm+AE4DVirli5fHLKS2wO5rOpLohdTUgXycgnNVzJN6j9K+hRTAXdIJqGyo2hpCqo74yswU2E9n32x+LiyJnspQ1tPAW8DC0omotncrcHApX3wsziDGN8sDJwNbx8znYWzPKD/qAB0wGzXgid58T+TTlartSM1KAbw08JPBJ6ek9k0tLRRXZUx9ZuB+6TxUW3sa2AbYPE4hZXwzj/HNscBjxCukPgQOAtaMWUh1wmzUgL9LJ6AyRbJh5/T9lTPPTElYEbhZKLbKnvuAH0onodrO+8AxwBkxT+mNArqAPwFfj5nTVcABUTuYQ0fNRg12p3QCKlOkJmQ+BN4c+JfBxZRU08S4Vyqo9qL7plSSpgEXAkfGabwJYHyzGrbx5roxc3oJ2M8pONfGGaSNT+qNRGem1GDfEYr7TLfdbw7MWEw9KpAMwEpCcVU2PYQ271TJuBs4MIG79BbC9p7ak3h/L6cCpwK/cQrOh1EH6dDZqAH/6c33vDbyy1QHyQnFfXrwv2gxpTKl3rzTB9aQzkW1rBeBQ4C4J/Rmw96jdwwwPmZOD2E3mMcq7Dp4NmqAzkqpmYnNTA3+l+nFlJtz3/Rq3hvAok1OaFGv5i3o5tx3mhxXpcz4ZgywIzABuNIpOI1uLr8RLaZUeB9jO46fVMoXP4kzkPHNBsDpwKoxc/oA+BVwtlNwvog6SIfPRg2mxZSarlrz5gWWEQo/62Kq7jGaX0yB3Td1r0BclRLjm7mBK4DN6790sPFN0Sk4lzbw+F+B36SWnGpHlwC/KOWLsU4lG998A7u53Ekgp8uBg5yCEysnnY2agRZTarBVBGMPW0w9CmzUvFym02KqjdT3mNwArDnol2cDzjW+uc0pOG/O+snpfLTflGrMg9h9UbFaatS7lx8C/BKYK2ZOLwA/dQrODXEG0dmor3ikN9/z0sgvUx1EaokPZtozNfNmSt03pWKpf7K/mxkLqQHzAvuNNEYpX5yKXepTaiivAb3AWnEKKeObUcY3P8JenHsM8QqpL7CzWqskUEhtQef0jWrUZdIJqMyR2nw+GZihpcmsZqYkaHuENmB8syJwC8PfubhOg8NdCfTETkq1m8+AE4E/lvLFyCfiAIxvVsKertssgbwewG4wD+IM0hf0L4ntqL5DAjm1m8ulE1CZIzUz9Vx3zp1hD+TMxdS/m5jMYDoz1eKMb9bA7nVaaISXNvqX/xbshuK4Sy6qfVwOHFbKF2P1xDO+mR84CjiAr34PDOs94BfAeU7BmRp1kL6gf3bsZctHA3PHzKkd/as33/OUdBIqc6Rmpv4z8y/MsMzn5tz/MdPUVZMs69W8cQJxVQKMbzYD7mDkQgrsm8+ISvnix+hSn7ICYMNSvrhDnELK+Ga08c0uwFPAz4hfSE0EVnQKzjkxC6n1gUnYJUItpGZNl/jUDKo1b1FgEaHwD8/8C7P6ZvIozT81Mhq7K/+fTY6rYjK+6QIqwOwNPhLm2qIrgZ+ETkq1i5ewpzorpXwxclsBmD5zegbJtNx4GtjfKTg3xRmkL+hfDFtA6XL2yLSYUjOT3HzecDG1Rfq5fMX30GKqpRjf7IftxTMqxGNXhHjtDdiNfo0Waqo9vAX8ATinlC9+Gmcg45vFsL2ndkkgr/eA3wFnOgXn86iD9AX9Y4B9sF3V508gr3b3aG++50npJFTmSC3xQYPFVOSb1GP6HnCOUGwVQv2y16Ox+07CeBe4uNEXl/LF98pB5TZgy5BxVGv6ENsK4ORSvvh+nIGMb+YE9geOAOaLmddU4FzsNTAjtfUYVl/QvybwZ+C7MXPqJDorpWZFambqbeys+QyGmpmS8D2huCoE45vRwFnA3hEeP8QpOB+FfOYitJhqd59jC4xjS/lirGKl3nW/iJ1BSmK7wq3Az5yCE+v7Yl/QvxB2hmx3ws3kKi2m1KxJzUw9PPiC4wGzKqYex9603uwv+FW8mje3m3PDvtmqJqm/UV0AlCI8/kun4FwU4bmrsZ8Chmu3oFrTVOx+u6NL+eILcQaqz5ZuBfyRZD6xDmxS/6tTcCLf79cX9I/GLjEeT2MHNNSMgt58z+PSSahsqda8gX3WEr6yxAezuAG9Xsw8m3o6s85lgkBc1YB6IXUx0Qqp47BvJqGV8sUp2Jkw1V6uAnKlfHGXBAqpNYE7geuJX0i9CxwEfMcpODfELKRWA+7BfgDRQiqas6UTUJm0FDCPUOxZ7u0e6mjwY8By6eUypO9hv/moDDG+mQ3oA9wIjx/mFJw/xUzhfOyprjljjqPk/Q34ZSlffCDuQMY3KwDHksyJzy+wS42/dQrO23EGql8D8ztst/+vfGBVDXsfqEonoTIpU5vPYehi6hFgm/RyGZLum8qYeiF1CeEvfp0K7OkUnAvj5lDKF98pB5V+YM+4Yykx/8Tee3dbKV+MPNsDYHyzOLa43gMYk0BuNwI/dwpOrOWkvqB/FPYDx4nA4gnk1en6evM9sbrcq7Yltfn8PYZYuRuqmJKaHdJiKkOMb2YHPGD7kI9+DuzkFJwrE0znDLSYakVPYU/UXZFAETUvcCjwc5LpjP84dnN5rH5RAH1B/8rY5egN446lpvuzdAIqs6RmpibNavM5DF1M3Y+d9k7iU18Yy3s1b7ybc99tclw1E+ObObAdnn8c8tGPgG2dgnNbkvmU8sVHy0HldmCTJMdVqXkF2z6jXN/3Fln97+Ke2FYcSXQ8fqc+1rlOwYmVW1/QPw/wa5LpqK6+dHtvvucJ6SRUZknNTM1yiQ+G+OJ3c+4HXs17BFg9tZSGVsAeR1ZC6m9efwF+FPLRd4AtnYLzYPJZAbZbtBZT2fYO9sDBWaV88ZM4A9XbcOyAbeCZxB7OKdgZzmOcghPrA1t9SW874BT0pGkadFZKzVK15i1Axk7ywfCfpO5BpphaAy2mxBjfjMVeKPvDkI++AmzmFJw0L8u+BXtqa8MUY6ho3sd2wz+xlC82dP/icIxvNgZOILnvQddh+5zFviy3L+hfHluUSdwU0QleBq6VTkJl1vrIHeyIXEwdmHwuI1pHIKYCjG/GYe/DC9sk8z/Apk7BiXXEfSSlfHFaOaj8ArsMrbLhv9jZmXMTKqLy2DYam8cdq+5R7L6o2B/Q+oL+OYFfAIcDY+OOp4Z0bm++J9byq2prGwvF/Ri7B3SWhqvupDahr+/VPL2Lrcnq129cTfhC6hFg3bQLqQH1I/VJbmxX0TyN3ce0bClfPCFuIWV8s4zxTT8wiWQKqbewXfonJFRIbYUtzI5CC6k0fYpthaLUUKSKqQe6c+6QF64POTPl5tz/ejXvaWD5VNIa2tzYU333Njlux6oXUtcC3w/56F3ANk7BiT0jEdKvsPu5mn1AQtlp7j8CV5byxSG/sTTK+GYh7J/nfsAcccfDXox9GvD7JP5e9gX9SwOnAtvGHUs15OzefM/r0kmobKrWvEWRO8k37KGqkU6f3EPziymwlacWU01Q7yN1KeELqeuBHZ2CE2uTcRSlfPHJclC5CNtnSDXHHdgiKnafKADjm7mAA7DLZvPHHa/uKmyT2KfjDtQX9I8DDsae1NNmsc3xCRFvSlAdYyPB2LGLqVJiqTRuY+D3AnE7Sv0+szMJf2rvEmBXp+BMTj6rhv0W2Bl9o0vTNGyBcnwpX0zkhGa9eO/F/vl9PYkxgQA42Ck4f4s7UP0uvZ2wJwiXjjueCuXPOiulRiC1xPc/hrhGZsBIO+Kl9k2t7dU8fZNM35HAXiGfuQjoFS6kKOWLr2CXc1TyJmP/nFcu5Ys/SaKQMr4ZbXzzE2zhcwHJFFJvALsDqydUSG0EPIj9sKCFVHN9jD29qdRwpFrj3DHcfikYeWbqKeBNkmmUF8ZYYC3s0oJKgfHNbtj7w8KYiL0iZmoKKUVxPLYYHC+dSJv4CDgHOLWUL76cxID1XlHbY5fLkmq09zlwMnCcU3DejztYvXv58YRvB6KSc1ZvvucN6SRUdlVr3tLI3BkMIyzxwQjFlJtzp3k17x7Cd8FOwsZoMZUK45sfAOeGfOwaoOgUnNibjpNSyhf/Vw4qx2Kbearo3sLO8v25lC++k8SAxjdjsA03fw2snMSY2Pse+7GXET8Xd7C+oH9x7HLj7uiFxJI+Qr+G1cgyu18KGrv+QLKYUgkzvlkTuIxwJ+FuARzppb0hnInth7akdCIt6HVst/LzS/nix0kMWC+iHOwS8kpJjDkwNHC0U3BiXzHSF/TPjb3f7zDs6WEl64zefM+b0kmozJOqCV7EtoIZVqPFlIQ1vJo3n5tzY0/jK8v4ZgXgBsJt2r4L+LFTcD5LJ6t4Svnip+WgchR2j49qzNvYZa2zEiyiZgO6sEXUt5MYs+5a4Cin4ARxB+oL+sdgD9QcAywRdzyViA+Bk6STUNlWrXmjkNsvddtQlxsP1kgxNQl7ZLXZG8LHAOth3/xVTMY3iwM3AwuFeOxB4IdOwUnkDTdFFeAQkltOalfvAycCp5XyxUQ+pNSLKBdbRH0riTHrbgF+ncQ9j/V79LbAbnCWuiBVzdoxvfmet6STUJm3AvA1odgjLvFBA8WUm3Mn1/dNbRo7pfA2Roup2Ixv5gH+CiwT4rF/YS8t/iCVpBJUyhe/KAeVX2L3damv+h/24tiTEtwTNRu2NcURJNuL7m7gSKfg3JXEYH1B/2rY/Thh+6ip9D2FbYiq1Egkt/00tHe7kZkpsAWNRDG1OXZvg4qo3kvqYmBCiMeewN61l8gbb5NcB/wDvdtxsBex9+ZdWMoXEymKjW9mB3qwRdQ3kxiz7iHs7NatTsGJ3RS0L+j/BrZXXQ8wKu54KhX79+Z7PpdOQrUEqWLqX905t6HeZ40WU9cj8wliFa/mLe/m3NgdjTvY4dij6Y16Fvi+U3Ba6pjyoEuQ75bOJQMmYWdjLivli4lcGGt8MwdQxF79smwSY9b9C3vi77qEiqj5sX/nDwbGxR1Ppeaq3nzPLdJJqOyr1rzRyJ3ka2iJDxosptyc+4xX854AVoycUnQ/QjcoRmJ8swVwbIhHXgE2cQrOKymllKpSvnhPOaj0Y2cjOtFN2D1RdyRx5QtML6JK2CIqyUaWTwK/AS5Lom9ZX9A/O/bi5aOBheOOp1L1KfAz6SRUy1iVcHt9k5RsMVV3PVpMtQzjm+Wwd+41usTxIbCVU3CeTy2p5jgYu9m42Y1mpUwBPODEUr5YS2pQ45uxwC7AL4GlkhoXeB5b8FSdghN71qy+uXxb7L2BK8QdTzXFcb35nuelk1AtQ2qJbzIhVjrCFlOHhE4nvnW8mreIm3O1D0mD6hvOrwYWaPCRaYDrFJx/pZdVc5TyxbfLQWU/bF+idvYBtvHqaUl1K4fpRdRu2CIqyd5dr2BbElzsFJxE9sn0Bf1rYmfi1k1iPNUUz6ENOlU4Ui0R7uvOuR82+uIwxdS92FNBjb5BJ2U09pqHi5sctyXVN5xfRLgj4Ic5Bee6lFKScBn2uH7YC5xbwSvY/Yvnl/LF95Ia1PhmHLYT+C9I7gJisNdRHQuc4xScT5MYsC/o/ya22eiOSYynmurg3nzPJ9JJqNZQrXmzA+sLhb81zIsbLqbqLRJuwjbma7Zt0WKqUYdhr/Fo1MW02TJqfTP6vsCGwPzC6SSlhv1Eb0r5YmInoIxv5sTuNTqcZBtZvovt63SmU3Aa/nQ3nL6gf0Hsib/9gNmTGFM11aW9+R5tX6LC+D9gHqHYt4d5cZiZKbBLfRLF1KZezZvLzblZbx4pyvhmM+wn9kbdBeydxCmqrCnli6+Wg8ohwPnSucR0O7aIuiWpTeUAxjcLYi+JPgBYPKlxscuPpwAnOwUnkZmzvqB/PHYv3IHAfEmMqZruVWwRrFQYjlDcV7FNqxsWtpi6CXvZp4/u3QAAG8pJREFUaLMvBZ0T2Ay7D0jNgvHNothLYBvdcP4c8JOk9q9k1IXY5T7JCzKj+AL4C3ZT+cNJDmx8szxwEHZz+VwJDv0JcAbwJ6fgJNLRui/oXwBbRB2EFlGtbtfefE8r9a1TwupLfFJL+aY7534R5oFQxZSbc9/2at69yGz4/BFaTM1SfZ/UecCiDT7yPvaamLa+xqG+3LcHdoms2dchRfERdibt1FK++EJSg9b/fqyNbYC7Lck2sfwcuxH+WKfg/DeJAeu9og7CFlLtskzbyc7pzffcLJ2EajmbIHcq+9KwD4SdmQLbDV2imNraq3mzuTk3kSaEbaZE45utpwKOU3D+nV462VHKF58pB5Ujyfa+sP8CpwPnlPLFd5MatH7ly3bYnj5rJjVu3RTsfrvfOwXnxSQGrBdRB2KLqGYfdFHpeAY4VDoJ1ZJ2Eor7DOCHfShKMXU94fblJGUh7KfrRO7sahfGN8ti34gbdbBTcG5KK5+MOg279r6GdCIzeRx7tL9ayhc/S2pQ45t5sSfzDiTZRptgZ6L6gOOdgvNMEgP2Bf3zYXP9GVpEtZOpQG9vvieRAwiqc1Rr3pzYD4ISJnbn3ND7U6MUU48BL5D8N+lGbIcWU9MZ34zBvrE1etrhXOy+lo5Svwh5N+Bh5E+BTcXO7p4D3FTKF2N3/x5gfPMN7IbyPUl+j9F7wNnA6U7BeS2JAetF1P7Y5cfxSYypMuWE3nzPP6STUC3ph8id4gu9xAcR9054Ne9M4KdRno3pdWBJXeqzjG8OxR4/b8SdwGZOwZmcXkbZVg4qR2OvMJHwMnABcFEpX3wpyYGNb1bHzursSLQPSMN5FXs67zyn4LyfxIB9Qf+8fFlELZjEmCpzfGDd3nxPYjOuqnNUa95V2P2dzVbrzrmrRnkw6jfeq5ApphYDNgVuFIidKcY3qwK/b/Dlb2E7nHdsIVV3HPbS51WaFG9gFuo84MZSvhjqdMhwjG9GAz/AFiQbJDXuII9jWzJUE+xYPg/2ePwhyN21pdL3NvATLaRUFNWaNx7YSih8pFkpiF5M3Qm8RrJN/hrVQ4cXU4OW9+Zo8JFdklqaaWWlfPGzclDZGbgPGJdiqDRnoeYCithN2mncRfcP4HjghiQuIIbpRdRPsRuRtYhqb1OBrt58TyKHElRH2o7G39uSNjHqg5GPSHs172TsN/Rm+xRYzM25iSw5tCLjmz2x+58acZZTcLRZ3iDloFLEFqNJmgr8FfvnclMpX0x0Kdr4ZjFsQbIv6RQk1wInOAUnsT0ufUH/3Nh8DwMWTmpclWm/6s33SBxQUm2iWvNuR+Zy4/u7c+5aUR+Os7+iikwxNQ67VHORQGxxxjfz0/jy3mPoseSvKOWLlXJQ+T9gnwSGewU7C3Vh0rNQAMY3q2C/znYGxiY8/GTgEmyjzceTGrQv6J+LL4soqT4xqvmuwc5qKhVJteYtgVyT5chLfBCvmHoYeBL4dpwEIuqhQ4sp7N1kjbxBfYbdJ6WXis7awcB3idZ/aWAWamAvVNKzUKOwDet+DmyR5Nh1H2BPE57mFJxXkhq0XkTtjb3nr9EGsqo9/AfbBiGx06mqIzkk21S4UVOxt05EFitpr+b9GvhdnDFiWMbNuYl1iW4F9atA/k1jx/t/4RQc/ZQ4jHJQWRK4h8bbfATYwxeJ74UCML6ZD3v9zT5ApBMlI/gvcCpwTlL35sH0C4j3xbZl0JmozvMxsGZvvudR6URUa6vWvAeB7wmEvr07534/zgBxj1F7yBVTOwN/EIot5UQaK6Qexx5nV8Mo5Ysvl4PKOsCtwEqzeMlnwB3AdcD1KRVQo7A3o++B/VSW5H15A57Ensy7xCk4iZ2w6gv6l8bO8O0OzJ3UuKqlfAHspIWUiqta876FTCEFMZf4IIHpNK/m3Yd9M2i2J4GV3AidSluR8c0mwG0Nvnwjp+DcmWI6baUcVBbGdpFfETt78yT2xOptpXzxozRiGt8siF2u3oP0WjXcj93Dcm1SJ/MA+oL+VbF78XYCxiQ1rmpJPb35nkukk1Ctr1rzjgJ+KxB6MrBYd86NdZVXEg3+qsgUU9/GVrEPCsRuqvrsRaMnZDwtpMIp5YtvYZfXUlX/c1wfW0BtT/Ibygdcj23meo9TcBL5sNEX9I8CNsRuKk9jH5dqPftrIaWSUK15o2jC9+Ah3Bi3kIJkiqm/YPdhSHxCLdIBxRS2WG1k+vN9bENElSHGN4sCvdjlsDR6Q4G9eLiKPZn3WFKD9gX9Y7B9Xw4DCkmNq1reUb35njOlk1BtYwIyh9kggSU+SKCYcnPuG17NuwXYMoF8wuryat7P3JybSIfmDDugwdf9VptzZkO9Q/n3sbNQPyK9OwE/xJ4qPNUpOInt6eoL+ucEStgThcslNa5qC6fQeHsWpRqxk1Dcj7F7YmNL6h4vD5liaiHs/T2xjjRmmfHN17FLQiN5G3vcXQkyvvkasAuwG7BsiqFq2D/vasIn8xbCnszbHz2Zp77qYuDnvfmejtirqtJXrXmjkSumrunOuYnsi02qmLoaW+GlcRJpJPvRxsUU9ph8I39OZzgF5+O0k1FfVb/eZ0vsLNQPSG/J+zPAYIuo+5PaDwUznMzbA5mvY5V9VwJ7aiGlErY+8HWh2JGvj5lZIsWUm3M/9GreNchUl+t5NS/v5txAIHaqjG/GAXs18NJPgLNSTkfNxPhmaWDX+o8lUwz1FLaA6nMKzjtJDtwX9OexJ/O60JN5ami3Am5vvifRBrVKYWfBJbwO3JTUYEnNTIG9UkNqqu6nwJ5CsdO0HY3daXahU3DeSjsZBcY3swNbY2dwNie9br2TsTMB5wB/T3gWajR2Ju0AYLOkxlVt635gu958T2I9ypQCqNa85YEfC4U/vzvB/dZJFlN/Q+56mZ29mvcLN+cm+qk9Axo9gq4NOlNUb2mQx87elIDFUgz3PPay5IudgvN6kgP3Bf3zY/dz/RRYPsmxVduqAVv15ns+lE5EtaWDkLs+5rwkB0ysmHJz7jSv5p2DzBv7nNg3iZMEYqei/gbeSHv7R52C82za+XSa+n//1YAd6j/SLD6mAtdii6hbkmywCdAX9K+E3VvYi3YqV417BtisN98TuwePUjOr1ryFsFskJFzbnXMTvdEiyZkpgD7gWGxx02z7ejXvVDfnfiEQOw0rAks08Lrb006kU9QLqAl8WUCl3RLgFeB87DLty0kOXO8P9QPsfoRYd06pjvQK8P3efM9/pRNRbWsfZGoFSGGPcaLFlJtz3/Vq3qXIVJvfxO4DuV4gdhoafQPUYiqGegH1Xb4soL6ZcshpwM3YvVA3OAUn0Q29fUH/eOzX309JtzWDal8v8P/t3XmUXHWVwPFvIAQQCAFBGBDiCCZC+FlAisWATmB0GAbZBCn8PYpiE5BNRxAmGBxlJCADiAeRHawU7yelbAF1BhAzKDOQWGiKxzK0AcKiZgAzIYFA9vnj93rSNNBd6X7v3XpV93NOnQ7ndN696ZDuW7/lXvj7SqE8TzoR1ZnCyG2A3MHzHvzM1UQlvTIFcA1yS3dn0F3F1ErgobQT6TRxATWRNQVUFkXHK8BNwA2lYun5pB9ebdZ2wX9zOgZtbaCGbjZwSKVQTvS8nlL9BMCHhGJfExib6FEKSOngl4vcbOSmP4+3xvYIxU5MvVGfy+DbTM+WiiU9SNyCuIDaA188HQl8JKPQM/GrUHeXiqVEO/XHW3mH4Iuo/ZJ8tupKdwDHVgpl7VenUhM36XwC2Ekg/FvAtknM4usvjZUp8KtTUsXU6cBXhGInadMWPietESUdIS6g9mRNATU2o9D/i+8UfX2pWHom6YfHXcpPxHcqz+rPpDrbpcCUSqGc+Dt2pfo5EJlCCiBMo5CC9IqpOnAFMCal5w/kOBe5qdbYxQKxExEXAa187TZIO5e8ib92e7GmgNo+o9Bv47eYbwN+USqW3ko6QNxg80z8Ern+3askrAROqxTKiV4TV2oA5wjGviatB6dSTFljl7jI3YIfT5G10UAZ+KFA7KRsSGt/N/oDFag36hsD++CbaB4JbJdR6OX4w+S3AfeUiqXEC/hqszYSP3/yTPzYBaWSshj4QqVQvk86EdUdwshNBCYLhX80MPZ3aT08rZUp8OdEJIopgLNd5K63xuZ19EGrK3qb1Bv1Dyd9rb7d1Rv1jYBJ+HNCk/Fbymn+v9zXKvwNytuAu0rFUipLxtVmbQt8l/XTSHdUjepOLwEHVQrlSDoR1VXOFoz9/TQfntoPIGtsj4vcg8DfphVjAB/Fd6u+VSB2Ehbif2ivM8jnjQCm4M+Jdax6o74hvniajC+g9iT782K/wRdQdyTdmbyvarO2O34V6ovA+mnFUV3tMeDgSqH8Z+lEVPcIIzcWOEoo/HPA7WkGSLWNu4vcYcBdacYYwH8DE2wKVyCzUG/UI2CXFj51GbBjqVhKtJurpHjA896sWXnaGxglkMps/Pm/n6S5+ldt1kbg33RMAfZPK45SwAwgqBTKb0onorpLGLkrkNutOi0wNrXzUpD+1sg9yM3r+zh+UHCq1WiKfkdrxdQo4NJ6o35sqVhannJOqag36uvjD433Fk+fRG5V5nH8ClQ97TE98cDhw/BFVDHNWErhLwWdWymUO2VKhMqJMHJj8McWJLwC/CjtIKkPGHSROxG4Me0472MOsLs1drVQ/CGrN+pfAa5ci9/yKBDkYU5fvVEfhd+qm4wvoCYhe5i+B/gxvoB6Ou1g1WZtFGCB8/BFv1JpegM4q1Io3yKdiOpOYeS+jm+/IWFqYOxFaQfJ4tDurcCFwDYZxOpvV+AfgJ8LxB6uf6e1c1O99gbm1Bv100rFUlucFYvbFGwFmD6vXeKX9E3EF/ArULcBzVKxlEnBXW3W9gduRvtDqWw8DFQqhXLbv8lSnSmM3Cjkej++QUY3+1NfmQJwslXpo8CknK5O3QwcP4Tf2gM8EL9mloqlRYkm1k+9UV8X2BpfIEzgncXTB9OMvZbmAXfjz0HNyqqA6lVt1gKgRkb/7lRXWwZcAFyu23pKUhi5MjBdKPwVgbGZ3CDM6jr5dcA3aK2rd9J6DzInPtgwA9/CN2hc28PX4+LX6cDKeqM+C/8OdT7wGvCXfq/XS8XSqnqjvg7+rNL6+JWjvh83AbbFX9PfLv7Y+/orYN2h/iFTtAj/9/4AcD9+/I5kUf0WsID2KjBV54mAYyqF8uPSiajuFkZuBHJNOpcD38sqWGbvkF3kLgb+Kat4/fzKGivRomHY6o365cDXUg6zEr+lmPfxNCuBWfjC6QFgdqlYaqteY/EomEuAk6RzUR1nNX4H4J8rhfJS6WSUCiN3AP7IioRbAmNPyCpYlsXU1vhzKhJX3MFv9T0iFHvI4ptud+LPfql3m8ua4mlmqVh6XTifllSbtUn40QafkM5FdYTn8UOKH5ZORCn4/4HGs4GJQinsHBib+oWiXpme3XCRux6565E/t8Z+Tij2sMQF1R3AQdK5tIGFwC+Jz4SViqXnhfMZsnhUzJn4CxobC6ej8usm4B8rhXJu55GqzhNG7ij8+VQJMwJjD8syYNbF1Dh8M02pA7i7W2N/LxR7WOKC6qfAwdK5ZGwF8F+sOff0WKlY6qgDtdVm7cP4vf0jpXNRufIKcFKlUL5XOhGl+gojtx7wFLCjUAqfDIx9NMuAmRc1LnK3A0dkHTd2pzVWKvawxQfEy8B38S0HOtEqfMH9IL54eiiNAcLtqNqsfRbfWLGVZq2qey0FrgIurhTKC6STUaq/MHKn4o8xSPhFYGzmuzgSxdREoJF13D72tsbOEow/bPVGfTQwFfgq+T40/jrQjF+Pxx+fLBVLS0SzEhRv/R0PfAf4kHA6qr2sBqr4A+YvSiej1HsJI7cR/izr1kIp7B4I7ECJbLcJr079Gpicx75T/dUb9R2ACn6o88eE0xnIavw/ribvLJ5eFG5V0Laqzdom+NuvZ6MDj5VvPDylUihH0okoNZAwcucDqXccfx+3B8Z+QSKwVDE1HngSud5EB1tjfyYUO3Fxp/Fd8UXVUcBHBNNZhC+UeleamsATpWJJB6sOQbVZGwtMw4+fUd1nFnBepVB+SDoRpQYTRu6DwHPAaIHwq4BdsrzB15dYJ2YXueuAk4XCPwUUrLFt1YMoKfVGfSv8lfu+r51Jpi3FYuDP7/HqwRdQ83S1KXnVZm0v4NvAAdK5qEz04Adg31UplPXfk8qFMHKX4VfTJUwPjK0IxRYtprbBb/1sKJTCl6yxUgOYMxePfNkUGANsFn/s/fVo/K25ZfjDrUv7/XoJvmCarytMsqrN2h74aQKHSueiUjEP39T1pkqh3JFv9lRnCiO3Pf5NgMSxhBXA+MBYsRmUojPCXOSm4d99SfgTMM4aq8WByp1qs/YJ4Hz8tq7O+su/XwNXAvfoLD2VR2HkpuNvm0u4NjD2y0KxAfliagzwLLC5UApTrbFSB+WUGrZqszYe/4bkGNpzPqJ6f8uAHwPfrxTKuex/pxRAGLl9gd8IhV8K7BgY+7JQfKAN3tG6yJ0NXCYUfjGwgzX2VaH4SiWi2qxti7/ZeQKwg3A6amCv4HvwXFsplOdLJ6PUcISRG4lvd1QQSuF7gbFpz68d1DrSCQBXAy8Jxd4EuEAotlKJqRTKf6wUytOAccB+wK3A27JZqX6a+B5iYyuF8re0kFId4hTkCqk38WcMxYmvTAG4yB0H3CIUfgWwkzV2rlB8pVJRbdY2Bb4InAgUhdPpVq8CITAdmKM381QnCSO3Jf7Q+RihFC4KjJ0qFPsdRkonEKsB5wATBGKPxPfxOUogtlKpqRTKrwPXAtfGB9ZPwPer2lI0sc63FJiBL6DurxTKy4XzUSotFyNXSC0ALheK/S5tsTIF4CJ3MHCPYAq5HzOj1GCqzdq6wD7A54HDge1lM+ooD+MLqJ9WCuWF0skolaYwcnsBmQ4T7uf0wNgfCsZ/h3YqpkbgbwPsI5TCw8CnO2HMjFKtqDZrI4Dd8UXV4fjGrmrtPIcvoG6tFMrPSiejVBbCyK2L784/USiFJ4DdgjZqvN02xRSAi9w++KJGyinW2OsF4yslJm6z0FtYFWmPCyrt5k1gJnB//OrRc1Cq24SROxm4TjCFzwTGPigY/13aqpgCcJGbARwiFH4xMMEaK3W7UKm2UG3WxgD7ApPxtwN3ow2/X2RgNfAYa4qnRyqF8jLZlJSSE8/f60GuP+TdgbGHC8V+X233zdFFbgJ+xpvUu+J/Aw7S7T6l1oiLq0/hC6vJ+MHabff9IyEvs6Z4erBSKL8mnI9SbSOMXA3fJFjCMmDnwNi221Jvy2+GLnI34/uxSKlYY6cLxleqrVWbtc3wBVWhz2sCyQzTzspq/ASGp/HDz5/CNx98WrfulHq3MHKfA+4VTOGSwFipEXQDatdiajvgD8gMTARYiN/u+5NQfKVyp9qsrQeMZ02RtQswFn9jcCPB1Fbgv5/0Fky9xVNPpVB+SzAvpXIj9OPfngS2EUphPjAuMHaxUPwBtWUxBeAidynwdcEUfgX8nTVWh44qNQzxrcHN8EVV/9fm+EkEo/t97L/Nvwp/+Lvva8kA/70Yf67jaWCunnNSanjCyN2E71Un5fjA2B8Jxh9QuzTtfC8XAkcD2wnF3x84H/gXofhKdYR4y2xB/Joz2OfHxdcHgI2B5fjiaJluvSklI4zcAcgWUg18C5K21bYrUwAucocCdwumsArY3xr7kGAOSimllIgwcqPxfZ2kFjYAJgXGPiIYf1Bt3UfGGjsD2WJqHcA5P39IKaWU6jbfRbaQcu1eSEGbF1Oxs4A3BONvA1Rd5PLwtVJKKaUSEUZuf+BUwRSWAOcJxm9Z2xcIcQPNC4TTOBA4WzgHpZRSKhNh5DYGbhRO4xuBsS8L59CSti+mYj8Afi+cwzQXuT2Fc1BKKaWycBnw14LxfwtcJRh/rbT1AfS+XOSK+MGKkgXgc8Bu1thFgjkopZRSqQkjdwRwu2AKK4CJgbGPC+awVvKyMoU1tgFcLZzGR4HrXORyU4QqpZRSrQojNxb57b1L81RIQY6KqdhUQLor+dHIjrpRSimlEhdGbiQQAmME0+ghh/0dc1VMxdtrZ0nnAVzlIvcx6SSUUkqpBH0T2Ec4h5MDY98WzmGt5aqYit0J/Ew4hw+g231KKaU6RBi5yfjdH0k3BDltkp27Ysoauxo4A99/QtJ+wLHCOSillFLDEkZuC/z2nuQCwXzgXMH4w5K7YgrAGvsCMEU6D+AK7Y6ulFIqr0K/w3IzvkG1pDMCYxcK5zBkuSymYj8A/lM4h82By4VzUEoppYbqDOBg4Rzuxh/hya1cn/lxkRsPNIH1hVP5rDX2l8I5KKWUUi0LI7cTMAcYJZjGImDnwNg/CuYwbHlemcIa+wz+9oG0b0snoJRSSrUq9PNmr0e2kAI4L++FFOS8mIpdATwmnMOkuEO7UkoplQcnAfsK5zATX9DlXu6LKWvsCnwTzeXCqZwpHF8ppZQaVBi5DYFLhNNYCFQCY1cJ55GI3BdTANbYCLhIOI2jXeS2Es5BKaWUGswRwGbCOZwSGPuScA6J6YhiKnYxEAnGHwWcLBhfKaWUasVJwvGnB8b+RDiHRHVMMWWNXQacgJ82LeUYwdhKKaXUgMLIbQr8jWAK8+jAYzEdU0wBWGMbwAWCKYxzkZNeOlVKKaXez3jB2KuAYwI/Z7ejdFQxFbsUkOz5NFEwtlJKKTWQjwvGnhYYK91sOxUdV0xZfzOgDLwilIKuTCmllGpXGwjFnQ1cKBQ7dR1XTAFYY+cjN4R4pFBcpZRSajB/EYi5BL+9J93CKDUdWUwBWGPvw9/wy9qbAjGVUkqpVvyPQMyvBsb+QSBuZjq2mIpNBbK+fjkr43hKKaVUq34LvJFhvBnAjRnGE9HRxVR8fqoCPJxRyLnWWImqXymllBpUYOxS4L6Mws0HTgqMXZ1RPDEdXUwBWGPfBg4Fnskg3JUZxFBKKaWG4+qM4hwXGPtaRrFEdXwxBWCNXQAcSLo3/F6mC5YylVJK5Vtg7Ezg3pTDfDPwZ5e7QlcUUwDW2OeBycBzKTx+JXC89cunSimlVLs7E3ghpWffAHwnpWe3pa4ppgCssU8DewNJNw37sjVWslGoUkop1bLA2BeATwNzE370PcBp3XBOqq+uKqYArLGvAp8BwgQetwr4mjX2hgSepZRSSmUmMPZFfEH1VEKPnAZ8PjBWckauiBHSCUhxkRsBTAG+Caw/hEe8CpSs33tWSimlcimM3JbAHcCnhviIV4EvBcbOSC6rfOnaYqqXi9w2wLnAKbTeZr8OnGONfTm1xJRSSqkMhZHbAzgdOJrWFhleA/4VuDowtqsbVnd9MdXLRW5r4BzgVGCj9/iURfjeHNOssXOyzE0ppZTKShi5LYDj8W2Ftge2xR9rWYDvHfUfwP3AzMDYJUJpthUtpvpxkVsPP1V7V2A94G1gHjDbduE+sFJKqe4WRm5dYFW3HSpfG/8HS4VniLAxUgAAAAAASUVORK5CYII="/>
11
+ </defs>
12
+ </svg>
@@ -0,0 +1,72 @@
1
+ import { IncomingMessage, ServerResponse } from "node:http";
2
+ /** A docs folder the reader serves. */
3
+ interface DocsSource {
4
+ /** Its name in the top bar, e.g. the app's name or `spacefn`. */
5
+ readonly label: string;
6
+ readonly dir: string;
7
+ /** Its path under the reader's base: `""` for one source, else e.g. `spacefn/`. */
8
+ readonly prefix: string;
9
+ readonly version?: string;
10
+ }
11
+ interface ReaderOptions {
12
+ /** The URL the reader is served at, e.g. `/` or `/__space/docs/`. */
13
+ readonly base: string;
14
+ readonly sources: readonly DocsSource[];
15
+ /** The site's name in the top bar. */
16
+ readonly name: string;
17
+ }
18
+ interface Reader {
19
+ /** A Node or Connect handler; `next` is called for URLs outside the base. */
20
+ readonly handle: (req: IncomingMessage, res: ServerResponse, next?: () => void) => Promise<void>;
21
+ /** Stops watching the docs folders. */
22
+ readonly close: () => void;
23
+ }
24
+ export declare const createReader: (options: ReaderOptions) => Reader;
25
+ interface TocEntry {
26
+ readonly depth: 2 | 3;
27
+ readonly text: string;
28
+ readonly id: string;
29
+ }
30
+ /** A page's text under each heading, for search. */
31
+ interface Section {
32
+ readonly id: string | null;
33
+ readonly heading: string | null;
34
+ readonly text: string;
35
+ }
36
+ interface Rendered {
37
+ readonly html: string;
38
+ /** The first `# heading`, if the page has one. */
39
+ readonly title: string | null;
40
+ readonly toc: readonly TocEntry[];
41
+ readonly sections: readonly Section[];
42
+ /** Whether the page has a `mermaid` block, so the page loads Mermaid. */
43
+ readonly mermaid: boolean;
44
+ readonly frontmatter: Frontmatter;
45
+ }
46
+ /** The `key: value` lines between `---` fences at the top of a page. */
47
+ type Frontmatter = Readonly<Record<string, string>>;
48
+ export declare const renderMarkdown: (source: string) => Promise<Rendered>;
49
+ /** spacefn's own docs, as installed. */
50
+ export declare const contentDir: string;
51
+ /** The installed version, which matches the spacefn it documents. */
52
+ export declare const version: string;
53
+ /** spacefn's docs. */
54
+ export declare const spacefnSource: (prefix: string) => DocsSource;
55
+ export interface AppDocsOptions {
56
+ /** The app root: its `docs/` folder is served first, spacefn's docs under `spacefn/`. */
57
+ readonly root: string;
58
+ /** Where the reader is served, e.g. `/` or `/__space/docs/`. */
59
+ readonly base: string;
60
+ }
61
+ /** The reader for an app: its own `docs/` (if any) and spacefn's docs. */
62
+ export declare const appDocs: ({ root, base }: AppDocsOptions) => Reader;
63
+ export interface ServeOptions extends Omit<AppDocsOptions, "base"> {
64
+ readonly port?: number;
65
+ readonly host?: string;
66
+ }
67
+ /** `space docs`: the app's reader on its own server. */
68
+ export declare const serve: ({ root, port, host }: ServeOptions) => Promise<{
69
+ url: string;
70
+ close: () => Promise<void>;
71
+ }>;
72
+ export type { DocsSource, Reader, ReaderOptions, Rendered, TocEntry };