@dreamboard-games/sdk 0.4.0-alpha.1 → 0.4.0-alpha.10

package/dist/HandView-Bi2lxzQP.d.ts

@@ -0,0 +1,79 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode, CSSProperties } from 'react';
+import { ViewCard } from './types.js';
+import { P as InteractionVisualState, f as CardIntent } from './hex-board-view-aKkblDp6.js';
+
+/**
+ * Pure layout math for the controlled `HandView`.
+ *
+ * The functions here are independent of React and DOM measurement so they can
+ * be unit-tested directly. {@link computeFanLayout} matches the algorithm
+ * documented in `docs/reference/ui-sdk-mobile-hand-and-card-interactions.md`,
+ * and {@link chooseHandLayoutMode} translates a measured container width and a
+ * caller policy into the actual presentation mode the hand should render.
+ */
+type HandPresentationMode = "fan" | "compressed-fan" | "strip" | "tray";
+
+/**
+ * Deterministic pointer recognizer for the controlled hand view.
+ *
+ * The engine is independent from React: it consumes pointer events and a
+ * caller-supplied callbacks bag, and produces semantic gesture events. It
+ * owns no DOM, emits no `CardIntent`, and does not track the drag-lifecycle
+ * `phase` — that responsibility lives in `CardDragSurface`. The engine only
+ * recognizes `tap`, `previewStart`/`previewEnd`, `liftStart`/`liftMove`/
+ * `liftEnd`/`liftCancel`, and a `horizontalBrowse` informational signal.
+ *
+ * The thresholds match
+ * `docs/reference/ui-sdk-mobile-hand-and-card-interactions.md`:
+ *
+ * | Threshold                 | Default     |
+ * | ------------------------- | ----------- |
+ * | Press preview delay       | `220ms`     |
+ * | Movement slop             | `8px`       |
+ * | Axis bias                 | `1.25`      |
+ * | Drag lift distance        | `28px`      |
+ *
+ * Callers wire the engine's `handlePointerDown` / `handlePointerMove` /
+ * `handlePointerUp` / `handlePointerCancel` to the matching DOM events on
+ * each interactive card.
+ */
+type HandInteractionPolicy = "direct-activate" | "drag-to-target";
+
+type HandLayoutKind = HandPresentationMode | "stack";
+interface HandLayoutPolicy {
+    desktop?: HandLayoutKind;
+    mobile?: HandLayoutKind;
+}
+interface HandViewProps<CardData extends ViewCard = ViewCard> {
+    cards: readonly CardData[];
+    /**
+     * Layout policy. Pass a single layout kind to use the same layout in every
+     * viewport, or pass `{ desktop, mobile }` for a measured-width decision.
+     * Defaults to `{ desktop: "fan", mobile: "tray" }`.
+     */
+    layout?: HandLayoutKind | HandLayoutPolicy;
+    /**
+     * Mobile interaction policy. Defaults to `direct-activate`. Use
+     * `drag-to-target` together with a surrounding `CardDragSurface` and one
+     * or more `CardDropTargetView` children.
+     */
+    mobileInteraction?: HandInteractionPolicy;
+    /** Returns the controlled visual state for a card. */
+    stateForCard?: (card: CardData, index: number) => InteractionVisualState | undefined;
+    /** Visual surface renderer. */
+    renderCard: (card: CardData, state: InteractionVisualState, index: number) => ReactNode;
+    /** Generic UI intent callback. */
+    onCardIntent?: (intent: CardIntent<CardData["id"] & string>) => void;
+    /** Card width hint for fan geometry. */
+    cardSize?: "sm" | "md" | "lg";
+    /** Slot for the empty state. Defaults to nothing rendered. */
+    renderEmpty?: () => ReactNode;
+    /** ARIA label for the hand region. */
+    "aria-label"?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+declare function HandView<CardData extends ViewCard = ViewCard>({ cards, layout, mobileInteraction, stateForCard, renderCard, onCardIntent, cardSize, renderEmpty, "aria-label": ariaLabel, className, style, }: HandViewProps<CardData>): react_jsx_runtime.JSX.Element;
+
+export { type HandInteractionPolicy as H, type HandLayoutKind as a, type HandLayoutPolicy as b, HandView as c, type HandViewProps as d };

package/dist/{ResourceCounter-BTXklCEZ.d.ts → ResourceCounter-BFxJknqp.d.ts}

@@ -20,14 +20,10 @@ declare function MobileHandTrayProvider({ children }: {
     children: ReactNode;
 }): react_jsx_runtime.JSX.Element;
 declare function useRegisterMobileHand(hand: MobileHandRegistration): void;
-/**
- * Whether the mobile hand tray is currently presenting hands — i.e. the
- * viewport is below the mobile breakpoint and at least one primary/auxiliary
- * hand has registered. Authors can use this to drop redundant inline hand
- * chrome (labels, framing) that the tray already provides, instead of guessing
- * the breakpoint with a CSS media query. Returns `false` outside `<UI.Root>`.
- */
-declare function useMobileHandTrayActive(): boolean;
+declare function useOverlayInsets(): {
+    bottom: number;
+};
+declare function useRegisterBottomOverlayInset(id: string, height: number): void;
 
 type ResourceId = string;
 interface ResourceDisplayConfig<Resource extends string = ResourceId> {
@@ -99,4 +95,4 @@ declare const ResourceCounter: {
     Label: typeof ResourceCounterLabel;
 };
 
-export { type BoundResourceCounterRootProps as B, type HandRole as H, type MobileHandRegistration as M, ResourceCounter as R, MobileHandTrayProvider as a, type ResourceCounterComponents as b, ResourceCounterCount as c, ResourceCounterIcon as d, ResourceCounterItem as e, type ResourceCounterItemState as f, ResourceCounterLabel as g, type ResourceCounterPartProps as h, type ResourceCounterProps as i, ResourceCounterRoot as j, type ResourceCounterRootProps as k, type ResourceDisplayConfig as l, type ResourceIconProps as m, createResourceCounter as n, useRegisterMobileHand as o, useMobileHandTrayActive as u };
+export { type BoundResourceCounterRootProps as B, type HandRole as H, type MobileHandRegistration as M, ResourceCounter as R, MobileHandTrayProvider as a, type ResourceCounterComponents as b, ResourceCounterCount as c, ResourceCounterIcon as d, ResourceCounterItem as e, type ResourceCounterItemState as f, ResourceCounterLabel as g, type ResourceCounterPartProps as h, type ResourceCounterProps as i, ResourceCounterRoot as j, type ResourceCounterRootProps as k, type ResourceDisplayConfig as l, type ResourceIconProps as m, createResourceCounter as n, useRegisterBottomOverlayInset as o, useRegisterMobileHand as p, useOverlayInsets as u };

package/dist/{ThemeProvider-DvMl17Ny.d.ts → ThemeProvider-CElaL2ik.d.ts}

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { CSSProperties, ReactNode } from 'react';
-import { $ as Theme, a1 as ThemeOverride } from './hex-board-view-UCUjMALd.js';
+import { ag as Theme, ai as ThemeOverride } from './hex-board-view-aKkblDp6.js';
 
 /**
  * The set of preset theme ids ships in `@dreamboard-games/sdk/ui`. Authors

package/dist/{attributes-BrZtP9az.d.ts → attributes-DbvyMbXw.d.ts}

@@ -1,4 +1,4 @@
-import { q as BrowserInteractionIntent, i as BrowserInteractionCandidateState, h as BrowserInteractionActuatorKind, G as BrowserInteractionSurfaceEffect, k as BrowserInteractionEffectPattern, s as BrowserInteractionPreparationTarget, v as BrowserInteractionReadiness, R as GameplayBrowserInteractionIntent, T as GameplaySemanticEffect, U as GameplaySemanticEffectPattern } from './types-BqzHkNMA.js';
+import { q as BrowserInteractionIntent, i as BrowserInteractionCandidateState, h as BrowserInteractionActuatorKind, K as BrowserInteractionSurfaceEffect, k as BrowserInteractionEffectPattern, w as BrowserInteractionPreparationTarget, z as BrowserInteractionReadiness, V as GameplayBrowserInteractionIntent, X as GameplaySemanticEffect, Y as GameplaySemanticEffectPattern } from './types-DJj5MJkl.js';
 
 type BrowserInteractionAttributeMap = Record<string, string | boolean>;
 interface BrowserInteractionRootAttributesInput {
@@ -29,8 +29,19 @@ interface BrowserInteractionActuatorAttributesInput {
     readonly preparationPatterns?: readonly BrowserInteractionEffectPattern[];
     readonly prepares?: BrowserInteractionPreparationTarget;
 }
+interface BrowserInteractionPointerTargetAttributesInput {
+    readonly surface: string;
+    readonly scopeId: string;
+    readonly interactionKey: string;
+    readonly interactionId: string;
+    readonly descriptorDigest?: string;
+    readonly targetId: string;
+    readonly enabled?: boolean;
+    readonly acceptedEffectPatterns: readonly BrowserInteractionEffectPattern[];
+}
 declare function createBrowserInteractionRootAttributes(input: BrowserInteractionRootAttributesInput): BrowserInteractionAttributeMap;
 declare function createBrowserInteractionActuatorAttributes(input: BrowserInteractionActuatorAttributesInput): BrowserInteractionAttributeMap;
+declare function createBrowserInteractionPointerTargetAttributes(input: BrowserInteractionPointerTargetAttributesInput): BrowserInteractionAttributeMap;
 type GameplayInteractionRootAttributesInput = Omit<BrowserInteractionRootAttributesInput, "surface">;
 type GameplayActuatorAttributesInput = Omit<BrowserInteractionActuatorAttributesInput, "surface" | "intent" | "semanticEffects" | "acceptedEffectPatterns" | "preparationPatterns"> & {
     readonly intent: GameplayBrowserInteractionIntent;
@@ -38,8 +49,12 @@ type GameplayActuatorAttributesInput = Omit<BrowserInteractionActuatorAttributes
     readonly acceptedEffectPatterns?: readonly GameplaySemanticEffectPattern[];
     readonly preparationPatterns?: readonly GameplaySemanticEffectPattern[];
 };
+type GameplayPointerTargetAttributesInput = Omit<BrowserInteractionPointerTargetAttributesInput, "surface" | "acceptedEffectPatterns"> & {
+    readonly acceptedEffectPatterns: readonly GameplaySemanticEffectPattern[];
+};
 declare function createGameplayInteractionRootAttributes(input: GameplayInteractionRootAttributesInput): BrowserInteractionAttributeMap;
 declare function createGameplayActuatorAttributes(input: GameplayActuatorAttributesInput): BrowserInteractionAttributeMap;
+declare function createGameplayPointerTargetAttributes(input: GameplayPointerTargetAttributesInput): BrowserInteractionAttributeMap;
 declare function createBrowserInteractionActuatorKey(input: {
     readonly surface: string;
     readonly scopeId: string;
@@ -50,4 +65,4 @@ declare function createBrowserInteractionActuatorKey(input: {
     readonly actuatorKind: BrowserInteractionActuatorKind;
 }): string;
 
-export { type BrowserInteractionActuatorAttributesInput as B, type GameplayActuatorAttributesInput as G, type BrowserInteractionAttributeMap as a, type BrowserInteractionRootAttributesInput as b, type GameplayInteractionRootAttributesInput as c, createBrowserInteractionActuatorAttributes as d, createBrowserInteractionActuatorKey as e, createBrowserInteractionRootAttributes as f, createGameplayActuatorAttributes as g, createGameplayInteractionRootAttributes as h };
+export { type BrowserInteractionActuatorAttributesInput as B, type GameplayActuatorAttributesInput as G, type BrowserInteractionAttributeMap as a, type BrowserInteractionPointerTargetAttributesInput as b, type BrowserInteractionRootAttributesInput as c, type GameplayInteractionRootAttributesInput as d, type GameplayPointerTargetAttributesInput as e, createBrowserInteractionActuatorAttributes as f, createBrowserInteractionActuatorKey as g, createBrowserInteractionPointerTargetAttributes as h, createBrowserInteractionRootAttributes as i, createGameplayActuatorAttributes as j, createGameplayInteractionRootAttributes as k, createGameplayPointerTargetAttributes as l };

package/dist/authoring/index.d.ts

@@ -0,0 +1,62 @@
+import { JsonValue } from '../types.js';
+
+type GeneratedAuthoringMetadataV1 = {
+    sdkVersion: string;
+    codegenVersion: string;
+    manifestSchemaVersion: number;
+    generatedArtifactSchemaVersion: number;
+};
+type AuthoringValidationResultV1 = {
+    valid: boolean;
+    errors: readonly string[];
+    warnings: readonly string[];
+};
+type GeneratedArtifactV1 = {
+    path: string;
+    ownership: "authoritative" | "seed";
+    content: string;
+    contentSha256: string;
+};
+type GeneratedPathPatternV1 = {
+    prefix: string;
+    suffix: string;
+};
+type AuthoringManifestConformanceCaseV1 = {
+    id: string;
+    manifest: JsonValue;
+    expected: {
+        valid: true;
+        transportValid: true;
+        materializedSha256: string;
+    } | {
+        valid: false;
+        transportValid: boolean;
+        diagnosticCodes: readonly string[];
+    };
+};
+type ProjectAuthoringAdapterV1 = {
+    protocolVersion: 1;
+    metadata: GeneratedAuthoringMetadataV1;
+    generatedPaths: readonly string[];
+    generatedPathPatterns: readonly GeneratedPathPatternV1[];
+    manifestConformanceCases: readonly AuthoringManifestConformanceCaseV1[];
+    validateManifest(manifest: unknown): AuthoringValidationResultV1;
+    materializeManifest(manifest: unknown): JsonValue;
+    generateWorkspaceArtifacts(manifest: unknown): readonly GeneratedArtifactV1[];
+};
+
+declare function diagnosticCodesForValidationErrors(errors: readonly string[]): readonly string[];
+
+declare function validateManifest(manifest: unknown): AuthoringValidationResultV1;
+declare function materializeManifest(manifest: unknown): JsonValue;
+declare function generateWorkspaceArtifacts(manifest: unknown): readonly GeneratedArtifactV1[];
+declare const GENERATED_WORKSPACE_PATHS: readonly string[];
+type GeneratedWorkspacePathPattern = {
+    readonly prefix: string;
+    readonly suffix: string;
+};
+declare const GENERATED_WORKSPACE_PATH_PATTERNS: readonly GeneratedWorkspacePathPattern[];
+declare const MANIFEST_CONFORMANCE_CASES: readonly AuthoringManifestConformanceCaseV1[];
+declare const projectAuthoringAdapter: ProjectAuthoringAdapterV1;
+
+export { type AuthoringManifestConformanceCaseV1, type AuthoringValidationResultV1, GENERATED_WORKSPACE_PATHS, GENERATED_WORKSPACE_PATH_PATTERNS, type GeneratedArtifactV1, type GeneratedAuthoringMetadataV1, type GeneratedPathPatternV1, MANIFEST_CONFORMANCE_CASES, type ProjectAuthoringAdapterV1, diagnosticCodesForValidationErrors, generateWorkspaceArtifacts, materializeManifest, projectAuthoringAdapter, validateManifest };

package/dist/authoring/index.js

@@ -0,0 +1,24 @@
+import {
+  GENERATED_WORKSPACE_PATHS,
+  GENERATED_WORKSPACE_PATH_PATTERNS,
+  MANIFEST_CONFORMANCE_CASES,
+  diagnosticCodesForValidationErrors,
+  generateWorkspaceArtifacts,
+  materializeManifest,
+  projectAuthoringAdapter,
+  validateManifest
+} from "../chunk-PJXXQ7IE.js";
+import "../chunk-X7GPD5TR.js";
+import "../chunk-SACZWUA6.js";
+import "../chunk-PZ5AY32C.js";
+export {
+  GENERATED_WORKSPACE_PATHS,
+  GENERATED_WORKSPACE_PATH_PATTERNS,
+  MANIFEST_CONFORMANCE_CASES,
+  diagnosticCodesForValidationErrors,
+  generateWorkspaceArtifacts,
+  materializeManifest,
+  projectAuthoringAdapter,
+  validateManifest
+};
+//# sourceMappingURL=index.js.map

package/dist/authoring/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/authoring-compiler.d.ts

@@ -0,0 +1,27 @@
+type MaterializeWorkspaceOptions = {
+    readonly manifestPath: string;
+    readonly projectRoot?: string;
+    /** Scaffolding-only. Existing build/test paths leave seed files untouched. */
+    readonly writeMissingSeeds?: boolean;
+};
+type MaterializedWorkspaceReceipt = {
+    readonly schemaVersion: 1;
+    readonly projectRoot: string;
+    readonly authoritativeFiles: number;
+    readonly seededFiles: number;
+    readonly artifacts: readonly {
+        readonly path: string;
+        readonly ownership: "authoritative";
+        readonly sha256: `sha256:${string}`;
+    }[];
+    readonly digest: `sha256:${string}`;
+};
+/**
+ * Materialize SDK-owned workspace contracts from authored manifest source.
+ * Authoritative files are always replaced. Seed files are untouched unless a
+ * scaffolding caller explicitly opts in. No test state or projection artifact
+ * is emitted.
+ */
+declare function materializeWorkspace(options: MaterializeWorkspaceOptions): Promise<MaterializedWorkspaceReceipt>;
+
+export { type MaterializeWorkspaceOptions, type MaterializedWorkspaceReceipt, materializeWorkspace };

package/dist/authoring-compiler.js

@@ -0,0 +1,12 @@
+import {
+  materializeWorkspace
+} from "./chunk-26IRD573.js";
+import "./chunk-PJXXQ7IE.js";
+import "./chunk-UNVCT5Z7.js";
+import "./chunk-X7GPD5TR.js";
+import "./chunk-SACZWUA6.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  materializeWorkspace
+};
+//# sourceMappingURL=authoring-compiler.js.map

