# Real External Plugin 0.1.1

An accessible ambient clock and live scene beacon for host-owned UI surfaces.

## Immutable release

- Plugin ID: `plg_f5ade172-7f6e-4f2f-a045-bf53e795600e`
- Release ID: `rel_ef9b8db7-0f74-494f-8241-da7c9e441738`
- Version: `0.1.1`

## Package artifacts

The package import specifier is the Registry-reviewed `packageName`; do not substitute a source-workspace package name. `packageSpec` identifies the exact install bytes.

| Provider | packageName | packageSpec | Integrity |
| --- | --- | --- | --- |
| al_amr | `@al-amr-community/al-amr-technical--real-external-plugin` | `https://registry.al-amr.com/v1/packages/sha512/f97e62f0f6c157bb40e7864ae24ff62d52839b2703eb6c9d58615867441a53c6bb6e9b377e631c93d71e1c4c0395a4d9773a58d142fbb254397a53307568cb88.tgz` | `sha512-+X5i8PbBV7tA54ZK4k/2LVKDmycD62ydWGFYZ0QaU8a7bps3fmMck9ceHEwDlaTZdzpY0UL7slQ5elMwdWjLiA==` |

## Declare the exact Plugin installation

Run this from an Al-Amr Environment. This command updates the Environment manifest, `al-amr.lock.json`, and the package dependency together. Do not install the npm package directly.

```sh
alamr add al-amr-technical/real-external-plugin@0.1.1 --integration frontend-adapter --adapter default --yes --json
```

Run the `installCommand` returned by `alamr add`, then verify the complete declaration:

```sh
alamr validate --json
```

## Trust and compatibility preflight

- Runtime class: `trusted_library` (trusted library code in the host Environment; not a JavaScript sandbox)
- Kind: `frontend_only`
- Contracts: `>=0.1.0-alpha.7 <1`
- SDK: `>=0.1.0-alpha.7 <1`
- Platform permissions: none declared
- Browser requirements: none declared
- Direct network origins: none declared
- Collected data: none declared
- Shared data: none declared

## Machine-readable release artifacts

- Reviewed TypeScript declaration: [types.d.ts](./types.d.ts)

## Frontend adapters

| Adapter ID | Runtime | Export path | Exports | Capabilities |
| --- | --- | --- | --- | --- |
| `default` ([types](./types.d.ts?adapter=default)) | `vanilla` | `.` | `activate` | `ambient:clock`, `ambient:scene-beacon` |

## Semantic composition surfaces

The Environment is the compositor. Providers define semantic mount points; contributors provide content for a compatible surface without importing the provider Plugin.

| Direction | Surface | Adapter | Export | Description |
| --- | --- | --- | --- | --- |
| provides | `ambient.scene-beacon` | `default` | `activate` | Host-mounted ambient clock panel with selectable time zones, pause controls, reduced-motion support, and deterministic cleanup. |

## Import examples

These imports use the selected Registry artifact package name: `@al-amr-community/al-amr-technical--real-external-plugin`.

### default (vanilla)

```ts
import * as PluginAdapter from "@al-amr-community/al-amr-technical--real-external-plugin";

// Runtime values are available on PluginAdapter. The reviewed declaration
// names (runtime values plus structural TypeScript bindings) are listed above
// and in types.d.ts; type-only declarations do not exist at runtime.
void PluginAdapter;
```