@rafaelaugusto/jolt 0.1.0-beta.8 → 0.1.0-rc.1

package/dist/scene-appearance.js

@@ -0,0 +1,68 @@
+/// <reference types="@nativescript/types-ios/lib/ios/objc-x86_64/objc!SceneKit" preserve="true" />
+import { Color } from '@nativescript/core';
+import { colorMixer, parseColor } from './color.js';
+import { registerNativeProperty } from './native-property.js';
+const clamp = (n) => Math.max(0, Math.min(1, n));
+function scalar(name, maximum, create) {
+    return registerNativeProperty({
+        name: `jolt.scenekit/${name}`,
+        units: [
+            name === 'light-intensity'
+                ? 'lumens (PBR); 1000 = unit multiplier otherwise'
+                : 'opacity fraction',
+        ],
+        platforms: ['ios'],
+        encode: (value) => [value],
+        decode: (values) => values[0],
+        validate(value) {
+            if (!Number.isFinite(value) || value < 0 || value > maximum)
+                throw new RangeError(`${name} needs a finite value in 0..${maximum}.`);
+        },
+        interpolate: (a, b, t) => Math.max(0, Math.min(maximum, a + (b - a) * t)),
+        create,
+    });
+}
+function color(name, create) {
+    return registerNativeProperty({
+        name: `jolt.scenekit/${name}`,
+        // Premultiply the sampled sRGB channels, so native linear interpolation also handles zero alpha.
+        units: [
+            'premultiplied sRGB red',
+            'premultiplied sRGB green',
+            'premultiplied sRGB blue',
+            'alpha',
+        ],
+        platforms: ['ios'],
+        encode(value) {
+            const argb = parseColor(value), alpha = (argb >>> 24) / 255;
+            return [
+                (((argb >>> 16) & 255) / 255) * alpha,
+                (((argb >>> 8) & 255) / 255) * alpha,
+                ((argb & 255) / 255) * alpha,
+                alpha,
+            ];
+        },
+        decode(values) {
+            const alpha = clamp(values[3]);
+            const channel = (i) => Math.round(clamp(alpha ? values[i] / alpha : 0) * 255);
+            return new Color(((Math.round(alpha * 255) << 24) |
+                (channel(0) << 16) |
+                (channel(1) << 8) |
+                channel(2)) >>>
+                0);
+        },
+        interpolate: (a, b, t) => new Color(colorMixer(parseColor(a), parseColor(b))(t)),
+        create,
+    });
+}
+/** SCNLight intensity, finite and nonnegative. Non-spatial: retains timing under reduced motion. */
+export const sceneKitLightIntensity = scalar('light-intensity', Infinity, (target) => JoltReferenceProperties.sceneLightIntensity(target));
+/** Solid UIColor/CGColor light color. Returns a normalized sRGB Color from get(). */
+export const sceneKitLightColor = color('light-color', (target) => JoltReferenceProperties.sceneLightColor(target));
+/** SCNMaterial transparency in 0..1; does not change transparencyMode/transparent contents. */
+export const sceneKitMaterialTransparency = scalar('material-transparency', 1, (target) => JoltReferenceProperties.sceneMaterialTransparency(target));
+/** Solid color diffuse contents only; never converts a texture into a color. */
+export const sceneKitMaterialDiffuse = color('material-diffuse', (target) => JoltReferenceProperties.sceneMaterialDiffuse(target));
+/** Solid color emission contents only; does not make the material illuminate nearby geometry. */
+export const sceneKitMaterialEmission = color('material-emission', (target) => JoltReferenceProperties.sceneMaterialEmission(target));
+//# sourceMappingURL=scene-appearance.js.map

package/dist/scene-appearance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-appearance.js","sourceRoot":"","sources":["../src/scene-appearance.ts"],"names":[],"mappings":"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"}

package/dist/scene-camera.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="@nativescript/types-ios/lib/ios/objc-x86_64/objc!SceneKit" preserve="true" />
+import { type NativeProperty } from './native-property.js';
+/** Perspective SCNCamera field of view in degrees (1..179), on its projectionDirection axis. */
+export declare const sceneKitFieldOfView: (camera: SCNCamera) => NativeProperty<number>;
+//# sourceMappingURL=scene-camera.d.ts.map

