@gtkx/codegen 1.0.0-rc.3 → 1.0.0

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 (486) hide show
  1. package/README.md +8 -9
  2. package/dist/analysis/descriptor-render.d.ts +9 -4
  3. package/dist/analysis/descriptor-render.d.ts.map +1 -1
  4. package/dist/analysis/descriptor-render.js +51 -61
  5. package/dist/analysis/descriptor-render.js.map +1 -1
  6. package/dist/analysis/descriptor.d.ts +7 -7
  7. package/dist/analysis/descriptor.d.ts.map +1 -1
  8. package/dist/analysis/descriptor.js +7 -7
  9. package/dist/analysis/descriptor.js.map +1 -1
  10. package/dist/analysis/inheritance.d.ts +1 -2
  11. package/dist/analysis/inheritance.d.ts.map +1 -1
  12. package/dist/analysis/inheritance.js +25 -22
  13. package/dist/analysis/inheritance.js.map +1 -1
  14. package/dist/analysis/nul-terminated-bytes.d.ts +5 -0
  15. package/dist/analysis/nul-terminated-bytes.d.ts.map +1 -0
  16. package/dist/analysis/nul-terminated-bytes.js +18 -0
  17. package/dist/analysis/nul-terminated-bytes.js.map +1 -0
  18. package/dist/analysis/param-capability.d.ts +5 -0
  19. package/dist/analysis/param-capability.d.ts.map +1 -0
  20. package/dist/analysis/param-capability.js +130 -0
  21. package/dist/analysis/param-capability.js.map +1 -0
  22. package/dist/analysis/param-structure.d.ts +13 -6
  23. package/dist/analysis/param-structure.d.ts.map +1 -1
  24. package/dist/analysis/param-structure.js +44 -20
  25. package/dist/analysis/param-structure.js.map +1 -1
  26. package/dist/analysis/ts-type.d.ts +1 -1
  27. package/dist/analysis/ts-type.d.ts.map +1 -1
  28. package/dist/analysis/ts-type.js +3 -5
  29. package/dist/analysis/ts-type.js.map +1 -1
  30. package/dist/analysis/type-shape.d.ts +8 -0
  31. package/dist/analysis/type-shape.d.ts.map +1 -0
  32. package/dist/analysis/type-shape.js +12 -0
  33. package/dist/analysis/type-shape.js.map +1 -0
  34. package/dist/compile.d.ts +1 -1
  35. package/dist/compile.d.ts.map +1 -1
  36. package/dist/compile.js +2 -1
  37. package/dist/compile.js.map +1 -1
  38. package/dist/docs/api-reference.d.ts +79 -3
  39. package/dist/docs/api-reference.d.ts.map +1 -1
  40. package/dist/docs/api-reference.js +68 -13
  41. package/dist/docs/api-reference.js.map +1 -1
  42. package/dist/docs/element-page.d.ts +4 -4
  43. package/dist/docs/element-page.d.ts.map +1 -1
  44. package/dist/docs/element-page.js +32 -20
  45. package/dist/docs/element-page.js.map +1 -1
  46. package/dist/docs/handwritten-props.d.ts +9 -0
  47. package/dist/docs/handwritten-props.d.ts.map +1 -0
  48. package/dist/docs/handwritten-props.js +149 -0
  49. package/dist/docs/handwritten-props.js.map +1 -0
  50. package/dist/docs/pipeline.d.ts +4 -4
  51. package/dist/docs/pipeline.d.ts.map +1 -1
  52. package/dist/docs/pipeline.js +6 -6
  53. package/dist/docs/pipeline.js.map +1 -1
  54. package/dist/docs/render.d.ts +25 -5
  55. package/dist/docs/render.d.ts.map +1 -1
  56. package/dist/docs/render.js +90 -28
  57. package/dist/docs/render.js.map +1 -1
  58. package/dist/docs/symbol-page.d.ts +22 -0
  59. package/dist/docs/symbol-page.d.ts.map +1 -1
  60. package/dist/docs/symbol-page.js +129 -44
  61. package/dist/docs/symbol-page.js.map +1 -1
  62. package/dist/fingerprint.d.ts +3 -6
  63. package/dist/fingerprint.d.ts.map +1 -1
  64. package/dist/fingerprint.js +6 -8
  65. package/dist/fingerprint.js.map +1 -1
  66. package/dist/gi.d.ts +3 -11
  67. package/dist/gi.d.ts.map +1 -1
  68. package/dist/gi.js +0 -7
  69. package/dist/gi.js.map +1 -1
  70. package/dist/gir/ancestry.d.ts +2 -2
  71. package/dist/gir/ancestry.d.ts.map +1 -1
  72. package/dist/gir/ancestry.js +11 -1
  73. package/dist/gir/ancestry.js.map +1 -1
  74. package/dist/gir/annotations.d.ts +22 -0
  75. package/dist/gir/annotations.d.ts.map +1 -0
  76. package/dist/gir/annotations.js +15 -0
  77. package/dist/gir/annotations.js.map +1 -0
  78. package/dist/gir/callback.d.ts +1 -0
  79. package/dist/gir/callback.d.ts.map +1 -1
  80. package/dist/gir/callback.js +1 -0
  81. package/dist/gir/callback.js.map +1 -1
  82. package/dist/gir/class.d.ts +32 -1
  83. package/dist/gir/class.d.ts.map +1 -1
  84. package/dist/gir/class.js +8 -3
  85. package/dist/gir/class.js.map +1 -1
  86. package/dist/gir/enum.d.ts +21 -1
  87. package/dist/gir/enum.d.ts.map +1 -1
  88. package/dist/gir/enum.js +9 -9
  89. package/dist/gir/enum.js.map +1 -1
  90. package/dist/gir/field.d.ts +19 -4
  91. package/dist/gir/field.d.ts.map +1 -1
  92. package/dist/gir/field.js +7 -11
  93. package/dist/gir/field.js.map +1 -1
  94. package/dist/gir/function.d.ts +15 -0
  95. package/dist/gir/function.d.ts.map +1 -1
  96. package/dist/gir/function.js.map +1 -1
  97. package/dist/gir/gir-path.d.ts +7 -0
  98. package/dist/gir/gir-path.d.ts.map +1 -1
  99. package/dist/gir/gir-path.js +7 -0
  100. package/dist/gir/gir-path.js.map +1 -1
  101. package/dist/gir/libraries.d.ts +13 -2
  102. package/dist/gir/libraries.d.ts.map +1 -1
  103. package/dist/gir/libraries.js +11 -0
  104. package/dist/gir/libraries.js.map +1 -1
  105. package/dist/gir/library.d.ts +36 -0
  106. package/dist/gir/library.d.ts.map +1 -1
  107. package/dist/gir/library.js +34 -0
  108. package/dist/gir/library.js.map +1 -1
  109. package/dist/gir/namespace.d.ts +38 -0
  110. package/dist/gir/namespace.d.ts.map +1 -1
  111. package/dist/gir/namespace.js +4 -5
  112. package/dist/gir/namespace.js.map +1 -1
  113. package/dist/gir/parameter.d.ts +39 -0
  114. package/dist/gir/parameter.d.ts.map +1 -1
  115. package/dist/gir/parameter.js +7 -7
  116. package/dist/gir/parameter.js.map +1 -1
  117. package/dist/gir/parse.d.ts +3 -1
  118. package/dist/gir/parse.d.ts.map +1 -1
  119. package/dist/gir/parse.js +6 -3
  120. package/dist/gir/parse.js.map +1 -1
  121. package/dist/gir/primitives.d.ts +1 -0
  122. package/dist/gir/primitives.d.ts.map +1 -1
  123. package/dist/gir/primitives.js.map +1 -1
  124. package/dist/gir/property.d.ts +16 -0
  125. package/dist/gir/property.d.ts.map +1 -1
  126. package/dist/gir/property.js +3 -3
  127. package/dist/gir/property.js.map +1 -1
  128. package/dist/gir/record.d.ts +22 -0
  129. package/dist/gir/record.d.ts.map +1 -1
  130. package/dist/gir/record.js +3 -2
  131. package/dist/gir/record.js.map +1 -1
  132. package/dist/gir/size.d.ts +5 -4
  133. package/dist/gir/size.d.ts.map +1 -1
  134. package/dist/gir/size.js +0 -3
  135. package/dist/gir/size.js.map +1 -1
  136. package/dist/gir/type-id.d.ts +36 -1
  137. package/dist/gir/type-id.d.ts.map +1 -1
  138. package/dist/gir/type-id.js +2 -3
  139. package/dist/gir/type-id.js.map +1 -1
  140. package/dist/gir/type-ref.d.ts.map +1 -1
  141. package/dist/gir/type-ref.js +2 -1
  142. package/dist/gir/type-ref.js.map +1 -1
  143. package/dist/gir/type.d.ts +20 -0
  144. package/dist/gir/type.d.ts.map +1 -1
  145. package/dist/gir/type.js.map +1 -1
  146. package/dist/index.d.ts +18 -6
  147. package/dist/index.d.ts.map +1 -1
  148. package/dist/index.js +12 -3
  149. package/dist/index.js.map +1 -1
  150. package/dist/internal.d.ts +3 -0
  151. package/dist/internal.d.ts.map +1 -0
  152. package/dist/internal.js +3 -0
  153. package/dist/internal.js.map +1 -0
  154. package/dist/jsx.d.ts +7 -12
  155. package/dist/jsx.d.ts.map +1 -1
  156. package/dist/jsx.js +18 -19
  157. package/dist/jsx.js.map +1 -1
  158. package/dist/khronos/args.d.ts +7 -6
  159. package/dist/khronos/args.d.ts.map +1 -1
  160. package/dist/khronos/args.js +29 -7
  161. package/dist/khronos/args.js.map +1 -1
  162. package/dist/khronos/doc-context.d.ts +29 -0
  163. package/dist/khronos/doc-context.d.ts.map +1 -0
  164. package/dist/khronos/doc-context.js +29 -0
  165. package/dist/khronos/doc-context.js.map +1 -0
  166. package/dist/khronos/extensions.d.ts +13 -0
  167. package/dist/khronos/extensions.d.ts.map +1 -0
  168. package/dist/khronos/extensions.js +49 -0
  169. package/dist/khronos/extensions.js.map +1 -0
  170. package/dist/khronos/jsdoc.d.ts +17 -11
  171. package/dist/khronos/jsdoc.d.ts.map +1 -1
  172. package/dist/khronos/jsdoc.js +104 -46
  173. package/dist/khronos/jsdoc.js.map +1 -1
  174. package/dist/khronos/model.d.ts +42 -3
  175. package/dist/khronos/model.d.ts.map +1 -1
  176. package/dist/khronos/model.js +218 -63
  177. package/dist/khronos/model.js.map +1 -1
  178. package/dist/khronos/modules.d.ts +9 -6
  179. package/dist/khronos/modules.d.ts.map +1 -1
  180. package/dist/khronos/modules.js +96 -26
  181. package/dist/khronos/modules.js.map +1 -1
  182. package/dist/khronos/notes.d.ts +19 -0
  183. package/dist/khronos/notes.d.ts.map +1 -0
  184. package/dist/khronos/notes.js +35 -0
  185. package/dist/khronos/notes.js.map +1 -0
  186. package/dist/khronos/param-pair.d.ts +1 -1
  187. package/dist/khronos/param-pair.d.ts.map +1 -1
  188. package/dist/khronos/param-pair.js.map +1 -1
  189. package/dist/khronos/pipeline.d.ts +3 -1
  190. package/dist/khronos/pipeline.d.ts.map +1 -1
  191. package/dist/khronos/pipeline.js +59 -28
  192. package/dist/khronos/pipeline.js.map +1 -1
  193. package/dist/khronos/plan.d.ts +5 -5
  194. package/dist/khronos/plan.d.ts.map +1 -1
  195. package/dist/khronos/plan.js +8 -8
  196. package/dist/khronos/plan.js.map +1 -1
  197. package/dist/khronos/render.d.ts +8 -6
  198. package/dist/khronos/render.d.ts.map +1 -1
  199. package/dist/khronos/render.js +35 -26
  200. package/dist/khronos/render.js.map +1 -1
  201. package/dist/khronos/select.d.ts +21 -4
  202. package/dist/khronos/select.d.ts.map +1 -1
  203. package/dist/khronos/select.js +47 -34
  204. package/dist/khronos/select.js.map +1 -1
  205. package/dist/react/element-config.d.ts +16 -10
  206. package/dist/react/element-config.d.ts.map +1 -1
  207. package/dist/react/element-config.js +22 -15
  208. package/dist/react/element-config.js.map +1 -1
  209. package/dist/runner.d.ts +33 -21
  210. package/dist/runner.d.ts.map +1 -1
  211. package/dist/runner.js +19 -20
  212. package/dist/runner.js.map +1 -1
  213. package/dist/store/compile-store.d.ts +2 -3
  214. package/dist/store/compile-store.d.ts.map +1 -1
  215. package/dist/store/compile-store.js +2 -2
  216. package/dist/store/compile-store.js.map +1 -1
  217. package/dist/store/gi/callable-doc.d.ts +11 -0
  218. package/dist/store/gi/callable-doc.d.ts.map +1 -0
  219. package/dist/store/gi/callable-doc.js +62 -0
  220. package/dist/store/gi/callable-doc.js.map +1 -0
  221. package/dist/store/gi/callables.d.ts +3 -1
  222. package/dist/store/gi/callables.d.ts.map +1 -1
  223. package/dist/store/gi/callables.js +16 -16
  224. package/dist/store/gi/callables.js.map +1 -1
  225. package/dist/store/gi/callback.d.ts.map +1 -1
  226. package/dist/store/gi/callback.js +2 -2
  227. package/dist/store/gi/callback.js.map +1 -1
  228. package/dist/store/gi/class.d.ts.map +1 -1
  229. package/dist/store/gi/class.js +5 -3
  230. package/dist/store/gi/class.js.map +1 -1
  231. package/dist/store/gi/closure-invocation.d.ts +4 -0
  232. package/dist/store/gi/closure-invocation.d.ts.map +1 -0
  233. package/dist/store/gi/closure-invocation.js +22 -0
  234. package/dist/store/gi/closure-invocation.js.map +1 -0
  235. package/dist/store/gi/constant.d.ts.map +1 -1
  236. package/dist/store/gi/constant.js +3 -4
  237. package/dist/store/gi/constant.js.map +1 -1
  238. package/dist/store/gi/constructor-props.d.ts.map +1 -1
  239. package/dist/store/gi/constructor-props.js +18 -20
  240. package/dist/store/gi/constructor-props.js.map +1 -1
  241. package/dist/store/gi/doc-spec.d.ts +14 -0
  242. package/dist/store/gi/doc-spec.d.ts.map +1 -0
  243. package/dist/store/gi/doc-spec.js +23 -0
  244. package/dist/store/gi/doc-spec.js.map +1 -0
  245. package/dist/store/gi/enum.d.ts.map +1 -1
  246. package/dist/store/gi/enum.js +29 -16
  247. package/dist/store/gi/enum.js.map +1 -1
  248. package/dist/store/gi/function.d.ts.map +1 -1
  249. package/dist/store/gi/function.js +28 -17
  250. package/dist/store/gi/function.js.map +1 -1
  251. package/dist/store/gi/interface.d.ts.map +1 -1
  252. package/dist/store/gi/interface.js +130 -16
  253. package/dist/store/gi/interface.js.map +1 -1
  254. package/dist/store/gi/item-comparators.d.ts.map +1 -1
  255. package/dist/store/gi/item-comparators.js +3 -5
  256. package/dist/store/gi/item-comparators.js.map +1 -1
  257. package/dist/store/gi/method.d.ts +9 -1
  258. package/dist/store/gi/method.d.ts.map +1 -1
  259. package/dist/store/gi/method.js +92 -47
  260. package/dist/store/gi/method.js.map +1 -1
  261. package/dist/store/gi/param-marshal.d.ts +4 -1
  262. package/dist/store/gi/param-marshal.d.ts.map +1 -1
  263. package/dist/store/gi/param-marshal.js +5 -1
  264. package/dist/store/gi/param-marshal.js.map +1 -1
  265. package/dist/store/gi/pipeline.d.ts.map +1 -1
  266. package/dist/store/gi/pipeline.js +3 -2
  267. package/dist/store/gi/pipeline.js.map +1 -1
  268. package/dist/store/gi/properties.d.ts.map +1 -1
  269. package/dist/store/gi/properties.js +2 -2
  270. package/dist/store/gi/properties.js.map +1 -1
  271. package/dist/store/gi/property-accessor.d.ts +4 -2
  272. package/dist/store/gi/property-accessor.d.ts.map +1 -1
  273. package/dist/store/gi/property-accessor.js +10 -11
  274. package/dist/store/gi/property-accessor.js.map +1 -1
  275. package/dist/store/gi/record-constructor.d.ts.map +1 -1
  276. package/dist/store/gi/record-constructor.js +3 -1
  277. package/dist/store/gi/record-constructor.js.map +1 -1
  278. package/dist/store/gi/record-field-accessor.d.ts +4 -2
  279. package/dist/store/gi/record-field-accessor.d.ts.map +1 -1
  280. package/dist/store/gi/record-field-accessor.js +6 -11
  281. package/dist/store/gi/record-field-accessor.js.map +1 -1
  282. package/dist/store/gi/record-layout.d.ts.map +1 -1
  283. package/dist/store/gi/record-layout.js +1 -5
  284. package/dist/store/gi/record-layout.js.map +1 -1
  285. package/dist/store/gi/record.d.ts.map +1 -1
  286. package/dist/store/gi/record.js +3 -2
  287. package/dist/store/gi/record.js.map +1 -1
  288. package/dist/store/gi/registration.d.ts +1 -1
  289. package/dist/store/gi/registration.js +2 -2
  290. package/dist/store/gi/registration.js.map +1 -1
  291. package/dist/store/gi/return-wrap.d.ts +1 -1
  292. package/dist/store/gi/return-wrap.d.ts.map +1 -1
  293. package/dist/store/gi/return-wrap.js +4 -4
  294. package/dist/store/gi/return-wrap.js.map +1 -1
  295. package/dist/store/gi/runtime-override.d.ts +2 -1
  296. package/dist/store/gi/runtime-override.d.ts.map +1 -1
  297. package/dist/store/gi/runtime-override.js +8 -5
  298. package/dist/store/gi/runtime-override.js.map +1 -1
  299. package/dist/store/gi/signal.d.ts.map +1 -1
  300. package/dist/store/gi/signal.js +27 -31
  301. package/dist/store/gi/signal.js.map +1 -1
  302. package/dist/store/gi/value-marshalable.d.ts +1 -10
  303. package/dist/store/gi/value-marshalable.d.ts.map +1 -1
  304. package/dist/store/gi/value-marshalable.js +1 -10
  305. package/dist/store/gi/value-marshalable.js.map +1 -1
  306. package/dist/store/gi/vtable.d.ts +16 -1
  307. package/dist/store/gi/vtable.d.ts.map +1 -1
  308. package/dist/store/gi/vtable.js +214 -51
  309. package/dist/store/gi/vtable.js.map +1 -1
  310. package/dist/store/gi-store.d.ts +2 -3
  311. package/dist/store/gi-store.d.ts.map +1 -1
  312. package/dist/store/gi-store.js.map +1 -1
  313. package/dist/store/jsx/element-components.d.ts +1 -3
  314. package/dist/store/jsx/element-components.d.ts.map +1 -1
  315. package/dist/store/jsx/element-components.js +6 -8
  316. package/dist/store/jsx/element-components.js.map +1 -1
  317. package/dist/store/jsx/element-prop-imports.d.ts +1 -4
  318. package/dist/store/jsx/element-prop-imports.d.ts.map +1 -1
  319. package/dist/store/jsx/element-prop-imports.js +0 -2
  320. package/dist/store/jsx/element-prop-imports.js.map +1 -1
  321. package/dist/store/jsx/element-prop-types.d.ts +3 -1
  322. package/dist/store/jsx/element-prop-types.d.ts.map +1 -1
  323. package/dist/store/jsx/element-prop-types.js +7 -2
  324. package/dist/store/jsx/element-prop-types.js.map +1 -1
  325. package/dist/store/jsx/generated-elements.d.ts +29 -0
  326. package/dist/store/jsx/generated-elements.d.ts.map +1 -0
  327. package/dist/store/jsx/generated-elements.js +30 -0
  328. package/dist/store/jsx/generated-elements.js.map +1 -0
  329. package/dist/store/jsx/intrinsic-elements.d.ts +4 -0
  330. package/dist/store/jsx/intrinsic-elements.d.ts.map +1 -1
  331. package/dist/store/jsx/intrinsic-elements.js.map +1 -1
  332. package/dist/store/jsx/jsx.d.ts.map +1 -1
  333. package/dist/store/jsx/jsx.js +13 -12
  334. package/dist/store/jsx/jsx.js.map +1 -1
  335. package/dist/store/jsx/metadata.js +9 -9
  336. package/dist/store/jsx/metadata.js.map +1 -1
  337. package/dist/store/jsx/omitted-props.d.ts +2 -4
  338. package/dist/store/jsx/omitted-props.d.ts.map +1 -1
  339. package/dist/store/jsx/omitted-props.js +2 -4
  340. package/dist/store/jsx/omitted-props.js.map +1 -1
  341. package/dist/store/jsx/pipeline.d.ts +4 -2
  342. package/dist/store/jsx/pipeline.d.ts.map +1 -1
  343. package/dist/store/jsx/pipeline.js +3 -2
  344. package/dist/store/jsx/pipeline.js.map +1 -1
  345. package/dist/store/jsx/props.d.ts +1 -7
  346. package/dist/store/jsx/props.d.ts.map +1 -1
  347. package/dist/store/jsx/props.js +16 -8
  348. package/dist/store/jsx/props.js.map +1 -1
  349. package/dist/store/jsx-store.d.ts +2 -3
  350. package/dist/store/jsx-store.d.ts.map +1 -1
  351. package/dist/store/jsx-store.js +3 -3
  352. package/dist/store/jsx-store.js.map +1 -1
  353. package/dist/store/resolve-store.d.ts +28 -0
  354. package/dist/store/resolve-store.d.ts.map +1 -0
  355. package/dist/store/resolve-store.js +65 -0
  356. package/dist/store/resolve-store.js.map +1 -0
  357. package/dist/store/store-fs.d.ts +5 -1
  358. package/dist/store/store-fs.d.ts.map +1 -1
  359. package/dist/store/store-fs.js +6 -4
  360. package/dist/store/store-fs.js.map +1 -1
  361. package/dist/writer/context.d.ts +2 -1
  362. package/dist/writer/context.d.ts.map +1 -1
  363. package/dist/writer/context.js +3 -0
  364. package/dist/writer/context.js.map +1 -1
  365. package/dist/writer/doc-tags.d.ts +21 -0
  366. package/dist/writer/doc-tags.d.ts.map +1 -0
  367. package/dist/writer/doc-tags.js +38 -0
  368. package/dist/writer/doc-tags.js.map +1 -0
  369. package/dist/writer/doc.d.ts +3 -1
  370. package/dist/writer/doc.d.ts.map +1 -1
  371. package/dist/writer/doc.js +19 -6
  372. package/dist/writer/doc.js.map +1 -1
  373. package/dist/writer/gtk-doc.d.ts +1 -1
  374. package/dist/writer/gtk-doc.d.ts.map +1 -1
  375. package/dist/writer/gtk-doc.js +64 -15
  376. package/dist/writer/gtk-doc.js.map +1 -1
  377. package/dist/writer/module.d.ts +8 -2
  378. package/dist/writer/module.d.ts.map +1 -1
  379. package/dist/writer/module.js +13 -1
  380. package/dist/writer/module.js.map +1 -1
  381. package/overrides/gdk/rgba.ts.ejs +26 -0
  382. package/overrides/gobject/object.ts.ejs +56 -11
  383. package/overrides/gobject/value.ts.ejs +7 -0
  384. package/overrides/graphene/structs.ts.ejs +55 -0
  385. package/package.json +7 -11
  386. package/src/analysis/descriptor-render.ts +67 -73
  387. package/src/analysis/descriptor.ts +13 -16
  388. package/src/analysis/inheritance.ts +35 -34
  389. package/src/analysis/nul-terminated-bytes.ts +31 -0
  390. package/src/analysis/param-capability.ts +172 -0
  391. package/src/analysis/param-structure.ts +90 -32
  392. package/src/analysis/ts-type.ts +4 -6
  393. package/src/analysis/type-shape.ts +24 -0
  394. package/src/compile.ts +3 -2
  395. package/src/docs/api-reference.ts +162 -28
  396. package/src/docs/element-page.ts +53 -47
  397. package/src/docs/handwritten-props.ts +230 -0
  398. package/src/docs/pipeline.ts +10 -10
  399. package/src/docs/render.ts +153 -39
  400. package/src/docs/symbol-page.ts +230 -80
  401. package/src/fingerprint.ts +8 -14
  402. package/src/gi.ts +4 -11
  403. package/src/gir/ancestry.ts +15 -1
  404. package/src/gir/annotations.ts +37 -0
  405. package/src/gir/callback.ts +2 -0
  406. package/src/gir/class.ts +42 -4
  407. package/src/gir/enum.ts +30 -10
  408. package/src/gir/field.ts +24 -13
  409. package/src/gir/function.ts +15 -0
  410. package/src/gir/gir-path.ts +7 -0
  411. package/src/gir/libraries.ts +23 -2
  412. package/src/gir/library.ts +51 -2
  413. package/src/gir/namespace.ts +41 -5
  414. package/src/gir/parameter.ts +47 -7
  415. package/src/gir/parse.ts +8 -2
  416. package/src/gir/primitives.ts +1 -0
  417. package/src/gir/property.ts +18 -3
  418. package/src/gir/record.ts +24 -2
  419. package/src/gir/size.ts +8 -6
  420. package/src/gir/type-id.ts +51 -7
  421. package/src/gir/type-ref.ts +2 -1
  422. package/src/gir/type.ts +50 -6
  423. package/src/index.ts +18 -16
  424. package/src/internal.ts +2 -0
  425. package/src/jsx.ts +26 -26
  426. package/src/khronos/args.ts +37 -14
  427. package/src/khronos/doc-context.ts +62 -0
  428. package/src/khronos/extensions.ts +85 -0
  429. package/src/khronos/jsdoc.ts +152 -56
  430. package/src/khronos/model.ts +314 -69
  431. package/src/khronos/modules.ts +134 -40
  432. package/src/khronos/notes.ts +74 -0
  433. package/src/khronos/param-pair.ts +1 -1
  434. package/src/khronos/pipeline.ts +95 -42
  435. package/src/khronos/plan.ts +12 -13
  436. package/src/khronos/render.ts +62 -50
  437. package/src/khronos/select.ts +91 -50
  438. package/src/react/element-config.ts +21 -18
  439. package/src/runner.ts +51 -40
  440. package/src/store/compile-store.ts +4 -5
  441. package/src/store/gi/callable-doc.ts +102 -0
  442. package/src/store/gi/callables.ts +23 -17
  443. package/src/store/gi/callback.ts +3 -2
  444. package/src/store/gi/class.ts +6 -3
  445. package/src/store/gi/closure-invocation.ts +26 -0
  446. package/src/store/gi/constant.ts +3 -6
  447. package/src/store/gi/constructor-props.ts +19 -23
  448. package/src/store/gi/doc-spec.ts +38 -0
  449. package/src/store/gi/enum.ts +55 -20
  450. package/src/store/gi/function.ts +44 -26
  451. package/src/store/gi/interface.ts +214 -26
  452. package/src/store/gi/item-comparators.ts +3 -5
  453. package/src/store/gi/method.ts +126 -68
  454. package/src/store/gi/param-marshal.ts +15 -1
  455. package/src/store/gi/pipeline.ts +7 -2
  456. package/src/store/gi/properties.ts +3 -2
  457. package/src/store/gi/property-accessor.ts +14 -11
  458. package/src/store/gi/record-constructor.ts +6 -1
  459. package/src/store/gi/record-field-accessor.ts +9 -13
  460. package/src/store/gi/record-layout.ts +1 -5
  461. package/src/store/gi/record.ts +8 -2
  462. package/src/store/gi/registration.ts +3 -3
  463. package/src/store/gi/return-wrap.ts +5 -5
  464. package/src/store/gi/runtime-override.ts +13 -6
  465. package/src/store/gi/signal.ts +36 -37
  466. package/src/store/gi/value-marshalable.ts +1 -10
  467. package/src/store/gi/vtable.ts +361 -60
  468. package/src/store/gi-store.ts +2 -4
  469. package/src/store/jsx/element-components.ts +8 -11
  470. package/src/store/jsx/element-prop-imports.ts +6 -5
  471. package/src/store/jsx/element-prop-types.ts +10 -2
  472. package/src/store/jsx/generated-elements.ts +60 -0
  473. package/src/store/jsx/intrinsic-elements.ts +4 -0
  474. package/src/store/jsx/jsx.ts +15 -13
  475. package/src/store/jsx/metadata.ts +10 -10
  476. package/src/store/jsx/omitted-props.ts +2 -4
  477. package/src/store/jsx/pipeline.ts +6 -4
  478. package/src/store/jsx/props.ts +22 -9
  479. package/src/store/jsx-store.ts +5 -7
  480. package/src/store/resolve-store.ts +100 -0
  481. package/src/store/store-fs.ts +12 -5
  482. package/src/writer/context.ts +5 -1
  483. package/src/writer/doc-tags.ts +70 -0
  484. package/src/writer/doc.ts +29 -6
  485. package/src/writer/gtk-doc.ts +82 -15
  486. package/src/writer/module.ts +25 -2
