@pie-players/pie-tool-sign-language 0.3.75 → 1.0.0-beta.0

package/README.md

@@ -7,9 +7,8 @@ This package is also the worked example of a capability contributed entirely fro
 outside the player. It is authored against
 `@pie-players/pie-assessment-toolkit/tools/registration` — the same entry point the
 packaged registrations use — and `@pie-players/pie-section-player` reaches it only
-through `ToolRegistry.getToolsBySurface("content-media")`. No package in the player
-names signing, the `signLanguage` support id, the `sign-language` catalog type or
-this package.
+through `ToolRegistry.getToolsBySurface("content-media")`. No package renders the
+`sign-language` catalog type except this tool.
 
 ## Opting in
 
@@ -56,7 +55,7 @@ for every learner when the markup could not be parsed.
 ASL, BSL and LSF are not interchangeable. Handing an ASL learner a BSL recording
 is worse than handing them nothing. `resolveSignLanguageAlternate` scans the
 owner snapshot for an exact requested-language match first, then permits an
-unlabelled card as the only fallback. A card labelled with another sign language
+unlabeled card as the only fallback. A card labeled with another sign language
 is never substituted.
 
 ## The element
@@ -75,11 +74,14 @@ for hands and face. Host overrides:
 | `--pie-section-player-item-media-min-height` | `220px` |
 | `--pie-section-player-item-media-max-height` | `60vh` |
 
+All three are registered `component-public` tokens.
+
 The region's share of the card width, the drag-to-resize handle and the stacking
 breakpoint belong to the host: that is the card's layout, not the capability's.
 
 ## Related
 
-- [`docs/prds/sign-language-asl-support.md`](../../docs/prds/sign-language-asl-support.md)
-- [`docs/TOOL_REGISTRY.md`](../assessment-toolkit/docs/TOOL_REGISTRY.md) — host
+- [Tool registry](../assessment-toolkit/docs/TOOL_REGISTRY.md): host
   surfaces and content dependencies
+- [Sign language support](../../docs/prds/sign-language-asl-support.md): the
+  design record

package/custom-elements.json

@@ -0,0 +1,65 @@
+{
+	"schemaVersion": "2.1.0",
+	"modules": [
+		{
+			"kind": "javascript-module",
+			"path": "dist/tool-sign-language.js",
+			"declarations": [
+				{
+					"kind": "class",
+					"description": "Signed translation of one item or passage, shown in the host's content-media surface. The sign-language registration's `renderSurface` mounts it and sets `media` to a resolved catalog card; it plays that recording muted with native controls, held to the card's authored time slice, under a caption naming the sign language. Its playback and read-aloud through the toolkit runtime context's TTS service pause each other.",
+					"name": "SignLanguageMediaRegion",
+					"tagName": "pie-tool-sign-language",
+					"customElement": true,
+					"members": [
+						{
+							"kind": "field",
+							"name": "media",
+							"type": {
+								"text": "ResolvedSignLanguageAlternate | null"
+							},
+							"default": "null",
+							"attribute": "media"
+						}
+					],
+					"attributes": [
+						{
+							"name": "media",
+							"type": {
+								"text": "ResolvedSignLanguageAlternate | null"
+							},
+							"default": "null",
+							"fieldName": "media"
+						}
+					],
+					"cssProperties": [
+						{
+							"name": "--pie-section-player-item-media-aspect-ratio",
+							"description": "Public sizing hook for the item card media region; defaults to 3 / 4 because signed content needs height for hands and face. Geometry-only, but hosts must keep signing legible when overriding."
+						},
+						{
+							"name": "--pie-section-player-item-media-max-height",
+							"description": "Public ceiling for the item card media region; defaults to 60vh so a tall recording cannot push question content off screen. Geometry-only."
+						},
+						{
+							"name": "--pie-section-player-item-media-min-height",
+							"description": "Public legibility floor for the item card media region; defaults to 220px so a narrow content column cannot crush signed content. Geometry-only."
+						}
+					],
+					"x-pie": {
+						"shadow": "open"
+					}
+				}
+			],
+			"exports": [
+				{
+					"kind": "custom-element-definition",
+					"name": "pie-tool-sign-language",
+					"declaration": {
+						"name": "SignLanguageMediaRegion"
+					}
+				}
+			]
+		}
+	]
+}

package/dist/src/sign-language-content.d.ts

@@ -25,7 +25,7 @@ export declare function resolveSignLanguageAlternate(args: SignLanguageLookupArg
 /**
  * Which sign language the learner is entitled to.
  *
- * Read from the feature's policy parameters (`toolParameters` / `toolConfigs`),
+ * Read from the feature's policy parameters (`toolParameters`),
  * never inferred from the item's content language — a Spanish item's signed
  * alternate is LSM, not ASL.
  */