package/dist/scene-camera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-camera.d.ts","sourceRoot":"","sources":["../src/scene-camera.ts"],"names":[],"mappings":";AACA,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAElF,gGAAgG;AAChG,eAAO,MAAM,mBAAmB,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,cAAc,CAAC,MAAM,CAyB1E,CAAA"}

package/dist/scene-camera.js

@@ -0,0 +1,23 @@
+/// <reference types="@nativescript/types-ios/lib/ios/objc-x86_64/objc!SceneKit" preserve="true" />
+import { registerNativeProperty } from './native-property.js';
+/** Perspective SCNCamera field of view in degrees (1..179), on its projectionDirection axis. */
+export const sceneKitFieldOfView = registerNativeProperty({
+    name: 'jolt.scenekit/field-of-view',
+    units: ['degrees on the camera projectionDirection axis'],
+    platforms: ['ios'],
+    spatial: true,
+    encode: (value) => [value],
+    decode: (values) => values[0],
+    validate(value) {
+        if (!Number.isFinite(value) || value < 1 || value > 179)
+            throw new RangeError('SceneKit field of view needs a finite angle in 1..179 degrees.');
+    },
+    interpolate: (a, b, t) => Math.max(1, Math.min(179, a + (b - a) * t)),
+    create(target) {
+        if (typeof JoltReferenceProperties === 'undefined' ||
+            typeof JoltReferenceProperties.sceneFieldOfView !== 'function')
+            throw new Error('SceneKit field of view requires an updated @rafaelaugusto/jolt-native plugin. Update both packages and rebuild the native app.');
+        return JoltReferenceProperties.sceneFieldOfView(target);
+    },
+});
+//# sourceMappingURL=scene-camera.js.map

package/dist/scene-camera.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-camera.js","sourceRoot":"","sources":["../src/scene-camera.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,OAAO,EAAE,sBAAsB,EAAuB,MAAM,sBAAsB,CAAA;AAElF,gGAAgG;AAChG,MAAM,CAAC,MAAM,mBAAmB,GAC9B,sBAAsB,CAAS;IAC7B,IAAI,EAAE,6BAA6B;IACnC,KAAK,EAAE,CAAC,gDAAgD,CAAC;IACzD,SAAS,EAAE,CAAC,KAAK,CAAC;IAClB,OAAO,EAAE,IAAI;IACb,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC;IAC1B,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAE;IAC9B,QAAQ,CAAC,KAAK;QACZ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,GAAG;YACrD,MAAM,IAAI,UAAU,CAClB,gEAAgE,CACjE,CAAA;IACL,CAAC;IACD,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACrE,MAAM,CAAC,MAAM;QACX,IACE,OAAO,uBAAuB,KAAK,WAAW;YAC9C,OAAO,uBAAuB,CAAC,gBAAgB,KAAK,UAAU;YAE9D,MAAM,IAAI,KAAK,CACb,gIAAgI,CACjI,CAAA;QACH,OAAO,uBAAuB,CAAC,gBAAgB,CAAC,MAAkB,CAAC,CAAA;IACrE,CAAC;CACF,CAAC,CAAA"}

package/dist/scene-shader.d.ts

