@tokioapp/adblock 0.0.0-stage → 0.1.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 (143) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +72 -2
  3. package/THIRD_PARTY_NOTICES.md +50 -0
  4. package/dist/content/cosmetics.d.ts +22 -0
  5. package/dist/content/cosmetics.js +173 -0
  6. package/dist/content/mainWorld.d.ts +8 -0
  7. package/dist/content/mainWorld.js +10 -0
  8. package/dist/content/preload.d.ts +1 -0
  9. package/dist/content/preload.js +34 -0
  10. package/dist/content/procedural.d.ts +19 -0
  11. package/dist/content/procedural.js +212 -0
  12. package/dist/cosmetic/engine.d.ts +95 -0
  13. package/dist/cosmetic/engine.js +268 -0
  14. package/dist/electron/blocker.d.ts +84 -0
  15. package/dist/electron/blocker.js +320 -0
  16. package/dist/electron/channels.d.ts +10 -0
  17. package/dist/electron/channels.js +6 -0
  18. package/dist/electron/scheme.d.ts +21 -0
  19. package/dist/electron/scheme.js +21 -0
  20. package/dist/engine.d.ts +86 -0
  21. package/dist/engine.js +163 -0
  22. package/dist/index.d.ts +13 -0
  23. package/dist/index.js +12 -0
  24. package/dist/lists/defaults.d.ts +6 -0
  25. package/dist/lists/defaults.js +59 -0
  26. package/dist/lists/manager.d.ts +86 -0
  27. package/dist/lists/manager.js +154 -0
  28. package/dist/lists/preprocessor.d.ts +21 -0
  29. package/dist/lists/preprocessor.js +152 -0
  30. package/dist/lists/storage.d.ts +37 -0
  31. package/dist/lists/storage.js +66 -0
  32. package/dist/network/engine.d.ts +105 -0
  33. package/dist/network/engine.js +431 -0
  34. package/dist/network/filterIndex.d.ts +40 -0
  35. package/dist/network/filterIndex.js +343 -0
  36. package/dist/network/modifiers.d.ts +23 -0
  37. package/dist/network/modifiers.js +192 -0
  38. package/dist/network/pattern.d.ts +7 -0
  39. package/dist/network/pattern.js +145 -0
  40. package/dist/network/request.d.ts +50 -0
  41. package/dist/network/request.js +136 -0
  42. package/dist/network/tokens.d.ts +5 -0
  43. package/dist/network/tokens.js +150 -0
  44. package/dist/parser/cosmetic.d.ts +21 -0
  45. package/dist/parser/cosmetic.js +171 -0
  46. package/dist/parser/hosts.d.ts +20 -0
  47. package/dist/parser/hosts.js +143 -0
  48. package/dist/parser/index.d.ts +40 -0
  49. package/dist/parser/index.js +158 -0
  50. package/dist/parser/network.d.ts +6 -0
  51. package/dist/parser/network.js +474 -0
  52. package/dist/parser/selector.d.ts +25 -0
  53. package/dist/parser/selector.js +522 -0
  54. package/dist/parser/types.d.ts +175 -0
  55. package/dist/parser/types.js +75 -0
  56. package/dist/preload.cjs +1988 -0
  57. package/dist/psl/psl.d.ts +32 -0
  58. package/dist/psl/psl.js +119 -0
  59. package/dist/resources/binary.d.ts +9 -0
  60. package/dist/resources/binary.js +54 -0
  61. package/dist/resources/defusers.d.ts +29 -0
  62. package/dist/resources/defusers.js +180 -0
  63. package/dist/resources/documents.d.ts +12 -0
  64. package/dist/resources/documents.js +56 -0
  65. package/dist/resources/ima.d.ts +6 -0
  66. package/dist/resources/ima.js +313 -0
  67. package/dist/resources/index.d.ts +14 -0
  68. package/dist/resources/index.js +85 -0
  69. package/dist/resources/surrogates.d.ts +30 -0
  70. package/dist/resources/surrogates.js +486 -0
  71. package/dist/scriptlets/abort.d.ts +5 -0
  72. package/dist/scriptlets/abort.js +97 -0
  73. package/dist/scriptlets/dom/attributes.d.ts +5 -0
  74. package/dist/scriptlets/dom/attributes.js +92 -0
  75. package/dist/scriptlets/dom/click.d.ts +2 -0
  76. package/dist/scriptlets/dom/click.js +107 -0
  77. package/dist/scriptlets/dom/cookies.d.ts +16 -0
  78. package/dist/scriptlets/dom/cookies.js +194 -0
  79. package/dist/scriptlets/dom/createHtml.d.ts +2 -0
  80. package/dist/scriptlets/dom/createHtml.js +27 -0
  81. package/dist/scriptlets/dom/dialogs.d.ts +3 -0
  82. package/dist/scriptlets/dom/dialogs.js +21 -0
  83. package/dist/scriptlets/dom/hrefSanitizer.d.ts +2 -0
  84. package/dist/scriptlets/dom/hrefSanitizer.js +91 -0
  85. package/dist/scriptlets/dom/index.d.ts +3 -0
  86. package/dist/scriptlets/dom/index.js +38 -0
  87. package/dist/scriptlets/dom/navigation.d.ts +5 -0
  88. package/dist/scriptlets/dom/navigation.js +60 -0
  89. package/dist/scriptlets/dom/nodeText.d.ts +3 -0
  90. package/dist/scriptlets/dom/nodeText.js +98 -0
  91. package/dist/scriptlets/dom/spoofCss.d.ts +2 -0
  92. package/dist/scriptlets/dom/spoofCss.js +58 -0
  93. package/dist/scriptlets/dom/storage.d.ts +5 -0
  94. package/dist/scriptlets/dom/storage.js +50 -0
  95. package/dist/scriptlets/dom/watch.d.ts +8 -0
  96. package/dist/scriptlets/dom/watch.js +41 -0
  97. package/dist/scriptlets/events.d.ts +2 -0
  98. package/dist/scriptlets/events.js +42 -0
  99. package/dist/scriptlets/helpers.d.ts +58 -0
  100. package/dist/scriptlets/helpers.js +206 -0
  101. package/dist/scriptlets/index.d.ts +6 -0
  102. package/dist/scriptlets/index.js +47 -0
  103. package/dist/scriptlets/network/edit.d.ts +9 -0
  104. package/dist/scriptlets/network/edit.js +104 -0
  105. package/dist/scriptlets/network/eval.d.ts +3 -0
  106. package/dist/scriptlets/network/eval.js +22 -0
  107. package/dist/scriptlets/network/fetch.d.ts +10 -0
  108. package/dist/scriptlets/network/fetch.js +145 -0
  109. package/dist/scriptlets/network/index.d.ts +3 -0
  110. package/dist/scriptlets/network/index.js +43 -0
  111. package/dist/scriptlets/network/jsonPath.d.ts +13 -0
  112. package/dist/scriptlets/network/jsonPath.js +482 -0
  113. package/dist/scriptlets/network/media.d.ts +3 -0
  114. package/dist/scriptlets/network/media.js +97 -0
  115. package/dist/scriptlets/network/methods.d.ts +5 -0
  116. package/dist/scriptlets/network/methods.js +139 -0
  117. package/dist/scriptlets/network/prune.d.ts +13 -0
  118. package/dist/scriptlets/network/prune.js +194 -0
  119. package/dist/scriptlets/network/rendering.d.ts +4 -0
  120. package/dist/scriptlets/network/rendering.js +46 -0
  121. package/dist/scriptlets/network/replace.d.ts +5 -0
  122. package/dist/scriptlets/network/replace.js +168 -0
  123. package/dist/scriptlets/network/request.d.ts +19 -0
  124. package/dist/scriptlets/network/request.js +124 -0
  125. package/dist/scriptlets/network/util.d.ts +19 -0
  126. package/dist/scriptlets/network/util.js +80 -0
  127. package/dist/scriptlets/network/webrtc.d.ts +3 -0
  128. package/dist/scriptlets/network/webrtc.js +62 -0
  129. package/dist/scriptlets/network/windowOpen.d.ts +2 -0
  130. package/dist/scriptlets/network/windowOpen.js +28 -0
  131. package/dist/scriptlets/network/xhr.d.ts +9 -0
  132. package/dist/scriptlets/network/xhr.js +177 -0
  133. package/dist/scriptlets/runner.d.ts +8 -0
  134. package/dist/scriptlets/runner.js +19 -0
  135. package/dist/scriptlets/setConstant.d.ts +5 -0
  136. package/dist/scriptlets/setConstant.js +117 -0
  137. package/dist/scriptlets/timers.d.ts +5 -0
  138. package/dist/scriptlets/timers.js +66 -0
  139. package/dist/scriptlets/types.d.ts +32 -0
  140. package/dist/scriptlets/types.js +1 -0
  141. package/dist/util.d.ts +5 -0
  142. package/dist/util.js +16 -0
  143. package/package.json +83 -4
