@lostgradient/cinder 0.1.1 → 0.2.0

package/dist/components/share-card/share-card.svelte.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @cinder
+ * @category action
+ * @status alpha
+ * @purpose Compact share card with copy-link, copy-text, and native navigator.share actions, with accessible success announcements and graceful fallback when navigator.share is unavailable.
+ * @tag action
+ * @tag clipboard
+ * @useWhen Offering a quick way to share a link or text with copy and native share options.
+ * @useWhen Presenting a result, invite link, or exported report link with sharing affordances.
+ * @avoidWhen Generating the share text or images — compose ShareCard with your own copy generation logic.
+ * @avoidWhen Posting directly to social media or analytics — wire those externally.
+ * @related copy-button, card, button
+ */
+export type { ShareCardAction, ShareCardProps } from './share-card.types.ts';
+import type { ShareCardProps } from './share-card.types.ts';
+declare const ShareCard: import("svelte").Component<ShareCardProps, {}, "">;
+type ShareCard = ReturnType<typeof ShareCard>;
+export default ShareCard;

package/dist/components/share-card/share-card.types.d.ts

@@ -0,0 +1,66 @@
+import type { Snippet } from 'svelte';
+import type { HTMLAttributes } from 'svelte/elements';
+/** An action to include in the share card. */
+export type ShareCardAction = {
+    /** Unique key for this action. */
+    key: string;
+    /** Visible label for the action button. */
+    label: string;
+    /** Text to copy when this action is triggered (used for copy-link/copy-text). */
+    copyValue?: string;
+    /** Called when this action button is clicked. */
+    onClick?: () => void;
+    /** Whether to use navigator.share for this action. */
+    useNativeShare?: boolean;
+};
+/** Props for the ShareCard component. */
+export type ShareCardProps = Omit<HTMLAttributes<HTMLDivElement>, 'class' | 'children'> & {
+    /** The URL or text to share/copy. */
+    value: string;
+    /** Human-readable title for the share card. */
+    title?: string;
+    /** Additional descriptive text below the title. */
+    description?: string;
+    /** Explicit actions to show. When omitted, default copy-link and native-share actions are rendered. */
+    actions?: ShareCardAction[];
+    /** Label for the copy-link button. @default "Copy link" */
+    copyLinkLabel?: string;
+    /** Label shown after a successful copy. @default "Copied!" */
+    copiedLabel?: string;
+    /** Label for the native-share button. Only shown when navigator.share is available. @default "Share" */
+    shareLabel?: string;
+    /** Duration in ms to show the copied confirmation state. @default 2000 */
+    confirmDuration?: number;
+    /** Preview content slot rendered above the actions. */
+    preview?: Snippet;
+    /** Additional class names merged with `.cinder-share-card`. */
+    class?: string;
+};
+/**
+ * Cinder-specific props for ShareCard, used by the schema generator.
+ */
+export interface ShareCardSchemaProps {
+    /** The URL or text to share/copy. */
+    value: string;
+    /** Human-readable title for the share card. */
+    title?: string;
+    /** Additional descriptive text. */
+    description?: string;
+    /** Label for the copy-link button. */
+    copyLinkLabel?: string;
+    /** Label shown after a successful copy. */
+    copiedLabel?: string;
+    /** Label for the native-share button. */
+    shareLabel?: string;
+    /**
+     * Duration in ms to show the copied confirmation state.
+     * @default 2000
+     */
+    confirmDuration?: number;
+    /** Additional class names merged with `.cinder-share-card`. */
+    class?: string;
+    /** Explicit actions to show. When omitted, default copy + native-share actions render. */
+    actions?: ShareCardAction[];
+    /** Preview content slot rendered above the actions. */
+    preview?: Snippet;
+}

package/dist/components/share-card/share-card.variables.d.ts

@@ -0,0 +1,2 @@
+declare const variables: readonly string[];
+export default variables;

package/dist/components/share-card/share-card.variables.js

