docs: Add jsdoc to two live-tile classes

Author: filiphsps

.vscode/extensions.json

@@ -8,6 +8,7 @@
         "yoavbls.pretty-ts-errors",
         "christian-kohler.path-intellisense",
         "christian-kohler.npm-intellisense",
-        "chdsbd.github-code-owners"
+        "chdsbd.github-code-owners",
+        "bierner.jsdoc-markdown-highlighting"
     ]
 }

.vscode/settings.json

@@ -30,8 +30,20 @@
         "editor.wordWrap": "off",
         "workbench.editor.restoreViewState": false
     },
-    "cSpell.words": ["bitcode", "codegen", "commitlint", "nativewind", "Pressable", "startscreen", "Subviews", "tsup"],
+    "cSpell.words": [
+        "bitcode",
+        "codegen",
+        "commitlint",
+        "nativewind",
+        "nvmrc",
+        "Pressable",
+        "startscreen",
+        "Subviews",
+        "tsup"
+    ],
     "githubCodeOwners.format.enabled": true,
     "typescript.preferences.importModuleSpecifier": "non-relative",
-    "typescript.experimental.expandableHover": true
+    "typescript.experimental.expandableHover": true,
+    "jsdoc-generator.includeExport": false,
+    "jsdoc-generator.emptyLineAfterHeader": true
 }

packages/live-tiles/README.md

@@ -1,3 +1,4 @@
 # @metro-ui/live-tiles
 
-[![npm](https://img.shields.io/npm/dt/@metro-ui/live-tiles)](https://www.npmjs.com/package/@metro-ui/live-tiles)
+[![npm downloads](https://img.shields.io/npm/dt/@metro-ui/live-tiles.svg)](https://www.npmjs.com/package/@metro-ui/live-tiles)
+[![npm version](https://img.shields.io/npm/v/@metro-ui/live-tiles.svg?style=flat)](https://www.npmjs.com/package/@metro-ui/live-tiles)

packages/live-tiles/src/tiles/live-tiles.ts

@@ -76,6 +76,7 @@ export abstract class LiveTileImage {
         public readonly overlay: number = 20
     ) {}
 }
+export class LiveTileBadgeImage extends LiveTileImage {}
 export class LiveTilePeekImage extends LiveTileImage {}
 export class LiveTileBackgroundImage extends LiveTileImage {}
 
@@ -91,6 +92,42 @@ export class LiveTileContentAdaptive extends LiveTileContent {
     }
 }
 
+/**
+ * A tile that displays a single line of text with an optional badge.
+ *
+ * ![screenshot](https://learn.microsoft.com/en-us/previous-versions/windows/apps/images/hh761491.tilesquare150x150iconwithbadge(en-us,win.10).jpg)
+ *
+ *{@link https://learn.microsoft.com/en-us/previous-versions/windows/apps/hh761491(v=win.10)#tilesquare150x150iconwithbadge}
+ * @extends {LiveTileContent}
+ */
+export class LiveTileContentIconWithBadge extends LiveTileContent {
+    public constructor(
+        public readonly badgeImage: Optional<LiveTileBadgeImage>,
+        public readonly text: string = ''
+    ) {
+        super();
+    }
+}
+
+/**
+ * A tile that displays two rows of text either side by side or one above the other depending on the device/platform.
+ * They were typically used for display the day and month the calendar app tile.
+ *
+ * ![screenshot](https://learn.microsoft.com/en-us/previous-versions/windows/apps/images/hh761491.tilesquareblock(en-us,win.10).png)
+ *
+ * {@link https://learn.microsoft.com/en-us/previous-versions/windows/apps/hh761491(v=win.10)#tilesquareblocktilesquare150x150block}
+ * @extends {LiveTileContent}
+ */
+export class LiveTileContentTileSquareBlock extends LiveTileContent {
+    public constructor(
+        public readonly blockText: Optional<string>,
+        public readonly besideBlockText: Optional<string>,
+        public readonly text: string = ''
+    ) {
+        super();
+    }
+}
+
 export class LiveTileBinding {
     public constructor(
         public displayName: Optional<string>,