@gyral/core 0.1.0 → 0.3.0

package/dist/live-boolean.js

@@ -1,34 +0,0 @@
-import { Directive, directive, PartType, } from 'lit/directive.js';
-/**
- * A boolean that is right both in server-rendered markup and in the live DOM (ADR 0012).
- * Use it in a boolean attribute binding:
- *
- *   <input type="checkbox" ?checked=${liveBoolean(s.on)} />
- *   <option ?selected=${liveBoolean(s.sort === 'price')}>Price</option>
- *
- * - On the server it renders the attribute when true and omits it when false.
- *   (A property binding, `.checked=${false}`, is serialized by Lit SSR as `checked="false"`,
- *   which *checks* the box. Never bind boolean form state as a property in SSR'd views.)
- * - In the browser it also sets the element's property of the same name (`checked`,
- *   `selected`, `open`, …), so the control follows model state even after the user has
- *   changed it. The attribute alone stops controlling `checked` once a box has been clicked.
- */
-class LiveBoolean extends Directive {
-    constructor(info) {
-        super(info);
-        if (info.type !== PartType.BOOLEAN_ATTRIBUTE) {
-            throw new Error('liveBoolean() must be used in a boolean attribute: ?checked=${…}');
-        }
-    }
-    render(value) {
-        return value;
-    }
-    update(part, [value]) {
-        const element = part.element;
-        if (part.name in part.element && element[part.name] !== value)
-            element[part.name] = value;
-        return value;
-    }
-}
-export const liveBoolean = directive(LiveBoolean);
-//# sourceMappingURL=live-boolean.js.map

package/dist/live-boolean.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"live-boolean.js","sourceRoot":"","sources":["../src/live-boolean.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,SAAS,EACT,QAAQ,GAGT,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAY,SAAQ,SAAS;IACjC,YAAY,IAAc;QACxB,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,iBAAiB,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAEQ,MAAM,CAAC,KAAc;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IAEQ,MAAM,CAAC,IAAmB,EAAE,CAAC,KAAK,CAAY;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,OAA6C,CAAC;QACnE,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QAC1F,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC","sourcesContent":["import {\n  Directive,\n  directive,\n  PartType,\n  type AttributePart,\n  type PartInfo,\n} from 'lit/directive.js';\n\n/**\n * A boolean that is right both in server-rendered markup and in the live DOM (ADR 0012).\n * Use it in a boolean attribute binding:\n *\n *   <input type=\"checkbox\" ?checked=${liveBoolean(s.on)} />\n *   <option ?selected=${liveBoolean(s.sort === 'price')}>Price</option>\n *\n * - On the server it renders the attribute when true and omits it when false.\n *   (A property binding, `.checked=${false}`, is serialized by Lit SSR as `checked=\"false\"`,\n *   which *checks* the box. Never bind boolean form state as a property in SSR'd views.)\n * - In the browser it also sets the element's property of the same name (`checked`,\n *   `selected`, `open`, …), so the control follows model state even after the user has\n *   changed it. The attribute alone stops controlling `checked` once a box has been clicked.\n */\nclass LiveBoolean extends Directive {\n  constructor(info: PartInfo) {\n    super(info);\n    if (info.type !== PartType.BOOLEAN_ATTRIBUTE) {\n      throw new Error('liveBoolean() must be used in a boolean attribute: ?checked=${…}');\n    }\n  }\n\n  override render(value: boolean): boolean {\n    return value;\n  }\n\n  override update(part: AttributePart, [value]: [boolean]): boolean {\n    const element = part.element as unknown as Record<string, unknown>;\n    if (part.name in part.element && element[part.name] !== value) element[part.name] = value;\n    return value;\n  }\n}\n\nexport const liveBoolean = directive(LiveBoolean);\n"]}

package/dist/styles.d.ts

