@tur-ng/std 0.0.1 → 0.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tur-ng/std",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "type": "module",
   "types": "src/index.d.ts",
   "files": [

package/src/index.d.ts

@@ -284,7 +284,27 @@ declare module "tur:std" {
         /** When `true`, the text can be drag-selected with the pointer. */
         selectable?: boolean;
         queryKey?: Val<string[]>;
-    }
+        /**
+         * Maximum number of lines to render. Ignored when `overflow` is
+         * `"visible"`. When omitted (or `0`), the text wraps without limit.
+         */
+        maxLines?: Val<number>;
+        /**
+         * How content beyond `maxLines` is handled. Defaults to `"clip"`
+         * when `maxLines` is set.
+         * - `"clip"`     — render at most `maxLines` lines, discard the rest.
+         * - `"ellipsis"` — render at most `maxLines` lines, appending `…`
+         *                  to the last visible line (trimmed to fit).
+         * - `"visible"`  — render all lines; `maxLines` is ignored.
+         */
+        overflow?: Val<TextOverflow>;
+    }
+
+    /**
+     * How `Text` handles content beyond `maxLines`. Mirrors Flutter's
+     * `TextOverflow`.
+     */
+    export type TextOverflow = "clip" | "ellipsis" | "visible";
 
     export interface PointerInteractProps {
         onClick?: Mutation<[PointerInteractEvent]>;
@@ -412,6 +432,11 @@ declare module "tur:std" {
         width?: Val<number>;
         height?: Val<number>;
         multiline?: Val<boolean>;
+        /** When true, each character is rendered as `obscuringCharacter`
+         *  (password mode). The controller's `text` keeps the real value. */
+        obscureText?: Val<boolean>;
+        /** Mask glyph used when `obscureText` is on (default `"•"`). */
+        obscuringCharacter?: Val<string>;
         onContextMenu?: Mutation<[PointerInteractEvent]>;
         queryKey?: Val<string[]>;
     }
@@ -614,6 +639,95 @@ declare module "tur:std" {
     export function lifecycleView(f: () => LifecycleDescriptor): Element;
     export function ReadableSubscribe(props: ReadableSubscribeProps): Element;
 
+    // ---------------------------------------------------------------------------
+    // Visual-effect elements (Opacity / Transform)
+    // ---------------------------------------------------------------------------
+
+    export interface OpacityProps {
+        value: Val<number>;
+        child?: Element;
+        queryKey?: Val<string[]>;
+    }
+
+    export interface TransformProps {
+        scale?: Val<number>;
+        scaleX?: Val<number>;
+        scaleY?: Val<number>;
+        rotate?: Val<number>;
+        translateX?: Val<number>;
+        translateY?: Val<number>;
+        /** Pivot for `rotate`/`scale`, within the child box. Defaults to
+         *  `Alignment.Center` (matches Flutter's `Transform`). */
+        alignment?: Val<Alignment>;
+        child?: Element;
+        queryKey?: Val<string[]>;
+    }
+
+    /** Alpha-mask its child subtree by `value` (0.0..=1.0). */
+    export function Opacity(props: OpacityProps): Element;
+
+    /** Apply a 2D affine rotate/scale/translate to its child subtree. */
+    export function Transform(props: TransformProps): Element;
+
+    // ---------------------------------------------------------------------------
+    // CompositedTransformTarget / Follower — Flutter-style anchor linking.
+    // A follower renders at a target's global position (tracked continuously
+    // through layout / scroll / reactive / transform changes). Create a shared
+    // link via `createLayerLink()` and pass it to one target + one follower.
+    // Place the follower in a root overlay slot so it isn't clipped and paints
+    // on top (the Flutter `Overlay` pattern).
+    // ---------------------------------------------------------------------------
+
+    /** Shared handle connecting one `CompositedTransformTarget` to one
+     *  `CompositedTransformFollower`. Create via `createLayerLink()`. */
+    export interface LayerLink {
+        readonly _layerLinkBrand: unique symbol;
+    }
+
+    /** Create a shared `LayerLink` connecting a target and a follower. */
+    export function createLayerLink(): LayerLink;
+
+    export interface CompositedTransformTargetProps {
+        /** A link created via `createLayerLink()`, shared with the follower. */
+        link: LayerLink;
+        child?: Element;
+        queryKey?: Val<string[]>;
+    }
+
+    export interface CompositedTransformFollowerProps {
+        /** A link created via `createLayerLink()`, shared with the target. */
+        link: LayerLink;
+        /** Anchor point on the target that the follower aligns to. The
+         *  follower is translated so its `followerAnchor` lands here in global
+         *  space. Defaults to `Alignment.TopLeft`. Reactive: pass a `derive`
+         *  to change it at runtime. */
+        targetAnchor?: Val<Alignment>;
+        /** Anchor point on this follower that lines up with `targetAnchor`.
+         *  Defaults to `Alignment.TopLeft`. Reactive. */
+        followerAnchor?: Val<Alignment>;
+        /** Additional offset (in the target's local coordinate space) applied
+         *  to `targetAnchor`. Defaults to `{x: 0, y: 0}`. Reactive: pass a
+         *  `derive` to change it at runtime (e.g. steppers). */
+        targetOffset?: Val<{ x: number; y: number }>;
+        /** Whether to keep rendering at the follower's layout position when no
+         *  target is linked. Defaults to `true`. */
+        showWhenUnlinked?: boolean;
+        child?: Element;
+        queryKey?: Val<string[]>;
+    }
+
+    /** Marks a spot in the tree for a `CompositedTransformFollower` to track.
+     *  A transparent passthrough. */
+    export function CompositedTransformTarget(
+        props: CompositedTransformTargetProps,
+    ): Element;
+
+    /** Renders at a target's anchor (tracked continuously). Place in a root
+     *  overlay slot. */
+    export function CompositedTransformFollower(
+        props: CompositedTransformFollowerProps,
+    ): Element;
+
     // ---------------------------------------------------------------------------
     // Controllers / resources / colors / focus
     // ---------------------------------------------------------------------------