@@ -0,0 +1,20 @@
1
+ import type { HostList } from "./types.js";
2
+ /**
3
+ * Lowercases a hostname and turns non-ASCII labels into punycode, as request
4
+ * URLs have them. Undefined when the text isn't a hostname.
5
+ */
6
+ export declare function normalizeHostname(text: string, allowSingleLabel?: boolean): string | undefined;
7
+ /** Whether a pattern reads as a hostname, which makes it `||hostname^`. */
8
+ export declare function isHostname(text: string): boolean;
9
+ /**
10
+ * Parses the hostnames of `domain=`, `to=` (`|` between them) or of a cosmetic
11
+ * filter (`,`). Undefined when an entry isn't a hostname, an entity or a regex.
12
+ */
13
+ export declare function parseHostList(text: string, separator: "|" | ",", allowWildcard?: boolean): HostList | undefined;
14
+ /** Whether any entry of the list matches. */
15
+ export declare function anyHostMatches(entries: readonly string[], hostname: string, entity: string): boolean;
16
+ /**
17
+ * Whether a hostname is in a list. `entity` is the hostname with its public
18
+ * suffix replaced by `*` (`www.google.*` for `www.google.co.uk`), or empty.
19
+ */
20
+ export declare function hostListMatches(list: HostList, hostname: string, entity: string): boolean;
@@ -0,0 +1,143 @@
1
+ import { domainToASCII } from "node:url";
2
+ import { tryRegex } from "../util.js";
3
+ // Labels of letters, digits, hyphens and underscores, at least two of them.
4
+ const HOSTNAME = /^(?:[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?\.)+[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?$/;
5
+ const SINGLE_LABEL = /^[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?$/;
6
+ const IPV6 = /^\[[0-9a-f:.]+\]$/;
7
+ // eslint-disable-next-line no-control-regex
8
+ const NON_ASCII = /[^\x00-\x7f]/;
9
+ /**
10
+ * Lowercases a hostname and turns non-ASCII labels into punycode, as request
11
+ * URLs have them. Undefined when the text isn't a hostname.
12
+ */
13
+ export function normalizeHostname(text, allowSingleLabel = false) {
14
+ let hostname = text.toLowerCase();
15
+ if (hostname.endsWith("."))
16
+ hostname = hostname.slice(0, -1);
17
+ if (NON_ASCII.test(hostname))
18
+ hostname = domainToASCII(hostname);
19
+ if (HOSTNAME.test(hostname) || IPV6.test(hostname))
20
+ return hostname;
21
+ if (allowSingleLabel && SINGLE_LABEL.test(hostname))
22
+ return hostname;
23
+ return undefined;
24
+ }
25
+ /** Whether a pattern reads as a hostname, which makes it `||hostname^`. */
26
+ export function isHostname(text) {
27
+ return HOSTNAME.test(text);
28
+ }
29
+ /**
30
+ * Splits a hostname list. A regex entry (`/…/`) may hold the separator, so it
31
+ * runs to the slash that the separator or the end follows.
32
+ */
33
+ function splitEntries(text, separator) {
34
+ const entries = [];
35
+ let i = 0;
36
+ while (i < text.length) {
37
+ const first = text[i] === "~" ? i + 1 : i;
38
+ if (text[first] !== "/") {
39
+ const next = text.indexOf(separator, i);
40
+ if (next === -1) {
41
+ entries.push(text.slice(i));
42
+ break;
43
+ }
44
+ entries.push(text.slice(i, next));
45
+ i = next + 1;
46
+ continue;
47
+ }
48
+ let end = -1;
49
+ for (let k = first + 1; k < text.length; k++) {
50
+ if (text[k] === "\\")
51
+ k++;
52
+ else if (text[k] === "/" &&
53
+ (k + 1 === text.length || text[k + 1] === separator)) {
54
+ end = k;
55
+ break;
56
+ }
57
+ }
58
+ if (end === -1)
59
+ return undefined;
60
+ entries.push(text.slice(i, end + 1));
61
+ i = end + 2;
62
+ }
63
+ return entries;
64
+ }
65
+ /**
66
+ * Parses the hostnames of `domain=`, `to=` (`|` between them) or of a cosmetic
67
+ * filter (`,`). Undefined when an entry isn't a hostname, an entity or a regex.
68
+ */
69
+ export function parseHostList(text, separator, allowWildcard = false) {
70
+ const entries = splitEntries(text, separator);
71
+ if (entries === undefined)
72
+ return undefined;
73
+ const list = { include: [], exclude: [] };
74
+ for (let entry of entries) {
75
+ entry = entry.trim();
76
+ if (entry === "")
77
+ continue;
78
+ const negated = entry.startsWith("~");
79
+ if (negated)
80
+ entry = entry.slice(1);
81
+ let value;
82
+ if (entry.length > 2 && entry.startsWith("/") && entry.endsWith("/")) {
83
+ if (tryRegex(entry.slice(1, -1)) === undefined)
84
+ return undefined;
85
+ value = entry;
86
+ }
87
+ else if (entry === "*") {
88
+ if (!allowWildcard || negated)
89
+ return undefined;
90
+ value = entry;
91
+ }
92
+ else if (entry.endsWith(".*")) {
93
+ const name = normalizeHostname(entry.slice(0, -2), true);
94
+ if (name !== undefined)
95
+ value = `${name}.*`;
96
+ }
97
+ else {
98
+ value = normalizeHostname(entry, true);
99
+ }
100
+ if (value === undefined)
101
+ return undefined;
102
+ (negated ? list.exclude : list.include).push(value);
103
+ }
104
+ if (list.include.length === 0 && list.exclude.length === 0)
105
+ return undefined;
106
+ return list;
107
+ }
108
+ const regexes = new Map();
109
+ function entryMatches(entry, hostname, entity) {
110
+ if (entry.charCodeAt(0) === 0x2f /* / */) {
111
+ let regex = regexes.get(entry);
112
+ if (regex === undefined) {
113
+ regex = new RegExp(entry.slice(1, -1));
114
+ regexes.set(entry, regex);
115
+ }
116
+ return regex.test(hostname);
117
+ }
118
+ if (entry === "*")
119
+ return true;
120
+ if (entry.endsWith(".*")) {
121
+ return entity !== "" && (entity === entry || entity.endsWith(`.${entry}`));
122
+ }
123
+ return (hostname === entry ||
124
+ (hostname.endsWith(entry) &&
125
+ hostname.charCodeAt(hostname.length - entry.length - 1) === 0x2e) /* . */);
126
+ }
127
+ /** Whether any entry of the list matches. */
128
+ export function anyHostMatches(entries, hostname, entity) {
129
+ for (const entry of entries) {
130
+ if (entryMatches(entry, hostname, entity))
131
+ return true;
132
+ }
133
+ return false;
134
+ }
135
+ /**
136
+ * Whether a hostname is in a list. `entity` is the hostname with its public
137
+ * suffix replaced by `*` (`www.google.*` for `www.google.co.uk`), or empty.
138
+ */
139
+ export function hostListMatches(list, hostname, entity) {
140
+ if (anyHostMatches(list.exclude, hostname, entity))
141
+ return false;
142
+ return (list.include.length === 0 || anyHostMatches(list.include, hostname, entity));
143
+ }
@@ -0,0 +1,40 @@
1
+ import { type CosmeticRule, type NetworkRule, type ParseContext, type ParsedLine, type ResponseHeaderRule, type ScriptletRule } from "./types.js";
2
+ /** How many lines of each kind a list holds. */
3
+ export interface ParseStats {
4
+ lines: number;
5
+ comments: number;
6
+ network: number;
7
+ networkExceptions: number;
8
+ cosmetic: number;
9
+ cosmeticExceptions: number;
10
+ /** Cosmetic filters that need JavaScript, counted in `cosmetic` too. */
11
+ procedural: number;
12
+ scriptlets: number;
13
+ scriptletExceptions: number;
14
+ responseHeaders: number;
15
+ /** Valid syntax the library can't apply, by reason. */
16
+ unsupported: Record<string, number>;
17
+ /** Malformed or discarded filters, by reason. */
18
+ invalid: Record<string, number>;
19
+ }
20
+ export interface ParsedList {
21
+ network: NetworkRule[];
22
+ cosmetic: CosmeticRule[];
23
+ scriptlets: ScriptletRule[];
24
+ responseHeaders: ResponseHeaderRule[];
25
+ stats: ParseStats;
26
+ }
27
+ export declare function emptyParsedList(): ParsedList;
28
+ /**
29
+ * Parses one line of a filter list and hands each result to `emit`: one per
30
+ * line, except a hosts file line, which gives a rule per hostname.
31
+ */
32
+ export declare function parseLine(raw: string, context: ParseContext, emit: (parsed: ParsedLine) => void): void;
33
+ /**
34
+ * Parses `lines[start, end)` into `list`. A caller with a long list parses it
35
+ * in slices, to give the event loop a turn between them.
36
+ */
37
+ export declare function parseInto(list: ParsedList, lines: readonly string[], context: ParseContext, start?: number, end?: number): void;
38
+ /** Parses a filter list's text, already preprocessed, into typed rules. */
39
+ export declare function parseList(text: string, context?: ParseContext): ParsedList;
40
+ export type * from "./types.js";
@@ -0,0 +1,158 @@
1
+ import { parseCosmeticFilter, splitCosmetic } from "./cosmetic.js";
2
+ import { normalizeHostname } from "./hosts.js";
3
+ import { parseNetworkFilter } from "./network.js";
4
+ import { F_EXCEPTION, P_HOST, T_DOCUMENT, T_NETWORK, } from "./types.js";
5
+ export function emptyParsedList() {
6
+ return {
7
+ network: [],
8
+ cosmetic: [],
9
+ scriptlets: [],
10
+ responseHeaders: [],
11
+ stats: {
12
+ lines: 0,
13
+ comments: 0,
14
+ network: 0,
15
+ networkExceptions: 0,
16
+ cosmetic: 0,
17
+ cosmeticExceptions: 0,
18
+ procedural: 0,
19
+ scriptlets: 0,
20
+ scriptletExceptions: 0,
21
+ responseHeaders: 0,
22
+ unsupported: {},
23
+ invalid: {},
24
+ },
25
+ };
26
+ }
27
+ const COMMENT = { kind: "comment", reason: "" };
28
+ const EXTENDED_START = /^#@?(?:\$\?|\$|\?|%)?#/;
29
+ // A hosts file line: an address that means "nowhere", then hostnames.
30
+ const HOSTS_LINE = /^(?:0\.0\.0\.0|127\.0\.0\.1|::1?|fe80::1%lo0|255\.255\.255\.255|ff0[02]::[1-3])\s+(\S.*)$/;
31
+ const LOCAL_NAMES = new Set([
32
+ "localhost",
33
+ "localhost.localdomain",
34
+ "local",
35
+ "broadcasthost",
36
+ "ip6-localhost",
37
+ "ip6-loopback",
38
+ "ip6-localnet",
39
+ "ip6-mcastprefix",
40
+ "ip6-allnodes",
41
+ "ip6-allrouters",
42
+ "ip6-allhosts",
43
+ "0.0.0.0",
44
+ ]);
45
+ /**
46
+ * Parses one line of a filter list and hands each result to `emit`: one per
47
+ * line, except a hosts file line, which gives a rule per hostname.
48
+ */
49
+ export function parseLine(raw, context, emit) {
50
+ let line = raw.trim();
51
+ const first = line.charCodeAt(0);
52
+ if (line === "" ||
53
+ first === 0x21 /* ! */ ||
54
+ (first === 0x5b /* [ */ && /^\[[^\]]*\]$/.test(line)) ||
55
+ (first === 0x23 /* # */ && !EXTENDED_START.test(line))) {
56
+ emit(COMMENT);
57
+ return;
58
+ }
59
+ // A line cut out of a list's text keeps the whole text in memory, and so
60
+ // does every string cut out of the line: parse a copy. (V8 copies anything
61
+ // shorter than 13 characters by itself.)
62
+ if (line.length >= 13)
63
+ line = Buffer.from(line).toString();
64
+ const hosts = HOSTS_LINE.exec(line);
65
+ if (hosts !== null) {
66
+ for (const name of hosts[1].split(/\s+/)) {
67
+ if (name.startsWith("#"))
68
+ break;
69
+ const hostname = normalizeHostname(name, true);
70
+ if (hostname === undefined) {
71
+ emit({ kind: "invalid", reason: "bad hostname in a hosts line" });
72
+ }
73
+ else if (LOCAL_NAMES.has(hostname)) {
74
+ emit(COMMENT);
75
+ }
76
+ else {
77
+ emit({
78
+ kind: "network",
79
+ raw: line,
80
+ patternKind: P_HOST,
81
+ pattern: hostname,
82
+ flags: 0,
83
+ types: T_NETWORK | T_DOCUMENT,
84
+ from: undefined,
85
+ modifier: undefined,
86
+ extra: undefined,
87
+ });
88
+ }
89
+ }
90
+ return;
91
+ }
92
+ const cosmetic = splitCosmetic(line);
93
+ const parsed = cosmetic === undefined
94
+ ? parseNetworkFilter(line, context)
95
+ : parseCosmeticFilter(line, cosmetic, context);
96
+ if (Array.isArray(parsed))
97
+ parsed.forEach(emit);
98
+ else
99
+ emit(parsed);
100
+ }
101
+ /** Adds what `parseLine` found to a list's rules and counts. */
102
+ function collect(list, parsed) {
103
+ const { stats } = list;
104
+ switch (parsed.kind) {
105
+ case "comment":
106
+ stats.comments++;
107
+ break;
108
+ case "unsupported":
109
+ case "invalid": {
110
+ const counts = stats[parsed.kind];
111
+ counts[parsed.reason] = (counts[parsed.reason] ?? 0) + 1;
112
+ break;
113
+ }
114
+ case "network":
115
+ list.network.push(parsed);
116
+ if (parsed.flags & F_EXCEPTION)
117
+ stats.networkExceptions++;
118
+ else
119
+ stats.network++;
120
+ break;
121
+ case "cosmetic":
122
+ list.cosmetic.push(parsed);
123
+ if (parsed.exception)
124
+ stats.cosmeticExceptions++;
125
+ else
126
+ stats.cosmetic++;
127
+ if (parsed.procedural !== undefined)
128
+ stats.procedural++;
129
+ break;
130
+ case "scriptlet":
131
+ list.scriptlets.push(parsed);
132
+ if (parsed.exception)
133
+ stats.scriptletExceptions++;
134
+ else
135
+ stats.scriptlets++;
136
+ break;
137
+ case "responseheader":
138
+ list.responseHeaders.push(parsed);
139
+ stats.responseHeaders++;
140
+ break;
141
+ }
142
+ }
143
+ /**
144
+ * Parses `lines[start, end)` into `list`. A caller with a long list parses it
145
+ * in slices, to give the event loop a turn between them.
146
+ */
147
+ export function parseInto(list, lines, context, start = 0, end = lines.length) {
148
+ const emit = (parsed) => collect(list, parsed);
149
+ for (let i = start; i < end; i++)
150
+ parseLine(lines[i], context, emit);
151
+ list.stats.lines += end - start;
152
+ }
153
+ /** Parses a filter list's text, already preprocessed, into typed rules. */
154
+ export function parseList(text, context = { trusted: false }) {
155
+ const list = emptyParsedList();
156
+ parseInto(list, text.split(/\r?\n/), context);
157
+ return list;
158
+ }
@@ -0,0 +1,6 @@
1
+ import { type NetworkRule, type NotARule, type ParseContext } from "./types.js";
2
+ /**
3
+ * Parses a network filter: `[@@]pattern[$options]`. `line` is trimmed and
4
+ * isn't a comment or a cosmetic filter.
5
+ */
6
+ export declare function parseNetworkFilter(line: string, context: ParseContext): NetworkRule | NotARule;