@jupyterlab/observables 5.2.0-beta.0 → 5.2.0-beta.2

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/lib/modeldb.d.ts CHANGED
@@ -120,7 +120,7 @@ export interface IModelDB extends IDisposable {
120
120
  /**
121
121
  * Get a value for a path.
122
122
  *
123
- * @param path: the path for the object.
123
+ * @param path the path for the object.
124
124
  *
125
125
  * @returns an `IObservable`.
126
126
  */
@@ -128,7 +128,7 @@ export interface IModelDB extends IDisposable {
128
128
  /**
129
129
  * Whether the `IModelDB` has an object at this path.
130
130
  *
131
- * @param path: the path for the object.
131
+ * @param path the path for the object.
132
132
  *
133
133
  * @returns a boolean for whether an object is at `path`.
134
134
  */
@@ -136,7 +136,7 @@ export interface IModelDB extends IDisposable {
136
136
  /**
137
137
  * Create a string and insert it in the database.
138
138
  *
139
- * @param path: the path for the string.
139
+ * @param path the path for the string.
140
140
  *
141
141
  * @returns the string that was created.
142
142
  */
@@ -144,7 +144,7 @@ export interface IModelDB extends IDisposable {
144
144
  /**
145
145
  * Create an undoable list and insert it in the database.
146
146
  *
147
- * @param path: the path for the list.
147
+ * @param path the path for the list.
148
148
  *
149
149
  * @returns the list that was created.
150
150
  *
@@ -156,7 +156,7 @@ export interface IModelDB extends IDisposable {
156
156
  /**
157
157
  * Create a map and insert it in the database.
158
158
  *
159
- * @param path: the path for the map.
159
+ * @param path the path for the map.
160
160
  *
161
161
  * @returns the map that was created.
162
162
  *
@@ -168,7 +168,7 @@ export interface IModelDB extends IDisposable {
168
168
  /**
169
169
  * Create an opaque value and insert it in the database.
170
170
  *
171
- * @param path: the path for the value.
171
+ * @param path the path for the value.
172
172
  *
173
173
  * @returns the value that was created.
174
174
  */
@@ -177,22 +177,22 @@ export interface IModelDB extends IDisposable {
177
177
  * Get a value at a path, or `undefined if it has not been set
178
178
  * That value must already have been created using `createValue`.
179
179
  *
180
- * @param path: the path for the value.
180
+ * @param path the path for the value.
181
181
  */
182
182
  getValue(path: string): JSONValue | undefined;
183
183
  /**
184
184
  * Set a value at a path. That value must already have
185
185
  * been created using `createValue`.
186
186
  *
187
- * @param path: the path for the value.
187
+ * @param path the path for the value.
188
188
  *
189
- * @param value: the new value.
189
+ * @param value the new value.
190
190
  */
191
191
  setValue(path: string, value: JSONValue): void;
192
192
  /**
193
193
  * Create a view onto a subtree of the model database.
194
194
  *
195
- * @param basePath: the path for the root of the subtree.
195
+ * @param basePath the path for the root of the subtree.
196
196
  *
197
197
  * @returns an `IModelDB` with a view onto the original
198
198
  * `IModelDB`, with `basePath` prepended to all paths.
@@ -210,7 +210,7 @@ export declare class ObservableValue implements IObservableValue {
210
210
  /**
211
211
  * Constructor for the value.
212
212
  *
213
- * @param initialValue: the starting value for the `ObservableValue`.
213
+ * @param initialValue the starting value for the `ObservableValue`.
214
214
  */
215
215
  constructor(initialValue?: JSONValue);
216
216
  /**
@@ -295,7 +295,7 @@ export declare class ModelDB implements IModelDB {
295
295
  /**
296
296
  * Get a value for a path.
297
297
  *
298
- * @param path: the path for the object.
298
+ * @param path the path for the object.
299
299
  *
300
300
  * @returns an `IObservable`.
301
301
  */
@@ -303,7 +303,7 @@ export declare class ModelDB implements IModelDB {
303
303
  /**
304
304
  * Whether the `IModelDB` has an object at this path.
305
305
  *
306
- * @param path: the path for the object.
306
+ * @param path the path for the object.
307
307
  *
308
308
  * @returns a boolean for whether an object is at `path`.
309
309
  */
@@ -311,7 +311,7 @@ export declare class ModelDB implements IModelDB {
311
311
  /**
312
312
  * Create a string and insert it in the database.
313
313
  *
314
- * @param path: the path for the string.
314
+ * @param path the path for the string.
315
315
  *
316
316
  * @returns the string that was created.
317
317
  */
@@ -319,7 +319,7 @@ export declare class ModelDB implements IModelDB {
319
319
  /**
320
320
  * Create an undoable list and insert it in the database.
321
321
  *
322
- * @param path: the path for the list.
322
+ * @param path the path for the list.
323
323
  *
324
324
  * @returns the list that was created.
325
325
  *
@@ -331,7 +331,7 @@ export declare class ModelDB implements IModelDB {
331
331
  /**
332
332
  * Create a map and insert it in the database.
333
333
  *
334
- * @param path: the path for the map.
334
+ * @param path the path for the map.
335
335
  *
336
336
  * @returns the map that was created.
337
337
  *
@@ -343,7 +343,7 @@ export declare class ModelDB implements IModelDB {
343
343
  /**
344
344
  * Create an opaque value and insert it in the database.
345
345
  *
346
- * @param path: the path for the value.
346
+ * @param path the path for the value.
347
347
  *
348
348
  * @returns the value that was created.
349
349
  */
@@ -352,22 +352,22 @@ export declare class ModelDB implements IModelDB {
352
352
  * Get a value at a path, or `undefined if it has not been set
353
353
  * That value must already have been created using `createValue`.
354
354
  *
355
- * @param path: the path for the value.
355
+ * @param path the path for the value.
356
356
  */
357
357
  getValue(path: string): JSONValue | undefined;
358
358
  /**
359
359
  * Set a value at a path. That value must already have
360
360
  * been created using `createValue`.
361
361
  *
362
- * @param path: the path for the value.
362
+ * @param path the path for the value.
363
363
  *
364
- * @param value: the new value.
364
+ * @param value the new value.
365
365
  */
366
366
  setValue(path: string, value: JSONValue): void;
367
367
  /**
368
368
  * Create a view onto a subtree of the model database.
369
369
  *
370
- * @param basePath: the path for the root of the subtree.
370
+ * @param basePath the path for the root of the subtree.
371
371
  *
372
372
  * @returns an `IModelDB` with a view onto the original
373
373
  * `IModelDB`, with `basePath` prepended to all paths.
@@ -378,9 +378,9 @@ export declare class ModelDB implements IModelDB {
378
378
  * be called by user code, instead use the
379
379
  * `create*` factory methods.
380
380
  *
381
- * @param path: the path to set the value at.
381
+ * @param path the path to set the value at.
382
382
  *
383
- * @param value: the value to set at the path.
383
+ * @param value the value to set at the path.
384
384
  */
385
385
  set(path: string, value: IObservable): void;
386
386
  /**
package/lib/modeldb.js CHANGED
@@ -14,7 +14,7 @@ export class ObservableValue {
14
14
  /**
15
15
  * Constructor for the value.
16
16
  *
17
- * @param initialValue: the starting value for the `ObservableValue`.
17
+ * @param initialValue the starting value for the `ObservableValue`.
18
18
  */
19
19
  constructor(initialValue = null) {
20
20
  this._value = null;
@@ -135,7 +135,7 @@ export class ModelDB {
135
135
  /**
136
136
  * Get a value for a path.
137
137
  *
138
- * @param path: the path for the object.
138
+ * @param path the path for the object.
139
139
  *
140
140
  * @returns an `IObservable`.
141
141
  */
@@ -145,7 +145,7 @@ export class ModelDB {
145
145
  /**
146
146
  * Whether the `IModelDB` has an object at this path.
147
147
  *
148
- * @param path: the path for the object.
148
+ * @param path the path for the object.
149
149
  *
150
150
  * @returns a boolean for whether an object is at `path`.
151
151
  */
@@ -155,7 +155,7 @@ export class ModelDB {
155
155
  /**
156
156
  * Create a string and insert it in the database.
157
157
  *
158
- * @param path: the path for the string.
158
+ * @param path the path for the string.
159
159
  *
160
160
  * @returns the string that was created.
161
161
  */
@@ -168,7 +168,7 @@ export class ModelDB {
168
168
  /**
169
169
  * Create an undoable list and insert it in the database.
170
170
  *
171
- * @param path: the path for the list.
171
+ * @param path the path for the list.
172
172
  *
173
173
  * @returns the list that was created.
174
174
  *
@@ -185,7 +185,7 @@ export class ModelDB {
185
185
  /**
186
186
  * Create a map and insert it in the database.
187
187
  *
188
- * @param path: the path for the map.
188
+ * @param path the path for the map.
189
189
  *
190
190
  * @returns the map that was created.
191
191
  *
@@ -202,7 +202,7 @@ export class ModelDB {
202
202
  /**
203
203
  * Create an opaque value and insert it in the database.
204
204
  *
205
- * @param path: the path for the value.
205
+ * @param path the path for the value.
206
206
  *
207
207
  * @returns the value that was created.
208
208
  */
@@ -216,7 +216,7 @@ export class ModelDB {
216
216
  * Get a value at a path, or `undefined if it has not been set
217
217
  * That value must already have been created using `createValue`.
218
218
  *
219
- * @param path: the path for the value.
219
+ * @param path the path for the value.
220
220
  */
221
221
  getValue(path) {
222
222
  const val = this.get(path);
@@ -229,9 +229,9 @@ export class ModelDB {
229
229
  * Set a value at a path. That value must already have
230
230
  * been created using `createValue`.
231
231
  *
232
- * @param path: the path for the value.
232
+ * @param path the path for the value.
233
233
  *
234
- * @param value: the new value.
234
+ * @param value the new value.
235
235
  */
236
236
  setValue(path, value) {
237
237
  const val = this.get(path);
@@ -243,7 +243,7 @@ export class ModelDB {
243
243
  /**
244
244
  * Create a view onto a subtree of the model database.
245
245
  *
246
- * @param basePath: the path for the root of the subtree.
246
+ * @param basePath the path for the root of the subtree.
247
247
  *
248
248
  * @returns an `IModelDB` with a view onto the original
249
249
  * `IModelDB`, with `basePath` prepended to all paths.
@@ -258,9 +258,9 @@ export class ModelDB {
258
258
  * be called by user code, instead use the
259
259
  * `create*` factory methods.
260
260
  *
261
- * @param path: the path to set the value at.
261
+ * @param path the path to set the value at.
262
262
  *
263
- * @param value: the value to set at the path.
263
+ * @param value the value to set at the path.
264
264
  */
265
265
  set(path, value) {
266
266
  this._db.set(this._resolvePath(path), value);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jupyterlab/observables",
3
- "version": "5.2.0-beta.0",
3
+ "version": "5.2.0-beta.2",
4
4
  "description": "Data structures which may be observed for changes.",
5
5
  "homepage": "https://github.com/jupyterlab/jupyterlab",
6
6
  "bugs": {
@@ -29,7 +29,6 @@
29
29
  "build": "tsc -b",
30
30
  "build:test": "tsc --build tsconfig.test.json",
31
31
  "clean": "rimraf lib && rimraf tsconfig.tsbuildinfo",
32
- "docs": "typedoc src",
33
32
  "test": "jest",
34
33
  "test:cov": "jest --collect-coverage",
35
34
  "test:debug": "node --inspect-brk ../../node_modules/.bin/jest --runInBand",
@@ -44,11 +43,10 @@
44
43
  "@lumino/signaling": "^2.1.2"
45
44
  },
46
45
  "devDependencies": {
47
- "@jupyterlab/testing": "^4.2.0-beta.0",
46
+ "@jupyterlab/testing": "^4.2.0-beta.2",
48
47
  "@types/jest": "^29.2.0",
49
48
  "jest": "^29.2.0",
50
49
  "rimraf": "~5.0.5",
51
- "typedoc": "~0.24.7",
52
50
  "typescript": "~5.1.6"
53
51
  },
54
52
  "publishConfig": {
package/src/modeldb.ts CHANGED
@@ -150,7 +150,7 @@ export interface IModelDB extends IDisposable {
150
150
  /**
151
151
  * Get a value for a path.
152
152
  *
153
- * @param path: the path for the object.
153
+ * @param path the path for the object.
154
154
  *
155
155
  * @returns an `IObservable`.
156
156
  */
@@ -159,7 +159,7 @@ export interface IModelDB extends IDisposable {
159
159
  /**
160
160
  * Whether the `IModelDB` has an object at this path.
161
161
  *
162
- * @param path: the path for the object.
162
+ * @param path the path for the object.
163
163
  *
164
164
  * @returns a boolean for whether an object is at `path`.
165
165
  */
@@ -168,7 +168,7 @@ export interface IModelDB extends IDisposable {
168
168
  /**
169
169
  * Create a string and insert it in the database.
170
170
  *
171
- * @param path: the path for the string.
171
+ * @param path the path for the string.
172
172
  *
173
173
  * @returns the string that was created.
174
174
  */
@@ -177,7 +177,7 @@ export interface IModelDB extends IDisposable {
177
177
  /**
178
178
  * Create an undoable list and insert it in the database.
179
179
  *
180
- * @param path: the path for the list.
180
+ * @param path the path for the list.
181
181
  *
182
182
  * @returns the list that was created.
183
183
  *
@@ -190,7 +190,7 @@ export interface IModelDB extends IDisposable {
190
190
  /**
191
191
  * Create a map and insert it in the database.
192
192
  *
193
- * @param path: the path for the map.
193
+ * @param path the path for the map.
194
194
  *
195
195
  * @returns the map that was created.
196
196
  *
@@ -203,7 +203,7 @@ export interface IModelDB extends IDisposable {
203
203
  /**
204
204
  * Create an opaque value and insert it in the database.
205
205
  *
206
- * @param path: the path for the value.
206
+ * @param path the path for the value.
207
207
  *
208
208
  * @returns the value that was created.
209
209
  */
@@ -213,7 +213,7 @@ export interface IModelDB extends IDisposable {
213
213
  * Get a value at a path, or `undefined if it has not been set
214
214
  * That value must already have been created using `createValue`.
215
215
  *
216
- * @param path: the path for the value.
216
+ * @param path the path for the value.
217
217
  */
218
218
  getValue(path: string): JSONValue | undefined;
219
219
 
@@ -221,16 +221,16 @@ export interface IModelDB extends IDisposable {
221
221
  * Set a value at a path. That value must already have
222
222
  * been created using `createValue`.
223
223
  *
224
- * @param path: the path for the value.
224
+ * @param path the path for the value.
225
225
  *
226
- * @param value: the new value.
226
+ * @param value the new value.
227
227
  */
228
228
  setValue(path: string, value: JSONValue): void;
229
229
 
230
230
  /**
231
231
  * Create a view onto a subtree of the model database.
232
232
  *
233
- * @param basePath: the path for the root of the subtree.
233
+ * @param basePath the path for the root of the subtree.
234
234
  *
235
235
  * @returns an `IModelDB` with a view onto the original
236
236
  * `IModelDB`, with `basePath` prepended to all paths.
@@ -250,7 +250,7 @@ export class ObservableValue implements IObservableValue {
250
250
  /**
251
251
  * Constructor for the value.
252
252
  *
253
- * @param initialValue: the starting value for the `ObservableValue`.
253
+ * @param initialValue the starting value for the `ObservableValue`.
254
254
  */
255
255
  constructor(initialValue: JSONValue = null) {
256
256
  this._value = initialValue;
@@ -390,7 +390,7 @@ export class ModelDB implements IModelDB {
390
390
  /**
391
391
  * Get a value for a path.
392
392
  *
393
- * @param path: the path for the object.
393
+ * @param path the path for the object.
394
394
  *
395
395
  * @returns an `IObservable`.
396
396
  */
@@ -401,7 +401,7 @@ export class ModelDB implements IModelDB {
401
401
  /**
402
402
  * Whether the `IModelDB` has an object at this path.
403
403
  *
404
- * @param path: the path for the object.
404
+ * @param path the path for the object.
405
405
  *
406
406
  * @returns a boolean for whether an object is at `path`.
407
407
  */
@@ -412,7 +412,7 @@ export class ModelDB implements IModelDB {
412
412
  /**
413
413
  * Create a string and insert it in the database.
414
414
  *
415
- * @param path: the path for the string.
415
+ * @param path the path for the string.
416
416
  *
417
417
  * @returns the string that was created.
418
418
  */
@@ -426,7 +426,7 @@ export class ModelDB implements IModelDB {
426
426
  /**
427
427
  * Create an undoable list and insert it in the database.
428
428
  *
429
- * @param path: the path for the list.
429
+ * @param path the path for the list.
430
430
  *
431
431
  * @returns the list that was created.
432
432
  *
@@ -446,7 +446,7 @@ export class ModelDB implements IModelDB {
446
446
  /**
447
447
  * Create a map and insert it in the database.
448
448
  *
449
- * @param path: the path for the map.
449
+ * @param path the path for the map.
450
450
  *
451
451
  * @returns the map that was created.
452
452
  *
@@ -464,7 +464,7 @@ export class ModelDB implements IModelDB {
464
464
  /**
465
465
  * Create an opaque value and insert it in the database.
466
466
  *
467
- * @param path: the path for the value.
467
+ * @param path the path for the value.
468
468
  *
469
469
  * @returns the value that was created.
470
470
  */
@@ -479,7 +479,7 @@ export class ModelDB implements IModelDB {
479
479
  * Get a value at a path, or `undefined if it has not been set
480
480
  * That value must already have been created using `createValue`.
481
481
  *
482
- * @param path: the path for the value.
482
+ * @param path the path for the value.
483
483
  */
484
484
  getValue(path: string): JSONValue | undefined {
485
485
  const val = this.get(path);
@@ -493,9 +493,9 @@ export class ModelDB implements IModelDB {
493
493
  * Set a value at a path. That value must already have
494
494
  * been created using `createValue`.
495
495
  *
496
- * @param path: the path for the value.
496
+ * @param path the path for the value.
497
497
  *
498
- * @param value: the new value.
498
+ * @param value the new value.
499
499
  */
500
500
  setValue(path: string, value: JSONValue): void {
501
501
  const val = this.get(path);
@@ -508,7 +508,7 @@ export class ModelDB implements IModelDB {
508
508
  /**
509
509
  * Create a view onto a subtree of the model database.
510
510
  *
511
- * @param basePath: the path for the root of the subtree.
511
+ * @param basePath the path for the root of the subtree.
512
512
  *
513
513
  * @returns an `IModelDB` with a view onto the original
514
514
  * `IModelDB`, with `basePath` prepended to all paths.
@@ -524,9 +524,9 @@ export class ModelDB implements IModelDB {
524
524
  * be called by user code, instead use the
525
525
  * `create*` factory methods.
526
526
  *
527
- * @param path: the path to set the value at.
527
+ * @param path the path to set the value at.
528
528
  *
529
- * @param value: the value to set at the path.
529
+ * @param value the value to set at the path.
530
530
  */
531
531
  set(path: string, value: IObservable): void {
532
532
  this._db.set(this._resolvePath(path), value);