@@ -0,0 +1,61 @@
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
+var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: __accessProp.bind(mod, key),
+        enumerable: true
+      });
+  if (canCache)
+    cache.set(mod, to);
+  return to;
+};
+var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined")
+    return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/components/share-card/share-card.variables.ts
+var variables = [];
+var share_card_variables_default = variables;
+export {
+  share_card_variables_default as default
+};
+
+//# debugId=4D6D0B2A055ED1CB64756E2164756E21

package/dist/components/shortcut-hint/index.d.ts

@@ -0,0 +1,5 @@
+import './shortcut-hint.css';
+import ShortcutHint from './shortcut-hint.svelte';
+export default ShortcutHint;
+export type { ShortcutHintProps } from './shortcut-hint.types.ts';
+export { ShortcutHint };

package/dist/components/shortcut-hint/index.js

@@ -0,0 +1,197 @@
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
+var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: __accessProp.bind(mod, key),
+        enumerable: true
+      });
+  if (canCache)
+    cache.set(mod, to);
+  return to;
+};
+var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined")
+    return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/components/shortcut-hint/index.ts
+import"@lostgradient/cinder/shortcut-hint/styles";
+
+// src/components/shortcut-hint/shortcut-hint.svelte
+import"svelte/internal/disclose-version";
+import * as $2 from "svelte/internal/client";
+
+// src/utilities/class-names.ts
+function classNames(...parts) {
+  return parts.filter((part) => typeof part === "string" && part.length > 0).join(" ");
+}
+
+// src/components/kbd/kbd.svelte
+import"svelte/internal/disclose-version";
+import * as $ from "svelte/internal/client";
+var root = $.from_html(`<kbd><!></kbd>`);
+function Kbd($$anchor, $$props) {
+  $.push($$props, true);
+  let size = $.prop($$props, "size", 3, "md"), rest = $.rest_props($$props, [
+    "$$slots",
+    "$$events",
+    "$$legacy",
+    "class",
+    "size",
+    "label",
+    "children"
+  ]);
+  var kbd = root();
+  $.attribute_effect(kbd, ($0) => ({ class: $0, "data-cinder-size": size(), ...rest }), [() => classNames("cinder-kbd", $$props.class)]);
+  var node = $.child(kbd);
+  {
+    var consequent = ($$anchor2) => {
+      var fragment = $.comment();
+      var node_1 = $.first_child(fragment);
+      $.snippet(node_1, () => $$props.children);
+      $.append($$anchor2, fragment);
+    };
+    var alternate = ($$anchor2) => {
+      var text2 = $.text();
+      $.template_effect(() => $.set_text(text2, $$props.label));
+      $.append($$anchor2, text2);
+    };
+    $.if(node, ($$render) => {
+      if ($$props.children)
+        $$render(consequent);
+      else
+        $$render(alternate, -1);
+    });
+  }
+  $.reset(kbd);
+  $.append($$anchor, kbd);
+  $.pop();
+}
+
+// src/components/shortcut-hint/shortcut-hint.svelte
+var root_1 = $2.from_html(`<span class="cinder-shortcut-hint__label"><!></span>`);
+var root_3 = $2.from_html(`<span class="cinder-shortcut-hint__separator">+</span>`);
+var root_2 = $2.from_html(`<!> <!>`, 1);
+var root_4 = $2.from_html(`<span class="cinder-shortcut-hint__label"><!></span>`);
+var root2 = $2.from_html(`<span><!> <span class="cinder-shortcut-hint__keys" aria-hidden="true"></span> <span class="cinder-sr-only"> </span> <!></span>`);
+function Shortcut_hint($$anchor, $$props) {
+  $2.push($$props, true);
+  let keysPosition = $2.prop($$props, "keysPosition", 3, "after"), rest = $2.rest_props($$props, [
+    "$$slots",
+    "$$events",
+    "$$legacy",
+    "keys",
+    "keysLabel",
+    "children",
+    "keysPosition",
+    "class"
+  ]);
+  const resolvedKeysLabel = $2.derived(() => $$props.keysLabel ?? $$props.keys.join(" plus "));
+  var span = root2();
+  $2.attribute_effect(span, ($0) => ({ ...rest, class: $0 }), [() => classNames("cinder-shortcut-hint", $$props.class)]);
+  var node = $2.child(span);
+  {
+    var consequent = ($$anchor2) => {
+      var span_1 = root_1();
+      var node_1 = $2.child(span_1);
+      $2.snippet(node_1, () => $$props.children);
+      $2.reset(span_1);
+      $2.append($$anchor2, span_1);
+    };
+    $2.if(node, ($$render) => {
+      if ($$props.children && keysPosition() === "after")
+        $$render(consequent);
+    });
+  }
+  var span_2 = $2.sibling(node, 2);
+  $2.each(span_2, 23, () => $$props.keys, (key, index) => key + index, ($$anchor2, key, index) => {
+    var fragment = root_2();
+    var node_2 = $2.first_child(fragment);
+    Kbd(node_2, {
+      get label() {
+        return $2.get(key);
+      },
+      size: "sm"
+    });
+    var node_3 = $2.sibling(node_2, 2);
+    {
+      var consequent_1 = ($$anchor3) => {
+        var span_3 = root_3();
+        $2.append($$anchor3, span_3);
+      };
+      $2.if(node_3, ($$render) => {
+        if ($2.get(index) < $$props.keys.length - 1)
+          $$render(consequent_1);
+      });
+    }
+    $2.append($$anchor2, fragment);
+  });
+  $2.reset(span_2);
+  var span_4 = $2.sibling(span_2, 2);
+  var text2 = $2.child(span_4, true);
+  $2.reset(span_4);
+  var node_4 = $2.sibling(span_4, 2);
+  {
+    var consequent_2 = ($$anchor2) => {
+      var span_5 = root_4();
+      var node_5 = $2.child(span_5);
+      $2.snippet(node_5, () => $$props.children);
+      $2.reset(span_5);
+      $2.append($$anchor2, span_5);
+    };
+    $2.if(node_4, ($$render) => {
+      if ($$props.children && keysPosition() === "before")
+        $$render(consequent_2);
+    });
+  }
+  $2.reset(span);
+  $2.template_effect(() => $2.set_text(text2, $2.get(resolvedKeysLabel)));
+  $2.append($$anchor, span);
+  $2.pop();
+}
+
+// src/components/shortcut-hint/index.ts
+var shortcut_hint_default = Shortcut_hint;
+export {
+  shortcut_hint_default as default,
+  Shortcut_hint as ShortcutHint
+};
+
+//# debugId=57DD5F61D7E015CF64756E2164756E21

