@digitalcanopy/assets 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/README.md +55 -0
  2. package/dist/catalog/index.d.mts +94 -0
  3. package/dist/catalog/index.d.ts +94 -0
  4. package/dist/catalog/index.js +540 -0
  5. package/dist/catalog/index.mjs +30 -0
  6. package/dist/chunk-BUUV7WRE.mjs +502 -0
  7. package/dist/chunk-CIMJYYCP.mjs +3612 -0
  8. package/dist/chunk-FECYZWQ6.mjs +278 -0
  9. package/dist/chunk-MFWLT2XV.mjs +47 -0
  10. package/dist/index.d.mts +5 -0
  11. package/dist/index.d.ts +5 -0
  12. package/dist/index.js +4483 -0
  13. package/dist/index.mjs +74 -0
  14. package/dist/manifests/index.d.mts +79 -0
  15. package/dist/manifests/index.d.ts +79 -0
  16. package/dist/manifests/index.js +3647 -0
  17. package/dist/manifests/index.mjs +24 -0
  18. package/dist/registry/index.d.mts +98 -0
  19. package/dist/registry/index.d.ts +98 -0
  20. package/dist/registry/index.js +321 -0
  21. package/dist/registry/index.mjs +12 -0
  22. package/dist/resolvers/cdn.d.mts +16 -0
  23. package/dist/resolvers/cdn.d.ts +16 -0
  24. package/dist/resolvers/cdn.js +76 -0
  25. package/dist/resolvers/cdn.mjs +16 -0
  26. package/dist/types-Cy3PZIX4.d.mts +52 -0
  27. package/dist/types-_dmvJ9qx.d.ts +52 -0
  28. package/package.json +19 -3
  29. package/scripts/generate-manifests.mjs +0 -409
  30. package/src/__tests__/manifests.test.ts +0 -129
  31. package/src/__tests__/resolvers.test.ts +0 -83
  32. package/src/__tests__/sync-r2.test.ts +0 -82
  33. package/src/index.ts +0 -2
  34. package/src/manifests/index.ts +0 -81
  35. package/src/manifests/isometric-tiles.atlas.json +0 -592
  36. package/src/manifests/keys.ts +0 -160
  37. package/src/manifests/modular-characters.atlas.json +0 -856
  38. package/src/manifests/playing-cards.atlas.json +0 -1408
  39. package/src/manifests/ui-sprites.atlas.json +0 -568
  40. package/src/resolvers/cdn.ts +0 -52
  41. package/src/resolvers/index.ts +0 -1
  42. package/tsconfig.build.json +0 -12
  43. package/tsconfig.json +0 -20
