add Array.ensure api

[datner]

yum yum, I love getting garbage from my backend

• test(Array): fix typos
• chore: update readme to be more accurate
• feat(Array): add cast

[changeset-bot]

🦋 Changeset detected

Latest commit: 707e99d

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 25 packages

Name	Type
effect	Minor
@effect/cli	Major
@effect/experimental	Major
@effect/opentelemetry	Major
@effect/platform-browser	Major
@effect/platform-bun	Major
@effect/platform-node-shared	Major
@effect/platform-node	Major
@effect/platform	Major
@effect/printer-ansi	Major
@effect/printer	Major
@effect/rpc-http	Major
@effect/rpc	Major
@effect/schema	Major
@effect/sql-drizzle	Major
@effect/sql-mssql	Major
@effect/sql-mysql2	Major
@effect/sql-pg	Major
@effect/sql-sqlite-bun	Major
@effect/sql-sqlite-node	Major
@effect/sql-sqlite-react-native	Major
@effect/sql-sqlite-wasm	Major
@effect/sql	Major
@effect/typeclass	Major
@effect/vitest	Major

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[gcanti]

How about using "ensure" instead of "cast"?
Shouldn't it take Iterable<A> as input like other APIs in the module?

[datner]

@gcanti

How about using "ensure" instead of "cast"? Shouldn't it take Iterable<A> as input like other APIs in the module?

hmm ensure sounds like it would make sure that some condition is fulfilled, like every. I used cast because of castArray. Regarding Iterable I thought that accepting A | Iterable<A> would make the fromIterable util redundant, since it would be fromIterable + wrapping. What do you think?

[gcanti]

it would make sure that some condition is fulfilled

Yes, the idea I've formed about the goal of this function is to "normalize" or "ensure" that you always have an array as output (which is the fulfilled condition)

the issue with Array<A> | A is that I cannot pass a readonly array

declare const readonlyNumbers: ReadonlyArray<number>;
const x = cast(readonlyNumbers); // error

[jessekelly881]

+1 A Schema transformation for this might be nice as well. :) Schema.CastArray(A) :: Schema<readonly A[], A | A[]>