sliftutils 1.2.1 → 1.2.3

package/yarn.lock

@@ -1812,10 +1812,10 @@ slash@^3.0.0:
   resolved "https://registry.yarnpkg.com/slash/-/slash-3.0.0.tgz#6539be870c165adbd5240220dbe361f1bc4d4634"
   integrity sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==
 
-socket-function@^1.0.1:
-  version "1.0.1"
-  resolved "https://registry.yarnpkg.com/socket-function/-/socket-function-1.0.1.tgz#0fb37346c3395661c2c82a00a34908e1e5ed00bc"
-  integrity sha512-qsiDZxYEwLtSoX+/tlSfR5bE6YUNTdV+ccs+swtZFHsTajx3PhWnTvQRdgE2AnSwhtrldv3QOmZJsOTOZKL0/A==
+socket-function@^1.1.1:
+  version "1.1.1"
+  resolved "https://registry.yarnpkg.com/socket-function/-/socket-function-1.1.1.tgz#1384a41d70dec192caba4b5b93bfc594b5ac08c8"
+  integrity sha512-WsjlLdaUZzKhMfcc7rjP8/gPQaXUf4jLCgwJtDfIf+pzvS9Rqw4uxxoHkGAUwGp/iT13qyKiryZ+EBrR8/pwJg==
   dependencies:
     "@types/pako" "^2.0.3"
     "@types/ws" "^8.5.3"

package/.cursorrules