@@ -0,0 +1,278 @@
1
+ import {
2
+ getFrameCoordinates
3
+ } from "./chunk-CIMJYYCP.mjs";
4
+ import {
5
+ getKenneyAssetUrl
6
+ } from "./chunk-MFWLT2XV.mjs";
7
+
8
+ // src/registry/resolvers.ts
9
+ function resolveAssetPathWithOverrides(pack, assetPath, overrides, packOverrides, ext) {
10
+ const cleanPack = pack.replace(/^\/+|\/+$/g, "").toLowerCase();
11
+ const cleanPath = assetPath.replace(/^\/+/, "");
12
+ const bareKey = cleanPath.replace(/\.[a-zA-Z0-9]+$/, "");
13
+ if (overrides.has(bareKey)) {
14
+ return overrides.get(bareKey).url;
15
+ }
16
+ if (overrides.has(cleanPath)) {
17
+ return overrides.get(cleanPath).url;
18
+ }
19
+ const packOverride = packOverrides.get(cleanPack);
20
+ if (packOverride) {
21
+ if (typeof packOverride === "function") {
22
+ return packOverride(cleanPath, ext);
23
+ }
24
+ const cleanBase = packOverride.replace(/\/+$/, "");
25
+ const finalExt = ext ? ext.startsWith(".") ? ext.slice(1) : ext : /\.[a-zA-Z0-9]+$/.test(cleanPath) ? void 0 : "png";
26
+ const targetPath = finalExt && !cleanPath.endsWith(`.${finalExt}`) ? `${cleanPath.replace(/\.[a-zA-Z0-9]+$/, "")}.${finalExt}` : cleanPath;
27
+ return `${cleanBase}/${targetPath}`;
28
+ }
29
+ return getKenneyAssetUrl(pack, assetPath, ext);
30
+ }
31
+ function resolveCardUrlWithOverrides(cardKey, overrides, packOverrides, ext = "png") {
32
+ const cleanKey = cardKey.replace(/^\/+|\/+$/g, "").replace(/\.[a-zA-Z0-9]+$/, "");
33
+ if (overrides.has(cleanKey)) {
34
+ return overrides.get(cleanKey).url;
35
+ }
36
+ return resolveAssetPathWithOverrides("cards", cleanKey, overrides, packOverrides, ext);
37
+ }
38
+ function resolveCharacterUrlWithOverrides(category, itemKey, overrides, packOverrides, ext = "png") {
39
+ const cleanKey = itemKey.replace(/^\/+|\/+$/g, "").replace(/\.[a-zA-Z0-9]+$/, "");
40
+ if (overrides.has(cleanKey)) {
41
+ return overrides.get(cleanKey).url;
42
+ }
43
+ const pathWithCat = `${category}/${cleanKey}`;
44
+ if (overrides.has(pathWithCat)) {
45
+ return overrides.get(pathWithCat).url;
46
+ }
47
+ return resolveAssetPathWithOverrides(
48
+ "modular-characters",
49
+ pathWithCat,
50
+ overrides,
51
+ packOverrides,
52
+ ext
53
+ );
54
+ }
55
+ function resolveAudioUrlWithOverrides(soundName, overrides, packOverrides, ext = "ogg") {
56
+ const cleanName = soundName.replace(/^\/+|\/+$/g, "").replace(/\.[a-zA-Z0-9]+$/, "");
57
+ if (overrides.has(cleanName)) {
58
+ return overrides.get(cleanName).url;
59
+ }
60
+ if (packOverrides.has("ui-pack/sounds")) {
61
+ return resolveAssetPathWithOverrides("ui-pack/sounds", cleanName, overrides, packOverrides, ext);
62
+ }
63
+ return resolveAssetPathWithOverrides("ui-pack", `sounds/${cleanName}`, overrides, packOverrides, ext);
64
+ }
65
+ function resolveFrameWithOverrides(manifest, frameKey, overrides) {
66
+ const cleanKey = frameKey.trim();
67
+ const override = overrides.get(cleanKey);
68
+ const baseFrame = getFrameCoordinates(manifest, cleanKey);
69
+ if (!override || !override.frame && !override.anchor) {
70
+ return baseFrame;
71
+ }
72
+ if (!baseFrame && !override.frame) {
73
+ return void 0;
74
+ }
75
+ const mergedFrame = override.frame ?? baseFrame.frame;
76
+ const mergedAnchor = override.anchor ?? baseFrame?.anchor;
77
+ return {
78
+ frame: mergedFrame,
79
+ ...mergedAnchor ? { anchor: mergedAnchor } : {},
80
+ trimmed: baseFrame?.trimmed ?? false,
81
+ rotated: baseFrame?.rotated ?? false,
82
+ ...baseFrame?.spriteSourceSize ? { spriteSourceSize: baseFrame.spriteSourceSize } : {},
83
+ ...baseFrame?.sourceSize ? { sourceSize: baseFrame.sourceSize } : {}
84
+ };
85
+ }
86
+ function resolveFlameDataWithOverrides(manifest, frameKey, overrides) {
87
+ const frame = resolveFrameWithOverrides(manifest, frameKey, overrides);
88
+ if (!frame) return null;
89
+ return {
90
+ srcPosition: [frame.frame.x, frame.frame.y],
91
+ srcSize: [frame.frame.w, frame.frame.h],
92
+ anchor: [frame.anchor?.ax ?? 0.5, frame.anchor?.ay ?? 0.5]
93
+ };
94
+ }
95
+
96
+ // src/registry/registry.ts
97
+ var AssetRegistry = class {
98
+ constructor() {
99
+ this.overrides = /* @__PURE__ */ new Map();
100
+ this.packOverrides = /* @__PURE__ */ new Map();
101
+ this.listeners = /* @__PURE__ */ new Set();
102
+ }
103
+ registerOverride(key, override) {
104
+ const cleanKey = key.trim();
105
+ const entry = typeof override === "string" ? { url: override } : { ...override };
106
+ this.overrides.set(cleanKey, entry);
107
+ this.emit({
108
+ type: "override_registered",
109
+ keys: [cleanKey],
110
+ timestamp: Date.now()
111
+ });
112
+ return this;
113
+ }
114
+ registerOverrides(overrides) {
115
+ const affectedKeys = [];
116
+ if (Array.isArray(overrides)) {
117
+ for (const asset of overrides) {
118
+ const cleanKey = asset.asset_key.trim();
119
+ this.overrides.set(cleanKey, {
120
+ url: asset.cdn_url,
121
+ frame: asset.metadata?.frame,
122
+ anchor: asset.metadata?.anchor,
123
+ app_scope: asset.app_scope,
124
+ category: asset.category,
125
+ metadata: asset.metadata
126
+ });
127
+ affectedKeys.push(cleanKey);
128
+ }
129
+ } else {
130
+ for (const [key, value] of Object.entries(overrides)) {
131
+ const cleanKey = key.trim();
132
+ this.overrides.set(
133
+ cleanKey,
134
+ typeof value === "string" ? { url: value } : { ...value }
135
+ );
136
+ affectedKeys.push(cleanKey);
137
+ }
138
+ }
139
+ if (affectedKeys.length > 0) {
140
+ this.emit({
141
+ type: "override_registered",
142
+ keys: affectedKeys,
143
+ timestamp: Date.now()
144
+ });
145
+ }
146
+ return this;
147
+ }
148
+ registerPackOverride(pack, cdnBaseOrResolver) {
149
+ const cleanPack = pack.replace(/^\/+|\/+$/g, "").toLowerCase();
150
+ this.packOverrides.set(cleanPack, cdnBaseOrResolver);
151
+ this.emit({
152
+ type: "pack_registered",
153
+ pack: cleanPack,
154
+ timestamp: Date.now()
155
+ });
156
+ return this;
157
+ }
158
+ removePackOverride(pack) {
159
+ const cleanPack = pack.replace(/^\/+|\/+$/g, "").toLowerCase();
160
+ const removed = this.packOverrides.delete(cleanPack);
161
+ if (removed) {
162
+ this.emit({
163
+ type: "pack_removed",
164
+ pack: cleanPack,
165
+ timestamp: Date.now()
166
+ });
167
+ }
168
+ return removed;
169
+ }
170
+ loadCatalog(assets, appScope) {
171
+ const filtered = appScope ? assets.filter((a) => a.app_scope === appScope || a.app_scope === "all") : assets;
172
+ this.registerOverrides(filtered);
173
+ this.emit({
174
+ type: "catalog_loaded",
175
+ app_scope: appScope,
176
+ keys: filtered.map((f) => f.asset_key),
177
+ timestamp: Date.now()
178
+ });
179
+ return this;
180
+ }
181
+ hasOverride(key) {
182
+ return this.overrides.has(key.trim());
183
+ }
184
+ getOverride(key) {
185
+ return this.overrides.get(key.trim());
186
+ }
187
+ removeOverride(key) {
188
+ const cleanKey = key.trim();
189
+ const existed = this.overrides.delete(cleanKey);
190
+ if (existed) {
191
+ this.emit({
192
+ type: "override_removed",
193
+ keys: [cleanKey],
194
+ timestamp: Date.now()
195
+ });
196
+ }
197
+ return existed;
198
+ }
199
+ clearOverrides() {
200
+ this.overrides.clear();
201
+ this.emit({ type: "cleared", timestamp: Date.now() });
202
+ }
203
+ clearPackOverrides() {
204
+ this.packOverrides.clear();
205
+ this.emit({ type: "cleared", timestamp: Date.now() });
206
+ }
207
+ reset() {
208
+ this.overrides.clear();
209
+ this.packOverrides.clear();
210
+ this.emit({ type: "reset", timestamp: Date.now() });
211
+ }
212
+ resolveUrl(key, defaultUrl = "") {
213
+ const override = this.overrides.get(key.trim());
214
+ return override ? override.url : defaultUrl;
215
+ }
216
+ resolveAssetUrl(pack, assetPath, ext) {
217
+ return resolveAssetPathWithOverrides(pack, assetPath, this.overrides, this.packOverrides, ext);
218
+ }
219
+ resolveCardUrl(cardKey, ext = "png") {
220
+ return resolveCardUrlWithOverrides(cardKey, this.overrides, this.packOverrides, ext);
221
+ }
222
+ resolveCharacterUrl(category, itemKey, ext = "png") {
223
+ return resolveCharacterUrlWithOverrides(category, itemKey, this.overrides, this.packOverrides, ext);
224
+ }
225
+ resolveAudioUrl(soundName, ext = "ogg") {
226
+ return resolveAudioUrlWithOverrides(soundName, this.overrides, this.packOverrides, ext);
227
+ }
228
+ resolveFrame(manifest, frameKey) {
229
+ return resolveFrameWithOverrides(manifest, frameKey, this.overrides);
230
+ }
231
+ resolveFlameSpriteData(manifest, frameKey) {
232
+ return resolveFlameDataWithOverrides(manifest, frameKey, this.overrides);
233
+ }
234
+ subscribe(listener) {
235
+ this.listeners.add(listener);
236
+ return () => {
237
+ this.listeners.delete(listener);
238
+ };
239
+ }
240
+ onSwap(listener) {
241
+ return this.subscribe(listener);
242
+ }
243
+ getSnapshot() {
244
+ return {
245
+ activeOverridesCount: this.overrides.size,
246
+ activePacksCount: this.packOverrides.size,
247
+ overriddenKeys: Array.from(this.overrides.keys()),
248
+ overriddenPacks: Array.from(this.packOverrides.keys())
249
+ };
250
+ }
251
+ emit(event) {
252
+ for (const listener of this.listeners) {
253
+ try {
254
+ listener(event);
255
+ } catch (err) {
256
+ console.error("[AssetRegistry] Listener error:", err);
257
+ }
258
+ }
259
+ }
260
+ };
261
+ function createAssetRegistry() {
262
+ return new AssetRegistry();
263
+ }
264
+ var DEFAULT_REGISTRY_SYMBOL = /* @__PURE__ */ Symbol.for("@digitalcanopy/assets/defaultRegistry");
265
+ function getDefaultAssetRegistry() {
266
+ const globalScope = globalThis;
267
+ if (!globalScope[DEFAULT_REGISTRY_SYMBOL]) {
268
+ globalScope[DEFAULT_REGISTRY_SYMBOL] = createAssetRegistry();
269
+ }
270
+ return globalScope[DEFAULT_REGISTRY_SYMBOL];
271
+ }
272
+ var assetRegistry = getDefaultAssetRegistry();
273
+
274
+ export {
275
+ AssetRegistry,
276
+ createAssetRegistry,
277
+ assetRegistry
278
+ };
@@ -0,0 +1,47 @@
1
+ // src/resolvers/cdn.ts
2
+ var CDN_BASE_URL = "https://cdn.sunshade.icu/assets/kenney";
3
+ var KENNEY_CDN_BASE = CDN_BASE_URL;
4
+ function getKenneyAssetUrl(pack, assetPath, ext) {
5
+ const cleanPack = pack.replace(/^\/+|\/+$/g, "");
6
+ const cleanPath = assetPath.replace(/^\/+|\/+$/g, "");
7
+ if (ext) {
8
+ const cleanExt = ext.startsWith(".") ? ext.slice(1) : ext;
9
+ if (cleanPath.toLowerCase().endsWith(`.${cleanExt.toLowerCase()}`)) {
10
+ return `${CDN_BASE_URL}/${cleanPack}/${cleanPath}`;
11
+ }
12
+ return `${CDN_BASE_URL}/${cleanPack}/${cleanPath}.${cleanExt}`;
13
+ }
14
+ const hasExt = /\.[a-zA-Z0-9]+$/.test(cleanPath);
15
+ const finalPath = hasExt ? cleanPath : `${cleanPath}.png`;
16
+ return `${CDN_BASE_URL}/${cleanPack}/${finalPath}`;
17
+ }
18
+ function appendOrReplaceExtension(cleanKey, ext) {
19
+ const cleanExt = ext.startsWith(".") ? ext.slice(1) : ext;
20
+ if (cleanKey.toLowerCase().endsWith(`.${cleanExt.toLowerCase()}`)) {
21
+ return cleanKey;
22
+ }
23
+ const baseKey = cleanKey.replace(/\.[a-zA-Z0-9]+$/, "");
24
+ return `${baseKey}.${cleanExt}`;
25
+ }
26
+ function getKenneyAudioUrl(soundName, ext = "ogg") {
27
+ const cleanName = soundName.replace(/^\/+|\/+$/g, "");
28
+ return `${CDN_BASE_URL}/ui-pack/sounds/${appendOrReplaceExtension(cleanName, ext)}`;
29
+ }
30
+ function getKenneyCardUrl(cardKey, ext = "png") {
31
+ const cleanKey = cardKey.replace(/^\/+|\/+$/g, "");
32
+ return `${CDN_BASE_URL}/cards/${appendOrReplaceExtension(cleanKey, ext)}`;
33
+ }
34
+ function getKenneyCharacterUrl(category, itemKey, ext = "png") {
35
+ const cleanCategory = category.replace(/^\/+|\/+$/g, "");
36
+ const cleanKey = itemKey.replace(/^\/+|\/+$/g, "");
37
+ return `${CDN_BASE_URL}/modular-characters/${cleanCategory}/${appendOrReplaceExtension(cleanKey, ext)}`;
38
+ }
39
+
40
+ export {
41
+ CDN_BASE_URL,
42
+ KENNEY_CDN_BASE,
43
+ getKenneyAssetUrl,
44
+ getKenneyAudioUrl,
45
+ getKenneyCardUrl,
46
+ getKenneyCharacterUrl
47
+ };
@@ -0,0 +1,5 @@
1
+ export { CDN_BASE_URL, KENNEY_CDN_BASE, getKenneyAssetUrl, getKenneyAudioUrl, getKenneyCardUrl, getKenneyCharacterUrl } from './resolvers/cdn.mjs';
2
+ export { AnchorPoint, AssetManifestMetadata, AtlasFrame, AtlasManifest, ISOMETRIC_TILES, IsometricTileKey, MODULAR_CHARACTERS, ModularCharacterKey, PLAYING_CARDS, PlayingCardKey, SpriteBounds, UI_SPRITES, UiSpriteKey, getFrameCoordinates, isometricTilesAtlas, modularCharactersAtlas, playingCardsAtlas, toFlameSpriteData, uiSpritesAtlas } from './manifests/index.mjs';
3
+ export { C as CatalogAppScope, a as CatalogAsset, b as CatalogAssetInsert, c as CatalogAssetMetadata, d as CatalogAssetRow, e as CatalogAssetUpdate, f as CatalogCategory } from './types-Cy3PZIX4.mjs';
4
+ export { CATALOG_ASSETS_SCHEMA_SQL, CATALOG_FULL_TABLE_NAME, CATALOG_SCHEMA_NAME, CATALOG_TABLE_NAME, CatalogQueryOptions, SEED_CATALOG_ASSETS, SupabaseClientLike, createCatalogMap, filterCatalog, filterCatalogByCategory, filterCatalogByScope, formatCatalogAssetKey, isCatalogAsset, loadCatalogAssets, validateCatalogAsset } from './catalog/index.mjs';
5
+ export { AssetOverride, AssetRegistry, FlameSpriteData, HotSwapEvent, HotSwapEventType, HotSwapListener, PackOverride, PackResolver, RegistrySnapshot, assetRegistry, createAssetRegistry } from './registry/index.mjs';
@@ -0,0 +1,5 @@
1
+ export { CDN_BASE_URL, KENNEY_CDN_BASE, getKenneyAssetUrl, getKenneyAudioUrl, getKenneyCardUrl, getKenneyCharacterUrl } from './resolvers/cdn.js';
2
+ export { AnchorPoint, AssetManifestMetadata, AtlasFrame, AtlasManifest, ISOMETRIC_TILES, IsometricTileKey, MODULAR_CHARACTERS, ModularCharacterKey, PLAYING_CARDS, PlayingCardKey, SpriteBounds, UI_SPRITES, UiSpriteKey, getFrameCoordinates, isometricTilesAtlas, modularCharactersAtlas, playingCardsAtlas, toFlameSpriteData, uiSpritesAtlas } from './manifests/index.js';
3
+ export { C as CatalogAppScope, a as CatalogAsset, b as CatalogAssetInsert, c as CatalogAssetMetadata, d as CatalogAssetRow, e as CatalogAssetUpdate, f as CatalogCategory } from './types-_dmvJ9qx.js';
4
+ export { CATALOG_ASSETS_SCHEMA_SQL, CATALOG_FULL_TABLE_NAME, CATALOG_SCHEMA_NAME, CATALOG_TABLE_NAME, CatalogQueryOptions, SEED_CATALOG_ASSETS, SupabaseClientLike, createCatalogMap, filterCatalog, filterCatalogByCategory, filterCatalogByScope, formatCatalogAssetKey, isCatalogAsset, loadCatalogAssets, validateCatalogAsset } from './catalog/index.js';
5
+ export { AssetOverride, AssetRegistry, FlameSpriteData, HotSwapEvent, HotSwapEventType, HotSwapListener, PackOverride, PackResolver, RegistrySnapshot, assetRegistry, createAssetRegistry } from './registry/index.js';