contentbase 0.4.0 → 0.4.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 (322) hide show
  1. package/dist/adapters/node-fs.d.ts +17 -0
  2. package/dist/adapters/node-fs.d.ts.map +1 -0
  3. package/dist/adapters/node-fs.js +71 -0
  4. package/dist/adapters/node-fs.js.map +1 -0
  5. package/dist/ast-query.d.ts +44 -0
  6. package/dist/ast-query.d.ts.map +1 -0
  7. package/dist/ast-query.js +95 -0
  8. package/dist/ast-query.js.map +1 -0
  9. package/dist/base-model.d.ts +8 -0
  10. package/dist/base-model.d.ts.map +1 -0
  11. package/dist/base-model.js +12 -0
  12. package/dist/base-model.js.map +1 -0
  13. package/dist/cli/commands/action.d.ts +2 -0
  14. package/dist/cli/commands/action.d.ts.map +1 -0
  15. package/dist/cli/commands/action.js +73 -0
  16. package/dist/cli/commands/action.js.map +1 -0
  17. package/dist/cli/commands/api/endpoints/actions.d.ts +13 -0
  18. package/dist/cli/commands/api/endpoints/actions.d.ts.map +1 -0
  19. package/dist/cli/commands/api/endpoints/actions.js +28 -0
  20. package/dist/cli/commands/api/endpoints/actions.js.map +1 -0
  21. package/dist/cli/commands/api/endpoints/doc.d.ts +5 -0
  22. package/dist/cli/commands/api/endpoints/doc.d.ts.map +1 -0
  23. package/dist/cli/commands/api/endpoints/doc.js +186 -0
  24. package/dist/cli/commands/api/endpoints/doc.js.map +1 -0
  25. package/dist/cli/commands/api/endpoints/docs-index.d.ts +8 -0
  26. package/dist/cli/commands/api/endpoints/docs-index.d.ts.map +1 -0
  27. package/dist/cli/commands/api/endpoints/docs-index.js +23 -0
  28. package/dist/cli/commands/api/endpoints/docs-index.js.map +1 -0
  29. package/dist/cli/commands/api/endpoints/document.d.ts +47 -0
  30. package/dist/cli/commands/api/endpoints/document.d.ts.map +1 -0
  31. package/dist/cli/commands/api/endpoints/document.js +146 -0
  32. package/dist/cli/commands/api/endpoints/document.js.map +1 -0
  33. package/dist/cli/commands/api/endpoints/documents.d.ts +35 -0
  34. package/dist/cli/commands/api/endpoints/documents.d.ts.map +1 -0
  35. package/dist/cli/commands/api/endpoints/documents.js +56 -0
  36. package/dist/cli/commands/api/endpoints/documents.js.map +1 -0
  37. package/dist/cli/commands/api/endpoints/index.d.ts +22 -0
  38. package/dist/cli/commands/api/endpoints/index.d.ts.map +1 -0
  39. package/dist/cli/commands/api/endpoints/index.js +38 -0
  40. package/dist/cli/commands/api/endpoints/index.js.map +1 -0
  41. package/dist/cli/commands/api/endpoints/inspect.d.ts +10 -0
  42. package/dist/cli/commands/api/endpoints/inspect.d.ts.map +1 -0
  43. package/dist/cli/commands/api/endpoints/inspect.js +15 -0
  44. package/dist/cli/commands/api/endpoints/inspect.js.map +1 -0
  45. package/dist/cli/commands/api/endpoints/models.d.ts +5 -0
  46. package/dist/cli/commands/api/endpoints/models.d.ts.map +1 -0
  47. package/dist/cli/commands/api/endpoints/models.js +9 -0
  48. package/dist/cli/commands/api/endpoints/models.js.map +1 -0
  49. package/dist/cli/commands/api/endpoints/query.d.ts +40 -0
  50. package/dist/cli/commands/api/endpoints/query.d.ts.map +1 -0
  51. package/dist/cli/commands/api/endpoints/query.js +106 -0
  52. package/dist/cli/commands/api/endpoints/query.js.map +1 -0
  53. package/dist/cli/commands/api/endpoints/root.d.ts +5 -0
  54. package/dist/cli/commands/api/endpoints/root.d.ts.map +1 -0
  55. package/dist/cli/commands/api/endpoints/root.js +7 -0
  56. package/dist/cli/commands/api/endpoints/root.js.map +1 -0
  57. package/dist/cli/commands/api/endpoints/search-reindex.d.ts +10 -0
  58. package/dist/cli/commands/api/endpoints/search-reindex.d.ts.map +1 -0
  59. package/dist/cli/commands/api/endpoints/search-reindex.js +38 -0
  60. package/dist/cli/commands/api/endpoints/search-reindex.js.map +1 -0
  61. package/dist/cli/commands/api/endpoints/search-status.d.ts +7 -0
  62. package/dist/cli/commands/api/endpoints/search-status.d.ts.map +1 -0
  63. package/dist/cli/commands/api/endpoints/search-status.js +33 -0
  64. package/dist/cli/commands/api/endpoints/search-status.js.map +1 -0
  65. package/dist/cli/commands/api/endpoints/search.d.ts +24 -0
  66. package/dist/cli/commands/api/endpoints/search.d.ts.map +1 -0
  67. package/dist/cli/commands/api/endpoints/search.js +61 -0
  68. package/dist/cli/commands/api/endpoints/search.js.map +1 -0
  69. package/dist/cli/commands/api/endpoints/semantic-search.d.ts +28 -0
  70. package/dist/cli/commands/api/endpoints/semantic-search.d.ts.map +1 -0
  71. package/dist/cli/commands/api/endpoints/semantic-search.js +76 -0
  72. package/dist/cli/commands/api/endpoints/semantic-search.js.map +1 -0
  73. package/dist/cli/commands/api/endpoints/text-search.d.ts +17 -0
  74. package/dist/cli/commands/api/endpoints/text-search.d.ts.map +1 -0
  75. package/dist/cli/commands/api/endpoints/text-search.js +55 -0
  76. package/dist/cli/commands/api/endpoints/text-search.js.map +1 -0
  77. package/dist/cli/commands/api/endpoints/validate.d.ts +12 -0
  78. package/dist/cli/commands/api/endpoints/validate.d.ts.map +1 -0
  79. package/dist/cli/commands/api/endpoints/validate.js +27 -0
  80. package/dist/cli/commands/api/endpoints/validate.js.map +1 -0
  81. package/dist/cli/commands/api/helpers.d.ts +8 -0
  82. package/dist/cli/commands/api/helpers.d.ts.map +1 -0
  83. package/dist/cli/commands/api/helpers.js +89 -0
  84. package/dist/cli/commands/api/helpers.js.map +1 -0
  85. package/dist/cli/commands/console.d.ts +2 -0
  86. package/dist/cli/commands/console.d.ts.map +1 -0
  87. package/dist/cli/commands/console.js +117 -0
  88. package/dist/cli/commands/console.js.map +1 -0
  89. package/dist/cli/commands/create.d.ts +2 -0
  90. package/dist/cli/commands/create.d.ts.map +1 -0
  91. package/dist/cli/commands/create.js +185 -0
  92. package/dist/cli/commands/create.js.map +1 -0
  93. package/dist/cli/commands/embed.d.ts +2 -0
  94. package/dist/cli/commands/embed.d.ts.map +1 -0
  95. package/dist/cli/commands/embed.js +231 -0
  96. package/dist/cli/commands/embed.js.map +1 -0
  97. package/dist/cli/commands/export.d.ts +2 -0
  98. package/dist/cli/commands/export.d.ts.map +1 -0
  99. package/dist/cli/commands/export.js +55 -0
  100. package/dist/cli/commands/export.js.map +1 -0
  101. package/dist/cli/commands/extract.d.ts +2 -0
  102. package/dist/cli/commands/extract.d.ts.map +1 -0
  103. package/dist/cli/commands/extract.js +149 -0
  104. package/dist/cli/commands/extract.js.map +1 -0
  105. package/dist/cli/commands/help.d.ts +2 -0
  106. package/dist/cli/commands/help.d.ts.map +1 -0
  107. package/dist/cli/commands/help.js +58 -0
  108. package/dist/cli/commands/help.js.map +1 -0
  109. package/dist/cli/commands/index.d.ts +18 -0
  110. package/dist/cli/commands/index.d.ts.map +1 -0
  111. package/dist/cli/commands/index.js +19 -0
  112. package/dist/cli/commands/index.js.map +1 -0
  113. package/dist/cli/commands/init.d.ts +2 -0
  114. package/dist/cli/commands/init.d.ts.map +1 -0
  115. package/dist/cli/commands/init.js +82 -0
  116. package/dist/cli/commands/init.js.map +1 -0
  117. package/dist/cli/commands/inspect.d.ts +2 -0
  118. package/dist/cli/commands/inspect.d.ts.map +1 -0
  119. package/dist/cli/commands/inspect.js +53 -0
  120. package/dist/cli/commands/inspect.js.map +1 -0
  121. package/dist/cli/commands/mcp.d.ts +2 -0
  122. package/dist/cli/commands/mcp.d.ts.map +1 -0
  123. package/dist/cli/commands/mcp.js +92 -0
  124. package/dist/cli/commands/mcp.js.map +1 -0
  125. package/dist/cli/commands/search.d.ts +2 -0
  126. package/dist/cli/commands/search.d.ts.map +1 -0
  127. package/dist/cli/commands/search.js +212 -0
  128. package/dist/cli/commands/search.js.map +1 -0
  129. package/dist/cli/commands/serve.d.ts +2 -0
  130. package/dist/cli/commands/serve.d.ts.map +1 -0
  131. package/dist/cli/commands/serve.js +298 -0
  132. package/dist/cli/commands/serve.js.map +1 -0
  133. package/dist/cli/commands/summary.d.ts +2 -0
  134. package/dist/cli/commands/summary.d.ts.map +1 -0
  135. package/dist/cli/commands/summary.js +58 -0
  136. package/dist/cli/commands/summary.js.map +1 -0
  137. package/dist/cli/commands/teach.d.ts +2 -0
  138. package/dist/cli/commands/teach.d.ts.map +1 -0
  139. package/dist/cli/commands/teach.js +80 -0
  140. package/dist/cli/commands/teach.js.map +1 -0
  141. package/dist/cli/commands/text-search.d.ts +2 -0
  142. package/dist/cli/commands/text-search.d.ts.map +1 -0
  143. package/dist/cli/commands/text-search.js +125 -0
  144. package/dist/cli/commands/text-search.js.map +1 -0
  145. package/dist/cli/commands/update.d.ts +2 -0
  146. package/dist/cli/commands/update.d.ts.map +1 -0
  147. package/dist/cli/commands/update.js +167 -0
  148. package/dist/cli/commands/update.js.map +1 -0
  149. package/dist/cli/commands/validate.d.ts +2 -0
  150. package/dist/cli/commands/validate.d.ts.map +1 -0
  151. package/dist/cli/commands/validate.js +129 -0
  152. package/dist/cli/commands/validate.js.map +1 -0
  153. package/dist/cli/index.d.ts +3 -0
  154. package/dist/cli/index.d.ts.map +1 -0
  155. package/dist/cli/index.js +84 -0
  156. package/dist/cli/index.js.map +1 -0
  157. package/dist/cli/load-collection.d.ts +7 -0
  158. package/dist/cli/load-collection.d.ts.map +1 -0
  159. package/dist/cli/load-collection.js +201 -0
  160. package/dist/cli/load-collection.js.map +1 -0
  161. package/dist/cli/registry.d.ts +17 -0
  162. package/dist/cli/registry.d.ts.map +1 -0
  163. package/dist/cli/registry.js +16 -0
  164. package/dist/cli/registry.js.map +1 -0
  165. package/dist/cnotes +0 -0
  166. package/dist/collection.d.ts +145 -0
  167. package/dist/collection.d.ts.map +1 -0
  168. package/dist/collection.js +684 -0
  169. package/dist/collection.js.map +1 -0
  170. package/dist/define-model.d.ts +45 -0
  171. package/dist/define-model.d.ts.map +1 -0
  172. package/dist/define-model.js +106 -0
  173. package/dist/define-model.js.map +1 -0
  174. package/dist/document.d.ts +119 -0
  175. package/dist/document.d.ts.map +1 -0
  176. package/dist/document.js +418 -0
  177. package/dist/document.js.map +1 -0
  178. package/dist/extract-sections.d.ts +46 -0
  179. package/dist/extract-sections.d.ts.map +1 -0
  180. package/dist/extract-sections.js +153 -0
  181. package/dist/extract-sections.js.map +1 -0
  182. package/dist/index.d.ts +28 -0
  183. package/dist/index.d.ts.map +1 -0
  184. package/dist/index.js +31 -0
  185. package/dist/index.js.map +1 -0
  186. package/dist/mcp/helpers.d.ts +14 -0
  187. package/dist/mcp/helpers.d.ts.map +1 -0
  188. package/dist/mcp/helpers.js +7 -0
  189. package/dist/mcp/helpers.js.map +1 -0
  190. package/dist/mcp/model-info.d.ts +2 -0
  191. package/dist/mcp/model-info.d.ts.map +1 -0
  192. package/dist/mcp/model-info.js +94 -0
  193. package/dist/mcp/model-info.js.map +1 -0
  194. package/dist/mcp/prompts.d.ts +2 -0
  195. package/dist/mcp/prompts.d.ts.map +1 -0
  196. package/dist/mcp/prompts.js +180 -0
  197. package/dist/mcp/prompts.js.map +1 -0
  198. package/dist/mcp/readme.d.ts +2 -0
  199. package/dist/mcp/readme.d.ts.map +1 -0
  200. package/dist/mcp/readme.js +71 -0
  201. package/dist/mcp/readme.js.map +1 -0
  202. package/dist/mcp/resources.d.ts +2 -0
  203. package/dist/mcp/resources.d.ts.map +1 -0
  204. package/dist/mcp/resources.js +85 -0
  205. package/dist/mcp/resources.js.map +1 -0
  206. package/dist/mcp/server.d.ts +18 -0
  207. package/dist/mcp/server.d.ts.map +1 -0
  208. package/dist/mcp/server.js +83 -0
  209. package/dist/mcp/server.js.map +1 -0
  210. package/dist/mcp/tools/mutation.d.ts +2 -0
  211. package/dist/mcp/tools/mutation.d.ts.map +1 -0
  212. package/dist/mcp/tools/mutation.js +155 -0
  213. package/dist/mcp/tools/mutation.js.map +1 -0
  214. package/dist/mcp/tools/query.d.ts +2 -0
  215. package/dist/mcp/tools/query.d.ts.map +1 -0
  216. package/dist/mcp/tools/query.js +130 -0
  217. package/dist/mcp/tools/query.js.map +1 -0
  218. package/dist/mcp/tools/search.d.ts +2 -0
  219. package/dist/mcp/tools/search.d.ts.map +1 -0
  220. package/dist/mcp/tools/search.js +168 -0
  221. package/dist/mcp/tools/search.js.map +1 -0
  222. package/dist/model-instance.d.ts +11 -0
  223. package/dist/model-instance.d.ts.map +1 -0
  224. package/dist/model-instance.js +208 -0
  225. package/dist/model-instance.js.map +1 -0
  226. package/dist/node-shortcuts.d.ts +25 -0
  227. package/dist/node-shortcuts.d.ts.map +1 -0
  228. package/dist/node-shortcuts.js +67 -0
  229. package/dist/node-shortcuts.js.map +1 -0
  230. package/dist/parse.d.ts +45 -0
  231. package/dist/parse.d.ts.map +1 -0
  232. package/dist/parse.js +98 -0
  233. package/dist/parse.js.map +1 -0
  234. package/dist/query/collection-query.d.ts +39 -0
  235. package/dist/query/collection-query.d.ts.map +1 -0
  236. package/dist/query/collection-query.js +184 -0
  237. package/dist/query/collection-query.js.map +1 -0
  238. package/dist/query/index.d.ts +8 -0
  239. package/dist/query/index.d.ts.map +1 -0
  240. package/dist/query/index.js +5 -0
  241. package/dist/query/index.js.map +1 -0
  242. package/dist/query/operators.d.ts +3 -0
  243. package/dist/query/operators.d.ts.map +1 -0
  244. package/dist/query/operators.js +18 -0
  245. package/dist/query/operators.js.map +1 -0
  246. package/dist/query/query-builder.d.ts +34 -0
  247. package/dist/query/query-builder.d.ts.map +1 -0
  248. package/dist/query/query-builder.js +84 -0
  249. package/dist/query/query-builder.js.map +1 -0
  250. package/dist/query/query-dsl.d.ts +36 -0
  251. package/dist/query/query-dsl.d.ts.map +1 -0
  252. package/dist/query/query-dsl.js +195 -0
  253. package/dist/query/query-dsl.js.map +1 -0
  254. package/dist/relationships/belongs-to.d.ts +9 -0
  255. package/dist/relationships/belongs-to.d.ts.map +1 -0
  256. package/dist/relationships/belongs-to.js +34 -0
  257. package/dist/relationships/belongs-to.js.map +1 -0
  258. package/dist/relationships/has-many.d.ts +23 -0
  259. package/dist/relationships/has-many.d.ts.map +1 -0
  260. package/dist/relationships/has-many.js +136 -0
  261. package/dist/relationships/has-many.js.map +1 -0
  262. package/dist/relationships/index.d.ts +26 -0
  263. package/dist/relationships/index.d.ts.map +1 -0
  264. package/dist/relationships/index.js +32 -0
  265. package/dist/relationships/index.js.map +1 -0
  266. package/dist/relationships/types.d.ts +2 -0
  267. package/dist/relationships/types.d.ts.map +1 -0
  268. package/dist/relationships/types.js +2 -0
  269. package/dist/relationships/types.js.map +1 -0
  270. package/dist/search/document-inputs.d.ts +30 -0
  271. package/dist/search/document-inputs.d.ts.map +1 -0
  272. package/dist/search/document-inputs.js +52 -0
  273. package/dist/search/document-inputs.js.map +1 -0
  274. package/dist/search/luca-semantic-search.d.ts +27 -0
  275. package/dist/search/luca-semantic-search.d.ts.map +1 -0
  276. package/dist/search/luca-semantic-search.js +56 -0
  277. package/dist/search/luca-semantic-search.js.map +1 -0
  278. package/dist/section.d.ts +21 -0
  279. package/dist/section.d.ts.map +1 -0
  280. package/dist/section.js +21 -0
  281. package/dist/section.js.map +1 -0
  282. package/dist/types.d.ts +185 -0
  283. package/dist/types.d.ts.map +1 -0
  284. package/dist/types.js +2 -0
  285. package/dist/types.js.map +1 -0
  286. package/dist/utils/index.d.ts +9 -0
  287. package/dist/utils/index.d.ts.map +1 -0
  288. package/dist/utils/index.js +8 -0
  289. package/dist/utils/index.js.map +1 -0
  290. package/dist/utils/inflect.d.ts +6 -0
  291. package/dist/utils/inflect.d.ts.map +1 -0
  292. package/dist/utils/inflect.js +75 -0
  293. package/dist/utils/inflect.js.map +1 -0
  294. package/dist/utils/match-pattern.d.ts +25 -0
  295. package/dist/utils/match-pattern.d.ts.map +1 -0
  296. package/dist/utils/match-pattern.js +52 -0
  297. package/dist/utils/match-pattern.js.map +1 -0
  298. package/dist/utils/normalize-headings.d.ts +8 -0
  299. package/dist/utils/normalize-headings.d.ts.map +1 -0
  300. package/dist/utils/normalize-headings.js +19 -0
  301. package/dist/utils/normalize-headings.js.map +1 -0
  302. package/dist/utils/parse-table.d.ts +7 -0
  303. package/dist/utils/parse-table.d.ts.map +1 -0
  304. package/dist/utils/parse-table.js +17 -0
  305. package/dist/utils/parse-table.js.map +1 -0
  306. package/dist/utils/read-directory.d.ts +5 -0
  307. package/dist/utils/read-directory.d.ts.map +1 -0
  308. package/dist/utils/read-directory.js +29 -0
  309. package/dist/utils/read-directory.js.map +1 -0
  310. package/dist/utils/stringify-ast.d.ts +6 -0
  311. package/dist/utils/stringify-ast.d.ts.map +1 -0
  312. package/dist/utils/stringify-ast.js +8 -0
  313. package/dist/utils/stringify-ast.js.map +1 -0
  314. package/dist/utils/strip-markdown.d.ts +11 -0
  315. package/dist/utils/strip-markdown.d.ts.map +1 -0
  316. package/dist/utils/strip-markdown.js +48 -0
  317. package/dist/utils/strip-markdown.js.map +1 -0
  318. package/dist/validator.d.ts +10 -0
  319. package/dist/validator.d.ts.map +1 -0
  320. package/dist/validator.js +55 -0
  321. package/dist/validator.js.map +1 -0
  322. package/package.json +1 -1