package/dist/components/shortcut-hint/shortcut-hint.css

@@ -0,0 +1,26 @@
+@layer cinder.tokens, cinder.foundation, cinder.components, cinder.utilities;
+@layer cinder.components {
+  .cinder-shortcut-hint {
+    display: inline-flex;
+    align-items: center;
+    gap: var(--cinder-space-1);
+  }
+
+  .cinder-shortcut-hint__label {
+    color: var(--cinder-text);
+  }
+
+  .cinder-shortcut-hint__keys {
+    display: inline-flex;
+    align-items: center;
+    gap: var(--cinder-space-1);
+    flex-shrink: 0;
+  }
+
+  .cinder-shortcut-hint__separator {
+    font-size: var(--cinder-text-xs);
+    color: var(--cinder-text-muted);
+    line-height: 1;
+    user-select: none;
+  }
+}

package/dist/components/shortcut-hint/shortcut-hint.schema.d.ts

@@ -0,0 +1,3 @@
+import type { ComponentSchema } from '../../schema-types';
+declare const _default: ComponentSchema;
+export default _default;

package/dist/components/shortcut-hint/shortcut-hint.schema.js

@@ -0,0 +1,96 @@
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
+var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: __accessProp.bind(mod, key),
+        enumerable: true
+      });
+  if (canCache)
+    cache.set(mod, to);
+  return to;
+};
+var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined")
+    return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/components/shortcut-hint/shortcut-hint.schema.ts
+var schema = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  type: "object",
+  properties: {
+    keys: {
+      type: "array",
+      items: {
+        type: "string"
+      },
+      description: "The key sequence to display."
+    },
+    keysLabel: {
+      type: "string",
+      description: "Accessible label for the key combo."
+    },
+    keysPosition: {
+      enum: ["before", "after"],
+      description: "Position of keys relative to children.",
+      default: "after"
+    },
+    class: {
+      type: "string",
+      description: "Additional class names merged with `.cinder-shortcut-hint`."
+    }
+  },
+  additionalProperties: false,
+  required: ["keys"],
+  metadata: {
+    unsupportedProps: [
+      {
+        name: "children",
+        reason: "function-or-snippet"
+      }
+    ]
+  }
+};
+var shortcut_hint_schema_default = schema;
+export {
+  shortcut_hint_schema_default as default
+};
+
+//# debugId=0EC4579353972B7E64756E2164756E21