@@ -0,0 +1,18 @@
+/// <reference types="@nativescript/types-ios/lib/ios/objc-x86_64/objc!SceneKit" preserve="true" />
+import { type NativeProperty } from './native-property.js';
+export type SceneUniformType = 'float' | 'float2' | 'float3' | 'float4';
+export type SceneUniformValue<T extends SceneUniformType> = T extends 'float' ? number : T extends 'float2' ? readonly [number, number] : T extends 'float3' ? readonly [number, number, number] : readonly [number, number, number, number];
+export interface SceneUniformOptions<T extends SceneUniformType> {
+    type: T;
+    /** Finite inclusive limits applied to every component; spring overshoot is clamped. */
+    range: readonly [number, number];
+    /** One application-defined unit per component. Vectors have no implicit color conversion. */
+    units: readonly string[];
+    /** Spatial uniforms jump under Reduced Motion; appearance uniforms keep their timing. */
+    motion: 'spatial' | 'appearance';
+}
+/** Scene environment multiplier, nonnegative; leaves the environment/background images untouched. */
+export declare const sceneKitEnvironmentIntensity: (scene: SCNScene) => NativeProperty<number>;
+/** Declared Metal shaderModifiers input, initialized by the application before attachment. */
+export declare function sceneKitUniform<T extends SceneUniformType>(target: SCNMaterial | SCNGeometry, name: string, options: SceneUniformOptions<T>): NativeProperty<SceneUniformValue<T>>;
+//# sourceMappingURL=scene-shader.d.ts.map

package/dist/scene-shader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-shader.d.ts","sourceRoot":"","sources":["../src/scene-shader.ts"],"names":[],"mappings":";AACA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAA;AAE7B,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;AACvE,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,gBAAgB,IAAI,CAAC,SAAS,OAAO,GACzE,MAAM,GACN,CAAC,SAAS,QAAQ,GAChB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GACzB,CAAC,SAAS,QAAQ,GAChB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GACjC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AACjD,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,gBAAgB;IAC7D,IAAI,EAAE,CAAC,CAAA;IACP,uFAAuF;IACvF,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,6FAA6F;IAC7F,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,yFAAyF;IACzF,MAAM,EAAE,SAAS,GAAG,YAAY,CAAA;CACjC;AAqBD,qGAAqG;AACrG,eAAO,MAAM,4BAA4B,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,cAAc,CAAC,MAAM,CAcjF,CAAA;AAEJ,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,CAAC,SAAS,gBAAgB,EACxD,MAAM,EAAE,WAAW,GAAG,WAAW,EACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC9B,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAwEtC"}

package/dist/scene-shader.js

@@ -0,0 +1,76 @@
+/// <reference types="@nativescript/types-ios/lib/ios/objc-x86_64/objc!SceneKit" preserve="true" />
+import { nativePropertyTarget, registerNativeProperty, } from './native-property.js';
+function runtime() {
+    if (typeof JoltSceneShaderProperties === 'undefined')
+        throw new Error('Update @rafaelaugusto/jolt-native and rebuild the native app to use SceneKit environment and shader adapters.');
+    return JoltSceneShaderProperties;
+}
+function sink(create) {
+    const error = new interop.Reference();
+    const result = create(error);
+    if (!result)
+        throw new Error(error.value?.localizedDescription ??
+            'Invalid SceneKit property target or shader schema.');
+    return result;
+}
+/** Scene environment multiplier, nonnegative; leaves the environment/background images untouched. */
+export const sceneKitEnvironmentIntensity = registerNativeProperty({
+    name: 'jolt.scenekit/environment-intensity',
+    units: ['environment illumination multiplier'],
+    platforms: ['ios'],
+    encode: (value) => [value],
+    decode: (values) => values[0],
+    validate(value) {
+        if (!Number.isFinite(value) || value < 0)
+            throw new RangeError('Environment intensity must be finite and nonnegative.');
+    },
+    interpolate: (a, b, t) => Math.max(0, a + (b - a) * t),
+    create: (target) => sink((error) => runtime().environmentError(target, error)),
+});
+/** Declared Metal shaderModifiers input, initialized by the application before attachment. */
+export function sceneKitUniform(target, name, options) {
+    if (typeof name !== 'string' ||
+        !/^[A-Za-z][A-Za-z0-9_]*$/.test(name) ||
+        /^(u_|a_|v_|scn_)/.test(name))
+        throw new TypeError('Use a declared custom uniform identifier without a reserved SceneKit prefix or KVC path.');
+    if (!options || !['float', 'float2', 'float3', 'float4'].includes(options.type))
+        throw new TypeError('Shader uniforms support float, float2, float3 and float4.');
+    const count = options.type === 'float' ? 1 : Number(options.type.slice(-1));
+    const range = options.range;
+    if (!Array.isArray(range) ||
+        range.length !== 2 ||
+        !range.every((n) => Number.isFinite(n) && Math.abs(n) <= 3.4028234663852886e38) ||
+        range[0] >= range[1])
+        throw new RangeError('Declare an ordered finite range for the shader components.');
+    if (!Array.isArray(options.units) ||
+        options.units.length !== count ||
+        options.units.some((unit) => typeof unit !== 'string' || !unit.trim()))
+        throw new TypeError('Declare one nonempty unit for each shader component.');
+    if (!['spatial', 'appearance'].includes(options.motion))
+        throw new TypeError('Declare whether the shader motion is spatial or appearance.');
+    // Copy the schema: caller mutation cannot change an already attached native sink.
+    const [low, high] = range, type = options.type, units = [...options.units];
+    const vector = (value) => {
+        const values = type === 'float' ? [value] : value;
+        if (!Array.isArray(values) ||
+            values.length !== count ||
+            values.some((n) => typeof n !== 'number' || !Number.isFinite(n) || n < low || n > high))
+            throw new RangeError(`${name} needs ${count} finite component(s) in ${low}..${high}.`);
+        return [...values];
+    };
+    return nativePropertyTarget(target, {
+        name: `jolt.scenekit/uniform-${name}`,
+        units,
+        platforms: ['ios'],
+        spatial: options.motion === 'spatial',
+        encode: vector,
+        decode: (values) => (type === 'float' ? values[0] : [...values]),
+        interpolate(a, b, t) {
+            const first = vector(a), last = vector(b);
+            const result = first.map((value, i) => Math.max(low, Math.min(high, value + (last[i] - value) * t)));
+            return (type === 'float' ? result[0] : result);
+        },
+        create: (object) => sink((error) => runtime().uniformNameConfigurationError(object, name, JSON.stringify({ type, low, high }), error)),
+    });
+}
+//# sourceMappingURL=scene-shader.js.map

