chore: add deprecation warnings for idaa_loc migration

src/lib/stores/ae_idaa_stores.ts

@@ -93,6 +93,9 @@ const idaa_local_data_struct: key_val = {
     }
 };
 
+// DEPRECATED: Migrate to $lib/stores/ae_idaa_stores__idaa_loc.svelte.ts.
+// This store uses legacy 'svelte-persisted-store'.
+// Do not add new features here; implement in the Svelte 5 PersistedState store.
 export const idaa_loc: Writable<key_val> = persisted(
     'ae_idaa_loc',
     idaa_local_data_struct

src/lib/stores/ae_idaa_stores__idaa_loc.svelte.ts

@@ -141,6 +141,11 @@ export const idaa_loc_defaults: IdaaLocState = {
 // recovery_meetings) are replaced wholesale from localStorage — if a new field
 // is added to a nested object, it will not auto-populate until the user clears
 // their storage. This is the same trade-off as the events sub-stores.
+// READY FOR IMPLEMENTATION: This is the Svelte 5 PersistedState version of 'idaa_loc'.
+// To migrate:
+// 1. Replace all 'idaa_loc' imports from '$lib/stores/ae_idaa_stores' with this file.
+// 2. Replace all '$idaa_loc.*' reads/writes with 'idaa_loc.current.*'.
+// 3. Follow the steps in: documentation/PROJECT__IDAA_Stores_Svelte5_Migration_2026.md
 export const idaa_loc = new PersistedState('ae_idaa_loc', idaa_loc_defaults, {
     serializer: {
         serialize: JSON.stringify,