@symbo.ls/utils 3.14.756 → 3.14.768
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.
- package/CHANGELOG.md +6 -0
- package/methods.js +19 -0
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
package/methods.js
CHANGED
|
@@ -31,6 +31,25 @@ export function spotByPath (path) {
|
|
|
31
31
|
}
|
|
32
32
|
|
|
33
33
|
// TODO: update these files
|
|
34
|
+
//
|
|
35
|
+
// ⚠️ DEPRECATED / NOT the `el.lookup` you get on a DOMQL element.
|
|
36
|
+
//
|
|
37
|
+
// The LIVE implementation is `@symbo.ls/element` `src/methods.js` — it is
|
|
38
|
+
// bound onto every element by `addMethods`, and it calls its predicate with
|
|
39
|
+
// exactly ONE argument (the candidate element). This twin calls
|
|
40
|
+
// `param(parent, parent.state, parent.context)` — THREE arguments — and is
|
|
41
|
+
// additionally gated on `parent.state` existing.
|
|
42
|
+
//
|
|
43
|
+
// `element/src/methods.js` deliberately does NOT import this function, and
|
|
44
|
+
// nothing in the monorepo imports it either (verified 2026-08-11); it stays
|
|
45
|
+
// exported only because `index.js` re-exports this file wholesale and
|
|
46
|
+
// removing a public export is a release-gated breaking change.
|
|
47
|
+
//
|
|
48
|
+
// It is, however, actively harmful as documentation: its 3-arg shape is why
|
|
49
|
+
// authors keep writing `el.lookup((el, s) => …)`, which throws against the
|
|
50
|
+
// real 1-arg implementation. Four such sites were live in `workspace` until
|
|
51
|
+
// 2026-08-10 (workspace `34884e6a`). If you are reading this to learn the
|
|
52
|
+
// signature, read `element/src/methods.js` instead.
|
|
34
53
|
export function lookup (param) {
|
|
35
54
|
const el = this
|
|
36
55
|
let { parent } = el
|