package/dist/scene-shader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-shader.js","sourceRoot":"","sources":["../src/scene-shader.ts"],"names":[],"mappings":"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"}

package/dist/scroll-header/geometry.d.ts

@@ -0,0 +1,18 @@
+export interface ScrollHeaderGeometry {
+    expanded: number;
+    minimum: number;
+    section: number;
+    range: number;
+    spacer: number;
+    rowHeight: number;
+    parallax: number;
+    divider: number;
+    handoff: number;
+    titleFade: readonly [number, number];
+    toolbarFade: readonly [number, number];
+}
+export declare function headerGeometry(expanded: number, minimum: number, section: number, rowHeight: number, parallax: number, divider?: number, titleFade?: readonly [number, number], toolbarFade?: readonly [number, number]): ScrollHeaderGeometry;
+/** Keep the visible rows anchored when late artwork/text changes the header height. */
+export declare function resizedOffset(offset: number, before: ScrollHeaderGeometry, after: ScrollHeaderGeometry): number;
+export declare function restoredOffset(offset: number, before: ScrollHeaderGeometry, after: ScrollHeaderGeometry, previousIndex: number, nextIndex: number): number;
+//# sourceMappingURL=geometry.d.ts.map

package/dist/scroll-header/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../src/scroll-header/geometry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,WAAW,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvC;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,SAAI,EACX,SAAS,GAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAY,EAC/C,WAAW,GAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAgB,GACpD,oBAAoB,CAsCtB;AAED,uFAAuF;AACvF,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,oBAAoB,UAG5B;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,oBAAoB,EAC3B,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,UAUlB"}

package/dist/scroll-header/geometry.js

