@marcozvd/basics-core 1.7.0 → 1.9.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 (52) hide show
  1. package/README.md +7 -7
  2. package/dist/api.d.ts +1 -1
  3. package/dist/api.d.ts.map +1 -1
  4. package/dist/compare-api.d.ts +111 -0
  5. package/dist/compare-api.d.ts.map +1 -0
  6. package/dist/compare-api.js +2 -0
  7. package/dist/compare-api.js.map +1 -0
  8. package/dist/detect.d.ts +1 -1
  9. package/dist/detect.d.ts.map +1 -1
  10. package/dist/detect.js +83 -0
  11. package/dist/detect.js.map +1 -1
  12. package/dist/detection-packages.d.ts +5 -0
  13. package/dist/detection-packages.d.ts.map +1 -0
  14. package/dist/detection-packages.js +31 -0
  15. package/dist/detection-packages.js.map +1 -0
  16. package/dist/eval.d.ts +5 -2
  17. package/dist/eval.d.ts.map +1 -1
  18. package/dist/eval.js +3 -0
  19. package/dist/eval.js.map +1 -1
  20. package/dist/index.d.ts +3 -0
  21. package/dist/index.d.ts.map +1 -1
  22. package/dist/index.js +3 -0
  23. package/dist/index.js.map +1 -1
  24. package/dist/outcome.d.ts +1 -0
  25. package/dist/outcome.d.ts.map +1 -1
  26. package/dist/outcome.js +1 -0
  27. package/dist/outcome.js.map +1 -1
  28. package/dist/pack-tasks.d.ts +12 -0
  29. package/dist/pack-tasks.d.ts.map +1 -0
  30. package/dist/pack-tasks.js +36 -0
  31. package/dist/pack-tasks.js.map +1 -0
  32. package/dist/packs.d.ts +6 -0
  33. package/dist/packs.d.ts.map +1 -1
  34. package/dist/packs.js +99 -9
  35. package/dist/packs.js.map +1 -1
  36. package/dist/query.d.ts +3 -0
  37. package/dist/query.d.ts.map +1 -1
  38. package/dist/query.js +102 -60
  39. package/dist/query.js.map +1 -1
  40. package/dist/recommend-history.d.ts +31 -0
  41. package/dist/recommend-history.d.ts.map +1 -0
  42. package/dist/recommend-history.js +47 -0
  43. package/dist/recommend-history.js.map +1 -0
  44. package/dist/schema.d.ts +10 -0
  45. package/dist/schema.d.ts.map +1 -1
  46. package/dist/schema.js +2 -0
  47. package/dist/schema.js.map +1 -1
  48. package/dist/tech-names.d.ts +9 -0
  49. package/dist/tech-names.d.ts.map +1 -0
  50. package/dist/tech-names.js +96 -0
  51. package/dist/tech-names.js.map +1 -0
  52. package/package.json +1 -1
