@ggts-sh/svelte 0.43.0

package/dist/guides/GuideLegend.svelte

@@ -0,0 +1,90 @@
+<script lang="ts">
+  /**
+   * <GuideLegend> — declaration-only legend-guide layer for <GGPlot>
+   * (#659 slice 6). Presentation of one aesthetic's legend: title, position,
+   * direction, key size, collision, and the INTEGER placement rank `order`.
+   *
+   * Host interaction: `focus` and `filter` opt this channel into discrete
+   * legend emphasis / data-changing checkboxes. They are NOT PortableSpec
+   * fields — stripped before guideLegend() and registered as host layer
+   * kinds `legendFocus` / `legendFilter`. Focus- or filter-only children
+   * (no presentation options) do not force a guides entry, so continuous
+   * colour scales keep their colorbar without a guide-aesthetic-incompatible
+   * pipeline error.
+   *
+   * Not to be confused with <Legend order="sorted"/>, which is the plot-wide
+   * entry-SORT enum (LegendSpec). Same word, unrelated concepts.
+   * Emits NO markup.
+   */
+  import { guideLegend, type LegendGuideOptions } from "@ggts-sh/spec";
+
+  import type { LegendFocusInput } from "../interaction/interaction.js";
+  import type { LegendFilterInput } from "../legend/filter.js";
+  import {
+    isLegendFilterPropEnabled,
+    type LegendFilterLayerValue,
+  } from "../legend/resolve-legend-filter.js";
+  import {
+    isLegendFocusPropEnabled,
+    type LegendFocusLayerValue,
+  } from "../legend/resolve-legend-focus.js";
+  import {
+    createPlotLayer,
+    definedProps,
+  } from "../layers/plot-layer.svelte.js";
+  import {
+    splitChannel,
+    type NonPositionGuideChannel,
+  } from "./factory.svelte.js";
+
+  type Props = LegendGuideOptions & {
+    channel: NonPositionGuideChannel;
+    /**
+     * Opt this channel into discrete legend preview, focus, and linked
+     * emphasis. Host-only — never appears in PortableSpec.
+     */
+    focus?: LegendFocusInput;
+    /**
+     * Opt this channel into data-changing filtering through discrete legend
+     * checkboxes. Host-only — never appears in PortableSpec.
+     */
+    filter?: LegendFilterInput;
+  };
+
+  const props: Props = $props();
+
+  createPlotLayer("guides", () => {
+    const defined = definedProps(props) as Props;
+    const { focus: _focus, filter: _filter, ...withoutHost } = defined;
+    const { channel, options } = splitChannel(withoutHost);
+    // Focus/filter-only: do not force type:"legend" (breaks continuous ramps).
+    if (
+      Object.keys(options).length === 0 &&
+      (isLegendFocusPropEnabled(defined.focus) ||
+        isLegendFilterPropEnabled(defined.filter))
+    ) {
+      return {};
+    }
+    return { [channel]: guideLegend(options) };
+  });
+
+  createPlotLayer("legendFocus", (): LegendFocusLayerValue => {
+    const defined = definedProps(props) as Props;
+    const focus = defined.focus;
+    if (!isLegendFocusPropEnabled(focus)) return null;
+    return {
+      channel: defined.channel,
+      input: focus === true ? true : focus,
+    };
+  });
+
+  createPlotLayer("legendFilter", (): LegendFilterLayerValue => {
+    const defined = definedProps(props) as Props;
+    const filter = defined.filter;
+    if (!isLegendFilterPropEnabled(filter)) return null;
+    return {
+      channel: defined.channel,
+      input: filter === true ? true : filter,
+    };
+  });
+</script>

package/dist/guides/GuideLegend.svelte.d.ts

@@ -0,0 +1,37 @@
+/**
+   * <GuideLegend> — declaration-only legend-guide layer for <GGPlot>
+   * (#659 slice 6). Presentation of one aesthetic's legend: title, position,
+   * direction, key size, collision, and the INTEGER placement rank `order`.
+   *
+   * Host interaction: `focus` and `filter` opt this channel into discrete
+   * legend emphasis / data-changing checkboxes. They are NOT PortableSpec
+   * fields — stripped before guideLegend() and registered as host layer
+   * kinds `legendFocus` / `legendFilter`. Focus- or filter-only children
+   * (no presentation options) do not force a guides entry, so continuous
+   * colour scales keep their colorbar without a guide-aesthetic-incompatible
+   * pipeline error.
+   *
+   * Not to be confused with <Legend order="sorted"/>, which is the plot-wide
+   * entry-SORT enum (LegendSpec). Same word, unrelated concepts.
+   * Emits NO markup.
+   */
+import { type LegendGuideOptions } from "@ggts-sh/spec";
+import type { LegendFocusInput } from "../interaction/interaction.js";
+import type { LegendFilterInput } from "../legend/filter.js";
+import { type NonPositionGuideChannel } from "./factory.svelte.js";
+type Props = LegendGuideOptions & {
+    channel: NonPositionGuideChannel;
+    /**
+     * Opt this channel into discrete legend preview, focus, and linked
+     * emphasis. Host-only — never appears in PortableSpec.
+     */
+    focus?: LegendFocusInput;
+    /**
+     * Opt this channel into data-changing filtering through discrete legend
+     * checkboxes. Host-only — never appears in PortableSpec.
+     */
+    filter?: LegendFilterInput;
+};
+declare const GuideLegend: import("svelte").Component<Props, {}, "">;
+type GuideLegend = ReturnType<typeof GuideLegend>;
+export default GuideLegend;

