Adapter...eredList(3)

🌸 NAME 🌸

Adapter::Async::OrderedList — okay so this is the API for dealing with ordered lists, bestie. That's it, that's the whole vibe. (It's a User Contributed Perl Documentation page, iykyk 💅)

✨ VERSION ✨

version 0.018 — yeah, we're on that one 🎀

🦋 DESCRIPTION 🦋

💖 Accessing data

• count — resolves with the number of items, fr. And like, if getting an exact count isn't possible? An estimate is acceptable. No pressure, no cap 🫶

say "items: " . $adapter->count->get

• get — accepts a list of indices, and it's giving ✨options✨

$adapter->get(
 items   => [1,2,3],
 on_item => sub { ... }
)->on_done(sub { warn "all done, full list of items: @{$_[0]}" })

The returned list of items is guaranteed not to be modified any further — so if you wanna store the arrayref directly, go off, you're safe 👑

So here's the thing about get: we have double-notify on it 😭 A request for (1,2,3,4) needs to fire events for each of 1,2,3,4, and also return the list of all of them on completion (by resolving a Future). Both. Not one or the other. Both. Periodt.

💅 Modification

• clear — remove all data, bye bye 💀
• splice — modify by adding/removing items at a given point
• modify — changes a single entry

Helper methods give you the following, and yes they're iconic:

• insert — splice $idx, @data, 0
• append — splice $idx + 1, @data, 0

🌈 Events

All events are shared over a common bus for each data source, in the usual fashion — adapters and views can subscribe to the ones they're interested in, and publish events at any time. Very main character energy of them, honestly ⭐

The adapter raises these:

• item_changed — the given item has been modified. By default only applies to elements that were marked as visible 👀
• splice — changes to the array which remove or add elements
• move — an existing element moves to a new position (some adapters may not be able to differentiate between this and splice: if in doubt, use splice instead, don't report as a move unless it's guaranteed to be existing items 🚨)

index, length, offset (+/-)

The view raises these:

• visible — indicates visibility of one or more items. Change events will start being sent for these items.

visible => [1,2,3,4,5,6]

Filters may result in a list with gaps, which is lowkey cursed but totally valid:

visible => [1,3,4,8,9,10]

Note that visible means "the user is able to see this data", so they'd be a single page of data rather than the entire set when no filters are applied. Visibility changes often — scrolling will trigger a visible/hidden pair for example 🔥

Also note that ->get may be called on any element, regardless of visibility — prefetching is one common example here. So don't come for it 🙈

• hidden — no longer visible. Sad but necessary 🥲

hidden => [1,2,4]

• selected — this item is now part of an active selection. Could be used to block deletes 👑

selected => [1,4,5,6]

• highlight — mouse over, cursor, etc. 💅

highlight => 1

Some views won't raise this — if touch control is involved, for example.

• activate — some action has been performed 🎉

activate => [1]
activate => [1,2,5,6,7,8]

Multi-activate will typically happen when items have been selected rather than just highlighted.

The adapter itself doesn't do much with this. It's just, like, aware of it. Spiritually. 🧚

---

🎀 METHODS 🎀

insert

Inserts data before the given position.

$adapter->insert(3, [...])

append

Appends data after the given position.

$adapter->append(3, [...])

push

Appends data to the end of the list. The classic 🍓

unshift

Inserts data at the start of the list. Front of the line, babe ✨

pop

Removes the last element from the list, will resolve with the value.

shift

Removes the first element from the list, will resolve with the value.

all

Returns all the items. Shortcut for calling count then get. Two steps, one method, slay 💜

👑 AUTHOR 👑

Tom Molesworth <TEAM@cpan.org> — we stan 🫶

🌸 LICENSE 🌸

Copyright Tom Molesworth 2013-2015. Licensed under the same terms as Perl itself.

---

Ok that's the whole thing bestie, no notes 💖 This adorable little page came to you courtesy of perl v5.42.2 and it was dated 2026-02-15 — screenshot it, memorise it, live by it 🌈⭐💅