Updated Docs

jsr.json

@@ -1,6 +1,6 @@
 {
     "name": "@purifyjs/core",
-    "version": "0.0.303",
+    "version": "0.0.304",
     "exports": "./lib/all.ts",
     "publish": {
         "include": ["lib", "LICENSE", "README.md"]

lib/signals.ts

@@ -70,7 +70,8 @@ export declare namespace Signal {
          * lastAdded.follow(console.log)
          * arraySignal.push(123)
          * arraySignal.emit() // logs: 123
-         **/
+         * ```
+         */
         public emit(): void
     }
 
@@ -224,10 +225,12 @@ Signal.Computed = class<T> extends Signal<T> {
  * @returns {Signal.State<T>} A new state signal with the given initial value.
  *
  * @example
+ * ```ts
  * const count = ref(0);
  * count.follow(console.log)
  * count.val = 5; // logs: 5
  * count.val = 10; // logs: 10
+ * ```
  */
 export let ref = <T>(value: T, startStop?: Signal.State.Start<T>): Signal.State<T> =>
     new Signal.State(value, startStop)
@@ -240,11 +243,13 @@ export let ref = <T>(value: T, startStop?: Signal.State.Start<T>): Signal.State<
  * @returns {Signal.Computed<T>} A new computed signal.
  *
  * @example
+ * ```ts
  * const a = ref(1);
  * const b = ref(2);
  * const sum = computed(() => a.val + b.val);
  * sum.follow(console.log)
  * a.val++ // logs: 4
+ * ```
  */
 export let computed = <T>(getter: Signal.Computed.Getter<T>): Signal.Computed<T> =>
     new Signal.Computed(getter)
@@ -259,8 +264,10 @@ export let computed = <T>(getter: Signal.Computed.Getter<T>): Signal.Computed<T>
  * @returns {Signal<T | U>} A signal that updates when the promise resolves.
  *
  * @example
+ * ```ts
  * const dataSignal = awaited(fetchDataPromise, null);
  * dataSignal.follow((data) => console.log(data)); // logs the resolved data when ready
+ * ```
  */
 export let awaited = <T, const U = null>(
     promise: Promise<T>,

lib/tags.ts

@@ -41,12 +41,14 @@ let instancesOf = <T extends (abstract new (...args: never) => unknown)[]>(
  * @param members - The members to append to the fragment.
  * @returns  The created DocumentFragment.
  * @example
- * let frag = fragment(
+ * ```ts
+ * document.body.append(fragment(
  *      document.createElement('div'),
  *      div(),
  *      computed(() => count.val * 2),
  *      'Text content'
- * );
+ * ));
+ * ```
  */
 export let fragment = (...members: MemberOf<DocumentFragment>[]): DocumentFragment => {
     let fragment = document.createDocumentFragment()
@@ -99,9 +101,9 @@ export let toAppendable = (
  * It separates attributes and properties.
 
  * @example
- * let { div, span } = tags;
- *
  * ```ts
+ * let { div, span } = tags;
+ * 
  * div({ class: 'hello', 'aria-hidden': 'false' })
  *  .id("my-div")
  *  .ariaLabel("Hello, World!")
@@ -228,9 +230,11 @@ export class Builder<T extends HTMLElementWithLifecycle> {
      *
      * @param element - The element to build.
      * @example
+     * ```ts
      * new Builder(myDiv)
      *  .attributes({ class: 'hello', 'aria-hidden': 'false' })
      *  .children(span('Hello, World!'));
+     * ```
      */
     constructor(element: T) {
         this.element = element
@@ -279,11 +283,13 @@ export declare namespace Builder {
      * @returns The proxy for the Builder instance.
      *
      * @example
+     * ```ts
      * Builder.Proxy(myDiv)
      *  .attributes({ class: 'hello', 'aria-hidden': 'false' })
      *  .children(span('Hello, World!'));
      *  .onclick(() => console.log('clicked!'));
      *  .ariaLabel("Hello, World!");
+     * ```
      */
     function Proxy<T extends HTMLElementWithLifecycle>(element: T): Builder.Proxy<T>
 }