@symbiote-native/linear-gradient 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 A. Prokopenko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,197 @@
-# Temporary Holding Version
+# @symbiote-native/linear-gradient
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[`expo-linear-gradient`](https://docs.expo.dev/versions/latest/sdk/linear-gradient/) for **every**
+[SymbioteNative](../../README.md) adapter: React, Vue, Svelte, Solid and Angular. A native view that
+paints a multi-color gradient behind its children.
+
+Built the same way as [`@symbiote-native/clipboard`](../clipboard)'s `ClipboardPasteButton`, an
+`expo-modules-core` native view reached through `requireNativeViewManager` (see the
+`symbiote-expo-native-module` project skill: why `expo-modules-core` is depended on directly and never
+the `expo` meta-package, why the upstream JS is hand-ported into `core/`, and how autolinking finds the
+native module). One render function in `core/` returns a descriptor and every adapter only turns it into
+its own element.
+
+## Install
+
+**New app:**
+
+```bash
+npx @symbiote-native/cli new my-app --linear-gradient
+```
+
+**Existing SymbioteNative app:**
+
+```bash
+npx @symbiote-native/cli add --linear-gradient
+```
+
+Either way: installs `@symbiote-native/linear-gradient` and wires the native autolinking automatically,
+see [`@symbiote-native/cli`](../cli).
+
+<details>
+<summary>Manual install (no CLI - installing and wiring native autolinking by hand)</summary>
+
+```bash
+npm install @symbiote-native/linear-gradient
+```
+
+Depends on `expo-linear-gradient` and `expo-modules-core` directly (regular dependencies, pinned to exact
+versions, since this package's `core/` is hand-ported against one specific native API shape).
+Never install `expo-linear-gradient` yourself, and never add the `expo` package to this project: it bundles
+its own Metro/Babel pipeline that conflicts with this project's own.
+
+### Required one-time step: native autolinking wiring
+
+`expo-linear-gradient`'s native code is discovered by `expo-modules-autolinking`, not by RN's own
+`react-native.config.cjs` mechanism. Wire it into the native host app **once**, it covers this package
+and every other `expo-modules-core` package with zero further changes. The steps and the
+mechanics behind them are in the `symbiote-expo-native-module` skill and in
+[`@symbiote-native/network`](../network)'s README; the reference app is `examples/expo-react`.
+
+</details>
+
+## Shape
+
+```
+src/core/                linear-gradient.ts - props, point normalization, the locations check and
+                         renderLinearGradient (iOS: the native view is the root, Android: a View that
+                         carries style and children over an absolute-fill native leaf).
+src/react/               @symbiote-native/linear-gradient/react   - LinearGradient
+src/vue/                 @symbiote-native/linear-gradient/vue     - LinearGradient
+src/svelte/              @symbiote-native/linear-gradient/svelte  - LinearGradient (.svelte)
+src/solid/               @symbiote-native/linear-gradient/solid   - LinearGradient
+src/angular/linear-gradient/  @symbiote-native/linear-gradient/angular - LinearGradient
+```
+
+Angular cannot spell a dynamic tag name or project into a descriptor-built node, so it keeps one
+component per platform (`index.ios.ts` / `index.android.ts`) with the same inputs.
+
+## Use it
+
+### React
+
+```tsx
+import { LinearGradient } from '@symbiote-native/linear-gradient/react';
+
+<LinearGradient colors={['#4c669f', '#192f6a']} start={{ x: 0, y: 0 }} end={[1, 1]}>
+  <Text>Over the gradient</Text>
+</LinearGradient>;
+```
+
+### Vue
+
+```vue
+<script setup lang="ts">
+import { LinearGradient } from '@symbiote-native/linear-gradient/vue';
+</script>
+
+<template>
+  <LinearGradient :colors="['#4c669f', '#192f6a']" :end="[1, 1]">
+    <text>Over the gradient</text>
+  </LinearGradient>
+</template>
+```
+
+### Angular
+
+```ts
+import { LinearGradient } from '@symbiote-native/linear-gradient/angular';
+
+@Component({
+  imports: [LinearGradient],
+  template: `<LinearGradient [colors]="colors" [end]="[1, 1]"><text>Over the gradient</text></LinearGradient>`,
+})
+export class Card {
+  readonly colors = ['#4c669f', '#192f6a'];
+}
+```
+
+### Svelte
+
+```svelte
+<script lang="ts">
+  import { LinearGradient } from '@symbiote-native/linear-gradient/svelte';
+</script>
+
+<LinearGradient colors={['#4c669f', '#192f6a']} end={[1, 1]}>
+  <text>Over the gradient</text>
+</LinearGradient>
+```
+
+### Solid
+
+```tsx
+import { LinearGradient } from '@symbiote-native/linear-gradient/solid';
+
+<LinearGradient colors={['#4c669f', '#192f6a']} end={[1, 1]}>
+  <text>Over the gradient</text>
+</LinearGradient>;
+```
+
+## API
+
+```ts
+<LinearGradient
+  colors={[ColorValue, ColorValue, ...ColorValue[]]}  // two or more, one color is style.backgroundColor
+  locations?={number[]}                                // 0..1 ascending, same length as colors
+  start?={{ x, y } | [x, y]}                           // default { x: 0.5, y: 0 }
+  end?={{ x, y } | [x, y]}                             // default { x: 0.5, y: 1 }
+  dither?={boolean}                                    // Android only, default true
+  style? testID? nativeID? onLayout? ...View accessibility and responder props
+/>
+```
+
+Plus `ILinearGradientProps` and `ILinearGradientPoint`, hand-ported from upstream's `LinearGradient.tsx`.
+Children come through the framework's own mechanism (`children`, default slot, snippet,
+`<ng-content>`).
+
+## Notes
+
+- **Children go inside the gradient.** It paints behind them. On iOS the native gradient is the root
+  view. On Android the root is a plain `View` that carries your `style`, with the native gradient
+  filling it as a child, so `children`, `onLayout` and touches behave as on any `View`.
+- **Rounded corners go in `style`.** `borderRadius` and the four per-corner radii are read from
+  `style` and handed to the native gradient, because React Native does not clip a native view by a
+  radius on its own.
+- **A bad value warns instead of throwing.** A `start` or `end` that is not `[x, y]` or `{ x, y }` is
+  ignored, and a `locations` array of the wrong length is cut to the number of `colors`. Both log a
+  warning and the gradient still draws.
+- **`colors` takes anything `style` colors take.** Names, hex, `rgb()`/`rgba()` and `hsl()` all go
+  through the same color processing as every other view.
+- **Where the native view is missing, you get a plain `View`.** The package logs
+  `LinearGradient is not available on this platform` and renders your children without a gradient.
+- **Not ported.** The web variant (`LinearGradient.web.tsx`) and `NativeLinearGradient` re-export: native only.
+
+## Common questions
+
+- **`transparent` to a color looks gray on iOS.** Apple platforms fade `transparent` as transparent
+  black. Fade to the same color with alpha 0 instead: `['rgba(255, 255, 255, 0)', '#ffffff']`.
+- **Different on iOS and Android.** Do not give `start` and `end` the same point, that case is
+  reported to render differently. Use distinct points, such as `[0, 0]` and `[1, 1]`.
+- **Rounded corners.** Put `borderRadius` (or the four per-corner radii) in `style`. Android passes
+  the radii to the native gradient by hand.
+- **Gradient text.** Needs `@react-native-masked-view/masked-view`, a third-party React component,
+  so React adapter only. No masked view ships for Vue, Svelte, Solid or Angular.
+- **Animating colors.** `colors` is a plain prop, so drive it from state, a signal or a rune. For a
+  smooth fade, stack two gradients and animate the `opacity` of the top one.
+- **Slow in a long list.** Draw one gradient behind the list instead of one per row, and try
+  `dither={false}` on Android.
+- **One color.** `colors` needs two entries, use `style.backgroundColor` for one.
+
+Sources: [Expo docs: LinearGradient](https://docs.expo.dev/versions/latest/sdk/linear-gradient/),
+[expo/expo#7418](https://github.com/expo/expo/issues/7418),
+[expo/expo#25595](https://github.com/expo/expo/issues/25595),
+[expo/expo#32934](https://github.com/expo/expo/issues/32934),
+[expo/expo#29408](https://github.com/expo/expo/issues/29408),
+[expo/expo#23861](https://github.com/expo/expo/issues/23861).
+
+## Test it
+
+No device is needed for the logic. The core tests (`src/core/*.test.ts`) replace `expo-modules-core`
+(`requireNativeViewManager`, `Platform`) and assert the descriptor a render function returns. The
+adapter tests (`src/{react,vue,solid,angular}/**/*.test.*`, `vitest`) render the real component over the
+recording Fabric with an injected view config and assert the committed payload, and Svelte's
+`*.smoke.test.ts` compile the `.svelte` files and mount them. Painting itself is verified on a device in
+the six `examples/expo-*` canary apps (`examples/expo-react`, `examples/expo-vue-sfc`,
+`examples/expo-vue-tsx`, `examples/expo-svelte`, `examples/expo-solid`, `examples/expo-angular`), see the
+parent [README](../../README.md).

package/build/angular/index.d.ts

@@ -0,0 +1,2 @@
+export { LinearGradient } from './linear-gradient';
+export { LINEAR_GRADIENT_MODULE_NAME, linearGradientViewName, type ILinearGradientProps, type ILinearGradientPoint, type INativeLinearGradientPoint, } from '../core';

package/build/angular/index.js

@@ -0,0 +1,3 @@
+// @symbiote-native/linear-gradient/angular: компонент `LinearGradient` поверх общего ядра
+export { LinearGradient } from './linear-gradient';
+export { LINEAR_GRADIENT_MODULE_NAME, linearGradientViewName, } from '../core/index.js';

package/build/angular/linear-gradient/index.android.d.ts

@@ -0,0 +1,4 @@
+import { LinearGradientBase } from './shared';
+/** Angular twin of `expo-linear-gradient`'s `LinearGradient`, a View wraps the gradient leaf */
+export declare class LinearGradient extends LinearGradientBase {
+}

package/build/angular/linear-gradient/index.android.js

@@ -0,0 +1,67 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+import { ChangeDetectionStrategy, Component } from '@angular/core';
+import { DescriptorHost } from '@symbiote-native/angular';
+import { LinearGradientBase } from './shared.js';
+/** Angular twin of `expo-linear-gradient`'s `LinearGradient`, a View wraps the gradient leaf */
+let LinearGradient = (() => {
+    let _classDecorators = [Component({
+            selector: 'LinearGradient',
+            standalone: true,
+            imports: [DescriptorHost],
+            changeDetection: ChangeDetectionStrategy.OnPush,
+            template: `@if (descriptor; as node) {
+    <symbiote-descriptor-host [node]="node"
+      ><ng-content
+    /></symbiote-descriptor-host>
+  }`,
+        })];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = LinearGradientBase;
+    var LinearGradient = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            LinearGradient = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+    };
+    return LinearGradient = _classThis;
+})();
+export { LinearGradient };

package/build/angular/linear-gradient/index.d.ts

@@ -0,0 +1 @@
+export { LinearGradient } from './index.ios';

package/build/angular/linear-gradient/index.ios.d.ts

@@ -0,0 +1,5 @@
+import { LinearGradientBase } from './shared';
+/** Angular twin of `expo-linear-gradient`'s `LinearGradient`, children go inside the native view */
+export declare class LinearGradient extends LinearGradientBase {
+    constructor();
+}

package/build/angular/linear-gradient/index.ios.js

@@ -0,0 +1,76 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+import { ChangeDetectionStrategy, Component, NO_ERRORS_SCHEMA, } from '@angular/core';
+import { SymbioteHostPropsDirective } from '@symbiote-native/angular';
+import { warnIfViewNameIsDynamic } from '@symbiote-native/engine';
+import { LINEAR_GRADIENT_MODULE_NAME } from '../../core/index.js';
+import { LinearGradientBase } from './shared.js';
+const TEMPLATE_TAG = 'ViewManagerAdapter_ExpoLinearGradient';
+/** Angular twin of `expo-linear-gradient`'s `LinearGradient`, children go inside the native view */
+let LinearGradient = (() => {
+    let _classDecorators = [Component({
+            selector: 'LinearGradient',
+            standalone: true,
+            imports: [SymbioteHostPropsDirective],
+            schemas: [NO_ERRORS_SCHEMA],
+            changeDetection: ChangeDetectionStrategy.OnPush,
+            // Имя тега это нативное имя view, его нельзя собрать динамически
+            template: `@if (descriptor; as node) {
+    <ViewManagerAdapter_ExpoLinearGradient [symbioteHostProps]="node.props">
+      <ng-content />
+    </ViewManagerAdapter_ExpoLinearGradient>
+  }`,
+        })];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = LinearGradientBase;
+    var LinearGradient = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            LinearGradient = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        constructor() {
+            super();
+            warnIfViewNameIsDynamic(TEMPLATE_TAG, LINEAR_GRADIENT_MODULE_NAME);
+        }
+    };
+    return LinearGradient = _classThis;
+})();
+export { LinearGradient };

package/build/angular/linear-gradient/index.js

@@ -0,0 +1,2 @@
+// Базовая точка для headless и tsc, Metro берёт `index.ios` или `index.android`
+export { LinearGradient } from './index.ios.js';

package/build/angular/linear-gradient/shared.d.ts

@@ -0,0 +1,12 @@
+import { NativeViewBase } from '@symbiote-native/angular';
+import type { IDescriptor } from '@symbiote-native/components';
+import type { ILinearGradientProps } from '../../core/linear-gradient';
+export declare abstract class LinearGradientBase extends NativeViewBase {
+    colors: ILinearGradientProps['colors'];
+    locations?: ILinearGradientProps['locations'];
+    start?: ILinearGradientProps['start'];
+    end?: ILinearGradientProps['end'];
+    dither?: ILinearGradientProps['dither'];
+    protected readonly propNames: readonly ["colors", "locations", "start", "end", "dither"];
+    protected renderView(props: object): IDescriptor;
+}

package/build/angular/linear-gradient/shared.js

@@ -0,0 +1,97 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+import { Directive, Input } from '@angular/core';
+import { NativeViewBase } from '@symbiote-native/angular';
+import { renderLinearGradient } from '../../core/linear-gradient.js';
+// Inputs и сборка дескриптора общие, платформы различаются только шаблоном
+let LinearGradientBase = (() => {
+    let _classDecorators = [Directive()];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = NativeViewBase;
+    let _colors_decorators;
+    let _colors_initializers = [];
+    let _colors_extraInitializers = [];
+    let _locations_decorators;
+    let _locations_initializers = [];
+    let _locations_extraInitializers = [];
+    let _start_decorators;
+    let _start_initializers = [];
+    let _start_extraInitializers = [];
+    let _end_decorators;
+    let _end_initializers = [];
+    let _end_extraInitializers = [];
+    let _dither_decorators;
+    let _dither_initializers = [];
+    let _dither_extraInitializers = [];
+    var LinearGradientBase = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _colors_decorators = [Input({ required: true })];
+            _locations_decorators = [Input()];
+            _start_decorators = [Input()];
+            _end_decorators = [Input()];
+            _dither_decorators = [Input()];
+            __esDecorate(null, null, _colors_decorators, { kind: "field", name: "colors", static: false, private: false, access: { has: obj => "colors" in obj, get: obj => obj.colors, set: (obj, value) => { obj.colors = value; } }, metadata: _metadata }, _colors_initializers, _colors_extraInitializers);
+            __esDecorate(null, null, _locations_decorators, { kind: "field", name: "locations", static: false, private: false, access: { has: obj => "locations" in obj, get: obj => obj.locations, set: (obj, value) => { obj.locations = value; } }, metadata: _metadata }, _locations_initializers, _locations_extraInitializers);
+            __esDecorate(null, null, _start_decorators, { kind: "field", name: "start", static: false, private: false, access: { has: obj => "start" in obj, get: obj => obj.start, set: (obj, value) => { obj.start = value; } }, metadata: _metadata }, _start_initializers, _start_extraInitializers);
+            __esDecorate(null, null, _end_decorators, { kind: "field", name: "end", static: false, private: false, access: { has: obj => "end" in obj, get: obj => obj.end, set: (obj, value) => { obj.end = value; } }, metadata: _metadata }, _end_initializers, _end_extraInitializers);
+            __esDecorate(null, null, _dither_decorators, { kind: "field", name: "dither", static: false, private: false, access: { has: obj => "dither" in obj, get: obj => obj.dither, set: (obj, value) => { obj.dither = value; } }, metadata: _metadata }, _dither_initializers, _dither_extraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            LinearGradientBase = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        colors = __runInitializers(this, _colors_initializers, void 0);
+        locations = (__runInitializers(this, _colors_extraInitializers), __runInitializers(this, _locations_initializers, void 0));
+        start = (__runInitializers(this, _locations_extraInitializers), __runInitializers(this, _start_initializers, void 0));
+        end = (__runInitializers(this, _start_extraInitializers), __runInitializers(this, _end_initializers, void 0));
+        dither = (__runInitializers(this, _end_extraInitializers), __runInitializers(this, _dither_initializers, void 0));
+        propNames = (__runInitializers(this, _dither_extraInitializers), [
+            'colors',
+            'locations',
+            'start',
+            'end',
+            'dither',
+        ]);
+        renderView(props) {
+            return renderLinearGradient(props);
+        }
+    };
+    return LinearGradientBase = _classThis;
+})();
+export { LinearGradientBase };

package/build/core/index.d.ts

@@ -0,0 +1 @@
+export { LINEAR_GRADIENT_MODULE_NAME, ensureLinearGradientRegistered, linearGradientViewName, normalizePoint, renderLinearGradient, type ILinearGradientPoint, type ILinearGradientProps, type INativeLinearGradientPoint, } from './linear-gradient';

package/build/core/index.js

@@ -0,0 +1 @@
+export { LINEAR_GRADIENT_MODULE_NAME, ensureLinearGradientRegistered, linearGradientViewName, normalizePoint, renderLinearGradient, } from './linear-gradient.js';

package/build/core/linear-gradient.d.ts

@@ -0,0 +1,33 @@
+import type { IAccessibilityProps, IAriaProps, IDescriptor, IResponderProps } from '@symbiote-native/components';
+import type { IColorValue, IStyleProp, ISymbioteEvent, IViewStyle } from '@symbiote-native/engine';
+export declare const LINEAR_GRADIENT_MODULE_NAME = "ExpoLinearGradient";
+export type INativeLinearGradientPoint = [x: number, y: number];
+/** Доли размера градиента от 0 до 1, объект `{ x, y }` или пара `[x, y]` */
+export type ILinearGradientPoint = {
+    x: number;
+    y: number;
+} | INativeLinearGradientPoint;
+export type ILinearGradientProps = IAccessibilityProps & IAriaProps & IResponderProps & {
+    /** Минимум два цвета, для одного используйте `style.backgroundColor` у View */
+    colors: readonly [IColorValue, IColorValue, ...IColorValue[]];
+    /** Позиции остановок от 0 до 1 по возрастанию, той же длины, что и `colors` */
+    locations?: readonly [number, number, ...number[]] | null;
+    /** @default { x: 0.5, y: 0.0 } */
+    start?: ILinearGradientPoint | null;
+    /** @default { x: 0.5, y: 1.0 } */
+    end?: ILinearGradientPoint | null;
+    /**
+     * Дизеринг убирает полосы в градиенте, false может ускорить отрисовку
+     * @default true
+     * @platform android
+     */
+    dither?: boolean;
+    style?: IStyleProp<IViewStyle>;
+    testID?: string;
+    nativeID?: string;
+    onLayout?: (event: ISymbioteEvent) => void;
+};
+export declare function linearGradientViewName(): string;
+export declare function ensureLinearGradientRegistered(): boolean;
+export declare function normalizePoint(point: unknown): INativeLinearGradientPoint | undefined;
+export declare function renderLinearGradient(props: object): IDescriptor;

package/build/core/linear-gradient.js

@@ -0,0 +1,105 @@
+// Ядро `LinearGradient`, порт `LinearGradient.tsx` из expo-linear-gradient
+import { Platform, requireNativeViewManager } from 'expo-modules-core';
+import { el } from '@symbiote-native/components';
+import { expoViewManagerName, flattenStyle, processColor, styleOfProps, tryRegisterNativeView, } from '@symbiote-native/engine';
+export const LINEAR_GRADIENT_MODULE_NAME = 'ExpoLinearGradient';
+// Эти ключи разбираются здесь, остальное уходит на хост как есть
+const GRADIENT_KEYS = new Set([
+    'colors',
+    'locations',
+    'start',
+    'end',
+    'dither',
+]);
+const ABSOLUTE_FILL = {
+    position: 'absolute',
+    left: 0,
+    right: 0,
+    top: 0,
+    bottom: 0,
+};
+export function linearGradientViewName() {
+    return expoViewManagerName(LINEAR_GRADIENT_MODULE_NAME);
+}
+// Регистрирует view config в реестре RN, из него движок берёт события и процессоры пропсов
+// Зовётся при рендере, а не при импорте: регистрация в побочном эффекте барреля теряется в release
+export function ensureLinearGradientRegistered() {
+    return tryRegisterNativeView(() => requireNativeViewManager(LINEAR_GRADIENT_MODULE_NAME));
+}
+function isNumber(value) {
+    return typeof value === 'number';
+}
+export function normalizePoint(point) {
+    if (!point)
+        return undefined;
+    if (Array.isArray(point)) {
+        const [x, y] = point;
+        if (point.length === 2 && isNumber(x) && isNumber(y))
+            return [x, y];
+        console.warn('start and end props for LinearGradient must be of the format [x,y] or {x, y}');
+        return undefined;
+    }
+    const x = Reflect.get(Object(point), 'x');
+    const y = Reflect.get(Object(point), 'y');
+    return isNumber(x) && isNumber(y) ? [x, y] : undefined;
+}
+function resolveLocations(colors, locations) {
+    if (!Array.isArray(locations))
+        return undefined;
+    if (locations.length === colors.length)
+        return locations;
+    console.warn('LinearGradient colors and locations props should be arrays of the same length');
+    return locations.slice(0, colors.length);
+}
+function radiusOr(value, fallback) {
+    return isNumber(value) ? value : fallback;
+}
+// Формат из `Path.addRoundRect`: по два значения на угол, начиная с верхнего левого
+function borderRadiiOf(style) {
+    const flat = flattenStyle(style) ?? {};
+    const base = radiusOr(flat.borderRadius, 0);
+    const topLeft = radiusOr(flat.borderTopLeftRadius, base);
+    const topRight = radiusOr(flat.borderTopRightRadius, base);
+    const bottomRight = radiusOr(flat.borderBottomRightRadius, base);
+    const bottomLeft = radiusOr(flat.borderBottomLeftRadius, base);
+    return [
+        topLeft,
+        topLeft,
+        topRight,
+        topRight,
+        bottomRight,
+        bottomRight,
+        bottomLeft,
+        bottomLeft,
+    ];
+}
+function withoutUndefined(props) {
+    return Object.fromEntries(Object.entries(props).filter(([, value]) => value !== undefined));
+}
+// `object`, а не тип пропсов: Vue и Angular отдают нетипизированный набор атрибутов
+export function renderLinearGradient(props) {
+    const hostProps = Object.fromEntries(Object.entries(props).filter(([key]) => !GRADIENT_KEYS.has(key)));
+    if (!ensureLinearGradientRegistered()) {
+        console.warn('LinearGradient is not available on this platform');
+        return el('view', hostProps);
+    }
+    const colors = Reflect.get(props, 'colors');
+    const colorList = Array.isArray(colors) ? colors : [];
+    const nativeProps = withoutUndefined({
+        colors: colorList.map(color => processColor(color)),
+        locations: resolveLocations(colorList, Reflect.get(props, 'locations')),
+        startPoint: normalizePoint(Reflect.get(props, 'start')),
+        endPoint: normalizePoint(Reflect.get(props, 'end')),
+    });
+    if (!Platform.select({ android: true, default: false })) {
+        return el(linearGradientViewName(), { ...hostProps, ...nativeProps });
+    }
+    // Нативный градиент заполняет View и сам скругляет углы, т.к. RN не обрезает по радиусу
+    const native = el(linearGradientViewName(), withoutUndefined({
+        ...nativeProps,
+        style: ABSOLUTE_FILL,
+        borderRadii: borderRadiiOf(styleOfProps(props)),
+        dither: Reflect.get(props, 'dither'),
+    }));
+    return el('view', hostProps, [native]);
+}