@@ -1 +1 @@
1
- {"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/khronos/plan.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/khronos/plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAW,MAAM,YAAY,CAAC;AAGrD,KAAK,QAAQ,GAAG;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,KAAK,WAAW,GAAG;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,KAAK,SAAS,GACR;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC3B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAElC,KAAK,UAAU,GACT;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAE/B,KAAK,iBAAiB,GAChB,oBAAoB,GACtB,iBAAiB,GACjB,wBAAwB,GACxB,mBAAmB,GACnB,gBAAgB,CAAC;AAErB,KAAK,YAAY,GAAG;IAChB,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACpC,CAAC;AAEF,KAAK,WAAW,GACV;IACE,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;CAC1B,GACD;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAInE,QAAA,MAAM,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAmBpC,CAAC;AAOH,QAAA,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,WAWnC,CAAC;AAqNF,QAAA,MAAM,WAAW,GAAI,SAAS,SAAS,EAAE,QAAQ,YAAY,KAAG,WAc/D,CAAC;AAEF,OAAO,EACH,UAAU,EACV,UAAU,EACV,WAAW,EACX,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,WAAW,GACnB,CAAC"}
@@ -1,9 +1,9 @@
1
1
  import { tScalar } from "../analysis/descriptor.js";
2
2
  const GL_SCALARS = new Map([
3
- ["GLenum", { descriptor: tScalar("uint32"), tsAlias: "GLenum", viewType: "Uint32Array", groupBearing: true }],
3
+ ["GLenum", { descriptor: tScalar("uint32"), tsAlias: "GLenum", viewType: "Uint32Array", isGroupBearing: true }],
4
4
  [
5
5
  "GLbitfield",
6
- { descriptor: tScalar("uint32"), tsAlias: "GLbitfield", viewType: "Uint32Array", groupBearing: true },
6
+ { descriptor: tScalar("uint32"), tsAlias: "GLbitfield", viewType: "Uint32Array", isGroupBearing: true },
7
7
  ],
8
8
  ["GLuint", { descriptor: tScalar("uint32"), tsAlias: "GLuint", viewType: "Uint32Array" }],
9
9
  ["GLint", { descriptor: tScalar("int32"), tsAlias: "GLint", viewType: "Int32Array" }],
@@ -31,7 +31,7 @@ const parseCType = (cType) => {
31
31
  .split(/\s+/)
32
32
  .filter((token) => token.length > 0 && token !== "const" && token !== "struct")
33
33
  .join(" ");
34
- return { base, pointers, constData: isConstData };
34
+ return { base, pointers, isConstData };
35
35
  };
36
36
  const isCompsize = (len) => len.includes("COMPSIZE(");
37
37
  const planCompsizeOut = (command, scalar, policy) => {
@@ -76,10 +76,10 @@ const charStringOutLen = (command, param, parsed) => {
76
76
  return command.params.some((other) => other.name === len) ? len : undefined;
77
77
  };
78
78
  const planCharParam = (command, param, parsed) => {
79
- if (parsed.pointers === 1 && parsed.constData) {
79
+ if (parsed.pointers === 1 && parsed.isConstData) {
80
80
  return { plan: { kind: "string-in" } };
81
81
  }
82
- if (parsed.pointers === 2 && parsed.constData) {
82
+ if (parsed.pointers === 2 && parsed.isConstData) {
83
83
  return { plan: { kind: "string-array-in" } };
84
84
  }
85
85
  const lenParamName = charStringOutLen(command, param, parsed);
@@ -96,7 +96,7 @@ const planScalarParam = (command, param, parsed, policy) => {
96
96
  if (parsed.pointers === 0) {
97
97
  return { plan: { kind: "scalar", scalar } };
98
98
  }
99
- if (parsed.pointers === 1 && parsed.constData) {
99
+ if (parsed.pointers === 1 && parsed.isConstData) {
100
100
  return { plan: { kind: "array-in", scalar } };
101
101
  }
102
102
  if (parsed.pointers === 1) {
@@ -190,11 +190,11 @@ const planCommand = (command, policy) => {
190
190
  for (const param of command.params) {
191
191
  const outcome = planParam(command, param, policy);
192
192
  if ("reason" in outcome) {
193
- return { ok: false, command, reason: outcome.reason };
193
+ return { isOk: false, command, reason: outcome.reason };
194
194
  }
195
195
  params.push(outcome.plan);
196
196
  }
197
- return { ok: true, command, params, returnPlan: planReturn(command) };
197
+ return { isOk: true, command, params, returnPlan: planReturn(command) };
198
198
  };
199
199
  export { GL_SCALARS, parseCType, planCommand, };
200
200
  //# sourceMappingURL=plan.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/khronos/plan.ts"],"names":[],"mappings":"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","sourcesContent":["import type { GlCommand, GlParam } from \"./model.js\";\nimport { tScalar } from \"../analysis/descriptor.js\";\n\ntype GlScalar = {\n descriptor: string;\n tsAlias: string;\n viewType?: string;\n groupBearing?: boolean;\n};\n\ntype ParsedCType = {\n base: string;\n pointers: number;\n constData: boolean;\n};\n\ntype ParamPlan =\n | { kind: \"scalar\"; scalar: GlScalar } |\n { kind: \"boolean\" } |\n { kind: \"sync\" } |\n { kind: \"string-in\" } |\n { kind: \"string-array-in\" } |\n { kind: \"array-in\"; scalar: GlScalar } |\n { kind: \"ref-out\"; scalar: GlScalar } |\n { kind: \"ref-array-out\"; scalar: GlScalar; lenParamName: string } |\n { kind: \"ref-fixed-out\"; scalar: GlScalar; length: number } |\n { kind: \"string-out\"; lenParamName: string } |\n { kind: \"buffer\" } |\n { kind: \"byte-offset\" } |\n { kind: \"byte-offset-array\" };\n\ntype ReturnPlan =\n | { kind: \"void\" } |\n { kind: \"scalar\"; scalar: GlScalar } |\n { kind: \"boolean\" } |\n { kind: \"string\" } |\n { kind: \"sync\" } |\n { kind: \"opaque-pointer\" };\n\ntype GlExclusionReason =\n | \"callback-parameter\" |\n \"compsize-output\" |\n \"computed-output-length\" |\n \"unsupported-shape\" |\n \"override-owned\";\n\ntype GlPlanPolicy = {\n byteOffsetParams: Set<string>;\n singleValuedQueries: Set<string>;\n};\n\ntype CommandPlan =\n | {\n ok: true;\n command: GlCommand;\n params: ParamPlan[];\n returnPlan: ReturnPlan;\n } |\n { ok: false; command: GlCommand; reason: GlExclusionReason };\n\ntype ParamOutcome = { plan: ParamPlan } | { reason: GlExclusionReason };\n\nconst GL_SCALARS: Map<string, GlScalar> = new Map([\n [\"GLenum\", { descriptor: tScalar(\"uint32\"), tsAlias: \"GLenum\", viewType: \"Uint32Array\", groupBearing: true }],\n [\n \"GLbitfield\",\n { descriptor: tScalar(\"uint32\"), tsAlias: \"GLbitfield\", viewType: \"Uint32Array\", groupBearing: true },\n ],\n [\"GLuint\", { descriptor: tScalar(\"uint32\"), tsAlias: \"GLuint\", viewType: \"Uint32Array\" }],\n [\"GLint\", { descriptor: tScalar(\"int32\"), tsAlias: \"GLint\", viewType: \"Int32Array\" }],\n [\"GLsizei\", { descriptor: tScalar(\"int32\"), tsAlias: \"GLsizei\", viewType: \"Int32Array\" }],\n [\"GLbyte\", { descriptor: tScalar(\"int8\"), tsAlias: \"GLbyte\", viewType: \"Int8Array\" }],\n [\"GLubyte\", { descriptor: tScalar(\"uint8\"), tsAlias: \"GLubyte\", viewType: \"Uint8Array\" }],\n [\"GLshort\", { descriptor: tScalar(\"int16\"), tsAlias: \"GLshort\", viewType: \"Int16Array\" }],\n [\"GLushort\", { descriptor: tScalar(\"uint16\"), tsAlias: \"GLushort\", viewType: \"Uint16Array\" }],\n [\"GLfloat\", { descriptor: tScalar(\"float32\"), tsAlias: \"GLfloat\", viewType: \"Float32Array\" }],\n [\"GLdouble\", { descriptor: tScalar(\"float64\"), tsAlias: \"GLdouble\", viewType: \"Float64Array\" }],\n [\"GLint64\", { descriptor: tScalar(\"int64\"), tsAlias: \"GLint64\" }],\n [\"GLuint64\", { descriptor: tScalar(\"uint64\"), tsAlias: \"GLuint64\" }],\n [\"GLintptr\", { descriptor: tScalar(\"int64\"), tsAlias: \"GLintptr\" }],\n [\"GLsizeiptr\", { descriptor: tScalar(\"int64\"), tsAlias: \"GLsizeiptr\" }],\n]);\n\nconst GL_BOOLEAN = \"GLboolean\";\nconst GL_CHAR = \"GLchar\";\nconst GL_SYNC = \"GLsync\";\nconst CALLBACK_BASES: Set<string> = new Set([\"GLDEBUGPROC\", \"GLDEBUGPROCARB\", \"GLDEBUGPROCKHR\", \"GLVULKANPROCNV\"]);\n\nconst parseCType = (cType: string): ParsedCType => {\n const pointers = (cType.match(/\\*/g) ?? []).length;\n const isConstData = /(^|\\s)const(\\s|\\*)/.test(` ${cType} `) && pointers > 0;\n\n const base = cType\n .replaceAll(\"*\", \" \")\n .split(/\\s+/)\n .filter((token) => token.length > 0 && token !== \"const\" && token !== \"struct\")\n .join(\" \");\n\n return { base, pointers, constData: isConstData };\n};\n\nconst isCompsize = (len: string): boolean => len.includes(\"COMPSIZE(\");\n\nconst planCompsizeOut = (command: GlCommand, scalar: GlScalar, policy: GlPlanPolicy): ParamOutcome => {\n if (policy.singleValuedQueries.has(command.name)) {\n return { plan: { kind: \"ref-out\", scalar } };\n }\n\n return { reason: \"compsize-output\" };\n};\n\nconst planPointerOut = (command: GlCommand, param: GlParam, scalar: GlScalar, policy: GlPlanPolicy): ParamOutcome => {\n const len = param.len;\n\n if (len === undefined || len === \"1\") {\n return { plan: { kind: \"ref-out\", scalar } };\n }\n\n if (isCompsize(len)) {\n return planCompsizeOut(command, scalar, policy);\n }\n\n if (/^\\d+$/.test(len)) {\n return { plan: { kind: \"ref-fixed-out\", scalar, length: Number(len) } };\n }\n\n if (command.params.some((other) => other.name === len)) {\n return { plan: { kind: \"ref-array-out\", scalar, lenParamName: len } };\n }\n\n return { reason: \"computed-output-length\" };\n};\n\nconst planByteOffsetParam = (parsed: ParsedCType): ParamOutcome => {\n if (parsed.pointers === 1) {\n return { plan: { kind: \"byte-offset\" } };\n }\n\n if (parsed.pointers === 2) {\n return { plan: { kind: \"byte-offset-array\" } };\n }\n\n return { reason: \"unsupported-shape\" };\n};\n\nconst charStringOutLen = (command: GlCommand, param: GlParam, parsed: ParsedCType): string | undefined => {\n if (parsed.pointers !== 1) {\n return undefined;\n }\n\n const len = param.len;\n\n if (len === undefined) {\n return undefined;\n }\n\n return command.params.some((other) => other.name === len) ? len : undefined;\n};\n\nconst planCharParam = (command: GlCommand, param: GlParam, parsed: ParsedCType): ParamOutcome => {\n if (parsed.pointers === 1 && parsed.constData) {\n return { plan: { kind: \"string-in\" } };\n }\n\n if (parsed.pointers === 2 && parsed.constData) {\n return { plan: { kind: \"string-array-in\" } };\n }\n\n const lenParamName = charStringOutLen(command, param, parsed);\n\n if (lenParamName !== undefined) {\n return { plan: { kind: \"string-out\", lenParamName } };\n }\n\n return { reason: \"unsupported-shape\" };\n};\n\nconst planScalarParam = (\n command: GlCommand,\n param: GlParam,\n parsed: ParsedCType,\n policy: GlPlanPolicy,\n): ParamOutcome => {\n const scalar = GL_SCALARS.get(parsed.base);\n\n if (scalar === undefined) {\n throw new Error(`Unmapped C base type \"${parsed.base}\" on ${command.name}(${param.name}: ${param.cType})`);\n }\n\n if (parsed.pointers === 0) {\n return { plan: { kind: \"scalar\", scalar } };\n }\n\n if (parsed.pointers === 1 && parsed.constData) {\n return { plan: { kind: \"array-in\", scalar } };\n }\n\n if (parsed.pointers === 1) {\n return planPointerOut(command, param, scalar, policy);\n }\n\n return { reason: \"unsupported-shape\" };\n};\n\nconst planVoidParam = (parsed: ParsedCType): ParamOutcome => {\n if (parsed.pointers === 1) {\n return { plan: { kind: \"buffer\" } };\n }\n\n return { reason: \"unsupported-shape\" };\n};\n\nconst planBooleanParam = (parsed: ParsedCType): ParamOutcome => {\n if (parsed.pointers === 0) {\n return { plan: { kind: \"boolean\" } };\n }\n\n return { reason: \"unsupported-shape\" };\n};\n\nconst planCharOrBoolean = (command: GlCommand, param: GlParam, parsed: ParsedCType): ParamOutcome | undefined => {\n if (parsed.base === GL_CHAR || parsed.base === \"GLcharARB\") {\n return planCharParam(command, param, parsed);\n }\n\n if (parsed.base === GL_BOOLEAN) {\n return planBooleanParam(parsed);\n }\n\n return undefined;\n};\n\nconst planByBase = (command: GlCommand, param: GlParam, parsed: ParsedCType, policy: GlPlanPolicy): ParamOutcome => {\n const { base, pointers } = parsed;\n\n if (base === GL_SYNC && pointers === 0) {\n return { plan: { kind: \"sync\" } };\n }\n\n if (base === \"void\") {\n return planVoidParam(parsed);\n }\n\n return planCharOrBoolean(command, param, parsed) ?? planScalarParam(command, param, parsed, policy);\n};\n\nconst planParam = (command: GlCommand, param: GlParam, policy: GlPlanPolicy): ParamOutcome => {\n const parsed = parseCType(param.cType);\n const { base } = parsed;\n\n if (CALLBACK_BASES.has(base) || base.startsWith(\"_cl_\")) {\n return { reason: \"callback-parameter\" };\n }\n\n if (policy.byteOffsetParams.has(`${command.name}:${param.name}`)) {\n return planByteOffsetParam(parsed);\n }\n\n return planByBase(command, param, parsed, policy);\n};\n\nconst planScalarReturn = (base: string): ReturnPlan | undefined => {\n if (base === \"void\") {\n return { kind: \"void\" };\n }\n\n if (base === GL_SYNC) {\n return { kind: \"sync\" };\n }\n\n if (base === GL_BOOLEAN) {\n return { kind: \"boolean\" };\n }\n\n const scalar = GL_SCALARS.get(base);\n\n if (scalar !== undefined) {\n return { kind: \"scalar\", scalar };\n }\n\n return undefined;\n};\n\nconst planPointerReturn = (base: string): ReturnPlan | undefined => {\n if (base === \"void\") {\n return { kind: \"opaque-pointer\" };\n }\n\n if (base === \"GLubyte\" || base === GL_CHAR) {\n return { kind: \"string\" };\n }\n\n return undefined;\n};\n\nconst planReturn = (command: GlCommand): ReturnPlan => {\n const { base, pointers } = parseCType(command.returnCType);\n let plan: ReturnPlan | undefined;\n\n if (pointers === 0) {\n plan = planScalarReturn(base);\n } else if (pointers === 1) {\n plan = planPointerReturn(base);\n }\n\n if (plan !== undefined) {\n return plan;\n }\n\n throw new Error(`Unmapped return type \"${command.returnCType}\" on ${command.name}`);\n};\n\nconst planCommand = (command: GlCommand, policy: GlPlanPolicy): CommandPlan => {\n const params: ParamPlan[] = [];\n\n for (const param of command.params) {\n const outcome = planParam(command, param, policy);\n\n if (\"reason\" in outcome) {\n return { ok: false, command, reason: outcome.reason };\n }\n\n params.push(outcome.plan);\n }\n\n return { ok: true, command, params, returnPlan: planReturn(command) };\n};\n\nexport {\n GL_SCALARS,\n parseCType,\n planCommand,\n type GlScalar,\n type ParsedCType,\n type ParamPlan,\n type ReturnPlan,\n type GlExclusionReason,\n type GlPlanPolicy,\n type CommandPlan,\n};\n"]}
1
+ {"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/khronos/plan.ts"],"names":[],"mappings":"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","sourcesContent":["import type { GlCommand, GlParam } from \"./model.js\";\nimport { tScalar } from \"../analysis/descriptor.js\";\n\ntype GlScalar = {\n descriptor: string;\n tsAlias: string;\n viewType?: string;\n isGroupBearing?: boolean;\n};\n\ntype ParsedCType = {\n base: string;\n pointers: number;\n isConstData: boolean;\n};\n\ntype ParamPlan =\n | { kind: \"scalar\"; scalar: GlScalar } |\n { kind: \"boolean\" } |\n { kind: \"sync\" } |\n { kind: \"string-in\" } |\n { kind: \"string-array-in\" } |\n { kind: \"array-in\"; scalar: GlScalar } |\n { kind: \"ref-out\"; scalar: GlScalar } |\n { kind: \"ref-array-out\"; scalar: GlScalar; lenParamName: string } |\n { kind: \"ref-fixed-out\"; scalar: GlScalar; length: number } |\n { kind: \"string-out\"; lenParamName: string } |\n { kind: \"buffer\" } |\n { kind: \"byte-offset\" } |\n { kind: \"byte-offset-array\" };\n\ntype ReturnPlan =\n | { kind: \"void\" } |\n { kind: \"scalar\"; scalar: GlScalar } |\n { kind: \"boolean\" } |\n { kind: \"string\" } |\n { kind: \"sync\" } |\n { kind: \"opaque-pointer\" };\n\ntype GlExclusionReason =\n | \"callback-parameter\" |\n \"compsize-output\" |\n \"computed-output-length\" |\n \"unsupported-shape\" |\n \"override-owned\";\n\ntype GlPlanPolicy = {\n byteOffsetParams: Set<string>;\n singleValuedQueries: Set<string>;\n};\n\ntype CommandPlan =\n | {\n isOk: true;\n command: GlCommand;\n params: ParamPlan[];\n returnPlan: ReturnPlan;\n } |\n { isOk: false; command: GlCommand; reason: GlExclusionReason };\n\ntype ParamOutcome = { plan: ParamPlan } | { reason: GlExclusionReason };\n\nconst GL_SCALARS: Map<string, GlScalar> = new Map([\n [\"GLenum\", { descriptor: tScalar(\"uint32\"), tsAlias: \"GLenum\", viewType: \"Uint32Array\", isGroupBearing: true }],\n [\n \"GLbitfield\",\n { descriptor: tScalar(\"uint32\"), tsAlias: \"GLbitfield\", viewType: \"Uint32Array\", isGroupBearing: true },\n ],\n [\"GLuint\", { descriptor: tScalar(\"uint32\"), tsAlias: \"GLuint\", viewType: \"Uint32Array\" }],\n [\"GLint\", { descriptor: tScalar(\"int32\"), tsAlias: \"GLint\", viewType: \"Int32Array\" }],\n [\"GLsizei\", { descriptor: tScalar(\"int32\"), tsAlias: \"GLsizei\", viewType: \"Int32Array\" }],\n [\"GLbyte\", { descriptor: tScalar(\"int8\"), tsAlias: \"GLbyte\", viewType: \"Int8Array\" }],\n [\"GLubyte\", { descriptor: tScalar(\"uint8\"), tsAlias: \"GLubyte\", viewType: \"Uint8Array\" }],\n [\"GLshort\", { descriptor: tScalar(\"int16\"), tsAlias: \"GLshort\", viewType: \"Int16Array\" }],\n [\"GLushort\", { descriptor: tScalar(\"uint16\"), tsAlias: \"GLushort\", viewType: \"Uint16Array\" }],\n [\"GLfloat\", { descriptor: tScalar(\"float32\"), tsAlias: \"GLfloat\", viewType: \"Float32Array\" }],\n [\"GLdouble\", { descriptor: tScalar(\"float64\"), tsAlias: \"GLdouble\", viewType: \"Float64Array\" }],\n [\"GLint64\", { descriptor: tScalar(\"int64\"), tsAlias: \"GLint64\" }],\n [\"GLuint64\", { descriptor: tScalar(\"uint64\"), tsAlias: \"GLuint64\" }],\n [\"GLintptr\", { descriptor: tScalar(\"int64\"), tsAlias: \"GLintptr\" }],\n [\"GLsizeiptr\", { descriptor: tScalar(\"int64\"), tsAlias: \"GLsizeiptr\" }],\n]);\n\nconst GL_BOOLEAN = \"GLboolean\";\nconst GL_CHAR = \"GLchar\";\nconst GL_SYNC = \"GLsync\";\nconst CALLBACK_BASES: Set<string> = new Set([\"GLDEBUGPROC\", \"GLDEBUGPROCARB\", \"GLDEBUGPROCKHR\", \"GLVULKANPROCNV\"]);\n\nconst parseCType = (cType: string): ParsedCType => {\n const pointers = (cType.match(/\\*/g) ?? []).length;\n const isConstData = /(^|\\s)const(\\s|\\*)/.test(` ${cType} `) && pointers > 0;\n\n const base = cType\n .replaceAll(\"*\", \" \")\n .split(/\\s+/)\n .filter((token) => token.length > 0 && token !== \"const\" && token !== \"struct\")\n .join(\" \");\n\n return { base, pointers, isConstData };\n};\n\nconst isCompsize = (len: string): boolean => len.includes(\"COMPSIZE(\");\n\nconst planCompsizeOut = (command: GlCommand, scalar: GlScalar, policy: GlPlanPolicy): ParamOutcome => {\n if (policy.singleValuedQueries.has(command.name)) {\n return { plan: { kind: \"ref-out\", scalar } };\n }\n\n return { reason: \"compsize-output\" };\n};\n\nconst planPointerOut = (command: GlCommand, param: GlParam, scalar: GlScalar, policy: GlPlanPolicy): ParamOutcome => {\n const len = param.len;\n\n if (len === undefined || len === \"1\") {\n return { plan: { kind: \"ref-out\", scalar } };\n }\n\n if (isCompsize(len)) {\n return planCompsizeOut(command, scalar, policy);\n }\n\n if (/^\\d+$/.test(len)) {\n return { plan: { kind: \"ref-fixed-out\", scalar, length: Number(len) } };\n }\n\n if (command.params.some((other) => other.name === len)) {\n return { plan: { kind: \"ref-array-out\", scalar, lenParamName: len } };\n }\n\n return { reason: \"computed-output-length\" };\n};\n\nconst planByteOffsetParam = (parsed: ParsedCType): ParamOutcome => {\n if (parsed.pointers === 1) {\n return { plan: { kind: \"byte-offset\" } };\n }\n\n if (parsed.pointers === 2) {\n return { plan: { kind: \"byte-offset-array\" } };\n }\n\n return { reason: \"unsupported-shape\" };\n};\n\nconst charStringOutLen = (command: GlCommand, param: GlParam, parsed: ParsedCType): string | undefined => {\n if (parsed.pointers !== 1) {\n return undefined;\n }\n\n const len = param.len;\n\n if (len === undefined) {\n return undefined;\n }\n\n return command.params.some((other) => other.name === len) ? len : undefined;\n};\n\nconst planCharParam = (command: GlCommand, param: GlParam, parsed: ParsedCType): ParamOutcome => {\n if (parsed.pointers === 1 && parsed.isConstData) {\n return { plan: { kind: \"string-in\" } };\n }\n\n if (parsed.pointers === 2 && parsed.isConstData) {\n return { plan: { kind: \"string-array-in\" } };\n }\n\n const lenParamName = charStringOutLen(command, param, parsed);\n\n if (lenParamName !== undefined) {\n return { plan: { kind: \"string-out\", lenParamName } };\n }\n\n return { reason: \"unsupported-shape\" };\n};\n\nconst planScalarParam = (\n command: GlCommand,\n param: GlParam,\n parsed: ParsedCType,\n policy: GlPlanPolicy,\n): ParamOutcome => {\n const scalar = GL_SCALARS.get(parsed.base);\n\n if (scalar === undefined) {\n throw new Error(`Unmapped C base type \"${parsed.base}\" on ${command.name}(${param.name}: ${param.cType})`);\n }\n\n if (parsed.pointers === 0) {\n return { plan: { kind: \"scalar\", scalar } };\n }\n\n if (parsed.pointers === 1 && parsed.isConstData) {\n return { plan: { kind: \"array-in\", scalar } };\n }\n\n if (parsed.pointers === 1) {\n return planPointerOut(command, param, scalar, policy);\n }\n\n return { reason: \"unsupported-shape\" };\n};\n\nconst planVoidParam = (parsed: ParsedCType): ParamOutcome => {\n if (parsed.pointers === 1) {\n return { plan: { kind: \"buffer\" } };\n }\n\n return { reason: \"unsupported-shape\" };\n};\n\nconst planBooleanParam = (parsed: ParsedCType): ParamOutcome => {\n if (parsed.pointers === 0) {\n return { plan: { kind: \"boolean\" } };\n }\n\n return { reason: \"unsupported-shape\" };\n};\n\nconst planCharOrBoolean = (command: GlCommand, param: GlParam, parsed: ParsedCType): ParamOutcome | undefined => {\n if (parsed.base === GL_CHAR || parsed.base === \"GLcharARB\") {\n return planCharParam(command, param, parsed);\n }\n\n if (parsed.base === GL_BOOLEAN) {\n return planBooleanParam(parsed);\n }\n\n return undefined;\n};\n\nconst planByBase = (command: GlCommand, param: GlParam, parsed: ParsedCType, policy: GlPlanPolicy): ParamOutcome => {\n const { base, pointers } = parsed;\n\n if (base === GL_SYNC && pointers === 0) {\n return { plan: { kind: \"sync\" } };\n }\n\n if (base === \"void\") {\n return planVoidParam(parsed);\n }\n\n return planCharOrBoolean(command, param, parsed) ?? planScalarParam(command, param, parsed, policy);\n};\n\nconst planParam = (command: GlCommand, param: GlParam, policy: GlPlanPolicy): ParamOutcome => {\n const parsed = parseCType(param.cType);\n const { base } = parsed;\n\n if (CALLBACK_BASES.has(base) || base.startsWith(\"_cl_\")) {\n return { reason: \"callback-parameter\" };\n }\n\n if (policy.byteOffsetParams.has(`${command.name}:${param.name}`)) {\n return planByteOffsetParam(parsed);\n }\n\n return planByBase(command, param, parsed, policy);\n};\n\nconst planScalarReturn = (base: string): ReturnPlan | undefined => {\n if (base === \"void\") {\n return { kind: \"void\" };\n }\n\n if (base === GL_SYNC) {\n return { kind: \"sync\" };\n }\n\n if (base === GL_BOOLEAN) {\n return { kind: \"boolean\" };\n }\n\n const scalar = GL_SCALARS.get(base);\n\n if (scalar !== undefined) {\n return { kind: \"scalar\", scalar };\n }\n\n return undefined;\n};\n\nconst planPointerReturn = (base: string): ReturnPlan | undefined => {\n if (base === \"void\") {\n return { kind: \"opaque-pointer\" };\n }\n\n if (base === \"GLubyte\" || base === GL_CHAR) {\n return { kind: \"string\" };\n }\n\n return undefined;\n};\n\nconst planReturn = (command: GlCommand): ReturnPlan => {\n const { base, pointers } = parseCType(command.returnCType);\n let plan: ReturnPlan | undefined;\n\n if (pointers === 0) {\n plan = planScalarReturn(base);\n } else if (pointers === 1) {\n plan = planPointerReturn(base);\n }\n\n if (plan !== undefined) {\n return plan;\n }\n\n throw new Error(`Unmapped return type \"${command.returnCType}\" on ${command.name}`);\n};\n\nconst planCommand = (command: GlCommand, policy: GlPlanPolicy): CommandPlan => {\n const params: ParamPlan[] = [];\n\n for (const param of command.params) {\n const outcome = planParam(command, param, policy);\n\n if (\"reason\" in outcome) {\n return { isOk: false, command, reason: outcome.reason };\n }\n\n params.push(outcome.plan);\n }\n\n return { isOk: true, command, params, returnPlan: planReturn(command) };\n};\n\nexport {\n GL_SCALARS,\n parseCType,\n planCommand,\n type GlScalar,\n type ParamPlan,\n type ReturnPlan,\n type GlExclusionReason,\n type GlPlanPolicy,\n type CommandPlan,\n};\n"]}
@@ -1,17 +1,19 @@
1
+ import type { GlDocContext } from "./doc-context.js";
1
2
  import type { CommandPlan } from "./plan.js";
3
+ import type { GlSymbolProvenance } from "./select.js";
2
4
  type RenderedCommand = {
3
5
  exportName: string;
4
6
  binding?: string;
5
7
  declaration: string;
6
8
  };
7
9
  declare const renderCommand: (plan: CommandPlan & {
8
- ok: true;
9
- }, feature: string, usedTypes: Set<string>) => RenderedCommand;
10
+ isOk: true;
11
+ }, provenance: GlSymbolProvenance, usedTypes: Set<string>, docs: GlDocContext) => RenderedCommand;
10
12
  declare const deriveGenSingular: (plan: CommandPlan & {
11
- ok: true;
12
- }, feature: string, usedTypes: Set<string>) => RenderedCommand | undefined;
13
+ isOk: true;
14
+ }, provenance: GlSymbolProvenance, usedTypes: Set<string>, docs: GlDocContext) => RenderedCommand | undefined;
13
15
  declare const deriveDeleteSingular: (plan: CommandPlan & {
14
- ok: true;
15
- }, feature: string, usedTypes: Set<string>) => RenderedCommand | undefined;
16
+ isOk: true;
17
+ }, provenance: GlSymbolProvenance, usedTypes: Set<string>, docs: GlDocContext) => RenderedCommand | undefined;
16
18
  export { renderCommand, deriveGenSingular, deriveDeleteSingular, type RenderedCommand };
17
19
  //# sourceMappingURL=render.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/khronos/render.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAwB,MAAM,WAAW,CAAC;AAKnE,KAAK,eAAe,GAAG;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AA4GF,QAAA,MAAM,aAAa,GACf,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,EAChC,SAAS,MAAM,EACf,WAAW,GAAG,CAAC,MAAM,CAAC,KACvB,eA4BF,CAAC;AA0DF,QAAA,MAAM,iBAAiB,GACnB,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,EAChC,SAAS,MAAM,EACf,WAAW,GAAG,CAAC,MAAM,CAAC,KACvB,eAAe,GAAG,SA4CpB,CAAC;AAkCF,QAAA,MAAM,oBAAoB,GACtB,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,EAChC,SAAS,MAAM,EACf,WAAW,GAAG,CAAC,MAAM,CAAC,KACvB,eAAe,GAAG,SAiCpB,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,KAAK,eAAe,EAAE,CAAC"}
1
+ {"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/khronos/render.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAwB,MAAM,WAAW,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAMtD,KAAK,eAAe,GAAG;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AA0GF,QAAA,MAAM,aAAa,GACf,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,EAClC,YAAY,kBAAkB,EAC9B,WAAW,GAAG,CAAC,MAAM,CAAC,EACtB,MAAM,YAAY,KACnB,eA4BF,CAAC;AA0EF,QAAA,MAAM,iBAAiB,GACnB,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,EAClC,YAAY,kBAAkB,EAC9B,WAAW,GAAG,CAAC,MAAM,CAAC,EACtB,MAAM,YAAY,KACnB,eAAe,GAAG,SAqCpB,CAAC;AAkCF,QAAA,MAAM,oBAAoB,GACtB,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,EAClC,YAAY,kBAAkB,EAC9B,WAAW,GAAG,CAAC,MAAM,CAAC,EACtB,MAAM,YAAY,KACnB,eAAe,GAAG,SAgCpB,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,KAAK,eAAe,EAAE,CAAC"}
@@ -1,7 +1,8 @@
1
- import { lowerFirst, sourceStringLiteral, toCamelIdentifier } from "@gtkx/utils";
1
+ import { sourceStringLiteral, toCamelIdentifier } from "@gtkx/utils";
2
2
  import { tBind, tInlineStruct, tRef, tString, tUint8, tVoid } from "../analysis/descriptor.js";
3
- import { planArgs, scalarAliasOrGroup, scalarPrefixArgs, trackInto } from "./args.js";
4
- import { commandJsDoc, inParamDocLine, singularJsDoc } from "./jsdoc.js";
3
+ import { planArgs, returnPlanTsType, scalarPrefixArgs, trackInto } from "./args.js";
4
+ import { commandJsDoc, derivedJsDoc, inParamDocLine } from "./jsdoc.js";
5
+ import { commandExportName } from "./notes.js";
5
6
  const GL_LIB_EXPRESSION = "LIB";
6
7
  const GEN_FAMILY = /^gl(Gen|Create)[A-Z][A-Za-z]*s$/;
7
8
  const DELETE_FAMILY = /^glDelete[A-Z][A-Za-z]*s$/;
@@ -11,34 +12,29 @@ const glBind = (name, argList, returnType) => tBind({
11
12
  argList,
12
13
  returnType,
13
14
  });
14
- const commandExportName = (name) => toCamelIdentifier(name.startsWith("gl") ? lowerFirst(name.slice(2)) : name);
15
15
  const singularize = (plural) => plural.endsWith("ies") ? `${plural.slice(0, -3)}y` : plural.replace(/s$/, "");
16
16
  const renderDescriptorList = (descriptors) => descriptors.length === 0 ? "[]" : `[${descriptors.join(", ")}]`;
17
17
  const buildEmittedReturn = (plan, returnGroup, usedTypes) => {
18
- const track = trackInto(usedTypes);
18
+ const tsType = trackInto(usedTypes)(returnPlanTsType(plan, returnGroup));
19
+ const cast = (call) => `${call} as ${tsType}`;
19
20
  switch (plan.kind) {
20
21
  case "void": {
21
- return { tsType: "void", descriptor: tVoid };
22
+ return { tsType, descriptor: tVoid };
22
23
  }
23
24
  case "scalar": {
24
- const alias = track(scalarAliasOrGroup(plan.scalar, returnGroup));
25
- return { tsType: alias, descriptor: plan.scalar.descriptor, expr: (call) => `${call} as ${alias}` };
25
+ return { tsType, descriptor: plan.scalar.descriptor, expr: cast };
26
26
  }
27
27
  case "boolean": {
28
- return { tsType: "boolean", descriptor: tUint8, expr: (call) => `(${call} as number) !== 0` };
28
+ return { tsType, descriptor: tUint8, expr: (call) => `(${call} as number) !== 0` };
29
29
  }
30
30
  case "string": {
31
- return { tsType: "string", descriptor: tString("borrowed"), expr: (call) => `${call} as string` };
31
+ return { tsType, descriptor: tString("borrowed"), expr: cast };
32
32
  }
33
33
  case "sync": {
34
- return { tsType: track("GLsync"), descriptor: tInlineStruct(), expr: (call) => `${call} as GLsync` };
34
+ return { tsType, descriptor: tInlineStruct(), expr: cast };
35
35
  }
36
36
  case "opaque-pointer": {
37
- return {
38
- tsType: track("GLpointer"),
39
- descriptor: tInlineStruct(),
40
- expr: (call) => `${call} as GLpointer`,
41
- };
37
+ return { tsType, descriptor: tInlineStruct(), expr: cast };
42
38
  }
43
39
  }
44
40
  };
@@ -67,16 +63,16 @@ const returnStatements = (call, returned, outs) => {
67
63
  }
68
64
  return [`const result = ${call};`, `return [${returned.expr("result")}, ${outValues.join(", ")}];`];
69
65
  };
70
- const renderCommand = (plan, feature, usedTypes) => {
66
+ const renderCommand = (plan, provenance, usedTypes, docs) => {
71
67
  const { command } = plan;
72
68
  const exportName = commandExportName(command.name);
73
69
  const { args, ins, outs } = planArgs(plan, usedTypes);
74
70
  const returned = buildEmittedReturn(plan.returnPlan, command.returnGroup, usedTypes);
75
71
  const signature = ins.map((arg) => `${arg.name}: ${arg.tsType}`).join(", ");
76
- const argNames = args.map((arg) => (arg.out ? arg.cellName : arg.name)).join(", ");
72
+ const argNames = args.map((arg) => (arg.isOut ? arg.cellName : arg.name)).join(", ");
77
73
  const descriptors = renderDescriptorList(args.map((arg) => arg.descriptor));
78
74
  const tsReturn = returnTsType(returned, outs);
79
- const jsDoc = commandJsDoc({ command, feature, ins, outs, returnPlan: plan.returnPlan });
75
+ const jsDoc = commandJsDoc({ plan, provenance, ins, outs, docs });
80
76
  const seeds = outs.map((out) => out.seed);
81
77
  const bindExpression = glBind(command.name, descriptors, returned.descriptor);
82
78
  const isInline = plan.params.some((paramPlan) => paramPlan.kind === "string-out");
@@ -94,7 +90,13 @@ const renderCommand = (plan, feature, usedTypes) => {
94
90
  declaration: `${jsDoc}\nexport function ${exportName}(${signature}): ${tsReturn} {\n${body}\n}`,
95
91
  };
96
92
  };
97
- const singularCommandJsDoc = (plan, feature, summary, body) => singularJsDoc({ commandName: plan.command.name, feature, summary, body });
93
+ const singularCommandJsDoc = (context, summary, body) => derivedJsDoc({
94
+ command: context.plan.command,
95
+ provenance: context.provenance,
96
+ docs: context.docs,
97
+ summary,
98
+ body,
99
+ });
98
100
  const genSingularScalars = (plan) => {
99
101
  const countPlan = plan.params.at(-2);
100
102
  if (countPlan?.kind !== "scalar") {
@@ -128,7 +130,15 @@ const genSingularShape = (plan) => {
128
130
  }
129
131
  return { countScalar: scalars.countScalar, outScalar: scalars.outScalar, objectClass };
130
132
  };
131
- const deriveGenSingular = (plan, feature, usedTypes) => {
133
+ const genSingularJsDoc = (context, prefix, shape) => {
134
+ const { command } = context.plan;
135
+ return singularCommandJsDoc(context, `Returns one ${shape.objectClass} object name via ` +
136
+ `\`${command.name}(${prefix.length > 0 ? "..., " : ""}1, ...)\`.`, [
137
+ ...prefix.map((arg) => inParamDocLine(context.plan, arg, context.docs)),
138
+ ` * @returns \`${shape.outScalar.tsAlias}\`, object class \`${shape.objectClass}\``,
139
+ ]);
140
+ };
141
+ const deriveGenSingular = (plan, provenance, usedTypes, docs) => {
132
142
  if (!GEN_FAMILY.test(plan.command.name)) {
133
143
  return undefined;
134
144
  }
@@ -140,15 +150,14 @@ const deriveGenSingular = (plan, feature, usedTypes) => {
140
150
  if (prefix === undefined) {
141
151
  return undefined;
142
152
  }
143
- const { countScalar, outScalar, objectClass } = shape;
153
+ const { countScalar, outScalar } = shape;
144
154
  const exportName = singularize(commandExportName(plan.command.name));
145
155
  const bindingName = `${plan.command.name}Single`;
146
156
  const descriptors = [...prefix.map((arg) => arg.descriptor), countScalar.descriptor, tRef(outScalar.descriptor)];
147
157
  usedTypes.add(outScalar.tsAlias);
148
158
  const signature = prefix.map((arg) => `${arg.name}: ${arg.tsType}`).join(", ");
149
159
  const callArgs = [...prefix.map((arg) => arg.name), "1", "out"].join(", ");
150
- const jsDoc = singularCommandJsDoc(plan, feature, `Returns one ${objectClass} object name via ` +
151
- `\`${plan.command.name}(${prefix.length > 0 ? "..., " : ""}1, ...)\`.`, [...prefix.map((arg) => inParamDocLine(plan.command, arg)), ` * @returns The new ${objectClass} object name`]);
160
+ const jsDoc = genSingularJsDoc({ plan, provenance, docs }, prefix, shape);
152
161
  const body = [" const out = { value: 0 };", ` ${bindingName}(${callArgs});`, " return out.value;"].join("\n");
153
162
  const binding = glBind(plan.command.name, renderDescriptorList(descriptors), tVoid);
154
163
  return {
@@ -180,7 +189,7 @@ const deleteSingularObjectClass = (plan) => {
180
189
  }
181
190
  return arrayParam.objectClass;
182
191
  };
183
- const deriveDeleteSingular = (plan, feature, usedTypes) => {
192
+ const deriveDeleteSingular = (plan, provenance, usedTypes, docs) => {
184
193
  if (!DELETE_FAMILY.test(plan.command.name)) {
185
194
  return undefined;
186
195
  }
@@ -194,7 +203,7 @@ const deriveDeleteSingular = (plan, feature, usedTypes) => {
194
203
  }
195
204
  usedTypes.add(scalarAlias);
196
205
  const exportName = singularize(commandExportName(plan.command.name));
197
- const jsDoc = singularCommandJsDoc(plan, feature, `Deletes one ${objectClass} object name via \`${plan.command.name}(1, ...)\`.`, [` * @param name - The ${objectClass} object name to delete`]);
206
+ const jsDoc = singularCommandJsDoc({ plan, provenance, docs }, `Deletes one ${objectClass} object name via \`${plan.command.name}(1, ...)\`.`, [` * @param name - \`${scalarAlias}\`, object class \`${objectClass}\``]);
198
207
  return {
199
208
  exportName,
200
209
  declaration: `${jsDoc}\nexport function ${exportName}(name: ${scalarAlias}): void {\n` +
@@ -1 +1 @@
1
- {"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/khronos/render.ts"],"names":[],"mappings":"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","sourcesContent":["import { lowerFirst, sourceStringLiteral, toCamelIdentifier } from \"@gtkx/utils\";\nimport type { CommandPlan, GlScalar, ReturnPlan } from \"./plan.js\";\nimport { tBind, tInlineStruct, tRef, tString, tUint8, tVoid } from \"../analysis/descriptor.js\";\nimport { type OutArg, planArgs, scalarAliasOrGroup, scalarPrefixArgs, trackInto } from \"./args.js\";\nimport { commandJsDoc, inParamDocLine, singularJsDoc } from \"./jsdoc.js\";\n\ntype RenderedCommand = {\n exportName: string;\n binding?: string;\n declaration: string;\n};\n\ntype EmittedReturn = {\n tsType: string;\n descriptor: string;\n expr?: (call: string) => string;\n};\n\ntype GenSingularShape = {\n countScalar: GlScalar;\n outScalar: GlScalar;\n objectClass: string;\n};\n\nconst GL_LIB_EXPRESSION = \"LIB\";\nconst GEN_FAMILY = /^gl(Gen|Create)[A-Z][A-Za-z]*s$/;\nconst DELETE_FAMILY = /^glDelete[A-Z][A-Za-z]*s$/;\n\nconst glBind = (name: string, argList: string, returnType: string): string =>\n tBind({\n libExpr: GL_LIB_EXPRESSION,\n symbolExpr: sourceStringLiteral(name),\n argList,\n returnType,\n });\n\nconst commandExportName = (name: string): string =>\n toCamelIdentifier(name.startsWith(\"gl\") ? lowerFirst(name.slice(2)) : name);\n\nconst singularize = (plural: string): string =>\n plural.endsWith(\"ies\") ? `${plural.slice(0, -3)}y` : plural.replace(/s$/, \"\");\n\nconst renderDescriptorList = (descriptors: string[]): string =>\n descriptors.length === 0 ? \"[]\" : `[${descriptors.join(\", \")}]`;\n\nconst buildEmittedReturn = (\n plan: ReturnPlan,\n returnGroup: string | undefined,\n usedTypes: Set<string>,\n): EmittedReturn => {\n const track = trackInto(usedTypes);\n\n switch (plan.kind) {\n case \"void\": {\n return { tsType: \"void\", descriptor: tVoid };\n }\n case \"scalar\": {\n const alias = track(scalarAliasOrGroup(plan.scalar, returnGroup));\n\n return { tsType: alias, descriptor: plan.scalar.descriptor, expr: (call) => `${call} as ${alias}` };\n }\n case \"boolean\": {\n return { tsType: \"boolean\", descriptor: tUint8, expr: (call) => `(${call} as number) !== 0` };\n }\n case \"string\": {\n return { tsType: \"string\", descriptor: tString(\"borrowed\"), expr: (call) => `${call} as string` };\n }\n case \"sync\": {\n return { tsType: track(\"GLsync\"), descriptor: tInlineStruct(), expr: (call) => `${call} as GLsync` };\n }\n case \"opaque-pointer\": {\n return {\n tsType: track(\"GLpointer\"),\n descriptor: tInlineStruct(),\n expr: (call) => `${call} as GLpointer`,\n };\n }\n }\n};\n\nconst returnTsType = (returned: EmittedReturn, outs: OutArg[]): string => {\n if (outs.length === 0) {\n return returned.tsType;\n }\n\n const outTypes = outs.map((out) => out.tsType);\n\n if (returned.expr === undefined) {\n return outTypes.length === 1 && outTypes[0] !== undefined ? outTypes[0] : `[${outTypes.join(\", \")}]`;\n }\n\n return `[${returned.tsType}, ${outTypes.join(\", \")}]`;\n};\n\nconst returnNoOut = (call: string, returned: EmittedReturn): string[] =>\n returned.expr === undefined ? [`${call};`] : [`return ${returned.expr(call)};`];\n\nconst returnStatements = (call: string, returned: EmittedReturn, outs: OutArg[]): string[] => {\n if (outs.length === 0) {\n return returnNoOut(call, returned);\n }\n\n const outValues = outs.map((out) => `${out.cellName}.value`);\n\n if (returned.expr === undefined) {\n const [single] = outValues;\n\n const tail =\n single !== undefined && outValues.length === 1\n ? `return ${single};`\n : `return [${outValues.join(\", \")}];`;\n\n return [`${call};`, tail];\n }\n\n return [`const result = ${call};`, `return [${returned.expr(\"result\")}, ${outValues.join(\", \")}];`];\n};\n\nconst renderCommand = (\n plan: CommandPlan & { ok: true },\n feature: string,\n usedTypes: Set<string>,\n): RenderedCommand => {\n const { command } = plan;\n const exportName = commandExportName(command.name);\n const { args, ins, outs } = planArgs(plan, usedTypes);\n const returned = buildEmittedReturn(plan.returnPlan, command.returnGroup, usedTypes);\n const signature = ins.map((arg) => `${arg.name}: ${arg.tsType}`).join(\", \");\n const argNames = args.map((arg) => (arg.out ? arg.cellName : arg.name)).join(\", \");\n const descriptors = renderDescriptorList(args.map((arg) => arg.descriptor));\n const tsReturn = returnTsType(returned, outs);\n const jsDoc = commandJsDoc({ command, feature, ins, outs, returnPlan: plan.returnPlan });\n const seeds = outs.map((out) => out.seed);\n const bindExpression = glBind(command.name, descriptors, returned.descriptor);\n const isInline = plan.params.some((paramPlan) => paramPlan.kind === \"string-out\");\n const bindingName = isInline ? \"binding\" : toCamelIdentifier(command.name);\n\n const body = [\n ...seeds,\n ...(isInline ? [`const ${bindingName} = ${bindExpression};`] : []),\n ...returnStatements(`${bindingName}(${argNames})`, returned, outs),\n ]\n .map((line) => ` ${line}`)\n .join(\"\\n\");\n\n return {\n exportName,\n ...(!isInline && { binding: `const ${bindingName} = ${bindExpression};` }),\n declaration: `${jsDoc}\\nexport function ${exportName}(${signature}): ${tsReturn} {\\n${body}\\n}`,\n };\n};\n\nconst singularCommandJsDoc = (\n plan: CommandPlan & { ok: true },\n feature: string,\n summary: string,\n body: string[],\n): string => singularJsDoc({ commandName: plan.command.name, feature, summary, body });\n\nconst genSingularScalars = (\n plan: CommandPlan & { ok: true },\n): { countScalar: GlScalar; outScalar: GlScalar; lenParamName: string } | undefined => {\n const countPlan = plan.params.at(-2);\n\n if (countPlan?.kind !== \"scalar\") {\n return undefined;\n }\n\n const outPlan = plan.params.at(-1);\n\n if (outPlan?.kind !== \"ref-array-out\") {\n return undefined;\n }\n\n return { countScalar: countPlan.scalar, outScalar: outPlan.scalar, lenParamName: outPlan.lenParamName };\n};\n\nconst genSingularObjectClass = (plan: CommandPlan & { ok: true }, lenParamName: string): string | undefined => {\n const countParam = plan.command.params[plan.params.length - 2];\n const outParam = plan.command.params[plan.params.length - 1];\n\n if (countParam === undefined || outParam === undefined) {\n return undefined;\n }\n\n if (lenParamName !== countParam.name) {\n return undefined;\n }\n\n return outParam.objectClass;\n};\n\nconst genSingularShape = (plan: CommandPlan & { ok: true }): GenSingularShape | undefined => {\n const scalars = genSingularScalars(plan);\n\n if (scalars === undefined) {\n return undefined;\n }\n\n const objectClass = genSingularObjectClass(plan, scalars.lenParamName);\n\n if (objectClass === undefined) {\n return undefined;\n }\n\n return { countScalar: scalars.countScalar, outScalar: scalars.outScalar, objectClass };\n};\n\nconst deriveGenSingular = (\n plan: CommandPlan & { ok: true },\n feature: string,\n usedTypes: Set<string>,\n): RenderedCommand | undefined => {\n if (!GEN_FAMILY.test(plan.command.name)) {\n return undefined;\n }\n\n const shape = genSingularShape(plan);\n\n if (shape === undefined) {\n return undefined;\n }\n\n const prefix = scalarPrefixArgs(plan, usedTypes);\n\n if (prefix === undefined) {\n return undefined;\n }\n\n const { countScalar, outScalar, objectClass } = shape;\n const exportName = singularize(commandExportName(plan.command.name));\n const bindingName = `${plan.command.name}Single`;\n const descriptors = [...prefix.map((arg) => arg.descriptor), countScalar.descriptor, tRef(outScalar.descriptor)];\n usedTypes.add(outScalar.tsAlias);\n const signature = prefix.map((arg) => `${arg.name}: ${arg.tsType}`).join(\", \");\n const callArgs = [...prefix.map((arg) => arg.name), \"1\", \"out\"].join(\", \");\n\n const jsDoc = singularCommandJsDoc(\n plan,\n feature,\n `Returns one ${objectClass} object name via ` +\n `\\`${plan.command.name}(${prefix.length > 0 ? \"..., \" : \"\"}1, ...)\\`.`,\n [...prefix.map((arg) => inParamDocLine(plan.command, arg)), ` * @returns The new ${objectClass} object name`],\n );\n\n const body = [\" const out = { value: 0 };\", ` ${bindingName}(${callArgs});`, \" return out.value;\"].join(\n \"\\n\",\n );\n\n const binding = glBind(plan.command.name, renderDescriptorList(descriptors), tVoid);\n\n return {\n exportName,\n binding: `const ${bindingName} = ${binding};`,\n declaration: `${jsDoc}\\nexport function ${exportName}(${signature}): ${outScalar.tsAlias} {\\n${body}\\n}`,\n };\n};\n\nconst deleteSingularAlias = (plan: CommandPlan & { ok: true }): string | undefined => {\n if (plan.params.length !== 2) {\n return undefined;\n }\n\n const [countPlan, arrayPlan] = plan.params;\n\n if (countPlan?.kind !== \"scalar\") {\n return undefined;\n }\n\n if (arrayPlan?.kind !== \"array-in\") {\n return undefined;\n }\n\n return arrayPlan.scalar.tsAlias;\n};\n\nconst deleteSingularObjectClass = (plan: CommandPlan & { ok: true }): string | undefined => {\n const [countParam, arrayParam] = plan.command.params;\n\n if (countParam === undefined || arrayParam === undefined) {\n return undefined;\n }\n\n if (arrayParam.len !== countParam.name) {\n return undefined;\n }\n\n return arrayParam.objectClass;\n};\n\nconst deriveDeleteSingular = (\n plan: CommandPlan & { ok: true },\n feature: string,\n usedTypes: Set<string>,\n): RenderedCommand | undefined => {\n if (!DELETE_FAMILY.test(plan.command.name)) {\n return undefined;\n }\n\n const scalarAlias = deleteSingularAlias(plan);\n\n if (scalarAlias === undefined) {\n return undefined;\n }\n\n const objectClass = deleteSingularObjectClass(plan);\n\n if (objectClass === undefined) {\n return undefined;\n }\n\n usedTypes.add(scalarAlias);\n const exportName = singularize(commandExportName(plan.command.name));\n\n const jsDoc = singularCommandJsDoc(\n plan,\n feature,\n `Deletes one ${objectClass} object name via \\`${plan.command.name}(1, ...)\\`.`,\n [` * @param name - The ${objectClass} object name to delete`],\n );\n\n return {\n exportName,\n declaration:\n `${jsDoc}\\nexport function ${exportName}(name: ${scalarAlias}): void {\\n` +\n ` ${plan.command.name}(1, [name]);\\n}`,\n };\n};\n\nexport { renderCommand, deriveGenSingular, deriveDeleteSingular, type RenderedCommand };\n"]}
1
+ {"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/khronos/render.ts"],"names":[],"mappings":"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","sourcesContent":["import { sourceStringLiteral, toCamelIdentifier } from \"@gtkx/utils\";\nimport type { GlDocContext } from \"./doc-context.js\";\nimport type { CommandPlan, GlScalar, ReturnPlan } from \"./plan.js\";\nimport type { GlSymbolProvenance } from \"./select.js\";\nimport { tBind, tInlineStruct, tRef, tString, tUint8, tVoid } from \"../analysis/descriptor.js\";\nimport { type InArg, type OutArg, planArgs, returnPlanTsType, scalarPrefixArgs, trackInto } from \"./args.js\";\nimport { commandJsDoc, derivedJsDoc, inParamDocLine } from \"./jsdoc.js\";\nimport { commandExportName } from \"./notes.js\";\n\ntype RenderedCommand = {\n exportName: string;\n binding?: string;\n declaration: string;\n};\n\ntype SingularContext = {\n plan: CommandPlan & { isOk: true };\n provenance: GlSymbolProvenance;\n docs: GlDocContext;\n};\n\ntype EmittedReturn = {\n tsType: string;\n descriptor: string;\n expr?: (call: string) => string;\n};\n\ntype GenSingularShape = {\n countScalar: GlScalar;\n outScalar: GlScalar;\n objectClass: string;\n};\n\nconst GL_LIB_EXPRESSION = \"LIB\";\nconst GEN_FAMILY = /^gl(Gen|Create)[A-Z][A-Za-z]*s$/;\nconst DELETE_FAMILY = /^glDelete[A-Z][A-Za-z]*s$/;\n\nconst glBind = (name: string, argList: string, returnType: string): string =>\n tBind({\n libExpr: GL_LIB_EXPRESSION,\n symbolExpr: sourceStringLiteral(name),\n argList,\n returnType,\n });\n\nconst singularize = (plural: string): string =>\n plural.endsWith(\"ies\") ? `${plural.slice(0, -3)}y` : plural.replace(/s$/, \"\");\n\nconst renderDescriptorList = (descriptors: string[]): string =>\n descriptors.length === 0 ? \"[]\" : `[${descriptors.join(\", \")}]`;\n\nconst buildEmittedReturn = (\n plan: ReturnPlan,\n returnGroup: string | undefined,\n usedTypes: Set<string>,\n): EmittedReturn => {\n const tsType = trackInto(usedTypes)(returnPlanTsType(plan, returnGroup));\n const cast = (call: string): string => `${call} as ${tsType}`;\n\n switch (plan.kind) {\n case \"void\": {\n return { tsType, descriptor: tVoid };\n }\n case \"scalar\": {\n return { tsType, descriptor: plan.scalar.descriptor, expr: cast };\n }\n case \"boolean\": {\n return { tsType, descriptor: tUint8, expr: (call) => `(${call} as number) !== 0` };\n }\n case \"string\": {\n return { tsType, descriptor: tString(\"borrowed\"), expr: cast };\n }\n case \"sync\": {\n return { tsType, descriptor: tInlineStruct(), expr: cast };\n }\n case \"opaque-pointer\": {\n return { tsType, descriptor: tInlineStruct(), expr: cast };\n }\n }\n};\n\nconst returnTsType = (returned: EmittedReturn, outs: OutArg[]): string => {\n if (outs.length === 0) {\n return returned.tsType;\n }\n\n const outTypes = outs.map((out) => out.tsType);\n\n if (returned.expr === undefined) {\n return outTypes.length === 1 && outTypes[0] !== undefined ? outTypes[0] : `[${outTypes.join(\", \")}]`;\n }\n\n return `[${returned.tsType}, ${outTypes.join(\", \")}]`;\n};\n\nconst returnNoOut = (call: string, returned: EmittedReturn): string[] =>\n returned.expr === undefined ? [`${call};`] : [`return ${returned.expr(call)};`];\n\nconst returnStatements = (call: string, returned: EmittedReturn, outs: OutArg[]): string[] => {\n if (outs.length === 0) {\n return returnNoOut(call, returned);\n }\n\n const outValues = outs.map((out) => `${out.cellName}.value`);\n\n if (returned.expr === undefined) {\n const [single] = outValues;\n\n const tail =\n single !== undefined && outValues.length === 1\n ? `return ${single};`\n : `return [${outValues.join(\", \")}];`;\n\n return [`${call};`, tail];\n }\n\n return [`const result = ${call};`, `return [${returned.expr(\"result\")}, ${outValues.join(\", \")}];`];\n};\n\nconst renderCommand = (\n plan: CommandPlan & { isOk: true },\n provenance: GlSymbolProvenance,\n usedTypes: Set<string>,\n docs: GlDocContext,\n): RenderedCommand => {\n const { command } = plan;\n const exportName = commandExportName(command.name);\n const { args, ins, outs } = planArgs(plan, usedTypes);\n const returned = buildEmittedReturn(plan.returnPlan, command.returnGroup, usedTypes);\n const signature = ins.map((arg) => `${arg.name}: ${arg.tsType}`).join(\", \");\n const argNames = args.map((arg) => (arg.isOut ? arg.cellName : arg.name)).join(\", \");\n const descriptors = renderDescriptorList(args.map((arg) => arg.descriptor));\n const tsReturn = returnTsType(returned, outs);\n const jsDoc = commandJsDoc({ plan, provenance, ins, outs, docs });\n const seeds = outs.map((out) => out.seed);\n const bindExpression = glBind(command.name, descriptors, returned.descriptor);\n const isInline = plan.params.some((paramPlan) => paramPlan.kind === \"string-out\");\n const bindingName = isInline ? \"binding\" : toCamelIdentifier(command.name);\n\n const body = [\n ...seeds,\n ...(isInline ? [`const ${bindingName} = ${bindExpression};`] : []),\n ...returnStatements(`${bindingName}(${argNames})`, returned, outs),\n ]\n .map((line) => ` ${line}`)\n .join(\"\\n\");\n\n return {\n exportName,\n ...(!isInline && { binding: `const ${bindingName} = ${bindExpression};` }),\n declaration: `${jsDoc}\\nexport function ${exportName}(${signature}): ${tsReturn} {\\n${body}\\n}`,\n };\n};\n\nconst singularCommandJsDoc = (context: SingularContext, summary: string, body: string[]): string =>\n derivedJsDoc({\n command: context.plan.command,\n provenance: context.provenance,\n docs: context.docs,\n summary,\n body,\n });\n\nconst genSingularScalars = (\n plan: CommandPlan & { isOk: true },\n): { countScalar: GlScalar; outScalar: GlScalar; lenParamName: string } | undefined => {\n const countPlan = plan.params.at(-2);\n\n if (countPlan?.kind !== \"scalar\") {\n return undefined;\n }\n\n const outPlan = plan.params.at(-1);\n\n if (outPlan?.kind !== \"ref-array-out\") {\n return undefined;\n }\n\n return { countScalar: countPlan.scalar, outScalar: outPlan.scalar, lenParamName: outPlan.lenParamName };\n};\n\nconst genSingularObjectClass = (plan: CommandPlan & { isOk: true }, lenParamName: string): string | undefined => {\n const countParam = plan.command.params[plan.params.length - 2];\n const outParam = plan.command.params[plan.params.length - 1];\n\n if (countParam === undefined || outParam === undefined) {\n return undefined;\n }\n\n if (lenParamName !== countParam.name) {\n return undefined;\n }\n\n return outParam.objectClass;\n};\n\nconst genSingularShape = (plan: CommandPlan & { isOk: true }): GenSingularShape | undefined => {\n const scalars = genSingularScalars(plan);\n\n if (scalars === undefined) {\n return undefined;\n }\n\n const objectClass = genSingularObjectClass(plan, scalars.lenParamName);\n\n if (objectClass === undefined) {\n return undefined;\n }\n\n return { countScalar: scalars.countScalar, outScalar: scalars.outScalar, objectClass };\n};\n\nconst genSingularJsDoc = (context: SingularContext, prefix: InArg[], shape: GenSingularShape): string => {\n const { command } = context.plan;\n\n return singularCommandJsDoc(\n context,\n `Returns one ${shape.objectClass} object name via ` +\n `\\`${command.name}(${prefix.length > 0 ? \"..., \" : \"\"}1, ...)\\`.`,\n [\n ...prefix.map((arg) => inParamDocLine(context.plan, arg, context.docs)),\n ` * @returns \\`${shape.outScalar.tsAlias}\\`, object class \\`${shape.objectClass}\\``,\n ],\n );\n};\n\nconst deriveGenSingular = (\n plan: CommandPlan & { isOk: true },\n provenance: GlSymbolProvenance,\n usedTypes: Set<string>,\n docs: GlDocContext,\n): RenderedCommand | undefined => {\n if (!GEN_FAMILY.test(plan.command.name)) {\n return undefined;\n }\n\n const shape = genSingularShape(plan);\n\n if (shape === undefined) {\n return undefined;\n }\n\n const prefix = scalarPrefixArgs(plan, usedTypes);\n\n if (prefix === undefined) {\n return undefined;\n }\n\n const { countScalar, outScalar } = shape;\n const exportName = singularize(commandExportName(plan.command.name));\n const bindingName = `${plan.command.name}Single`;\n const descriptors = [...prefix.map((arg) => arg.descriptor), countScalar.descriptor, tRef(outScalar.descriptor)];\n usedTypes.add(outScalar.tsAlias);\n const signature = prefix.map((arg) => `${arg.name}: ${arg.tsType}`).join(\", \");\n const callArgs = [...prefix.map((arg) => arg.name), \"1\", \"out\"].join(\", \");\n const jsDoc = genSingularJsDoc({ plan, provenance, docs }, prefix, shape);\n\n const body = [\" const out = { value: 0 };\", ` ${bindingName}(${callArgs});`, \" return out.value;\"].join(\n \"\\n\",\n );\n\n const binding = glBind(plan.command.name, renderDescriptorList(descriptors), tVoid);\n\n return {\n exportName,\n binding: `const ${bindingName} = ${binding};`,\n declaration: `${jsDoc}\\nexport function ${exportName}(${signature}): ${outScalar.tsAlias} {\\n${body}\\n}`,\n };\n};\n\nconst deleteSingularAlias = (plan: CommandPlan & { isOk: true }): string | undefined => {\n if (plan.params.length !== 2) {\n return undefined;\n }\n\n const [countPlan, arrayPlan] = plan.params;\n\n if (countPlan?.kind !== \"scalar\") {\n return undefined;\n }\n\n if (arrayPlan?.kind !== \"array-in\") {\n return undefined;\n }\n\n return arrayPlan.scalar.tsAlias;\n};\n\nconst deleteSingularObjectClass = (plan: CommandPlan & { isOk: true }): string | undefined => {\n const [countParam, arrayParam] = plan.command.params;\n\n if (countParam === undefined || arrayParam === undefined) {\n return undefined;\n }\n\n if (arrayParam.len !== countParam.name) {\n return undefined;\n }\n\n return arrayParam.objectClass;\n};\n\nconst deriveDeleteSingular = (\n plan: CommandPlan & { isOk: true },\n provenance: GlSymbolProvenance,\n usedTypes: Set<string>,\n docs: GlDocContext,\n): RenderedCommand | undefined => {\n if (!DELETE_FAMILY.test(plan.command.name)) {\n return undefined;\n }\n\n const scalarAlias = deleteSingularAlias(plan);\n\n if (scalarAlias === undefined) {\n return undefined;\n }\n\n const objectClass = deleteSingularObjectClass(plan);\n\n if (objectClass === undefined) {\n return undefined;\n }\n\n usedTypes.add(scalarAlias);\n const exportName = singularize(commandExportName(plan.command.name));\n\n const jsDoc = singularCommandJsDoc(\n { plan, provenance, docs },\n `Deletes one ${objectClass} object name via \\`${plan.command.name}(1, ...)\\`.`,\n [` * @param name - \\`${scalarAlias}\\`, object class \\`${objectClass}\\``],\n );\n\n return {\n exportName,\n declaration:\n `${jsDoc}\\nexport function ${exportName}(name: ${scalarAlias}): void {\\n` +\n ` ${plan.command.name}(1, [name]);\\n}`,\n };\n};\n\nexport { renderCommand, deriveGenSingular, deriveDeleteSingular, type RenderedCommand };\n"]}
@@ -5,11 +5,28 @@ type GlSelection = {
5
5
  version: number;
6
6
  profile: GlProfile;
7
7
  };
8
+ type GlSymbolKind = "command" | "enum";
9
+ type GlRemoval = {
10
+ feature: string;
11
+ comment?: string;
12
+ };
13
+ type GlSymbolProvenance = {
14
+ feature: string;
15
+ requireComment?: string;
16
+ removals: GlRemoval[];
17
+ };
18
+ type GlRemovedSymbol = {
19
+ name: string;
20
+ kind: GlSymbolKind;
21
+ feature: string;
22
+ comment?: string;
23
+ };
8
24
  type GlSubset = {
9
- commands: Map<string, string>;
10
- enums: Map<string, string>;
25
+ commands: Map<string, GlSymbolProvenance>;
26
+ enums: Map<string, GlSymbolProvenance>;
27
+ removed: GlRemovedSymbol[];
11
28
  };
12
29
  declare const selectSubset: (registry: GlRegistry, selection: GlSelection) => GlSubset;
13
- declare const resolveEnum: (registry: GlRegistry, name: string) => GlEnum;
14
- export { selectSubset, resolveEnum, type GlSelection };
30
+ declare const resolveEnum: (registry: GlRegistry, name: string, api: string) => GlEnum;
31
+ export { selectSubset, resolveEnum, type GlRemoval, type GlSelection, type GlSubset, type GlSymbolProvenance };
15
32
  //# sourceMappingURL=select.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../src/khronos/select.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAA+B,UAAU,EAAE,MAAM,YAAY,CAAC;AAElF,KAAK,SAAS,GAAG,MAAM,CAAC;AAExB,KAAK,WAAW,GAAG;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF,KAAK,QAAQ,GAAG;IACZ,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B,CAAC;AAsDF,QAAA,MAAM,YAAY,GAAI,UAAU,UAAU,EAAE,WAAW,WAAW,KAAG,QAiBpE,CAAC;AAEF,QAAA,MAAM,WAAW,GAAI,UAAU,UAAU,EAAE,MAAM,MAAM,KAAG,MAQzD,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,CAAC"}
1
+ {"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../src/khronos/select.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAA+B,UAAU,EAAE,MAAM,YAAY,CAAC;AAElF,KAAK,SAAS,GAAG,MAAM,CAAC;AAExB,KAAK,WAAW,GAAG;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF,KAAK,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;AAEvC,KAAK,SAAS,GAAG;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,SAAS,EAAE,CAAC;CACzB,CAAC;AAEF,KAAK,eAAe,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,KAAK,QAAQ,GAAG;IACZ,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC1C,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACvC,OAAO,EAAE,eAAe,EAAE,CAAC;CAC9B,CAAC;AAmEF,QAAA,MAAM,YAAY,GAAI,UAAU,UAAU,EAAE,WAAW,WAAW,KAAG,QAqBpE,CAAC;AAEF,QAAA,MAAM,WAAW,GAAI,UAAU,UAAU,EAAE,MAAM,MAAM,EAAE,KAAK,MAAM,KAAG,MAUtE,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EAAE,CAAC"}
@@ -1,52 +1,65 @@
1
- const isBlockApplicable = (block, selection) => block.profile === undefined || block.profile === selection.profile;
2
- const addMissing = (target, names, value) => {
3
- for (const name of names) {
4
- if (!target.has(name)) {
5
- target.set(name, value);
6
- }
1
+ import { sortStringsBy } from "@gtkx/utils";
2
+ const isBlockApplicable = (block, selection) => (block.profile === undefined || block.profile === selection.profile) &&
3
+ (block.api === undefined || block.api === selection.api);
4
+ const targetFor = (state, kind) => kind === "command" ? state.commands : state.enums;
5
+ const commentEntry = (comment) => comment === undefined ? {} : { comment };
6
+ const requireMember = (state, name, context) => {
7
+ const target = targetFor(state, context.kind);
8
+ if (target.has(name)) {
9
+ return;
7
10
  }
11
+ const { block, feature } = context;
12
+ target.set(name, {
13
+ feature: feature.name,
14
+ ...(block.comment !== undefined && { requireComment: block.comment }),
15
+ removals: [...(state.history.get(name) ?? [])],
16
+ });
8
17
  };
9
- const applyRequires = (feature, selection, commands, enums) => {
10
- for (const block of feature.requires) {
11
- if (!isBlockApplicable(block, selection)) {
12
- continue;
13
- }
14
- addMissing(commands, block.commands, feature.name);
15
- addMissing(enums, block.enums, feature.name);
16
- }
18
+ const removeMember = (state, name, context) => {
19
+ const { block, feature, kind } = context;
20
+ const removal = { feature: feature.name, ...commentEntry(block.comment) };
21
+ targetFor(state, kind).delete(name);
22
+ state.history.set(name, [...(state.history.get(name) ?? []), removal]);
23
+ state.removed.push({ name, kind, ...removal });
17
24
  };
18
- const removeBlock = (block, commands, enums) => {
19
- for (const name of block.commands) {
20
- commands.delete(name);
21
- }
22
- for (const name of block.enums) {
23
- enums.delete(name);
25
+ const applyMembers = (state, names, context) => {
26
+ const apply = context.block.kind === "require" ? requireMember : removeMember;
27
+ for (const name of names) {
28
+ apply(state, name, context);
24
29
  }
25
30
  };
26
- const applyRemoves = (feature, selection, commands, enums) => {
27
- for (const block of feature.removes) {
28
- if (!isBlockApplicable(block, selection)) {
29
- continue;
31
+ const applyBlock = (state, feature, block) => {
32
+ applyMembers(state, block.commands, { feature, block, kind: "command" });
33
+ applyMembers(state, block.enums, { feature, block, kind: "enum" });
34
+ };
35
+ const applyFeature = (state, feature, selection) => {
36
+ for (const block of feature.blocks) {
37
+ if (isBlockApplicable(block, selection)) {
38
+ applyBlock(state, feature, block);
30
39
  }
31
- removeBlock(block, commands, enums);
32
40
  }
33
41
  };
34
42
  const selectSubset = (registry, selection) => {
35
43
  const features = registry.features
36
44
  .filter((feature) => feature.api === selection.api && feature.number <= selection.version)
37
45
  .toSorted((a, b) => a.number - b.number);
38
- const commands = new Map();
39
- const enums = new Map();
40
- for (const feature of features) {
41
- applyRequires(feature, selection, commands, enums);
42
- }
46
+ const state = {
47
+ commands: new Map(),
48
+ enums: new Map(),
49
+ removed: [],
50
+ history: new Map(),
51
+ };
43
52
  for (const feature of features) {
44
- applyRemoves(feature, selection, commands, enums);
53
+ applyFeature(state, feature, selection);
45
54
  }
46
- return { commands, enums };
55
+ return {
56
+ commands: state.commands,
57
+ enums: state.enums,
58
+ removed: sortStringsBy(state.removed, (entry) => entry.name),
59
+ };
47
60
  };
48
- const resolveEnum = (registry, name) => {
49
- const found = registry.enums.find((candidate) => candidate.name === name);
61
+ const resolveEnum = (registry, name, api) => {
62
+ const found = registry.enums.find((candidate) => candidate.name === name && (candidate.api === undefined || candidate.api === api));
50
63
  if (found === undefined) {
51
64
  throw new Error(`Enum token ${name} has no definition in the registry`);
52
65
  }