package/dist/guides/GuideNone.svelte

@@ -0,0 +1,19 @@
+<script lang="ts">
+  /**
+   * <GuideNone> — declaration-only "suppress this guide" layer for <GGPlot>
+   * (#659 slice 6). `<GuideNone channel="size"/>` hides the size legend.
+   * Any aesthetic, positional or not. Emits NO markup.
+   */
+  import { guideNone } from "@ggts-sh/spec";
+
+  import { createPlotLayer } from "../layers/plot-layer.svelte.js";
+  import { splitChannel, type GuideChannel } from "./factory.svelte.js";
+
+  type Props = { channel: GuideChannel };
+
+  const props: Props = $props();
+  createPlotLayer("guides", () => {
+    const { channel } = splitChannel(props);
+    return { [channel]: guideNone() };
+  });
+</script>

package/dist/guides/GuideNone.svelte.d.ts

@@ -0,0 +1,7 @@
+import { type GuideChannel } from "./factory.svelte.js";
+type Props = {
+    channel: GuideChannel;
+};
+declare const GuideNone: import("svelte").Component<Props, {}, "">;
+type GuideNone = ReturnType<typeof GuideNone>;
+export default GuideNone;

package/dist/guides/Guides.svelte

@@ -0,0 +1,14 @@
+<script lang="ts">
+  /**
+   * <Guides> — declaration-only escape hatch for the whole GuidesSpec
+   * (#659 slice 6). For raw fragments and computed multi-channel guide bags;
+   * prefer the keyed shells (<GuideLegend channel="color"/>, …) when the shape
+   * is known at authoring time. Emits NO markup.
+   */
+  import type { GuidesSpec } from "@ggts-sh/spec";
+
+  import { createPlotLayer } from "../layers/plot-layer.svelte.js";
+
+  const { value }: { value: GuidesSpec } = $props();
+  createPlotLayer("guides", () => value);
+</script>

package/dist/guides/Guides.svelte.d.ts

@@ -0,0 +1,13 @@
+/**
+   * <Guides> — declaration-only escape hatch for the whole GuidesSpec
+   * (#659 slice 6). For raw fragments and computed multi-channel guide bags;
+   * prefer the keyed shells (<GuideLegend channel="color"/>, …) when the shape
+   * is known at authoring time. Emits NO markup.
+   */
+import type { GuidesSpec } from "@ggts-sh/spec";
+type $$ComponentProps = {
+    value: GuidesSpec;
+};
+declare const Guides: import("svelte").Component<$$ComponentProps, {}, "">;
+type Guides = ReturnType<typeof Guides>;
+export default Guides;

package/dist/guides/factory.svelte.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Guide channel types + splitChannel for declaration-only guide shells
+ * (#659 slice 6). Registration lives in {@link createPlotLayer} (#786).
+ *
+ * Guides are keyed by AESTHETIC, so this family is five type shells that each
+ * take a `channel` prop — not a 5×9 codegen matrix. The aesthetic is the key,
+ * never part of the helper: `<GuideLegend channel="color" position="bottom"/>`
+ * assembles `guides: { color: { type: "legend", position: "bottom" } }`.
+ *
+ * guides is a keyed-MERGE family, but the VALUE at a key is replaced whole —
+ * `builder.guides` shallow-merges by channel, so a child never field-merges
+ * into a prop's guide object.
+ */
+import type { GuidesSpec } from "@ggts-sh/spec";
+/** Every aesthetic a guide can be keyed by. */
+export type GuideChannel = keyof GuidesSpec;
+/** Aesthetics an axis guide can key: the positional pair. */
+export type PositionGuideChannel = Extract<GuideChannel, "x" | "y">;
+/** Aesthetics a legend/colorbar/colorsteps guide can key. */
+export type NonPositionGuideChannel = Exclude<GuideChannel, "x" | "y">;
+/**
+ * Split a shell's live props into the channel key and the guide options.
+ *
+ * Stripping `channel` here — rather than in each shell — is load-bearing:
+ * every *GuideSpec is `additionalProperties: false`, so a leaked `channel` key
+ * inside the guide object fails validate() rather than being ignored.
+ *
+ * Uses shared {@link definedProps} so undefined option keys are dropped before
+ * the rest-spread, matching the other grammar families.
+ */
+export declare function splitChannel<Props extends {
+    channel: GuideChannel;
+}>(props: Props): {
+    channel: GuideChannel;
+    options: Omit<Props, "channel">;
+};

package/dist/guides/factory.svelte.js

@@ -0,0 +1,15 @@
+import { definedProps } from "../layers/plot-layer.svelte.js";
+/**
+ * Split a shell's live props into the channel key and the guide options.
+ *
+ * Stripping `channel` here — rather than in each shell — is load-bearing:
+ * every *GuideSpec is `additionalProperties: false`, so a leaked `channel` key
+ * inside the guide object fails validate() rather than being ignored.
+ *
+ * Uses shared {@link definedProps} so undefined option keys are dropped before
+ * the rest-spread, matching the other grammar families.
+ */
+export function splitChannel(props) {
+    const { channel, ...options } = definedProps(props);
+    return { channel, options };
+}