# `CollectionSpec`

> Contract 2.0.0 · package sha256 `a857eca95b35921109faf997094bb4192f12527d9d0fcd4be7e97f06425bad6e` · generated from `configurator-runtime.d.ts` by `services/onsite-scripter/scripts/build-contract-docs.mjs`; edit the source, not this file.

Interface · `import type { CollectionSpec } from '@holostep-configurators/runtime-client/contract';` · stable · since 2.0.0 · section 7. Collections and shapes

JSON form of a collection's content.

## Members

| Member | Kind | Summary |
| --- | --- | --- |
| <a id="_schema"></a>[`$schema?`](CollectionSpec._schema.md) | property | The JSON Schema id, for editors and [`validate('collection')`](validate.md). |
| <a id="items"></a>[`items`](CollectionSpec.items.md) | property | Unique keys. |
| <a id="stage"></a>[`stage?`](CollectionSpec.stage.md) | property | The collection's one stage layer, which [`stage.set(settings, { owner })`](Stage.set.md) on this collection writes too. |

## Declaration

```ts
export interface CollectionSpec {
  $schema?: 'holostep.collection/1';
  items: readonly ItemSpec[];
  stage?: StageSettings;
}
```

## Generic-API test (spec 3.1)

| Rule | Result |
| --- | --- |
| 1. Neutral name | pass: `CollectionSpec` names no product |
| 2. A precedent | not recorded: no ledger row (coverage.json) names this member or its owner |
| 3. Two apps, or labs | not recorded: no ledger row names this member or its owner |
| 4. The cheaper fix first | not recorded per member (Appendix B decides it per need) |