@needle-tools/addressing 0.3.4 → 0.4.0-1791982227.dramatic-tempura.8b3a85e

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 (58) hide show
  1. package/Readme.md +151 -70
  2. package/dist/address.d.ts +5 -0
  3. package/dist/address.js +25 -3
  4. package/dist/document/assets.d.ts +27 -0
  5. package/dist/document/assets.js +75 -0
  6. package/dist/document/collectionSelector.d.ts +9 -0
  7. package/dist/document/collectionSelector.js +29 -0
  8. package/dist/document/evaluate.d.ts +86 -0
  9. package/dist/document/evaluate.js +1082 -0
  10. package/dist/document/index.d.ts +11 -0
  11. package/dist/document/index.js +11 -0
  12. package/dist/document/inspection.d.ts +30 -0
  13. package/dist/document/inspection.js +130 -0
  14. package/dist/document/loadedDocument.d.ts +18 -0
  15. package/dist/document/loadedDocument.js +35 -0
  16. package/dist/document/references.d.ts +7 -0
  17. package/dist/document/references.js +36 -0
  18. package/dist/document/runtime.d.ts +119 -0
  19. package/dist/document/runtime.js +1 -0
  20. package/dist/document/types.d.ts +240 -0
  21. package/dist/document/types.js +43 -0
  22. package/dist/document/validation.d.ts +36 -0
  23. package/dist/document/validation.js +222 -0
  24. package/dist/document/valueCodecs.d.ts +20 -0
  25. package/dist/document/valueCodecs.js +3 -0
  26. package/dist/document/write.d.ts +31 -0
  27. package/dist/document/write.js +131 -0
  28. package/dist/id.d.ts +2 -0
  29. package/dist/id.js +4 -0
  30. package/dist/index.d.ts +2 -1
  31. package/dist/index.js +2 -1
  32. package/dist/loadedGltf.d.ts +32 -0
  33. package/dist/loadedGltf.js +62 -0
  34. package/dist/resolve.js +8 -6
  35. package/package.json +10 -2
  36. package/src/address.ts +169 -144
  37. package/src/anchor.ts +71 -71
  38. package/src/document/assets.ts +77 -0
  39. package/src/document/collectionSelector.ts +37 -0
  40. package/src/document/evaluate.ts +1111 -0
  41. package/src/document/index.ts +11 -0
  42. package/src/document/inspection.ts +123 -0
  43. package/src/document/loadedDocument.ts +48 -0
  44. package/src/document/references.ts +41 -0
  45. package/src/document/runtime.ts +113 -0
  46. package/src/document/schema.json +293 -0
  47. package/src/document/types.ts +265 -0
  48. package/src/document/validation.ts +226 -0
  49. package/src/document/valueCodecs.ts +23 -0
  50. package/src/document/write.ts +132 -0
  51. package/src/gltf.ts +33 -33
  52. package/src/hash.ts +58 -58
  53. package/src/id.ts +206 -201
  54. package/src/index.ts +49 -46
  55. package/src/loadedGltf.ts +93 -0
  56. package/src/resolve.ts +319 -317
  57. package/src/target.ts +126 -126
  58. package/src/uuid.ts +48 -48
@@ -0,0 +1,37 @@
1
+ export interface DocumentCollectionSelectorOptions {
2
+ matchesComponentType?(component: object, name: string): boolean;
3
+ matchesComponentGuid?(component: object, guid: string): boolean;
4
+ deriveComponentGuid?(referenceId: string, fileGuid: string): string;
5
+ referenceId?: string;
6
+ report?(message: string): void;
7
+ }
8
+
9
+ /** Resolve an index or field qualifier; ambiguous identities never select an arbitrary member. */
10
+ export function resolveDocumentCollectionElement(
11
+ collection: readonly unknown[], selector: string, options: DocumentCollectionSelectorOptions = {},
12
+ ): unknown {
13
+ if (/^\d+$/.test(selector)) return collection[Number(selector)];
14
+ const qualifier = /^([A-Za-z_][A-Za-z0-9_-]*):([\s\S]*)$/.exec(selector);
15
+ if (!qualifier) {
16
+ options.report?.(`"${selector}" is neither an index nor a <field>:<value> qualifier`);
17
+ return undefined;
18
+ }
19
+ const [, field, value] = qualifier;
20
+ const elements = collection.filter((element): element is Record<string, unknown> =>
21
+ element !== null && typeof element === "object");
22
+ let matches = elements.filter(element => {
23
+ if (field === "type") return options.matchesComponentType?.(element, value) ?? element.constructor?.name === value;
24
+ if (field === "guid") return options.matchesComponentGuid?.(element, value)
25
+ ?? (element.guid === value || element.needle_editor_guid === value);
26
+ return element[field] === value;
27
+ });
28
+ if (!matches.length && field === "guid" && options.referenceId && options.deriveComponentGuid) {
29
+ const derived = options.deriveComponentGuid(options.referenceId, value);
30
+ matches = elements.filter(element => element.guid === derived);
31
+ }
32
+ if (matches.length > 1) {
33
+ options.report?.(`"${selector}" matched ${matches.length} elements ? the document must name one unambiguously`);
34
+ return undefined;
35
+ }
36
+ return matches[0];
37
+ }