package/dist/components/shortcut-hint/shortcut-hint.svelte.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @cinder
+ * @category typography
+ * @status alpha
+ * @purpose Inline shortcut hint that renders a key combo via Kbd alongside an action label, with an accessible text representation not reliant on visual keycaps alone.
+ * @tag shortcut
+ * @tag inline
+ * @useWhen Showing a keyboard shortcut inline beside a label in a toolbar button, menu item, or tooltip.
+ * @useWhen Pairing with command-palette items to surface available shortcuts.
+ * @avoidWhen Displaying a full shortcut reference table — use keyboard-shortcuts instead.
+ * @related kbd, keyboard-shortcuts, tooltip
+ */
+export type { ShortcutHintProps } from './shortcut-hint.types.ts';
+import type { ShortcutHintProps } from './shortcut-hint.types.ts';
+declare const ShortcutHint: import("svelte").Component<ShortcutHintProps, {}, "">;
+type ShortcutHint = ReturnType<typeof ShortcutHint>;
+export default ShortcutHint;

package/dist/components/shortcut-hint/shortcut-hint.types.d.ts

@@ -0,0 +1,33 @@
+import type { Snippet } from 'svelte';
+import type { HTMLAttributes } from 'svelte/elements';
+/** Props for the ShortcutHint component. */
+export type ShortcutHintProps = Omit<HTMLAttributes<HTMLSpanElement>, 'class' | 'children'> & {
+    /** The key sequence to display (e.g. ["Ctrl", "S"] or ["Space"]). */
+    keys: string[];
+    /** Optional accessible label for the key combo. Defaults to joining keys with " plus ". */
+    keysLabel?: string;
+    /** The action or label to render alongside the key combo. */
+    children?: Snippet;
+    /** Whether to place the keys before or after the children. @default "after" */
+    keysPosition?: 'before' | 'after';
+    /** Additional class names merged with `.cinder-shortcut-hint`. */
+    class?: string;
+};
+/**
+ * Cinder-specific props for ShortcutHint, used by the schema generator.
+ */
+export interface ShortcutHintSchemaProps {
+    /** The key sequence to display. */
+    keys: string[];
+    /** Accessible label for the key combo. */
+    keysLabel?: string;
+    /**
+     * Position of keys relative to children.
+     * @default "after"
+     */
+    keysPosition?: 'before' | 'after';
+    /** Additional class names merged with `.cinder-shortcut-hint`. */
+    class?: string;
+    /** The action label rendered beside the keys. */
+    children?: Snippet;
+}

package/dist/components/shortcut-hint/shortcut-hint.variables.d.ts

@@ -0,0 +1,2 @@
+declare const variables: readonly string[];
+export default variables;

package/dist/components/shortcut-hint/shortcut-hint.variables.js

@@ -0,0 +1,61 @@
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
+var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: __accessProp.bind(mod, key),
+        enumerable: true
+      });
+  if (canCache)
+    cache.set(mod, to);
+  return to;
+};
+var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined")
+    return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/components/shortcut-hint/shortcut-hint.variables.ts
+var variables = [];
+var shortcut_hint_variables_default = variables;
+export {
+  shortcut_hint_variables_default as default
+};
+
+//# debugId=89BF484AAC6ED13064756E2164756E21

package/dist/components/skip-link/index.d.ts

@@ -0,0 +1,4 @@
+import SkipLink from './skip-link.svelte';
+export default SkipLink;
+export type { SkipLinkProps, SkipLinkSchemaProps } from './skip-link.types.ts';
+export { SkipLink };