@@ -0,0 +1,96 @@
1
+ import { tokens } from "./tokens.js";
2
+ import { toId } from "./vault.js";
3
+ // Only known collisions, shared by IDs, titles and package aliases. Ecosystems
4
+ // come from vault metadata, not this vocabulary. Extend when a collision is found.
5
+ const ambiguousNames = new Set(["poem", "rocket", "echo", "fiber", "swift", "next"]);
6
+ const stackCues = new Set([
7
+ "api",
8
+ "http",
9
+ "rest",
10
+ "framework",
11
+ "server",
12
+ "backend",
13
+ "crate",
14
+ "package",
15
+ "library",
16
+ "language",
17
+ "servidor",
18
+ "paquete",
19
+ "biblioteca",
20
+ "lenguaje",
21
+ ]);
22
+ const languagePrepositions = new Set(["in", "using", "en", "con"]);
23
+ // Platform aliases, not language assignments. Vault use_when/tags determine
24
+ // which language ecosystems use the platform family (including cross-platform ones).
25
+ const platformFamilies = [["apple", "ios", "macos", "xcode"]];
26
+ /** Raw name words, without stemming; shared with weighted name matching. */
27
+ export function nameParts(names) {
28
+ return names
29
+ .normalize("NFD")
30
+ .replace(/[\u0300-\u036f]/g, "")
31
+ .toLowerCase()
32
+ .split(/[^a-z0-9+#]+/)
33
+ .filter(Boolean);
34
+ }
35
+ export function techNameContext(techs, positive) {
36
+ const words = nameParts(positive);
37
+ const query = new Set(tokens(positive));
38
+ const languageOf = (note) => {
39
+ const data = note.data;
40
+ return data.kind === "language" ? note.id : data.language && toId(data.language);
41
+ };
42
+ const ecosystemWords = new Map();
43
+ for (const note of techs) {
44
+ const language = languageOf(note);
45
+ if (!language)
46
+ continue;
47
+ const data = note.data;
48
+ const vocabulary = ecosystemWords.get(language) ?? new Set();
49
+ for (const word of nameParts([...data.tags, ...data.use_when].join(" ")))
50
+ vocabulary.add(word);
51
+ ecosystemWords.set(language, vocabulary);
52
+ }
53
+ const platformContext = (language) => platformFamilies.some((family) => family.some((word) => words.includes(word)) && family.some((word) => ecosystemWords.get(language)?.has(word)));
54
+ const matches = techs.flatMap((note) => {
55
+ const data = note.data;
56
+ return [note.id, data.title ?? note.id, ...Object.values(data.packages ?? {}).flat()].flatMap((name) => {
57
+ const parts = nameParts(name);
58
+ return words.flatMap((_, start) => {
59
+ if (!parts.length || !parts.every((part, i) => part === words[start + i]))
60
+ return [];
61
+ const ambiguous = parts.length === 1 && ambiguousNames.has(parts[0]);
62
+ // At most one intervening word: Echo REST API qualifies; fiber network
63
+ // inventory API does not attach its distant API cue to the word fiber.
64
+ const nearby = [...words.slice(Math.max(0, start - 2), start), ...words.slice(start + parts.length, start + parts.length + 2)];
65
+ const languageContext = data.kind === "language" && (languagePrepositions.has(words[start - 1]) || platformContext(note.id));
66
+ return [{ note, parts, qualified: !ambiguous || languageContext || nearby.some((word) => stackCues.has(word)) }];
67
+ });
68
+ });
69
+ });
70
+ const mentioned = new Set();
71
+ // Keep language aliases such as Golang, while ambiguous Swift needs context.
72
+ for (const note of techs) {
73
+ if (note.data.type !== "tech" || note.data.kind !== "language")
74
+ continue;
75
+ if ([...tokens(note.id), ...tokens(note.data.title ?? note.id)].some((word) => !ambiguousNames.has(word) && query.has(word)))
76
+ mentioned.add(note.id);
77
+ }
78
+ for (const match of matches.filter((match) => match.qualified)) {
79
+ const language = languageOf(match.note);
80
+ if (language)
81
+ mentioned.add(language);
82
+ }
83
+ const named = new Set();
84
+ const allowedWords = new Set();
85
+ for (const match of matches) {
86
+ const language = languageOf(match.note);
87
+ if (!match.qualified && (!language || !mentioned.has(language)))
88
+ continue;
89
+ named.add(match.note.id);
90
+ for (const word of match.parts)
91
+ allowedWords.add(word);
92
+ }
93
+ const blocked = new Set([...ambiguousNames].filter((word) => !allowedWords.has(word)));
94
+ return { named, mentioned, blocked };
95
+ }
96
+ //# sourceMappingURL=tech-names.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tech-names.js","sourceRoot":"","sources":["../src/tech-names.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@marcozvd/basics-core",
3
- "version": "1.7.0",
3
+ "version": "1.9.0",
4
4
  "description": "Core library for Basics: vault parsing, search and stack recommendation",
5
5
  "type": "module",
6
6
  "license": "MIT",