@@ -0,0 +1,208 @@
1
+ import { HasManyRelationship } from "./relationships/has-many";
2
+ import { BelongsToRelationship } from "./relationships/belongs-to";
3
+ import { matchPatterns } from "./utils/match-pattern";
4
+ /**
5
+ * Creates a model instance from a document and its model definition.
6
+ *
7
+ * This is the central factory function. Every typed model instance
8
+ * in contentbase is created here.
9
+ */
10
+ export function createModelInstance(document, definition, collection) {
11
+ // ─── Meta: merge defaults, pattern-inferred values, then frontmatter ───
12
+ const patternMeta = definition.pattern
13
+ ? matchPatterns(definition.pattern, document.id) ?? {}
14
+ : {};
15
+ const rawMeta = { ...(definition.defaults ?? {}), ...patternMeta, ...document.meta };
16
+ let meta;
17
+ try {
18
+ meta = definition.meta.parse(rawMeta);
19
+ }
20
+ catch (e) {
21
+ // If parsing fails, use raw meta so the instance can still be created
22
+ // Validation will catch the errors later
23
+ meta = rawMeta;
24
+ }
25
+ // ─── Sections: lazy extraction via defineProperty ───
26
+ const sections = {};
27
+ if (definition.sections) {
28
+ for (const [key, sectionDef] of Object.entries(definition.sections)) {
29
+ const sd = sectionDef;
30
+ let cached = null;
31
+ Object.defineProperty(sections, key, {
32
+ get() {
33
+ if (!cached) {
34
+ let heading = sd.heading;
35
+ if (sd.alternatives?.length) {
36
+ const found = document.astQuery.findHeadingByText(heading);
37
+ if (!found) {
38
+ for (const alt of sd.alternatives) {
39
+ if (document.astQuery.findHeadingByText(alt)) {
40
+ heading = alt;
41
+ break;
42
+ }
43
+ }
44
+ }
45
+ }
46
+ const sectionQuery = document.querySection(heading);
47
+ cached = { value: sd.extract(sectionQuery) };
48
+ }
49
+ return cached.value;
50
+ },
51
+ enumerable: true,
52
+ configurable: true,
53
+ });
54
+ }
55
+ }
56
+ // ─── Relationships: create accessor objects ───
57
+ const relationships = {};
58
+ if (definition.relationships) {
59
+ for (const [key, relDef] of Object.entries(definition.relationships)) {
60
+ if (relDef.type === "hasMany") {
61
+ const hm = relDef;
62
+ relationships[key] = new HasManyRelationship(document, collection, hm, createModelInstance);
63
+ }
64
+ else if (relDef.type === "belongsTo") {
65
+ const bt = relDef;
66
+ relationships[key] = new BelongsToRelationship(document, collection, bt, createModelInstance, definition);
67
+ }
68
+ }
69
+ }
70
+ // ─── Computed: lazy getters ───
71
+ const computed = {};
72
+ const selfProxy = {
73
+ meta,
74
+ sections,
75
+ relationships,
76
+ document,
77
+ id: document.id,
78
+ title: document.title,
79
+ slug: document.slug,
80
+ };
81
+ if (definition.computed) {
82
+ for (const [key, fn] of Object.entries(definition.computed)) {
83
+ Object.defineProperty(computed, key, {
84
+ get() {
85
+ return fn(selfProxy);
86
+ },
87
+ enumerable: true,
88
+ configurable: true,
89
+ });
90
+ }
91
+ }
92
+ // ─── Validation ───
93
+ const errors = new Map();
94
+ async function validate() {
95
+ errors.clear();
96
+ // Validate meta
97
+ const metaResult = definition.meta.safeParse(rawMeta);
98
+ if (!metaResult.success) {
99
+ for (const issue of metaResult.error.issues) {
100
+ errors.set(issue.path.join(".") || "meta", issue);
101
+ }
102
+ }
103
+ // Validate sections that have schemas
104
+ if (definition.sections) {
105
+ for (const [key, sd] of Object.entries(definition.sections)) {
106
+ const sectionDef = sd;
107
+ if (sectionDef.schema) {
108
+ const sectionData = sections[key];
109
+ const sResult = sectionDef.schema.safeParse(sectionData);
110
+ if (!sResult.success) {
111
+ for (const issue of sResult.error.issues) {
112
+ errors.set(`sections.${key}.${issue.path.join(".")}`, issue);
113
+ }
114
+ }
115
+ }
116
+ }
117
+ }
118
+ return {
119
+ valid: errors.size === 0,
120
+ errors: Array.from(errors.values()),
121
+ };
122
+ }
123
+ // ─── toJSON ───
124
+ function toJSON(options = {}) {
125
+ const json = {
126
+ id: document.id,
127
+ title: document.title,
128
+ meta,
129
+ createdAt: document.createdAt,
130
+ updatedAt: document.updatedAt,
131
+ size: document.size,
132
+ };
133
+ // Include requested sections
134
+ if (options.sections) {
135
+ for (const key of options.sections) {
136
+ if (key in sections) {
137
+ json[key] = sections[key];
138
+ }
139
+ }
140
+ }
141
+ // Include requested computed values
142
+ if (options.computed) {
143
+ for (const key of options.computed) {
144
+ if (key in computed) {
145
+ json[key] = computed[key];
146
+ }
147
+ }
148
+ }
149
+ // Include requested relationships
150
+ if (options.related) {
151
+ for (const key of options.related) {
152
+ const rel = relationships[key];
153
+ if (!rel)
154
+ continue;
155
+ if ("fetchAll" in rel) {
156
+ json[key] = rel.fetchAll().map((inst) => inst.toJSON());
157
+ }
158
+ else if ("fetch" in rel) {
159
+ json[key] = rel.fetch().toJSON();
160
+ }
161
+ }
162
+ }
163
+ return json;
164
+ }
165
+ // ─── Assemble the instance ───
166
+ const instance = {
167
+ id: document.id,
168
+ get title() {
169
+ return document.title;
170
+ },
171
+ get slug() {
172
+ return document.slug;
173
+ },
174
+ get createdAt() {
175
+ return document.createdAt;
176
+ },
177
+ get updatedAt() {
178
+ return document.updatedAt;
179
+ },
180
+ get size() {
181
+ return document.size;
182
+ },
183
+ meta,
184
+ sections,
185
+ relationships,
186
+ computed,
187
+ errors,
188
+ get hasErrors() {
189
+ return errors.size > 0;
190
+ },
191
+ validate,
192
+ toJSON,
193
+ async runAction(name, opts = {}) {
194
+ const actionFn = collection.actions.get(name);
195
+ if (!actionFn)
196
+ throw new Error(`Action "${name}" not found`);
197
+ return actionFn(collection, instance, opts);
198
+ },
199
+ async save(opts = {}) {
200
+ await document.save(opts);
201
+ },
202
+ };
203
+ // Keep heavy back-references accessible but out of REPL output
204
+ Object.defineProperty(instance, "document", { value: document, enumerable: false });
205
+ Object.defineProperty(instance, "collection", { value: collection, enumerable: false });
206
+ return instance;
207
+ }
208
+ //# sourceMappingURL=model-instance.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"model-instance.js","sourceRoot":"","sources":["../src/model-instance.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,25 @@
1
+ import type { AstQuery } from "./ast-query";
2
+ import type { Content, Heading } from "mdast";
3
+ /**
4
+ * Convenience getters for common node queries on a document.
5
+ */
6
+ export declare class NodeShortcuts {
7
+ #private;
8
+ constructor(astQuery: AstQuery);
9
+ get first(): Content | undefined;
10
+ get last(): Content | undefined;
11
+ get headings(): Heading[];
12
+ get firstHeading(): Heading | undefined;
13
+ get secondHeading(): Heading | undefined;
14
+ get lastHeading(): Heading | undefined;
15
+ get leadingElementsAfterTitle(): Content[];
16
+ get headingsByDepth(): Record<number, Heading[]>;
17
+ get links(): Content[];
18
+ get tables(): Content[];
19
+ get tablesAsData(): Record<string, string>[][];
20
+ get paragraphs(): Content[];
21
+ get lists(): Content[];
22
+ get codeBlocks(): Content[];
23
+ get images(): Content[];
24
+ }
25
+ //# sourceMappingURL=node-shortcuts.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node-shortcuts.d.ts","sourceRoot":"","sources":["../src/node-shortcuts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAE9C;;GAEG;AACH,qBAAa,aAAa;;gBAGZ,QAAQ,EAAE,QAAQ;IAI9B,IAAI,KAAK,IAAI,OAAO,GAAG,SAAS,CAE/B;IAED,IAAI,IAAI,IAAI,OAAO,GAAG,SAAS,CAG9B;IAED,IAAI,QAAQ,IAAI,OAAO,EAAE,CAExB;IAED,IAAI,YAAY,IAAI,OAAO,GAAG,SAAS,CAEtC;IAED,IAAI,aAAa,IAAI,OAAO,GAAG,SAAS,CAEvC;IAED,IAAI,WAAW,IAAI,OAAO,GAAG,SAAS,CAErC;IAED,IAAI,yBAAyB,IAAI,OAAO,EAAE,CAOzC;IAED,IAAI,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAS/C;IAED,IAAI,KAAK,IAAI,OAAO,EAAE,CAErB;IAED,IAAI,MAAM,IAAI,OAAO,EAAE,CAEtB;IAED,IAAI,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,CAE7C;IAED,IAAI,UAAU,IAAI,OAAO,EAAE,CAE1B;IAED,IAAI,KAAK,IAAI,OAAO,EAAE,CAErB;IAED,IAAI,UAAU,IAAI,OAAO,EAAE,CAE1B;IAED,IAAI,MAAM,IAAI,OAAO,EAAE,CAEtB;CACF"}
@@ -0,0 +1,67 @@
1
+ import { parseTable } from "./utils/parse-table";
2
+ /**
3
+ * Convenience getters for common node queries on a document.
4
+ */
5
+ export class NodeShortcuts {
6
+ #astQuery;
7
+ constructor(astQuery) {
8
+ this.#astQuery = astQuery;
9
+ }
10
+ get first() {
11
+ return this.#astQuery.ast.children[0];
12
+ }
13
+ get last() {
14
+ const children = this.#astQuery.ast.children;
15
+ return children[children.length - 1];
16
+ }
17
+ get headings() {
18
+ return this.#astQuery.selectAll("heading");
19
+ }
20
+ get firstHeading() {
21
+ return this.headings[0];
22
+ }
23
+ get secondHeading() {
24
+ return this.headings[1];
25
+ }
26
+ get lastHeading() {
27
+ return this.headings[this.headings.length - 1];
28
+ }
29
+ get leadingElementsAfterTitle() {
30
+ const { firstHeading, secondHeading } = this;
31
+ if (!firstHeading)
32
+ return [];
33
+ if (secondHeading) {
34
+ return this.#astQuery.findBetween(firstHeading, secondHeading);
35
+ }
36
+ return this.#astQuery.findAllAfter(firstHeading);
37
+ }
38
+ get headingsByDepth() {
39
+ return this.headings.reduce((memo, heading) => {
40
+ memo[heading.depth] = memo[heading.depth] || [];
41
+ memo[heading.depth].push(heading);
42
+ return memo;
43
+ }, {});
44
+ }
45
+ get links() {
46
+ return this.#astQuery.selectAll("link");
47
+ }
48
+ get tables() {
49
+ return this.#astQuery.selectAll("table");
50
+ }
51
+ get tablesAsData() {
52
+ return this.tables.map((table) => parseTable(table));
53
+ }
54
+ get paragraphs() {
55
+ return this.#astQuery.selectAll("paragraph");
56
+ }
57
+ get lists() {
58
+ return this.#astQuery.selectAll("list");
59
+ }
60
+ get codeBlocks() {
61
+ return this.#astQuery.selectAll("code");
62
+ }
63
+ get images() {
64
+ return this.#astQuery.selectAll("image");
65
+ }
66
+ }
67
+ //# sourceMappingURL=node-shortcuts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node-shortcuts.js","sourceRoot":"","sources":["../src/node-shortcuts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAIjD;;GAEG;AACH,MAAM,OAAO,aAAa;IACxB,SAAS,CAAW;IAEpB,YAAY,QAAkB;QAC5B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAwB,CAAC;IAC/D,CAAC;IAED,IAAI,IAAI;QACN,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC7C,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAwB,CAAC;IAC9D,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,SAAS,CAAc,CAAC;IAC1D,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,yBAAyB;QAC3B,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;QAC7C,IAAI,CAAC,YAAY;YAAE,OAAO,EAAE,CAAC;QAC7B,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CACzB,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;YAChB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAChD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC,EACD,EAA+B,CAChC,CAAC;IACJ,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;CACF"}
@@ -0,0 +1,45 @@
1
+ import { AstQuery } from "./ast-query";
2
+ import { NodeShortcuts } from "./node-shortcuts";
3
+ import type { StripMarkdownOptions } from "./utils/strip-markdown";
4
+ import type { Root, Content } from "mdast";
5
+ export interface ParsedDocument {
6
+ /** YAML frontmatter key/values */
7
+ meta: Record<string, unknown>;
8
+ /** Markdown content (without frontmatter) */
9
+ content: string;
10
+ /** The MDAST root node */
11
+ ast: Root;
12
+ /** Queryable AST wrapper */
13
+ astQuery: AstQuery;
14
+ /** Convenience node accessors */
15
+ nodes: NodeShortcuts;
16
+ /** First heading text, or empty string */
17
+ title: string;
18
+ /** Stringify an AST back to markdown */
19
+ stringify(ast?: Root): string;
20
+ /** Strip markdown syntax, returning plain text */
21
+ stripMarkdown(options?: StripMarkdownOptions): string;
22
+ /** Extract a section by heading text */
23
+ extractSection(heading: string | Content): Content[];
24
+ /** Get a queryable AstQuery scoped to a section */
25
+ querySection(heading: string | Content): AstQuery;
26
+ }
27
+ /**
28
+ * Parse a markdown/MDX file or raw string into a queryable document.
29
+ *
30
+ * @param input - A file path (.md/.mdx) or raw markdown string
31
+ * @returns A ParsedDocument with AST query capabilities
32
+ *
33
+ * @example
34
+ * ```ts
35
+ * import { parse } from "contentbase";
36
+ *
37
+ * const doc = await parse("./content/my-post.mdx");
38
+ * doc.meta // frontmatter
39
+ * doc.astQuery.selectAll("heading")
40
+ * doc.nodes.tables
41
+ * doc.querySection("Introduction").selectAll("paragraph")
42
+ * ```
43
+ */
44
+ export declare function parse(input: string): Promise<ParsedDocument>;
45
+ //# sourceMappingURL=parse.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAe,MAAM,OAAO,CAAC;AAIxD,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,GAAG,EAAE,IAAI,CAAC;IACV,4BAA4B;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB,iCAAiC;IACjC,KAAK,EAAE,aAAa,CAAC;IACrB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC9B,kDAAkD;IAClD,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAAC;IACtD,wCAAwC;IACxC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,CAAC;IACrD,mDAAmD;IACnD,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;CACnD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA8DlE"}
package/dist/parse.js ADDED
@@ -0,0 +1,98 @@
1
+ import fs from "fs/promises";
2
+ import matter from "gray-matter";
3
+ import { unified } from "unified";
4
+ import remarkParse from "remark-parse";
5
+ import remarkGfm from "remark-gfm";
6
+ import { toString } from "mdast-util-to-string";
7
+ import { AstQuery } from "./ast-query";
8
+ import { NodeShortcuts } from "./node-shortcuts";
9
+ import { stringifyAst } from "./utils/stringify-ast";
10
+ import { stripMarkdown } from "./utils/strip-markdown";
11
+ const processor = unified().use(remarkParse).use(remarkGfm);
12
+ /**
13
+ * Parse a markdown/MDX file or raw string into a queryable document.
14
+ *
15
+ * @param input - A file path (.md/.mdx) or raw markdown string
16
+ * @returns A ParsedDocument with AST query capabilities
17
+ *
18
+ * @example
19
+ * ```ts
20
+ * import { parse } from "contentbase";
21
+ *
22
+ * const doc = await parse("./content/my-post.mdx");
23
+ * doc.meta // frontmatter
24
+ * doc.astQuery.selectAll("heading")
25
+ * doc.nodes.tables
26
+ * doc.querySection("Introduction").selectAll("paragraph")
27
+ * ```
28
+ */
29
+ export async function parse(input) {
30
+ let raw;
31
+ if (looksLikeFilePath(input)) {
32
+ raw = await fs.readFile(input, "utf-8");
33
+ }
34
+ else {
35
+ raw = input;
36
+ }
37
+ const { data: meta, content } = matter(raw);
38
+ const ast = processor.parse(content);
39
+ const astQuery = new AstQuery(ast);
40
+ const nodes = new NodeShortcuts(astQuery);
41
+ const firstHeading = astQuery.select("heading");
42
+ const title = firstHeading ? toString(firstHeading) : "";
43
+ function extractSection(startHeading) {
44
+ let heading;
45
+ if (typeof startHeading === "string") {
46
+ heading = astQuery.findHeadingByText(startHeading);
47
+ }
48
+ else {
49
+ heading = startHeading;
50
+ }
51
+ if (!heading) {
52
+ throw new Error(`Heading not found: ${typeof startHeading === "string" ? startHeading : toString(startHeading)}`);
53
+ }
54
+ const endHeading = astQuery.findNextSiblingHeadingTo(heading);
55
+ const sectionNodes = endHeading
56
+ ? astQuery.findBetween(heading, endHeading)
57
+ : astQuery.findAllAfter(heading);
58
+ return [heading, ...sectionNodes];
59
+ }
60
+ function querySection(startHeading) {
61
+ let children = [];
62
+ try {
63
+ children = extractSection(startHeading).slice(1);
64
+ }
65
+ catch {
66
+ // Section not found: return empty query
67
+ }
68
+ return new AstQuery({
69
+ type: "root",
70
+ children: children,
71
+ });
72
+ }
73
+ return {
74
+ meta,
75
+ content,
76
+ ast,
77
+ astQuery,
78
+ nodes,
79
+ title,
80
+ stringify: (tree = ast) => stringifyAst(tree),
81
+ stripMarkdown: (options) => stripMarkdown(ast, options),
82
+ extractSection,
83
+ querySection,
84
+ };
85
+ }
86
+ function looksLikeFilePath(input) {
87
+ // If it contains a newline, it's raw markdown
88
+ if (input.includes("\n"))
89
+ return false;
90
+ // If it ends with a markdown extension, it's a path
91
+ if (/\.mdx?$/i.test(input))
92
+ return true;
93
+ // If it starts with . or / or ~, treat as path
94
+ if (/^[.\/~]/.test(input))
95
+ return true;
96
+ return false;
97
+ }
98
+ //# sourceMappingURL=parse.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,39 @@
1
+ import type { Collection } from "../collection";
2
+ import type { ModelDefinition, InferModelInstance, SerializeOptions } from "../types";
3
+ export declare class CollectionQuery<TDef extends ModelDefinition<any, any, any, any, any>> {
4
+ #private;
5
+ constructor(collection: Collection, definition: TDef);
6
+ /**
7
+ * Include related models in query results.
8
+ * Named relationships will be eagerly resolved and included in toJSON() output.
9
+ *
10
+ * @example
11
+ * await collection.query(Project).include("plans").fetchAll()
12
+ * await collection.query(Project).include("plans", "goal").fetchAll()
13
+ */
14
+ include(...names: string[]): this;
15
+ /** Returns the serialize options based on include() calls */
16
+ get serializeOptions(): SerializeOptions;
17
+ where(pathOrObject: string | Record<string, unknown>, operatorOrValue?: any, value?: any): this;
18
+ whereIn(path: string, values: unknown[]): this;
19
+ whereNotIn(path: string, values: unknown[]): this;
20
+ whereGt(path: string, value: unknown): this;
21
+ whereLt(path: string, value: unknown): this;
22
+ whereGte(path: string, value: unknown): this;
23
+ whereLte(path: string, value: unknown): this;
24
+ whereContains(path: string, value: string): this;
25
+ whereStartsWith(path: string, value: string): this;
26
+ whereEndsWith(path: string, value: string): this;
27
+ whereRegex(path: string, pattern: RegExp | string): this;
28
+ whereExists(path: string): this;
29
+ whereNotExists(path: string): this;
30
+ scope(name: string): this;
31
+ sort(path: string, direction?: "asc" | "desc"): this;
32
+ limit(n: number): this;
33
+ offset(n: number): this;
34
+ fetchAll(): Promise<InferModelInstance<TDef>[]>;
35
+ first(): Promise<InferModelInstance<TDef> | undefined>;
36
+ last(): Promise<InferModelInstance<TDef> | undefined>;
37
+ count(): Promise<number>;
38
+ }
39
+ //# sourceMappingURL=collection-query.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"collection-query.d.ts","sourceRoot":"","sources":["../../src/query/collection-query.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAkBtF,qBAAa,eAAe,CAC1B,IAAI,SAAS,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;;gBAUzC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI;IAMpD;;;;;;;OAOG;IACH,OAAO,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAKjC,6DAA6D;IAC7D,IAAI,gBAAgB,IAAI,gBAAgB,CAIvC;IAED,KAAK,CACH,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9C,eAAe,CAAC,EAAE,GAAG,EACrB,KAAK,CAAC,EAAE,GAAG,GACV,IAAI;IAKP,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAK9C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAKjD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAK3C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAK3C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAK5C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAK5C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKhD,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKlD,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKhD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKxD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK/B,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKlC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQzB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,KAAK,GAAG,MAAc,GAAG,IAAI;IAK3D,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKtB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKjB,QAAQ,IAAI,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;IAoE/C,KAAK,IAAI,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;IAItD,IAAI,IAAI,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;IAKrD,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;CAG/B"}