@nil-/doc 0.2.44 → 0.2.46

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @nil-/doc
 
+## 0.2.46
+
+### Patch Changes
+
+-   [doc][new] added event control support ([#77](https://github.com/njaldea/mono/pull/77))
+
+## 0.2.45
+
+### Patch Changes
+
+-   [doc][fix] keep control state when disabled after tuple/object parent toggles expand #[75](https://github.com/njaldea/mono/issues/75) ([#74](https://github.com/njaldea/mono/pull/74))
+
 ## 0.2.44
 
 ### Patch Changes

package/components/Layout.svelte

@@ -85,6 +85,7 @@
 </style>
 
 <script context="module">const defaultSorter = (l, r) => l.localeCompare(r);
+const defaultRenamer = (s) => s;
 </script>
 <script>import Container from "./etc/Container.svelte";
 import Nav from "./navigation/Nav.svelte";
@@ -135,7 +136,7 @@ const toggle = () => {
                         info={data}
                         selected={current ?? ""}
                         sorter={sorter ?? defaultSorter}
-                        renamer={renamer ?? ((s) => s)}
+                        renamer={renamer ?? defaultRenamer}
                         on:navigate
                     />
                 </div>

package/components/block/Controls.svelte

@@ -1,11 +1,12 @@
 
 <script>import { getControls, getControlsState } from "./context";
 export let props = [];
+export let events = [];
 export let hide = false;
 export let position = void 0;
 const controls = getControls();
 $:
-  $controls = props;
+  $controls = { props, events };
 const state = getControlsState();
 $:
   $state.hide = hide;

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

@@ -1,8 +1,9 @@
 import { SvelteComponentTyped } from "svelte";
-import type { Control } from "./controls/types";
+import type { Prop } from "./controls/types";
 declare const __propDef: {
     props: {
-        props?: Control[] | undefined;
+        props?: Prop[] | undefined;
+        events?: string[] | undefined;
         hide?: boolean | undefined;
         position?: undefined | "bottom" | "right";
     };

package/components/block/Instance.svelte

@@ -74,13 +74,27 @@
 import { cquery } from "./action";
 import { getControls, getControlsState } from "./context";
 import { getTheme } from "../context";
-import Controls from "./controls/Controls.svelte";
+import Props from "./controls/props/Props.svelte";
+import Events from "./controls/events/Events.svelte";
 import { resolve } from "./utils";
 const controls = getControls();
 const controlsState = getControlsState();
 const dark = getTheme();
 $:
-  expanded = $controls.length > 0 && !$controlsState.hide;
+  hasProps = $controls.props.length > 0;
+$:
+  hasEvents = $controls.events.length > 0;
+let cvisible = null;
+$:
+  if (cvisible == null && hasProps) {
+    cvisible = "props";
+  } else if (cvisible == null && hasEvents) {
+    cvisible = "events";
+  } else if (!hasProps && !hasEvents) {
+    cvisible = null;
+  }
+$:
+  expanded = !$controlsState.hide && cvisible != null;
 export let defaults = void 0;
 export let noreset = false;
 export let scale = false;
@@ -88,11 +102,10 @@ let key = false;
 beforeUpdate(() => key = !key);
 const resolveArgs = resolve;
 let bound = {};
-const updateBound = (d) => {
-  bound = resolve(d ?? {}, {});
-};
+const updateBound = (d) => bound = resolve(d ?? {}, {});
 $:
   updateBound(defaults);
+let handlers;
 </script>
 <div
     class="instance"
@@ -107,18 +120,32 @@ $:
 >
     {#if noreset}
         <div class="content scrollable" class:dark={$dark}>
-            <slot props={resolveArgs(defaults ?? {}, bound)} {key} />
+            <slot props={resolveArgs(defaults ?? {}, bound)} events={handlers} {key} />
         </div>
     {:else}
         {#key key}
             <div class="content scrollable" class:dark={$dark}>
-                <slot props={resolveArgs(defaults ?? {}, bound)} {key} />
+                <slot props={resolveArgs(defaults ?? {}, bound)} events={handlers} {key} />
             </div>
         {/key}
     {/if}
     {#if expanded}
         <div class="misc scrollable" class:dark={$dark}>
-            <Controls infos={$controls} bind:values={bound} />
+            <Props infos={$controls.props} bind:values={bound} visible={cvisible == "props"}>
+                <div on:dblclick={() => hasEvents && (cvisible = "events")}>
+                    <div>Properties</div>
+                    <div>Value</div>
+                    <div>Use</div>
+                </div>
+            </Props>
+            <Events events={$controls.events} bind:handlers visible={cvisible == "events"}>
+                {#if cvisible == "events"}
+                    <div on:dblclick={() => hasProps && (cvisible = "props")}>
+                        <div>Events</div>
+                        <div>Detail</div>
+                    </div>
+                {/if}
+            </Events>
         </div>
     {/if}
 </div>

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

@@ -1,7 +1,7 @@
 import { SvelteComponentTyped } from "svelte";
-declare class __sveltets_Render<Args> {
+declare class __sveltets_Render<PropArgs> {
     props(): {
-        defaults?: Args | undefined;
+        defaults?: PropArgs | undefined;
         noreset?: boolean | undefined;
         scale?: boolean | undefined;
     };
@@ -10,14 +10,15 @@ declare class __sveltets_Render<Args> {
     };
     slots(): {
         default: {
-            props: Args;
+            props: PropArgs;
+            events: Record<string, (ev: CustomEvent<unknown>) => void>;
             key: boolean;
         };
     };
 }
-export type InstanceProps<Args> = ReturnType<__sveltets_Render<Args>['props']>;
-export type InstanceEvents<Args> = ReturnType<__sveltets_Render<Args>['events']>;
-export type InstanceSlots<Args> = ReturnType<__sveltets_Render<Args>['slots']>;
-export default class Instance<Args> extends SvelteComponentTyped<InstanceProps<Args>, InstanceEvents<Args>, InstanceSlots<Args>> {
+export type InstanceProps<PropArgs> = ReturnType<__sveltets_Render<PropArgs>['props']>;
+export type InstanceEvents<PropArgs> = ReturnType<__sveltets_Render<PropArgs>['events']>;
+export type InstanceSlots<PropArgs> = ReturnType<__sveltets_Render<PropArgs>['slots']>;
+export default class Instance<PropArgs> extends SvelteComponentTyped<InstanceProps<PropArgs>, InstanceEvents<PropArgs>, InstanceSlots<PropArgs>> {
 }
 export {};

package/components/block/Template.svelte

@@ -30,7 +30,8 @@ const cast = (t) => t;
         {scale}
         let:key
         let:props
+        let:events
     >
-        <slot id={param.id} tag={param.tag} props={cast(props)} {key} />
+        <slot id={param.id} tag={param.tag} props={cast(props)} {events} {key} />
     </Instance>
 {/each}

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

@@ -14,6 +14,7 @@ declare class __sveltets_Render<Args> {
             id: number;
             tag: string;
             props: Args;
+            events: Record<string, (ev: CustomEvent<unknown>) => void>;
             key: boolean;
         };
     };

package/components/block/context.d.ts

@@ -1,5 +1,5 @@
 import type { Writable } from "svelte/store";
-import type { Control } from "./controls/types";
+import type { Prop, Event } from "./controls/types";
 import type { ValueType } from "./types";
 export type Params = {
     id: number;
@@ -11,7 +11,12 @@ export type ControlState = {
     position?: "bottom" | "right";
 };
 export declare const initParams: () => Writable<Params[]>, getParams: () => Writable<Params[]>;
-export declare const initControls: () => Writable<Control[]>, getControls: () => Writable<Control[]>;
+type Controls = {
+    props: Prop[];
+    events: Event[];
+};
+export declare const initControls: () => Writable<Controls>, getControls: () => Writable<Controls>;
 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>;
+export {};

package/components/block/context.js

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

package/components/block/controls/events/Events.svelte

@@ -0,0 +1,69 @@
+<style>
+    .count {
+        display: grid;
+        place-items: center;
+        text-align: center;
+        font-size: 0.8rem;
+    }
+</style>
+
+<script>import Styler from "./misc/Styler.svelte";
+export let visible;
+export let events;
+export let handlers;
+let history = [];
+const stringify = (detail) => {
+  if (detail) {
+    if (typeof detail === "string") {
+      return detail;
+    }
+    return JSON.stringify(detail);
+  }
+  return "";
+};
+const wrap = (ext) => {
+  const obj = {};
+  if (ext != null) {
+    for (const name of ext) {
+      obj[name] = (ev) => {
+        const detail = stringify(ev.detail);
+        if (history.length > 0) {
+          const last = history[history.length - 1];
+          if (last.name === name && last.detail === detail && last.count < 99) {
+            last.count += 1;
+            history = history;
+            return;
+          }
+        }
+        history.push({ name, detail, count: 1 });
+        if (history.length > 10) {
+          history.shift();
+        }
+        history = history;
+      };
+    }
+  }
+  return obj;
+};
+$:
+  handlers = wrap(events);
+</script>
+{#if visible}
+    <Styler>
+        <slot />
+        {#each history as { count, detail, name }, i (i)}
+            <div>
+                <div>
+                    <div>{name}</div>
+                    <div class="count">
+                        {#if count > 1}
+                            [{count.toString().padStart(2, "0")}]
+                        {/if}
+                    </div>
+                </div>
+                <div>{detail}</div>
+            </div>
+        {/each}
+    </Styler>
+{/if}
+

package/components/block/controls/events/Events.svelte.d.ts

@@ -0,0 +1,21 @@
+import { SvelteComponentTyped } from "svelte";
+import type { Event } from "../types";
+declare const __propDef: {
+    props: {
+        visible: boolean;
+        events: Event[];
+        handlers: Record<string, (ev: CustomEvent<unknown>) => void> | undefined;
+    };
+    events: {
+        [evt: string]: CustomEvent<any>;
+    };
+    slots: {
+        default: {};
+    };
+};
+export type EventsProps = typeof __propDef.props;
+export type EventsEvents = typeof __propDef.events;
+export type EventsSlots = typeof __propDef.slots;
+export default class Events extends SvelteComponentTyped<EventsProps, EventsEvents, EventsSlots> {
+}
+export {};

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

@@ -0,0 +1,83 @@
+<script>import { getTheme } from "../../../../context";
+const dark = getTheme();
+</script>
+<style>
+    div {
+        width: 100%;
+        height: 330px;
+        min-width: 500px;
+        overflow: hidden;
+        display: grid;
+        grid-auto-rows: 30px;
+        box-sizing: border-box;
+    }
+
+    div :global(*),
+    div :global(*::before),
+    div :global(*::after) {
+        box-sizing: inherit;
+    }
+
+    div > :global(div) {
+        display: grid;
+        width: 100%;
+        padding: 2px 0px;
+        grid-template-columns: 1fr 2fr;
+    }
+
+    div > :global(div > div) {
+        padding: 0px 10px;
+    }
+
+    div > :global(div:first-child) {
+        text-align: center;
+    }
+
+    div > :global(div:not(:first-child) > div:first-child) {
+        display: grid;
+        grid-template-columns: 1fr 30px;
+    }
+
+    /* colors */
+    div {
+        --pri-color: hsl(0, 0%, 100%);
+        --sec-color: hsl(210, 29%, 97%);
+        --hover-color: hsl(210, 100%, 90%);
+    }
+
+    div.dark {
+        --pri-color: hsl(213, 26%, 7%);
+        --sec-color: hsl(213, 26%, 11%);
+        --hover-color: hsl(203, 100%, 15%);
+    }
+
+    div {
+        transition: background-color 150ms;
+        background-repeat: repeat;
+        background-size: 100% 60px;
+        background-image: linear-gradient(to bottom, var(--pri-color) 30px, var(--sec-color) 30px);
+    }
+
+    div > :global(div:nth-child(n + 2):hover) {
+        background-color: var(--hover-color);
+    }
+</style>
+
+
+<!--
+    <div> this component
+        <div> Header
+            <div></div>
+            <div></div>
+        </div>
+        <div> Controls
+            <div></div>
+            <div></div>
+        </div>
+        ...
+    </div>
+-->
+<div class:dark={$dark}>
+    <slot />
+</div>
+

package/components/block/controls/{Component.svelte → props/Component.svelte}

@@ -10,19 +10,20 @@ export let value;
 export let info;
 export let depth;
 export let disabled = false;
+export let visible = false;
 </script>
 {#if "object" === info.type}
-    <Object {info} bind:value {depth} {disabled} />
+    <Object {info} bind:value {depth} {disabled} {visible} />
 {:else if "tuple" === info.type}
-    <Tuple {info} bind:value {depth} {disabled} />
+    <Tuple {info} bind:value {depth} {disabled} {visible} />
 {:else if "text" === info.type}
-    <Text {info} bind:value {depth} {disabled} />
+    <Text {info} bind:value {depth} {disabled} {visible} />
 {:else if "number" === info.type}
-    <Number {info} bind:value {depth} {disabled} />
+    <Number {info} bind:value {depth} {disabled} {visible} />
 {:else if "range" === info.type}
-    <Range {info} bind:value {depth} {disabled} />
+    <Range {info} bind:value {depth} {disabled} {visible} />
 {:else if "select" === info.type}
-    <Select {info} bind:value {depth} {disabled} />
+    <Select {info} bind:value {depth} {disabled} {visible} />
 {:else if "switch" === info.type}
-    <Switch {info} bind:value {depth} {disabled} />
+    <Switch {info} bind:value {depth} {disabled} {visible} />
 {/if}

package/components/block/controls/{Component.svelte.d.ts → props/Component.svelte.d.ts}

@@ -1,11 +1,12 @@
 import { SvelteComponentTyped } from "svelte";
-import type { Control } from "./types";
+import type { Prop } from "../types";
 declare const __propDef: {
     props: {
         value: any;
-        info: Control;
+        info: Prop;
         depth: number;
         disabled?: boolean | undefined;
+        visible?: boolean | undefined;
     };
     events: {
         [evt: string]: CustomEvent<any>;

package/components/block/controls/{Switch.svelte → props/Number.svelte}

@@ -5,13 +5,16 @@ export let value;
 export let info;
 export let depth;
 export let disabled = false;
+export let visible = false;
 let ivalue = value ?? getDefault(info);
 let enabled = value !== void 0;
 $:
   value = enabled && !disabled ? ivalue : void 0;
 </script>
-<div>
-    <Name name={info.name} {depth} />
-    <div><input type="checkbox" bind:checked={ivalue} disabled={!enabled || disabled} /></div>
-    <div><input type="checkbox" bind:checked={enabled} {disabled} /></div>
-</div>
+{#if visible}
+    <div>
+        <Name name={info.name} {depth} />
+        <div><input type="number" bind:value={ivalue} disabled={!enabled || disabled} /></div>
+        <div><input type="checkbox" bind:checked={enabled} {disabled} /></div>
+    </div>
+{/if}

package/components/block/controls/{Number.svelte.d.ts → props/Number.svelte.d.ts}

@@ -1,11 +1,12 @@
 import { SvelteComponentTyped } from "svelte";
-import type { ControlNumber } from "./types";
+import type { PropNumber } from "../types";
 declare const __propDef: {
     props: {
         value: number | undefined;
-        info: ControlNumber;
+        info: PropNumber;
         depth: number;
         disabled?: boolean | undefined;
+        visible?: boolean | undefined;
     };
     events: {
         [evt: string]: CustomEvent<any>;

package/components/block/controls/{Object.svelte → props/Object.svelte}

@@ -6,22 +6,22 @@ export let value;
 export let info;
 export let depth;
 export let disabled = false;
+export let visible = false;
 let ivalue = value ?? getDefault(info);
 let enabled = value !== void 0;
+let expand = info.values.length > 0 ? true : void 0;
 $:
   value = !disabled && enabled ? ivalue : void 0;
 $:
   values = info.values;
-let expand = info.values.length > 0 ? true : void 0;
 </script>
-<Header name={info.name} bind:expand bind:checked={enabled} {depth} {disabled} />
-{#if expand && enabled && !disabled}
-    {#each values as info, i (i)}
-        <Component
-            {info}
-            bind:value={ivalue[info.name]}
-            depth={depth + 10}
-            disabled={!enabled || disabled}
-        />
-    {/each}
-{/if}
+<Header name={info.name} bind:expand bind:checked={enabled} {depth} {disabled} {visible} />
+{#each values as info, i (i)}
+    <Component
+        {info}
+        bind:value={ivalue[info.name]}
+        depth={depth + 10}
+        disabled={!enabled || disabled}
+        visible={visible && expand && enabled && !disabled}
+    />
+{/each}

package/components/block/controls/{Object.svelte.d.ts → props/Object.svelte.d.ts}

@@ -1,12 +1,13 @@
 import { SvelteComponentTyped } from "svelte";
-import type { ValueType } from "../types";
-import type { ControlObject } from "./types";
+import type { ValueType } from "../../types";
+import type { PropObject } from "../types";
 declare const __propDef: {
     props: {
         value: Record<string, ValueType> | undefined;
-        info: ControlObject;
+        info: PropObject;
         depth: number;
         disabled?: boolean | undefined;
+        visible?: boolean | undefined;
     };
     events: {
         [evt: string]: CustomEvent<any>;

package/components/block/controls/{Controls.svelte → props/Props.svelte}

@@ -1,13 +1,15 @@
 
 <script>import Component from "./Component.svelte";
-import Header from "./misc/TopHeader.svelte";
 import Styler from "./misc/Styler.svelte";
 export let infos;
 export let values;
+export let visible;
 </script>
 <Styler>
-    <Header />
+    {#if visible}
+        <slot />
+    {/if}
     {#each infos as info}
-        <Component {info} bind:value={values[info.name]} depth={10} disabled={false} />
+        <Component {info} bind:value={values[info.name]} depth={10} {visible} />
     {/each}
 </Styler>

package/components/block/controls/props/Props.svelte.d.ts

@@ -0,0 +1,22 @@
+import { SvelteComponentTyped } from "svelte";
+import type { ValueType } from "../../types";
+import type { Prop } from "../types";
+declare const __propDef: {
+    props: {
+        infos: Prop[];
+        values: Record<string, ValueType>;
+        visible: boolean;
+    };
+    events: {
+        [evt: string]: CustomEvent<any>;
+    };
+    slots: {
+        default: {};
+    };
+};
+export type PropsProps = typeof __propDef.props;
+export type PropsEvents = typeof __propDef.events;
+export type PropsSlots = typeof __propDef.slots;
+export default class Props extends SvelteComponentTyped<PropsProps, PropsEvents, PropsSlots> {
+}
+export {};

package/components/block/controls/{Range.svelte → props/Range.svelte}

@@ -38,6 +38,7 @@ export let value;
 export let info;
 export let depth;
 export let disabled = false;
+export let visible = false;
 let ivalue = value ?? getDefault(info);
 let enabled = value !== void 0;
 $:
@@ -45,22 +46,24 @@ $:
 $:
   flag = !enabled || disabled;
 </script>
-<div>
-    <Name name={info.name} {depth} />
-    <div class="input">
-        <div class="tooltip" class:disabled={flag}>
-            Current Value: {ivalue}
+{#if visible}
+    <div>
+        <Name name={info.name} {depth} />
+        <div class="input">
+            <div class="tooltip" class:disabled={flag}>
+                Current Value: {ivalue}
+            </div>
+            <div>{ivalue.toFixed(2)}</div>
+            <input
+                type="range"
+                bind:value={ivalue}
+                min={info.min}
+                max={info.max}
+                step={info.step}
+                disabled={flag}
+            />
         </div>
-        <div>{ivalue.toFixed(2)}</div>
-        <input
-            type="range"
-            bind:value={ivalue}
-            min={info.min}
-            max={info.max}
-            step={info.step}
-            disabled={flag}
-        />
+        <div><input type="checkbox" bind:checked={enabled} {disabled} /></div>
     </div>
-    <div><input type="checkbox" bind:checked={enabled} {disabled} /></div>
-</div>
+{/if}
 

package/components/block/controls/{Range.svelte.d.ts → props/Range.svelte.d.ts}

@@ -1,11 +1,12 @@
 import { SvelteComponentTyped } from "svelte";
-import type { ControlRange } from "./types";
+import type { PropRange } from "../types";
 declare const __propDef: {
     props: {
         value: number | undefined;
-        info: ControlRange;
+        info: PropRange;
         depth: number;
         disabled?: boolean | undefined;
+        visible?: boolean | undefined;
     };
     events: {
         [evt: string]: CustomEvent<any>;