@@ -1,12 +0,0 @@
-import { type CSSResultGroup, type CSSResultOrNative } from 'lit';
-/**
- * What `spec.styles` accepts:
- * - `css` tagged templates (Lit's `CSSResult`);
- * - plain strings, e.g. a stylesheet module shared with the document (`import base from
- *   './base.css?raw'`). Strings are trusted CSS from your own code, never user input;
- * - `CSSStyleSheet` instances (constructable stylesheets, shared across components);
- * - arrays of any of these, nested freely.
- */
-export type Styles = CSSResultOrNative | string | readonly Styles[];
-/** Normalizes `Styles` into what Lit's `static styles` expects. */
-export declare function toCssResultGroup(styles: Styles): CSSResultGroup;

package/dist/styles.js

@@ -1,11 +0,0 @@
-// Component styles (gyral-czi.24): `css` templates, plain strings or constructed sheets.
-import { unsafeCSS } from 'lit';
-/** Normalizes `Styles` into what Lit's `static styles` expects. */
-export function toCssResultGroup(styles) {
-    if (typeof styles === 'string')
-        return unsafeCSS(styles);
-    if (Array.isArray(styles))
-        return styles.map(toCssResultGroup);
-    return styles;
-}
-//# sourceMappingURL=styles.js.map

package/dist/styles.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"styles.js","sourceRoot":"","sources":["../src/styles.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,OAAO,EAAE,SAAS,EAA+C,MAAM,KAAK,CAAC;AAY7E,mEAAmE;AACnE,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;IACzD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAQ,MAA4B,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACtF,OAAO,MAA2B,CAAC;AACrC,CAAC","sourcesContent":["// Component styles (gyral-czi.24): `css` templates, plain strings or constructed sheets.\nimport { unsafeCSS, type CSSResultGroup, type CSSResultOrNative } from 'lit';\n\n/**\n * What `spec.styles` accepts:\n * - `css` tagged templates (Lit's `CSSResult`);\n * - plain strings, e.g. a stylesheet module shared with the document (`import base from\n *   './base.css?raw'`). Strings are trusted CSS from your own code, never user input;\n * - `CSSStyleSheet` instances (constructable stylesheets, shared across components);\n * - arrays of any of these, nested freely.\n */\nexport type Styles = CSSResultOrNative | string | readonly Styles[];\n\n/** Normalizes `Styles` into what Lit's `static styles` expects. */\nexport function toCssResultGroup(styles: Styles): CSSResultGroup {\n  if (typeof styles === 'string') return unsafeCSS(styles);\n  if (Array.isArray(styles)) return (styles as readonly Styles[]).map(toCssResultGroup);\n  return styles as CSSResultOrNative;\n}\n"]}

package/dist/textarea.d.ts

@@ -1,26 +0,0 @@
-import { Directive, type ChildPart, type PartInfo } from 'lit/directive.js';
-export type TextareaAttribute = string | number | boolean | null | undefined;
-export interface TextareaOptions {
-    /** The model's value. Applied to the live element only when the model changes. */
-    readonly value: string;
-    /** Attributes such as name, id, rows, required, maxlength, data-intent, aria-invalid. */
-    readonly attrs?: Readonly<Record<string, TextareaAttribute>>;
-}
-/** The markup the server writes, and the client's first render: escaped, no bindings inside. */
-export declare function textareaMarkup({ value, attrs }: TextareaOptions): string;
-declare class TextareaDirective extends Directive {
-    #private;
-    constructor(info: PartInfo);
-    render(options: TextareaOptions): unknown;
-    update(part: ChildPart, [options]: [TextareaOptions]): unknown;
-}
-/**
- * A `<textarea>` whose content comes from the model, safe for SSR and hydration:
- *
- *   ${textarea({ value: s.message, attrs: { name: 'message', rows: 5, required: true,
- *                                            'data-intent': i.Message } })}
- *
- * Text typed before or after hydration is kept until the model's value changes.
- */
-export declare const textarea: (options: TextareaOptions) => import("lit/directive.js").DirectiveResult<typeof TextareaDirective>;
-export {};

package/dist/textarea.js