package/dist/authoring-compiler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/authoring-materialize-cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/authoring-materialize-cli.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+import {
+  materializeWorkspace
+} from "./chunk-26IRD573.js";
+import "./chunk-PJXXQ7IE.js";
+import "./chunk-UNVCT5Z7.js";
+import "./chunk-X7GPD5TR.js";
+import "./chunk-SACZWUA6.js";
+import "./chunk-PZ5AY32C.js";
+
+// src/authoring-materialize-cli.ts
+var options = parseArgs(process.argv.slice(2));
+var receipt = await materializeWorkspace(options);
+console.log(JSON.stringify(receipt, null, 2));
+function parseArgs(argv) {
+  let manifestPath;
+  let projectRoot;
+  let writeMissingSeeds = false;
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === "--manifest") {
+      manifestPath = argv[index + 1];
+      index += 1;
+      continue;
+    }
+    if (arg === "--project-root") {
+      projectRoot = argv[index + 1];
+      index += 1;
+      continue;
+    }
+    if (arg === "--write-missing-seeds") {
+      writeMissingSeeds = true;
+      continue;
+    }
+    throw new Error(`Unknown argument '${arg}'.`);
+  }
+  if (!manifestPath) {
+    throw new Error("--manifest is required.");
+  }
+  return {
+    manifestPath,
+    ...projectRoot === void 0 ? {} : { projectRoot },
+    ...writeMissingSeeds ? { writeMissingSeeds: true } : {}
+  };
+}
+//# sourceMappingURL=authoring-materialize-cli.js.map