@@ -0,0 +1,46 @@
+export function headerGeometry(expanded, minimum, section, rowHeight, parallax, divider = 0, titleFade = [0, 0.7], toolbarFade = [0.55, 0.95]) {
+    if (![expanded, minimum, section, rowHeight, parallax, divider].every(Number.isFinite) ||
+        divider < 0 ||
+        minimum <= 0 ||
+        expanded <= minimum ||
+        section < 0 ||
+        rowHeight <= 0 ||
+        parallax < 0 ||
+        parallax > expanded - minimum)
+        throw new RangeError('scrollHeader needs expanded > minimum > 0, a positive rowHeight, and parallax within the collapse range.');
+    for (const interval of [titleFade, toolbarFade]) {
+        if (!Array.isArray(interval) ||
+            interval.length !== 2 ||
+            !interval.every(Number.isFinite) ||
+            interval[0] < 0 ||
+            interval[1] > 1 ||
+            interval[0] >= interval[1])
+            throw new RangeError('Fade intervals must increase within [0, 1].');
+    }
+    return {
+        divider,
+        handoff: (toolbarFade[0] + toolbarFade[1]) / 2,
+        titleFade: [...titleFade],
+        toolbarFade: [...toolbarFade],
+        expanded,
+        minimum,
+        section,
+        rowHeight,
+        parallax,
+        range: expanded - minimum,
+        spacer: expanded + section,
+    };
+}
+/** Keep the visible rows anchored when late artwork/text changes the header height. */
+export function resizedOffset(offset, before, after) {
+    return offset <= 0 ? 0 : Math.max(0, offset + after.spacer - before.spacer);
+}
+export function restoredOffset(offset, before, after, previousIndex, nextIndex) {
+    if (offset <= 0)
+        return 0;
+    return Math.max(0, offset +
+        after.spacer -
+        before.spacer +
+        (nextIndex - previousIndex) * (after.rowHeight + after.divider));
+}
+//# sourceMappingURL=geometry.js.map

package/dist/scroll-header/geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.js","sourceRoot":"","sources":["../../src/scroll-header/geometry.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,OAAe,EACf,OAAe,EACf,SAAiB,EACjB,QAAgB,EAChB,OAAO,GAAG,CAAC,EACX,SAAS,GAA8B,CAAC,CAAC,EAAE,GAAG,CAAC,EAC/C,WAAW,GAA8B,CAAC,IAAI,EAAE,IAAI,CAAC;IAErD,IACE,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;QAClF,OAAO,GAAG,CAAC;QACX,OAAO,IAAI,CAAC;QACZ,QAAQ,IAAI,OAAO;QACnB,OAAO,GAAG,CAAC;QACX,SAAS,IAAI,CAAC;QACd,QAAQ,GAAG,CAAC;QACZ,QAAQ,GAAG,QAAQ,GAAG,OAAO;QAE7B,MAAM,IAAI,UAAU,CAClB,0GAA0G,CAC3G,CAAA;IACH,KAAK,MAAM,QAAQ,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,CAAC;QAChD,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YACxB,QAAQ,CAAC,MAAM,KAAK,CAAC;YACrB,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;YAChC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC;YACf,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC;YACf,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC;YAE1B,MAAM,IAAI,UAAU,CAAC,6CAA6C,CAAC,CAAA;IACvE,CAAC;IACD,OAAO;QACL,OAAO;QACP,OAAO,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAC9C,SAAS,EAAE,CAAC,GAAG,SAAS,CAAC;QACzB,WAAW,EAAE,CAAC,GAAG,WAAW,CAAC;QAC7B,QAAQ;QACR,OAAO;QACP,OAAO;QACP,SAAS;QACT,QAAQ;QACR,KAAK,EAAE,QAAQ,GAAG,OAAO;QACzB,MAAM,EAAE,QAAQ,GAAG,OAAO;KAC3B,CAAA;AACH,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,aAAa,CAC3B,MAAc,EACd,MAA4B,EAC5B,KAA2B;IAE3B,OAAO,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;AAC7E,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,MAA4B,EAC5B,KAA2B,EAC3B,aAAqB,EACrB,SAAiB;IAEjB,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,CAAC,CAAA;IACzB,OAAO,IAAI,CAAC,GAAG,CACb,CAAC,EACD,MAAM;QACJ,KAAK,CAAC,MAAM;QACZ,MAAM,CAAC,MAAM;QACb,CAAC,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,CAClE,CAAA;AACH,CAAC"}

