@nil-/doc 0.2.36 → 0.2.38

package/components/block/Template.svelte

@@ -1,162 +1,29 @@
-<style>
-    div {
-        box-sizing: border-box;
-    }
 
-    .template {
-        display: grid;
-        padding-bottom: 10px;
-        padding-top: 10px;
-        grid-auto-rows: 1fr;
-        grid-auto-columns: auto;
-        grid-auto-flow: row;
-        border-radius: 5px;
-    }
-
-    .template.columns {
-        grid-auto-rows: auto;
-        grid-auto-columns: 1fr;
-        grid-auto-flow: column;
-    }
-
-    .template > .cside {
-        display: grid;
-        grid-template-columns: 1fr 550px;
-    }
-
-    .content {
-        min-height: 100px;
-        border-radius: 5px;
-    }
-
-    div:not(.cside) > .misc {
-        border-bottom-left-radius: 5px;
-        border-bottom-right-radius: 5px;
-        user-select: none;
-    }
-
-    .template > .cside > .misc {
-        border-top-right-radius: 5px;
-        border-bottom-right-radius: 5px;
-        user-select: none;
-    }
-
-    .instance {
-        overflow: hidden;
-    }
-
-    .content,
-    .misc {
-        margin: 3px;
-        border-style: solid;
-        border-width: 1px;
-        padding: 1px;
-    }
-
-    /* scrollable */
-    .scrollable {
-        overflow: scroll;
-        scrollbar-width: none; /* Firefox */
-        -ms-overflow-style: none; /* IE and Edge */
-    }
-
-    .scrollable::-webkit-scrollbar {
-        display: none;
-    }
-
-    /* colors */
-    .template {
-        color: hsl(0, 0%, 0%);
-        background-color: hsl(0, 2%, 70%);
-        transition: color 350ms, background-color 350ms;
-    }
-
-    .template.dark {
-        color-scheme: dark;
-        color: hsl(0, 0%, 80%);
-        background-color: hsl(0, 2%, 40%);
-    }
-
-    .content,
-    .misc {
-        border-color: hsl(0, 2%, 60%);
-        background-color: hsl(0, 0%, 100%);
-        transition: border-color 350ms, background-color 350ms;
-    }
-
-    .dark .content,
-    .dark .misc {
-        border-color: hsl(0, 2%, 40%);
-        background-color: hsl(200, 4%, 14%);
-    }
-</style>
-
-<script>import { getParams, getDefaults } from "./context";
-import { getControls, getControlsState } from "./context";
+<script>import { beforeUpdate } from "svelte";
+import { getDefaults, getParams, getOrientation } from "./context";
 import { resolve } from "./utils";
-import { getTheme } from "../context";
-import Controls from "./controls/Controls.svelte";
-import { cquery } from "./action";
-import { beforeUpdate } from "svelte";
+import Instance from "./Instance.svelte";
 const params = getParams();
-const controls = getControls();
-const controlsState = getControlsState();
 const defaultsStore = getDefaults();
-const isDark = getTheme();
+const orientation = getOrientation();
 export let defaults = void 0;
 export let noreset = false;
 export let columns = false;
-const reset = () => {
-  $params = [];
-  $defaultsStore = defaults;
-};
 $:
-  $defaultsStore, reset();
-const resolveArgs = resolve;
+  $defaultsStore = defaults ?? {};
 $:
-  expanded = $controls.length > 0 && !$controlsState.hide;
+  $orientation = columns;
 let key = false;
 beforeUpdate(() => key = !key);
+const resolveArgs = resolve;
+const cast = (t) => t;
 </script>