@@ -1,251 +0,0 @@
-The code automatically updates on save, so do not ever run commands to rerun the site.
-
-Don't run shell commands when you need to create or move small code files. You should use tool calls to do this. You should also use tool calls to make files within folders. You don't need to make the folder, just make the file. The folder will automatically be created.
-
-We use MobX for state management. Components should use a variable called synced that is an observable for their state, and never Component.state. All components need the @observer decorator. For example:
-    import preact from "preact";
-    import { observable } from "mobx";
-
-    @observer
-    class Example extends preact.Component {
-        synced = observable({
-            x: 0,
-        });
-
-        render() {
-            return <div>
-                <button onClick={() => this.synced.x++}>
-                    Click me
-                </button>
-                <p>
-                    {this.synced.x}
-                </p>
-            </div>;
-        }
-    }
-
-The code automatically updates on save, so do not ever run commands to rerun the site.
-
-If you need to add a dependency, don't just change the packs to JSON file. Properly use yarn add so you get the latest version, unless the user specifies a version or tells you otherwise.
-
-Use tool calls to read files and directories where possible, instead of running "ls", "dir", etc.
-
-Coding Styles
-    Times should almost always be in milliseconds, and if not told, you should assume a time is in milliseconds.
-
-    Don't make functions that will never be reused and are short. This just makes the code too confusing. If the function is under five lines and it's not being reused, you shouldn't create it, unless instructed explicitly to create it.
-
-    Comments should be used sparingly and only if it's required to explain what's being done. If you're calling a function called create imageName and the comment is called create imageName, you will be fired because that's just stupid. It's a waste of lines. 
-
-    Comments go in the line before, never after the semicolon. 
-
-    Try not to use "null", and instead always use "undefined".
-
-    Almost never check for undefined or null, just check for falsey.
-
-    When functions have more than one primitive parameter, such that you could confuse them, even something as simple as start time and end time, you should put them inside of an object and call that object config, so the function only has a single parameter.
-
-    Never use return codes, always prefer to throw on error. Include a lot of context information in the error. If any values might be extremely large, such as parsing a file, limit them (ex, to 500 characters).
-
-    He used double quotes, not single quotes. 
-
-    Never use the ternary operator. Instead, do this: "x ? y : z" => "x && y || z".
-
-    Never use non-null assertion operator, instead check the value, and if necessary (because it is accessed in nested functions), use a const variable to preserve the type.
-
-    Errors should almost always use a template string to include the expected value, and the actual value, as in: "throw new Error(`Expected X, was ${Y}`);"
-
-    Don't use switch statements. Use if/else statements instead.
-    
-    Don't use ! when accessing a value from a map. Use the get / if undefined initialize and set, and then use style. It's faster, and more type safe.
-
-    Sort with this function, which takes a single function to map each object to a sortable value
-        import { sort } from "socket-function/src/misc";
-        export function sort<T>(arr: T[], sortKey: (obj: T) => unknown);
-
-    Prefer to return, instead of using else statements. Handle error cases, warn/throw, and then return. Your main case should be below, not in an if statement, just in the main code.
-
-    Use template strings for error messages, which include the exact value that triggered the error, and the exact expectation it failed.
-
-    Use functions to prevent code duplication only when something is actually duplicated. 
-
-    Don't recreate collections or URL parameters, import them instead. 
-
-    Do not redefine types. Import the types correctly. 
-
-    Do not use types when they can be inferred. 
-
-    Constants that are arbitrary and that we might to reconfigure should be near the top of the file under the imports, not buried within functions. 
-
-    Never use environment variables. All configuration should be on the disk, or, if specific to a current run, passed as command line parameters. 
-
-    Never use inline styles, always use the CSS helper. 
-
-    Don't use `as any`.
-
-    When you're making fetch calls and you get a type of any, you need to cast it to the actual type, and not leave it as any. The same goes for when you're deserializing values.
-    
-    DO NOT redeclare constants and copy their value. JUST IMPORT THEM!
-
-    DO NOT redeclare types. JUST IMPORT THEM!
-
-    Do not try catch for no reason. If you can't actually handle the exception, just let it throw.
-
-    For input events, always use event.currentTarget.
-
-    Use ref={elem => } callbacks. NEVER use .createRef.
-
-    NEVER render images with a fixed width+height. This will cause them to be stretched or cut off. This is terrible. Only set the width or height. 
-    
-    Callback held should be avoided by using async and `import { PromiseObj } from "socket-function/src/misc";`. Most of the time, if there's an event callback, you should wrap it with a promise obj so that you can wait for it asynchronously. 
-
-    `import { keyBy, keyByArray } from "socket-function/src/misc";` Should be used when you need to create lookups from lists and you know what key you want. This can clobber values, or it can gather in an array.
-        let example: Map<number, { x: number }> = keyBy([{ x: 5 }, { x: 6 }]);
-        let example: Map<number, { x: number }[]> = keyByArrat([{ x: 5 }, { x: 5, version: 2 } { x: 6 }]);
-
-    Never use alert. If there's an error, you should throw it. 
-
-
-
-General Styling
-    Never use em or rem. Only use px or vw/vh/%.
-
-    Don't add font colors unless asked to add styling. Don't add any aethetics beyond hbox/vbox/pad2 unless asked to add styling. Don't add fontSize unless asked to add styling. If you believe styling is possible, just tell the user, I can add styling, but won't do it unless you ask me to. 
-
-    Never use h1/h2/h3 etc. These classes have extremely large built-in margins and paddings, instead set the font size explicitly. 
-
-    Make sure to not use fillWidth, where flexGrow(1) would suffice. 
-
-Components
-    Anchor (<a> tag), for linking using URLParam
-        <Anchor
-            params={[[todolistURL, listKey]]}
-        >
-            {list.name}
-        </Anchor>
-    URLParam, Parameters which are stored in the URL. The second argument is the default, which can be a number, string, or an object. Set and get with .value
-        const todolistURL = new URLParam("todolist", "");
-
-    InputLabel and InputLabelURL should be used for inputs. For example:
-        <InputLabelURL
-            label="Show Previous Video"
-            checkbox
-            persisted={showPreviousVideoURL}
-        />
-        <InputLabel
-            label="Notes"
-            fillWidth
-            value={node.notes || ""}
-            onChangeValue={async (value) => {
-                const updatedNode = deepCloneJSON(node);
-                updatedNode.notes = value;
-                await VideoNode.set(node.id, updatedNode);
-            }}
-        />
-
-API Calls
-    When in an event callback (which must be async)
-        APIController(getExtNodeId()).getModels.promise()
-    When in a render function/context
-        APIController(getExtNodeId()).getModels()
-
-
-DiskCollection
-    If read an object from a collection, and then mutate it, and want to set it in the collection, you have to shallow copy it, so the DiskCollection picks up the change.
-        let x = collection.get("x");
-        x.y = Math.random();
-        // Not asynchronous, as sets are synchronous
-        collection.set("x", { ...x });
-    The non-async functions should be called in render functions, the async functions should be called in event handlers, etc. Except for .set, which should be called in all both cases. 
-    get(key: string): T | undefined;
-    async getPromise(key: string): Promise<T | undefined>;
-    set(key: string, value: T): void;
-    remove(key: string): void;
-    getKeys(): string[];
-    getKeysPromise(): Promise<string[]>;
-    getEntries(): [string, T][];
-    getValues(): T[];
-    async getValuesPromise(): Promise<T[]>;
-    getInfo(key: string);
-    async reset();
-
-css
-    Add very little styling, such as colours, rounding, etc, unless asked to add more styling.
-
-    css should be set using className={css.cssPropertyName(cssPropertyValue).anotherPropertyName...}
-    Always use the "css" helper for styling. For example:
-        <div className={css.width(100).height(50)}>My width is 100px, my height is 50px</div>
-    All css fields can be set in this way, with the function being the field name and the argument being the value.
-    Generally speaking, the CSS helpers are on two lines. Wrapping is fine. 
-        className={css.size(100, 100).hbox(4)
-            .hsl(0, 50, 50).borderRadius(4)
-        }
-        position
-            - Position, size, font size, layout, hints, etc. 
-            - The cursor, color, font color, border radius, pointer, bold. 
-
-        Conditionals come after, and should use this style:
-            className={css
-                ...
-                + (conditionalExample && css.opacity(0.5))
-            }
-            Specifically, it should be a value that you check for, and then the value. Don't use ternary, don't do `|| ""`
-                - If you have multiple values, chain them with || and &&
-    Keep the CSS simple, don't add too much, because it's easier to add than to remove.
-
-However, there are some helper functions that will directly map to commonly used styles. 
-
-    If you want to make a NON-Button feel like a button, you can use "css.button", which makes the background color change on hover, and make the cursor a pointer. Only use this if the background color is set, otherwise you need to message it's a button in another way. And never use it for <Button>/<button> which already does this.
-
-    Generally use hbox/vbox to set the spacing between elements, instead of using margins.
-
-
-    There are also some special aliases, some of which take parameters, some of which don't (which allows them to be chained like so: css.vbox0.wrap):
-    let nonCallAliases = {
-        relative: (c: CSSHelperTypeBase) => c.position("relative"),
-        absolute: (c: CSSHelperTypeBase) => c.position("absolute"),
-        fixed: (c: CSSHelperTypeBase) => c.position("fixed"),
-        wrap: (c: CSSHelperTypeBase) => c.flexWrap("wrap").display("flex", "soft").alignItems("center", "soft"),
-        marginAuto: (c: CSSHelperTypeBase) => c.margin("auto"),
-        fillBoth: (c: CSSHelperTypeBase) => c.width("100%").height("100%"),
-        fillWidth: (c: CSSHelperTypeBase) => c.width("100%"),
-        fillHeight: (c: CSSHelperTypeBase) => c.height("100%"),
-        flexShrink0: (c: CSSHelperTypeBase) => c.flexShrink(0),
-        ellipsis: (c: CSSHelperTypeBase) => c.overflow("hidden").textOverflow("ellipsis").whiteSpace("nowrap").display("inline-block"),
-        overflowAuto: (c: CSSHelperTypeBase) => c.overflow("auto"),
-        overflowHidden: (c: CSSHelperTypeBase) => c.overflow("hidden"),
-    };
-    let callAliases = {
-        hbox: (c: CSSHelperTypeBase, gap: number, rowGap?: number) => c.display("flex").flexDirection("row").rowGap(rowGap ?? gap).columnGap(gap).alignItems("center", "soft"),
-        vbox: (c: CSSHelperTypeBase, gap: number, columnGap?: number) => c.display("flex").flexDirection("column").rowGap(gap).columnGap(columnGap ?? gap).alignItems("start", "soft"),
-        pad2: (c: CSSHelperTypeBase, value: number, verticalValue?: number): CSSHelperTypeBase => {
-            if (verticalValue !== undefined) return c.padding(`${verticalValue}px ${value}px` as any);
-            return c.padding(value);
-        },
-        hsl: (c: CSSHelperTypeBase, h: number, s: number, l: number): CSSHelperTypeBase => c.background(`hsl(${h}, ${s}%, ${l}%)`),
-        hslhover: (c: CSSHelperTypeBase, h: number, s: number, l: number): CSSHelperTypeBase => c.background(`hsl(${h}, ${s}%, ${l}%)`, "hover"),
-        hsla: (c: CSSHelperTypeBase, h: number, s: number, l: number, a: number): CSSHelperTypeBase => c.background(`hsla(${h}, ${s}%, ${l}%, ${a})`),
-        hslahover: (c: CSSHelperTypeBase, h: number, s: number, l: number, a: number): CSSHelperTypeBase => c.background(`hsla(${h}, ${s}%, ${l}%, ${a})`, "hover"),
-        bord: (c: CSSHelperTypeBase, width: number, color: string | { h: number; s: number; l: number; a?: number; }, style = "solid"): CSSHelperTypeBase => {
-            let colorStr = typeof color === "string" ? color : `hsla(${color.h}, ${color.s}%, ${color.l}%, ${color.a ?? 1})`;
-            return c.border(`${width}px ${style} ${colorStr}`);
-        },
-        bord2: (c: CSSHelperTypeBase, h: number, s: number, l: number, width = 1, style = "solid"): CSSHelperTypeBase => {
-            return c.border(`${width}px ${style} hsla(${h}, ${s}%, ${l}%, 1)`);
-        },
-        hslcolor: (c: CSSHelperTypeBase, h: number, s: number, l: number): CSSHelperTypeBase => c.color(`hsl(${h}, ${s}%, ${l}%)`),
-        colorhsl: (c: CSSHelperTypeBase, h: number, s: number, l: number): CSSHelperTypeBase => c.color(`hsl(${h}, ${s}%, ${l}%)`),
-        hslacolor: (c: CSSHelperTypeBase, h: number, s: number, l: number, a: number): CSSHelperTypeBase => c.color(`hsla(${h}, ${s}%, ${l}%, ${a})`),
-        colorhsla: (c: CSSHelperTypeBase, h: number, s: number, l: number, a: number): CSSHelperTypeBase => c.color(`hsla(${h}, ${s}%, ${l}%, ${a})`),
-        size: (c: CSSHelperTypeBase, width: LengthOrPercentage, height: LengthOrPercentage) => c.width(width).height(height),
-        pos: (c: CSSHelperTypeBase, x: LengthOrPercentage, y: LengthOrPercentage) => c.left(x).top(y),
-    };
-
-
-For animation keyframes, a style tag is required. 
-    <style>{`
-        @keyframes spinner-ring {
-            0% { transform: rotate(0deg); }
-            100% { transform: rotate(360deg); }
-        }
-    `}</style>