@@ -1,85 +0,0 @@
-// <textarea> support (gyral-czi.34). Lit can't bind inside <textarea>: its content is raw
-// text, so `html\`<textarea>${v}</textarea>\`` throws during SSR ("Unexpected final
-// partIndex") and never updates in the browser. `textarea()` renders the element as a static,
-// escaped template (correct no-JS markup and a hydration match), then keeps it in sync by
-// setting properties and attributes on the same element.
-import { noChange } from 'lit';
-import { Directive, directive, PartType } from 'lit/directive.js';
-import { html as staticHtml, unsafeStatic } from 'lit/static-html.js';
-const escapeText = (s) => s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
-const escapeAttr = (s) => escapeText(s).replace(/"/g, '&quot;');
-const ATTR_NAME = /^[a-zA-Z_:][-a-zA-Z0-9_:.]*$/;
-function attrMarkup(attrs) {
-    return Object.entries(attrs ?? {})
-        .map(([name, value]) => {
-        if (!ATTR_NAME.test(name))
-            throw new Error(`textarea(): invalid attribute name "${name}"`);
-        if (value === false || value === null || value === undefined)
-            return '';
-        return value === true ? ` ${name}` : ` ${name}="${escapeAttr(String(value))}"`;
-    })
-        .join('');
-}
-/** The markup the server writes, and the client's first render: escaped, no bindings inside. */
-export function textareaMarkup({ value, attrs }) {
-    return `<textarea${attrMarkup(attrs)}>${escapeText(value)}</textarea>`;
-}
-function findTextarea(part) {
-    for (let node = part.startNode?.nextSibling; node && node !== part.endNode; node = node.nextSibling) {
-        if (node instanceof HTMLTextAreaElement)
-            return node;
-    }
-    return undefined;
-}
-function syncAttributes(el, attrs) {
-    for (const [name, value] of Object.entries(attrs ?? {})) {
-        if (value === false || value === null || value === undefined)
-            el.removeAttribute(name);
-        else
-            el.setAttribute(name, value === true ? '' : String(value));
-    }
-}
-class TextareaDirective extends Directive {
-    /** The model value last applied, so typing isn't overwritten by an unchanged model. */
-    #applied;
-    constructor(info) {
-        super(info);
-        if (info.type !== PartType.CHILD) {
-            throw new Error('textarea() must be used in a child position: html`${textarea({…})}`');
-        }
-    }
-    render(options) {
-        return staticHtml `${unsafeStatic(textareaMarkup(options))}`;
-    }
-    update(part, [options]) {
-        const el = findTextarea(part);
-        if (el === undefined) {
-            // First render (client) or hydration (server markup already in place): same template.
-            this.#applied = options.value;
-            return this.render(options);
-        }
-        syncAttributes(el, options.attrs);
-        if (this.#applied === undefined) {
-            // Hydration: the server's element is already here. Keep whatever the user typed before
-            // the script loaded; only later model changes write the value.
-            this.#applied = options.value;
-            return noChange;
-        }
-        if (options.value !== this.#applied) {
-            this.#applied = options.value;
-            if (el.value !== options.value)
-                el.value = options.value;
-        }
-        return noChange;
-    }
-}
-/**
- * A `<textarea>` whose content comes from the model, safe for SSR and hydration:
- *
- *   ${textarea({ value: s.message, attrs: { name: 'message', rows: 5, required: true,
- *                                            'data-intent': i.Message } })}
- *
- * Text typed before or after hydration is kept until the model's value changes.
- */
-export const textarea = directive(TextareaDirective);
-//# sourceMappingURL=textarea.js.map

package/dist/textarea.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"textarea.js","sourceRoot":"","sources":["../src/textarea.ts"],"names":[],"mappings":"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","sourcesContent":["// <textarea> support (gyral-czi.34). Lit can't bind inside <textarea>: its content is raw\n// text, so `html\\`<textarea>${v}</textarea>\\`` throws during SSR (\"Unexpected final\n// partIndex\") and never updates in the browser. `textarea()` renders the element as a static,\n// escaped template (correct no-JS markup and a hydration match), then keeps it in sync by\n// setting properties and attributes on the same element.\nimport { noChange } from 'lit';\nimport { Directive, directive, PartType, type ChildPart, type PartInfo } from 'lit/directive.js';\nimport { html as staticHtml, unsafeStatic } from 'lit/static-html.js';\n\nexport type TextareaAttribute = string | number | boolean | null | undefined;\n\nexport interface TextareaOptions {\n  /** The model's value. Applied to the live element only when the model changes. */\n  readonly value: string;\n  /** Attributes such as name, id, rows, required, maxlength, data-intent, aria-invalid. */\n  readonly attrs?: Readonly<Record<string, TextareaAttribute>>;\n}\n\nconst escapeText = (s: string): string =>\n  s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');\nconst escapeAttr = (s: string): string => escapeText(s).replace(/\"/g, '&quot;');\nconst ATTR_NAME = /^[a-zA-Z_:][-a-zA-Z0-9_:.]*$/;\n\nfunction attrMarkup(attrs: TextareaOptions['attrs']): string {\n  return Object.entries(attrs ?? {})\n    .map(([name, value]) => {\n      if (!ATTR_NAME.test(name)) throw new Error(`textarea(): invalid attribute name \"${name}\"`);\n      if (value === false || value === null || value === undefined) return '';\n      return value === true ? ` ${name}` : ` ${name}=\"${escapeAttr(String(value))}\"`;\n    })\n    .join('');\n}\n\n/** The markup the server writes, and the client's first render: escaped, no bindings inside. */\nexport function textareaMarkup({ value, attrs }: TextareaOptions): string {\n  return `<textarea${attrMarkup(attrs)}>${escapeText(value)}</textarea>`;\n}\n\nfunction findTextarea(part: ChildPart): HTMLTextAreaElement | undefined {\n  for (\n    let node = part.startNode?.nextSibling;\n    node && node !== part.endNode;\n    node = node.nextSibling\n  ) {\n    if (node instanceof HTMLTextAreaElement) return node;\n  }\n  return undefined;\n}\n\nfunction syncAttributes(el: HTMLTextAreaElement, attrs: TextareaOptions['attrs']): void {\n  for (const [name, value] of Object.entries(attrs ?? {})) {\n    if (value === false || value === null || value === undefined) el.removeAttribute(name);\n    else el.setAttribute(name, value === true ? '' : String(value));\n  }\n}\n\nclass TextareaDirective extends Directive {\n  /** The model value last applied, so typing isn't overwritten by an unchanged model. */\n  #applied: string | undefined;\n\n  constructor(info: PartInfo) {\n    super(info);\n    if (info.type !== PartType.CHILD) {\n      throw new Error('textarea() must be used in a child position: html`${textarea({…})}`');\n    }\n  }\n\n  override render(options: TextareaOptions): unknown {\n    return staticHtml`${unsafeStatic(textareaMarkup(options))}`;\n  }\n\n  override update(part: ChildPart, [options]: [TextareaOptions]): unknown {\n    const el = findTextarea(part);\n    if (el === undefined) {\n      // First render (client) or hydration (server markup already in place): same template.\n      this.#applied = options.value;\n      return this.render(options);\n    }\n    syncAttributes(el, options.attrs);\n    if (this.#applied === undefined) {\n      // Hydration: the server's element is already here. Keep whatever the user typed before\n      // the script loaded; only later model changes write the value.\n      this.#applied = options.value;\n      return noChange;\n    }\n    if (options.value !== this.#applied) {\n      this.#applied = options.value;\n      if (el.value !== options.value) el.value = options.value;\n    }\n    return noChange;\n  }\n}\n\n/**\n * A `<textarea>` whose content comes from the model, safe for SSR and hydration:\n *\n *   ${textarea({ value: s.message, attrs: { name: 'message', rows: 5, required: true,\n *                                            'data-intent': i.Message } })}\n *\n * Text typed before or after hydration is kept until the model's value changes.\n */\nexport const textarea = directive(TextareaDirective);\n"]}