-<div class="template" class:columns class:dark={$isDark}>
-    {#each $params as param (param.id)}
-        <div
-            class="instance"
-            class:cside={expanded && "right" === $controlsState.position}
-            use:cquery={{
-                class: "cside",
-                min: 1000,
-                w: true,
-                enabled: expanded && $controlsState.position === undefined
-            }}
-        >
-            {#if noreset}
-                <div class="content scrollable" class:dark={$isDark}>
-                    <slot
-                        id={param.id}
-                        tag={param.tag}
-                        props={resolveArgs(param.defaults, param.values)}
-                        {key}
-                    />
-                </div>
-            {:else}
-                {#key key}
-                    <div class="content scrollable" class:dark={$isDark}>
-                        <slot
-                            id={param.id}
-                            tag={param.tag}
-                            props={resolveArgs(param.defaults, param.values)}
-                            {key}
-                        />
-                    </div>
-                {/key}
-            {/if}
-            {#if expanded}
-                <div class="misc scrollable" class:dark={$isDark}>
-                    <Controls infos={$controls} bind:values={param.values} />
-                </div>
-            {/if}
-        </div>
-    {/each}
-</div>
-
+<!--
+    @component
+    See [documentation](https://mono-doc.vercel.app/3-Components/2-Block/2-Template) for more details.
+-->
+{#each $params as param (param.id)}
+    <Instance defaults={resolveArgs($defaultsStore, param.values)} {noreset} let:key let:props>
+        <slot id={param.id} tag={param.tag} props={cast(props)} {key} />
+    </Instance>
+{/each}

package/components/block/Template.svelte.d.ts

@@ -20,6 +20,7 @@ declare class __sveltets_Render<Args> {
 export type TemplateProps<Args> = ReturnType<__sveltets_Render<Args>['props']>;
 export type TemplateEvents<Args> = ReturnType<__sveltets_Render<Args>['events']>;
 export type TemplateSlots<Args> = ReturnType<__sveltets_Render<Args>['slots']>;
+/** See [documentation](https://mono-doc.vercel.app/3-Components/2-Block/2-Template) for more details. */
 export default class Template<Args> extends SvelteComponentTyped<TemplateProps<Args>, TemplateEvents<Args>, TemplateSlots<Args>> {
 }
 export {};

package/components/block/context.d.ts

@@ -7,7 +7,6 @@ export type Params = {
     id: number;
     tag: string;
     values: Record<string, ValueType>;
-    defaults: Record<string, ValueType>;
 };
 export type ControlState = {
     hide: boolean;
@@ -15,5 +14,6 @@ export type ControlState = {
 };
 export declare const initParams: () => Writable<Params[]>, getParams: () => Writable<Params[]>;
 export declare const initControls: () => Writable<Control[]>, getControls: () => Writable<Control[]>;
-export declare const initDefaults: () => Writable<Record<string, ValueType> | null>, getDefaults: () => Writable<Record<string, ValueType> | null>;
+export declare const initDefaults: () => Writable<Record<string, ValueType>>, getDefaults: () => Writable<Record<string, ValueType>>;
 export declare const initControlsState: () => Writable<ControlState>, getControlsState: () => Writable<ControlState>;
+export declare const initOrientation: () => Writable<boolean>, getOrientation: () => Writable<boolean>;

package/components/block/context.js

@@ -9,7 +9,8 @@ const create = (defaulter) => {
 };
 export const { init: initParams, get: getParams } = create(() => []);
 export const { init: initControls, get: getControls } = create(() => []);
-export const { init: initDefaults, get: getDefaults } = create(() => null);
+export const { init: initDefaults, get: getDefaults } = create(() => ({}));
 export const { init: initControlsState, get: getControlsState } = create(() => ({
     hide: false
 }));
+export const { init: initOrientation, get: getOrientation } = create(() => false);

package/components/block/controls/misc/Styler.svelte

@@ -1,5 +1,5 @@
 <script>import { getTheme } from "../../../context";
-const isDark = getTheme();
+const dark = getTheme();
 </script>
 <style>
     div {
@@ -36,6 +36,7 @@ const isDark = getTheme();
 
     /* colors */
     div > :global(div) {
+        transition: background-color 350ms;
         background-color: hsl(0, 0%, 100%);
     }
 
@@ -79,7 +80,7 @@ const isDark = getTheme();
 </style>
 
 
-<div class:dark={$isDark}>
+<div class:dark={$dark}>
     <slot />
 </div>
 

package/components/context.d.ts

@@ -1,5 +1,4 @@
 import type { Writable } from "svelte/store";
-export declare const inRoot: () => boolean;
 export type Theme = undefined | "light" | "dark";
 export declare const getTheme: () => Writable<boolean>;
 export declare const initTheme: () => Writable<boolean>;

package/components/context.js

@@ -1,11 +1,5 @@
 import { setContext, getContext } from "svelte";
 import { writable } from "svelte/store";
-const root = Symbol();
-export const inRoot = () => {
-    const value = getContext(root);
-    setContext(root, false);
-    return value !== false;
-};
 const theme = Symbol();
 export const getTheme = () => getContext(theme);
 export const initTheme = () => setContext(theme, writable(true));

package/components/etc/Container.svelte

@@ -8,14 +8,14 @@
         height: 100%;
         display: grid;
         grid-template-areas:
-            "primary"
+            "A"
             "divider"
-            "secondary";
+            "B";
         overflow: hidden;
     }
 
     .container.vertical {
-        grid-template-areas: "primary divider secondary";
+        grid-template-areas: "A divider B";
     }
 
     .container > div {
@@ -76,19 +76,19 @@
         background-color: var(--color-p);
     }
 
-    .container.moving:not(.secondary):not(.vertical) > .divider {
+    .container.moving:not(.b):not(.vertical) > .divider {
         border-bottom: var(--color-s) solid 2.5px;
     }
 
-    .container.moving.secondary:not(.vertical) > .divider {
+    .container.moving.b:not(.vertical) > .divider {
         border-top: var(--color-s) solid 2.5px;
     }
 
-    .container.moving:not(.secondary).vertical > .divider {
+    .container.moving:not(.b).vertical > .divider {
         border-right: var(--color-s) solid 2.5px;
     }
 
-    .container.moving.vertical.secondary > .divider {
+    .container.moving.vertical.b > .divider {
         border-left: var(--color-s) solid 2.5px;
     }
 </style>
@@ -97,10 +97,10 @@
 import { tweened } from "svelte/motion";
 import { createDraggable } from "./action";
 import { getTheme } from "../context";
-const isDark = getTheme();
+const dark = getTheme();
 export let vertical = false;
 export let offset = 0;
-export let secondary = false;
+export let b = false;
 let width;
 let height;
 const { position, draggable } = createDraggable(offset);
@@ -119,7 +119,7 @@ $:
 $:
   $off = offset;
 $:
-  style = !secondary ? `auto 5px ${$off}px` : `${$off}px 5px auto`;
+  style = !b ? `auto 5px ${$off}px` : `${$off}px 5px auto`;
 const moving = writable(false);
 const addLast = (v) => {
   if (v > 10) {
@@ -149,8 +149,8 @@ const check = (v, flag, s) => {
 <div
     class="container"
     class:vertical
-    class:secondary
-    class:dark={$isDark}
+    class:b
+    class:dark={$dark}
     class:moving={$moving}
     bind:clientWidth={width}
     bind:clientHeight={height}
@@ -158,9 +158,9 @@ const check = (v, flag, s) => {
     style:grid-template-rows={!vertical ? style : null}
 >
     {#if width != null && height != null}
-        <div style:grid-area="primary">
-            {#if check($off, !secondary, span)}
-                <slot name="primary" />
+        <div style:grid-area="A">
+            {#if check($off, !b, span)}
+                <slot name="A" />
             {/if}
         </div>
         <div class="divider">
@@ -168,7 +168,7 @@ const check = (v, flag, s) => {
                 class="overlay"
                 use:draggable={{
                     reset: () => offset,
-                    reversed: !secondary,
+                    reversed: !b,
                     vertical,
                     dbltap: dbltap,
                     tap: () => addLast($off),
@@ -176,9 +176,9 @@ const check = (v, flag, s) => {
                 }}
             />
         </div>
-        <div style:grid-area="secondary">
-            {#if check($off, secondary, span)}
-                <slot name="secondary" />
+        <div style:grid-area="B">
+            {#if check($off, b, span)}
+                <slot name="B" />
             {/if}
         </div>
     {/if}

package/components/etc/Container.svelte.d.ts

@@ -3,14 +3,14 @@ declare const __propDef: {
     props: {
         vertical?: boolean | undefined;
         offset?: number | undefined;
-        secondary?: boolean | undefined;
+        b?: boolean | undefined;
     };
     events: {
         [evt: string]: CustomEvent<any>;
     };
     slots: {
-        primary: {};
-        secondary: {};
+        A: {};
+        B: {};
     };
 };
 export type ContainerProps = typeof __propDef.props;

package/components/etc/ThemeIcon.svelte

@@ -44,13 +44,7 @@ const vdark = {
   v: 1
 };
 </script>
-<svg
-    class:dark
-    viewBox="-25 -25 50 50"
-    transform={`rotate(${$values.rotate})`}
-    on:click={() => (dark = !dark)}
-    on:keypress={null}
->
+<svg class:dark viewBox="-25 -25 50 50" transform={`rotate(${$values.rotate})`}>
     <mask id={`nil_doc_theme_icon_${index}`}>
         <rect x="-25" y="-25" fill="white" />
         <circle cy={$values.mcy} r="11" />

package/components/navigation/Nav.svelte

@@ -3,20 +3,22 @@
         width: 100%;
         height: 100%;
         min-width: 200px;
-        gap: 10px;
         display: flex;
         flex-direction: column;
     }
 
-    .logo,
     .search-bar {
-        padding-left: 20px;
-        padding-right: 20px;
+        padding: 5px;
     }
 
     input {
-        height: 20px;
+        height: 30px;
         width: 100%;
+        padding: 0px 10px;
+    }
+
+    input:focus {
+        outline: none;
     }
 
     * {
@@ -26,7 +28,8 @@
     }
 </style>
 
-<script context="module">const apply = (paths, init, pre, next, post) => {
+<script context="module">import { fuzz } from "./utils/fuzz";
+const apply = (paths, init, pre, next, post) => {
   const retval = {};
   for (const path of paths) {
     const parts = path.split("/");
@@ -51,7 +54,9 @@
   }
   return retval;
 };
-const filt = (path, filter, renamer) => path.includes(filter) || path.split("/").map(renamer).join("/").includes(filter);
+const filt = (path, filter, renamer) => {
+  return fuzz(path, filter) || fuzz(path.split("/").map(renamer).join("/"), filter);
+};
 const populate = (filter, info, renamer) => apply(
   filter.length > 0 ? info.filter((path) => filt(path, filter, renamer)) : info,
   () => ({ url: null, sub: {} }),
@@ -91,7 +96,6 @@ $:
   update(selected);
 </script>
 <div class="nav">
-    <div class="logo"><slot /></div>
     <div class="search-bar">
         <input bind:value={filter} type="text" />
     </div>

package/components/navigation/Nav.svelte.d.ts

@@ -12,9 +12,7 @@ declare const __propDef: {
     } & {
         [evt: string]: CustomEvent<any>;
     };
-    slots: {
-        default: {};
-    };
+    slots: {};
 };
 export type NavProps = typeof __propDef.props;
 export type NavEvents = typeof __propDef.events;

package/components/navigation/Node.svelte

@@ -43,7 +43,7 @@
 </style>
 
 <script>import { slide } from "svelte/transition";
-import { sort } from "./utils";
+import { sort } from "./utils/sort";
 import { createEventDispatcher } from "svelte";
 export let key;
 export let value;

package/components/navigation/Tree.svelte

@@ -1,6 +1,6 @@
 
 <script>import Node from "./Node.svelte";
-import { sort } from "./utils";
+import { sort } from "./utils/sort";
 export let tree;
 export let states;
 export let sorter;

package/components/navigation/utils/fuzz.d.ts

@@ -0,0 +1 @@
+export declare const fuzz: (target: string, query: string) => boolean;

package/components/navigation/utils/fuzz.js

@@ -0,0 +1,119 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License.
+ *  See License.txt in https://github.com/microsoft/vscode/blob/main/LICENSE.txt
+ *--------------------------------------------------------------------------------------------*/
+/*
+ *  This implementation is inspired by:
+ *      https://github.com/microsoft/vscode/blob/main/src/vs/base/common/fuzzyScorer.ts
+ *
+ *  It is simplified to fit the use case for @nil-/doc
+ */
+const isUpper = (code) => {
+    // A == 65
+    // Z == 90
+    return 65 <= code && code <= 90;
+};
+const scoreSeparatorAtPos = (charCode) => {
+    switch (charCode) {
+        case 47: // Slash
+            // prefer path separators...
+            return 5;
+        case 95: // Underline
+        case 45: // Dash
+        case 46: // Period
+        case 32: // Space
+        case 58: // Colon:
+            // ...over other separators
+            return 4;
+        default:
+            return 0;
+    }
+};
+const computeCharScore = (queryCharAtIndex, queryLowerCharAtIndex, target, targetLower, targetIndex, matchesSequenceLength) => {
+    let score = 0;
+    if (queryLowerCharAtIndex !== targetLower[targetIndex]) {
+        // no match of characters
+        return score;
+    }
+    // Character match bonus
+    score += 1;
+    // Consecutive match bonus
+    if (matchesSequenceLength > 0) {
+        score += matchesSequenceLength * 5;
+    }
+    // Same case bonus
+    if (queryCharAtIndex === target[targetIndex]) {
+        score += 1;
+    }
+    // Start of word bonus
+    if (0 === targetIndex) {
+        score += 8;
+    }
+    else {
+        const separatorBonus = scoreSeparatorAtPos(target.charCodeAt(targetIndex - 1));
+        if (separatorBonus) {
+            score += separatorBonus;
+        }
+        else if (isUpper(target.charCodeAt(targetIndex)) && 0 === matchesSequenceLength) {
+            score += 2;
+        }
+    }
+    return score;
+};
+const doScoreFuzzy = (query, queryLower, queryLength, target, targetLower, targetLength) => {
+    const scores = [];
+    const matches = [];
+    for (let queryIndex = 0; queryIndex < queryLength; queryIndex++) {
+        const queryIndexOffset = queryIndex * targetLength;
+        const queryIndexPreviousOffset = queryIndexOffset - targetLength;
+        const queryIndexGtNull = queryIndex > 0;
+        const queryCharAtIndex = query[queryIndex];
+        const queryLowerCharAtIndex = queryLower[queryIndex];
+        for (let targetIndex = 0; targetIndex < targetLength; targetIndex++) {
+            const targetIndexGtNull = targetIndex > 0;
+            const currentIndex = queryIndexOffset + targetIndex;
+            const leftIndex = currentIndex - 1;
+            const diagIndex = queryIndexPreviousOffset + targetIndex - 1;
+            const leftScore = targetIndexGtNull ? scores[leftIndex] : 0;
+            const diagScore = queryIndexGtNull && targetIndexGtNull ? scores[diagIndex] : 0;
+            const matchesSequenceLength = queryIndexGtNull && targetIndexGtNull ? matches[diagIndex] : 0;
+            const score = !diagScore && queryIndexGtNull
+                ? 0
+                : computeCharScore(queryCharAtIndex, queryLowerCharAtIndex, target, targetLower, targetIndex, matchesSequenceLength);
+            const isValidScore = score && diagScore + score >= leftScore;
+            if (isValidScore) {
+                matches[currentIndex] = matchesSequenceLength + 1;
+                scores[currentIndex] = diagScore + score;
+            }
+            else {
+                matches[currentIndex] = 0;
+                scores[currentIndex] = leftScore;
+            }
+        }
+    }
+    const positions = [];
+    let queryIndex = queryLength - 1;
+    let targetIndex = targetLength - 1;
+    while (queryIndex >= 0 && targetIndex >= 0) {
+        const currentIndex = queryIndex * targetLength + targetIndex;
+        const match = matches[currentIndex];
+        if (0 === match) {
+            targetIndex--;
+        }
+        else {
+            positions.push(targetIndex);
+            queryIndex--;
+            targetIndex--;
+        }
+    }
+    return [scores[queryLength * targetLength - 1], positions.reverse()];
+};
+export const fuzz = (target, query) => {
+    const targetLength = target.length;
+    const queryLength = query.length;
+    if (targetLength < queryLength) {
+        return false;
+    }
+    return (doScoreFuzzy(query, query.toLowerCase(), queryLength, target, target.toLowerCase(), targetLength)[0] > 0);
+};

package/components/navigation/utils/renamer.d.ts

@@ -0,0 +1,9 @@
+import type { Renamer } from "../types";
+/**
+ * If a text follows `<I>-<Name>` format,
+ * this method simply removes the Prefix.
+ *
+ * @param text
+ * @returns `<Name>`
+ */
+export declare const renamer: Renamer;

package/components/navigation/utils/renamer.js

@@ -0,0 +1,15 @@
+const match = /(\d+)-(.+)/;
+/**
+ * If a text follows `<I>-<Name>` format,
+ * this method simply removes the Prefix.
+ *
+ * @param text
+ * @returns `<Name>`
+ */
+export const renamer = (text) => {
+    const m = match.exec(text);
+    if (m) {
+        return m[2];
+    }
+    return text;
+};

package/components/navigation/utils/sort.d.ts

@@ -0,0 +1,2 @@
+import type { Tree } from "../types";
+export declare const sort: (t: Record<string, Tree>, order: (l: string, r: string) => 1 | 0 | -1) => [string, Tree][];

package/components/navigation/utils/sort.js

@@ -0,0 +1,3 @@
+export const sort = (t, order) => {
+    return Object.entries(t).sort(([l], [r]) => order(l, r));
+};

package/components/navigation/{utils.d.ts → utils/sorter.d.ts}

@@ -1,4 +1,4 @@
-import type { Tree, Sorter, Renamer } from "./types";
+import type { Sorter } from "../types";
 /**
  * Compares two texts for sorting.
  *
@@ -14,14 +14,4 @@ import type { Tree, Sorter, Renamer } from "./types";
  * @param r - right operand
  * @returns `-1 | 0 | +1`
  */
-declare const sorter: Sorter;
-/**
- * If a text follows `<I>-<Name>` format,
- * this method simply removes the Prefix.
- *
- * @param text
- * @returns `<Name>`
- */
-declare const renamer: Renamer;
-export declare const sort: (t: Record<string, Tree>, order: (l: string, r: string) => 1 | 0 | -1) => [string, Tree][];
-export { sorter, renamer };
+export declare const sorter: Sorter;