package/dist/authoring-materialize-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/authoring-materialize-cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { materializeWorkspace } from \"./authoring/materialize-workspace.js\";\n\nconst options = parseArgs(process.argv.slice(2));\nconst receipt = await materializeWorkspace(options);\nconsole.log(JSON.stringify(receipt, null, 2));\n\nfunction parseArgs(argv: readonly string[]): {\n  readonly manifestPath: string;\n  readonly projectRoot?: string;\n  readonly writeMissingSeeds?: boolean;\n} {\n  let manifestPath: string | undefined;\n  let projectRoot: string | undefined;\n  let writeMissingSeeds = false;\n  for (let index = 0; index < argv.length; index += 1) {\n    const arg = argv[index];\n    if (arg === \"--manifest\") {\n      manifestPath = argv[index + 1];\n      index += 1;\n      continue;\n    }\n    if (arg === \"--project-root\") {\n      projectRoot = argv[index + 1];\n      index += 1;\n      continue;\n    }\n    if (arg === \"--write-missing-seeds\") {\n      writeMissingSeeds = true;\n      continue;\n    }\n    throw new Error(`Unknown argument '${arg}'.`);\n  }\n  if (!manifestPath) {\n    throw new Error(\"--manifest is required.\");\n  }\n  return {\n    manifestPath,\n    ...(projectRoot === undefined ? {} : { projectRoot }),\n    ...(writeMissingSeeds ? { writeMissingSeeds: true } : {}),\n  };\n}\n"],"mappings":";;;;;;;;;;;AAGA,IAAM,UAAU,UAAU,QAAQ,KAAK,MAAM,CAAC,CAAC;AAC/C,IAAM,UAAU,MAAM,qBAAqB,OAAO;AAClD,QAAQ,IAAI,KAAK,UAAU,SAAS,MAAM,CAAC,CAAC;AAE5C,SAAS,UAAU,MAIjB;AACA,MAAI;AACJ,MAAI;AACJ,MAAI,oBAAoB;AACxB,WAAS,QAAQ,GAAG,QAAQ,KAAK,QAAQ,SAAS,GAAG;AACnD,UAAM,MAAM,KAAK,KAAK;AACtB,QAAI,QAAQ,cAAc;AACxB,qBAAe,KAAK,QAAQ,CAAC;AAC7B,eAAS;AACT;AAAA,IACF;AACA,QAAI,QAAQ,kBAAkB;AAC5B,oBAAc,KAAK,QAAQ,CAAC;AAC5B,eAAS;AACT;AAAA,IACF;AACA,QAAI,QAAQ,yBAAyB;AACnC,0BAAoB;AACpB;AAAA,IACF;AACA,UAAM,IAAI,MAAM,qBAAqB,GAAG,IAAI;AAAA,EAC9C;AACA,MAAI,CAAC,cAAc;AACjB,UAAM,IAAI,MAAM,yBAAyB;AAAA,EAC3C;AACA,SAAO;AAAA,IACL;AAAA,IACA,GAAI,gBAAgB,SAAY,CAAC,IAAI,EAAE,YAAY;AAAA,IACnD,GAAI,oBAAoB,EAAE,mBAAmB,KAAK,IAAI,CAAC;AAAA,EACzD;AACF;","names":[]}