package/dist/scroll-header/index.d.ts

@@ -0,0 +1,48 @@
+import { ListView, Label, LayoutBase, View } from '@nativescript/core';
+import { type ScrollHeaderSnapshot } from './native.js';
+import { type ScrollHeaderGeometry } from './geometry.js';
+export type { ScrollHeaderGeometry, ScrollHeaderSnapshot };
+export interface ScrollHeaderOptions {
+    /** Retained overlay siblings of the list. The header owns artwork/title descendants. */
+    header: LayoutBase;
+    artwork: View;
+    title: View;
+    toolbar: View;
+    toolbarTitle: View;
+    section: View;
+    /** Fixed data-row height in DIPs. Row zero is a separate, non-accessible spacer. */
+    rowHeight: number;
+    /** Update only spacer row zero, then refresh the list. Called at layout boundaries. */
+    setSpacerHeight(height: number): void;
+    /** Original spacer height to restore at disposal; defaults to zero. */
+    originalSpacerHeight?: number;
+    expandedHeight?: number;
+    minimumHeight?: number;
+    parallax?: number;
+    /** Fractions of the collapse range, from zero to one. */
+    titleFade?: readonly [number, number];
+    toolbarFade?: readonly [number, number];
+    /** iOS bounce stretches artwork. Android ListView uses its ordinary no-stretch behavior. */
+    stretch?: boolean;
+    /** Stable data keys, excluding spacer row zero. Required by preserveAnchor(). */
+    keys?: () => readonly string[];
+    diagnostic?: Label;
+    onState?: (state: ScrollHeaderSnapshot) => void;
+}
+export interface ScrollHeader {
+    readonly ready: boolean;
+    readonly disposed: boolean;
+    readonly state: ScrollHeaderSnapshot;
+    readonly geometry: ScrollHeaderGeometry | undefined;
+    remeasure(): Promise<void>;
+    preserveAnchor(change: () => void | Promise<void>): Promise<void>;
+    /** Data index, excluding spacer. Aligns below the compact toolbar and pinned section. */
+    scrollToItem(index: number, animated?: boolean): void;
+    scrollToTop(animated?: boolean): void;
+    pause(): void;
+    play(): void;
+    dispose(): void;
+}
+/** Core ListView adapter: one spacer, fixed data rows, retained header/toolbar/section. */
+export declare function scrollHeader(list: ListView, options: ScrollHeaderOptions): ScrollHeader;
+//# sourceMappingURL=index.d.ts.map

package/dist/scroll-header/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scroll-header/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,QAAQ,EACR,KAAK,EACL,UAAU,EACV,IAAI,EAGL,MAAM,oBAAoB,CAAA;AAK3B,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,aAAa,CAAA;AACpB,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,CAAA;AAE1D,MAAM,WAAW,mBAAmB;IAClC,wFAAwF;IACxF,MAAM,EAAE,UAAU,CAAA;IAClB,OAAO,EAAE,IAAI,CAAA;IACb,KAAK,EAAE,IAAI,CAAA;IACX,OAAO,EAAE,IAAI,CAAA;IACb,YAAY,EAAE,IAAI,CAAA;IAClB,OAAO,EAAE,IAAI,CAAA;IACb,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAA;IACjB,uFAAuF;IACvF,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,uEAAuE;IACvE,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yDAAyD;IACzD,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,WAAW,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,4FAA4F;IAC5F,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,SAAS,MAAM,EAAE,CAAA;IAC9B,UAAU,CAAC,EAAE,KAAK,CAAA;IAClB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAA;CAChD;AACD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAA;IACpC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,GAAG,SAAS,CAAA;IACnD,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,cAAc,CAAC,MAAM,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjE,yFAAyF;IACzF,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACrD,WAAW,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACrC,KAAK,IAAI,IAAI,CAAA;IACb,IAAI,IAAI,IAAI,CAAA;IACZ,OAAO,IAAI,IAAI,CAAA;CAChB;AAmBD,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAiavF"}